PHP _get_custom_object_labels函数代码示例

/**
 * Builds an object with all post type labels out of a post type object
 *
 * Accepted keys of the label array in the post type object:
 * - name - general name for the post type, usually plural. The same and overriden by $post_type_object->label. Default is Posts/Pages
 * - singular_name - name for one object of this post type. Default is Post/Page
 * - add_new - Default is Add New for both hierarchical and non-hierarchical types. When internationalizing this string, please use a {@link http://codex.wordpress.org/I18n_for_WordPress_Developers#Disambiguation_by_context gettext context} matching your post type. Example: <code>_x('Add New', 'product');</code>
 * - add_new_item - Default is Add New Post/Add New Page
 * - edit_item - Default is Edit Post/Edit Page
 * - new_item - Default is New Post/New Page
 * - view_item - Default is View Post/View Page
 * - search_items - Default is Search Posts/Search Pages
 * - not_found - Default is No posts found/No pages found
 * - not_found_in_trash - Default is No posts found in Trash/No pages found in Trash
 * - parent_item_colon - This string isn't used on non-hierarchical types. In hierarchical ones the default is Parent Page:
 *
 * Above, the first default value is for non-hierarchical post types (like posts) and the second one is for hierarchical post types (like pages).
 *
 * @since 3.0.0
 * @param object $post_type_object
 * @return object object with all the labels as member variables
 */
function get_post_type_labels($post_type_object)
{
    $nohier_vs_hier_defaults = array('name' => array(_x('Posts', 'post type general name'), _x('Pages', 'post type general name')), 'singular_name' => array(_x('Post', 'post type singular name'), _x('Page', 'post type singular name')), 'add_new' => array(_x('Add New', 'post'), _x('Add New', 'page')), 'add_new_item' => array(__('Add New Post'), __('Add New Page')), 'edit_item' => array(__('Edit Post'), __('Edit Page')), 'new_item' => array(__('New Post'), __('New Page')), 'view_item' => array(__('View Post'), __('View Page')), 'search_items' => array(__('Search Posts'), __('Search Pages')), 'not_found' => array(__('No posts found.'), __('No pages found.')), 'not_found_in_trash' => array(__('No posts found in Trash.'), __('No pages found in Trash.')), 'parent_item_colon' => array(null, __('Parent Page:')));
    $nohier_vs_hier_defaults['menu_name'] = $nohier_vs_hier_defaults['name'];
    return _get_custom_object_labels($post_type_object, $nohier_vs_hier_defaults);
}

/**
 * Build an object with all post type labels out of a post type object
 *
 * Accepted keys of the label array in the post type object:
 *
 * - name - general name for the post type, usually plural. The same and overridden
 *          by $post_type_object->label. Default is Posts/Pages
 * - singular_name - name for one object of this post type. Default is Post/Page
 * - add_new - Default is Add New for both hierarchical and non-hierarchical types.
 *             When internationalizing this string, please use a gettext context
 *             {@link https://codex.wordpress.org/I18n_for_WordPress_Developers#Disambiguation_by_context}
 *             matching your post type. Example: `_x( 'Add New', 'product' );`.
 * - add_new_item - Default is Add New Post/Add New Page.
 * - edit_item - Default is Edit Post/Edit Page.
 * - new_item - Default is New Post/New Page.
 * - view_item - Default is View Post/View Page.
 * - search_items - Default is Search Posts/Search Pages.
 * - not_found - Default is No posts found/No pages found.
 * - not_found_in_trash - Default is No posts found in Trash/No pages found in Trash.
 * - parent_item_colon - This string isn't used on non-hierarchical types. In hierarchical
 *                       ones the default is 'Parent Page:'.
 * - all_items - String for the submenu. Default is All Posts/All Pages.
 * - archives - String for use with archives in nav menus. Default is Post Archives/Page Archives.
 * - insert_into_item - String for the media frame button. Default is Insert into post/Insert into page.
 * - uploaded_to_this_item - String for the media frame filter. Default is Uploaded to this post/Uploaded to this page.
 * - featured_image - Default is Featured Image.
 * - set_featured_image - Default is Set featured image.
 * - remove_featured_image - Default is Remove featured image.
 * - use_featured_image - Default is Use as featured image.
 * - menu_name - Default is the same as `name`.
 * - filter_items_list - String for the table views hidden heading.
 * - items_list_navigation - String for the table pagination hidden heading.
 * - items_list - String for the table hidden heading.
 *
 * Above, the first default value is for non-hierarchical post types (like posts)
 * and the second one is for hierarchical post types (like pages).
 *
 * @since 3.0.0
 * @since 4.3.0 Added the `featured_image`, `set_featured_image`, `remove_featured_image`,
 *              and `use_featured_image` labels.
 * @since 4.4.0 Added the `insert_into_item`, `uploaded_to_this_item`, `filter_items_list`,
 *              `items_list_navigation`, and `items_list` labels.
 *
 * @access private
 *
 * @param object $post_type_object Post type object.
 * @return object object with all the labels as member variables.
 */
function get_post_type_labels($post_type_object)
{
    $nohier_vs_hier_defaults = array('name' => array(_x('Posts', 'post type general name'), _x('Pages', 'post type general name')), 'singular_name' => array(_x('Post', 'post type singular name'), _x('Page', 'post type singular name')), 'add_new' => array(_x('Add New', 'post'), _x('Add New', 'page')), 'add_new_item' => array(__('Add New Post'), __('Add New Page')), 'edit_item' => array(__('Edit Post'), __('Edit Page')), 'new_item' => array(__('New Post'), __('New Page')), 'view_item' => array(__('View Post'), __('View Page')), 'search_items' => array(__('Search Posts'), __('Search Pages')), 'not_found' => array(__('No posts found.'), __('No pages found.')), 'not_found_in_trash' => array(__('No posts found in Trash.'), __('No pages found in Trash.')), 'parent_item_colon' => array(null, __('Parent Page:')), 'all_items' => array(__('All Posts'), __('All Pages')), 'archives' => array(__('Post Archives'), __('Page Archives')), 'insert_into_item' => array(__('Insert into post'), __('Insert into page')), 'uploaded_to_this_item' => array(__('Uploaded to this post'), __('Uploaded to this page')), 'featured_image' => array(__('Featured Image'), __('Featured Image')), 'set_featured_image' => array(__('Set featured image'), __('Set featured image')), 'remove_featured_image' => array(__('Remove featured image'), __('Remove featured image')), 'use_featured_image' => array(__('Use as featured image'), __('Use as featured image')), 'filter_items_list' => array(__('Filter posts list'), __('Filter pages list')), 'items_list_navigation' => array(__('Posts list navigation'), __('Pages list navigation')), 'items_list' => array(__('Posts list'), __('Pages list')));
    $nohier_vs_hier_defaults['menu_name'] = $nohier_vs_hier_defaults['name'];
    $labels = _get_custom_object_labels($post_type_object, $nohier_vs_hier_defaults);
    $post_type = $post_type_object->name;
    $default_labels = clone $labels;
    /**
     * Filter the labels of a specific post type.
     *
     * The dynamic portion of the hook name, `$post_type`, refers to
     * the post type slug.
     *
     * @since 3.5.0
     *
     * @see get_post_type_labels() for the full list of labels.
     *
     * @param object $labels Object with labels for the post type as member variables.
     */
    $labels = apply_filters("post_type_labels_{$post_type}", $labels);
    // Ensure that the filtered labels contain all required default values.
    $labels = (object) array_merge((array) $default_labels, (array) $labels);
    return $labels;
}

/**
 * Builds an object with all taxonomy labels out of a taxonomy object
 *
 * Accepted keys of the label array in the taxonomy object:
 *
 * - name - general name for the taxonomy, usually plural. The same as and overridden by $tax->label. Default is Tags/Categories
 * - singular_name - name for one object of this taxonomy. Default is Tag/Category
 * - search_items - Default is Search Tags/Search Categories
 * - popular_items - This string isn't used on hierarchical taxonomies. Default is Popular Tags
 * - all_items - Default is All Tags/All Categories
 * - parent_item - This string isn't used on non-hierarchical taxonomies. In hierarchical ones the default is Parent Category
 * - parent_item_colon - The same as `parent_item`, but with colon `:` in the end
 * - edit_item - Default is Edit Tag/Edit Category
 * - view_item - Default is View Tag/View Category
 * - update_item - Default is Update Tag/Update Category
 * - add_new_item - Default is Add New Tag/Add New Category
 * - new_item_name - Default is New Tag Name/New Category Name
 * - separate_items_with_commas - This string isn't used on hierarchical taxonomies. Default is "Separate tags with commas", used in the meta box.
 * - add_or_remove_items - This string isn't used on hierarchical taxonomies. Default is "Add or remove tags", used in the meta box when JavaScript is disabled.
 * - choose_from_most_used - This string isn't used on hierarchical taxonomies. Default is "Choose from the most used tags", used in the meta box.
 * - not_found - Default is "No tags found"/"No categories found", used in the meta box and taxonomy list table.
 * - no_terms - Default is "No tags"/"No categories", used in the posts and media list tables.
 * - pagination - String for the table pagination hidden heading.
 * - list - String for the table hidden heading.
 *
 * Above, the first default value is for non-hierarchical taxonomies (like tags) and the second one is for hierarchical taxonomies (like categories).
 *
 * @todo Better documentation for the labels array.
 *
 * @since 3.0.0
 * @since 4.3.0 Added the `no_terms` label.
 *
 * @param object $tax Taxonomy object.
 * @return object object with all the labels as member variables.
 */
function get_taxonomy_labels($tax)
{
    $tax->labels = (array) $tax->labels;
    if (isset($tax->helps) && empty($tax->labels['separate_items_with_commas'])) {
        $tax->labels['separate_items_with_commas'] = $tax->helps;
    }
    if (isset($tax->no_tagcloud) && empty($tax->labels['not_found'])) {
        $tax->labels['not_found'] = $tax->no_tagcloud;
    }
    $nohier_vs_hier_defaults = array('name' => array(_x('Tags', 'taxonomy general name'), _x('Categories', 'taxonomy general name')), 'singular_name' => array(_x('Tag', 'taxonomy singular name'), _x('Category', 'taxonomy singular name')), 'search_items' => array(__('Search Tags'), __('Search Categories')), 'popular_items' => array(__('Popular Tags'), null), 'all_items' => array(__('All Tags'), __('All Categories')), 'parent_item' => array(null, __('Parent Category')), 'parent_item_colon' => array(null, __('Parent Category:')), 'edit_item' => array(__('Edit Tag'), __('Edit Category')), 'view_item' => array(__('View Tag'), __('View Category')), 'update_item' => array(__('Update Tag'), __('Update Category')), 'add_new_item' => array(__('Add New Tag'), __('Add New Category')), 'new_item_name' => array(__('New Tag Name'), __('New Category Name')), 'separate_items_with_commas' => array(__('Separate tags with commas'), null), 'add_or_remove_items' => array(__('Add or remove tags'), null), 'choose_from_most_used' => array(__('Choose from the most used tags'), null), 'not_found' => array(__('No tags found.'), __('No categories found.')), 'no_terms' => array(__('No tags'), __('No categories')), 'pagination' => array(__('Tags list navigation'), __('Categories list navigation')), 'list' => array(__('Tags list'), __('Categories list')));
    $nohier_vs_hier_defaults['menu_name'] = $nohier_vs_hier_defaults['name'];
    return _get_custom_object_labels($tax, $nohier_vs_hier_defaults);
}

/**
 * Build an object with all post type labels out of a post type object
 *
 * Accepted keys of the label array in the post type object:
 *
 * - name - general name for the post type, usually plural. The same and overridden
 *          by $post_type_object->label. Default is Posts/Pages
 * - singular_name - name for one object of this post type. Default is Post/Page
 * - add_new - Default is Add New for both hierarchical and non-hierarchical types.
 *             When internationalizing this string, please use a gettext context
 *             {@link http://codex.wordpress.org/I18n_for_WordPress_Developers#Disambiguation_by_context}
 *             matching your post type. Example: `_x( 'Add New', 'product' );`.
 * - add_new_item - Default is Add New Post/Add New Page.
 * - edit_item - Default is Edit Post/Edit Page.
 * - new_item - Default is New Post/New Page.
 * - view_item - Default is View Post/View Page.
 * - search_items - Default is Search Posts/Search Pages.
 * - not_found - Default is No posts found/No pages found.
 * - not_found_in_trash - Default is No posts found in Trash/No pages found in Trash.
 * - parent_item_colon - This string isn't used on non-hierarchical types. In hierarchical
 *                       ones the default is 'Parent Page:'.
 * - all_items - String for the submenu. Default is All Posts/All Pages.
 * - menu_name - Default is the same as `name`.
 *
 * Above, the first default value is for non-hierarchical post types (like posts)
 * and the second one is for hierarchical post types (like pages).
 *
 * @since 3.0.0
 * @access private
 *
 * @param object $post_type_object Post type object.
 * @return object object with all the labels as member variables.
 */
function get_post_type_labels($post_type_object)
{
    $nohier_vs_hier_defaults = array('name' => array(_x('Posts', 'post type general name'), _x('Pages', 'post type general name')), 'singular_name' => array(_x('Post', 'post type singular name'), _x('Page', 'post type singular name')), 'add_new' => array(_x('Add New', 'post'), _x('Add New', 'page')), 'add_new_item' => array(__('Add New Post'), __('Add New Page')), 'edit_item' => array(__('Edit Post'), __('Edit Page')), 'new_item' => array(__('New Post'), __('New Page')), 'view_item' => array(__('View Post'), __('View Page')), 'search_items' => array(__('Search Posts'), __('Search Pages')), 'not_found' => array(__('No posts found.'), __('No pages found.')), 'not_found_in_trash' => array(__('No posts found in Trash.'), __('No pages found in Trash.')), 'parent_item_colon' => array(null, __('Parent Page:')), 'all_items' => array(__('All Posts'), __('All Pages')));
    $nohier_vs_hier_defaults['menu_name'] = $nohier_vs_hier_defaults['name'];
    $labels = _get_custom_object_labels($post_type_object, $nohier_vs_hier_defaults);
    $post_type = $post_type_object->name;
    /**
     * Filter the labels of a specific post type.
     *
     * The dynamic portion of the hook name, `$post_type`, refers to
     * the post type slug.
     *
     * @since 3.5.0
     *
     * @see get_post_type_labels() for the full list of labels.
     *
     * @param array $labels Array of labels for the given post type.
     */
    return apply_filters("post_type_labels_{$post_type}", $labels);
}

/**
 * Builds an object with all taxonomy labels out of a taxonomy object
 *
 * Accepted keys of the label array in the taxonomy object:
 *
 * - name - general name for the taxonomy, usually plural. The same as and overridden by $tax->label. Default is Tags/Categories
 * - singular_name - name for one object of this taxonomy. Default is Tag/Category
 * - search_items - Default is Search Tags/Search Categories
 * - popular_items - This string isn't used on hierarchical taxonomies. Default is Popular Tags
 * - all_items - Default is All Tags/All Categories
 * - parent_item - This string isn't used on non-hierarchical taxonomies. In hierarchical ones the default is Parent Category
 * - parent_item_colon - The same as `parent_item`, but with colon `:` in the end
 * - edit_item - Default is Edit Tag/Edit Category
 * - view_item - Default is View Tag/View Category
 * - update_item - Default is Update Tag/Update Category
 * - add_new_item - Default is Add New Tag/Add New Category
 * - new_item_name - Default is New Tag Name/New Category Name
 * - separate_items_with_commas - This string isn't used on hierarchical taxonomies. Default is "Separate tags with commas", used in the meta box.
 * - add_or_remove_items - This string isn't used on hierarchical taxonomies. Default is "Add or remove tags", used in the meta box when JavaScript is disabled.
 * - choose_from_most_used - This string isn't used on hierarchical taxonomies. Default is "Choose from the most used tags", used in the meta box.
 * - not_found - Default is "No tags found"/"No categories found", used in the meta box and taxonomy list table.
 * - no_terms - Default is "No tags"/"No categories", used in the posts and media list tables.
 * - items_list_navigation - String for the table pagination hidden heading.
 * - items_list - String for the table hidden heading.
 *
 * Above, the first default value is for non-hierarchical taxonomies (like tags) and the second one is for hierarchical taxonomies (like categories).
 *
 * @todo Better documentation for the labels array.
 *
 * @since 3.0.0
 * @since 4.3.0 Added the `no_terms` label.
 * @since 4.4.0 Added the `items_list_navigation` and `items_list` labels.
 *
 * @param object $tax Taxonomy object.
 * @return object object with all the labels as member variables.
 */
function get_taxonomy_labels($tax)
{
    $tax->labels = (array) $tax->labels;
    if (isset($tax->helps) && empty($tax->labels['separate_items_with_commas'])) {
        $tax->labels['separate_items_with_commas'] = $tax->helps;
    }
    if (isset($tax->no_tagcloud) && empty($tax->labels['not_found'])) {
        $tax->labels['not_found'] = $tax->no_tagcloud;
    }
    $nohier_vs_hier_defaults = array('name' => array(_x('Tags', 'taxonomy general name'), _x('Categories', 'taxonomy general name')), 'singular_name' => array(_x('Tag', 'taxonomy singular name'), _x('Category', 'taxonomy singular name')), 'search_items' => array(__('Search Tags'), __('Search Categories')), 'popular_items' => array(__('Popular Tags'), null), 'all_items' => array(__('All Tags'), __('All Categories')), 'parent_item' => array(null, __('Parent Category')), 'parent_item_colon' => array(null, __('Parent Category:')), 'edit_item' => array(__('Edit Tag'), __('Edit Category')), 'view_item' => array(__('View Tag'), __('View Category')), 'update_item' => array(__('Update Tag'), __('Update Category')), 'add_new_item' => array(__('Add New Tag'), __('Add New Category')), 'new_item_name' => array(__('New Tag Name'), __('New Category Name')), 'separate_items_with_commas' => array(__('Separate tags with commas'), null), 'add_or_remove_items' => array(__('Add or remove tags'), null), 'choose_from_most_used' => array(__('Choose from the most used tags'), null), 'not_found' => array(__('No tags found.'), __('No categories found.')), 'no_terms' => array(__('No tags'), __('No categories')), 'items_list_navigation' => array(__('Tags list navigation'), __('Categories list navigation')), 'items_list' => array(__('Tags list'), __('Categories list')));
    $nohier_vs_hier_defaults['menu_name'] = $nohier_vs_hier_defaults['name'];
    $labels = _get_custom_object_labels($tax, $nohier_vs_hier_defaults);
    $taxonomy = $tax->name;
    $default_labels = clone $labels;
    /**
     * Filter the labels of a specific taxonomy.
     *
     * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
     *
     * @since 4.4.0
     *
     * @see get_taxonomy_labels() for the full list of taxonomy labels.
     *
     * @param object $labels Object with labels for the taxonomy as member variables.
     */
    $labels = apply_filters("taxonomy_labels_{$taxonomy}", $labels);
    // Ensure that the filtered labels contain all required default values.
    $labels = (object) array_merge((array) $default_labels, (array) $labels);
    return $labels;
}

/**
 * Builds an object with all taxonomy labels out of a taxonomy object
 *
 * Accepted keys of the label array in the taxonomy object:
 * - name - general name for the taxonomy, usually plural. The same as and overriden by $tax->label. Default is Post Tags/Categories
 * - singular_name - name for one object of this taxonomy. Default is Post Tag/Category
 * - search_items - Default is Search Tags/Search Categories
 * - popular_items - This string isn't used on hierarchical taxonomies. Default is Popular Tags
 * - all_items - Default is All Tags/All Categories
 * - parent_item - This string isn't used on non-hierarchical taxonomies. In hierarchical ones the default is Parent Category
 * - parent_item_colon - The same as <code>parent_item</code>, but with colon <code>:</code> in the end
 * - edit_item - Default is Edit Tag/Edit Category
 * - update_item - Default is Update Tag/Update Category
 * - add_new_item - Default is Add New Tag/Add New Category
 * - new_item_name - Default is New Tag Name/New Category Name
 * - separate_items_with_commas - This string isn't used on hierarchical taxonomies. Default is "Separate tags with commas," used in the meta box.
 * - add_or_remove_items - This string isn't used on hierarchical taxonomies. Default is "Add or remove tags," used in the meta box when JavaScript is disabled.
 * - choose_from_most_used - This string isn't used on hierarchical taxonomies. Default is "Choose from the most used tags," used in the meta box.
 *
 * Above, the first default value is for non-hierarchical taxonomies (like tags) and the second one is for hierarchical taxonomies (like categories.)
 *
 * @since 3.0.0
 * @param object $tax Taxonomy object
 * @return object object with all the labels as member variables
 */
function get_taxonomy_labels($tax)
{
    if (isset($tax->helps) && empty($tax->labels['separate_items_with_commas'])) {
        $tax->labels['separate_items_with_commas'] = $tax->helps;
    }
    $nohier_vs_hier_defaults = array('name' => array(_x('Post Tags', 'taxonomy general name'), _x('Categories', 'taxonomy general name')), 'singular_name' => array(_x('Post Tag', 'taxonomy singular name'), _x('Category', 'taxonomy singular name')), 'search_items' => array(__('Search Tags'), __('Search Categories')), 'popular_items' => array(__('Popular Tags'), null), 'all_items' => array(__('All Tags'), __('All Categories')), 'parent_item' => array(null, __('Parent Category')), 'parent_item_colon' => array(null, __('Parent Category:')), 'edit_item' => array(__('Edit Tag'), __('Edit Category')), 'update_item' => array(__('Update Tag'), __('Update Category')), 'add_new_item' => array(__('Add New Tag'), __('Add New Category')), 'new_item_name' => array(__('New Tag Name'), __('New Category Name')), 'separate_items_with_commas' => array(__('Separate tags with commas'), null), 'add_or_remove_items' => array(__('Add or remove tags'), null), 'choose_from_most_used' => array(__('Choose from the most used tags'), null));
    return _get_custom_object_labels($tax, $nohier_vs_hier_defaults);
}