277 lines
9.3 KiB
PHP
277 lines
9.3 KiB
PHP
|
<?php
|
||
|
|
/**
|
||
|
|
* Service Category taxonomy.
|
||
|
|
*
|
||
|
|
* Non-hierarchical taxonomy for categorizing additional services.
|
||
|
|
*
|
||
|
|
* @package Magdev\WpBnb\Taxonomies
|
||
|
|
*/
|
||
|
|
|
||
|
|
declare( strict_types=1 );
|
||
|
|
|
||
|
|
namespace Magdev\WpBnb\Taxonomies;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Service Category taxonomy class.
|
||
|
|
*/
|
||
|
|
final class ServiceCategory {
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Taxonomy slug.
|
||
|
|
*
|
||
|
|
* @var string
|
||
|
|
*/
|
||
|
|
public const TAXONOMY = 'bnb_service_category';
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Initialize the taxonomy.
|
||
|
|
*
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public static function init(): void {
|
||
|
|
add_action( 'init', array( self::class, 'register' ) );
|
||
|
|
add_action( 'bnb_service_category_add_form_fields', array( self::class, 'add_form_fields' ) );
|
||
|
|
add_action( 'bnb_service_category_edit_form_fields', array( self::class, 'edit_form_fields' ), 10, 2 );
|
||
|
|
add_action( 'created_bnb_service_category', array( self::class, 'save_term_meta' ), 10, 2 );
|
||
|
|
add_action( 'edited_bnb_service_category', array( self::class, 'save_term_meta' ), 10, 2 );
|
||
|
|
add_filter( 'manage_edit-bnb_service_category_columns', array( self::class, 'add_columns' ) );
|
||
|
|
add_filter( 'manage_bnb_service_category_custom_column', array( self::class, 'render_column' ), 10, 3 );
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Register the taxonomy.
|
||
|
|
*
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public static function register(): void {
|
||
|
|
$labels = array(
|
||
|
|
'name' => _x( 'Service Categories', 'taxonomy general name', 'wp-bnb' ),
|
||
|
|
'singular_name' => _x( 'Service Category', 'taxonomy singular name', 'wp-bnb' ),
|
||
|
|
'search_items' => __( 'Search Service Categories', 'wp-bnb' ),
|
||
|
|
'popular_items' => __( 'Popular Service Categories', 'wp-bnb' ),
|
||
|
|
'all_items' => __( 'All Service Categories', 'wp-bnb' ),
|
||
|
|
'parent_item' => null,
|
||
|
|
'parent_item_colon' => null,
|
||
|
|
'edit_item' => __( 'Edit Service Category', 'wp-bnb' ),
|
||
|
|
'update_item' => __( 'Update Service Category', 'wp-bnb' ),
|
||
|
|
'add_new_item' => __( 'Add New Service Category', 'wp-bnb' ),
|
||
|
|
'new_item_name' => __( 'New Service Category Name', 'wp-bnb' ),
|
||
|
|
'separate_items_with_commas' => __( 'Separate categories with commas', 'wp-bnb' ),
|
||
|
|
'add_or_remove_items' => __( 'Add or remove categories', 'wp-bnb' ),
|
||
|
|
'choose_from_most_used' => __( 'Choose from the most used categories', 'wp-bnb' ),
|
||
|
|
'not_found' => __( 'No service categories found.', 'wp-bnb' ),
|
||
|
|
'menu_name' => __( 'Categories', 'wp-bnb' ),
|
||
|
|
'back_to_items' => __( '← Back to Categories', 'wp-bnb' ),
|
||
|
|
);
|
||
|
|
|
||
|
|
$args = array(
|
||
|
|
'labels' => $labels,
|
||
|
|
'hierarchical' => false, // Non-hierarchical (like tags).
|
||
|
|
'public' => true,
|
||
|
|
'publicly_queryable' => true,
|
||
|
|
'show_ui' => true,
|
||
|
|
'show_in_menu' => true,
|
||
|
|
'show_in_nav_menus' => true,
|
||
|
|
'show_in_rest' => true,
|
||
|
|
'show_tagcloud' => false,
|
||
|
|
'show_in_quick_edit' => true,
|
||
|
|
'show_admin_column' => true,
|
||
|
|
'rewrite' => array(
|
||
|
|
'slug' => 'service-category',
|
||
|
|
'with_front' => false,
|
||
|
|
),
|
||
|
|
'query_var' => true,
|
||
|
|
'capabilities' => array(
|
||
|
|
'manage_terms' => 'manage_options',
|
||
|
|
'edit_terms' => 'manage_options',
|
||
|
|
'delete_terms' => 'manage_options',
|
||
|
|
'assign_terms' => 'edit_posts',
|
||
|
|
),
|
||
|
|
);
|
||
|
|
|
||
|
|
register_taxonomy( self::TAXONOMY, array( 'bnb_service' ), $args );
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Add custom fields to the add term form.
|
||
|
|
*
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public static function add_form_fields(): void {
|
||
|
|
?>
|
||
|
|
<div class="form-field term-icon-wrap">
|
||
|
|
<label for="service-category-icon"><?php esc_html_e( 'Icon', 'wp-bnb' ); ?></label>
|
||
|
|
<select name="service_category_icon" id="service-category-icon">
|
||
|
|
<?php foreach ( self::get_icon_options() as $value => $label ) : ?>
|
||
|
|
<option value="<?php echo esc_attr( $value ); ?>"><?php echo esc_html( $label ); ?></option>
|
||
|
|
<?php endforeach; ?>
|
||
|
|
</select>
|
||
|
|
<p><?php esc_html_e( 'Select an icon to represent this category.', 'wp-bnb' ); ?></p>
|
||
|
|
</div>
|
||
|
|
<div class="form-field term-sort-order-wrap">
|
||
|
|
<label for="service-category-sort-order"><?php esc_html_e( 'Sort Order', 'wp-bnb' ); ?></label>
|
||
|
|
<input type="number" name="service_category_sort_order" id="service-category-sort-order" value="0" min="0">
|
||
|
|
<p><?php esc_html_e( 'Lower numbers appear first.', 'wp-bnb' ); ?></p>
|
||
|
|
</div>
|
||
|
|
<?php
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Add custom fields to the edit term form.
|
||
|
|
*
|
||
|
|
* @param \WP_Term $term Current term object.
|
||
|
|
* @param string $taxonomy Current taxonomy slug.
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public static function edit_form_fields( \WP_Term $term, string $taxonomy ): void {
|
||
|
|
$icon = get_term_meta( $term->term_id, 'service_category_icon', true );
|
||
|
|
$sort_order = get_term_meta( $term->term_id, 'service_category_sort_order', true );
|
||
|
|
?>
|
||
|
|
<tr class="form-field term-icon-wrap">
|
||
|
|
<th scope="row">
|
||
|
|
<label for="service-category-icon"><?php esc_html_e( 'Icon', 'wp-bnb' ); ?></label>
|
||
|
|
</th>
|
||
|
|
<td>
|
||
|
|
<select name="service_category_icon" id="service-category-icon">
|
||
|
|
<?php foreach ( self::get_icon_options() as $value => $label ) : ?>
|
||
|
|
<option value="<?php echo esc_attr( $value ); ?>" <?php selected( $icon, $value ); ?>>
|
||
|
|
<?php echo esc_html( $label ); ?>
|
||
|
|
</option>
|
||
|
|
<?php endforeach; ?>
|
||
|
|
</select>
|
||
|
|
<p class="description"><?php esc_html_e( 'Select an icon to represent this category.', 'wp-bnb' ); ?></p>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<tr class="form-field term-sort-order-wrap">
|
||
|
|
<th scope="row">
|
||
|
|
<label for="service-category-sort-order"><?php esc_html_e( 'Sort Order', 'wp-bnb' ); ?></label>
|
||
|
|
</th>
|
||
|
|
<td>
|
||
|
|
<input type="number" name="service_category_sort_order" id="service-category-sort-order"
|
||
|
|
value="<?php echo esc_attr( $sort_order ?: '0' ); ?>" min="0">
|
||
|
|
<p class="description"><?php esc_html_e( 'Lower numbers appear first.', 'wp-bnb' ); ?></p>
|
||
|
|
</td>
|
||
|
|
</tr>
|
||
|
|
<?php
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Save term meta data.
|
||
|
|
*
|
||
|
|
* @param int $term_id Term ID.
|
||
|
|
* @param int $tt_id Term taxonomy ID.
|
||
|
|
* @return void
|
||
|
|
*/
|
||
|
|
public static function save_term_meta( int $term_id, int $tt_id ): void {
|
||
|
|
if ( isset( $_POST['service_category_icon'] ) ) {
|
||
|
|
update_term_meta(
|
||
|
|
$term_id,
|
||
|
|
'service_category_icon',
|
||
|
|
sanitize_text_field( wp_unslash( $_POST['service_category_icon'] ) )
|
||
|
|
);
|
||
|
|
}
|
||
|
|
if ( isset( $_POST['service_category_sort_order'] ) ) {
|
||
|
|
update_term_meta(
|
||
|
|
$term_id,
|
||
|
|
'service_category_sort_order',
|
||
|
|
absint( $_POST['service_category_sort_order'] )
|
||
|
|
);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Add custom columns to the taxonomy list.
|
||
|
|
*
|
||
|
|
* @param array $columns Existing columns.
|
||
|
|
* @return array
|
||
|
|
*/
|
||
|
|
public static function add_columns( array $columns ): array {
|
||
|
|
$new_columns = array();
|
||
|
|
foreach ( $columns as $key => $value ) {
|
||
|
|
$new_columns[ $key ] = $value;
|
||
|
|
if ( 'name' === $key ) {
|
||
|
|
$new_columns['icon'] = __( 'Icon', 'wp-bnb' );
|
||
|
|
$new_columns['sort_order'] = __( 'Sort Order', 'wp-bnb' );
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return $new_columns;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Render custom column content.
|
||
|
|
*
|
||
|
|
* @param string $content Column content.
|
||
|
|
* @param string $column_name Column name.
|
||
|
|
* @param int $term_id Term ID.
|
||
|
|
* @return string
|
||
|
|
*/
|
||
|
|
public static function render_column( string $content, string $column_name, int $term_id ): string {
|
||
|
|
if ( 'icon' === $column_name ) {
|
||
|
|
$icon = get_term_meta( $term_id, 'service_category_icon', true );
|
||
|
|
if ( $icon ) {
|
||
|
|
return '<span class="dashicons dashicons-' . esc_attr( $icon ) . '"></span>';
|
||
|
|
}
|
||
|
|
return '—';
|
||
|
|
}
|
||
|
|
if ( 'sort_order' === $column_name ) {
|
||
|
|
$sort_order = get_term_meta( $term_id, 'service_category_sort_order', true );
|
||
|
|
return esc_html( $sort_order ?: '0' );
|
||
|
|
}
|
||
|
|
return $content;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get available icon options.
|
||
|
|
*
|
||
|
|
* @return array<string, string>
|
||
|
|
*/
|
||
|
|
public static function get_icon_options(): array {
|
||
|
|
return array(
|
||
|
|
'' => __( '— Select Icon —', 'wp-bnb' ),
|
||
|
|
'food' => __( 'Food & Dining', 'wp-bnb' ),
|
||
|
|
'car' => __( 'Transportation', 'wp-bnb' ),
|
||
|
|
'heart' => __( 'Wellness & Spa', 'wp-bnb' ),
|
||
|
|
'tickets-alt' => __( 'Activities', 'wp-bnb' ),
|
||
|
|
'admin-home' => __( 'Housekeeping', 'wp-bnb' ),
|
||
|
|
'admin-appearance' => __( 'Room Service', 'wp-bnb' ),
|
||
|
|
'store' => __( 'Shopping', 'wp-bnb' ),
|
||
|
|
'groups' => __( 'Childcare', 'wp-bnb' ),
|
||
|
|
'pets' => __( 'Pet Services', 'wp-bnb' ),
|
||
|
|
'businessman' => __( 'Business', 'wp-bnb' ),
|
||
|
|
'calendar' => __( 'Events', 'wp-bnb' ),
|
||
|
|
'camera' => __( 'Photography', 'wp-bnb' ),
|
||
|
|
'admin-generic' => __( 'Other', 'wp-bnb' ),
|
||
|
|
);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Get default service categories to seed on activation.
|
||
|
|
*
|
||
|
|
* @return array<string, array{icon: string, sort_order: int}>
|
||
|
|
*/
|
||
|
|
public static function get_default_terms(): array {
|
||
|
|
return array(
|
||
|
|
__( 'Food & Dining', 'wp-bnb' ) => array(
|
||
|
|
'icon' => 'food',
|
||
|
|
'sort_order' => 10,
|
||
|
|
),
|
||
|
|
__( 'Transportation', 'wp-bnb' ) => array(
|
||
|
|
'icon' => 'car',
|
||
|
|
'sort_order' => 20,
|
||
|
|
),
|
||
|
|
__( 'Wellness & Spa', 'wp-bnb' ) => array(
|
||
|
|
'icon' => 'heart',
|
||
|
|
'sort_order' => 30,
|
||
|
|
),
|
||
|
|
__( 'Activities', 'wp-bnb' ) => array(
|
||
|
|
'icon' => 'tickets-alt',
|
||
|
|
'sort_order' => 40,
|
||
|
|
),
|
||
|
|
__( 'Housekeeping', 'wp-bnb' ) => array(
|
||
|
|
'icon' => 'admin-home',
|
||
|
|
'sort_order' => 50,
|
||
|
|
),
|
||
|
|
);
|
||
|
|
}
|
||
|
|
}
|