true, ] ); $public = get_taxonomies( [ '_builtin' => false, 'public' => true, ] ); $private = get_taxonomies( [ '_builtin' => false, 'public' => false, ] ); $registered_taxonomies = array_merge( $core, $public, $private ); wp_localize_script( 'cptui', 'cptui_tax_data', [ 'confirm' => esc_html__( 'Are you sure you want to delete this? Deleting will NOT remove created content.', 'custom-post-type-ui' ), 'no_associated_type' => esc_html__( 'Please select a post type to associate with.', 'custom-post-type-ui' ), 'existing_taxonomies' => $registered_taxonomies, ] ); } add_action( 'admin_enqueue_scripts', 'cptui_taxonomies_enqueue_scripts' ); /** * Register our tabs for the Taxonomy screen. * * @since 1.3.0 * * @internal * * @param array $tabs Array of tabs to display. Optional. * @param string $current_page Current page being shown. Optional. Default empty string. * @return array Amended array of tabs to show. */ function cptui_taxonomy_tabs( $tabs = [], $current_page = '' ) { if ( 'taxonomies' === $current_page ) { $taxonomies = cptui_get_taxonomy_data(); $classes = [ 'nav-tab' ]; $tabs['page_title'] = get_admin_page_title(); $tabs['tabs'] = []; $tabs['tabs']['add'] = [ // Start out with our basic "Add new" tab. 'text' => esc_html__( 'Add New Taxonomy', 'custom-post-type-ui' ), 'classes' => $classes, 'url' => cptui_admin_url( 'admin.php?page=cptui_manage_' . $current_page ), 'aria-selected' => 'false', ]; $action = cptui_get_current_action(); if ( empty( $action ) ) { $tabs['tabs']['add']['classes'][] = 'nav-tab-active'; $tabs['tabs']['add']['aria-selected'] = 'true'; } if ( ! empty( $taxonomies ) ) { if ( ! empty( $action ) ) { $classes[] = 'nav-tab-active'; } $tabs['tabs']['edit'] = [ 'text' => esc_html__( 'Edit Taxonomies', 'custom-post-type-ui' ), 'classes' => $classes, 'url' => esc_url( add_query_arg( [ 'action' => 'edit' ], cptui_admin_url( 'admin.php?page=cptui_manage_' . $current_page ) ) ), 'aria-selected' => ! empty( $action ) ? 'true' : 'false', ]; $tabs['tabs']['view'] = [ 'text' => esc_html__( 'View Taxonomies', 'custom-post-type-ui' ), 'classes' => [ 'nav-tab' ], // Prevent notices. 'url' => esc_url( cptui_admin_url( 'admin.php?page=cptui_listings#taxonomies' ) ), 'aria-selected' => 'false', ]; $tabs['tabs']['export'] = [ 'text' => esc_html__( 'Import/Export Taxonomies', 'custom-post-type-ui' ), 'classes' => [ 'nav-tab' ], // Prevent notices. 'url' => esc_url( cptui_admin_url( 'admin.php?page=cptui_tools&action=taxonomies' ) ), 'aria-selected' => 'false', ]; } } return $tabs; } add_filter( 'cptui_get_tabs', 'cptui_taxonomy_tabs', 10, 2 ); /** * Create our settings page output. * * @since 1.0.0 * * @internal */ function cptui_manage_taxonomies() { $tab = ( ! empty( $_GET ) && ! empty( $_GET['action'] ) && 'edit' == $_GET['action'] ) ? 'edit' : 'new'; // phpcs:ignore. $tab_class = 'cptui-' . $tab; $current = null; ?>

get_tr_start() . $ui->get_th_start(); // phpcs:ignore. echo $ui->get_label( 'name', esc_html__( 'Taxonomy Slug', 'custom-post-type-ui' ) ) . $ui->get_required_span(); // phpcs:ignore. if ( 'edit' === $tab ) { echo '

' . esc_html__( 'Slug has changed', 'custom-post-type-ui' ) . '

'; } echo '

' . esc_html__( 'Slug already exists', 'custom-post-type-ui' ) . '

'; echo $ui->get_th_end() . $ui->get_td_start(); // phpcs:ignore. echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'name', 'textvalue' => isset( $current['name'] ) ? esc_attr( $current['name'] ) : '', // phpcs:ignore. 'maxlength' => '32', 'helptext' => esc_attr__( 'The taxonomy name/slug. Used for various queries for taxonomy content.', 'custom-post-type-ui' ), 'required' => true, 'placeholder' => false, 'wrap' => false, ] ); echo '

'; esc_html_e( 'Slugs may only contain lowercase alphanumeric characters, dashes, and underscores.', 'custom-post-type-ui' ); echo '

'; if ( 'edit' === $tab ) { echo '

'; esc_html_e( 'DO NOT EDIT the taxonomy slug unless also planning to migrate terms. Changing the slug registers a new taxonomy entry.', 'custom-post-type-ui' ); echo '

'; echo '
'; echo $ui->get_check_input( // phpcs:ignore. [ 'checkvalue' => 'update_taxonomy', 'checked' => 'false', 'name' => 'update_taxonomy', 'namearray' => 'update_taxonomy', 'labeltext' => esc_html__( 'Migrate terms to newly renamed taxonomy?', 'custom-post-type-ui' ), 'helptext' => '', 'default' => false, 'wrap' => false, ] ); echo '
'; } echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'label', 'textvalue' => isset( $current['label'] ) ? esc_attr( $current['label'] ) : '', // phpcs:ignore. 'aftertext' => esc_html__( '(e.g. Actors)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Plural Label', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Used for the taxonomy admin menu item.', 'custom-post-type-ui' ), 'required' => true, ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'singular_label', 'textvalue' => isset( $current['singular_label'] ) ? esc_attr( $current['singular_label'] ) : '', // phpcs:ignore. 'aftertext' => esc_html__( '(e.g. Actor)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Singular Label', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Used when a singular label is needed.', 'custom-post-type-ui' ), 'required' => true, ] ); echo $ui->get_td_end() . $ui->get_tr_end(); // phpcs:ignore. $link_text = ( 'new' === $tab ) ? esc_html__( 'Populate additional labels based on chosen labels', 'custom-post-type-ui' ) : esc_html__( 'Populate missing labels based on chosen labels', 'custom-post-type-ui' ); echo $ui->get_tr_start( [ 'id' => 'autolabels', 'style' => 'display:none;' ] ); // phpcs:ignore. echo $ui->get_th_start() . esc_html__( 'Auto-populate labels', 'custom-post-type-ui' ) . $ui->get_th_end(); // phpcs:ignore. echo $ui->get_td_start(); // phpcs:ignore. ?> | get_td_end() . $ui->get_tr_end(); // phpcs:ignore. echo $ui->get_tr_start() . $ui->get_th_start() . esc_html__( 'Attach to Post Type', 'custom-post-type-ui' ) . $ui->get_required_span(); // phpcs:ignore. echo $ui->get_p( esc_html__( 'Add support for available registered post types. At least one is required. Only public post types listed by default.', 'custom-post-type-ui' ) ); // phpcs:ignore. echo $ui->get_th_end() . $ui->get_td_start() . $ui->get_fieldset_start(); // phpcs:ignore. echo $ui->get_legend_start() . esc_html__( 'Post type options', 'custom-post-type-ui' ) . $ui->get_legend_end(); // phpcs:ignore. /** * Filters the arguments for post types to list for taxonomy association. * * @since 1.0.0 * * @param array $value Array of default arguments. */ $args = apply_filters( 'cptui_attach_post_types_to_taxonomy', [ 'public' => true ] ); // If they don't return an array, fall back to the original default. Don't need to check for empty, because empty array is default for $args param in get_post_types anyway. if ( ! is_array( $args ) ) { $args = [ 'public' => true ]; } $output = 'objects'; // Or objects. /** * Filters the results returned to display for available post types for taxonomy. * * @since 1.3.0 * * @param array $value Array of post type objects. * @param array $args Array of arguments for the post type query. * @param string $output The output type we want for the results. */ $post_types = apply_filters( 'cptui_get_post_types_for_taxonomies', get_post_types( $args, $output ), $args, $output ); foreach ( $post_types as $post_type ) { $core_label = in_array( $post_type->name, [ 'post', 'page', 'attachment', ], true ) ? esc_html__( '(WP Core)', 'custom-post-type-ui' ) : ''; echo $ui->get_check_input( // phpcs:ignore. [ 'checkvalue' => $post_type->name, 'checked' => ( ! empty( $current['object_types'] ) && is_array( $current['object_types'] ) && in_array( $post_type->name, $current['object_types'], true ) ) ? 'true' : 'false', // phpcs:ignore. 'name' => esc_attr( $post_type->name ), 'namearray' => 'cpt_post_types', 'textvalue' => esc_attr( $post_type->name ), 'labeltext' => "{$post_type->label} {$core_label}", // phpcs:ignore. 'wrap' => false, ] ); } echo $ui->get_fieldset_end() . $ui->get_td_end() . $ui->get_tr_end(); // phpcs:ignore. ?>

get_textarea_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'description', 'rows' => '4', 'cols' => '40', 'textvalue' => isset( $current['description'] ) ? esc_textarea( $current['description'] ) : '', // phpcs:ignore. 'labeltext' => esc_html__( 'Description', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Describe what your taxonomy is used for.', 'custom-post-type-ui' ), ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'menu_name', 'textvalue' => isset( $current['labels']['menu_name'] ) ? esc_attr( $current['labels']['menu_name'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. Actors)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Menu Name', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Custom admin menu name for your taxonomy.', 'custom-post-type-ui' ), 'data' => [ 'label' => 'item', // Not localizing because it's isolated. 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'all_items', 'textvalue' => isset( $current['labels']['all_items'] ) ? esc_attr( $current['labels']['all_items'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. All Actors)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'All Items', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Used as tab text when showing all terms for hierarchical taxonomy while editing post.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'All %s', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'edit_item', 'textvalue' => isset( $current['labels']['edit_item'] ) ? esc_attr( $current['labels']['edit_item'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. Edit Actor)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Edit Item', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Used at the top of the term editor screen for an existing taxonomy term.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Edit %s', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'singular', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'view_item', 'textvalue' => isset( $current['labels']['view_item'] ) ? esc_attr( $current['labels']['view_item'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. View Actor)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'View Item', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Used in the admin bar when viewing editor screen for an existing taxonomy term.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'View %s', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'singular', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'update_item', 'textvalue' => isset( $current['labels']['update_item'] ) ? esc_attr( $current['labels']['update_item'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. Update Actor Name)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Update Item Name', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Update %s name', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'singular', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'add_new_item', 'textvalue' => isset( $current['labels']['add_new_item'] ) ? esc_attr( $current['labels']['add_new_item'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. Add New Actor)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Add New Item', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Used at the top of the term editor screen and button text for a new taxonomy term.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Add new %s', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'singular', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'new_item_name', 'textvalue' => isset( $current['labels']['new_item_name'] ) ? esc_attr( $current['labels']['new_item_name'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. New Actor Name)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'New Item Name', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'New %s name', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'singular', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'parent_item', 'textvalue' => isset( $current['labels']['parent_item'] ) ? esc_attr( $current['labels']['parent_item'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. Parent Actor)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Parent Item', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Parent %s', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'singular', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'parent_item_colon', 'textvalue' => isset( $current['labels']['parent_item_colon'] ) ? esc_attr( $current['labels']['parent_item_colon'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. Parent Actor:)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Parent Item Colon', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Parent %s:', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'singular', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'search_items', 'textvalue' => isset( $current['labels']['search_items'] ) ? esc_attr( $current['labels']['search_items'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. Search Actors)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Search Items', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Search %s', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'popular_items', 'textvalue' => isset( $current['labels']['popular_items'] ) ? esc_attr( $current['labels']['popular_items'] ) : null, // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. Popular Actors)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Popular Items', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Popular %s', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'separate_items_with_commas', 'textvalue' => isset( $current['labels']['separate_items_with_commas'] ) ? esc_attr( $current['labels']['separate_items_with_commas'] ) : null, // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. Separate Actors with commas)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Separate Items with Commas', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Separate %s with commas', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'add_or_remove_items', 'textvalue' => isset( $current['labels']['add_or_remove_items'] ) ? esc_attr( $current['labels']['add_or_remove_items'] ) : null, // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. Add or remove Actors)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Add or Remove Items', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Add or remove %s', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'choose_from_most_used', 'textvalue' => isset( $current['labels']['choose_from_most_used'] ) ? esc_attr( $current['labels']['choose_from_most_used'] ) : null, // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. Choose from the most used Actors)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Choose From Most Used', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'The text displayed via clicking ‘Choose from the most used items’ in the taxonomy meta box when no items are available.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Choose from the most used %s', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'not_found', 'textvalue' => isset( $current['labels']['not_found'] ) ? esc_attr( $current['labels']['not_found'] ) : null, // phpcs:ignore. 'aftertext' => esc_attr__( '(e.g. No Actors found)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Not found', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Used when indicating that there are no terms in the given taxonomy within the meta box and taxonomy list table.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'No %s found', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'no_terms', 'textvalue' => isset( $current['labels']['no_terms'] ) ? esc_attr( $current['labels']['no_terms'] ) : null, // phpcs:ignore. 'aftertext' => esc_html__( '(e.g. No actors)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'No terms', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Used when indicating that there are no terms in the given taxonomy associated with an object.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'No %s', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'items_list_navigation', 'textvalue' => isset( $current['labels']['items_list_navigation'] ) ? esc_attr( $current['labels']['items_list_navigation'] ) : null, // phpcs:ignore. 'aftertext' => esc_html__( '(e.g. Actors list navigation)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Items List Navigation', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Screen reader text for the pagination heading on the term listing screen.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( '%s list navigation', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'items_list', 'textvalue' => isset( $current['labels']['items_list'] ) ? esc_attr( $current['labels']['items_list'] ) : null, // phpcs:ignore. 'aftertext' => esc_html__( '(e.g. Actors list)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Items List', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Screen reader text for the items list heading on the term listing screen.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( '%s list', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'back_to_items', 'textvalue' => isset( $current['labels']['back_to_items'] ) ? esc_attr( $current['labels']['back_to_items'] ) : null, // phpcs:ignore. 'aftertext' => esc_html__( '(e.g. ← Back to actors', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Back to Items', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'The text displayed after a term has been updated for a link back to main index.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Back to %s', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'name_field_description', 'textvalue' => isset( $current['labels']['name_field_description'] ) ? esc_attr( $current['labels']['name_field_description'] ) : null, // phpcs:ignore. 'aftertext' => esc_html__( '(e.g. "The name is how it appears on your site."', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Term Name Field Description', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Description for the Name field on Edit Tags screen.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'The name is how it appears on your site.', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'singular', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'parent_field_description', 'textvalue' => isset( $current['labels']['parent_field_description'] ) ? esc_attr( $current['labels']['parent_field_description'] ) : null, // phpcs:ignore. 'aftertext' => esc_html__( '(e.g. "Assign a parent term to create a hierarchy. The term Jazz, for example, would be the parent of Bebop and Big Band."', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Term Parent Field Description', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Description for the Parent field on Edit Tags screen.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'Assign a parent term to create a hierarchy. The term Jazz, for example, would be the parent of Bebop and Big Band.', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'singular', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'slug_field_description', 'textvalue' => isset( $current['labels']['slug_field_description'] ) ? esc_attr( $current['labels']['slug_field_description'] ) : null, // phpcs:ignore. 'aftertext' => esc_html__( '(e.g. "The « slug » is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens."', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Term Slug Field Description', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Description for the Slug field on Edit Tags screen. ', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'The "slug" is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'singular', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'desc_field_description', 'textvalue' => isset( $current['labels']['desc_field_description'] ) ? esc_attr( $current['labels']['desc_field_description'] ) : null, // phpcs:ignore. 'aftertext' => esc_html__( '(e.g. "The description is not prominent by default; however, some themes may show it."', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Term Description Field Description', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Description for the Description field on Edit Tags screen.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( 'The description is not prominent by default; however, some themes may show it.', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'plural', ], ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_tax_labels', 'name' => 'template_name', 'textvalue' => isset( $current['labels']['template_name'] ) ? esc_attr( $current['labels']['template_name'] ) : null, // phpcs:ignore. 'aftertext' => esc_html__( '(e.g. "Category Archives")', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Template name', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Use by the site editor to display on the templates/add new template screens.', 'custom-post-type-ui' ), 'data' => [ /* translators: Used for autofill */ 'label' => sprintf( esc_attr__( '%s Archives', 'custom-post-type-ui' ), 'item' ), 'plurality' => 'singular', ], ] ); ?>

[ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), 'default' => 'true', ], ], ]; $selected = isset( $current ) ? disp_boolean( $current['public'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['public'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'public', 'labeltext' => esc_html__( 'Public', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: true) Whether a taxonomy is intended for use publicly either via the admin interface or by front-end users.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), 'default' => 'true', ], ], ]; $selected = isset( $current ) ? disp_boolean( $current['publicly_queryable'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['publicly_queryable'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'publicly_queryable', 'labeltext' => esc_html__( 'Public Queryable', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: value of "public" setting) Whether or not the taxonomy should be publicly queryable.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), 'default' => 'true', ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), ], ], ]; $selected = isset( $current ) ? disp_boolean( $current['hierarchical'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['hierarchical'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'hierarchical', 'labeltext' => esc_html__( 'Hierarchical', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: false) Whether the taxonomy can have parent-child relationships. "True" gives checkboxes, "False" gives text input.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), 'default' => 'true', ], ], ]; $selected = isset( $current ) ? disp_boolean( $current['show_ui'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['show_ui'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'show_ui', 'labeltext' => esc_html__( 'Show UI', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: true) Whether to generate a default UI for managing this custom taxonomy.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), 'default' => 'true', ], ], ]; $selected = isset( $current ) ? disp_boolean( $current['show_in_menu'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['show_in_menu'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'show_in_menu', 'labeltext' => esc_html__( 'Show in menu', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: value of show_ui) Whether to show the taxonomy in the admin menu.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), 'default' => 'true', ], ], ]; $selected = ( isset( $current ) && ! empty( $current['show_in_nav_menus'] ) ) ? disp_boolean( $current['show_in_nav_menus'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['show_in_nav_menus'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'show_in_nav_menus', 'labeltext' => esc_html__( 'Show in nav menus', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: value of public) Whether to make the taxonomy available for selection in navigation menus.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), 'default' => 'true', ], ], ]; $selected = isset( $current ) ? disp_boolean( $current['query_var'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['query_var'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'query_var', 'labeltext' => esc_html__( 'Query Var', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: true) Sets the query_var key for this taxonomy.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'query_var_slug', 'textvalue' => isset( $current['query_var_slug'] ) ? esc_attr( $current['query_var_slug'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(default: taxonomy slug). Query var needs to be true to use.', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Custom Query Var String', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Sets a custom query_var slug for this taxonomy.', 'custom-post-type-ui' ), ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), 'default' => 'true', ], ], ]; $selected = isset( $current ) ? disp_boolean( $current['rewrite'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['rewrite'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'rewrite', 'labeltext' => esc_html__( 'Rewrite', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: true) Whether or not WordPress should use rewrites for this taxonomy.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'rewrite_slug', 'textvalue' => isset( $current['rewrite_slug'] ) ? esc_attr( $current['rewrite_slug'] ) : '', // phpcs:ignore. 'aftertext' => esc_attr__( '(default: taxonomy name)', 'custom-post-type-ui' ), 'labeltext' => esc_html__( 'Custom Rewrite Slug', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Custom taxonomy rewrite slug.', 'custom-post-type-ui' ), ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), 'default' => 'true', ], ], ]; $selected = isset( $current ) ? disp_boolean( $current['rewrite_withfront'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['rewrite_withfront'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'rewrite_withfront', 'labeltext' => esc_html__( 'Rewrite With Front', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: true) Should the permastruct be prepended with the front base.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), 'default' => 'false', ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), ], ], ]; $selected = isset( $current ) ? disp_boolean( $current['rewrite_hierarchical'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['rewrite_hierarchical'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'rewrite_hierarchical', 'labeltext' => esc_html__( 'Rewrite Hierarchical', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: false) Should the permastruct allow hierarchical urls.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), 'default' => 'true', ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), ], ], ]; $selected = isset( $current ) ? disp_boolean( $current['show_admin_column'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['show_admin_column'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'show_admin_column', 'labeltext' => esc_html__( 'Show Admin Column', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: false) Whether to allow automatic creation of taxonomy columns on associated post-types.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), 'default' => 'true', ], ], ]; $selected = isset( $current ) ? disp_boolean( $current['show_in_rest'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['show_in_rest'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'show_in_rest', 'labeltext' => esc_html__( 'Show in REST API', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(Custom Post Type UI default: true) Whether to show this taxonomy data in the WP REST API.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'rest_base', 'labeltext' => esc_html__( 'REST API base slug', 'custom-post-type-ui' ), 'helptext' => esc_attr__( 'Slug to use in REST API URLs.', 'custom-post-type-ui' ), 'textvalue' => isset( $current['rest_base'] ) ? esc_attr( $current['rest_base'] ) : '', // phpcs:ignore. ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'rest_controller_class', 'labeltext' => esc_html__( 'REST API controller class', 'custom-post-type-ui' ), 'aftertext' => esc_attr__( '(default: WP_REST_Terms_Controller) Custom controller to use instead of WP_REST_Terms_Controller.', 'custom-post-type-ui' ), 'textvalue' => isset( $current['rest_controller_class'] ) ? esc_attr( $current['rest_controller_class'] ) : '', // phpcs:ignore. ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'rest_namespace', 'labeltext' => esc_html__( 'REST API namespace', 'custom-post-type-ui' ), 'aftertext' => esc_attr__( '(default: wp/v2) To change the namespace URL of REST API route.', 'custom-post-type-ui' ), 'textvalue' => isset( $current['rest_namespace'] ) ? esc_attr( $current['rest_namespace'] ) : '', // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), 'default' => 'false', ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), ], ], ]; $selected = ( isset( $current ) && ! empty( $current['show_tagcloud'] ) ) ? disp_boolean( $current['show_tagcloud'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['show_tagcloud'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'show_tagcloud', 'labeltext' => esc_html__( 'Show in tag cloud.', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: inherited from "show_ui") Whether to list the taxonomy in the Tag Cloud Widget controls.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), 'default' => 'false', ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), ], ], ]; $selected = ( isset( $current ) && ! empty( $current['show_in_quick_edit'] ) ) ? disp_boolean( $current['show_in_quick_edit'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['show_in_quick_edit'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'show_in_quick_edit', 'labeltext' => esc_html__( 'Show in quick/bulk edit panel.', 'custom-post-type-ui' ), 'aftertext' => esc_html__( '(default: false) Whether to show the taxonomy in the quick/bulk edit panel.', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); $select = [ 'options' => [ [ 'attr' => '0', 'text' => esc_attr__( 'False', 'custom-post-type-ui' ), 'default' => 'false', ], [ 'attr' => '1', 'text' => esc_attr__( 'True', 'custom-post-type-ui' ), ], ], ]; $selected = ( isset( $current ) && ! empty( $current['sort'] ) ) ? disp_boolean( $current['sort'] ) : ''; $select['selected'] = ! empty( $selected ) ? $current['sort'] : ''; echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'sort', 'labeltext' => esc_html__( 'Sort', 'custom-post-type-ui' ), 'aftertext' => esc_html__( 'Whether terms in this taxonomy should be sorted in the order they are provided to wp_set_object_terms()', 'custom-post-type-ui' ), 'selections' => $select, // phpcs:ignore. ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'meta_box_cb', 'textvalue' => isset( $current['meta_box_cb'] ) ? esc_attr( $current['meta_box_cb'] ) : '', // phpcs:ignore. 'labeltext' => esc_html__( 'Metabox callback', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Sets a callback function name for the meta box display. Hierarchical default: post_categories_meta_box, non-hierarchical default: post_tags_meta_box. To remove the metabox completely, use "false".', 'custom-post-type-ui' ), ] ); echo $ui->get_text_input( // phpcs:ignore. [ 'namearray' => 'cpt_custom_tax', 'name' => 'default_term', 'textvalue' => isset( $current['default_term'] ) ? esc_attr( $current['default_term'] ) : '', // phpcs:ignore. 'labeltext' => esc_html__( 'Default Term', 'custom-post-type-ui' ), 'helptext' => esc_html__( 'Set a default term for the taxonomy. Able to set a name, slug, and description. Only a name is required if setting a default, others are optional. Set values in the following order, separated by comma. Example: name, slug, description', 'custom-post-type-ui' ), ] ); ?>

$tax['name'], 'text' => $text, ]; } $current = cptui_get_current_taxonomy(); $select['selected'] = $current; /** * Filters the taxonomy dropdown options before rendering. * * @since 1.6.0 * * @param array $select Array of options for the dropdown. * @param array $taxonomies Array of original passed in post types. */ $select = apply_filters( 'cptui_taxonomies_dropdown_options', $select, $taxonomies ); echo $ui->get_select_input( // phpcs:ignore. [ 'namearray' => 'cptui_selected_taxonomy', 'name' => 'taxonomy', 'selections' => $select, // phpcs:ignore. 'wrap' => false, ] ); } } /** * Get the selected taxonomy from the $_POST global. * * @since 1.0.0 * * @internal * * @param bool $taxonomy_deleted Whether or not a taxonomy was recently deleted. Optional. Default false. * @return bool|string False on no result, sanitized taxonomy if set. */ function cptui_get_current_taxonomy( $taxonomy_deleted = false ) { $tax = false; if ( ! empty( $_POST ) ) { if ( ! empty( $_POST['cptui_select_taxonomy_nonce_field'] ) ) { check_admin_referer( 'cptui_select_taxonomy_nonce_action', 'cptui_select_taxonomy_nonce_field' ); } if ( isset( $_POST['cptui_selected_taxonomy']['taxonomy'] ) ) { $tax = sanitize_text_field( wp_unslash( $_POST['cptui_selected_taxonomy']['taxonomy'] ) ); } elseif ( $taxonomy_deleted ) { $taxonomies = cptui_get_taxonomy_data(); $tax = key( $taxonomies ); } elseif ( isset( $_POST['cpt_custom_tax']['name'] ) ) { // Return the submitted value. if ( ! in_array( $_POST['cpt_custom_tax']['name'], cptui_reserved_taxonomies(), true ) ) { $tax = sanitize_text_field( wp_unslash( $_POST['cpt_custom_tax']['name'] ) ); } else { // Return the original value since user tried to submit a reserved term. $tax = sanitize_text_field( wp_unslash( $_POST['tax_original'] ) ); // phpcs:ignore. } } } elseif ( ! empty( $_GET ) && isset( $_GET['cptui_taxonomy'] ) ) { $tax = sanitize_text_field( wp_unslash( $_GET['cptui_taxonomy'] ) ); } else { $taxonomies = cptui_get_taxonomy_data(); if ( ! empty( $taxonomies ) ) { // Will return the first array key. $tax = key( $taxonomies ); } } /** * Filters the current taxonomy to edit. * * @since 1.3.0 * * @param string $tax Taxonomy slug. */ return apply_filters( 'cptui_current_taxonomy', $tax ); } /** * Delete our custom taxonomy from the array of taxonomies. * * @since 1.0.0 * * @internal * * @param array $data The $_POST values. Optional. * @return bool|string False on failure, string on success. */ function cptui_delete_taxonomy( $data = [] ) { if ( is_string( $data ) && taxonomy_exists( $data ) ) { $slug = $data; $data = []; $data['name'] = $slug; } // Check if they selected one to delete. if ( empty( $data['name'] ) ) { return cptui_admin_notices( 'error', '', false, esc_html__( 'Please provide a taxonomy to delete', 'custom-post-type-ui' ) ); } /** * Fires before a taxonomy is deleted from our saved options. * * @since 1.0.0 * * @param array $data Array of taxonomy data we are deleting. */ do_action( 'cptui_before_delete_taxonomy', $data ); $taxonomies = cptui_get_taxonomy_data(); if ( array_key_exists( strtolower( $data['name'] ), $taxonomies ) ) { unset( $taxonomies[ $data['name'] ] ); /** * Filters whether or not 3rd party options were saved successfully within taxonomy deletion. * * @since 1.3.0 * * @param bool $value Whether or not someone else saved successfully. Default false. * @param array $taxonomies Array of our updated taxonomies data. * @param array $data Array of submitted taxonomy to update. */ if ( false === ( $success = apply_filters( 'cptui_taxonomy_delete_tax', false, $taxonomies, $data ) ) ) { // phpcs:ignore. $success = update_option( 'cptui_taxonomies', $taxonomies ); } } delete_option( "default_term_{$data['name']}" ); /** * Fires after a taxonomy is deleted from our saved options. * * @since 1.0.0 * * @param array $data Array of taxonomy data that was deleted. */ do_action( 'cptui_after_delete_taxonomy', $data ); // Used to help flush rewrite rules on init. set_transient( 'cptui_flush_rewrite_rules', 'true', 5 * 60 ); if ( isset( $success ) ) { return 'delete_success'; } return 'delete_fail'; } /** * Add to or update our CPTUI option with new data. * * @since 1.0.0 * * @internal * * @param array $data Array of taxonomy data to update. Optional. * @return bool|string False on failure, string on success. */ function cptui_update_taxonomy( $data = [] ) { /** * Fires before a taxonomy is updated to our saved options. * * @since 1.0.0 * * @param array $data Array of taxonomy data we are updating. */ do_action( 'cptui_before_update_taxonomy', $data ); // They need to provide a name. if ( empty( $data['cpt_custom_tax']['name'] ) ) { return cptui_admin_notices( 'error', '', false, esc_html__( 'Please provide a taxonomy name', 'custom-post-type-ui' ) ); } // Maybe a little harsh, but we shouldn't be saving THAT frequently. delete_option( "default_term_{$data['cpt_custom_tax']['name']}" ); if ( empty( $data['cpt_post_types'] ) ) { add_filter( 'cptui_custom_error_message', 'cptui_empty_cpt_on_taxonomy' ); return 'error'; } if ( ! empty( $data['tax_original'] ) && $data['tax_original'] !== $data['cpt_custom_tax']['name'] ) { if ( ! empty( $data['update_taxonomy'] ) ) { add_filter( 'cptui_convert_taxonomy_terms', '__return_true' ); } } foreach ( $data as $key => $value ) { if ( is_string( $value ) ) { $data[ $key ] = sanitize_text_field( $value ); } else { array_map( 'sanitize_text_field', $data[ $key ] ); } } if ( false !== strpos( $data['cpt_custom_tax']['name'], '\'' ) || false !== strpos( $data['cpt_custom_tax']['name'], '\"' ) || false !== strpos( $data['cpt_custom_tax']['rewrite_slug'], '\'' ) || false !== strpos( $data['cpt_custom_tax']['rewrite_slug'], '\"' ) ) { add_filter( 'cptui_custom_error_message', 'cptui_slug_has_quotes' ); return 'error'; } $taxonomies = cptui_get_taxonomy_data(); /** * Check if we already have a post type of that name. * * @since 1.3.0 * * @param bool $value Assume we have no conflict by default. * @param string $value Post type slug being saved. * @param array $post_types Array of existing post types from CPTUI. */ $slug_exists = apply_filters( 'cptui_taxonomy_slug_exists', false, $data['cpt_custom_tax']['name'], $taxonomies ); if ( true === $slug_exists ) { add_filter( 'cptui_custom_error_message', 'cptui_slug_matches_taxonomy' ); return 'error'; } if ( empty( $data['cpt_tax_labels'] ) || ! is_array( $data['cpt_tax_labels'] ) ) { $data['cpt_tax_labels'] = []; } foreach ( $data['cpt_tax_labels'] as $key => $label ) { if ( empty( $label ) ) { unset( $data['cpt_tax_labels'][ $key ] ); } $label = str_replace( '"', '', htmlspecialchars_decode( $label ) ); $label = htmlspecialchars( $label, ENT_QUOTES ); $label = trim( $label ); $data['cpt_tax_labels'][ $key ] = stripslashes_deep( $label ); } $label = ucwords( str_replace( '_', ' ', $data['cpt_custom_tax']['name'] ) ); if ( ! empty( $data['cpt_custom_tax']['label'] ) ) { $label = str_replace( '"', '', htmlspecialchars_decode( $data['cpt_custom_tax']['label'] ) ); $label = htmlspecialchars( stripslashes( $label ), ENT_QUOTES ); } $name = trim( $data['cpt_custom_tax']['name'] ); $singular_label = ucwords( str_replace( '_', ' ', $data['cpt_custom_tax']['name'] ) ); if ( ! empty( $data['cpt_custom_tax']['singular_label'] ) ) { $singular_label = str_replace( '"', '', htmlspecialchars_decode( $data['cpt_custom_tax']['singular_label'] ) ); $singular_label = htmlspecialchars( stripslashes( $singular_label ) ); } $description = stripslashes_deep( $data['cpt_custom_tax']['description'] ); $query_var_slug = trim( $data['cpt_custom_tax']['query_var_slug'] ); $rewrite_slug = trim( $data['cpt_custom_tax']['rewrite_slug'] ); $rest_base = trim( $data['cpt_custom_tax']['rest_base'] ); $rest_controller_class = trim( $data['cpt_custom_tax']['rest_controller_class'] ); $rest_namespace = trim( $data['cpt_custom_tax']['rest_namespace'] ); $show_quickpanel_bulk = ! empty( $data['cpt_custom_tax']['show_in_quick_edit'] ) ? disp_boolean( $data['cpt_custom_tax']['show_in_quick_edit'] ) : ''; $default_term = trim( $data['cpt_custom_tax']['default_term'] ); $meta_box_cb = trim( $data['cpt_custom_tax']['meta_box_cb'] ); // We may or may not need to force a boolean false keyword. $maybe_false = strtolower( trim( $data['cpt_custom_tax']['meta_box_cb'] ) ); if ( 'false' === $maybe_false ) { $meta_box_cb = $maybe_false; } $taxonomies[ $data['cpt_custom_tax']['name'] ] = [ 'name' => $name, 'label' => $label, 'singular_label' => $singular_label, 'description' => $description, 'public' => disp_boolean( $data['cpt_custom_tax']['public'] ), 'publicly_queryable' => disp_boolean( $data['cpt_custom_tax']['publicly_queryable'] ), 'hierarchical' => disp_boolean( $data['cpt_custom_tax']['hierarchical'] ), 'show_ui' => disp_boolean( $data['cpt_custom_tax']['show_ui'] ), 'show_in_menu' => disp_boolean( $data['cpt_custom_tax']['show_in_menu'] ), 'show_in_nav_menus' => disp_boolean( $data['cpt_custom_tax']['show_in_nav_menus'] ), 'query_var' => disp_boolean( $data['cpt_custom_tax']['query_var'] ), 'query_var_slug' => $query_var_slug, 'rewrite' => disp_boolean( $data['cpt_custom_tax']['rewrite'] ), 'rewrite_slug' => $rewrite_slug, 'rewrite_withfront' => $data['cpt_custom_tax']['rewrite_withfront'], 'rewrite_hierarchical' => $data['cpt_custom_tax']['rewrite_hierarchical'], 'show_admin_column' => disp_boolean( $data['cpt_custom_tax']['show_admin_column'] ), 'show_in_rest' => disp_boolean( $data['cpt_custom_tax']['show_in_rest'] ), 'show_tagcloud' => disp_boolean( $data['cpt_custom_tax']['show_tagcloud'] ), 'sort' => disp_boolean( $data['cpt_custom_tax']['sort'] ), 'show_in_quick_edit' => $show_quickpanel_bulk, 'rest_base' => $rest_base, 'rest_controller_class' => $rest_controller_class, 'rest_namespace' => $rest_namespace, 'labels' => $data['cpt_tax_labels'], 'meta_box_cb' => $meta_box_cb, 'default_term' => $default_term, ]; $taxonomies[ $data['cpt_custom_tax']['name'] ]['object_types'] = $data['cpt_post_types']; /** * Filters final data to be saved right before saving taxoomy data. * * @since 1.6.0 * * @param array $taxonomies Array of final taxonomy data to save. * @param string $name Taxonomy slug for taxonomy being saved. */ $taxonomies = apply_filters( 'cptui_pre_save_taxonomy', $taxonomies, $name ); /** * Filters whether or not 3rd party options were saved successfully within taxonomy add/update. * * @since 1.3.0 * * @param bool $value Whether or not someone else saved successfully. Default false. * @param array $taxonomies Array of our updated taxonomies data. * @param array $data Array of submitted taxonomy to update. */ if ( false === ( $success = apply_filters( 'cptui_taxonomy_update_save', false, $taxonomies, $data ) ) ) { // phpcs:ignore. $success = update_option( 'cptui_taxonomies', $taxonomies ); } /** * Fires after a taxonomy is updated to our saved options. * * @since 1.0.0 * * @param array $data Array of taxonomy data that was updated. */ do_action( 'cptui_after_update_taxonomy', $data ); // Used to help flush rewrite rules on init. set_transient( 'cptui_flush_rewrite_rules', 'true', 5 * 60 ); if ( isset( $success ) && 'new' === $data['cpt_tax_status'] ) { return 'add_success'; } return 'update_success'; } /** * Return an array of names that users should not or can not use for taxonomy names. * * @since 1.3.0 * * @return array $value Array of names that are recommended against. */ function cptui_reserved_taxonomies() { $reserved = [ 'action', 'attachment', 'attachment_id', 'author', 'author_name', 'calendar', 'cat', 'category', 'category__and', 'category__in', 'category__not_in', 'category_name', 'comments_per_page', 'comments_popup', 'cpage', 'custom', 'customize_messenger_channel', 'customized', 'date', 'day', 'debug', 'embed', 'error', 'exact', 'feed', 'fields', 'hour', 'include', 'link_category', 'm', 'minute', 'monthnum', 'more', 'name', 'nav_menu', 'nonce', 'nopaging', 'offset', 'order', 'orderby', 'output', 'p', 'page', 'page_id', 'paged', 'pagename', 'pb', 'perm', 'post', 'post__in', 'post__not_in', 'post_format', 'post_mime_type', 'post_status', 'post_tag', 'post_type', 'posts', 'posts_per_archive_page', 'posts_per_page', 'preview', 'robots', 's', 'search', 'search_terms', 'second', 'sentence', 'showposts', 'static', 'status', 'subpost', 'subpost_id', 'tag', 'tag__and', 'tag__in', 'tag__not_in', 'tag_id', 'tag_slug__and', 'tag_slug__in', 'taxonomy', 'tb', 'term', 'terms', 'theme', 'themes', 'title', 'type', 'types', 'w', 'withcomments', 'withoutcomments', 'year', ]; /** * Filters the list of reserved post types to check against. * 3rd party plugin authors could use this to prevent duplicate post types. * * @since 1.0.0 * * @param array $value Array of post type slugs to forbid. */ $custom_reserved = apply_filters( 'cptui_reserved_taxonomies', [] ); if ( is_string( $custom_reserved ) && ! empty( $custom_reserved ) ) { $reserved[] = $custom_reserved; } elseif ( is_array( $custom_reserved ) && ! empty( $custom_reserved ) ) { foreach ( $custom_reserved as $slug ) { $reserved[] = $slug; } } return $reserved; } /** * Convert taxonomies. * * @since 1.3.0 * * @internal * * @param string $original_slug Original taxonomy slug. Optional. Default empty string. * @param string $new_slug New taxonomy slug. Optional. Default empty string. */ function cptui_convert_taxonomy_terms( $original_slug = '', $new_slug = '' ) { global $wpdb; $args = [ 'taxonomy' => $original_slug, 'hide_empty' => false, 'fields' => 'ids', ]; $term_ids = get_terms( $args ); if ( is_int( $term_ids ) ) { $term_ids = (array) $term_ids; } if ( is_array( $term_ids ) && ! empty( $term_ids ) ) { $term_ids = implode( ',', $term_ids ); $query = "UPDATE `{$wpdb->term_taxonomy}` SET `taxonomy` = %s WHERE `taxonomy` = %s AND `term_id` IN ( {$term_ids} )"; $wpdb->query( // phpcs:ignore. $wpdb->prepare( $query, $new_slug, $original_slug ) // phpcs:ignore. ); } cptui_delete_taxonomy( $original_slug ); } /** * Checks if we are trying to register an already registered taxonomy slug. * * @since 1.3.0 * * @param bool $slug_exists Whether or not the post type slug exists. Optional. Default false. * @param string $taxonomy_slug The post type slug being saved. Optional. Default empty string. * @param array $taxonomies Array of CPTUI-registered post types. Optional. * * @return bool */ function cptui_check_existing_taxonomy_slugs( $slug_exists = false, $taxonomy_slug = '', $taxonomies = [] ) { // If true, then we'll already have a conflict, let's not re-process. if ( true === $slug_exists ) { return $slug_exists; } if ( ! is_array( $taxonomies ) ) { return $slug_exists; } // Check if CPTUI has already registered this slug. if ( array_key_exists( strtolower( $taxonomy_slug ), $taxonomies ) ) { // phpcs:ignore. return true; } // Check if we're registering a reserved post type slug. if ( in_array( $taxonomy_slug, cptui_reserved_taxonomies() ) ) { // phpcs:ignore. return true; } // Check if other plugins have registered this same slug. $public = get_taxonomies( [ '_builtin' => false, 'public' => true, ] ); $private = get_taxonomies( [ '_builtin' => false, 'public' => false, ] ); $registered_taxonomies = array_merge( $public, $private ); if ( in_array( $taxonomy_slug, $registered_taxonomies, true ) ) { return true; } // If we're this far, it's false. return $slug_exists; } add_filter( 'cptui_taxonomy_slug_exists', 'cptui_check_existing_taxonomy_slugs', 10, 3 ); /** * Handle the save and deletion of taxonomy data. * * @since 1.4.0 */ function cptui_process_taxonomy() { if ( wp_doing_ajax() ) { return; } if ( ! is_admin() ) { return; } if ( ! empty( $_GET ) && isset( $_GET['page'] ) && 'cptui_manage_taxonomies' !== $_GET['page'] ) { return; } if ( ! empty( $_POST ) ) { $result = ''; if ( isset( $_POST['cpt_submit'] ) ) { check_admin_referer( 'cptui_addedit_taxonomy_nonce_action', 'cptui_addedit_taxonomy_nonce_field' ); $data = cptui_filtered_taxonomy_post_global(); $result = cptui_update_taxonomy( $data ); } elseif ( isset( $_POST['cpt_delete'] ) ) { check_admin_referer( 'cptui_addedit_taxonomy_nonce_action', 'cptui_addedit_taxonomy_nonce_field' ); $filtered_data = filter_input( INPUT_POST, 'cpt_custom_tax', FILTER_SANITIZE_SPECIAL_CHARS, FILTER_REQUIRE_ARRAY ); $result = cptui_delete_taxonomy( $filtered_data ); add_filter( 'cptui_taxonomy_deleted', '__return_true' ); } if ( $result && is_callable( "cptui_{$result}_admin_notice" ) ) { add_action( 'admin_notices', "cptui_{$result}_admin_notice" ); } if ( isset( $_POST['cpt_delete'] ) && empty( cptui_get_taxonomy_slugs() ) ) { wp_safe_redirect( add_query_arg( [ 'page' => 'cptui_manage_taxonomies' ], cptui_admin_url( 'admin.php?page=cptui_manage_taxonomies' ) ) ); } } } add_action( 'init', 'cptui_process_taxonomy', 8 ); /** * Handle the conversion of taxonomy terms. * * This function came to be because we needed to convert AFTER registration. * * @since 1.4.3 */ function cptui_do_convert_taxonomy_terms() { /** * Whether or not to convert taxonomy terms. * * @since 1.4.3 * * @param bool $value Whether or not to convert. */ if ( apply_filters( 'cptui_convert_taxonomy_terms', false ) ) { check_admin_referer( 'cptui_addedit_taxonomy_nonce_action', 'cptui_addedit_taxonomy_nonce_field' ); $original = filter_input( INPUT_POST, 'tax_original', FILTER_SANITIZE_SPECIAL_CHARS ); $new = filter_input( INPUT_POST, 'cpt_custom_tax', FILTER_SANITIZE_SPECIAL_CHARS, FILTER_REQUIRE_ARRAY ); // Return early if either fails to successfully validate. if ( ! $original || ! $new ) { return; } cptui_convert_taxonomy_terms( sanitize_text_field( $original ), sanitize_text_field( $new['name'] ) ); } } add_action( 'init', 'cptui_do_convert_taxonomy_terms' ); /** * Handles slug_exist checks for cases of editing an existing taxonomy. * * @since 1.5.3 * * @param bool $slug_exists Current status for exist checks. * @param string $taxonomy_slug Taxonomy slug being processed. * @param array $taxonomies CPTUI taxonomies. * @return bool */ function cptui_updated_taxonomy_slug_exists( $slug_exists, $taxonomy_slug = '', $taxonomies = [] ) { if ( ( ! empty( $_POST['cpt_tax_status'] ) && 'edit' === $_POST['cpt_tax_status'] ) && // phpcs:ignore WordPress.Security.NonceVerification ! in_array( $taxonomy_slug, cptui_reserved_taxonomies(), true ) && // phpcs:ignore WordPress.Security.NonceVerification ( ! empty( $_POST['tax_original'] ) && $taxonomy_slug === $_POST['tax_original'] ) // phpcs:ignore WordPress.Security.NonceVerification ) { $slug_exists = false; } return $slug_exists; } add_filter( 'cptui_taxonomy_slug_exists', 'cptui_updated_taxonomy_slug_exists', 11, 3 ); /** * Sanitize and filter the $_POST global and return a reconstructed array of the parts we need. * * Used for when managing taxonomies. * * @since 1.10.0 * @return array */ function cptui_filtered_taxonomy_post_global() { $filtered_data = []; $default_arrays = [ 'cpt_custom_tax', 'cpt_tax_labels', 'cpt_post_types', 'update_taxonomy', ]; $third_party_items_arrays = apply_filters( 'cptui_filtered_taxonomy_post_global_arrays', (array) [] // phpcs:ignore. ); $items_arrays = array_merge( $default_arrays, $third_party_items_arrays ); foreach ( $items_arrays as $item ) { $first_result = filter_input( INPUT_POST, $item, FILTER_SANITIZE_SPECIAL_CHARS, FILTER_REQUIRE_ARRAY ); if ( $first_result ) { $filtered_data[ $item ] = $first_result; } } $default_strings = [ 'tax_original', 'cpt_tax_status', ]; $third_party_items_strings = apply_filters( 'cptui_filtered_taxonomy_post_global_strings', (array) [] // phpcs:ignore. ); $items_strings = array_merge( $default_strings, $third_party_items_strings ); foreach ( $items_strings as $item ) { $second_result = filter_input( INPUT_POST, $item, FILTER_SANITIZE_SPECIAL_CHARS ); if ( $second_result ) { $filtered_data[ $item ] = $second_result; } } return $filtered_data; }