Post Revision Display 0.8.1

Want a way to show an "audit trail" for blog posts? Possible uses: * For web publishers, to allow the freedom of updating stories without worrying about confusing or deceiving readers. Anyone can see the changes. * For academic/student use of blogs, so students can't "sneak" posts around submission deadlines by futzing around with the publish date.On single post views, this plugin will display a list of all post-publication revisions, showing revision times, authors, and links to view them. When viewing a previous revision, differences ("diffs") between the previous and current revision will be shown.Also when a previous revision is displayed: will be added to the page header if the standard hook is used in the theme's header file.CSSYou'll probably want to add styling for the diffs so they look as pretty as they do in the screenshots tab. For example:table.diff { width: 100%; }table.diff th { text-align: left; }table.diff .diff-deletedline { background-color:#fdd; width: 50%; }table.diff .diff-deletedline del { background-color:#f99; text-decoration: none; }table.diff .diff-addedline { background-color:#dfd; width: 50%; }table.diff .diff-addedline ins { background-color:#9f9; text-decoration: none; }table.diff .diff-context { display: none; }Other CSSThe revision-header is the note shown above the content when a previous revision is displayed. Possible styling to make it stand out:.revision-header { background-color: yellow; border: 1px solid #3a8b8c; padding: 10px; }div.revision-header { padding: 0 10px; }See the movingtofreedom.org plugin page for more samples and info about the CSS.Automatic vs. Manual ModeIn "automatic mode," once you activate the plugin, revision information will show up on single post views (e.g. single.php) as shown in screenshots one and two. There is no need to modify theme files.With "manual mode," you can specify where in your theme you want revision info to be displayed. Maybe you want to have the note about viewing a previous revision to appear above the post title, or maybe you want the revision list and diffs to appear below other meta information at the end of the post.Most commonly, you'll make calls from single.php to:Which I think are pretty self-explanatory. One of these will have to come before the_content so that when filters are applied on post content, the plugin will know it is in manual mode and won't do the automatic stuff. To me it makes the most sense to have the note at the top as a warning for when a previous revision is displayed, which will take care of this requirement. (Even on current revision posts where there is no note, it will still set the manual flag.)If you insist on putting all the function calls after the post content, you can place before the_content is called in your theme.Manual mode allows you to show revision info on "pages" (page.php) in addition to single post views. (See FAQ for how you can do this in automatic mode also.)You can also put revision info on pages with multiple posts (e.g. the main index.php page or archive pages), although in those cases it only makes sense to show the revision list. When calling the_revision_list_prd() from within "the loop," you'll need to force an update of the revision info for each post by using the first optional parameter, $refreshGlobals:the_revision_list_prd(true)(When you call the three _prd functions, the first call will load all the revision info into a set of global variables. Without forcing the update with $refreshGlobals=true, you'd see the revision list for the first post for every following post displayed on the page.)In manual mode, you can also specify your own header text for the revision list and diff sections. This is the second optional parameter for the function:the_revision_list_prd($refreshGlobals=false, $header=REV_LIST_HEADER)Where the default REV_LIST_HEADER is Revision List:The header is the first and only optional parameter for the function:the_revision_diffs_prd($header=REV_DIFFS_HEADER)Where the default REV_DIFFS_HEADER is Changes:An example of calling these from single.php:Installation : 1. Upload post-revision-display.php to the /wp-content/plugins/ directory. 2. Activate the plugin through the 'Plugins' menu in WordPress. 3. By default in automatic mode, it should "just work," although you'll want to include CSS for styling the diff/revision comparison and probably also the note at the top indicating when a revision is displayed. See the description tab for sample CSS and instructions on how to use "manual" mode to control where things are displayed.

Requirements:	No special requirements
Platforms:	PHP
Keyword:	Automatic,  Content,  Default,  Displayed,  Fgtlt Fphp,  Header,  Manual,  Optional,  Parameter,  Plugin,  Posts,  Previous,  Revision,  Single,  Styling,  Tablediff,  Views,  You039ll
Users rating:	0/10