X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/11be8dc178e77d0b46189bbd8e33a216a9b90942..refs/tags/wordpress-4.5:/wp-admin/includes/template.php
diff --git a/wp-admin/includes/template.php b/wp-admin/includes/template.php
index 2566a616..5138fd20 100644
--- a/wp-admin/includes/template.php
+++ b/wp-admin/includes/template.php
@@ -8,2183 +8,443 @@
* @subpackage Administration
*/
-// Ugly recursive category stuff.
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $parent
- * @param unknown_type $level
- * @param unknown_type $categories
- * @param unknown_type $page
- * @param unknown_type $per_page
- */
-function cat_rows( $parent = 0, $level = 0, $categories = 0, $page = 1, $per_page = 20 ) {
- $count = 0;
- _cat_rows($categories, $count, $parent, $level, $page, $per_page);
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $categories
- * @param unknown_type $count
- * @param unknown_type $parent
- * @param unknown_type $level
- * @param unknown_type $page
- * @param unknown_type $per_page
- * @return unknown
- */
-function _cat_rows( $categories, &$count, $parent = 0, $level = 0, $page = 1, $per_page = 20 ) {
- if ( empty($categories) ) {
- $args = array('hide_empty' => 0);
- if ( !empty($_GET['s']) )
- $args['search'] = $_GET['s'];
- $categories = get_categories( $args );
- }
-
- if ( !$categories )
- return false;
-
- $children = _get_term_hierarchy('category');
-
- $start = ($page - 1) * $per_page;
- $end = $start + $per_page;
- $i = -1;
- ob_start();
- foreach ( $categories as $category ) {
- if ( $count >= $end )
- break;
-
- $i++;
-
- if ( $category->parent != $parent )
- continue;
-
- // If the page starts in a subtree, print the parents.
- if ( $count == $start && $category->parent > 0 ) {
- $my_parents = array();
- while ( $my_parent) {
- $my_parent = get_category($my_parent);
- $my_parents[] = $my_parent;
- if ( !$my_parent->parent )
- break;
- $my_parent = $my_parent->parent;
- }
- $num_parents = count($my_parents);
- while( $my_parent = array_pop($my_parents) ) {
- echo "\t" . _cat_row( $my_parent, $level - $num_parents );
- $num_parents--;
- }
- }
-
- if ( $count >= $start )
- echo "\t" . _cat_row( $category, $level );
-
- unset($categories[$i]); // Prune the working set
- $count++;
-
- if ( isset($children[$category->term_id]) )
- _cat_rows( $categories, $count, $category->term_id, $level + 1, $page, $per_page );
-
- }
-
- $output = ob_get_contents();
- ob_end_clean();
-
- echo $output;
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $category
- * @param unknown_type $level
- * @param unknown_type $name_override
- * @return unknown
- */
-function _cat_row( $category, $level, $name_override = false ) {
- static $row_class = '';
-
- $category = get_category( $category, OBJECT, 'display' );
-
- $default_cat_id = (int) get_option( 'default_category' );
- $pad = str_repeat( '— ', $level );
- $name = ( $name_override ? $name_override : $pad . ' ' . $category->name );
- $edit_link = "categories.php?action=edit&cat_ID=$category->term_id";
- if ( current_user_can( 'manage_categories' ) ) {
- $edit = "name)) . "'>" . attribute_escape( $name ) . ' ';
- $actions = array();
- $actions['edit'] = '' . __('Edit') . ' ';
- $actions['inline hide-if-no-js'] = '' . __('Quick Edit') . ' ';
- if ( $default_cat_id != $category->term_id )
- $actions['delete'] = "term_id) . "' onclick=\"if ( confirm('" . js_escape(sprintf(__("You are about to delete this category '%s'\n 'Cancel' to stop, 'OK' to delete."), $name )) . "') ) { return true;}return false;\">" . __('Delete') . " ";
- $action_count = count($actions);
- $i = 0;
- $edit .= '
';
- foreach ( $actions as $action => $link ) {
- ++$i;
- ( $i == $action_count ) ? $sep = '' : $sep = ' | ';
- $edit .= "$link$sep ";
- }
- $edit .= '
';
- } else {
- $edit = $name;
- }
-
- $row_class = 'alternate' == $row_class ? '' : 'alternate';
- $qe_data = get_category_to_edit($category->term_id);
-
- $category->count = number_format_i18n( $category->count );
- $posts_count = ( $category->count > 0 ) ? "$category->count " : $category->count;
- $output = "";
-
- $columns = get_column_headers('categories');
- $hidden = get_hidden_columns('categories');
- foreach ( $columns as $column_name => $column_display_name ) {
- $class = "class=\"$column_name column-$column_name\"";
-
- $style = '';
- if ( in_array($column_name, $hidden) )
- $style = ' style="display:none;"';
-
- $attributes = "$class$style";
-
- switch ($column_name) {
- case 'cb':
- $output .= "";
- if ( $default_cat_id != $category->term_id ) {
- $output .= " ";
- } else {
- $output .= " ";
- }
- $output .= ' ';
- break;
- case 'name':
- $output .= "$edit";
- $output .= '';
- $output .= '
' . $qe_data->name . '
';
- $output .= '
' . $qe_data->slug . '
';
- $output .= '
' . $qe_data->parent . '
';
- break;
- case 'description':
- $output .= "$category->description ";
- break;
- case 'slug':
- $output .= "$category->slug ";
- break;
- case 'posts':
- $attributes = 'class="posts column-posts num"' . $style;
- $output .= "$posts_count \n";
- }
- }
- $output .= ' ';
-
- return $output;
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since 2.7
- *
- * Outputs the HTML for the hidden table rows used in Categories, Link Caregories and Tags quick edit.
- *
- * @param string $type "tag", "category" or "link-category"
- * @return
- */
-function inline_edit_term_row($type) {
-
- if ( ! current_user_can( 'manage_categories' ) )
- return;
-
- $is_tag = $type == 'edit-tags';
- $columns = get_column_headers($type);
- $hidden = array_intersect( array_keys( $columns ), array_filter( get_hidden_columns($type) ) );
- $col_count = count($columns) - count($hidden);
- ?>
-
-
-name );
- $edit_link = "link-category.php?action=edit&cat_ID=$category->term_id";
- if ( current_user_can( 'manage_categories' ) ) {
- $edit = "name)) . "'>$name ";
- $actions = array();
- $actions['edit'] = '' . __('Edit') . ' ';
- $actions['inline hide-if-no-js'] = '' . __('Quick Edit') . ' ';
- if ( $default_cat_id != $category->term_id )
- $actions['delete'] = "term_id) . "' onclick=\"if ( confirm('" . js_escape(sprintf(__("You are about to delete this category '%s'\n 'Cancel' to stop, 'OK' to delete."), $name )) . "') ) { return true;}return false;\">" . __('Delete') . " ";
- $action_count = count($actions);
- $i = 0;
- $edit .= '';
- foreach ( $actions as $action => $link ) {
- ++$i;
- ( $i == $action_count ) ? $sep = '' : $sep = ' | ';
- $edit .= "$link$sep ";
- }
- $edit .= '
';
- } else {
- $edit = $name;
- }
-
- $row_class = 'alternate' == $row_class ? '' : 'alternate';
- $qe_data = get_term_to_edit($category->term_id, 'link_category');
-
- $category->count = number_format_i18n( $category->count );
- $count = ( $category->count > 0 ) ? "$category->count " : $category->count;
- $output = "";
- $columns = get_column_headers('edit-link-categories');
- $hidden = get_hidden_columns('edit-link-categories');
- foreach ( $columns as $column_name => $column_display_name ) {
- $class = "class=\"$column_name column-$column_name\"";
-
- $style = '';
- if ( in_array($column_name, $hidden) )
- $style = ' style="display:none;"';
-
- $attributes = "$class$style";
-
- switch ($column_name) {
- case 'cb':
- $output .= "";
- if ( absint( get_option( 'default_link_category' ) ) != $category->term_id ) {
- $output .= " ";
- } else {
- $output .= " ";
- }
- $output .= " ";
- break;
- case 'name':
- $output .= "$edit";
- $output .= '';
- $output .= '
' . $qe_data->name . '
';
- $output .= '
' . $qe_data->slug . '
';
- $output .= '
' . $qe_data->parent . '
';
- break;
- case 'description':
- $output .= "$category->description ";
- break;
- case 'slug':
- $output .= "$category->slug ";
- break;
- case 'links':
- $attributes = 'class="links column-links num"' . $style;
- $output .= "$count ";
- }
- }
- $output .= ' ';
-
- return $output;
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $checked
- * @param unknown_type $current
- */
-function checked( $checked, $current) {
- if ( $checked == $current)
- echo ' checked="checked"';
-}
+/** Walker_Category_Checklist class */
+require_once( ABSPATH . 'wp-admin/includes/class-walker-category-checklist.php' );
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $selected
- * @param unknown_type $current
- */
-function selected( $selected, $current) {
- if ( $selected == $current)
- echo ' selected="selected"';
-}
+/** WP_Internal_Pointers class */
+require_once( ABSPATH . 'wp-admin/includes/class-wp-internal-pointers.php' );
//
// Category Checklists
//
/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- * @deprecated Use {@link wp_link_category_checklist()}
- * @see wp_link_category_checklist()
- *
- * @param unknown_type $default
- * @param unknown_type $parent
- * @param unknown_type $popular_ids
- */
-function dropdown_categories( $default = 0, $parent = 0, $popular_ids = array() ) {
- global $post_ID;
- wp_category_checklist($post_ID);
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- */
-class Walker_Category_Checklist extends Walker {
- var $tree_type = 'category';
- var $db_fields = array ('parent' => 'parent', 'id' => 'term_id'); //TODO: decouple this
-
- function start_lvl(&$output, $depth, $args) {
- $indent = str_repeat("\t", $depth);
- $output .= "$indent\n";
- }
-
- function end_lvl(&$output, $depth, $args) {
- $indent = str_repeat("\t", $depth);
- $output .= "$indent \n";
- }
-
- function start_el(&$output, $category, $depth, $args) {
- extract($args);
-
- $class = in_array( $category->term_id, $popular_cats ) ? ' class="popular-category"' : '';
- $output .= "\n" . ' term_id, $selected_cats ) ? ' checked="checked"' : "" ) . '/> ' . wp_specialchars( apply_filters('the_category', $category->name )) . ' ';
- }
+ * Output an unordered list of checkbox input elements labeled with category names.
+ *
+ * @since 2.5.1
+ *
+ * @see wp_terms_checklist()
+ *
+ * @param int $post_id Optional. Post to generate a categories checklist for. Default 0.
+ * $selected_cats must not be an array. Default 0.
+ * @param int $descendants_and_self Optional. ID of the category to output along with its descendants.
+ * Default 0.
+ * @param array $selected_cats Optional. List of categories to mark as checked. Default false.
+ * @param array $popular_cats Optional. List of categories to receive the "popular-category" class.
+ * Default false.
+ * @param object $walker Optional. Walker object to use to build the output.
+ * Default is a Walker_Category_Checklist instance.
+ * @param bool $checked_ontop Optional. Whether to move checked items out of the hierarchy and to
+ * the top of the list. Default true.
+ */
+function wp_category_checklist( $post_id = 0, $descendants_and_self = 0, $selected_cats = false, $popular_cats = false, $walker = null, $checked_ontop = true ) {
+ wp_terms_checklist( $post_id, array(
+ 'taxonomy' => 'category',
+ 'descendants_and_self' => $descendants_and_self,
+ 'selected_cats' => $selected_cats,
+ 'popular_cats' => $popular_cats,
+ 'walker' => $walker,
+ 'checked_ontop' => $checked_ontop
+ ) );
+}
+
+/**
+ * Output an unordered list of checkbox input elements labelled with term names.
+ *
+ * Taxonomy-independent version of wp_category_checklist().
+ *
+ * @since 3.0.0
+ * @since 4.4.0 Introduced the `$echo` argument.
+ *
+ * @param int $post_id Optional. Post ID. Default 0.
+ * @param array|string $args {
+ * Optional. Array or string of arguments for generating a terms checklist. Default empty array.
+ *
+ * @type int $descendants_and_self ID of the category to output along with its descendants.
+ * Default 0.
+ * @type array $selected_cats List of categories to mark as checked. Default false.
+ * @type array $popular_cats List of categories to receive the "popular-category" class.
+ * Default false.
+ * @type object $walker Walker object to use to build the output.
+ * Default is a Walker_Category_Checklist instance.
+ * @type string $taxonomy Taxonomy to generate the checklist for. Default 'category'.
+ * @type bool $checked_ontop Whether to move checked items out of the hierarchy and to
+ * the top of the list. Default true.
+ * @type bool $echo Whether to echo the generated markup. False to return the markup instead
+ * of echoing it. Default true.
+ * }
+ */
+function wp_terms_checklist( $post_id = 0, $args = array() ) {
+ $defaults = array(
+ 'descendants_and_self' => 0,
+ 'selected_cats' => false,
+ 'popular_cats' => false,
+ 'walker' => null,
+ 'taxonomy' => 'category',
+ 'checked_ontop' => true,
+ 'echo' => true,
+ );
+
+ /**
+ * Filter the taxonomy terms checklist arguments.
+ *
+ * @since 3.4.0
+ *
+ * @see wp_terms_checklist()
+ *
+ * @param array $args An array of arguments.
+ * @param int $post_id The post ID.
+ */
+ $params = apply_filters( 'wp_terms_checklist_args', $args, $post_id );
- function end_el(&$output, $category, $depth, $args) {
- $output .= " \n";
- }
-}
+ $r = wp_parse_args( $params, $defaults );
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $post_id
- * @param unknown_type $descendants_and_self
- * @param unknown_type $selected_cats
- * @param unknown_type $popular_cats
- */
-function wp_category_checklist( $post_id = 0, $descendants_and_self = 0, $selected_cats = false, $popular_cats = false, $walker = null ) {
- if ( empty($walker) || !is_a($walker, 'Walker') )
+ if ( empty( $r['walker'] ) || ! ( $r['walker'] instanceof Walker ) ) {
$walker = new Walker_Category_Checklist;
-
- $descendants_and_self = (int) $descendants_and_self;
-
- $args = array();
-
- if ( is_array( $selected_cats ) )
- $args['selected_cats'] = $selected_cats;
- elseif ( $post_id )
- $args['selected_cats'] = wp_get_post_categories($post_id);
- else
- $args['selected_cats'] = array();
-
- if ( is_array( $popular_cats ) )
- $args['popular_cats'] = $popular_cats;
- else
- $args['popular_cats'] = get_terms( 'category', array( 'fields' => 'ids', 'orderby' => 'count', 'order' => 'DESC', 'number' => 10, 'hierarchical' => false ) );
-
- if ( $descendants_and_self ) {
- $categories = get_categories( "child_of=$descendants_and_self&hierarchical=0&hide_empty=0" );
- $self = get_category( $descendants_and_self );
- array_unshift( $categories, $self );
} else {
- $categories = get_categories('get=all');
- }
-
- // Post process $categories rather than adding an exclude to the get_terms() query to keep the query the same across all posts (for any query cache)
- $checked_categories = array();
- for ( $i = 0; isset($categories[$i]); $i++ ) {
- if ( in_array($categories[$i]->term_id, $args['selected_cats']) ) {
- $checked_categories[] = $categories[$i];
- unset($categories[$i]);
- }
- }
-
- // Put checked cats on top
- echo call_user_func_array(array(&$walker, 'walk'), array($checked_categories, 0, $args));
- // Then the rest of them
- echo call_user_func_array(array(&$walker, 'walk'), array($categories, 0, $args));
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $taxonomy
- * @param unknown_type $default
- * @param unknown_type $number
- * @param unknown_type $echo
- * @return unknown
- */
-function wp_popular_terms_checklist( $taxonomy, $default = 0, $number = 10, $echo = true ) {
- global $post_ID;
- if ( $post_ID )
- $checked_categories = wp_get_post_categories($post_ID);
- else
- $checked_categories = array();
- $categories = get_terms( $taxonomy, array( 'orderby' => 'count', 'order' => 'DESC', 'number' => $number, 'hierarchical' => false ) );
-
- $popular_ids = array();
- foreach ( (array) $categories as $category ) {
- $popular_ids[] = $category->term_id;
- if ( !$echo ) // hack for AJAX use
- continue;
- $id = "popular-category-$category->term_id";
- ?>
-
-
-
-
- name ) ); ?>
-
-
-
- $taxonomy );
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $link_id
- */
-function wp_link_category_checklist( $link_id = 0 ) {
- $default = 1;
+ $tax = get_taxonomy( $taxonomy );
+ $args['disabled'] = ! current_user_can( $tax->cap->assign_terms );
- if ( $link_id ) {
- $checked_categories = wp_get_link_cats($link_id);
+ $args['list_only'] = ! empty( $r['list_only'] );
- if ( count( $checked_categories ) == 0 ) {
- // No selected categories, strange
- $checked_categories[] = $default;
- }
+ if ( is_array( $r['selected_cats'] ) ) {
+ $args['selected_cats'] = $r['selected_cats'];
+ } elseif ( $post_id ) {
+ $args['selected_cats'] = wp_get_object_terms( $post_id, $taxonomy, array_merge( $args, array( 'fields' => 'ids' ) ) );
} else {
- $checked_categories[] = $default;
+ $args['selected_cats'] = array();
}
-
- $categories = get_terms('link_category', 'orderby=count&hide_empty=0');
-
- if ( empty($categories) )
- return;
-
- foreach ( $categories as $category ) {
- $cat_id = $category->term_id;
- $name = wp_specialchars( apply_filters('the_category', $category->name));
- $checked = in_array( $cat_id, $checked_categories );
- echo ' ', $name, " ";
+ if ( is_array( $r['popular_cats'] ) ) {
+ $args['popular_cats'] = $r['popular_cats'];
+ } else {
+ $args['popular_cats'] = get_terms( $taxonomy, array(
+ 'fields' => 'ids',
+ 'orderby' => 'count',
+ 'order' => 'DESC',
+ 'number' => 10,
+ 'hierarchical' => false
+ ) );
}
-}
-
-// Tag stuff
-
-// Returns a single tag row (see tag_rows below)
-// Note: this is also used in admin-ajax.php!
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $tag
- * @param unknown_type $class
- * @return unknown
- */
-function _tag_row( $tag, $class = '' ) {
- $count = number_format_i18n( $tag->count );
- $count = ( $count > 0 ) ? "$count " : $count;
-
- $name = apply_filters( 'term_name', $tag->name );
- $qe_data = get_term($tag->term_id, 'post_tag', object, 'edit');
- $edit_link = "edit-tags.php?action=edit&tag_ID=$tag->term_id";
- $out = '';
- $out .= '';
- $columns = get_column_headers('edit-tags');
- $hidden = get_hidden_columns('edit-tags');
- foreach ( $columns as $column_name => $column_display_name ) {
- $class = "class=\"$column_name column-$column_name\"";
-
- $style = '';
- if ( in_array($column_name, $hidden) )
- $style = ' style="display:none;"';
-
- $attributes = "$class$style";
-
- switch ($column_name) {
- case 'cb':
- $out .= ' ';
- break;
- case 'name':
- $out .= '' . $name . ' ';
- $actions = array();
- $actions['edit'] = '' . __('Edit') . ' ';
- $actions['inline hide-if-no-js'] = '' . __('Quick Edit') . ' ';
- $actions['delete'] = "term_id) . "' onclick=\"if ( confirm('" . js_escape(sprintf(__("You are about to delete this tag '%s'\n 'Cancel' to stop, 'OK' to delete."), $name )) . "') ) { return true;}return false;\">" . __('Delete') . " ";
- $action_count = count($actions);
- $i = 0;
- $out .= '';
- foreach ( $actions as $action => $link ) {
- ++$i;
- ( $i == $action_count ) ? $sep = '' : $sep = ' | ';
- $out .= "$link$sep ";
- }
- $out .= '
';
- $out .= '';
- $out .= '
' . $qe_data->name . '
';
- $out .= '
' . $qe_data->slug . '
';
- break;
- case 'slug':
- $out .= "$tag->slug ";
- break;
- case 'posts':
- $attributes = 'class="posts column-posts num"' . $style;
- $out .= "$count ";
- break;
- }
- }
-
- $out .= ' ';
-
- return $out;
-}
-
-// Outputs appropriate rows for the Nth page of the Tag Management screen,
-// assuming M tags displayed at a time on the page
-// Returns the number of tags displayed
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $page
- * @param unknown_type $pagesize
- * @param unknown_type $searchterms
- * @return unknown
- */
-function tag_rows( $page = 1, $pagesize = 20, $searchterms = '' ) {
-
- // Get a page worth of tags
- $start = ($page - 1) * $pagesize;
-
- $args = array('offset' => $start, 'number' => $pagesize, 'hide_empty' => 0);
-
- if ( !empty( $searchterms ) ) {
- $args['search'] = $searchterms;
+ if ( $descendants_and_self ) {
+ $categories = (array) get_terms( $taxonomy, array(
+ 'child_of' => $descendants_and_self,
+ 'hierarchical' => 0,
+ 'hide_empty' => 0
+ ) );
+ $self = get_term( $descendants_and_self, $taxonomy );
+ array_unshift( $categories, $self );
+ } else {
+ $categories = (array) get_terms( $taxonomy, array( 'get' => 'all' ) );
}
- $tags = get_terms( 'post_tag', $args );
-
- // convert it to table rows
- $out = '';
- $count = 0;
- foreach( $tags as $tag )
- $out .= _tag_row( $tag, ++$count % 2 ? ' class="iedit alternate"' : ' class="iedit"' );
-
- // filter and send to screen
- echo $out;
- return $count;
-}
-
-// define the columns to display, the syntax is 'internal name' => 'display name'
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @return unknown
- */
-function wp_manage_posts_columns() {
- $posts_columns = array();
- $posts_columns['cb'] = ' ';
- $posts_columns['title'] = _c('Post|noun');
- $posts_columns['author'] = __('Author');
- $posts_columns['categories'] = __('Categories');
- $posts_columns['tags'] = __('Tags');
- if ( !isset($_GET['post_status']) || !in_array($_GET['post_status'], array('pending', 'draft', 'future')) )
- $posts_columns['comments'] = ' ';
- $posts_columns['date'] = __('Date');
- $posts_columns = apply_filters('manage_posts_columns', $posts_columns);
-
- return $posts_columns;
-}
-
-// define the columns to display, the syntax is 'internal name' => 'display name'
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @return unknown
- */
-function wp_manage_media_columns() {
- $posts_columns = array();
- $posts_columns['cb'] = ' ';
- $posts_columns['icon'] = '';
- $posts_columns['media'] = _c('File|media column header');
- $posts_columns['author'] = __('Author');
- //$posts_columns['tags'] = _c('Tags|media column header');
- $posts_columns['parent'] = _c('Attached to|media column header');
- $posts_columns['comments'] = ' ';
- //$posts_columns['comments'] = __('Comments');
- $posts_columns['date'] = _c('Date|media column header');
- $posts_columns = apply_filters('manage_media_columns', $posts_columns);
-
- return $posts_columns;
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @return unknown
- */
-function wp_manage_pages_columns() {
- $posts_columns = array();
- $posts_columns['cb'] = ' ';
- $posts_columns['title'] = __('Title');
- $posts_columns['author'] = __('Author');
- $post_status = 'all';
- if ( !empty($_GET['post_status']) )
- $post_status = $_GET['post_status'];
- if ( !in_array($post_status, array('pending', 'draft', 'future')) )
- $posts_columns['comments'] = ' ';
- $posts_columns['date'] = __('Date');
- $posts_columns = apply_filters('manage_pages_columns', $posts_columns);
-
- return $posts_columns;
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $page
- * @return unknown
- */
-function get_column_headers($page) {
- global $_wp_column_headers;
-
- if ( !isset($_wp_column_headers) )
- $_wp_column_headers = array();
-
- // Store in static to avoid running filters on each call
- if ( isset($_wp_column_headers[$page]) )
- return $_wp_column_headers[$page];
-
- switch ($page) {
- case 'edit':
- $_wp_column_headers[$page] = wp_manage_posts_columns();
- break;
- case 'edit-pages':
- $_wp_column_headers[$page] = wp_manage_pages_columns();
- break;
- case 'edit-comments':
- $_wp_column_headers[$page] = array(
- 'cb' => ' ',
- 'author' => __('Author'),
- 'comment' => _c('Comment|noun'),
- //'date' => __('Submitted'),
- 'response' => __('In Response To')
- );
-
- break;
- case 'link-manager':
- $_wp_column_headers[$page] = array(
- 'cb' => ' ',
- 'name' => __('Name'),
- 'url' => __('URL'),
- 'categories' => __('Categories'),
- 'rel' => __('rel'),
- 'visible' => __('Visible')
- );
-
- break;
- case 'upload':
- $_wp_column_headers[$page] = wp_manage_media_columns();
- break;
- case 'categories':
- $_wp_column_headers[$page] = array(
- 'cb' => ' ',
- 'name' => __('Name'),
- 'description' => __('Description'),
- 'slug' => __('Slug'),
- 'posts' => __('Posts')
- );
-
- break;
- case 'edit-link-categories':
- $_wp_column_headers[$page] = array(
- 'cb' => ' ',
- 'name' => __('Name'),
- 'description' => __('Description'),
- 'slug' => __('Slug'),
- 'links' => __('Links')
- );
-
- break;
- case 'edit-tags':
- $_wp_column_headers[$page] = array(
- 'cb' => ' ',
- 'name' => __('Name'),
- 'slug' => __('Slug'),
- 'posts' => __('Posts')
- );
-
- break;
- case 'users':
- $_wp_column_headers[$page] = array(
- 'cb' => ' ',
- 'username' => __('Username'),
- 'name' => __('Name'),
- 'email' => __('E-mail'),
- 'role' => __('Role'),
- 'posts' => __('Posts')
- );
- break;
- default :
- $_wp_column_headers[$page] = array();
- }
+ $output = '';
- $_wp_column_headers[$page] = apply_filters('manage_' . $page . '_columns', $_wp_column_headers[$page]);
- return $_wp_column_headers[$page];
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $type
- * @param unknown_type $id
- */
-function print_column_headers( $type, $id = true ) {
- $type = str_replace('.php', '', $type);
- $columns = get_column_headers( $type );
- $hidden = get_hidden_columns($type);
- $styles = array();
-// $styles['tag']['posts'] = 'width: 90px;';
-// $styles['link-category']['links'] = 'width: 90px;';
-// $styles['category']['posts'] = 'width: 90px;';
-// $styles['link']['visible'] = 'text-align: center;';
-
- foreach ( $columns as $column_key => $column_display_name ) {
- $class = ' class="manage-column';
-
- $class .= " column-$column_key";
-
- if ( 'cb' == $column_key )
- $class .= ' check-column';
- elseif ( in_array($column_key, array('posts', 'comments', 'links')) )
- $class .= ' num';
-
- $class .= '"';
-
- $style = '';
- if ( in_array($column_key, $hidden) )
- $style = 'display:none;';
-
- if ( isset($styles[$type]) && isset($styles[$type][$column_key]) )
- $style .= ' ' . $styles[$type][$column_key];
- $style = ' style="' . $style . '"';
-?>
- >
- true, 'date' => true, 'title' => true, 'categories' => true, 'tags' => true, 'comments' => true, 'author' => true );
-
-?>
-
-
-post_type, $post->ID) )
- return;
-
- $title = attribute_escape($post->post_title);
-
- echo '
-
-
' . $title . '
-
' . $post->post_name . '
-
' . $post->post_author . '
-
-
' . $post->ping_status . '
-
' . $post->post_status . '
-
' . mysql2date( 'd', $post->post_date ) . '
-
' . mysql2date( 'm', $post->post_date ) . '
-
' . mysql2date( 'Y', $post->post_date ) . '
-
' . mysql2date( 'H', $post->post_date ) . '
-
' . mysql2date( 'i', $post->post_date ) . '
-
' . mysql2date( 's', $post->post_date ) . '
-
' . wp_specialchars($post->post_password, 1) . '
';
-
- if( $post->post_type == 'page' )
- echo '
-
' . $post->post_parent . '
-
' . wp_specialchars(get_post_meta( $post->ID, '_wp_page_template', true ), 1) . '
- ';
-
- if( $post->post_type == 'post' )
- echo '
-
' . wp_specialchars( str_replace( ',', ', ', get_tags_to_edit($post->ID) ), 1) . '
-
' . implode( ',', wp_get_post_categories( $post->ID ) ) . '
-
' . (is_sticky($post->ID) ? 'sticky' : '') . '
';
-
- echo '
';
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $posts
- */
-function post_rows( $posts = array() ) {
- global $wp_query, $post, $mode;
-
- add_filter('the_title','wp_specialchars');
-
- // Create array of post IDs.
- $post_ids = array();
-
- if ( empty($posts) )
- $posts = &$wp_query->posts;
-
- foreach ( $posts as $a_post )
- $post_ids[] = $a_post->ID;
-
- $comment_pending_count = get_pending_comments_num($post_ids);
- if ( empty($comment_pending_count) )
- $comment_pending_count = array();
-
- foreach ( $posts as $post ) {
- if ( empty($comment_pending_count[$post->ID]) )
- $comment_pending_count[$post->ID] = 0;
-
- _post_row($post, $comment_pending_count[$post->ID], $mode);
- }
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $a_post
- * @param unknown_type $pending_comments
- * @param unknown_type $mode
- */
-function _post_row($a_post, $pending_comments, $mode) {
- global $post;
- static $rowclass;
-
- $global_post = $post;
- $post = $a_post;
- setup_postdata($post);
-
- $rowclass = 'alternate' == $rowclass ? '' : 'alternate';
- global $current_user;
- $post_owner = ( $current_user->ID == $post->post_author ? 'self' : 'other' );
- $edit_link = get_edit_post_link( $post->ID );
- $title = _draft_or_post_title();
-?>
- post_status ); ?> iedit' valign="top">
-$column_display_name ) {
- $class = "class=\"$column_name column-$column_name\"";
-
- $style = '';
- if ( in_array($column_name, $hidden) )
- $style = ' style="display:none;"';
-
- $attributes = "$class$style";
-
- switch ($column_name) {
-
- case 'cb':
- ?>
- ID ) ) { ?>
- post_date && 'date' == $column_name ) {
- $t_time = $h_time = __('Unpublished');
- } else {
- $t_time = get_the_time(__('Y/m/d g:i:s A'));
- $m_time = $post->post_date;
- $time = get_post_time('G', true, $post);
-
- $time_diff = time() - $time;
-
- if ( ( 'future' == $post->post_status) ) {
- if ( $time_diff <= 0 ) {
- $h_time = sprintf( __('%s from now'), human_time_diff( $time ) );
- } else {
- $h_time = $t_time;
- $missed = true;
- }
- } else {
-
- if ( $time_diff > 0 && $time_diff < 24*60*60 )
- $h_time = sprintf( __('%s ago'), human_time_diff( $time ) );
- else
- $h_time = mysql2date(__('Y/m/d'), $m_time);
- }
- }
-
- echo '';
- if ( 'excerpt' == $mode )
- echo apply_filters('post_date_column_time', $t_time, $post, $column_name, $mode);
- else
- echo '' . apply_filters('post_date_column_time', $h_time, $post, $column_name, $mode) . ' ';
- echo ' ';
- if ( 'publish' == $post->post_status ) {
- _e('Published');
- } elseif ( 'future' == $post->post_status ) {
- if ( isset($missed) )
- echo '' . __('Missed schedule') . ' ';
- else
- _e('Scheduled');
- } else {
- _e('Last Modified');
- }
- echo ' ';
- break;
-
- case 'title':
- $attributes = 'class="post-title column-title"' . $style;
- ?>
- >ID ) ) { ?>">
- ID) ) {
- $actions['edit'] = '' . __('Edit') . ' ';
- $actions['inline hide-if-no-js'] = '' . __('Quick Edit') . ' ';
- $actions['delete'] = "ID) . "' onclick=\"if ( confirm('" . js_escape(sprintf( ('draft' == $post->post_status) ? __("You are about to delete this draft '%s'\n 'Cancel' to stop, 'OK' to delete.") : __("You are about to delete this post '%s'\n 'Cancel' to stop, 'OK' to delete."), $post->post_title )) . "') ) { return true;}return false;\">" . __('Delete') . " ";
- }
- if ( in_array($post->post_status, array('pending', 'draft')) ) {
- if ( current_user_can('edit_post', $post->ID) )
- $actions['view'] = '' . __('Preview') . ' ';
- } else {
- $actions['view'] = '' . __('View') . ' ';
- }
- $action_count = count($actions);
- $i = 0;
- echo '';
- foreach ( $actions as $action => $link ) {
- ++$i;
- ( $i == $action_count ) ? $sep = '' : $sep = ' | ';
- echo "$link$sep ";
- }
- echo '
';
-
- get_inline_data($post);
- ?>
-
-
- >slug'> " . wp_specialchars(sanitize_term_field('name', $c->name, $c->term_id, 'category', 'display')) . "";
- echo join( ', ', $out );
- } else {
- _e('Uncategorized');
- }
- ?>
-
- >ID);
- if ( !empty( $tags ) ) {
- $out = array();
- foreach ( $tags as $c )
- $out[] = " " . wp_specialchars(sanitize_term_field('name', $c->name, $c->term_id, 'post_tag', 'display')) . " ";
- echo join( ', ', $out );
- } else {
- _e('No Tags');
- }
- ?>
-
- >
- ';
- comments_number("
', "
', "
');
- if ( $pending_comments )
- echo '';
- ?>
-
-
- >
-
-
-
- ID) ) { echo "" . __('Edit') . " "; } ?>
-
- ID) ) { echo "ID) . "' class='delete'>" . __('Delete') . " "; } ?>
-
- >ID); ?>
-
-
-post_title = wp_specialchars( $page->post_title );
- $pad = str_repeat( '— ', $level );
- $id = (int) $page->ID;
- $rowclass = 'alternate' == $rowclass ? '' : 'alternate';
- $posts_columns = get_column_headers('edit-pages');
- $hidden = get_hidden_columns('edit-pages');
- $title = _draft_or_post_title();
-?>
-
-$column_display_name) {
- $class = "class=\"$column_name column-$column_name\"";
-
- $style = '';
- if ( in_array($column_name, $hidden) )
- $style = ' style="display:none;"';
-
- $attributes = "$class$style";
-
- switch ($column_name) {
-
- case 'cb':
- ?>
-
- post_date && 'date' == $column_name ) {
- $t_time = $h_time = __('Unpublished');
- } else {
- $t_time = get_the_time(__('Y/m/d g:i:s A'));
- $m_time = $page->post_date;
- $time = get_post_time('G', true);
-
- if ( ( abs(time() - $time) ) < 86400 ) {
- if ( ( 'future' == $page->post_status) )
- $h_time = sprintf( __('%s from now'), human_time_diff( $time ) );
- else
- $h_time = sprintf( __('%s ago'), human_time_diff( $time ) );
- } else {
- $h_time = mysql2date(__('Y/m/d'), $m_time);
- }
- }
- echo '';
- echo '' . apply_filters('post_date_column_time', $h_time, $page, $column_name, '') . ' ';
- echo ' ';
- if ( 'publish' == $page->post_status || 'future' == $page->post_status )
- _e('Published');
- else
- _e('Last Modified');
- echo ' ';
- break;
- case 'title':
- $attributes = 'class="post-title page-title column-title"' . $style;
- $edit_link = get_edit_post_link( $page->ID );
- ?>
- >ID ) ) { ?>">
- ID) ) {
- $actions['edit'] = '' . __('Edit') . ' ';
- $actions['inline'] = '' . __('Quick Edit') . ' ';
- $actions['delete'] = "ID) . "' onclick=\"if ( confirm('" . js_escape(sprintf( ('draft' == $page->post_status) ? __("You are about to delete this draft '%s'\n 'Cancel' to stop, 'OK' to delete.") : __("You are about to delete this page '%s'\n 'Cancel' to stop, 'OK' to delete."), $page->post_title )) . "') ) { return true;}return false;\">" . __('Delete') . " ";
- }
- if ( in_array($post->post_status, array('pending', 'draft')) ) {
- if ( current_user_can('edit_page', $page->ID) )
- $actions['view'] = '' . __('Preview') . ' ';
- } else {
- $actions['view'] = '' . __('View') . ' ';
- }
- $action_count = count($actions);
-
- $i = 0;
- echo '';
- foreach ( $actions as $action => $link ) {
- ++$i;
- ( $i == $action_count ) ? $sep = '' : $sep = ' | ';
- echo "$link$sep ";
- }
- echo '
';
-
- get_inline_data($post);
- echo ' ';
- break;
-
- case 'comments':
- ?>
- >
- ID );
- $pending_phrase = sprintf( __('%s pending'), number_format( $left ) );
- if ( $left )
- echo '
';
- comments_number(" ', " ', " ');
- if ( $left )
- echo ' ';
- ?>
-
-
- >
-
- >
-
-
-
-
- 'menu_order') );
-
- if ( ! $pages )
- return false;
- }
-
- /*
- * arrange pages into two parts: top level pages and children_pages
- * children_pages is two dimensional array, eg.
- * children_pages[10][] contains all sub-pages whose parent is 10.
- * It only takes O(N) to arrange this and it takes O(1) for subsequent lookup operations
- * If searching, ignore hierarchy and treat everything as top level
- */
- if ( empty($_GET['s']) ) {
-
- $top_level_pages = array();
- $children_pages = array();
-
- foreach ( $pages as $page ) {
-
- // catch and repair bad pages
- if ( $page->post_parent == $page->ID ) {
- $page->post_parent = 0;
- $wpdb->query( $wpdb->prepare("UPDATE $wpdb->posts SET post_parent = '0' WHERE ID = %d", $page->ID) );
- clean_page_cache( $page->ID );
- }
-
- if ( 0 == $page->post_parent )
- $top_level_pages[] = $page;
- else
- $children_pages[ $page->post_parent ][] = $page;
- }
-
- $pages = &$top_level_pages;
- }
-
- $count = 0;
- $start = ($pagenum - 1) * $per_page;
- $end = $start + $per_page;
-
- foreach ( $pages as $page ) {
- if ( $count >= $end )
- break;
-
- if ( $count >= $start )
- echo "\t" . display_page_row( $page, $level );
-
- $count++;
-
- if ( isset($children_pages) )
- _page_rows( $children_pages, $count, $page->ID, $level + 1, $pagenum, $per_page );
- }
+ if ( $r['checked_ontop'] ) {
+ // Post process $categories rather than adding an exclude to the get_terms() query to keep the query the same across all posts (for any query cache)
+ $checked_categories = array();
+ $keys = array_keys( $categories );
- // if it is the last pagenum and there are orphaned pages, display them with paging as well
- if ( isset($children_pages) && $count < $end ){
- foreach( $children_pages as $orphans ){
- foreach ( $orphans as $op ) {
- if ( $count >= $end )
- break;
- if ( $count >= $start )
- echo "\t" . display_page_row( $op, 0 );
- $count++;
+ foreach ( $keys as $k ) {
+ if ( in_array( $categories[$k]->term_id, $args['selected_cats'] ) ) {
+ $checked_categories[] = $categories[$k];
+ unset( $categories[$k] );
}
}
+
+ // Put checked cats on top
+ $output .= call_user_func_array( array( $walker, 'walk' ), array( $checked_categories, 0, $args ) );
+ }
+ // Then the rest of them
+ $output .= call_user_func_array( array( $walker, 'walk' ), array( $categories, 0, $args ) );
+
+ if ( $r['echo'] ) {
+ echo $output;
}
+
+ return $output;
}
-/*
- * Given a top level page ID, display the nested hierarchy of sub-pages
- * together with paging support
- */
/**
- * {@internal Missing Short Description}}
+ * Retrieve a list of the most popular terms from the specified taxonomy.
+ *
+ * If the $echo argument is true then the elements for a list of checkbox
+ * ` ` elements labelled with the names of the selected terms is output.
+ * If the $post_ID global isn't empty then the terms associated with that
+ * post will be marked as checked.
*
- * @since unknown
+ * @since 2.5.0
*
- * @param unknown_type $children_pages
- * @param unknown_type $count
- * @param unknown_type $parent
- * @param unknown_type $level
- * @param unknown_type $pagenum
- * @param unknown_type $per_page
+ * @param string $taxonomy Taxonomy to retrieve terms from.
+ * @param int $default Not used.
+ * @param int $number Number of terms to retrieve. Defaults to 10.
+ * @param bool $echo Optionally output the list as well. Defaults to true.
+ * @return array List of popular term IDs.
*/
-function _page_rows( &$children_pages, &$count, $parent, $level, $pagenum, $per_page ) {
-
- if ( ! isset( $children_pages[$parent] ) )
- return;
-
- $start = ($pagenum - 1) * $per_page;
- $end = $start + $per_page;
+function wp_popular_terms_checklist( $taxonomy, $default = 0, $number = 10, $echo = true ) {
+ $post = get_post();
- foreach ( $children_pages[$parent] as $page ) {
+ if ( $post && $post->ID )
+ $checked_terms = wp_get_object_terms($post->ID, $taxonomy, array('fields'=>'ids'));
+ else
+ $checked_terms = array();
- if ( $count >= $end )
- break;
+ $terms = get_terms( $taxonomy, array( 'orderby' => 'count', 'order' => 'DESC', 'number' => $number, 'hierarchical' => false ) );
- // If the page starts in a subtree, print the parents.
- if ( $count == $start && $page->post_parent > 0 ) {
- $my_parents = array();
- $my_parent = $page->post_parent;
- while ( $my_parent) {
- $my_parent = get_post($my_parent);
- $my_parents[] = $my_parent;
- if ( !$my_parent->post_parent )
- break;
- $my_parent = $my_parent->post_parent;
- }
- $num_parents = count($my_parents);
- while( $my_parent = array_pop($my_parents) ) {
- echo "\t" . display_page_row( $my_parent, $level - $num_parents );
- $num_parents--;
- }
- }
+ $tax = get_taxonomy($taxonomy);
- if ( $count >= $start )
- echo "\t" . display_page_row( $page, $level );
+ $popular_ids = array();
+ foreach ( (array) $terms as $term ) {
+ $popular_ids[] = $term->term_id;
+ if ( !$echo ) // hack for AJAX use
+ continue;
+ $id = "popular-$taxonomy-$term->term_id";
+ $checked = in_array( $term->term_id, $checked_terms ) ? 'checked="checked"' : '';
+ ?>
- $count++;
+
+
+ value="term_id; ?>" cap->assign_terms ) ); ?> />
+ name ) );
+ ?>
+
+
- _page_rows( $children_pages, $count, $page->ID, $level + 1, $pagenum, $per_page );
+ user_email;
- $url = $user_object->user_url;
- $short_url = str_replace( 'http://', '', $url );
- $short_url = str_replace( 'www.', '', $short_url );
- if ('/' == substr( $short_url, -1 ))
- $short_url = substr( $short_url, 0, -1 );
- if ( strlen( $short_url ) > 35 )
- $short_url = substr( $short_url, 0, 32 ).'...';
- $numposts = get_usernumposts( $user_object->ID );
- if ( current_user_can( 'edit_user', $user_object->ID ) ) {
- if ($current_user->ID == $user_object->ID) {
- $edit_link = 'profile.php';
- } else {
- $edit_link = clean_url( add_query_arg( 'wp_http_referer', urlencode( clean_url( stripslashes( $_SERVER['REQUEST_URI'] ) ) ), "user-edit.php?user_id=$user_object->ID" ) );
- }
- $edit = "$user_object->user_login ";
- $actions = array();
- $actions['edit'] = '' . __('Edit') . ' ';
- if ( $current_user->ID != $user_object->ID )
- $actions['delete'] = "" . __('Delete') . " ";
- $action_count = count($actions);
- $i = 0;
- $edit .= '';
- foreach ( $actions as $action => $link ) {
- ++$i;
- ( $i == $action_count ) ? $sep = '' : $sep = ' | ';
- $edit .= "$link$sep ";
+function wp_link_category_checklist( $link_id = 0 ) {
+ $default = 1;
+
+ $checked_categories = array();
+
+ if ( $link_id ) {
+ $checked_categories = wp_get_link_cats( $link_id );
+ // No selected categories, strange
+ if ( ! count( $checked_categories ) ) {
+ $checked_categories[] = $default;
}
- $edit .= '
';
} else {
- $edit = '' . $user_object->user_login . ' ';
- }
- $role_name = isset($wp_roles->role_names[$role]) ? translate_with_context($wp_roles->role_names[$role]) : __('None');
- $r = "";
- $columns = get_column_headers('users');
- $hidden = get_hidden_columns('users');
- $avatar = get_avatar( $user_object->user_email, 32 );
- foreach ( $columns as $column_name => $column_display_name ) {
- $class = "class=\"$column_name column-$column_name\"";
-
- $style = '';
- if ( in_array($column_name, $hidden) )
- $style = ' style="display:none;"';
-
- $attributes = "$class$style";
-
- switch ($column_name) {
- case 'cb':
- $r .= " ";
- break;
- case 'username':
- $r .= "$avatar $edit ";
- break;
- case 'name':
- $r .= "$user_object->first_name $user_object->last_name ";
- break;
- case 'email':
- $r .= "$email ";
- break;
- case 'role':
- $r .= "$role_name ";
- break;
- case 'posts':
- $attributes = 'class="posts column-posts num"' . $style;
- $r .= "";
- if ( $numposts > 0 ) {
- $r .= "";
- $r .= $numposts;
- $r .= ' ';
- } else {
- $r .= 0;
- }
- $r .= " ";
- }
+ $checked_categories[] = $default;
}
- $r .= ' ';
- return $r;
+ $categories = get_terms( 'link_category', array( 'orderby' => 'name', 'hide_empty' => 0 ) );
+
+ if ( empty( $categories ) )
+ return;
+
+ foreach ( $categories as $category ) {
+ $cat_id = $category->term_id;
+
+ /** This filter is documented in wp-includes/category-template.php */
+ $name = esc_html( apply_filters( 'the_category', $category->name ) );
+ $checked = in_array( $cat_id, $checked_categories ) ? ' checked="checked"' : '';
+ echo ' ', $name, " ";
+ }
}
/**
- * {@internal Missing Short Description}}
+ * Adds hidden fields with the data for use in the inline editor for posts and pages.
*
- * @since unknown
+ * @since 2.7.0
*
- * @param unknown_type $status
- * @param unknown_type $s
- * @param unknown_type $start
- * @param unknown_type $num
- * @param unknown_type $post
- * @param unknown_type $type
- * @return unknown
+ * @param WP_Post $post Post object.
*/
-function _wp_get_comment_list( $status = '', $s = false, $start, $num, $post = 0, $type = '' ) {
- global $wpdb;
-
- $start = abs( (int) $start );
- $num = (int) $num;
- $post = (int) $post;
-
- if ( 'moderated' == $status )
- $approved = "comment_approved = '0'";
- elseif ( 'approved' == $status )
- $approved = "comment_approved = '1'";
- elseif ( 'spam' == $status )
- $approved = "comment_approved = 'spam'";
- else
- $approved = "( comment_approved = '0' OR comment_approved = '1' )";
+function get_inline_data($post) {
+ $post_type_object = get_post_type_object($post->post_type);
+ if ( ! current_user_can( 'edit_post', $post->ID ) )
+ return;
- if ( $post ) {
- $post = " AND comment_post_ID = '$post'";
- $orderby = "ORDER BY comment_date_gmt ASC LIMIT $start, $num";
- } else {
- $post = '';
- $orderby = "ORDER BY comment_date_gmt DESC LIMIT $start, $num";
- }
+ $title = esc_textarea( trim( $post->post_title ) );
- if ( 'comment' == $type )
- $typesql = "AND comment_type = ''";
- elseif ( 'pingback' == $type )
- $typesql = "AND comment_type = 'pingback'";
- elseif ( 'trackback' == $type )
- $typesql = "AND comment_type = 'trackback'";
- elseif ( 'pings' == $type )
- $typesql = "AND ( comment_type = 'pingback' OR comment_type = 'trackback' )";
- else
- $typesql = '';
-
- if ( $s ) {
- $s = $wpdb->escape($s);
- $comments = $wpdb->get_results("SELECT SQL_CALC_FOUND_ROWS * FROM $wpdb->comments WHERE
- (comment_author LIKE '%$s%' OR
- comment_author_email LIKE '%$s%' OR
- comment_author_url LIKE ('%$s%') OR
- comment_author_IP LIKE ('%$s%') OR
- comment_content LIKE ('%$s%') ) AND
- $approved
- $typesql
- $orderby");
- } else {
- $comments = $wpdb->get_results( "SELECT SQL_CALC_FOUND_ROWS * FROM $wpdb->comments WHERE $approved $post $typesql $orderby" );
- }
+ /** This filter is documented in wp-admin/edit-tag-form.php */
+ echo '
+
+
' . $title . '
' .
+ /** This filter is documented in wp-admin/edit-tag-form.php */
+ '
' . apply_filters( 'editable_slug', $post->post_name, $post ) . '
+
' . $post->post_author . '
+
+
' . esc_html( $post->ping_status ) . '
+
' . esc_html( $post->post_status ) . '
+
' . mysql2date( 'd', $post->post_date, false ) . '
+
' . mysql2date( 'm', $post->post_date, false ) . '
+
' . mysql2date( 'Y', $post->post_date, false ) . '
+
' . mysql2date( 'H', $post->post_date, false ) . '
+
' . mysql2date( 'i', $post->post_date, false ) . '
+
' . mysql2date( 's', $post->post_date, false ) . '
+
' . esc_html( $post->post_password ) . '
';
+
+ if ( $post_type_object->hierarchical )
+ echo '
' . $post->post_parent . '
';
+
+ if ( $post->post_type == 'page' )
+ echo '
' . esc_html( get_post_meta( $post->ID, '_wp_page_template', true ) ) . '
';
+
+ if ( post_type_supports( $post->post_type, 'page-attributes' ) )
+ echo '';
+
+ $taxonomy_names = get_object_taxonomies( $post->post_type );
+ foreach ( $taxonomy_names as $taxonomy_name) {
+ $taxonomy = get_taxonomy( $taxonomy_name );
+
+ if ( $taxonomy->hierarchical && $taxonomy->show_ui ) {
+
+ $terms = get_object_term_cache( $post->ID, $taxonomy_name );
+ if ( false === $terms ) {
+ $terms = wp_get_object_terms( $post->ID, $taxonomy_name );
+ wp_cache_add( $post->ID, $terms, $taxonomy_name . '_relationships' );
+ }
+ $term_ids = empty( $terms ) ? array() : wp_list_pluck( $terms, 'term_id' );
- update_comment_cache($comments);
+ echo '
' . implode( ',', $term_ids ) . '
';
- $total = $wpdb->get_var( "SELECT FOUND_ROWS()" );
+ } elseif ( $taxonomy->show_ui ) {
- return array($comments, $total);
-}
+ $terms_to_edit = get_terms_to_edit( $post->ID, $taxonomy_name );
+ if ( ! is_string( $terms_to_edit ) ) {
+ $terms_to_edit = '';
+ }
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $comment_id
- * @param unknown_type $mode
- * @param unknown_type $comment_status
- * @param unknown_type $checkbox
- */
-function _wp_comment_row( $comment_id, $mode, $comment_status, $checkbox = true, $from_ajax = false ) {
- global $comment, $post, $_comment_pending_count;
- $comment = get_comment( $comment_id );
- $post = get_post($comment->comment_post_ID);
- $the_comment_status = wp_get_comment_status($comment->comment_ID);
-
- $author_url = get_comment_author_url();
- if ( 'http://' == $author_url )
- $author_url = '';
- $author_url_display = $author_url;
- $author_url_display = str_replace('http://www.', '', $author_url_display);
- $author_url_display = str_replace('http://', '', $author_url_display);
- if ( strlen($author_url_display) > 50 )
- $author_url_display = substr($author_url_display, 0, 49) . '...';
-
- $ptime = date('G', strtotime( $comment->comment_date ) );
- if ( ( abs(time() - $ptime) ) < 86400 )
- $ptime = sprintf( __('%s ago'), human_time_diff( $ptime ) );
- else
- $ptime = mysql2date(__('Y/m/d \a\t g:i A'), $comment->comment_date );
-
- $delete_url = clean_url( wp_nonce_url( "comment.php?action=deletecomment&p=$post->ID&c=$comment->comment_ID", "delete-comment_$comment->comment_ID" ) );
- $approve_url = clean_url( wp_nonce_url( "comment.php?action=approvecomment&p=$post->ID&c=$comment->comment_ID", "approve-comment_$comment->comment_ID" ) );
- $unapprove_url = clean_url( wp_nonce_url( "comment.php?action=unapprovecomment&p=$post->ID&c=$comment->comment_ID", "unapprove-comment_$comment->comment_ID" ) );
- $spam_url = clean_url( wp_nonce_url( "comment.php?action=deletecomment&dt=spam&p=$post->ID&c=$comment->comment_ID", "delete-comment_$comment->comment_ID" ) );
-
- echo "\n";
+
+ if ( !$post_type_object->hierarchical )
+ echo '
' . (is_sticky($post->ID) ? 'sticky' : '') . '
';
+
+ if ( post_type_supports( $post->post_type, 'post-formats' ) )
+ echo '
' . esc_html( get_post_format( $post->ID ) ) . '
';
+
+ echo '
';
}
/**
- * {@internal Missing Short Description}}
+ * Outputs the in-line comment reply-to form in the Comments list table.
*
- * @since unknown
+ * @since 2.7.0
*
- * @param unknown_type $position
- * @param unknown_type $checkbox
- * @param unknown_type $mode
- */
-function wp_comment_reply($position = '1', $checkbox = false, $mode = 'single', $table_row = true) {
- global $current_user;
-
- // allow plugin to replace the popup content
- $content = apply_filters( 'wp_comment_reply', '', array('position' => $position, 'checkbox' => $checkbox, 'mode' => $mode) );
+ * @global WP_List_Table $wp_list_table
+ *
+ * @param int $position
+ * @param bool $checkbox
+ * @param string $mode
+ * @param bool $table_row
+ */
+function wp_comment_reply( $position = 1, $checkbox = false, $mode = 'single', $table_row = true ) {
+ global $wp_list_table;
+ /**
+ * Filter the in-line comment reply-to form output in the Comments
+ * list table.
+ *
+ * Returning a non-empty value here will short-circuit display
+ * of the in-line comment-reply form in the Comments list table,
+ * echoing the returned value instead.
+ *
+ * @since 2.7.0
+ *
+ * @see wp_comment_reply()
+ *
+ * @param string $content The reply-to form content.
+ * @param array $args An array of default args.
+ */
+ $content = apply_filters( 'wp_comment_reply', '', array( 'position' => $position, 'checkbox' => $checkbox, 'mode' => $mode ) );
if ( ! empty($content) ) {
echo $content;
return;
}
- $columns = get_column_headers('edit-comments');
- $hidden = array_intersect( array_keys( $columns ), array_filter( get_hidden_columns('edit-comments') ) );
- $col_count = count($columns) - count($hidden);
+ if ( ! $wp_list_table ) {
+ if ( $mode == 'single' ) {
+ $wp_list_table = _get_list_table('WP_Post_Comments_List_Table');
+ } else {
+ $wp_list_table = _get_list_table('WP_Comments_List_Table');
+ }
+ }
?>
-
+
-
+
@@ -2195,44 +455,27 @@ function wp_comment_reply($position = '1', $checkbox = false, $mode = 'single',
}
/**
- * {@internal Missing Short Description}}
+ * Output 'undo move to trash' text for comments
*
- * @since unknown
- *
- * @param unknown_type $currentcat
- * @param unknown_type $currentparent
- * @param unknown_type $parent
- * @param unknown_type $level
- * @param unknown_type $categories
- * @return unknown
+ * @since 2.9.0
*/
-function wp_dropdown_cats( $currentcat = 0, $currentparent = 0, $parent = 0, $level = 0, $categories = 0 ) {
- if (!$categories )
- $categories = get_categories( array('hide_empty' => 0) );
-
- if ( $categories ) {
- foreach ( $categories as $category ) {
- if ( $currentcat != $category->term_id && $parent == $category->parent) {
- $pad = str_repeat( '– ', $level );
- $category->name = wp_specialchars( $category->name );
- echo "\n\tterm_id )
- echo " selected='selected'";
- echo ">$pad$category->name ";
- wp_dropdown_cats( $currentcat, $currentparent, $category->term_id, $level +1, $categories );
- }
- }
- } else {
- return false;
- }
+function wp_comment_trashnotice() {
+?>
+
+
+
- ' . __( 'Name' ) . '
+ ' . _x( 'Name', 'meta name' ) . '
' . __( 'Value' ) . '
-
+
'; //TBODY needed for list-manipulation JS
@@ -2256,11 +499,11 @@ function list_meta( $meta ) {
-
+
-
+
+ $entry['meta_key'] = esc_attr($entry['meta_key']);
+ $entry['meta_value'] = esc_textarea( $entry['meta_value'] ); // using a
$entry['meta_id'] = (int) $entry['meta_id'];
$delete_nonce = wp_create_nonce( 'delete-meta_' . $entry['meta_id'] );
- $r .= "\n\t";
- $r .= "\n\t\t" . __( 'Key' ) . " ";
+ $r .= "\n\t ";
+ $r .= "\n\t\t" . __( 'Key' ) . " ";
- $r .= "\n\t\t ";
- $r .= "\n\t\t
";
+ $r .= "\n\t\t";
+ $r .= get_submit_button( __( 'Delete' ), 'deletemeta small', "deletemeta[{$entry['meta_id']}]", false, array( 'data-wp-lists' => "delete:the-list:meta-{$entry['meta_id']}::_ajax_nonce=$delete_nonce" ) );
+ $r .= "\n\t\t";
+ $r .= get_submit_button( __( 'Update' ), 'updatemeta small', "meta-{$entry['meta_id']}-submit", false, array( 'data-wp-lists' => "add:the-list:meta-{$entry['meta_id']}::_ajax_nonce-add-meta=$update_nonce" ) );
+ $r .= "
";
$r .= wp_nonce_field( 'change-meta', '_ajax_nonce', false, false );
$r .= " ";
- $r .= "\n\t\t" . __( 'Value' ) . " {$entry['meta_value']} \n\t ";
+ $r .= "\n\t\t" . __( 'Value' ) . " {$entry['meta_value']} \n\t";
return $r;
}
/**
- * {@internal Missing Short Description}}
+ * Prints the form in the Custom Fields meta box.
+ *
+ * @since 1.2.0
*
- * @since unknown
+ * @global wpdb $wpdb WordPress database abstraction object.
+ *
+ * @param WP_Post $post Optional. The post being edited.
*/
-function meta_form() {
+function meta_form( $post = null ) {
global $wpdb;
- $limit = (int) apply_filters( 'postmeta_form_limit', 30 );
- $keys = $wpdb->get_col( "
- SELECT meta_key
- FROM $wpdb->postmeta
- WHERE meta_key NOT LIKE '\_%'
- GROUP BY meta_key
- ORDER BY meta_id DESC
- LIMIT $limit" );
- if ( $keys )
- natcasesort($keys);
+ $post = get_post( $post );
+
+ /**
+ * Filter values for the meta key dropdown in the Custom Fields meta box.
+ *
+ * Returning a non-null value will effectively short-circuit and avoid a
+ * potentially expensive query against postmeta.
+ *
+ * @since 4.4.0
+ *
+ * @param array|null $keys Pre-defined meta keys to be used in place of a postmeta query. Default null.
+ * @param WP_Post $post The current post object.
+ */
+ $keys = apply_filters( 'postmeta_form_keys', null, $post );
+
+ if ( null === $keys ) {
+ /**
+ * Filter the number of custom fields to retrieve for the drop-down
+ * in the Custom Fields meta box.
+ *
+ * @since 2.1.0
+ *
+ * @param int $limit Number of custom fields to retrieve. Default 30.
+ */
+ $limit = apply_filters( 'postmeta_form_limit', 30 );
+ $sql = "SELECT DISTINCT meta_key
+ FROM $wpdb->postmeta
+ WHERE meta_key NOT BETWEEN '_' AND '_z'
+ HAVING meta_key NOT LIKE %s
+ ORDER BY meta_key
+ LIMIT %d";
+ $keys = $wpdb->get_col( $wpdb->prepare( $sql, $wpdb->esc_like( '_' ) . '%', $limit ) );
+ }
+
+ if ( $keys ) {
+ natcasesort( $keys );
+ $meta_key_input_id = 'metakeyselect';
+ } else {
+ $meta_key_input_id = 'metakeyinput';
+ }
?>
-
+
@@ -2386,35 +668,41 @@ function meta_form() {
}
/**
- * {@internal Missing Short Description}}
+ * Print out HTML form date elements for editing post or comment publish date.
*
- * @since unknown
+ * @since 0.71
+ * @since 4.4.0 Converted to use get_comment() instead of the global `$comment`.
*
- * @param unknown_type $edit
- * @param unknown_type $for_post
- * @param unknown_type $tab_index
- * @param unknown_type $multi
+ * @global WP_Locale $wp_locale
+ *
+ * @param int|bool $edit Accepts 1|true for editing the date, 0|false for adding the date.
+ * @param int|bool $for_post Accepts 1|true for applying the date to a post, 0|false for a comment.
+ * @param int $tab_index The tabindex attribute to add. Default 0.
+ * @param int|bool $multi Optional. Whether the additional fields and buttons should be added.
+ * Default 0|false.
*/
function touch_time( $edit = 1, $for_post = 1, $tab_index = 0, $multi = 0 ) {
- global $wp_locale, $post, $comment;
+ global $wp_locale;
+ $post = get_post();
if ( $for_post )
- $edit = ( in_array($post->post_status, array('draft', 'pending') ) && (!$post->post_date_gmt || '0000-00-00 00:00:00' == $post->post_date_gmt ) ) ? false : true;
+ $edit = ! ( in_array($post->post_status, array('draft', 'pending') ) && (!$post->post_date_gmt || '0000-00-00 00:00:00' == $post->post_date_gmt ) );
$tab_index_attribute = '';
if ( (int) $tab_index > 0 )
$tab_index_attribute = " tabindex=\"$tab_index\"";
+ // todo: Remove this?
// echo ' '.__( 'Edit timestamp' ).' ';
- $time_adj = time() + (get_option( 'gmt_offset' ) * 3600 );
- $post_date = ($for_post) ? $post->post_date : $comment->comment_date;
- $jj = ($edit) ? mysql2date( 'd', $post_date ) : gmdate( 'd', $time_adj );
- $mm = ($edit) ? mysql2date( 'm', $post_date ) : gmdate( 'm', $time_adj );
- $aa = ($edit) ? mysql2date( 'Y', $post_date ) : gmdate( 'Y', $time_adj );
- $hh = ($edit) ? mysql2date( 'H', $post_date ) : gmdate( 'H', $time_adj );
- $mn = ($edit) ? mysql2date( 'i', $post_date ) : gmdate( 'i', $time_adj );
- $ss = ($edit) ? mysql2date( 's', $post_date ) : gmdate( 's', $time_adj );
+ $time_adj = current_time('timestamp');
+ $post_date = ($for_post) ? $post->post_date : get_comment()->comment_date;
+ $jj = ($edit) ? mysql2date( 'd', $post_date, false ) : gmdate( 'd', $time_adj );
+ $mm = ($edit) ? mysql2date( 'm', $post_date, false ) : gmdate( 'm', $time_adj );
+ $aa = ($edit) ? mysql2date( 'Y', $post_date, false ) : gmdate( 'Y', $time_adj );
+ $hh = ($edit) ? mysql2date( 'H', $post_date, false ) : gmdate( 'H', $time_adj );
+ $mn = ($edit) ? mysql2date( 'i', $post_date, false ) : gmdate( 'i', $time_adj );
+ $ss = ($edit) ? mysql2date( 's', $post_date, false ) : gmdate( 's', $time_adj );
$cur_jj = gmdate( 'd', $time_adj );
$cur_mm = gmdate( 'm', $time_adj );
@@ -2422,90 +710,99 @@ function touch_time( $edit = 1, $for_post = 1, $tab_index = 0, $multi = 0 ) {
$cur_hh = gmdate( 'H', $time_adj );
$cur_mn = gmdate( 'i', $time_adj );
- $month = "\n";
+ $month = '' . __( 'Month' ) . ' \n";
for ( $i = 1; $i < 13; $i = $i +1 ) {
- $month .= "\t\t\t" . 'get_month_abbrev( $wp_locale->get_month( $i ) ) . " \n";
+ $monthnum = zeroise($i, 2);
+ $monthtext = $wp_locale->get_month_abbrev( $wp_locale->get_month( $i ) );
+ $month .= "\t\t\t" . '';
+ /* translators: 1: month number (01, 02, etc.), 2: month abbreviation */
+ $month .= sprintf( __( '%1$s-%2$s' ), $monthnum, $monthtext ) . " \n";
}
- $month .= ' ';
+ $month .= ' ';
+
+ $day = '' . __( 'Day' ) . ' ';
+ $year = '' . __( 'Year' ) . ' ';
+ $hour = '' . __( 'Hour' ) . ' ';
+ $minute = '' . __( 'Minute' ) . ' ';
- $day = ' ';
- $year = ' ';
- $hour = ' ';
- $minute = ' ';
- printf(_c('%1$s%2$s, %3$s @ %4$s : %5$s|1: month input, 2: day input, 3: year input, 4: hour input, 5: minute input'), $month, $day, $year, $hour, $minute);
+ echo '';
+ /* translators: 1: month, 2: day, 3: year, 4: hour, 5: minute */
+ printf( __( '%1$s %2$s, %3$s @ %4$s:%5$s' ), $month, $day, $year, $hour, $minute );
- echo ' ';
+ echo '
';
if ( $multi ) return;
echo "\n\n";
- foreach ( array('mm', 'jj', 'aa', 'hh', 'mn') as $timeunit ) {
- echo ' ' . "\n";
+ $map = array(
+ 'mm' => array( $mm, $cur_mm ),
+ 'jj' => array( $jj, $cur_jj ),
+ 'aa' => array( $aa, $cur_aa ),
+ 'hh' => array( $hh, $cur_hh ),
+ 'mn' => array( $mn, $cur_mn ),
+ );
+ foreach ( $map as $timeunit => $value ) {
+ list( $unit, $curr ) = $value;
+
+ echo ' ' . "\n";
$cur_timeunit = 'cur_' . $timeunit;
- echo ' ' . "\n";
+ echo ' ' . "\n";
}
?>
-
-
-
+
$template";
- endforeach;
+ foreach ( array_keys( $templates ) as $template ) {
+ $selected = selected( $default, $templates[ $template ], false );
+ echo "\n\t$template ";
+ }
}
/**
- * {@internal Missing Short Description}}
+ * Print out option HTML elements for the page parents drop-down.
+ *
+ * @since 1.5.0
+ * @since 4.4.0 `$post` argument was added.
*
- * @since unknown
+ * @global wpdb $wpdb WordPress database abstraction object.
*
- * @param unknown_type $default
- * @param unknown_type $parent
- * @param unknown_type $level
- * @return unknown
+ * @param int $default Optional. The default page ID to be pre-selected. Default 0.
+ * @param int $parent Optional. The parent page ID. Default 0.
+ * @param int $level Optional. Page depth level. Default 0.
+ * @param int|WP_Post $post Post ID or WP_Post object.
+ *
+ * @return null|false Boolean False if page has no children, otherwise print out html elements
*/
-function parent_dropdown( $default = 0, $parent = 0, $level = 0 ) {
- global $wpdb, $post_ID;
+function parent_dropdown( $default = 0, $parent = 0, $level = 0, $post = null ) {
+ global $wpdb;
+ $post = get_post( $post );
$items = $wpdb->get_results( $wpdb->prepare("SELECT ID, post_parent, post_title FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'page' ORDER BY menu_order", $parent) );
if ( $items ) {
foreach ( $items as $item ) {
// A page cannot be its own parent.
- if (!empty ( $post_ID ) ) {
- if ( $item->ID == $post_ID ) {
- continue;
- }
- }
+ if ( $post && $post->ID && $item->ID == $post->ID )
+ continue;
+
$pad = str_repeat( ' ', $level * 3 );
- if ( $item->ID == $default)
- $current = ' selected="selected"';
- else
- $current = '';
+ $selected = selected( $default, $item->ID, false );
- echo "\n\t$pad " . wp_specialchars($item->post_title) . " ";
+ echo "\n\t$pad " . esc_html($item->post_title) . " ";
parent_dropdown( $default, $item->ID, $level +1 );
}
} else {
@@ -2514,192 +811,114 @@ function parent_dropdown( $default = 0, $parent = 0, $level = 0 ) {
}
/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- */
-function browse_happy() {
- $getit = __( 'WordPress recommends a better browser' );
- echo '
-
-';
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $id
- * @return unknown
- */
-function the_attachment_links( $id = false ) {
- $id = (int) $id;
- $post = & get_post( $id );
-
- if ( $post->post_type != 'attachment' )
- return false;
-
- $icon = get_attachment_icon( $post->ID );
- $attachment_data = wp_get_attachment_metadata( $id );
- $thumb = isset( $attachment_data['thumb'] );
-?>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-role_names as $role => $name ) {
- $name = translate_with_context($name);
- if ( $default == $role ) // Make default first in list
- $p = "\n\t$name ";
+
+ $editable_roles = array_reverse( get_editable_roles() );
+
+ foreach ( $editable_roles as $role => $details ) {
+ $name = translate_user_role($details['name'] );
+ if ( $selected == $role ) // preselect specified role
+ $p = "\n\t$name ";
else
- $r .= "\n\t$name ";
+ $r .= "\n\t$name ";
}
echo $p . $r;
}
/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $size
- * @return unknown
- */
-function wp_convert_hr_to_bytes( $size ) {
- $size = strtolower($size);
- $bytes = (int) $size;
- if ( strpos($size, 'k') !== false )
- $bytes = intval($size) * 1024;
- elseif ( strpos($size, 'm') !== false )
- $bytes = intval($size) * 1024 * 1024;
- elseif ( strpos($size, 'g') !== false )
- $bytes = intval($size) * 1024 * 1024 * 1024;
- return $bytes;
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @param unknown_type $bytes
- * @return unknown
- */
-function wp_convert_bytes_to_hr( $bytes ) {
- $units = array( 0 => 'B', 1 => 'kB', 2 => 'MB', 3 => 'GB' );
- $log = log( $bytes, 1024 );
- $power = (int) $log;
- $size = pow(1024, $log - $power);
- return $size . $units[$power];
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- *
- * @return unknown
- */
-function wp_max_upload_size() {
- $u_bytes = wp_convert_hr_to_bytes( ini_get( 'upload_max_filesize' ) );
- $p_bytes = wp_convert_hr_to_bytes( ini_get( 'post_max_size' ) );
- $bytes = apply_filters( 'upload_size_limit', min($u_bytes, $p_bytes), $u_bytes, $p_bytes );
- return $bytes;
-}
-
-/**
- * {@internal Missing Short Description}}
+ * Outputs the form used by the importers to accept the data to be imported
*
- * @since unknown
+ * @since 2.0.0
*
- * @param unknown_type $action
+ * @param string $action The action attribute for the form.
*/
function wp_import_upload_form( $action ) {
+
+ /**
+ * Filter the maximum allowed upload size for import files.
+ *
+ * @since 2.3.0
+ *
+ * @see wp_max_upload_size()
+ *
+ * @param int $max_upload_size Allowed upload size. Default 1 MB.
+ */
$bytes = apply_filters( 'import_upload_size_limit', wp_max_upload_size() );
- $size = wp_convert_bytes_to_hr( $bytes );
+ $size = size_format( $bytes );
+ $upload_dir = wp_upload_dir();
+ if ( ! empty( $upload_dir['error'] ) ) :
+ ?>
-
+
-
()
-
-
-
+
post_name); // just in case
- if ( strlen($name) )
- echo ' ';
-}
-
-/**
- * Add a meta box to an edit form.
+ * Adds a meta box to one or more screens.
*
* @since 2.5.0
- *
- * @param string $id String for use in the 'id' attribute of tags.
- * @param string $title Title of the meta box.
- * @param string $callback Function that fills the box with the desired content. The function should echo its output.
- * @param string $page The type of edit page on which to show the box (post, page, link).
- * @param string $context The context within the page where the boxes should show ('normal', 'advanced').
- * @param string $priority The priority within the context where the boxes should show ('high', 'low').
- */
-function add_meta_box($id, $title, $callback, $page, $context = 'advanced', $priority = 'default') {
+ * @since 4.4.0 The `$screen` parameter now accepts an array of screen IDs.
+ *
+ * @global array $wp_meta_boxes
+ *
+ * @param string $id Meta box ID (used in the 'id' attribute for the meta box).
+ * @param string $title Title of the meta box.
+ * @param callable $callback Function that fills the box with the desired content.
+ * The function should echo its output.
+ * @param string|array|WP_Screen $screen Optional. The screen or screens on which to show the box
+ * (such as a post type, 'link', or 'comment'). Accepts a single
+ * screen ID, WP_Screen object, or array of screen IDs. Default
+ * is the current screen.
+ * @param string $context Optional. The context within the screen where the boxes
+ * should display. Available contexts vary from screen to
+ * screen. Post edit screen contexts include 'normal', 'side',
+ * and 'advanced'. Comments screen contexts include 'normal'
+ * and 'side'. Menus meta boxes (accordion sections) all use
+ * the 'side' context. Global default is 'advanced'.
+ * @param string $priority Optional. The priority within the context where the boxes
+ * should show ('high', 'low'). Default 'default'.
+ * @param array $callback_args Optional. Data that should be set as the $args property
+ * of the box array (which is the second parameter passed
+ * to your callback). Default null.
+ */
+function add_meta_box( $id, $title, $callback, $screen = null, $context = 'advanced', $priority = 'default', $callback_args = null ) {
global $wp_meta_boxes;
+ if ( empty( $screen ) ) {
+ $screen = get_current_screen();
+ } elseif ( is_string( $screen ) ) {
+ $screen = convert_to_screen( $screen );
+ } elseif ( is_array( $screen ) ) {
+ foreach ( $screen as $single_screen ) {
+ add_meta_box( $id, $title, $callback, $single_screen, $context, $priority, $callback_args );
+ }
+ }
+
+ if ( ! isset( $screen->id ) ) {
+ return;
+ }
+
+ $page = $screen->id;
+
if ( !isset($wp_meta_boxes) )
$wp_meta_boxes = array();
if ( !isset($wp_meta_boxes[$page]) )
@@ -2708,34 +927,42 @@ function add_meta_box($id, $title, $callback, $page, $context = 'advanced', $pri
$wp_meta_boxes[$page][$context] = array();
foreach ( array_keys($wp_meta_boxes[$page]) as $a_context ) {
- foreach ( array('high', 'core', 'default', 'low') as $a_priority ) {
- if ( !isset($wp_meta_boxes[$page][$a_context][$a_priority][$id]) )
- continue;
+ foreach ( array('high', 'core', 'default', 'low') as $a_priority ) {
+ if ( !isset($wp_meta_boxes[$page][$a_context][$a_priority][$id]) )
+ continue;
+
+ // If a core box was previously added or removed by a plugin, don't add.
+ if ( 'core' == $priority ) {
+ // If core box previously deleted, don't add
+ if ( false === $wp_meta_boxes[$page][$a_context][$a_priority][$id] )
+ return;
- // If a core box was previously added or removed by a plugin, don't add.
- if ( 'core' == $priority ) {
- // If core box previously deleted, don't add
- if ( false === $wp_meta_boxes[$page][$a_context][$a_priority][$id] )
+ /*
+ * If box was added with default priority, give it core priority to
+ * maintain sort order.
+ */
+ if ( 'default' == $a_priority ) {
+ $wp_meta_boxes[$page][$a_context]['core'][$id] = $wp_meta_boxes[$page][$a_context]['default'][$id];
+ unset($wp_meta_boxes[$page][$a_context]['default'][$id]);
+ }
return;
- // If box was added with default priority, give it core priority to maintain sort order
- if ( 'default' == $a_priority ) {
- $wp_meta_boxes[$page][$a_context]['core'][$id] = $wp_meta_boxes[$page][$a_context]['default'][$id];
- unset($wp_meta_boxes[$page][$a_context]['default'][$id]);
}
- return;
- }
- // If no priority given and id already present, use existing priority
- if ( empty($priority) ) {
- $priority = $a_priority;
- // else if we're adding to the sorted priortiy, we don't know the title or callback. Glab them from the previously added context/priority.
- } elseif ( 'sorted' == $priority ) {
- $title = $wp_meta_boxes[$page][$a_context][$a_priority][$id]['title'];
- $callback = $wp_meta_boxes[$page][$a_context][$a_priority][$id]['callback'];
+ // If no priority given and id already present, use existing priority.
+ if ( empty($priority) ) {
+ $priority = $a_priority;
+ /*
+ * Else, if we're adding to the sorted priority, we don't know the title
+ * or callback. Grab them from the previously added context/priority.
+ */
+ } elseif ( 'sorted' == $priority ) {
+ $title = $wp_meta_boxes[$page][$a_context][$a_priority][$id]['title'];
+ $callback = $wp_meta_boxes[$page][$a_context][$a_priority][$id]['callback'];
+ $callback_args = $wp_meta_boxes[$page][$a_context][$a_priority][$id]['args'];
+ }
+ // An id can be in only one priority and one context.
+ if ( $priority != $a_priority || $context != $a_context )
+ unset($wp_meta_boxes[$page][$a_context][$a_priority][$id]);
}
- // An id can be in only one priority and one context
- if ( $priority != $a_priority || $context != $a_context )
- unset($wp_meta_boxes[$page][$a_context][$a_priority][$id]);
- }
}
if ( empty($priority) )
@@ -2744,55 +971,68 @@ function add_meta_box($id, $title, $callback, $page, $context = 'advanced', $pri
if ( !isset($wp_meta_boxes[$page][$context][$priority]) )
$wp_meta_boxes[$page][$context][$priority] = array();
- $wp_meta_boxes[$page][$context][$priority][$id] = array('id' => $id, 'title' => $title, 'callback' => $callback);
+ $wp_meta_boxes[$page][$context][$priority][$id] = array('id' => $id, 'title' => $title, 'callback' => $callback, 'args' => $callback_args);
}
/**
- * {@internal Missing Short Description}}
+ * Meta-Box template function
+ *
+ * @since 2.5.0
*
- * @since unknown
+ * @global array $wp_meta_boxes
*
- * @param unknown_type $page
- * @param unknown_type $context
- * @param unknown_type $object
+ * @staticvar bool $already_sorted
+ * @param string|WP_Screen $screen Screen identifier
+ * @param string $context box context
+ * @param mixed $object gets passed to the box callback function as first parameter
* @return int number of meta_boxes
*/
-function do_meta_boxes($page, $context, $object) {
+function do_meta_boxes( $screen, $context, $object ) {
global $wp_meta_boxes;
static $already_sorted = false;
- //do_action('do_meta_boxes', $page, $context, $object);
+ if ( empty( $screen ) )
+ $screen = get_current_screen();
+ elseif ( is_string( $screen ) )
+ $screen = convert_to_screen( $screen );
- $hidden = get_hidden_meta_boxes($page);
+ $page = $screen->id;
- echo "\n";
+ $hidden = get_hidden_meta_boxes( $screen );
- $i = 0;
- do {
- // Grab the ones the user has manually sorted. Pull them out of their previous context/priority and into the one the user chose
- if ( !$already_sorted && $sorted = get_user_option( "meta-box-order_$page", 0, false ) ) {
- foreach ( $sorted as $box_context => $ids )
- foreach ( explode(',', $ids) as $id )
- if ( $id )
- add_meta_box( $id, null, null, $page, $box_context, 'sorted' );
+ printf('
', htmlspecialchars($context));
+
+ // Grab the ones the user has manually sorted. Pull them out of their previous context/priority and into the one the user chose
+ if ( ! $already_sorted && $sorted = get_user_option( "meta-box-order_$page" ) ) {
+ foreach ( $sorted as $box_context => $ids ) {
+ foreach ( explode( ',', $ids ) as $id ) {
+ if ( $id && 'dashboard_browser_nag' !== $id ) {
+ add_meta_box( $id, null, null, $screen, $box_context, 'sorted' );
+ }
+ }
}
- $already_sorted = true;
+ }
+
+ $already_sorted = true;
- if ( !isset($wp_meta_boxes) || !isset($wp_meta_boxes[$page]) || !isset($wp_meta_boxes[$page][$context]) )
- break;
+ $i = 0;
- foreach ( array('high', 'sorted', 'core', 'default', 'low') as $priority ) {
- if ( isset($wp_meta_boxes[$page][$context][$priority]) ) {
- foreach ( (array) $wp_meta_boxes[$page][$context][$priority] as $box ) {
+ if ( isset( $wp_meta_boxes[ $page ][ $context ] ) ) {
+ foreach ( array( 'high', 'sorted', 'core', 'default', 'low' ) as $priority ) {
+ if ( isset( $wp_meta_boxes[ $page ][ $context ][ $priority ]) ) {
+ foreach ( (array) $wp_meta_boxes[ $page ][ $context ][ $priority ] as $box ) {
if ( false == $box || ! $box['title'] )
continue;
$i++;
- $style = '';
- if ( in_array($box['id'], $hidden) )
- $style = 'style="display:none;"';
- echo '
' . "\n";
- echo '
';
- echo "
{$box['title']} \n";
+ $hidden_class = in_array($box['id'], $hidden) ? ' hide-if-js' : '';
+ echo '
' . "\n";
+ if ( 'dashboard_browser_nag' != $box['id'] ) {
+ echo '
';
+ echo '' . sprintf( __( 'Toggle panel: %s' ), $box['title'] ) . ' ';
+ echo ' ';
+ echo ' ';
+ }
+ echo "
{$box['title']} \n";
echo '
' . "\n";
call_user_func($box['callback'], $object, $box);
echo "
\n";
@@ -2800,7 +1040,7 @@ function do_meta_boxes($page, $context, $object) {
}
}
}
- } while(0);
+ }
echo "
";
@@ -2809,17 +1049,43 @@ function do_meta_boxes($page, $context, $object) {
}
/**
- * Remove a meta box from an edit form.
+ * Removes a meta box from one or more screens.
*
* @since 2.6.0
- *
- * @param string $id String for use in the 'id' attribute of tags.
- * @param string $page The type of edit page on which to show the box (post, page, link).
- * @param string $context The context within the page where the boxes should show ('normal', 'advanced').
- */
-function remove_meta_box($id, $page, $context) {
+ * @since 4.4.0 The `$screen` parameter now accepts an array of screen IDs.
+ *
+ * @global array $wp_meta_boxes
+ *
+ * @param string $id Meta box ID (used in the 'id' attribute for the meta box).
+ * @param string|array|WP_Screen $screen The screen or screens on which the meta box is shown (such as a
+ * post type, 'link', or 'comment'). Accepts a single screen ID,
+ * WP_Screen object, or array of screen IDs.
+ * @param string $context Optional. The context within the screen where the boxes
+ * should display. Available contexts vary from screen to
+ * screen. Post edit screen contexts include 'normal', 'side',
+ * and 'advanced'. Comments screen contexts include 'normal'
+ * and 'side'. Menus meta boxes (accordion sections) all use
+ * the 'side' context. Global default is 'advanced'.
+ */
+function remove_meta_box( $id, $screen, $context ) {
global $wp_meta_boxes;
+ if ( empty( $screen ) ) {
+ $screen = get_current_screen();
+ } elseif ( is_string( $screen ) ) {
+ $screen = convert_to_screen( $screen );
+ } elseif ( is_array( $screen ) ) {
+ foreach ( $screen as $single_screen ) {
+ remove_meta_box( $id, $single_screen, $context );
+ }
+ }
+
+ if ( ! isset( $screen->id ) ) {
+ return;
+ }
+
+ $page = $screen->id;
+
if ( !isset($wp_meta_boxes) )
$wp_meta_boxes = array();
if ( !isset($wp_meta_boxes[$page]) )
@@ -2832,367 +1098,431 @@ function remove_meta_box($id, $page, $context) {
}
/**
- * {@internal Missing Short Description}}
+ * Meta Box Accordion Template Function
+ *
+ * Largely made up of abstracted code from {@link do_meta_boxes()}, this
+ * function serves to build meta boxes as list items for display as
+ * a collapsible accordion.
+ *
+ * @since 3.6.0
*
- * @since unknown
+ * @uses global $wp_meta_boxes Used to retrieve registered meta boxes.
*
- * @param unknown_type $page
+ * @param string|object $screen The screen identifier.
+ * @param string $context The meta box context.
+ * @param mixed $object gets passed to the section callback function as first parameter.
+ * @return int number of meta boxes as accordion sections.
*/
-function meta_box_prefs($page) {
+function do_accordion_sections( $screen, $context, $object ) {
global $wp_meta_boxes;
- if ( empty($wp_meta_boxes[$page]) )
- return;
+ wp_enqueue_script( 'accordion' );
- $hidden = get_hidden_meta_boxes($page);
-
- foreach ( array_keys($wp_meta_boxes[$page]) as $context ) {
- foreach ( array_keys($wp_meta_boxes[$page][$context]) as $priority ) {
- foreach ( $wp_meta_boxes[$page][$context][$priority] as $box ) {
- if ( false == $box || ! $box['title'] )
- continue;
- // Submit box cannot be hidden
- if ( 'submitdiv' == $box['id'] || 'linksubmitdiv' == $box['id'] )
- continue;
- $box_id = $box['id'];
- echo '
';
- echo ' ';
- echo "{$box['title']} \n";
- }
- }
- }
-}
+ if ( empty( $screen ) )
+ $screen = get_current_screen();
+ elseif ( is_string( $screen ) )
+ $screen = convert_to_screen( $screen );
-function get_hidden_meta_boxes($page) {
- $hidden = (array) get_user_option( "meta-box-hidden_$page", 0, false );
+ $page = $screen->id;
- // Hide slug boxes by default
- if ( empty($hidden[0]) ) {
- if ( 'page' == $page )
- $hidden = array('pageslugdiv');
- elseif ( 'post' == $page )
- $hidden = array('slugdiv');
- }
+ $hidden = get_hidden_meta_boxes( $screen );
+ ?>
+
+ $id, 'title' => $title, 'callback' => $callback);
}
/**
- * Add a new field to a settings page.
+ * Add a new field to a section of a settings page
*
- * @since 2.7.0
+ * Part of the Settings API. Use this to define a settings field that will show
+ * as part of a settings section inside a settings page. The fields are shown using
+ * do_settings_fields() in do_settings-sections()
*
- * @param string $id String for use in the 'id' attribute of tags.
- * @param string $title Title of the field.
- * @param string $callback Function that fills the field with the desired content. The function should echo its output.
- * @param string $page The type of settings page on which to show the field (general, reading, writing, ...).
- * @param string $section The section of the settingss page in which to show the box (default, ...).
- * @param array $args Additional arguments
+ * The $callback argument should be the name of a function that echoes out the
+ * html input tags for this setting field. Use get_option() to retrieve existing
+ * values to show.
+ *
+ * @since 2.7.0
+ * @since 4.2.0 The `$class` argument was added.
+ *
+ * @global $wp_settings_fields Storage array of settings fields and info about their pages/sections
+ *
+ * @param string $id Slug-name to identify the field. Used in the 'id' attribute of tags.
+ * @param string $title Formatted title of the field. Shown as the label for the field
+ * during output.
+ * @param callable $callback Function that fills the field with the desired form inputs. The
+ * function should echo its output.
+ * @param string $page The slug-name of the settings page on which to show the section
+ * (general, reading, writing, ...).
+ * @param string $section Optional. The slug-name of the section of the settings page
+ * in which to show the box. Default 'default'.
+ * @param array $args {
+ * Optional. Extra arguments used when outputting the field.
+ *
+ * @type string $label_for When supplied, the setting title will be wrapped
+ * in a `
` element, its `for` attribute populated
+ * with this value.
+ * @type string $class CSS Class to be added to the `` element when the
+ * field is output.
+ * }
*/
function add_settings_field($id, $title, $callback, $page, $section = 'default', $args = array()) {
global $wp_settings_fields;
- if ( !isset($wp_settings_fields) )
- $wp_settings_fields = array();
- if ( !isset($wp_settings_fields[$page]) )
- $wp_settings_fields[$page] = array();
- if ( !isset($wp_settings_fields[$page][$section]) )
- $wp_settings_fields[$page][$section] = array();
+ if ( 'misc' == $page ) {
+ _deprecated_argument( __FUNCTION__, '3.0', __( 'The miscellaneous options group has been removed. Use another settings group.' ) );
+ $page = 'general';
+ }
+
+ if ( 'privacy' == $page ) {
+ _deprecated_argument( __FUNCTION__, '3.5', __( 'The privacy options group has been removed. Use another settings group.' ) );
+ $page = 'reading';
+ }
$wp_settings_fields[$page][$section][$id] = array('id' => $id, 'title' => $title, 'callback' => $callback, 'args' => $args);
}
/**
- * {@internal Missing Short Description}}
+ * Prints out all settings sections added to a particular settings page
+ *
+ * Part of the Settings API. Use this in a settings page callback function
+ * to output all the sections and fields that were added to that $page with
+ * add_settings_section() and add_settings_field()
*
- * @since unknown
+ * @global $wp_settings_sections Storage array of all settings sections added to admin pages
+ * @global $wp_settings_fields Storage array of settings fields and info about their pages/sections
+ * @since 2.7.0
*
- * @param unknown_type $page
+ * @param string $page The slug name of the page whose settings sections you want to output
*/
-function do_settings_sections($page) {
+function do_settings_sections( $page ) {
global $wp_settings_sections, $wp_settings_fields;
- if ( !isset($wp_settings_sections) || !isset($wp_settings_sections[$page]) )
+ if ( ! isset( $wp_settings_sections[$page] ) )
return;
foreach ( (array) $wp_settings_sections[$page] as $section ) {
- echo "{$section['title']} \n";
- call_user_func($section['callback'], $section);
- if ( !isset($wp_settings_fields) || !isset($wp_settings_fields[$page]) || !isset($wp_settings_fields[$page][$section['id']]) )
+ if ( $section['title'] )
+ echo "{$section['title']} \n";
+
+ if ( $section['callback'] )
+ call_user_func( $section['callback'], $section );
+
+ if ( ! isset( $wp_settings_fields ) || !isset( $wp_settings_fields[$page] ) || !isset( $wp_settings_fields[$page][$section['id']] ) )
continue;
echo '';
}
}
/**
- * {@internal Missing Short Description}}
+ * Print out the settings fields for a particular settings section
+ *
+ * Part of the Settings API. Use this in a settings page to output
+ * a specific section. Should normally be called by do_settings_sections()
+ * rather than directly.
*
- * @since unknown
+ * @global $wp_settings_fields Storage array of settings fields and their pages/sections
+ *
+ * @since 2.7.0
*
- * @param unknown_type $page
- * @param unknown_type $section
+ * @param string $page Slug title of the admin page who's settings fields you want to show.
+ * @param string $section Slug title of the settings section who's fields you want to show.
*/
function do_settings_fields($page, $section) {
global $wp_settings_fields;
- if ( !isset($wp_settings_fields) || !isset($wp_settings_fields[$page]) || !isset($wp_settings_fields[$page][$section]) )
+ if ( ! isset( $wp_settings_fields[$page][$section] ) )
return;
foreach ( (array) $wp_settings_fields[$page][$section] as $field ) {
- echo ' ';
- if ( !empty($field['args']['label_for']) )
- echo '' . $field['title'] . ' ';
- else
+ $class = '';
+
+ if ( ! empty( $field['args']['class'] ) ) {
+ $class = ' class="' . esc_attr( $field['args']['class'] ) . '"';
+ }
+
+ echo " ";
+
+ if ( ! empty( $field['args']['label_for'] ) ) {
+ echo '' . $field['title'] . ' ';
+ } else {
echo '' . $field['title'] . ' ';
+ }
+
echo '';
- call_user_func($field['callback']);
+ call_user_func($field['callback'], $field['args']);
echo ' ';
echo ' ';
}
}
/**
- * {@internal Missing Short Description}}
+ * Register a settings error to be displayed to the user
*
- * @since unknown
+ * Part of the Settings API. Use this to show messages to users about settings validation
+ * problems, missing settings or anything else.
*
- * @param unknown_type $page
+ * Settings errors should be added inside the $sanitize_callback function defined in
+ * register_setting() for a given setting to give feedback about the submission.
+ *
+ * By default messages will show immediately after the submission that generated the error.
+ * Additional calls to settings_errors() can be used to show errors even when the settings
+ * page is first accessed.
+ *
+ * @since 3.0.0
+ *
+ * @global array $wp_settings_errors Storage array of errors registered during this pageload
+ *
+ * @param string $setting Slug title of the setting to which this error applies
+ * @param string $code Slug-name to identify the error. Used as part of 'id' attribute in HTML output.
+ * @param string $message The formatted message text to display to the user (will be shown inside styled
+ * `` and `
` tags).
+ * @param string $type Optional. Message type, controls HTML class. Accepts 'error' or 'updated'.
+ * Default 'error'.
*/
-function manage_columns_prefs($page) {
- $columns = get_column_headers($page);
+function add_settings_error( $setting, $code, $message, $type = 'error' ) {
+ global $wp_settings_errors;
- $hidden = get_hidden_columns($page);
+ $wp_settings_errors[] = array(
+ 'setting' => $setting,
+ 'code' => $code,
+ 'message' => $message,
+ 'type' => $type
+ );
+}
- foreach ( $columns as $column => $title ) {
- // Can't hide these
- if ( 'cb' == $column || 'title' == $column || 'name' == $column || 'username' == $column || 'media' == $column || 'comment' == $column )
- continue;
- if ( empty($title) )
- continue;
+/**
+ * Fetch settings errors registered by add_settings_error()
+ *
+ * Checks the $wp_settings_errors array for any errors declared during the current
+ * pageload and returns them.
+ *
+ * If changes were just submitted ($_GET['settings-updated']) and settings errors were saved
+ * to the 'settings_errors' transient then those errors will be returned instead. This
+ * is used to pass errors back across pageloads.
+ *
+ * Use the $sanitize argument to manually re-sanitize the option before returning errors.
+ * This is useful if you have errors or notices you want to show even when the user
+ * hasn't submitted data (i.e. when they first load an options page, or in admin_notices action hook)
+ *
+ * @since 3.0.0
+ *
+ * @global array $wp_settings_errors Storage array of errors registered during this pageload
+ *
+ * @param string $setting Optional slug title of a specific setting who's errors you want.
+ * @param boolean $sanitize Whether to re-sanitize the setting value before returning errors.
+ * @return array Array of settings errors
+ */
+function get_settings_errors( $setting = '', $sanitize = false ) {
+ global $wp_settings_errors;
+
+ /*
+ * If $sanitize is true, manually re-run the sanitization for this option
+ * This allows the $sanitize_callback from register_setting() to run, adding
+ * any settings errors you want to show by default.
+ */
+ if ( $sanitize )
+ sanitize_option( $setting, get_option( $setting ) );
+
+ // If settings were passed back from options.php then use them.
+ if ( isset( $_GET['settings-updated'] ) && $_GET['settings-updated'] && get_transient( 'settings_errors' ) ) {
+ $wp_settings_errors = array_merge( (array) $wp_settings_errors, get_transient( 'settings_errors' ) );
+ delete_transient( 'settings_errors' );
+ }
+
+ // Check global in case errors have been added on this pageload.
+ if ( ! count( $wp_settings_errors ) )
+ return array();
+
+ // Filter the results to those of a specific setting if one was set.
+ if ( $setting ) {
+ $setting_errors = array();
+ foreach ( (array) $wp_settings_errors as $key => $details ) {
+ if ( $setting == $details['setting'] )
+ $setting_errors[] = $wp_settings_errors[$key];
+ }
+ return $setting_errors;
+ }
+
+ return $wp_settings_errors;
+}
+
+/**
+ * Display settings errors registered by {@see add_settings_error()}.
+ *
+ * Part of the Settings API. Outputs a div for each error retrieved by
+ * {@see get_settings_errors()}.
+ *
+ * This is called automatically after a settings page based on the
+ * Settings API is submitted. Errors should be added during the validation
+ * callback function for a setting defined in {@see register_setting()}
+ *
+ * The $sanitize option is passed into {@see get_settings_errors()} and will
+ * re-run the setting sanitization
+ * on its current value.
+ *
+ * The $hide_on_update option will cause errors to only show when the settings
+ * page is first loaded. if the user has already saved new values it will be
+ * hidden to avoid repeating messages already shown in the default error
+ * reporting after submission. This is useful to show general errors like
+ * missing settings when the user arrives at the settings page.
+ *
+ * @since 3.0.0
+ *
+ * @param string $setting Optional slug title of a specific setting who's errors you want.
+ * @param bool $sanitize Whether to re-sanitize the setting value before returning errors.
+ * @param bool $hide_on_update If set to true errors will not be shown if the settings page has already been submitted.
+ */
+function settings_errors( $setting = '', $sanitize = false, $hide_on_update = false ) {
+
+ if ( $hide_on_update && ! empty( $_GET['settings-updated'] ) )
+ return;
+
+ $settings_errors = get_settings_errors( $setting, $sanitize );
+
+ if ( empty( $settings_errors ) )
+ return;
- if ( 'comments' == $column )
- $title = __('Comments');
- $id = "$column-hide";
- echo '';
- echo ' ';
- echo "$title \n";
+ $output = '';
+ foreach ( $settings_errors as $key => $details ) {
+ $css_id = 'setting-error-' . $details['code'];
+ $css_class = $details['type'] . ' settings-error notice is-dismissible';
+ $output .= "
\n";
+ $output .= "
{$details['message']}
";
+ $output .= "
\n";
}
+ echo $output;
}
/**
- * {@internal Missing Short Description}}
+ * Outputs the modal window used for attaching media to posts or pages in the media-listing screen.
*
- * @since unknown
+ * @since 2.7.0
*
- * @param unknown_type $found_action
+ * @param string $found_action
*/
function find_posts_div($found_action = '') {
?>
-
-
+
-
post_password ) ) echo attribute_escape( $post->post_password );
-}
-
-/**
- * {@internal Missing Short Description}}
- *
- * @since unknown
- */
-function favorite_actions() {
- $actions = array(
- 'post-new.php' => array(__('New Post'), 'edit_posts'),
- 'edit.php?post_status=draft' => array(__('Drafts'), 'edit_posts'),
- 'page-new.php' => array(__('New Page'), 'edit_pages'),
- 'media-new.php' => array(__('Upload'), 'upload_files'),
- 'edit-comments.php' => array(__('Comments'), 'moderate_comments')
- );
-
- $actions = apply_filters('favorite_actions', $actions);
-
- $allowed_actions = array();
- foreach ( $actions as $action => $data ) {
- if ( current_user_can($data[1]) )
- $allowed_actions[$action] = $data[0];
- }
-
- if ( empty($allowed_actions) )
- return;
-
- $first = array_keys($allowed_actions);
- $first = $first[0];
- echo '
';
- echo '
';
- echo '
';
-
- array_shift($allowed_actions);
-
- foreach ( $allowed_actions as $action => $label) {
- echo "
\n";
- }
- echo "
\n";
+ $post = get_post();
+ if ( isset( $post->post_password ) )
+ echo esc_attr( $post->post_password );
}
/**
@@ -3202,15 +1532,15 @@ function favorite_actions() {
* returned.
*
* @since 2.7.0
- * @param int $id The post id. If not supplied the global $post is used.
*
+ * @param int|WP_Post $post Optional. Post ID or WP_Post object. Default is global $post.
+ * @return string The post title if set.
*/
-function _draft_or_post_title($post_id = 0)
-{
- $title = get_the_title($post_id);
- if ( empty($title) )
- $title = __('(no title)');
- return $title;
+function _draft_or_post_title( $post = 0 ) {
+ $title = get_the_title( $post );
+ if ( empty( $title ) )
+ $title = __( '(no title)' );
+ return esc_html( $title );
}
/**
@@ -3219,46 +1549,94 @@ function _draft_or_post_title($post_id = 0)
* A simple wrapper to display the "s" parameter in a GET URI. This function
* should only be used when {@link the_search_query()} cannot.
*
- * @uses attribute_escape
* @since 2.7.0
- *
*/
function _admin_search_query() {
- echo isset($_GET['s']) ? attribute_escape( stripslashes( $_GET['s'] ) ) : '';
+ echo isset($_REQUEST['s']) ? esc_attr( wp_unslash( $_REQUEST['s'] ) ) : '';
}
/**
* Generic Iframe header for use with Thickbox
*
* @since 2.7.0
- * @param string $title Title of the Iframe page.
- * @param bool $limit_styles Limit styles to colour-related styles only (unless others are enqueued).
*
+ * @global string $hook_suffix
+ * @global string $admin_body_class
+ * @global WP_Locale $wp_locale
+ *
+ * @param string $title Optional. Title of the Iframe page. Default empty.
+ * @param bool $deprecated Not used.
*/
-function iframe_header( $title = '', $limit_styles = false) {
-?>
- >
-
-
+function iframe_header( $title = '', $deprecated = false ) {
+ show_admin_bar( false );
+ global $hook_suffix, $admin_body_class, $wp_locale;
+ $admin_body_class = preg_replace('/[^a-z0-9_-]+/i', '-', $hook_suffix);
+
+ $current_screen = get_current_screen();
+
+ @header( 'Content-Type: ' . get_option( 'html_type' ) . '; charset=' . get_option( 'blog_charset' ) );
+ _wp_admin_html_begin();
+?>
› —
->
+
+ class="wp-admin wp-core-ui no-js iframe ">
+
-';
+ /*
+ * We're going to hide any footer output on iFrame pages,
+ * but run the hooks anyway since they output JavaScript
+ * or other needed content.
+ */
+ ?>
+
+
+
+
+
+
+post_password) )
- $post_states[] = __('Password protected');
+ $post_states['protected'] = __('Password protected');
if ( 'private' == $post->post_status && 'private' != $post_status )
- $post_states[] = __('Private');
+ $post_states['private'] = __('Private');
if ( 'draft' == $post->post_status && 'draft' != $post_status )
- $post_states[] = __('Draft');
+ $post_states['draft'] = __('Draft');
if ( 'pending' == $post->post_status && 'pending' != $post_status )
- $post_states[] = __('Pending');
+ $post_states['pending'] = _x('Pending', 'post status');
+ if ( is_sticky($post->ID) )
+ $post_states['sticky'] = __('Sticky');
+
+ if ( 'future' === $post->post_status ) {
+ $post_states['scheduled'] = __( 'Scheduled' );
+ }
+
+ if ( 'page' === get_option( 'show_on_front' ) ) {
+ if ( intval( get_option( 'page_on_front' ) ) === $post->ID ) {
+ $post_states['page_on_front'] = __( 'Front Page' );
+ }
+
+ if ( intval( get_option( 'page_for_posts' ) ) === $post->ID ) {
+ $post_states['page_for_posts'] = __( 'Posts Page' );
+ }
+ }
+
+ /**
+ * Filter the default post display states used in the posts list table.
+ *
+ * @since 2.8.0
+ *
+ * @param array $post_states An array of post display states.
+ * @param WP_Post $post The current post object.
+ */
+ $post_states = apply_filters( 'display_post_states', $post_states, $post );
if ( ! empty($post_states) ) {
$state_count = count($post_states);
$i = 0;
- echo ' - ';
+ echo ' — ';
foreach ( $post_states as $state ) {
++$i;
( $i == $state_count ) ? $sep = '' : $sep = ', ';
echo "
$state$sep ";
}
}
+
}
-function screen_meta($screen) {
- global $wp_meta_boxes, $_wp_contextual_help;
+/**
+ *
+ * @param WP_Post $post
+ */
+function _media_states( $post ) {
+ $media_states = array();
+ $stylesheet = get_option('stylesheet');
+
+ if ( current_theme_supports( 'custom-header') ) {
+ $meta_header = get_post_meta($post->ID, '_wp_attachment_is_custom_header', true );
+ if ( ! empty( $meta_header ) && $meta_header == $stylesheet )
+ $media_states[] = __( 'Header Image' );
+ }
+
+ if ( current_theme_supports( 'custom-background') ) {
+ $meta_background = get_post_meta($post->ID, '_wp_attachment_is_custom_background', true );
+ if ( ! empty( $meta_background ) && $meta_background == $stylesheet )
+ $media_states[] = __( 'Background Image' );
+ }
- $screen = str_replace('.php', '', $screen);
- $screen = str_replace('-new', '', $screen);
- $screen = str_replace('-add', '', $screen);
- $screen = apply_filters('screen_meta_screen', $screen);
+ if ( $post->ID == get_option( 'site_icon' ) ) {
+ $media_states[] = __( 'Site Icon' );
+ }
- $column_screens = get_column_headers($screen);
- $meta_screens = array('index' => 'dashboard');
+ if ( $post->ID == get_theme_mod( 'site_logo' ) ) {
+ $media_states[] = __( 'Logo' );
+ }
- if ( isset($meta_screens[$screen]) )
- $screen = $meta_screens[$screen];
- $show_screen = false;
- if ( !empty($wp_meta_boxes[$screen]) || !empty($column_screens) )
- $show_screen = true;
-?>
-
+/**
+ *
+ * @global bool $is_IE
+ */
+function _wp_admin_html_begin() {
+ global $is_IE;
+
+ $admin_html_class = ( is_admin_bar_showing() ) ? 'wp-toolbar' : '';
+
+ if ( $is_IE )
+ @header('X-UA-Compatible: IE=edge');
+
+?>
+
+
+
+ >
+
+
+
'_invalid', 'base' => '_are_belong_to_us' );
+ }
- $_wp_contextual_help[$screen] = $help;
+ return WP_Screen::get( $hook_name );
}
-function drag_drop_help() {
- return '
-
' . __('Most of the modules on this screen can be moved. If you hover your mouse over the title bar of a module youâll notice the 4 arrow cursor appears to let you know it is movable. Click on it, hold down the mouse button and start dragging the module to a new location. As you drag the module, notice the dotted gray box that also moves. This box indicates where the module will be placed when you release the mouse button.') . '
-
' . __('The same modules can be expanded and collapsed by clicking once on their title bar and also completely hidden from the Screen Options tab.') . '
-';
+/**
+ * Output the HTML for restoring the post data from DOM storage
+ *
+ * @since 3.6.0
+ * @access private
+ */
+function _local_storage_notice() {
+ ?>
+
+ 0,
+ 'type' => 'rating',
+ 'number' => 0,
+ 'echo' => true,
+ );
+ $r = wp_parse_args( $args, $defaults );
- if ( empty($name) ) {
- if ( isset($parent_file) && !empty($parent_file) )
- $name = substr($parent_file, 0, -4);
- else
- $name = str_replace(array('.php', '-new', '-add'), '', $hook_suffix);
+ // Non-english decimal places when the $rating is coming from a string
+ $rating = str_replace( ',', '.', $r['rating'] );
+
+ // Convert Percentage to star rating, 0..5 in .5 increments
+ if ( 'percent' == $r['type'] ) {
+ $rating = round( $rating / 10, 0 ) / 2;
}
- unset($hook_suffix);
-?>
-
-';
+ $output .= '
' . $title . ' ';
+ $output .= str_repeat( '
', $full_stars );
+ $output .= str_repeat( '
', $half_stars );
+ $output .= str_repeat( '
', $empty_stars );
+ $output .= '
';
+
+ if ( $r['echo'] ) {
+ echo $output;
+ }
+
+ return $output;
}
-?>
+/**
+ * Output a notice when editing the page for posts (internal use only).
+ *
+ * @ignore
+ * @since 4.2.0
+ */
+function _wp_posts_page_notice() {
+ echo '
' . __( 'You are currently editing the page that shows your latest posts.' ) . '
';
+}