diff --git a/wp-admin/includes/admin.php b/wp-admin/includes/admin.php index a44abba917..eb2c161a78 100644 --- a/wp-admin/includes/admin.php +++ b/wp-admin/includes/admin.php @@ -58,6 +58,8 @@ require_once(ABSPATH . 'wp-admin/includes/taxonomy.php'); /** WordPress Template Administration API */ require_once(ABSPATH . 'wp-admin/includes/template.php'); +require_once(ABSPATH . 'wp-admin/includes/class-walker-category-checklist.php'); +require_once(ABSPATH . 'wp-admin/includes/class-wp-internal-pointers.php'); /** WordPress List Table Administration API and base class */ require_once(ABSPATH . 'wp-admin/includes/class-wp-list-table.php'); diff --git a/wp-admin/includes/template-functions.php b/wp-admin/includes/template-functions.php deleted file mode 100644 index f85e87a8bf..0000000000 --- a/wp-admin/includes/template-functions.php +++ /dev/null @@ -1,2074 +0,0 @@ - '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 ); - - $r = wp_parse_args( $params, $defaults ); - - if ( empty( $r['walker'] ) || ! ( $r['walker'] instanceof Walker ) ) { - $walker = new Walker_Category_Checklist; - } else { - $walker = $r['walker']; - } - - $taxonomy = $r['taxonomy']; - $descendants_and_self = (int) $r['descendants_and_self']; - - $args = array( 'taxonomy' => $taxonomy ); - - $tax = get_taxonomy( $taxonomy ); - $args['disabled'] = ! current_user_can( $tax->cap->assign_terms ); - - $args['list_only'] = ! empty( $r['list_only'] ); - - 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 { - $args['selected_cats'] = array(); - } - 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 - ) ); - } - 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' ) ); - } - - $output = ''; - - 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 ); - - 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; -} - -/** - * 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 2.5.0 - * - * @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 wp_popular_terms_checklist( $taxonomy, $default = 0, $number = 10, $echo = true ) { - $post = get_post(); - - if ( $post && $post->ID ) - $checked_terms = wp_get_object_terms($post->ID, $taxonomy, array('fields'=>'ids')); - else - $checked_terms = array(); - - $terms = get_terms( $taxonomy, array( 'orderby' => 'count', 'order' => 'DESC', 'number' => $number, 'hierarchical' => false ) ); - - $tax = get_taxonomy($taxonomy); - - $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"' : ''; - ?> - - - - '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 '"; - } -} - -/** - * Adds hidden fields with the data for use in the inline editor for posts and pages. - * - * @since 2.7.0 - * - * @param WP_Post $post Post object. - */ -function get_inline_data($post) { - $post_type_object = get_post_type_object($post->post_type); - if ( ! current_user_can( 'edit_post', $post->ID ) ) - return; - - $title = esc_textarea( trim( $post->post_title ) ); - - /** This filter is documented in wp-admin/edit-tag-form.php */ - echo ' -'; -} - -/** - * Outputs the in-line comment reply-to form in the Comments list table. - * - * @since 2.7.0 - * - * @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; - } - - 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'); - } - } - -?> -
- -
- - - -
- - - - - - - ' . _x( 'Name', 'meta name' ) . ' - ' . __( 'Value' ) . ' - - - - - -'; //TBODY needed for list-manipulation JS - return; - } - $count = 0; -?> - - - - - - - - - - -
- - $entry['meta_id'] = (int) $entry['meta_id']; - - $delete_nonce = wp_create_nonce( 'delete-meta_' . $entry['meta_id'] ); - - $r .= "\n\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\n\t"; - return $r; -} - -/** - * Prints the form in the Custom Fields meta box. - * - * @since 1.2.0 - * - * @global wpdb $wpdb WordPress database abstraction object. - * - * @param WP_Post $post Optional. The post being edited. - */ -function meta_form( $post = null ) { - global $wpdb; - $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. - */ - $keys = apply_filters( 'postmeta_form_keys', null ); - - 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'; - } -?> -

- - - - - - - - - - - - - - - - -
- - - - - - - - - -
-
- 'newmeta-submit', 'data-wp-lists' => 'add:the-list:newmeta' ) ); ?> -
- -
-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 '
'; - - $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 ); - $cur_aa = gmdate( 'Y', $time_adj ); - $cur_hh = gmdate( 'H', $time_adj ); - $cur_mn = gmdate( 'i', $time_adj ); - - $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 '
'; - - if ( $multi ) return; - - echo "\n\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"; - } -?> - -

- - -

-$template"; - } -} - -/** - * Print out option HTML elements for the page parents drop-down. - * - * @since 1.5.0 - * @since 4.4.0 `$post` argument was added. - * - * @global wpdb $wpdb WordPress database abstraction object. - * - * @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, $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 ( $post && $post->ID && $item->ID == $post->ID ) - continue; - - $pad = str_repeat( ' ', $level * 3 ); - $selected = selected( $default, $item->ID, false ); - - echo "\n\t"; - parent_dropdown( $default, $item->ID, $level +1 ); - } - } else { - return false; - } -} - -/** - * Print out option html elements for role selectors. - * - * @since 2.1.0 - * - * @param string $selected Slug for the role that should be already selected. - */ -function wp_dropdown_roles( $selected = '' ) { - $p = ''; - $r = ''; - - $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"; - else - $r .= "\n\t"; - } - echo $p . $r; -} - -/** - * Outputs the form used by the importers to accept the data to be imported - * - * @since 2.0.0 - * - * @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 = size_format( $bytes ); - $upload_dir = wp_upload_dir(); - if ( ! empty( $upload_dir['error'] ) ) : - ?>

-

-
-

- () - - - -

- -
-id ) ) { - return; - } - - $page = $screen->id; - - if ( !isset($wp_meta_boxes) ) - $wp_meta_boxes = array(); - if ( !isset($wp_meta_boxes[$page]) ) - $wp_meta_boxes[$page] = array(); - if ( !isset($wp_meta_boxes[$page][$context]) ) - $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; - - // 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 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 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]); - } - } - - if ( empty($priority) ) - $priority = 'low'; - - 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, 'args' => $callback_args); -} - -/** - * Meta-Box template function - * - * @since 2.5.0 - * - * @global array $wp_meta_boxes - * - * @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( $screen, $context, $object ) { - global $wp_meta_boxes; - static $already_sorted = false; - - if ( empty( $screen ) ) - $screen = get_current_screen(); - elseif ( is_string( $screen ) ) - $screen = convert_to_screen( $screen ); - - $page = $screen->id; - - $hidden = get_hidden_meta_boxes( $screen ); - - 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; - - $i = 0; - - 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++; - $hidden_class = in_array($box['id'], $hidden) ? ' hide-if-js' : ''; - echo '
' . "\n"; - if ( 'dashboard_browser_nag' != $box['id'] ) { - echo ''; - } - echo "

{$box['title']}

\n"; - echo '
' . "\n"; - call_user_func($box['callback'], $object, $box); - echo "
\n"; - echo "
\n"; - } - } - } - } - - echo "
"; - - return $i; - -} - -/** - * Removes a meta box from one or more screens. - * - * @since 2.6.0 - * @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]) ) - $wp_meta_boxes[$page] = array(); - if ( !isset($wp_meta_boxes[$page][$context]) ) - $wp_meta_boxes[$page][$context] = array(); - - foreach ( array('high', 'core', 'default', 'low') as $priority ) - $wp_meta_boxes[$page][$context][$priority][$id] = false; -} - -/** - * 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 - * - * @uses global $wp_meta_boxes Used to retrieve registered meta boxes. - * - * @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 do_accordion_sections( $screen, $context, $object ) { - global $wp_meta_boxes; - - wp_enqueue_script( 'accordion' ); - - if ( empty( $screen ) ) - $screen = get_current_screen(); - elseif ( is_string( $screen ) ) - $screen = convert_to_screen( $screen ); - - $page = $screen->id; - - $hidden = get_hidden_meta_boxes( $screen ); - ?> -
- -
- $id, 'title' => $title, 'callback' => $callback); -} - -/** - * 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 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 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 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 `