/** * Display list of a post's revisions. * * Can output either a UL with edit links or a TABLE with diff interface, and * restore action links. * * Second argument controls parameters: * (bool) parent : include the parent (the "Current Revision") in the list. * (string) format : 'list' or 'form-table'. 'list' outputs UL, 'form-table' * outputs TABLE with UI. * (int) right : what revision is currently being viewed - used in * form-table format. * (int) left : what revision is currently being diffed against right - * used in form-table format. * * @package NXTClass * @subpackage Post_Revisions * @since 2.6.0 * * @uses nxt_get_post_revisions() * @uses nxt_post_revision_title() * @uses get_edit_post_link() * @uses get_the_author_meta() * * @todo split into two functions (list, form-table) ? * * @param int|object $post_id Post ID or post object. * @param string|array $args See description {@link nxt_parse_args()}. * @return null */ function nxt_list_post_revisions($post_id = 0, $args = null) { if (!($post = get_post($post_id))) { return; } $defaults = array('parent' => false, 'right' => false, 'left' => false, 'format' => 'list', 'type' => 'all'); extract(nxt_parse_args($args, $defaults), EXTR_SKIP); switch ($type) { case 'autosave': if (!($autosave = nxt_get_post_autosave($post->ID))) { return; } $revisions = array($autosave); break; case 'revision': // just revisions - remove autosave later // just revisions - remove autosave later case 'all': default: if (!($revisions = nxt_get_post_revisions($post->ID))) { return; } break; } /* translators: post revision: 1: when, 2: author name */ $titlef = _x('%1$s by %2$s', 'post revision'); if ($parent) { array_unshift($revisions, $post); } $rows = $right_checked = ''; $class = false; $can_edit_post = current_user_can('edit_post', $post->ID); foreach ($revisions as $revision) { if (!current_user_can('read_post', $revision->ID)) { continue; } if ('revision' === $type && nxt_is_post_autosave($revision)) { continue; } $date = nxt_post_revision_title($revision); $name = get_the_author_meta('display_name', $revision->post_author); if ('form-table' == $format) { if ($left) { $left_checked = $left == $revision->ID ? ' checked="checked"' : ''; } else { $left_checked = $right_checked ? ' checked="checked"' : ''; } // [sic] (the next one) $right_checked = $right == $revision->ID ? ' checked="checked"' : ''; $class = $class ? '' : " class='alternate'"; if ($post->ID != $revision->ID && $can_edit_post) { $actions = '<a href="' . nxt_nonce_url(add_query_arg(array('revision' => $revision->ID, 'action' => 'restore')), "restore-post_{$post->ID}|{$revision->ID}") . '">' . __('Restore') . '</a>'; } else { $actions = ''; } $rows .= "<tr{$class}>\n"; $rows .= "\t<th style='white-space: nowrap' scope='row'><input type='radio' name='left' value='{$revision->ID}'{$left_checked} /></th>\n"; $rows .= "\t<th style='white-space: nowrap' scope='row'><input type='radio' name='right' value='{$revision->ID}'{$right_checked} /></th>\n"; $rows .= "\t<td>{$date}</td>\n"; $rows .= "\t<td>{$name}</td>\n"; $rows .= "\t<td class='action-links'>{$actions}</td>\n"; $rows .= "</tr>\n"; } else { $title = sprintf($titlef, $date, $name); $rows .= "\t<li>{$title}</li>\n"; } } if ('form-table' == $format) { ?> <form action="revision.php" method="get"> <div class="tablenav"> <div class="alignleft"> <input type="submit" class="button-secondary" value="<?php esc_attr_e('Compare Revisions'); ?> " /> <input type="hidden" name="action" value="diff" /> <input type="hidden" name="post_type" value="<?php echo esc_attr($post->post_type); ?> " /> </div> </div> <br class="clear" /> <table class="widefat post-revisions" cellspacing="0" id="post-revisions"> <col /> <col /> <col style="width: 33%" /> <col style="width: 33%" /> <col style="width: 33%" /> <thead> <tr> <th scope="col"><?php /* translators: column name in revisons */ _ex('Old', 'revisions column name'); ?> </th> <th scope="col"><?php /* translators: column name in revisons */ _ex('New', 'revisions column name'); ?> </th> <th scope="col"><?php /* translators: column name in revisons */ _ex('Date Created', 'revisions column name'); ?> </th> <th scope="col"><?php _e('Author'); ?> </th> <th scope="col" class="action-links"><?php _e('Actions'); ?> </th> </tr> </thead> <tbody> <?php echo $rows; ?> </tbody> </table> </form> <?php } else { echo "<ul class='post-revisions'>\n"; echo $rows; echo "</ul>"; } }
$right = $right_revision->ID; $redirect = false; break; case 'view': default: if (!($revision = nxt_get_post_revision($revision_id))) { break; } if (!($post = get_post($revision->post_parent))) { break; } if (!current_user_can('read_post', $revision->ID) || !current_user_can('read_post', $post->ID)) { break; } // Revisions disabled and we're not looking at an autosave if ((!nxt_POST_REVISIONS || !post_type_supports($post->post_type, 'revisions')) && !nxt_is_post_autosave($revision)) { $redirect = 'edit.php?post_type=' . $post->post_type; break; } $post_title = '<a href="' . get_edit_post_link() . '">' . get_the_title() . '</a>'; $revision_title = nxt_post_revision_title($revision, false); $h2 = sprintf(__('Revision for “%1$s” created on %2$s'), $post_title, $revision_title); $title = __('Revisions'); // Sets up the diff radio buttons $left = $revision->ID; $right = $post->ID; $redirect = false; break; } // Empty post_type means either malformed object found, or no valid parent was found. if (!$redirect && empty($post->post_type)) {