/** * Convert taxonomies. * * @since 1.3.0 * * @internal * * @param string $original_slug Original taxonomy slug. * @param string $new_slug New taxonomy slug. */ function cptui_convert_taxonomy_terms($original_slug = '', $new_slug = '') { global $wpdb; $args = array('hide_empty' => false, 'fields' => 'ids'); $term_ids = get_terms($original_slug, $args); $term_ids = implode(',', $term_ids); $query = "UPDATE `{$wpdb->term_taxonomy}` SET `taxonomy` = %s WHERE `taxonomy` = %s AND `term_id` IN ( {$term_ids} )"; $wpdb->query($wpdb->prepare($query, $new_slug, $original_slug)); cptui_delete_taxonomy($original_slug); }
/** * Create our settings page output. * * @since 1.0.0 * * @return string HTML output for the page. */ function cptui_manage_taxonomies() { if (!empty($_POST)) { if (isset($_POST['cpt_submit'])) { check_admin_referer('cptui_addedit_taxonomy_nonce_action', 'cptui_addedit_taxonomy_nonce_field'); $notice = cptui_update_taxonomy($_POST); } elseif (isset($_POST['cpt_delete'])) { check_admin_referer('cptui_addedit_taxonomy_nonce_action', 'cptui_addedit_taxonomy_nonce_field'); $notice = cptui_delete_taxonomy($_POST); } } $tab = !empty($_GET) && !empty($_GET['action']) && 'edit' == $_GET['action'] ? 'edit' : 'new'; ?> <div class="wrap"> <?php if (isset($notice)) { echo $notice; } # Create our tabs. cptui_settings_tab_menu($page = 'taxonomies'); if ('edit' == $tab) { $taxonomies = get_option('cptui_taxonomies'); $selected_taxonomy = cptui_get_current_taxonomy(); if ($selected_taxonomy) { if (array_key_exists($selected_taxonomy, $taxonomies)) { $current = $taxonomies[$selected_taxonomy]; } } } $ui = new cptui_admin_ui(); # Will only be set if we're already on the edit screen if (!empty($taxonomies)) { ?> <form id="cptui_select_taxonomy" method="post"> <p><?php _e('Select a taxonomy to edit. DO NOT EDIT the taxonomy slug unless necessary. Changing that value registers a new taxonomy entry for your install.', 'cpt-plugin'); ?> </p> <?php cptui_taxonomies_dropdown($taxonomies); ?> <input type="submit" class="button-secondary" name="cptui_select_taxonomy_submit" value="<?php echo esc_attr(apply_filters('cptui_taxonomy_submit_select', __('Select', 'cpt-plugin'))); ?> " /> </form> <?php } ?> <form method="post"> <table class="form-table cptui-table"> <tr> <td><!--LEFT SIDE--> <table> <?php echo $ui->get_text_input(array('namearray' => 'cpt_custom_tax', 'name' => 'name', 'textvalue' => isset($current['name']) ? esc_attr($current['name']) : '', 'maxlength' => '32', 'onblur' => 'this.value=this.value.toLowerCase()', 'labeltext' => __('Taxonomy Slug', 'cpt-plugin'), 'aftertext' => __('(e.g. actors)', 'cpt-plugin'), 'helptext' => esc_attr__('The taxonomy name. Used to retrieve custom taxonomy content. Should be short and unique', 'cpt-plugin'), 'required' => true)); echo $ui->get_text_input(array('namearray' => 'cpt_custom_tax', 'name' => 'label', 'textvalue' => isset($current['label']) ? esc_attr($current['label']) : '', 'aftertext' => __('(e.g. Actors)', 'cpt-plugin'), 'labeltext' => __('Plural Label', 'cpt-plugin'), 'helptext' => esc_attr__('Taxonomy label. Used in the admin menu for displaying custom taxonomy.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_custom_tax', 'name' => 'singular_label', 'textvalue' => isset($current['singular_label']) ? esc_attr($current['singular_label']) : '', 'aftertext' => __('(e.g. Actor)', 'cpt-plugin'), 'labeltext' => __('Singular Label', 'cpt-plugin'), 'helptext' => esc_attr__('Taxonomy Singular label. Used in WordPress when a singular label is needed.', 'cpt-plugin'))); echo $ui->get_tr_start() . $ui->get_th_start() . __('Attach to Post Type', 'cpt-plugin') . $ui->get_required(); echo $ui->get_th_end() . $ui->get_td_start(); /** * 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', array('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 = array('public' => true); } $output = 'objects'; # or objects $post_types = get_post_types($args, $output); foreach ($post_types as $post_type) { /* * Supports Taxonomies Checkbox */ echo $ui->get_check_input(array('checkvalue' => $post_type->name, 'checked' => !empty($current['object_types']) && is_array($current['object_types']) && in_array($post_type->name, $current['object_types']) ? 'true' : 'false', 'name' => $post_type->name, 'namearray' => 'cpt_post_types', 'textvalue' => $post_type->name, 'labeltext' => $post_type->label, 'helptext' => sprintf(esc_attr__('Adds %s support', 'cpt-plugin'), $post_type->label), 'wrap' => false)); } echo $ui->get_td_end() . $ui->get_tr_end(); ?> </table> <p class="submit"> <?php wp_nonce_field('cptui_addedit_taxonomy_nonce_action', 'cptui_addedit_taxonomy_nonce_field'); if (!empty($_GET) && !empty($_GET['action']) && 'edit' == $_GET['action']) { ?> <input type="submit" class="button-primary" name="cpt_submit" value="<?php echo esc_attr(apply_filters('cptui_taxonomy_submit_edit', __('Edit Taxonomy', 'cpt-plugin'))); ?> " /> <input type="submit" class="button-secondary" name="cpt_delete" id="cpt_submit_delete" value="<?php echo apply_filters('cptui_taxonomy_submit_delete', __('Delete Taxonomy', 'cpt-plugin')); ?> " /> <?php } else { ?> <input type="submit" class="button-primary" name="cpt_submit" value="<?php echo esc_attr(apply_filters('cptui_taxonomy_submit_add', __('Add Taxonomy', 'cpt-plugin'))); ?> " /> <?php } ?> <input type="hidden" name="cpt_tax_status" id="cpt_tax_status" value="<?php echo $tab; ?> " /> </p> </td> <td> <p><?php _e('Click headings to reveal available options.', 'cpt-plugin'); ?> </p> <div id="cptui_accordion"> <h3 title="<?php esc_attr_e('Click to expand', 'cpt-plugin'); ?> "><?php _e('Labels', 'cpt-plugin'); ?> </h3> <div> <table> <?php echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'menu_name', 'textvalue' => isset($current['labels']['menu_name']) ? esc_attr($current['labels']['menu_name']) : '', 'aftertext' => __('(e.g. Actors)', 'cpt-plugin'), 'labeltext' => __('Menu Name', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'all_items', 'textvalue' => isset($current['labels']['all_items']) ? esc_attr($current['labels']['all_items']) : '', 'aftertext' => __('(e.g. All Actors)', 'cpt-plugin'), 'labeltext' => __('All Items', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'edit_item', 'textvalue' => isset($current['labels']['edit_item']) ? esc_attr($current['labels']['edit_item']) : '', 'aftertext' => __('(e.g. Edit Actor)', 'cpt-plugin'), 'labeltext' => __('Edit Item', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'view_item', 'textvalue' => isset($current['labels']['view_item']) ? esc_attr($current['labels']['view_item']) : '', 'aftertext' => __('(e.g. View Actor)', 'cpt-plugin'), 'labeltext' => __('View Item', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'update_item', 'textvalue' => isset($current['labels']['update_item']) ? esc_attr($current['labels']['update_item']) : '', 'aftertext' => __('(e.g. Update Actor Name)', 'cpt-plugin'), 'labeltext' => __('Update Item Name', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'add_new_item', 'textvalue' => isset($current['labels']['add_new_item']) ? esc_attr($current['labels']['add_new_item']) : '', 'aftertext' => __('(e.g. Add New Actor)', 'cpt-plugin'), 'labeltext' => __('Add New Item', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'new_item_name', 'textvalue' => isset($current['labels']['new_item_name']) ? esc_attr($current['labels']['new_item_name']) : '', 'aftertext' => __('(e.g. New Actor Name)', 'cpt-plugin'), 'labeltext' => __('New Item Name', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'parent_item', 'textvalue' => isset($current['labels']['parent_item']) ? esc_attr($current['labels']['parent_item']) : '', 'aftertext' => __('(e.g. Parent Actor)', 'cpt-plugin'), 'labeltext' => __('Parent Item', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'parent_item_colon', 'textvalue' => isset($current['labels']['parent_item_colon']) ? esc_attr($current['labels']['parent_item_colon']) : '', 'aftertext' => __('(e.g. Parent Actor:)', 'cpt-plugin'), 'labeltext' => __('Parent Item Colon', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'search_items', 'textvalue' => isset($current['labels']['search_items']) ? esc_attr($current['labels']['search_items']) : '', 'aftertext' => __('(e.g. Search Actors)', 'cpt-plugin'), 'labeltext' => __('Search Items', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'popular_items', 'textvalue' => isset($current['labels']['popular_items']) ? esc_attr($current['labels']['popular_items']) : null, 'aftertext' => __('(e.g. Popular Actors)', 'cpt-plugin'), 'labeltext' => __('Popular Items', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('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, 'aftertext' => __('(e.g. Separate actors with commas)', 'cpt-plugin'), 'labeltext' => __('Separate Items with Commas', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('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, 'aftertext' => __('(e.g. Add or remove actors)', 'cpt-plugin'), 'labeltext' => __('Add or Remove Items', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('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, 'aftertext' => __('(e.g. Choose from the most used actors)', 'cpt-plugin'), 'labeltext' => __('Choose From Most Used', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); echo $ui->get_text_input(array('namearray' => 'cpt_tax_labels', 'name' => 'not_found', 'textvalue' => isset($current['labels']['not_found']) ? esc_attr($current['labels']['not_found']) : null, 'aftertext' => __('(e.g. No actors found)', 'cpt-plugin'), 'labeltext' => __('Not found', 'cpt-plugin'), 'helptext' => esc_attr__('Custom taxonomy label. Used in the admin menu for displaying taxonomies.', 'cpt-plugin'))); ?> </table> </div> <h3 title="<?php esc_attr_e('Click to expand', 'cpt-plugin'); ?> "><?php _e('Settings', 'cpt-plugin'); ?> </h3> <div> <table> <?php $select = array('options' => array(array('attr' => '0', 'text' => __('False', 'cpt-plugin'), 'default' => 'true'), array('attr' => '1', 'text' => __('True', 'cpt-plugin')))); $selected = isset($current) ? disp_boolean($current['hierarchical']) : ''; $select['selected'] = !empty($selected) ? $current['hierarchical'] : ''; echo $ui->get_select_input(array('namearray' => 'cpt_custom_tax', 'name' => 'hierarchical', 'labeltext' => __('Hierarchical', 'cpt-plugin'), 'aftertext' => __('(default: False)', 'cpt-plugin'), 'helptext' => esc_attr__('Whether the taxonomy can have parent-child relationships', 'cpt-plugin'), 'selections' => $select)); $select = array('options' => array(array('attr' => '0', 'text' => __('False', 'cpt-plugin')), array('attr' => '1', 'text' => __('True', 'cpt-plugin'), 'default' => 'true'))); $selected = isset($current) ? disp_boolean($current['show_ui']) : ''; $select['selected'] = !empty($selected) ? $current['show_ui'] : ''; echo $ui->get_select_input(array('namearray' => 'cpt_custom_tax', 'name' => 'show_ui', 'labeltext' => __('Show UI', 'cpt-plugin'), 'aftertext' => __('(default: True)', 'cpt-plugin'), 'helptext' => esc_attr__('Whether to generate a default UI for managing this custom taxonomy', 'cpt-plugin'), 'selections' => $select)); $select = array('options' => array(array('attr' => '0', 'text' => __('False', 'cpt-plugin')), array('attr' => '1', 'text' => __('True', 'cpt-plugin'), 'default' => 'true'))); $selected = isset($current) ? disp_boolean($current['query_var']) : ''; $select['selected'] = !empty($selected) ? $current['query_var'] : ''; echo $ui->get_select_input(array('namearray' => 'cpt_custom_tax', 'name' => 'query_var', 'labeltext' => __('Query Var', 'cpt-plugin'), 'aftertext' => __('(default: True)', 'cpt-plugin'), 'selections' => $select)); echo $ui->get_text_input(array('namearray' => 'cpt_custom_tax', 'name' => 'query_var_slug', 'textvalue' => isset($current['query_var_slug']) ? esc_attr($current['query_var_slug']) : '', 'aftertext' => __('(default: none). Query Var needs to be true to use.', 'cpt-plugin'), 'labeltext' => __('Custom Query Var String', 'cpt-plugin'), 'helptext' => esc_attr__('Custom Query Var Slug', 'cpt-plugin'))); $select = array('options' => array(array('attr' => '0', 'text' => __('False', 'cpt-plugin')), array('attr' => '1', 'text' => __('True', 'cpt-plugin'), 'default' => 'true'))); $selected = isset($current) ? disp_boolean($current['rewrite']) : ''; $select['selected'] = !empty($selected) ? $current['rewrite'] : ''; echo $ui->get_select_input(array('namearray' => 'cpt_custom_tax', 'name' => 'rewrite', 'labeltext' => __('Rewrite', 'cpt-plugin'), 'aftertext' => __('(default: True)', 'cpt-plugin'), 'helptext' => esc_attr__('Triggers the handling of rewrites for this taxonomy', 'cpt-plugin'), 'selections' => $select)); echo $ui->get_text_input(array('namearray' => 'cpt_custom_tax', 'name' => 'rewrite_slug', 'textvalue' => isset($current['rewrite_slug']) ? esc_attr($current['rewrite_slug']) : '', 'aftertext' => __('(default: taxonomy name)', 'cpt-plugin'), 'labeltext' => __('Custom Rewrite Slug', 'cpt-plugin'), 'helptext' => esc_attr__('Custom Taxonomy Rewrite Slug', 'cpt-plugin'))); $select = array('options' => array(array('attr' => '0', 'text' => __('False', 'cpt-plugin')), array('attr' => '1', 'text' => __('True', 'cpt-plugin'), 'default' => 'true'))); $selected = isset($current) ? disp_boolean($current['rewrite_withfront']) : ''; $select['selected'] = !empty($selected) ? $current['rewrite_withfront'] : ''; echo $ui->get_select_input(array('namearray' => 'cpt_custom_tax', 'name' => 'rewrite_withfront', 'labeltext' => __('Rewrite With Front', 'cpt-plugin'), 'aftertext' => __('(default: true)', 'cpt-plugin'), 'helptext' => esc_attr__('Should the permastruct be prepended with the front base.', 'cpt-plugin'), 'selections' => $select)); $select = array('options' => array(array('attr' => '0', 'text' => __('False', 'cpt-plugin'), 'default' => 'false'), array('attr' => '1', 'text' => __('True', 'cpt-plugin')))); $selected = isset($current) ? disp_boolean($current['rewrite_hierarchical']) : ''; $select['selected'] = !empty($selected) ? $current['rewrite_hierarchical'] : ''; echo $ui->get_select_input(array('namearray' => 'cpt_custom_tax', 'name' => 'rewrite_hierarchical', 'labeltext' => __('Rewrite Hierarchical', 'cpt-plugin'), 'aftertext' => __('(default: false)', 'cpt-plugin'), 'helptext' => esc_attr__('Should the permastruct allow hierarchical urls.', 'cpt-plugin'), 'selections' => $select)); $select = array('options' => array(array('attr' => '0', 'text' => __('False', 'cpt-plugin'), 'default' => 'true'), array('attr' => '1', 'text' => __('True', 'cpt-plugin')))); $selected = isset($current) ? disp_boolean($current['show_admin_column']) : ''; $select['selected'] = !empty($selected) ? $current['show_admin_column'] : ''; echo $ui->get_select_input(array('namearray' => 'cpt_custom_tax', 'name' => 'show_admin_column', 'labeltext' => __('Show Admin Column', 'cpt-plugin'), 'aftertext' => __('(default: False)', 'cpt-plugin'), 'helptext' => esc_attr__('Whether to allow automatic creation of taxonomy columns on associated post-types.', 'cpt-plugin'), 'selections' => $select)); ?> </table> </div> <?php if ('new' == $tab) { ?> <h3 title="<?php esc_attr_e('Click to expand', 'cpt-plugin'); ?> "><?php _e('Starter Notes', 'cpt-plugin'); ?> </h3> <div><ol> <?php echo '<li>' . sprintf(__('Taxonomy names should have %smax 32 characters%s, and only contain alphanumeric, lowercase, characters, underscores in place of spaces, and letters that do not have accents.', 'cpt-plugin'), '<strong class="wp-ui-highlight">', '</strong>'); echo '<li>' . sprintf(__('If you are unfamiliar with the advanced taxonomy settings, just fill in the %sTaxonomy Name%s and choose an %sAttach to Post Type%s option. Remaining settings will use default values. Labels, if left blank, will be automatically created based on the taxonomy name. Hover over the question marks for more details.', 'cpt-plugin'), '<strong class="wp-ui-highlight">', '</strong>', '<strong class="wp-ui-highlight">', '</strong>'); echo '<li>' . sprintf(__('Deleting custom taxonomies do %sNOT%s delete terms added to those taxonomies. You can recreate your taxonomies and the terms will return. Changing the name, after adding terms to the taxonomy, will not update the terms in the database.', 'cpt-plugin'), '<strong class="wp-ui-highlight">', '</strong>'); ?> </ol></div> <?php } ?> </td> </tr> </table><!-- End outter table --> </form> </div><!-- End .wrap --> <?php }
/** * Handle the save and deletion of taxonomy data. * * @since 1.4.0 */ function cptui_process_taxonomy() { if (defined('DOING_AJAX') && 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'); $result = cptui_update_taxonomy($_POST); } elseif (isset($_POST['cpt_delete'])) { check_admin_referer('cptui_addedit_taxonomy_nonce_action', 'cptui_addedit_taxonomy_nonce_field'); $result = cptui_delete_taxonomy($_POST); add_filter('cptui_taxonomy_deleted', '__return_true'); } if ($result) { add_action('admin_notices', "cptui_{$result}_admin_notice"); } } }