X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/3f5685912e89eb3b0534acd85aa0946b1ca2bbe3..refs/tags/wordpress-3.0.5:/wp-admin/includes/template.php diff --git a/wp-admin/includes/template.php b/wp-admin/includes/template.php index 79bc9900..fd7e76f9 100644 --- a/wp-admin/includes/template.php +++ b/wp-admin/includes/template.php @@ -8,215 +8,23 @@ * @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; - - if ( empty($categories) ) { - - $args = array('hide_empty' => 0); - if ( !empty($_GET['s']) ) - $args['search'] = $_GET['s']; - - $categories = get_categories( $args ); - - if ( empty($categories) ) - return false; - } - - $children = _get_term_hierarchy('category'); - - _cat_rows( $parent, $level, $categories, $children, $page, $per_page, $count ); - -} - -/** - * {@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( $parent = 0, $level = 0, $categories, &$children, $page = 1, $per_page = 20, &$count ) { - - $start = ($page - 1) * $per_page; - $end = $start + $per_page; - ob_start(); - - foreach ( $categories as $key => $category ) { - if ( $count >= $end ) - break; - - if ( $category->parent != $parent && empty($_GET['s']) ) - continue; - - // If the page starts in a subtree, print the parents. - if ( $count == $start && $category->parent > 0 ) { - - $my_parents = array(); - $p = $category->parent; - while ( $p ) { - $my_parent = get_category( $p ); - $my_parents[] = $my_parent; - if ( $my_parent->parent == 0 ) - break; - $p = $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[ $key ] ); - - $count++; - - if ( isset($children[$category->term_id]) ) - _cat_rows( $category->term_id, $level + 1, $categories, $children, $page, $per_page, $count ); - } - - $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( '— ', max(0, $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)) . "'>" . esc_attr( $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) . "'>" . __('Delete') . ""; - $actions = apply_filters('cat_row_actions', $actions, $category); - $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 .= ''; - break; - case 'description': - $output .= "$category->description"; - break; - case 'slug': - $output .= "" . apply_filters('editable_slug', $category->slug) . ""; - break; - case 'posts': - $attributes = 'class="posts column-posts num"' . $style; - $output .= "$posts_count\n"; - break; - default: - $output .= ""; - $output .= apply_filters('manage_categories_custom_column', '', $column_name, $category->term_id); - $output .= ""; - } - } - $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. + * Outputs the HTML for the hidden table rows used in Categories, Link Categories and Tags quick edit. * - * @param string $type "tag", "category" or "link-category" + * @param string $type "edit-tags", "categoried" or "edit-link-categories" + * @param string $taxonomy The taxonomy of the row. * @return */ -function inline_edit_term_row($type) { +function inline_edit_term_row($type, $taxonomy) { - if ( ! current_user_can( 'manage_categories' ) ) + $tax = get_taxonomy($taxonomy); + if ( ! current_user_can( $tax->cap->edit_terms ) ) 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); @@ -232,20 +40,12 @@ function inline_edit_term_row($type) { - + - - - - - - + @@ -256,18 +56,19 @@ function inline_edit_term_row($type) { foreach ( $columns as $column_name => $column_display_name ) { if ( isset( $core_columns[$column_name] ) ) continue; - do_action( 'quick_edit_custom_box', $column_name, $type ); + do_action( 'quick_edit_custom_box', $column_name, $type, $taxonomy ); } ?>

- + labels->update_item; ?> - + +

@@ -371,81 +172,10 @@ function link_cat_row( $category, $name_override = false ) { return $output; } -/** - * Outputs the html checked attribute. - * - * Compares the first two arguments and if identical marks as checked - * - * @since 1.0 - * - * @param any $checked One of the values to compare - * @param any $current (true) The other value to compare if not just true - * @param bool $echo Whether or not to echo or just return the string - */ -function checked( $checked, $current = true, $echo = true) { - return __checked_selected_helper( $checked, $current, $echo, 'checked' ); -} - -/** - * Outputs the html selected attribute. - * - * Compares the first two arguments and if identical marks as selected - * - * @since 1.0 - * - * @param any selected One of the values to compare - * @param any $current (true) The other value to compare if not just true - * @param bool $echo Whether or not to echo or just return the string - */ -function selected( $selected, $current = true, $echo = true) { - return __checked_selected_helper( $selected, $current, $echo, 'selected' ); -} - -/** - * Private helper function for checked and selected. - * - * Compares the first two arguments and if identical marks as $type - * - * @since 2.8 - * @access private - * - * @param any $helper One of the values to compare - * @param any $current (true) The other value to compare if not just true - * @param bool $echo Whether or not to echo or just return the string - * @param string $type The type of checked|selected we are doing. - */ -function __checked_selected_helper( $helper, $current, $echo, $type) { - if ( (string) $helper === (string) $current) - $result = " $type='$type'"; - else - $result = ''; - - if ($echo) - echo $result; - - return $result; -} - // // 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}} * @@ -467,9 +197,16 @@ class Walker_Category_Checklist extends Walker { function start_el(&$output, $category, $depth, $args) { extract($args); + if ( empty($taxonomy) ) + $taxonomy = 'category'; + + if ( $taxonomy == 'category' ) + $name = 'post_category'; + else + $name = 'tax_input['.$taxonomy.']'; $class = in_array( $category->term_id, $popular_cats ) ? ' class="popular-category"' : ''; - $output .= "\n
  • " . ''; + $output .= "\n
  • " . ''; } function end_el(&$output, $category, $depth, $args) { @@ -488,31 +225,62 @@ class Walker_Category_Checklist extends Walker { * @param unknown_type $popular_cats */ 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 + )); +} + +/** + * Taxonomy independent version of wp_category_checklist + * + * @param int $post_id + * @param array $args + */ +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 + ); + extract( wp_parse_args($args, $defaults), EXTR_SKIP ); + if ( empty($walker) || !is_a($walker, 'Walker') ) $walker = new Walker_Category_Checklist; $descendants_and_self = (int) $descendants_and_self; - $args = array(); + $args = array('taxonomy' => $taxonomy); + + $tax = get_taxonomy($taxonomy); + $args['disabled'] = !current_user_can($tax->cap->assign_terms); if ( is_array( $selected_cats ) ) $args['selected_cats'] = $selected_cats; elseif ( $post_id ) - $args['selected_cats'] = wp_get_post_categories($post_id); + $args['selected_cats'] = wp_get_object_terms($post_id, $taxonomy, array_merge($args, array('fields' => 'ids'))); 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 ) ); + $args['popular_cats'] = get_terms( $taxonomy, 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 ); + $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 = get_categories('get=all'); + $categories = (array) get_terms($taxonomy, array('get' => 'all')); } if ( $checked_ontop ) { @@ -549,25 +317,31 @@ function wp_popular_terms_checklist( $taxonomy, $default = 0, $number = 10, $ech global $post_ID; if ( $post_ID ) - $checked_categories = wp_get_post_categories($post_ID); + $checked_terms = wp_get_object_terms($post_ID, $taxonomy, array('fields'=>'ids')); else - $checked_categories = array(); + $checked_terms = array(); - $categories = get_terms( $taxonomy, array( 'orderby' => 'count', 'order' => 'DESC', 'number' => $number, 'hierarchical' => false ) ); + $terms = get_terms( $taxonomy, array( 'orderby' => 'count', 'order' => 'DESC', 'number' => $number, 'hierarchical' => false ) ); + + $tax = get_taxonomy($taxonomy); + if ( ! current_user_can($tax->cap->assign_terms) ) + $disabled = 'disabled="disabled"'; + else + $disabled = ''; $popular_ids = array(); - foreach ( (array) $categories as $category ) { - $popular_ids[] = $category->term_id; + foreach ( (array) $terms as $term ) { + $popular_ids[] = $term->term_id; if ( !$echo ) // hack for AJAX use continue; - $id = "popular-category-$category->term_id"; - $checked = in_array( $category->term_id, $checked_categories ) ? 'checked="checked"' : ''; + $id = "popular-$taxonomy-$term->term_id"; + $checked = in_array( $term->term_id, $checked_terms ) ? 'checked="checked"' : ''; ?>
  • @@ -576,21 +350,6 @@ function wp_popular_terms_checklist( $taxonomy, $default = 0, $number = 10, $ech return $popular_ids; } -/** - * {@internal Missing Short Description}} - * - * @since unknown - * @deprecated Use {@link wp_link_category_checklist()} - * @see wp_link_category_checklist() - * - * @param unknown_type $default - */ -function dropdown_link_categories( $default = 0 ) { - global $link_id; - - wp_link_category_checklist($link_id); -} - /** * {@internal Missing Short Description}} * @@ -602,26 +361,24 @@ function wp_link_category_checklist( $link_id = 0 ) { $default = 1; if ( $link_id ) { - $checked_categories = wp_get_link_cats($link_id); - - if ( count( $checked_categories ) == 0 ) { - // No selected categories, strange + $checked_categories = wp_get_link_cats( $link_id ); + // No selected categories, strange + if ( ! count( $checked_categories ) ) $checked_categories[] = $default; - } } else { $checked_categories[] = $default; } - $categories = get_terms('link_category', 'orderby=count&hide_empty=0'); + $categories = get_terms( 'link_category', array( 'orderby' => 'name', 'hide_empty' => 0 ) ); - if ( empty($categories) ) + if ( empty( $categories ) ) return; foreach ( $categories as $category ) { $cat_id = $category->term_id; - $name = esc_html( apply_filters('the_category', $category->name)); - $checked = in_array( $cat_id, $checked_categories ); - echo '"; + $name = esc_html( apply_filters( 'the_category', $category->name ) ); + $checked = in_array( $cat_id, $checked_categories ) ? ' checked="checked"' : ''; + echo '"; } } @@ -638,18 +395,36 @@ function wp_link_category_checklist( $link_id = 0 ) { * @param unknown_type $class * @return unknown */ -function _tag_row( $tag, $class = '', $taxonomy = 'post_tag' ) { +function _tag_row( $tag, $level, $taxonomy = 'post_tag' ) { + global $post_type, $current_screen; + static $row_class = ''; + $row_class = ($row_class == '' ? ' class="alternate"' : ''); + $count = number_format_i18n( $tag->count ); - $tagsel = ($taxonomy == 'post_tag' ? 'tag' : $taxonomy); - $count = ( $count > 0 ) ? "$count" : $count; + $tax = get_taxonomy($taxonomy); + + if ( 'post_tag' == $taxonomy ) { + $tagsel = 'tag'; + } elseif ( 'category' == $taxonomy ) { + $tagsel = 'category_name'; + } elseif ( ! empty($tax->query_var) ) { + $tagsel = $tax->query_var; + } else { + $tagsel = $taxonomy; + } - $name = apply_filters( 'term_name', $tag->name ); + $pad = str_repeat( '— ', max(0, $level) ); + $name = apply_filters( 'term_name', $pad . ' ' . $tag->name, $tag ); $qe_data = get_term($tag->term_id, $taxonomy, object, 'edit'); - $edit_link = "edit-tags.php?action=edit&taxonomy=$taxonomy&tag_ID=$tag->term_id"; + $edit_link = "edit-tags.php?action=edit&taxonomy=$taxonomy&post_type=$post_type&tag_ID=$tag->term_id"; + $out = ''; - $out .= ''; - $columns = get_column_headers('edit-tags'); - $hidden = get_hidden_columns('edit-tags'); + $out .= ''; + + + $columns = get_column_headers($current_screen); + $hidden = get_hidden_columns($current_screen); + $default_term = get_option('default_' . $taxonomy); foreach ( $columns as $column_name => $column_display_name ) { $class = "class=\"$column_name column-$column_name\""; @@ -661,15 +436,24 @@ function _tag_row( $tag, $class = '', $taxonomy = 'post_tag' ) { switch ($column_name) { case 'cb': - $out .= ' '; + if ( current_user_can($tax->cap->delete_terms) && $tag->term_id != $default_term ) + $out .= ' '; + else + $out .= ' '; break; case 'name': $out .= '' . $name . '
    '; $actions = array(); - $actions['edit'] = '' . __('Edit') . ''; - $actions['inline hide-if-no-js'] = '' . __('Quick Edit') . ''; - $actions['delete'] = "term_id) . "'>" . __('Delete') . ""; + if ( current_user_can($tax->cap->edit_terms) ) { + $actions['edit'] = '' . __('Edit') . ''; + $actions['inline hide-if-no-js'] = '' . __('Quick Edit') . ''; + } + if ( current_user_can($tax->cap->delete_terms) && $tag->term_id != $default_term ) + $actions['delete'] = "term_id) . "'>" . __('Delete') . ""; + $actions = apply_filters('tag_row_actions', $actions, $tag); + $actions = apply_filters("${taxonomy}_row_actions", $actions, $tag); + $action_count = count($actions); $i = 0; $out .= '
    '; @@ -681,7 +465,8 @@ function _tag_row( $tag, $class = '', $taxonomy = 'post_tag' ) { $out .= '
    '; $out .= ''; + $out .= '
    ' . apply_filters('editable_slug', $qe_data->slug) . '
    '; + $out .= '
    ' . $qe_data->parent . '
    '; break; case 'description': $out .= "$tag->description"; @@ -691,7 +476,7 @@ function _tag_row( $tag, $class = '', $taxonomy = 'post_tag' ) { break; case 'posts': $attributes = 'class="posts column-posts num"' . $style; - $out .= "$count"; + $out .= "$count"; break; default: $out .= ""; @@ -700,7 +485,7 @@ function _tag_row( $tag, $class = '', $taxonomy = 'post_tag' ) { } } - $out .= ''; + $out .= "\n"; return $out; } @@ -725,23 +510,84 @@ function tag_rows( $page = 1, $pagesize = 20, $searchterms = '', $taxonomy = 'po $args = array('offset' => $start, 'number' => $pagesize, 'hide_empty' => 0); - if ( !empty( $searchterms ) ) { + if ( !empty( $searchterms ) ) $args['search'] = $searchterms; - } - - $tags = get_terms( $taxonomy, $args ); // convert it to table rows $out = ''; $count = 0; - foreach( $tags as $tag ) - $out .= _tag_row( $tag, ++$count % 2 ? ' class="alternate"' : '', $taxonomy ); + if ( is_taxonomy_hierarchical($taxonomy) ) { + // We'll need the full set of terms then. + $args['number'] = $args['offset'] = 0; + + $terms = get_terms( $taxonomy, $args ); + if ( !empty( $searchterms ) ) // Ignore children on searches. + $children = array(); + else + $children = _get_term_hierarchy($taxonomy); + + // Some funky recursion to get the job done(Paging & parents mainly) is contained within, Skip it for non-hierarchical taxonomies for performance sake + $out .= _term_rows($taxonomy, $terms, $children, $page, $pagesize, $count); + } else { + $terms = get_terms( $taxonomy, $args ); + foreach( $terms as $term ) + $out .= _tag_row( $term, 0, $taxonomy ); + $count = $pagesize; // Only displaying a single page. + } - // filter and send to screen echo $out; return $count; } +function _term_rows( $taxonomy, $terms, &$children, $page = 1, $per_page = 20, &$count, $parent = 0, $level = 0 ) { + + $start = ($page - 1) * $per_page; + $end = $start + $per_page; + + $output = ''; + foreach ( $terms as $key => $term ) { + + if ( $count >= $end ) + break; + + if ( $term->parent != $parent && empty($_GET['s']) ) + continue; + + // If the page starts in a subtree, print the parents. + if ( $count == $start && $term->parent > 0 && empty($_GET['s']) ) { + $my_parents = $parent_ids = array(); + $p = $term->parent; + while ( $p ) { + $my_parent = get_term( $p, $taxonomy ); + $my_parents[] = $my_parent; + $p = $my_parent->parent; + if ( in_array($p, $parent_ids) ) // Prevent parent loops. + break; + $parent_ids[] = $p; + } + unset($parent_ids); + + $num_parents = count($my_parents); + while ( $my_parent = array_pop($my_parents) ) { + $output .= "\t" . _tag_row( $my_parent, $level - $num_parents, $taxonomy ); + $num_parents--; + } + } + + if ( $count >= $start ) + $output .= "\t" . _tag_row( $term, $level, $taxonomy ); + + ++$count; + + unset($terms[$key]); + + if ( isset($children[$term->term_id]) && empty($_GET['s']) ) + $output .= _term_rows( $taxonomy, $terms, $children, $page, $per_page, $count, $term->term_id, $level + 1 ); + } + + return $output; +} + // define the columns to display, the syntax is 'internal name' => 'display name' /** * {@internal Missing Short Description}} @@ -750,19 +596,31 @@ function tag_rows( $page = 1, $pagesize = 20, $searchterms = '', $taxonomy = 'po * * @return unknown */ -function wp_manage_posts_columns() { +function wp_manage_posts_columns( $screen = '') { + if ( empty($screen) ) + $post_type = 'post'; + else + $post_type = $screen->post_type; + $posts_columns = array(); $posts_columns['cb'] = ''; /* translators: manage posts column name */ - $posts_columns['title'] = _x('Post', 'column name'); + $posts_columns['title'] = _x('Title', 'column name'); $posts_columns['author'] = __('Author'); - $posts_columns['categories'] = __('Categories'); - $posts_columns['tags'] = __('Tags'); + if ( empty($post_type) || is_object_in_taxonomy($post_type, 'category') ) + $posts_columns['categories'] = __('Categories'); + if ( empty($post_type) || is_object_in_taxonomy($post_type, 'post_tag') ) + $posts_columns['tags'] = __('Tags'); $post_status = !empty($_REQUEST['post_status']) ? $_REQUEST['post_status'] : 'all'; - if ( !in_array( $post_status, array('pending', 'draft', 'future') ) ) - $posts_columns['comments'] = '
    Comments
    '; + if ( !in_array( $post_status, array('pending', 'draft', 'future') ) && ( empty($post_type) || post_type_supports($post_type, 'comments') ) ) + $posts_columns['comments'] = '
    Comments
    '; $posts_columns['date'] = __('Date'); - $posts_columns = apply_filters('manage_posts_columns', $posts_columns); + + if ( 'page' == $post_type ) + $posts_columns = apply_filters( 'manage_pages_columns', $posts_columns ); + else + $posts_columns = apply_filters( 'manage_posts_columns', $posts_columns, $post_type ); + $posts_columns = apply_filters( "manage_{$post_type}_posts_columns", $posts_columns ); return $posts_columns; } @@ -785,7 +643,7 @@ function wp_manage_media_columns() { //$posts_columns['tags'] = _x('Tags', 'column name'); /* translators: column name */ $posts_columns['parent'] = _x('Attached to', 'column name'); - $posts_columns['comments'] = '
    Comments
    '; + $posts_columns['comments'] = '
    Comments
    '; //$posts_columns['comments'] = __('Comments'); /* translators: column name */ $posts_columns['date'] = _x('Date', 'column name'); @@ -802,46 +660,36 @@ function wp_manage_media_columns() { * @return unknown */ function wp_manage_pages_columns() { - $posts_columns = array(); - $posts_columns['cb'] = ''; - $posts_columns['title'] = __('Title'); - $posts_columns['author'] = __('Author'); - $post_status = !empty($_REQUEST['post_status']) ? $_REQUEST['post_status'] : 'all'; - 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; + return wp_manage_posts_columns(); } /** - * {@internal Missing Short Description}} + * Get the column headers for a screen * * @since unknown * - * @param unknown_type $page - * @return unknown + * @param string|object $screen The screen you want the headers for + * @return array Containing the headers in the format id => UI String */ -function get_column_headers($page) { +function get_column_headers($screen) { global $_wp_column_headers; if ( !isset($_wp_column_headers) ) $_wp_column_headers = array(); + if ( is_string($screen) ) + $screen = convert_to_screen($screen); + // Store in static to avoid running filters on each call - if ( isset($_wp_column_headers[$page]) ) - return $_wp_column_headers[$page]; + if ( isset($_wp_column_headers[$screen->id]) ) + return $_wp_column_headers[$screen->id]; - switch ($page) { + switch ($screen->base) { case 'edit': - $_wp_column_headers[$page] = wp_manage_posts_columns(); + $_wp_column_headers[$screen->id] = wp_manage_posts_columns( $screen ); break; - case 'edit-pages': - $_wp_column_headers[$page] = wp_manage_pages_columns(); - break; case 'edit-comments': - $_wp_column_headers[$page] = array( + $_wp_column_headers[$screen->id] = array( 'cb' => '', 'author' => __('Author'), /* translators: column name */ @@ -852,7 +700,7 @@ function get_column_headers($page) { break; case 'link-manager': - $_wp_column_headers[$page] = array( + $_wp_column_headers[$screen->id] = array( 'cb' => '', 'name' => __('Name'), 'url' => __('URL'), @@ -864,10 +712,10 @@ function get_column_headers($page) { break; case 'upload': - $_wp_column_headers[$page] = wp_manage_media_columns(); + $_wp_column_headers[$screen->id] = wp_manage_media_columns(); break; case 'categories': - $_wp_column_headers[$page] = array( + $_wp_column_headers[$screen->id] = array( 'cb' => '', 'name' => __('Name'), 'description' => __('Description'), @@ -877,7 +725,7 @@ function get_column_headers($page) { break; case 'edit-link-categories': - $_wp_column_headers[$page] = array( + $_wp_column_headers[$screen->id] = array( 'cb' => '', 'name' => __('Name'), 'description' => __('Description'), @@ -887,7 +735,7 @@ function get_column_headers($page) { break; case 'edit-tags': - $_wp_column_headers[$page] = array( + $_wp_column_headers[$screen->id] = array( 'cb' => '', 'name' => __('Name'), 'description' => __('Description'), @@ -897,7 +745,7 @@ function get_column_headers($page) { break; case 'users': - $_wp_column_headers[$page] = array( + $_wp_column_headers[$screen->id] = array( 'cb' => '', 'username' => __('Username'), 'name' => __('Name'), @@ -907,11 +755,11 @@ function get_column_headers($page) { ); break; default : - $_wp_column_headers[$page] = array(); + $_wp_column_headers[$screen->id] = array(); } - $_wp_column_headers[$page] = apply_filters('manage_' . $page . '_columns', $_wp_column_headers[$page]); - return $_wp_column_headers[$page]; + $_wp_column_headers[$screen->id] = apply_filters('manage_' . $screen->id . '_columns', $_wp_column_headers[$screen->id]); + return $_wp_column_headers[$screen->id]; } /** @@ -919,18 +767,16 @@ function get_column_headers($page) { * * @since unknown * - * @param unknown_type $type + * @param unknown_type $screen * @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); +function print_column_headers( $screen, $id = true ) { + if ( is_string($screen) ) + $screen = convert_to_screen($screen); + + $columns = get_column_headers( $screen ); + $hidden = get_hidden_columns($screen); $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'; @@ -948,8 +794,8 @@ function print_column_headers( $type, $id = true ) { if ( in_array($column_key, $hidden) ) $style = 'display:none;'; - if ( isset($styles[$type]) && isset($styles[$type][$column_key]) ) - $style .= ' ' . $styles[$type][$column_key]; + if ( isset($styles[$screen->id]) && isset($styles[$screen->id][$column_key]) ) + $style .= ' ' . $styles[$screen>id][$column_key]; $style = ' style="' . $style . '"'; ?> > @@ -968,10 +814,13 @@ function print_column_headers( $type, $id = true ) { function register_column_headers($screen, $columns) { global $_wp_column_headers; + if ( is_string($screen) ) + $screen = convert_to_screen($screen); + if ( !isset($_wp_column_headers) ) $_wp_column_headers = array(); - $_wp_column_headers[$screen] = $columns; + $_wp_column_headers[$screen->id] = $columns; } /** @@ -979,11 +828,13 @@ function register_column_headers($screen, $columns) { * * @since unknown * - * @param unknown_type $page + * @param unknown_type $screen */ -function get_hidden_columns($page) { - $page = str_replace('.php', '', $page); - return (array) get_user_option( 'manage-' . $page . '-columns-hidden', 0, false ); +function get_hidden_columns($screen) { + if ( is_string($screen) ) + $screen = convert_to_screen($screen); + + return (array) get_user_option( 'manage' . $screen->id. 'columnshidden' ); } /** @@ -993,43 +844,61 @@ function get_hidden_columns($page) { * * @since 2.7 * - * @param string $type 'post' or 'page' + * @param string $screen */ -function inline_edit_row( $type ) { - global $current_user, $mode; +function inline_edit_row( $screen ) { + global $mode; - $is_page = 'page' == $type; - if ( $is_page ) { - $screen = 'edit-pages'; - $post = get_default_page_to_edit(); - } else { - $screen = 'edit'; - $post = get_default_post_to_edit(); + if ( is_string($screen) ) { + $screen = array('id' => 'edit-' . $screen, 'base' => 'edit', 'post_type' => $screen ); + $screen = (object) $screen; + } + + $post = get_default_post_to_edit( $screen->post_type ); + $post_type_object = get_post_type_object( $screen->post_type ); + + $taxonomy_names = get_object_taxonomies( $screen->post_type ); + $hierarchical_taxonomies = array(); + $flat_taxonomies = array(); + foreach ( $taxonomy_names as $taxonomy_name ) { + $taxonomy = get_taxonomy( $taxonomy_name); + + if ( !$taxonomy->show_ui ) + continue; + + if ( $taxonomy->hierarchical ) + $hierarchical_taxonomies[] = $taxonomy; + else + $flat_taxonomies[] = $taxonomy; } - $columns = $is_page ? wp_manage_pages_columns() : wp_manage_posts_columns(); + $columns = wp_manage_posts_columns($screen); $hidden = array_intersect( array_keys( $columns ), array_filter( get_hidden_columns($screen) ) ); $col_count = count($columns) - count($hidden); $m = ( isset($mode) && 'excerpt' == $mode ) ? 'excerpt' : 'list'; - $can_publish = current_user_can("publish_{$type}s"); + $can_publish = current_user_can($post_type_object->cap->publish_posts); $core_columns = array( 'cb' => true, 'date' => true, 'title' => true, 'categories' => true, 'tags' => true, 'comments' => true, 'author' => true ); ?>
    - post_type "; + echo $bulk ? "bulk-edit-row bulk-edit-row-$hclass bulk-edit-$screen->post_type" : "quick-edit-row quick-edit-row-$hclass inline-edit-$screen->post_type"; ?>" style="display: none"> @@ -1286,20 +1181,20 @@ function inline_edit_row( $type ) { * @param unknown_type $post */ function get_inline_data($post) { - - if ( ! current_user_can('edit_' . $post->post_type, $post->ID) ) + $post_type_object = get_post_type_object($post->post_type); + if ( ! current_user_can($post_type_object->cap->edit_post, $post->ID) ) return; - $title = esc_attr($post->post_title); + $title = htmlspecialchars( trim( $post->post_title ), ENT_QUOTES ); echo ' '; } @@ -1345,8 +1250,6 @@ function post_rows( $posts = array() ) { $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]) ) @@ -1366,7 +1269,7 @@ function post_rows( $posts = array() ) { * @param unknown_type $mode */ function _post_row($a_post, $pending_comments, $mode) { - global $post, $current_user; + global $post, $current_screen; static $rowclass; $global_post = $post; @@ -1374,14 +1277,15 @@ function _post_row($a_post, $pending_comments, $mode) { setup_postdata($post); $rowclass = 'alternate' == $rowclass ? '' : 'alternate'; - $post_owner = ( $current_user->ID == $post->post_author ? 'self' : 'other' ); + $post_owner = ( get_current_user_id() == $post->post_author ? 'self' : 'other' ); $edit_link = get_edit_post_link( $post->ID ); $title = _draft_or_post_title(); + $post_type_object = get_post_type_object($post->post_type); ?> post_status ); ?> iedit' valign="top"> $column_display_name ) { $class = "class=\"$column_name column-$column_name\""; @@ -1395,7 +1299,7 @@ function _post_row($a_post, $pending_comments, $mode) { case 'cb': ?> - + - + - + - + ID; $rowclass = 'alternate' == $rowclass ? '' : 'alternate'; - $posts_columns = get_column_headers('edit-pages'); - $hidden = get_hidden_columns('edit-pages'); + $posts_columns = get_column_headers( $current_screen ); + $hidden = get_hidden_columns( $current_screen ); $title = _draft_or_post_title(); + $post_type = $page->post_type; + $post_type_object = get_post_type_object($post_type); ?> $column_display_name) { +foreach ( $posts_columns as $column_name => $column_display_name ) { $class = "class=\"$column_name column-$column_name\""; $style = ''; @@ -1623,7 +1529,7 @@ foreach ($posts_columns as $column_name=>$column_display_name) { case 'cb': ?> - + $column_display_name) { $attributes = 'class="post-title page-title column-title"' . $style; $edit_link = get_edit_post_link( $page->ID ); ?> - + post_parent == $page->ID ) { $page->post_parent = 0; - $wpdb->query( $wpdb->prepare("UPDATE $wpdb->posts SET post_parent = '0' WHERE ID = %d", $page->ID) ); + $wpdb->update($wpdb->posts, array('post_parent' => 0), array('ID' => $page->ID)); clean_page_cache( $page->ID ); } @@ -1820,12 +1726,9 @@ function page_rows($pages, $pagenum = 1, $per_page = 20) { } } -/* +/** * Given a top level page ID, display the nested hierarchy of sub-pages * together with paging support - */ -/** - * {@internal Missing Short Description}} * * @since unknown * @@ -1879,20 +1782,19 @@ function _page_rows( &$children_pages, &$count, $parent, $level, $pagenum, $per_ } /** - * {@internal Missing Short Description}} + * Generate HTML for a single row on the users.php admin panel. * - * @since unknown + * @since 2.1.0 * - * @param unknown_type $user_object - * @param unknown_type $style - * @param unknown_type $role - * @return unknown + * @param object $user_object + * @param string $style Optional. Attributes added to the TR element. Must be sanitized. + * @param string $role Key for the $wp_roles array. + * @param int $numposts Optional. Post count to display for this user. Defaults to zero, as in, a new user has made zero posts. + * @return string */ -function user_row( $user_object, $style = '', $role = '' ) { +function user_row( $user_object, $style = '', $role = '', $numposts = 0 ) { global $wp_roles; - $current_user = wp_get_current_user(); - if ( !( is_object( $user_object) && is_a( $user_object, 'WP_User' ) ) ) $user_object = new WP_User( (int) $user_object ); $user_object = sanitize_user_object($user_object, 'display'); @@ -1904,13 +1806,12 @@ function user_row( $user_object, $style = '', $role = '' ) { $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 ); $checkbox = ''; // Check if the user for this row is editable - if ( current_user_can( 'edit_user', $user_object->ID ) ) { + if ( current_user_can( 'list_users' ) ) { // Set up the user editing link - // TODO: make profile/user-edit determination a seperate function - if ($current_user->ID == $user_object->ID) { + // TODO: make profile/user-edit determination a separate function + if ( get_current_user_id() == $user_object->ID) { $edit_link = 'profile.php'; } else { $edit_link = esc_url( add_query_arg( 'wp_http_referer', urlencode( esc_url( stripslashes( $_SERVER['REQUEST_URI'] ) ) ), "user-edit.php?user_id=$user_object->ID" ) ); @@ -1919,9 +1820,18 @@ function user_row( $user_object, $style = '', $role = '' ) { // Set up the hover actions for this user $actions = array(); - $actions['edit'] = '' . __('Edit') . ''; - if ( $current_user->ID != $user_object->ID ) + + if ( current_user_can('edit_user', $user_object->ID) ) { + $edit = "$user_object->user_login
    "; + $actions['edit'] = '' . __('Edit') . ''; + } else { + $edit = "$user_object->user_login
    "; + } + + if ( !is_multisite() && get_current_user_id() != $user_object->ID && current_user_can('delete_user', $user_object->ID) ) $actions['delete'] = "" . __('Delete') . ""; + if ( is_multisite() && get_current_user_id() != $user_object->ID && current_user_can('remove_user', $user_object->ID) ) + $actions['remove'] = "" . __('Remove') . ""; $actions = apply_filters('user_row_actions', $actions, $user_object); $action_count = count($actions); $i = 0; @@ -1964,7 +1874,7 @@ function user_row( $user_object, $style = '', $role = '' ) { $r .= ""; break; case 'email': - $r .= ""; + $r .= ""; break; case 'role': $r .= ""; @@ -2095,8 +2005,10 @@ function _wp_comment_row( $comment_id, $mode, $comment_status, $checkbox = true, $comment = get_comment( $comment_id ); $post = get_post($comment->comment_post_ID); $the_comment_status = wp_get_comment_status($comment->comment_ID); - $user_can = current_user_can('edit_post', $post->ID); + $post_type_object = get_post_type_object($post->post_type); + $user_can = current_user_can($post_type_object->cap->edit_post, $post->ID); + $comment_url = esc_url(get_comment_link($comment->comment_ID)); $author_url = get_comment_author_url(); if ( 'http://' == $author_url ) $author_url = ''; @@ -2145,7 +2057,18 @@ function _wp_comment_row( $comment_id, $mode, $comment_status, $checkbox = true, case 'comment': echo "
    -

    +

    - +post_type, 'title' ) ) : + if ( $bulk ) : ?>
    @@ -1041,16 +910,15 @@ function inline_edit_row( $type ) { - - - - - + + +
    @@ -1059,12 +927,13 @@ function inline_edit_row( $type ) { id, true, $type ); // TODO: ROLE SYSTEM + if ( post_type_supports( $screen->post_type, 'author' ) ) : + $authors = get_editable_user_ids( get_current_user_id(), true, $screen->post_type ); // TODO: ROLE SYSTEM $authors_dropdown = ''; if ( $authors && count( $authors ) > 1 ) : $users_opt = array('include' => $authors, 'name' => 'post_author', 'class'=> 'authors', 'multi' => 1, 'echo' => 0); if ( $bulk ) - $users_opt['show_option_none'] = __('- No Change -'); + $users_opt['show_option_none'] = __('— No Change —'); $authors_dropdown = '
    - +
    - + + + + labels->name) ?> -
      - + +
        + $taxonomy->name)) ?>
      + + +
    - +
    post_type, 'author' ) && $bulk ) echo $authors_dropdown; ?> - +hierarchical ) : ?> - +post_type, 'page-attributes' ) ) : + if ( !$bulk ) : ?> - +hierarchical ?> + + + + - + - + + +post_type, 'comments' ) || post_type_supports( $screen->post_type, 'trackbacks' ) ) : + if ( $bulk ) : ?>
    + post_type, 'comments' ) ) : ?> - + post_type, 'trackbacks' ) ) : ?> +
    + post_type, 'comments' ) ) : ?> - + post_type, 'trackbacks' ) ) : ?> +
    - - +
    - +post_type && $can_publish && current_user_can( $post_type_object->cap->edit_others_posts ) ) : ?>
    @@ -1250,23 +1144,24 @@ function inline_edit_row( $type ) { foreach ( $columns as $column_name => $column_display_name ) { if ( isset( $core_columns[$column_name] ) ) continue; - do_action( $bulk ? 'bulk_edit_custom_box' : 'quick_edit_custom_box', $column_name, $type); + do_action( $bulk ? 'bulk_edit_custom_box' : 'quick_edit_custom_box', $column_name, $screen->post_type ); } ?>

    - + - + +

    ID ) ) { ?>cap->edit_post, $post->ID ) ) { ?> >ID) && $post->post_status != 'trash' ) { ?> + >cap->edit_post, $post->ID) && $post->post_status != 'trash' ) { ?> ID) && 'trash' != $post->post_status ) { - $actions['edit'] = '' . __('Edit') . ''; - $actions['inline hide-if-no-js'] = '' . __('Quick Edit') . ''; + if ( current_user_can($post_type_object->cap->edit_post, $post->ID) && 'trash' != $post->post_status ) { + $actions['edit'] = '' . __('Edit') . ''; + $actions['inline hide-if-no-js'] = '' . __('Quick Edit') . ''; } - if ( current_user_can('delete_post', $post->ID) ) { + if ( current_user_can($post_type_object->cap->delete_post, $post->ID) ) { if ( 'trash' == $post->post_status ) - $actions['untrash'] = "ID) . "'>" . __('Restore') . ""; + $actions['untrash'] = "ID) ), 'untrash-' . $post->post_type . '_' . $post->ID ) . "'>" . __('Restore') . ""; elseif ( EMPTY_TRASH_DAYS ) - $actions['trash'] = "" . __('Trash') . ""; + $actions['trash'] = "" . __('Trash') . ""; if ( 'trash' == $post->post_status || !EMPTY_TRASH_DAYS ) - $actions['delete'] = "ID) . "'>" . __('Delete Permanently') . ""; + $actions['delete'] = "" . __('Delete Permanently') . ""; } if ( in_array($post->post_status, array('pending', 'draft')) ) { - if ( current_user_can('edit_post', $post->ID) ) - $actions['view'] = '' . __('Preview') . ''; + if ( current_user_can($post_type_object->cap->edit_post, $post->ID) ) + $actions['view'] = '' . __('Preview') . ''; } elseif ( 'trash' != $post->post_status ) { $actions['view'] = '' . __('View') . ''; } @@ -1486,7 +1390,7 @@ function _post_row($a_post, $pending_comments, $mode) { if ( !empty( $categories ) ) { $out = array(); foreach ( $categories as $c ) - $out[] = " " . esc_html(sanitize_term_field('name', $c->name, $c->term_id, 'category', 'display')) . ""; + $out[] = " " . esc_html(sanitize_term_field('name', $c->name, $c->term_id, 'category', 'display')) . ""; echo join( ', ', $out ); } else { _e('Uncategorized'); @@ -1502,7 +1406,7 @@ function _post_row($a_post, $pending_comments, $mode) { if ( !empty( $tags ) ) { $out = array(); foreach ( $tags as $c ) - $out[] = " " . esc_html(sanitize_term_field('name', $c->name, $c->term_id, 'post_tag', 'display')) . ""; + $out[] = " " . esc_html(sanitize_term_field('name', $c->name, $c->term_id, 'post_tag', 'display')) . ""; echo join( ', ', $out ); } else { _e('No Tags'); @@ -1528,7 +1432,7 @@ function _post_row($a_post, $pending_comments, $mode) { case 'author': ?> - >> ID) ) { echo "" . __('Edit') . ""; } ?>cap->edit_post, $post->ID) ) { echo "" . __('Edit') . ""; } ?> ID) ) { echo "ID) . "' class='delete'>" . __('Delete') . ""; } ?>cap->delete_post, $post->ID) ) { echo "ID) . "' class='delete'>" . __('Delete') . ""; } ?>
    cap->edit_post, $page->ID ) ) { ?> >ID) && $post->post_status != 'trash' ) { ?> + >cap->edit_post, $page->ID) && $post->post_status != 'trash' ) { ?>labels->parent_item_colon . ' ' . esc_html($parent_name) : ''; ?> ID) && $post->post_status != 'trash' ) { + if ( current_user_can($post_type_object->cap->edit_post, $page->ID) && $post->post_status != 'trash' ) { $actions['edit'] = '' . __('Edit') . ''; $actions['inline'] = '' . __('Quick Edit') . ''; } - if ( current_user_can('delete_page', $page->ID) ) { + if ( current_user_can($post_type_object->cap->delete_post, $page->ID) ) { if ( $post->post_status == 'trash' ) - $actions['untrash'] = "ID) . "'>" . __('Restore') . ""; + $actions['untrash'] = "post_type . '_' . $page->ID) . "'>" . __('Restore') . ""; elseif ( EMPTY_TRASH_DAYS ) $actions['trash'] = "" . __('Trash') . ""; if ( $post->post_status == 'trash' || !EMPTY_TRASH_DAYS ) - $actions['delete'] = "ID) . "'>" . __('Delete Permanently') . ""; + $actions['delete'] = "post_type . '_' . $page->ID) . "'>" . __('Delete Permanently') . ""; } if ( in_array($post->post_status, array('pending', 'draft')) ) { - if ( current_user_can('edit_page', $page->ID) ) - $actions['view'] = '' . __('Preview') . ''; + if ( current_user_can($post_type_object->cap->edit_post, $page->ID) ) + $actions['view'] = '' . __('Preview') . ''; } elseif ( $post->post_status != 'trash' ) { $actions['view'] = '' . __('View') . ''; } @@ -1716,7 +1622,7 @@ foreach ($posts_columns as $column_name=>$column_display_name) { case 'author': ?> - >> $user_object->first_name $user_object->last_name$email$email$role_name"; echo '
    '; - printf(__('Submitted on %2$s at %3$s'), get_comment_link($comment->comment_ID), get_comment_date(__('Y/m/d')), get_comment_date(__('g:ia'))); + /* translators: 2: comment date, 3: comment time */ + printf( __( '%2$s at %3$s' ), $comment_url, + /* translators: comment date format. See http://php.net/date */ get_comment_date( __('Y/m/d') ), + /* translators: comment time format. See http://php.net/date */ get_comment_date( get_option( 'time_format' ) ) ); + + if ( $comment->comment_parent ) { + $parent = get_comment( $comment->comment_parent ); + $parent_link = esc_url( get_comment_link( $comment->comment_parent ) ); + $name = apply_filters( 'get_comment_author', $parent->comment_author ); // there's no API function for this + printf( ' | '.__( 'In reply to %2$s.' ), $parent_link, $name ); + } + echo '
    '; comment_text(); if ( $user_can ) { ?> @@ -2172,18 +2095,18 @@ function _wp_comment_row( $comment_id, $mode, $comment_status, $checkbox = true, if ( $comment_status && 'all' != $comment_status ) { // not looking at all comments if ( 'approved' == $the_comment_status ) - $actions['unapprove'] = "" . __( 'Unapprove' ) . ''; + $actions['unapprove'] = "" . __( 'Unapprove' ) . ''; else if ( 'unapproved' == $the_comment_status ) - $actions['approve'] = "" . __( 'Approve' ) . ''; + $actions['approve'] = "" . __( 'Approve' ) . ''; } else { - $actions['approve'] = "" . __( 'Approve' ) . ''; - $actions['unapprove'] = "" . __( 'Unapprove' ) . ''; + $actions['approve'] = "" . __( 'Approve' ) . ''; + $actions['unapprove'] = "" . __( 'Unapprove' ) . ''; } if ( 'spam' != $the_comment_status && 'trash' != $the_comment_status ) { - $actions['spam'] = "" . /* translators: mark as spam link */ _x( 'Spam', 'verb' ) . ''; + $actions['spam'] = "" . /* translators: mark as spam link */ _x( 'Spam', 'verb' ) . ''; } elseif ( 'spam' == $the_comment_status ) { - $actions['unspam'] = "" . __( 'Not Spam' ) . ''; + $actions['unspam'] = "" . _x( 'Not Spam', 'comment' ) . ''; } elseif ( 'trash' == $the_comment_status ) { $actions['untrash'] = "" . __( 'Restore' ) . ''; } @@ -2191,14 +2114,14 @@ function _wp_comment_row( $comment_id, $mode, $comment_status, $checkbox = true, if ( 'spam' == $the_comment_status || 'trash' == $the_comment_status || !EMPTY_TRASH_DAYS ) { $actions['delete'] = "" . __('Delete Permanently') . ''; } else { - $actions['trash'] = "" . _x('Trash', 'verb') . ''; + $actions['trash'] = "" . _x('Trash', 'verb') . ''; } if ( 'trash' != $the_comment_status ) { - $actions['edit'] = "". __('Edit') . ''; - $actions['quickedit'] = '' . __('Quick Edit') . ''; + $actions['edit'] = "". __('Edit') . ''; + $actions['quickedit'] = '' . __('Quick Edit') . ''; if ( 'spam' != $the_comment_status ) - $actions['reply'] = '' . __('Reply') . ''; + $actions['reply'] = '' . __('Reply') . ''; } $actions = apply_filters( 'comment_row_actions', array_filter($actions), $comment ); @@ -2252,9 +2175,9 @@ function _wp_comment_row( $comment_id, $mode, $comment_status, $checkbox = true, case 'response': if ( 'single' !== $mode ) { if ( isset( $_comment_pending_count[$post->ID] ) ) { - $pending_comments = absint( $_comment_pending_count[$post->ID] ); + $pending_comments = $_comment_pending_count[$post->ID]; } else { - $_comment_pending_count_temp = (array) get_pending_comments_num( array( $post->ID ) ); + $_comment_pending_count_temp = get_pending_comments_num( array( $post->ID ) ); $pending_comments = $_comment_pending_count[$post->ID] = $_comment_pending_count_temp[$post->ID]; } if ( $user_can ) { @@ -2266,7 +2189,7 @@ function _wp_comment_row( $comment_id, $mode, $comment_status, $checkbox = true, echo "
    \n"; echo '
    @@ -2388,39 +2309,6 @@ function wp_comment_trashnotice() { 0) ); - - if ( $categories ) { - foreach ( $categories as $category ) { - if ( $currentcat != $category->term_id && $parent == $category->parent) { - $pad = str_repeat( '– ', $level ); - $category->name = esc_html( $category->name ); - echo "\n\t"; - wp_dropdown_cats( $currentcat, $currentparent, $category->term_id, $level +1, $categories ); - } - } - } else { - return false; - } -} - /** * {@internal Missing Short Description}} * @@ -2509,7 +2397,7 @@ function _list_meta_row( $entry, &$count ) { $r .= "\n\t\t
    "; - $r .= "\n\t\t
    "; + $r .= "\n\t\t"; $r .= wp_nonce_field( 'change-meta', '_ajax_nonce', false, false ); $r .= ""; @@ -2530,12 +2418,12 @@ function meta_form() { FROM $wpdb->postmeta GROUP BY meta_key HAVING meta_key NOT LIKE '\_%' - ORDER BY LOWER(meta_key) + ORDER BY meta_key LIMIT $limit" ); if ( $keys ) natcasesort($keys); ?> -

    +

    @@ -2549,12 +2437,11 @@ function meta_form() {
    @@ -2571,7 +2458,7 @@ function meta_form() {
    - +
    @@ -2593,7 +2480,7 @@ function touch_time( $edit = 1, $for_post = 1, $tab_index = 0, $multi = 0 ) { global $wp_locale, $post, $comment; 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 ) @@ -2601,7 +2488,7 @@ function touch_time( $edit = 1, $for_post = 1, $tab_index = 0, $multi = 0 ) { // echo '
    '; - $time_adj = time() + (get_option( 'gmt_offset' ) * 3600 ); + $time_adj = current_time('timestamp'); $post_date = ($for_post) ? $post->post_date : $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 ); @@ -2708,18 +2595,6 @@ 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 ' -
    Browse Happy
    -'; -} - /** * {@internal Missing Short Description}} * @@ -2735,7 +2610,7 @@ function the_attachment_links( $id = false ) { if ( $post->post_type != 'attachment' ) return false; - $icon = get_attachment_icon( $post->ID ); + $icon = wp_get_attachment_image( $post->ID, 'thumbnail', true ); $attachment_data = wp_get_attachment_metadata( $id ); $thumb = isset( $attachment_data['thumb'] ); ?> @@ -2783,13 +2658,12 @@ function the_attachment_links( $id = false ) { * @param string $default slug for the role that should be already selected */ function wp_dropdown_roles( $selected = false ) { - global $wp_roles; $p = ''; $r = ''; $editable_roles = get_editable_roles(); - foreach( $editable_roles as $role => $details ) { + foreach ( $editable_roles as $role => $details ) { $name = translate_user_role($details['name'] ); if ( $selected == $role ) // Make default first in list $p = "\n\t"; @@ -2880,18 +2754,6 @@ function wp_import_upload_form( $action ) { endif; } -/** - * {@internal Missing Short Description}} - * - * @since unknown - */ -function wp_remember_old_slug() { - global $post; - $name = esc_attr($post->post_name); // just in case - if ( strlen($name) ) - echo ''; -} - /** * Add a meta box to an edit form. * @@ -2956,29 +2818,27 @@ function add_meta_box($id, $title, $callback, $page, $context = 'advanced', $pri } /** - * {@internal Missing Short Description}} + * Meta-Box template function * - * @since unknown + * @since 2.5.0 * - * @param unknown_type $page - * @param unknown_type $context - * @param unknown_type $object + * @param string $page page identifier, also known as 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) { global $wp_meta_boxes; static $already_sorted = false; - //do_action('do_meta_boxes', $page, $context, $object); - $hidden = get_hidden_meta_boxes($page); - echo "
    \n"; + printf('
    ', htmlspecialchars($context)); $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 ) ) { + if ( !$already_sorted && $sorted = get_user_option( "meta-box-order_$page" ) ) { foreach ( $sorted as $box_context => $ids ) foreach ( explode(',', $ids) as $id ) if ( $id ) @@ -2996,9 +2856,8 @@ function do_meta_boxes($page, $context, $object) { continue; $i++; $style = ''; - if ( in_array($box['id'], $hidden) ) - $style = 'style="display:none;"'; - echo '
    ' . "\n"; + $hidden_class = in_array($box['id'], $hidden) ? ' hide-if-js' : ''; + echo '
    ' . "\n"; echo '

    '; echo "

    {$box['title']}

    \n"; echo '
    ' . "\n"; @@ -3044,19 +2903,22 @@ function remove_meta_box($id, $page, $context) { * * @since unknown * - * @param unknown_type $page + * @param unknown_type $screen */ -function meta_box_prefs($page) { +function meta_box_prefs($screen) { global $wp_meta_boxes; - if ( empty($wp_meta_boxes[$page]) ) + if ( is_string($screen) ) + $screen = convert_to_screen($screen); + + if ( empty($wp_meta_boxes[$screen->id]) ) return; - $hidden = get_hidden_meta_boxes($page); + $hidden = get_hidden_meta_boxes($screen); - 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 ) { + foreach ( array_keys($wp_meta_boxes[$screen->id]) as $context ) { + foreach ( array_keys($wp_meta_boxes[$screen->id][$context]) as $priority ) { + foreach ( $wp_meta_boxes[$screen->id][$context][$priority] as $box ) { if ( false == $box || ! $box['title'] ) continue; // Submit box cannot be hidden @@ -3071,13 +2933,23 @@ function meta_box_prefs($page) { } } -function get_hidden_meta_boxes($page) { - $hidden = (array) get_user_option( "meta-box-hidden_$page", 0, false ); +/** + * Get Hidden Meta Boxes + * + * @since 2.7 + * + * @param string|object $screen Screen identifier + * @return array Hidden Meta Boxes + */ +function get_hidden_meta_boxes( $screen ) { + if ( is_string( $screen ) ) + $screen = convert_to_screen( $screen ); + + $hidden = get_user_option( "metaboxhidden_{$screen->id}" ); // Hide slug boxes by default - if ( empty($hidden[0]) ) { + if ( !is_array( $hidden ) ) $hidden = array('slugdiv'); - } return $hidden; } @@ -3085,16 +2957,31 @@ function get_hidden_meta_boxes($page) { /** * Add a new section to a settings page. * + * Part of the Settings API. Use this to define new settings sections for an admin page. + * Show settings sections in your admin page callback function with do_settings_sections(). + * Add settings fields to your section with add_settings_field() + * + * The $callback argument should be the name of a function that echoes out any + * content you want to show at the top of the settings section before the actual + * fields. It can output nothing if you want. + * * @since 2.7.0 * - * @param string $id String for use in the 'id' attribute of tags. - * @param string $title Title of the section. - * @param string $callback Function that fills the section with the desired content. The function should echo its output. - * @param string $page The type of settings page on which to show the section (general, reading, writing, ...). + * @global $wp_settings_sections Storage array of all settings sections added to admin pages + * + * @param string $id Slug-name to identify the section. Used in the 'id' attribute of tags. + * @param string $title Formatted title of the section. Shown as the heading for the section. + * @param string $callback Function that echos out any content at the top of the section (between heading and fields). + * @param string $page The slug-name of the settings page on which to show the section. Built-in pages include 'general', 'reading', 'writing', 'discussion', 'media', etc. Create your own using add_options_page(); */ function add_settings_section($id, $title, $callback, $page) { global $wp_settings_sections; + if ( 'misc' == $page ) { + _deprecated_argument( __FUNCTION__, '3.0', __( 'The miscellaneous options group has been removed. Use another settings group.' ) ); + $page = 'general'; + } + if ( !isset($wp_settings_sections) ) $wp_settings_sections = array(); if ( !isset($wp_settings_sections[$page]) ) @@ -3106,20 +2993,35 @@ function add_settings_section($id, $title, $callback, $page) { } /** - * Add a new field to a settings page. + * Add a new field to a section of a settings page + * + * 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() + * + * 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 retrive existing + * values to show. * * @since 2.7.0 * - * @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, ...). + * @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 string $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 The slug-name of the section of the settingss page in which to show the box (default, ...). * @param array $args Additional arguments */ function add_settings_field($id, $title, $callback, $page, $section = 'default', $args = array()) { global $wp_settings_fields; + if ( 'misc' == $page ) { + _deprecated_argument( __FUNCTION__, '3.0', __( 'The miscellaneous options group has been removed. Use another settings group.' ) ); + $page = 'general'; + } + if ( !isset($wp_settings_fields) ) $wp_settings_fields = array(); if ( !isset($wp_settings_fields[$page]) ) @@ -3131,11 +3033,17 @@ function add_settings_field($id, $title, $callback, $page, $section = 'default', } /** - * {@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() + * + * @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 unknown * - * @param unknown_type $page + * @param string $page The slug name of the page whos settings sections you want to output */ function do_settings_sections($page) { global $wp_settings_sections, $wp_settings_fields; @@ -3155,12 +3063,18 @@ function do_settings_sections($page) { } /** - * {@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. + * + * @global $wp_settings_fields Storage array of settings fields and their pages/sections * * @since unknown * - * @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 section $section Slug title of the settings section who's fields you want to show. */ function do_settings_fields($page, $section) { global $wp_settings_fields; @@ -3181,6 +3095,131 @@ function do_settings_fields($page, $section) { } } +/** + * Register a settings error to be displayed to the user + * + * Part of the Settings API. Use this to show messages to users about settings validation + * problems, missing settings or anything else. + * + * 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. + * + * @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

    ) + * @param string $type The type of message it is, controls HTML class. Use 'error' or 'updated'. + */ +function add_settings_error( $setting, $code, $message, $type = 'error' ) { + global $wp_settings_errors; + + if ( !isset($wp_settings_errors) ) + $wp_settings_errors = array(); + + $new_error = array( + 'setting' => $setting, + 'code' => $code, + 'message' => $message, + 'type' => $type + ); + $wp_settings_errors[] = $new_error; +} + +/** + * 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['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) + * + * @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 sanitizisation 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 + // Ignore transients if $sanitize is true, we dont' want the old values anyway + if ( isset($_GET['updated']) && $_GET['updated'] && get_transient('settings_errors') ) { + $settings_errors = get_transient('settings_errors'); + delete_transient('settings_errors'); + // Otherwise check global in case validation has been run on this pageload + } elseif ( count( $wp_settings_errors ) ) { + $settings_errors = $wp_settings_errors; + } else { + return; + } + + // Filter the results to those of a specific setting if one was set + if ( $setting ) { + foreach ( (array) $settings_errors as $key => $details ) + if ( $setting != $details['setting'] ) + unset( $settings_errors[$key] ); + } + return $settings_errors; +} + +/** + * Display settings errors registered by add_settings_error() + * + * Part of the Settings API. Outputs a

    for each error retrieved by 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 register_setting() + * + * The $sanitize option is passed into 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. + * + * @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. + * @param boolean $hide_on_update If set to true errors will not be shown if the settings page has already been submitted. + * @return + */ +function settings_errors ( $setting = '', $sanitize = FALSE, $hide_on_update = FALSE ) { + + if ($hide_on_update AND $_GET['updated']) return; + + $settings_errors = get_settings_errors( $setting, $sanitize ); + + if ( !is_array($settings_errors) ) return; + + $output = ''; + foreach ( $settings_errors as $key => $details ) { + $css_id = 'setting-error-' . $details['code']; + $css_class = $details['type'] . ' settings-error'; + $output .= "
    \n"; + $output .= "

    {$details['message']}

    "; + $output .= "
    \n"; + } + echo $output; +} + /** * {@internal Missing Short Description}} * @@ -3188,20 +3227,20 @@ function do_settings_fields($page, $section) { * * @param unknown_type $page */ -function manage_columns_prefs($page) { - $columns = get_column_headers($page); - - $hidden = get_hidden_columns($page); +function manage_columns_prefs( $page ) { + $columns = get_column_headers( $page ); + $hidden = get_hidden_columns( $page ); + $special = array('_title', 'cb', 'comment', 'media', 'name', 'title', 'username'); foreach ( $columns as $column => $title ) { - // Can't hide these - if ( 'cb' == $column || 'title' == $column || 'name' == $column || 'username' == $column || 'media' == $column || 'comment' == $column ) + // Can't hide these or they are special + if ( in_array( $column, $special ) ) continue; - if ( empty($title) ) + if ( empty( $title ) ) continue; if ( 'comments' == $column ) - $title = __('Comments'); + $title = __( 'Comments' ); $id = "$column-hide"; echo '
    @@ -3267,55 +3312,62 @@ function the_post_password() { * @since unknown */ function favorite_actions( $screen = null ) { - switch ( $screen ) { - case 'post-new.php': - $default_action = array('edit.php' => array(__('Edit Posts'), 'edit_posts')); - break; - case 'edit-pages.php': - $default_action = array('page-new.php' => array(__('New Page'), 'edit_pages')); - break; - case 'page-new.php': - $default_action = array('edit-pages.php' => array(__('Edit Pages'), 'edit_pages')); - break; - case 'upload.php': - $default_action = array('media-new.php' => array(__('New Media'), 'upload_files')); - break; - case 'media-new.php': - $default_action = array('upload.php' => array(__('Edit Media'), 'upload_files')); - break; - case 'link-manager.php': - $default_action = array('link-add.php' => array(__('New Link'), 'manage_links')); - break; - case 'link-add.php': - $default_action = array('link-manager.php' => array(__('Edit Links'), 'manage_links')); - break; - case 'users.php': - $default_action = array('user-new.php' => array(__('New User'), 'create_users')); - break; - case 'user-new.php': - $default_action = array('users.php' => array(__('Edit Users'), 'edit_users')); - break; - case 'plugins.php': - $default_action = array('plugin-install.php' => array(__('Install Plugins'), 'install_plugins')); - break; - case 'plugin-install.php': - $default_action = array('plugins.php' => array(__('Manage Plugins'), 'activate_plugins')); - break; - case 'themes.php': - $default_action = array('theme-install.php' => array(__('Install Themes'), 'install_themes')); - break; - case 'theme-install.php': - $default_action = array('themes.php' => array(__('Manage Themes'), 'switch_themes')); - break; - default: - $default_action = array('post-new.php' => array(__('New Post'), 'edit_posts')); - break; + $default_action = false; + + if ( is_string($screen) ) + $screen = convert_to_screen($screen); + + if ( isset($screen->post_type) ) { + $post_type_object = get_post_type_object($screen->post_type); + if ( 'add' != $screen->action ) + $default_action = array('post-new.php?post_type=' . $post_type_object->name => array($post_type_object->labels->new_item, $post_type_object->cap->edit_posts)); + else + $default_action = array('edit.php?post_type=' . $post_type_object->name => array($post_type_object->labels->name, $post_type_object->cap->edit_posts)); + } + + if ( !$default_action ) { + switch ( $screen->id ) { + case 'upload': + $default_action = array('media-new.php' => array(__('New Media'), 'upload_files')); + break; + case 'media': + $default_action = array('upload.php' => array(__('Edit Media'), 'upload_files')); + break; + case 'link-manager': + case 'link': + if ( 'add' != $screen->action ) + $default_action = array('link-add.php' => array(__('New Link'), 'manage_links')); + else + $default_action = array('link-manager.php' => array(__('Edit Links'), 'manage_links')); + break; + case 'users': + $default_action = array('user-new.php' => array(__('New User'), 'create_users')); + break; + case 'user': + $default_action = array('users.php' => array(__('Edit Users'), 'edit_users')); + break; + case 'plugins': + $default_action = array('plugin-install.php' => array(__('Install Plugins'), 'install_plugins')); + break; + case 'plugin-install': + $default_action = array('plugins.php' => array(__('Manage Plugins'), 'activate_plugins')); + break; + case 'themes': + $default_action = array('theme-install.php' => array(__('Install Themes'), 'install_themes')); + break; + case 'theme-install': + $default_action = array('themes.php' => array(__('Manage Themes'), 'switch_themes')); + break; + default: + $default_action = array('post-new.php' => array(__('New Post'), 'edit_posts')); + break; + } } $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'), + 'post-new.php?post_type=page' => array(__('New Page'), 'edit_pages'), 'media-new.php' => array(__('Upload'), 'upload_files'), 'edit-comments.php' => array(__('Comments'), 'moderate_comments') ); @@ -3362,8 +3414,7 @@ function favorite_actions( $screen = null ) { * @param int $id The post id. If not supplied the global $post is used. * */ -function _draft_or_post_title($post_id = 0) -{ +function _draft_or_post_title($post_id = 0) { $title = get_the_title($post_id); if ( empty($title) ) $title = __('(no title)'); @@ -3393,6 +3444,7 @@ function _admin_search_query() { * */ function iframe_header( $title = '', $limit_styles = false ) { +global $hook_suffix; ?> > @@ -3414,9 +3466,20 @@ function tb_close(){var win=window.dialogArguments||opener||parent||top;win.tb_r do_action('admin_print_styles'); do_action('admin_print_scripts'); do_action('admin_head'); + +$admin_body_class = preg_replace('/[^a-z0-9_-]+/i', '-', $hook_suffix); ?> -> + class="no-js "> + $screen, 'base' => $screen); + return $screen; +} + function screen_meta($screen) { - global $wp_meta_boxes, $_wp_contextual_help; + global $wp_meta_boxes, $_wp_contextual_help, $title; - $screen = str_replace('.php', '', $screen); - $screen = str_replace('-new', '', $screen); - $screen = str_replace('-add', '', $screen); - $screen = apply_filters('screen_meta_screen', $screen); + if ( is_string($screen) ) + $screen = convert_to_screen($screen); $column_screens = get_column_headers($screen); $meta_screens = array('index' => 'dashboard'); - if ( isset($meta_screens[$screen]) ) - $screen = $meta_screens[$screen]; + if ( isset($meta_screens[$screen->id]) ) { + $screen->id = $meta_screens[$screen->id]; + $screen->base = $screen->id; + } + $show_screen = false; - $show_on_screen = false; - if ( !empty($wp_meta_boxes[$screen]) || !empty($column_screens) ) { + if ( !empty($wp_meta_boxes[$screen->id]) || !empty($column_screens) ) $show_screen = true; - $show_on_screen = true; - } $screen_options = screen_options($screen); if ( $screen_options ) @@ -3499,109 +3575,68 @@ function screen_meta($screen) { if ( !isset($_wp_contextual_help) ) $_wp_contextual_help = array(); - $settings = ''; + $settings = apply_filters('screen_settings', '', $screen); - switch ( $screen ) { - case 'post': - if ( !isset($_wp_contextual_help['post']) ) { - $help = drag_drop_help(); - $help .= '

    ' . __('Writing Posts') . '

    '; - $_wp_contextual_help['post'] = $help; - } - break; - case 'page': - if ( !isset($_wp_contextual_help['page']) ) { - $help = drag_drop_help(); - $_wp_contextual_help['page'] = $help; - } - break; - case 'dashboard': - if ( !isset($_wp_contextual_help['dashboard']) ) { - $help = '

    ' . __('The modules on this screen can be arranged in several columns. You can select the number of columns from the Screen Options tab.') . "

    \n"; - $help .= drag_drop_help(); - $_wp_contextual_help['dashboard'] = $help; - } - break; - case 'link': - if ( !isset($_wp_contextual_help['link']) ) { - $help = drag_drop_help(); - $_wp_contextual_help['link'] = $help; - } - break; - case 'options-general': - if ( !isset($_wp_contextual_help['options-general']) ) - $_wp_contextual_help['options-general'] = __('General Settings'); - break; - case 'theme-install': - case 'plugin-install': - if ( ( !isset($_GET['tab']) || 'dashboard' == $_GET['tab'] ) && !isset($_wp_contextual_help[$screen]) ) { - $help = plugins_search_help(); - $_wp_contextual_help[$screen] = $help; - } - break; + switch ( $screen->id ) { case 'widgets': - if ( !isset($_wp_contextual_help['widgets']) ) { - $help = widgets_help(); - $_wp_contextual_help['widgets'] = $help; - } $settings = '

    ' . __('Enable accessibility mode') . '' . __('Disable accessibility mode') . "

    \n"; $show_screen = true; break; } + if( ! empty( $settings ) ) + $show_screen = true; ?>
    - + - @@ -3630,10 +3665,13 @@ function screen_meta($screen) { function add_contextual_help($screen, $help) { global $_wp_contextual_help; + if ( is_string($screen) ) + $screen = convert_to_screen($screen); + if ( !isset($_wp_contextual_help) ) $_wp_contextual_help = array(); - $_wp_contextual_help[$screen] = $help; + $_wp_contextual_help[$screen->id] = $help; } function drag_drop_help() { @@ -3653,28 +3691,27 @@ function plugins_search_help() { '; } -function widgets_help() { - return ' -

    ' . __('Widgets are added and arranged by simple drag ’n’ drop. If you hover your mouse over the titlebar of a widget, you’ll see a 4-arrow cursor which indicates that the widget is movable. Click on the titlebar, hold down the mouse button and drag the widget to a sidebar. As you drag, you’ll see a dotted box that also moves. This box shows where the widget will go once you drop it.') . '

    -

    ' . __('To remove a widget from a sidebar, drag it back to Available Widgets or click on the arrow on its titlebar to reveal its settings, and then click Remove.') . '

    -

    ' . __('To remove a widget from a sidebar and keep its configuration, drag it to Inactive Widgets.') . '

    -

    ' . __('The Inactive Widgets area stores widgets that are configured but not curently used. If you change themes and the new theme has fewer sidebars than the old, all extra widgets will be stored to Inactive Widgets automatically.') . '

    -'; -} - function screen_layout($screen) { global $screen_layout_columns; - $columns = array('dashboard' => 4, 'post' => 2, 'page' => 2, 'link' => 2); - $columns = apply_filters('screen_layout_columns', $columns, $screen); + if ( is_string($screen) ) + $screen = convert_to_screen($screen); + + $columns = array('dashboard' => 4, 'link' => 2); + + // Add custom post types + foreach ( get_post_types( array('show_ui' => true) ) as $post_type ) + $columns[$post_type] = 2; - if ( !isset($columns[$screen]) ) { + $columns = apply_filters('screen_layout_columns', $columns, $screen->id, $screen); + + if ( !isset($columns[$screen->id]) ) { $screen_layout_columns = 0; return ''; } - $screen_layout_columns = get_user_option("screen_layout_$screen"); - $num = $columns[$screen]; + $screen_layout_columns = get_user_option("screen_layout_$screen->id"); + $num = $columns[$screen->id]; if ( ! $screen_layout_columns ) $screen_layout_columns = 2; @@ -3690,66 +3727,91 @@ function screen_layout($screen) { } function screen_options($screen) { - switch ( $screen ) { + if ( is_string($screen) ) + $screen = convert_to_screen($screen); + + switch ( $screen->base ) { case 'edit': - $per_page_label = __('Posts per page:'); - break; case 'edit-pages': - $per_page_label = __('Pages per page:'); + $post_type = 'post'; + if ( isset($_GET['post_type']) && in_array( $_GET['post_type'], get_post_types( array('public' => true ) ) ) ) + $post_type = $_GET['post_type']; + $post_type_object = get_post_type_object($post_type); + $per_page_label = $post_type_object->labels->name; + break; + case 'ms-sites': + $per_page_label = _x( 'Sites', 'sites per page (screen options)' ); + break; + case 'ms-users': + $per_page_label = _x( 'Users', 'users per page (screen options)' ); break; case 'edit-comments': - $per_page_label = __('Comments per page:'); + $per_page_label = _x( 'Comments', 'comments per page (screen options)' ); break; case 'upload': - $per_page_label = __('Media items per page:'); - break; - case 'categories': - $per_page_label = __('Categories per page:'); + $per_page_label = _x( 'Media items', 'items per page (screen options)' ); break; case 'edit-tags': - $per_page_label = __('Tags per page:'); + global $tax; + $per_page_label = $tax->labels->name; break; case 'plugins': - $per_page_label = __('Plugins per page:'); + $per_page_label = _x( 'Plugins', 'plugins per page (screen options)' ); break; default: return ''; } - $option = str_replace( '-', '_', "${screen}_per_page" ); - $per_page = (int) get_user_option( $option, 0, false ); + $option = str_replace( '-', '_', "{$screen->id}_per_page" ); + if ( 'edit_tags_per_page' == $option ) { + if ( 'category' == $tax->name ) + $option = 'categories_per_page'; + elseif ( 'post_tag' != $tax->name ) + $option = 'edit_' . $tax->name . '_per_page'; + } + + $per_page = (int) get_user_option( $option ); if ( empty( $per_page ) || $per_page < 1 ) { - if ( 'plugins' == $screen ) + if ( 'plugins' == $screen->id ) $per_page = 999; else $per_page = 20; } + if ( 'edit_comments_per_page' == $option ) $per_page = apply_filters( 'comments_per_page', $per_page, isset($_REQUEST['comment_status']) ? $_REQUEST['comment_status'] : 'all' ); - elseif ( 'categories' == $option ) + elseif ( 'categories_per_page' == $option ) $per_page = apply_filters( 'edit_categories_per_page', $per_page ); else $per_page = apply_filters( $option, $per_page ); - $return = '
    ' . __('Options') . "
    \n"; - $return .= "
    \n"; + $return = "
    \n"; if ( !empty($per_page_label) ) - $return .= " \n"; + $return .= " \n"; $return .= ""; $return .= ""; $return .= "
    \n"; return $return; } -function screen_icon($name = '') { - global $parent_file, $hook_suffix; +function screen_icon($screen = '') { + global $current_screen; + + if ( empty($screen) ) + $screen = $current_screen; + elseif ( is_string($screen) ) + $name = $screen; if ( empty($name) ) { - if ( isset($parent_file) && !empty($parent_file) ) - $name = substr($parent_file, 0, -4); + if ( !empty($screen->parent_base) ) + $name = $screen->parent_base; else - $name = str_replace(array('.php', '-new', '-add'), '', $hook_suffix); + $name = $screen->base; + + if ( 'edit' == $name && isset($screen->post_type) && 'page' == $screen->post_type ) + $name = 'edit-pages'; } + ?>

    $current_screen, 'base' => $current_screen); + } else { + $id = sanitize_key($id); + if ( false !== strpos($id, '-') ) { + list( $id, $typenow ) = explode('-', $id, 2); + if ( taxonomy_exists( $typenow ) ) { + $id = 'edit-tags'; + $taxnow = $typenow; + $typenow = ''; + } + } + $current_screen = array('id' => $id, 'base' => $id); + } + + $current_screen = (object) $current_screen; + + $current_screen->action = $action; + + // Map index to dashboard + if ( 'index' == $current_screen->base ) + $current_screen->base = 'dashboard'; + if ( 'index' == $current_screen->id ) + $current_screen->id = 'dashboard'; + + if ( 'edit' == $current_screen->id ) { + if ( empty($typenow) ) + $typenow = 'post'; + $current_screen->id .= '-' . $typenow; + $current_screen->post_type = $typenow; + } elseif ( 'post' == $current_screen->id ) { + if ( empty($typenow) ) + $typenow = 'post'; + $current_screen->id = $typenow; + $current_screen->post_type = $typenow; + } elseif ( 'edit-tags' == $current_screen->id ) { + if ( empty($taxnow) ) + $taxnow = 'post_tag'; + $current_screen->id = 'edit-' . $taxnow; + $current_screen->taxonomy = $taxnow; + } + + $current_screen = apply_filters('current_screen', $current_screen); +} + ?>