*/ public function get_style_depends(): array { return [ KING_ADDONS_ASSETS_UNIQUE_KEY . '-comparison-matrix-cards-style', ]; } /** * Script dependencies. * * @return array */ public function get_script_depends(): array { return [ KING_ADDONS_ASSETS_UNIQUE_KEY . '-comparison-matrix-cards-script', ]; } /** * Categories. * * @return array */ public function get_categories(): array { return ['king-addons']; } /** * Keywords. * * @return array */ public function get_keywords(): array { return ['comparison', 'matrix', 'cards', 'pricing', 'plans']; } public function get_custom_help_url() { return 'mailto:bug@kingaddons.com?subject=Bug Report - King Addons&body=Please describe the issue'; } /** * Register widget controls. */ public function register_controls(): void { $this->register_data_source_controls(); $this->register_plan_controls(); $this->register_feature_controls(); $this->register_layout_controls(); $this->register_highlight_controls(); $this->register_sticky_controls(); $this->register_search_controls(); $this->register_style_card_controls(); $this->register_style_header_controls(); $this->register_style_feature_controls(); $this->register_style_button_controls(); $this->register_style_highlight_controls(); $this->register_style_sticky_controls(); $this->register_style_search_controls(); $this->register_pro_notice_controls(); } /** * Render widget output. */ public function render(): void { $settings = $this->get_settings_for_display(); $data = $this->get_render_data($settings); if (!empty($data['pro_locked'])) { if ($this->is_editor_mode()) { echo '
' . esc_html__('Upgrade to Pro to use ACF/WooCommerce data sources and advanced comparison tools.', 'king-addons') . '
'; } return; } $plans = $data['plans'] ?? []; $features = $data['features'] ?? []; if (count($plans) < 2) { return; } $context = $this->get_render_context($settings, count($plans)); $wrapper_classes = $this->get_wrapper_classes($settings, $context); $wrapper_attributes = $this->get_wrapper_attributes($settings, $context); ?>
> render_controls_bar($context); ?>
$plan) : ?> render_card($plan, $features, $index); ?>
start_controls_section( 'kng_data_source_section', [ 'label' => KING_ADDONS_ELEMENTOR_ICON . esc_html__('Data Source', 'king-addons'), 'tab' => Controls_Manager::TAB_CONTENT, ] ); $this->add_control( 'kng_data_source', [ 'label' => esc_html__('Source', 'king-addons'), 'type' => Controls_Manager::SELECT, 'default' => 'manual', 'options' => [ 'manual' => esc_html__('Manual', 'king-addons'), 'acf' => $this->get_pro_label(esc_html__('ACF', 'king-addons')), 'woo' => $this->get_pro_label(esc_html__('WooCommerce', 'king-addons')), ], ] ); $this->add_control( 'kng_max_plans', [ 'label' => $this->get_pro_label(esc_html__('Max Plans', 'king-addons')), 'type' => Controls_Manager::NUMBER, 'default' => 4, 'min' => 2, 'max' => 8, 'step' => 1, 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_data_source!' => 'manual', ], 'description' => esc_html__('Applies to ACF/Woo data sources.', 'king-addons'), ] ); $this->end_controls_section(); $this->register_acf_controls(); $this->register_woo_controls(); } /** * Register ACF data controls. */ protected function register_acf_controls(): void { $this->start_controls_section( 'kng_acf_section', [ 'label' => KING_ADDONS_ELEMENTOR_ICON . esc_html__('ACF Mapping', 'king-addons'), 'tab' => Controls_Manager::TAB_CONTENT, 'condition' => [ 'kng_data_source' => 'acf', ], ] ); if (!function_exists('get_field')) { $this->add_control( 'kng_acf_missing_notice', [ 'type' => Controls_Manager::RAW_HTML, 'raw' => esc_html__('ACF plugin is not active. Enable ACF to use this data source.', 'king-addons'), 'content_classes' => 'king-addons-pro-notice', ] ); } $this->add_control( 'kng_acf_post_source', [ 'label' => $this->get_pro_label(esc_html__('Post ID Source', 'king-addons')), 'type' => Controls_Manager::SELECT, 'default' => 'current', 'options' => [ 'current' => esc_html__('Current Post', 'king-addons'), 'custom' => esc_html__('Custom Post ID', 'king-addons'), ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_post_id', [ 'label' => $this->get_pro_label(esc_html__('Custom Post ID', 'king-addons')), 'type' => Controls_Manager::NUMBER, 'min' => 1, 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_acf_post_source' => 'custom', ], ] ); $this->add_control( 'kng_acf_plans_repeater', [ 'label' => $this->get_pro_label(esc_html__('Plans Repeater Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'plans', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_plan_name_field', [ 'label' => $this->get_pro_label(esc_html__('Plan Name Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'plan_name', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_plan_badge_field', [ 'label' => $this->get_pro_label(esc_html__('Badge Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'plan_badge', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_plan_description_field', [ 'label' => $this->get_pro_label(esc_html__('Description Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'plan_description', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_plan_price_field', [ 'label' => $this->get_pro_label(esc_html__('Price Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'plan_price', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_plan_subtitle_field', [ 'label' => $this->get_pro_label(esc_html__('Subtitle Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'plan_subtitle', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_plan_cta_label_field', [ 'label' => $this->get_pro_label(esc_html__('CTA Label Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'cta_label', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_plan_cta_link_field', [ 'label' => $this->get_pro_label(esc_html__('CTA Link Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'cta_link', 'classes' => $this->get_pro_control_class(), 'description' => esc_html__('Accepts ACF Link field or URL string.', 'king-addons'), ] ); $this->add_control( 'kng_acf_plan_footer_field', [ 'label' => $this->get_pro_label(esc_html__('Footer Note Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'plan_footer', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_plan_features_repeater', [ 'label' => $this->get_pro_label(esc_html__('Plan Features Repeater', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'features', 'classes' => $this->get_pro_control_class(), 'separator' => 'before', ] ); $this->add_control( 'kng_acf_feature_label_field', [ 'label' => $this->get_pro_label(esc_html__('Feature Label Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'feature_label', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_feature_value_field', [ 'label' => $this->get_pro_label(esc_html__('Feature Value Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'feature_value', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_feature_value_type_field', [ 'label' => $this->get_pro_label(esc_html__('Feature Value Type Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'feature_type', 'classes' => $this->get_pro_control_class(), 'description' => esc_html__('Optional field with values: included, excluded, limited, text.', 'king-addons'), ] ); $this->add_control( 'kng_acf_feature_tooltip_field', [ 'label' => $this->get_pro_label(esc_html__('Tooltip Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'feature_tooltip', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_acf_feature_group_field', [ 'label' => $this->get_pro_label(esc_html__('Group Field', 'king-addons')), 'type' => Controls_Manager::TEXT, 'placeholder' => 'feature_group', 'classes' => $this->get_pro_control_class(), ] ); $this->end_controls_section(); } /** * Register WooCommerce data controls. */ protected function register_woo_controls(): void { $this->start_controls_section( 'kng_woo_section', [ 'label' => KING_ADDONS_ELEMENTOR_ICON . esc_html__('WooCommerce Mapping', 'king-addons'), 'tab' => Controls_Manager::TAB_CONTENT, 'condition' => [ 'kng_data_source' => 'woo', ], ] ); if (!class_exists('WooCommerce')) { $this->add_control( 'kng_woo_missing_notice', [ 'type' => Controls_Manager::RAW_HTML, 'raw' => esc_html__('WooCommerce plugin is not active. Enable WooCommerce to use this data source.', 'king-addons'), 'content_classes' => 'king-addons-pro-notice', ] ); } $this->add_control( 'kng_woo_products_source', [ 'label' => $this->get_pro_label(esc_html__('Products Source', 'king-addons')), 'type' => Controls_Manager::SELECT, 'default' => 'manual', 'options' => [ 'manual' => esc_html__('Manual Select', 'king-addons'), 'related' => esc_html__('Related Products', 'king-addons'), 'upsell' => esc_html__('Upsells', 'king-addons'), 'cross_sell' => esc_html__('Cross-sells', 'king-addons'), ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_woo_products', [ 'label' => $this->get_pro_label(esc_html__('Select Products', 'king-addons')), 'type' => 'king-addons-ajax-select2', 'options' => 'ajaxselect2/getPostsByPostType', 'query_slug' => 'product', 'multiple' => true, 'label_block' => true, 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_woo_products_source' => 'manual', ], ] ); $this->add_control( 'kng_woo_products_limit', [ 'label' => $this->get_pro_label(esc_html__('Max Products', 'king-addons')), 'type' => Controls_Manager::NUMBER, 'default' => 4, 'min' => 2, 'max' => 8, 'step' => 1, 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_woo_compare_variations', [ 'label' => $this->get_pro_label(esc_html__('Compare Variations', 'king-addons')), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => '', 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_woo_products_source' => 'manual', ], 'description' => esc_html__('Compare variations of a single variable product.', 'king-addons'), ] ); $this->add_control( 'kng_woo_variation_title_mode', [ 'label' => $this->get_pro_label(esc_html__('Variation Title', 'king-addons')), 'type' => Controls_Manager::SELECT, 'default' => 'full', 'options' => [ 'full' => esc_html__('Full Name', 'king-addons'), 'attributes' => esc_html__('Attributes Only', 'king-addons'), 'parent' => esc_html__('Parent Name', 'king-addons'), ], 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_woo_compare_variations' => 'yes', ], ] ); $this->add_control( 'kng_woo_variation_subtitle_mode', [ 'label' => $this->get_pro_label(esc_html__('Variation Subtitle', 'king-addons')), 'type' => Controls_Manager::SELECT, 'default' => 'none', 'options' => [ 'none' => esc_html__('None', 'king-addons'), 'attributes' => esc_html__('Attributes', 'king-addons'), ], 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_woo_compare_variations' => 'yes', ], ] ); $this->add_control( 'kng_woo_variation_notice', [ 'type' => Controls_Manager::RAW_HTML, 'raw' => esc_html__('When enabled, only the first selected product is used to load variations.', 'king-addons'), 'content_classes' => 'elementor-panel-alert elementor-panel-alert-info', 'condition' => [ 'kng_woo_compare_variations' => 'yes', ], ] ); $this->add_control( 'kng_woo_show_price', [ 'label' => $this->get_pro_label(esc_html__('Show Price', 'king-addons')), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => 'yes', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_woo_cta_mode', [ 'label' => $this->get_pro_label(esc_html__('CTA Type', 'king-addons')), 'type' => Controls_Manager::SELECT, 'default' => 'product', 'options' => [ 'product' => esc_html__('Product Page', 'king-addons'), 'add_to_cart' => esc_html__('Add to Cart', 'king-addons'), ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_woo_cta_label', [ 'label' => $this->get_pro_label(esc_html__('CTA Label', 'king-addons')), 'type' => Controls_Manager::TEXT, 'default' => esc_html__('View Product', 'king-addons'), 'classes' => $this->get_pro_control_class(), ] ); $attributes = new Repeater(); $attributes->add_control( 'kng_woo_attr_slug', [ 'label' => esc_html__('Attribute Slug', 'king-addons'), 'type' => Controls_Manager::TEXT, 'placeholder' => 'pa_color', 'label_block' => true, ] ); $attributes->add_control( 'kng_woo_attr_label', [ 'label' => esc_html__('Label Override', 'king-addons'), 'type' => Controls_Manager::TEXT, 'placeholder' => esc_html__('Color', 'king-addons'), ] ); $attributes->add_control( 'kng_woo_attr_group', [ 'label' => esc_html__('Group', 'king-addons'), 'type' => Controls_Manager::TEXT, 'placeholder' => esc_html__('Performance', 'king-addons'), ] ); $attributes->add_control( 'kng_woo_attr_tooltip', [ 'label' => esc_html__('Tooltip', 'king-addons'), 'type' => Controls_Manager::TEXTAREA, 'rows' => 2, ] ); $attributes->add_control( 'kng_woo_attr_fallback', [ 'label' => esc_html__('Fallback Meta Key', 'king-addons'), 'type' => Controls_Manager::TEXT, 'placeholder' => 'custom_feature', ] ); $this->add_control( 'kng_woo_attributes', [ 'label' => $this->get_pro_label(esc_html__('Compare Attributes', 'king-addons')), 'type' => Controls_Manager::REPEATER, 'fields' => $attributes->get_controls(), 'title_field' => '{{ kng_woo_attr_slug }}', 'classes' => $this->get_pro_control_class(), ] ); $this->end_controls_section(); } /** * Register manual plan controls. */ protected function register_plan_controls(): void { $this->start_controls_section( 'kng_plans_section', [ 'label' => KING_ADDONS_ELEMENTOR_ICON . esc_html__('Plans', 'king-addons'), 'tab' => Controls_Manager::TAB_CONTENT, 'condition' => [ 'kng_data_source' => 'manual', ], ] ); $plan_options = [ '2' => esc_html__('2 Plans', 'king-addons'), '3' => esc_html__('3 Plans', 'king-addons'), ]; if ($this->can_use_pro()) { $plan_options['4'] = esc_html__('4 Plans', 'king-addons'); $plan_options['5'] = esc_html__('5 Plans', 'king-addons'); $plan_options['6'] = esc_html__('6 Plans', 'king-addons'); } else { $plan_options['4'] = $this->get_pro_label(esc_html__('4 Plans', 'king-addons')); $plan_options['5'] = $this->get_pro_label(esc_html__('5 Plans', 'king-addons')); $plan_options['6'] = $this->get_pro_label(esc_html__('6 Plans', 'king-addons')); } $this->add_control( 'kng_plans_count', [ 'label' => esc_html__('Plans Count', 'king-addons'), 'type' => Controls_Manager::SELECT, 'default' => '3', 'options' => $plan_options, 'description' => esc_html__('Free version supports 2-3 plans.', 'king-addons'), ] ); $repeater = new Repeater(); $repeater->add_control( 'kng_plan_name', [ 'label' => esc_html__('Name', 'king-addons'), 'type' => Controls_Manager::TEXT, 'default' => esc_html__('Plan name', 'king-addons'), 'label_block' => true, 'dynamic' => [ 'active' => true, ], ] ); $repeater->add_control( 'kng_plan_badge', [ 'label' => esc_html__('Badge', 'king-addons'), 'type' => Controls_Manager::TEXT, 'default' => '', 'placeholder' => esc_html__('Most Popular', 'king-addons'), 'dynamic' => [ 'active' => true, ], ] ); $repeater->add_control( 'kng_plan_description', [ 'label' => esc_html__('Short Description', 'king-addons'), 'type' => Controls_Manager::TEXTAREA, 'rows' => 2, 'default' => '', 'dynamic' => [ 'active' => true, ], ] ); $repeater->add_control( 'kng_plan_price', [ 'label' => esc_html__('Price', 'king-addons'), 'type' => Controls_Manager::TEXT, 'default' => '$29', 'dynamic' => [ 'active' => true, ], ] ); $repeater->add_control( 'kng_plan_subtitle', [ 'label' => esc_html__('Subtitle', 'king-addons'), 'type' => Controls_Manager::TEXT, 'default' => esc_html__('per month', 'king-addons'), 'dynamic' => [ 'active' => true, ], ] ); $repeater->add_control( 'kng_plan_cta_label', [ 'label' => esc_html__('CTA Label', 'king-addons'), 'type' => Controls_Manager::TEXT, 'default' => esc_html__('Get started', 'king-addons'), 'dynamic' => [ 'active' => true, ], ] ); $repeater->add_control( 'kng_plan_cta_link', [ 'label' => esc_html__('CTA Link', 'king-addons'), 'type' => Controls_Manager::URL, 'placeholder' => esc_html__('https://your-link.com', 'king-addons'), 'default' => [ 'url' => '', 'is_external' => false, 'nofollow' => false, ], ] ); $repeater->add_control( 'kng_plan_footer_note', [ 'label' => esc_html__('Footer Note', 'king-addons'), 'type' => Controls_Manager::TEXT, 'default' => '', 'dynamic' => [ 'active' => true, ], ] ); $this->add_control( 'kng_plans', [ 'label' => esc_html__('Plans', 'king-addons'), 'type' => Controls_Manager::REPEATER, 'fields' => $repeater->get_controls(), 'title_field' => '{{ kng_plan_name }}', 'default' => [ [ 'kng_plan_name' => esc_html__('Starter', 'king-addons'), 'kng_plan_badge' => '', 'kng_plan_price' => '$19', 'kng_plan_subtitle' => esc_html__('per month', 'king-addons'), 'kng_plan_cta_label' => esc_html__('Choose Starter', 'king-addons'), ], [ 'kng_plan_name' => esc_html__('Pro', 'king-addons'), 'kng_plan_badge' => esc_html__('Most Popular', 'king-addons'), 'kng_plan_price' => '$39', 'kng_plan_subtitle' => esc_html__('per month', 'king-addons'), 'kng_plan_cta_label' => esc_html__('Choose Pro', 'king-addons'), ], [ 'kng_plan_name' => esc_html__('Business', 'king-addons'), 'kng_plan_badge' => '', 'kng_plan_price' => '$79', 'kng_plan_subtitle' => esc_html__('per month', 'king-addons'), 'kng_plan_cta_label' => esc_html__('Choose Business', 'king-addons'), ], ], ] ); $this->end_controls_section(); } /** * Register feature controls (manual mode). */ protected function register_feature_controls(): void { $this->start_controls_section( 'kng_features_section', [ 'label' => KING_ADDONS_ELEMENTOR_ICON . esc_html__('Features', 'king-addons'), 'tab' => Controls_Manager::TAB_CONTENT, 'condition' => [ 'kng_data_source' => 'manual', ], ] ); $repeater = new Repeater(); $repeater->add_control( 'kng_feature_label', [ 'label' => esc_html__('Feature Label', 'king-addons'), 'type' => Controls_Manager::TEXT, 'default' => esc_html__('Feature name', 'king-addons'), 'label_block' => true, 'dynamic' => [ 'active' => true, ], ] ); $repeater->add_control( 'kng_feature_tooltip', [ 'label' => esc_html__('Tooltip', 'king-addons'), 'type' => Controls_Manager::TEXTAREA, 'rows' => 2, 'default' => '', 'dynamic' => [ 'active' => true, ], ] ); $repeater->add_control( 'kng_feature_group', [ 'label' => esc_html__('Group', 'king-addons'), 'type' => Controls_Manager::TEXT, 'default' => '', 'placeholder' => esc_html__('Security', 'king-addons'), 'dynamic' => [ 'active' => true, ], ] ); $plan_conditions = [ 3 => ['kng_plans_count' => ['3', '4', '5', '6']], 4 => ['kng_plans_count' => ['4', '5', '6']], 5 => ['kng_plans_count' => ['5', '6']], 6 => ['kng_plans_count' => ['6']], ]; $this->add_feature_value_controls($repeater, 1, esc_html__('Plan 1', 'king-addons')); $this->add_feature_value_controls($repeater, 2, esc_html__('Plan 2', 'king-addons')); $this->add_feature_value_controls($repeater, 3, esc_html__('Plan 3', 'king-addons'), $plan_conditions[3]); $this->add_feature_value_controls($repeater, 4, $this->get_pro_label(esc_html__('Plan 4', 'king-addons')), $plan_conditions[4], $this->get_pro_control_class()); $this->add_feature_value_controls($repeater, 5, $this->get_pro_label(esc_html__('Plan 5', 'king-addons')), $plan_conditions[5], $this->get_pro_control_class()); $this->add_feature_value_controls($repeater, 6, $this->get_pro_label(esc_html__('Plan 6', 'king-addons')), $plan_conditions[6], $this->get_pro_control_class()); $this->add_control( 'kng_features', [ 'label' => esc_html__('Feature Rows', 'king-addons'), 'type' => Controls_Manager::REPEATER, 'fields' => $repeater->get_controls(), 'title_field' => '{{ kng_feature_label }}', 'default' => [ [ 'kng_feature_label' => esc_html__('Unlimited projects', 'king-addons'), 'kng_feature_value_1_type' => 'limited', 'kng_feature_value_2_type' => 'included', 'kng_feature_value_3_type' => 'included', ], [ 'kng_feature_label' => esc_html__('Team seats', 'king-addons'), 'kng_feature_value_1_type' => 'text', 'kng_feature_value_1_text' => '5', 'kng_feature_value_2_type' => 'text', 'kng_feature_value_2_text' => '20', 'kng_feature_value_3_type' => 'text', 'kng_feature_value_3_text' => 'Unlimited', ], [ 'kng_feature_label' => esc_html__('Priority support', 'king-addons'), 'kng_feature_value_1_type' => 'excluded', 'kng_feature_value_2_type' => 'included', 'kng_feature_value_3_type' => 'included', ], [ 'kng_feature_label' => esc_html__('SLA guarantee', 'king-addons'), 'kng_feature_value_1_type' => 'excluded', 'kng_feature_value_2_type' => 'limited', 'kng_feature_value_3_type' => 'included', ], ], ] ); $this->end_controls_section(); } /** * Register layout controls. */ protected function register_layout_controls(): void { $this->start_controls_section( 'kng_layout_section', [ 'label' => KING_ADDONS_ELEMENTOR_ICON . esc_html__('Layout', 'king-addons'), 'tab' => Controls_Manager::TAB_CONTENT, ] ); $this->add_control( 'kng_preset', [ 'label' => esc_html__('Preset', 'king-addons'), 'type' => Controls_Manager::SELECT, 'default' => 'minimal', 'options' => [ 'minimal' => esc_html__('Minimal', 'king-addons'), 'bordered' => esc_html__('Bordered', 'king-addons'), 'soft' => esc_html__('Soft Shadow', 'king-addons'), ], ] ); $column_options = [ '2' => esc_html__('2 Columns', 'king-addons'), '3' => esc_html__('3 Columns', 'king-addons'), ]; if ($this->can_use_pro()) { $column_options['4'] = esc_html__('4 Columns', 'king-addons'); $column_options['5'] = esc_html__('5 Columns', 'king-addons'); $column_options['6'] = esc_html__('6 Columns', 'king-addons'); } else { $column_options['4'] = $this->get_pro_label(esc_html__('4 Columns', 'king-addons')); $column_options['5'] = $this->get_pro_label(esc_html__('5 Columns', 'king-addons')); $column_options['6'] = $this->get_pro_label(esc_html__('6 Columns', 'king-addons')); } $this->add_control( 'kng_columns', [ 'label' => esc_html__('Columns', 'king-addons'), 'type' => Controls_Manager::SELECT, 'default' => '3', 'options' => $column_options, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-columns: {{VALUE}};', ], ] ); $this->add_responsive_control( 'kng_grid_gap', [ 'label' => esc_html__('Gap', 'king-addons'), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px', 'em'], 'range' => [ 'px' => [ 'min' => 0, 'max' => 80, ], 'em' => [ 'min' => 0, 'max' => 6, ], ], 'default' => [ 'size' => 24, 'unit' => 'px', ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-gap: {{SIZE}}{{UNIT}};', ], ] ); $this->add_control( 'kng_equal_height', [ 'label' => esc_html__('Equal Height Cards', 'king-addons'), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => 'yes', ] ); $this->add_control( 'kng_mobile_layout', [ 'label' => esc_html__('Mobile Layout', 'king-addons'), 'type' => Controls_Manager::SELECT, 'default' => 'stack', 'options' => [ 'stack' => esc_html__('Stack', 'king-addons'), 'scroll' => esc_html__('Horizontal Scroll', 'king-addons'), ], ] ); $this->add_control( 'kng_hide_scrollbar', [ 'label' => esc_html__('Hide Mobile Scrollbar', 'king-addons'), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => '', 'condition' => [ 'kng_mobile_layout' => 'scroll', ], ] ); $this->add_responsive_control( 'kng_mobile_card_min_width', [ 'label' => esc_html__('Card Min Width (Mobile)', 'king-addons'), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px'], 'range' => [ 'px' => [ 'min' => 200, 'max' => 420, ], ], 'default' => [ 'size' => 260, 'unit' => 'px', ], 'condition' => [ 'kng_mobile_layout' => 'scroll', ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-card-min-width: {{SIZE}}{{UNIT}};', ], ] ); $this->end_controls_section(); } /** * Register highlight differences controls (Pro). */ protected function register_highlight_controls(): void { $this->start_controls_section( 'kng_highlight_section', [ 'label' => $this->get_pro_label(esc_html__('Highlight Differences', 'king-addons')), 'tab' => Controls_Manager::TAB_CONTENT, 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_highlight_enable', [ 'label' => $this->get_pro_label(esc_html__('Enable Highlight', 'king-addons')), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => '', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_highlight_mode', [ 'label' => $this->get_pro_label(esc_html__('Mode', 'king-addons')), 'type' => Controls_Manager::SELECT, 'default' => 'dim', 'options' => [ 'dim' => esc_html__('Dim Identical', 'king-addons'), 'hide' => esc_html__('Hide Identical', 'king-addons'), 'unique' => esc_html__('Highlight Unique', 'king-addons'), ], 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_highlight_enable' => 'yes', ], ] ); $this->add_control( 'kng_highlight_style', [ 'label' => $this->get_pro_label(esc_html__('Visual Style', 'king-addons')), 'type' => Controls_Manager::SELECT, 'default' => 'background', 'options' => [ 'background' => esc_html__('Background', 'king-addons'), 'border' => esc_html__('Border', 'king-addons'), 'icon' => esc_html__('Icon Emphasis', 'king-addons'), ], 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_highlight_enable' => 'yes', 'kng_highlight_mode' => 'unique', ], ] ); $this->add_control( 'kng_highlight_compare', [ 'label' => $this->get_pro_label(esc_html__('Compare Mode', 'king-addons')), 'type' => Controls_Manager::SELECT, 'default' => 'normalized', 'options' => [ 'strict' => esc_html__('Strict Match', 'king-addons'), 'normalized' => esc_html__('Normalized', 'king-addons'), ], 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_highlight_enable' => 'yes', ], ] ); $this->add_control( 'kng_highlight_toggle', [ 'label' => $this->get_pro_label(esc_html__('Show Toggle', 'king-addons')), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => '', 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_highlight_enable' => 'yes', ], ] ); $this->add_control( 'kng_highlight_toggle_label', [ 'label' => $this->get_pro_label(esc_html__('Toggle Label', 'king-addons')), 'type' => Controls_Manager::TEXT, 'default' => esc_html__('Highlight differences', 'king-addons'), 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_highlight_enable' => 'yes', 'kng_highlight_toggle' => 'yes', ], ] ); $this->add_control( 'kng_highlight_default', [ 'label' => $this->get_pro_label(esc_html__('Default State', 'king-addons')), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => 'yes', 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_highlight_enable' => 'yes', ], ] ); $this->end_controls_section(); } /** * Register sticky header controls (Pro). */ protected function register_sticky_controls(): void { $this->start_controls_section( 'kng_sticky_section', [ 'label' => $this->get_pro_label(esc_html__('Sticky Header', 'king-addons')), 'tab' => Controls_Manager::TAB_CONTENT, 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_sticky_enable', [ 'label' => $this->get_pro_label(esc_html__('Enable Sticky Header', 'king-addons')), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => '', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_sticky_offset', [ 'label' => $this->get_pro_label(esc_html__('Top Offset', 'king-addons')), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px'], 'range' => [ 'px' => [ 'min' => 0, 'max' => 120, ], ], 'default' => [ 'size' => 0, 'unit' => 'px', ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-sticky-offset: {{SIZE}}{{UNIT}};', ], 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_sticky_enable' => 'yes', ], ] ); $this->add_control( 'kng_sticky_shadow', [ 'label' => $this->get_pro_label(esc_html__('Shadow on Sticky', 'king-addons')), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => 'yes', 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_sticky_enable' => 'yes', ], ] ); $this->add_control( 'kng_sticky_mobile_mode', [ 'label' => $this->get_pro_label(esc_html__('Mobile Mode', 'king-addons')), 'type' => Controls_Manager::SELECT, 'default' => 'compact', 'options' => [ 'off' => esc_html__('Off', 'king-addons'), 'compact' => esc_html__('Compact', 'king-addons'), 'full' => esc_html__('Full', 'king-addons'), ], 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_sticky_enable' => 'yes', ], ] ); $this->end_controls_section(); } /** * Register search/filter controls (Pro). */ protected function register_search_controls(): void { $this->start_controls_section( 'kng_search_section', [ 'label' => $this->get_pro_label(esc_html__('Feature Search', 'king-addons')), 'tab' => Controls_Manager::TAB_CONTENT, 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_search_enable', [ 'label' => $this->get_pro_label(esc_html__('Enable Search', 'king-addons')), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => '', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_search_placeholder', [ 'label' => $this->get_pro_label(esc_html__('Placeholder', 'king-addons')), 'type' => Controls_Manager::TEXT, 'default' => esc_html__('Search features', 'king-addons'), 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_search_enable' => 'yes', ], ] ); $this->add_control( 'kng_search_includes_tooltip', [ 'label' => $this->get_pro_label(esc_html__('Search Tooltips', 'king-addons')), 'type' => Controls_Manager::SWITCHER, 'return_value' => 'yes', 'default' => 'yes', 'classes' => $this->get_pro_control_class(), 'condition' => [ 'kng_search_enable' => 'yes', ], ] ); $this->end_controls_section(); } /** * Register card style controls. */ protected function register_style_card_controls(): void { $this->start_controls_section( 'kng_style_card_section', [ 'label' => KING_ADDONS_ELEMENTOR_ICON . esc_html__('Card', 'king-addons'), 'tab' => Controls_Manager::TAB_STYLE, ] ); $this->add_group_control( Group_Control_Background::get_type(), [ 'name' => 'kng_card_background', 'types' => ['classic', 'gradient'], 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__card', ] ); $this->add_group_control( Group_Control_Border::get_type(), [ 'name' => 'kng_card_border', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__card', ] ); $this->add_control( 'kng_card_radius', [ 'label' => esc_html__('Border Radius', 'king-addons'), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px', '%'], 'range' => [ 'px' => ['min' => 0, 'max' => 60], '%' => ['min' => 0, 'max' => 100], ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__card' => 'border-radius: {{SIZE}}{{UNIT}};', ], ] ); $this->add_group_control( Group_Control_Box_Shadow::get_type(), [ 'name' => 'kng_card_shadow', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__card', ] ); $this->add_responsive_control( 'kng_card_padding', [ 'label' => esc_html__('Padding', 'king-addons'), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => ['px', 'em', '%'], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__card' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};', ], ] ); $this->add_control( 'kng_card_hover_heading', [ 'label' => esc_html__('Hover', 'king-addons'), 'type' => Controls_Manager::HEADING, 'separator' => 'before', ] ); $this->add_control( 'kng_card_hover_background', [ 'label' => esc_html__('Hover Background', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__card:hover' => 'background: {{VALUE}};', ], ] ); $this->add_control( 'kng_card_hover_border', [ 'label' => esc_html__('Hover Border Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__card:hover' => 'border-color: {{VALUE}};', ], ] ); $this->add_group_control( Group_Control_Box_Shadow::get_type(), [ 'name' => 'kng_card_hover_shadow', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__card:hover', ] ); $this->add_control( 'kng_card_hover_translate', [ 'label' => esc_html__('Hover Lift', 'king-addons'), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px'], 'range' => [ 'px' => [ 'min' => -30, 'max' => 30, ], ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-card-hover-translate: {{SIZE}}{{UNIT}};', ], ] ); $this->end_controls_section(); } /** * Register header style controls. */ protected function register_style_header_controls(): void { $this->start_controls_section( 'kng_style_header_section', [ 'label' => KING_ADDONS_ELEMENTOR_ICON . esc_html__('Header', 'king-addons'), 'tab' => Controls_Manager::TAB_STYLE, ] ); $this->add_control( 'kng_title_color', [ 'label' => esc_html__('Title Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__title' => 'color: {{VALUE}};', ], ] ); $this->add_group_control( Group_Control_Typography::get_type(), [ 'name' => 'kng_title_typography', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__title', ] ); $this->add_control( 'kng_price_color', [ 'label' => esc_html__('Price Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__price' => 'color: {{VALUE}};', ], ] ); $this->add_group_control( Group_Control_Typography::get_type(), [ 'name' => 'kng_price_typography', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__price', ] ); $this->add_control( 'kng_subtitle_color', [ 'label' => esc_html__('Subtitle Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__subtitle' => 'color: {{VALUE}};', '{{WRAPPER}} .king-addons-comparison-matrix-cards__description' => 'color: {{VALUE}};', ], ] ); $this->add_group_control( Group_Control_Typography::get_type(), [ 'name' => 'kng_subtitle_typography', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__subtitle, {{WRAPPER}} .king-addons-comparison-matrix-cards__description', ] ); $this->add_control( 'kng_header_gap', [ 'label' => esc_html__('Header Spacing', 'king-addons'), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px', 'em'], 'range' => [ 'px' => [ 'min' => 0, 'max' => 40, ], 'em' => [ 'min' => 0, 'max' => 3, ], ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-header-gap: {{SIZE}}{{UNIT}};', ], ] ); $this->add_control( 'kng_badge_color', [ 'label' => esc_html__('Badge Text Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__badge' => 'color: {{VALUE}};', ], ] ); $this->add_control( 'kng_badge_background', [ 'label' => esc_html__('Badge Background', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__badge' => 'background-color: {{VALUE}};', ], ] ); $this->end_controls_section(); } /** * Register feature style controls. */ protected function register_style_feature_controls(): void { $this->start_controls_section( 'kng_style_features_section', [ 'label' => KING_ADDONS_ELEMENTOR_ICON . esc_html__('Features', 'king-addons'), 'tab' => Controls_Manager::TAB_STYLE, ] ); $this->add_control( 'kng_feature_label_color', [ 'label' => esc_html__('Label Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__feature-label' => 'color: {{VALUE}};', ], ] ); $this->add_group_control( Group_Control_Typography::get_type(), [ 'name' => 'kng_feature_label_typography', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__feature-label', ] ); $this->add_control( 'kng_feature_value_color', [ 'label' => esc_html__('Value Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__feature-value' => 'color: {{VALUE}};', ], ] ); $this->add_group_control( Group_Control_Typography::get_type(), [ 'name' => 'kng_feature_value_typography', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__feature-value', ] ); $this->add_control( 'kng_feature_icon_size', [ 'label' => esc_html__('Icon Size', 'king-addons'), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px'], 'range' => [ 'px' => [ 'min' => 12, 'max' => 32, ], ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__icon' => 'width: {{SIZE}}{{UNIT}}; height: {{SIZE}}{{UNIT}};', ], ] ); $this->add_control( 'kng_feature_icon_included', [ 'label' => esc_html__('Included Icon Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__icon.is-included' => 'color: {{VALUE}};', ], ] ); $this->add_control( 'kng_feature_icon_excluded', [ 'label' => esc_html__('Excluded Icon Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__icon.is-excluded' => 'color: {{VALUE}};', ], ] ); $this->add_control( 'kng_feature_icon_limited', [ 'label' => esc_html__('Limited Icon Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__icon.is-limited' => 'color: {{VALUE}};', ], ] ); $this->add_control( 'kng_feature_spacing', [ 'label' => esc_html__('Item Spacing', 'king-addons'), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px'], 'range' => [ 'px' => [ 'min' => 4, 'max' => 32, ], ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__feature' => 'gap: {{SIZE}}{{UNIT}};', '{{WRAPPER}} .king-addons-comparison-matrix-cards__feature:not(:last-child)' => 'padding-bottom: {{SIZE}}{{UNIT}};', ], ] ); $this->add_control( 'kng_feature_divider_color', [ 'label' => esc_html__('Divider Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-divider-color: {{VALUE}};', ], ] ); $this->add_control( 'kng_feature_divider_style', [ 'label' => esc_html__('Divider Style', 'king-addons'), 'type' => Controls_Manager::SELECT, 'default' => 'dashed', 'options' => [ 'solid' => esc_html__('Solid', 'king-addons'), 'dashed' => esc_html__('Dashed', 'king-addons'), 'dotted' => esc_html__('Dotted', 'king-addons'), ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-divider-style: {{VALUE}};', ], ] ); $this->add_control( 'kng_feature_divider_width', [ 'label' => esc_html__('Divider Width', 'king-addons'), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px'], 'range' => [ 'px' => [ 'min' => 0, 'max' => 4, ], ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-divider-width: {{SIZE}}{{UNIT}};', ], ] ); $this->add_control( 'kng_feature_group_color', [ 'label' => esc_html__('Group Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__group' => 'color: {{VALUE}};', ], ] ); $this->add_group_control( Group_Control_Typography::get_type(), [ 'name' => 'kng_feature_group_typography', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__group', ] ); $this->add_control( 'kng_feature_group_background', [ 'label' => esc_html__('Group Background', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-group-bg: {{VALUE}};', ], ] ); $this->add_responsive_control( 'kng_feature_group_padding', [ 'label' => esc_html__('Group Padding', 'king-addons'), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => ['px', 'em'], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-group-padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};', ], ] ); $this->add_control( 'kng_feature_group_radius', [ 'label' => esc_html__('Group Border Radius', 'king-addons'), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px', '%'], 'range' => [ 'px' => ['min' => 0, 'max' => 40], '%' => ['min' => 0, 'max' => 100], ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-group-radius: {{SIZE}}{{UNIT}};', ], ] ); $this->add_control( 'kng_tooltip_background', [ 'label' => esc_html__('Tooltip Background', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-tooltip-bg: {{VALUE}};', ], ] ); $this->add_control( 'kng_tooltip_text', [ 'label' => esc_html__('Tooltip Text Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-tooltip-text: {{VALUE}};', ], ] ); $this->add_group_control( Group_Control_Typography::get_type(), [ 'name' => 'kng_tooltip_typography', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__tooltip-text', ] ); $this->end_controls_section(); } /** * Register button style controls. */ protected function register_style_button_controls(): void { $this->start_controls_section( 'kng_style_button_section', [ 'label' => KING_ADDONS_ELEMENTOR_ICON . esc_html__('Button', 'king-addons'), 'tab' => Controls_Manager::TAB_STYLE, ] ); $this->add_control( 'kng_button_alignment', [ 'label' => esc_html__('Alignment', 'king-addons'), 'type' => Controls_Manager::SELECT, 'default' => 'flex-start', 'options' => [ 'flex-start' => esc_html__('Left', 'king-addons'), 'center' => esc_html__('Center', 'king-addons'), 'flex-end' => esc_html__('Right', 'king-addons'), ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__button' => 'align-self: {{VALUE}};', ], ] ); $this->add_group_control( Group_Control_Typography::get_type(), [ 'name' => 'kng_button_typography', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__button', ] ); $this->add_control( 'kng_button_text_color', [ 'label' => esc_html__('Text Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__button' => 'color: {{VALUE}};', ], ] ); $this->add_control( 'kng_button_background', [ 'label' => esc_html__('Background', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__button' => 'background-color: {{VALUE}};', ], ] ); $this->add_control( 'kng_button_hover_text_color', [ 'label' => esc_html__('Hover Text Color', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__button:hover' => 'color: {{VALUE}};', ], ] ); $this->add_control( 'kng_button_hover_background', [ 'label' => esc_html__('Hover Background', 'king-addons'), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__button:hover' => 'background-color: {{VALUE}};', ], ] ); $this->add_group_control( Group_Control_Border::get_type(), [ 'name' => 'kng_button_border', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__button', ] ); $this->add_control( 'kng_button_radius', [ 'label' => esc_html__('Border Radius', 'king-addons'), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px', '%'], 'range' => [ 'px' => ['min' => 0, 'max' => 60], '%' => ['min' => 0, 'max' => 100], ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__button' => 'border-radius: {{SIZE}}{{UNIT}};', ], ] ); $this->add_responsive_control( 'kng_button_padding', [ 'label' => esc_html__('Padding', 'king-addons'), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => ['px', 'em'], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__button' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};', ], ] ); $this->end_controls_section(); } /** * Register highlight style controls (Pro). */ protected function register_style_highlight_controls(): void { $this->start_controls_section( 'kng_style_highlight_section', [ 'label' => $this->get_pro_label(esc_html__('Highlight Styles', 'king-addons')), 'tab' => Controls_Manager::TAB_STYLE, 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_highlight_dim_opacity', [ 'label' => $this->get_pro_label(esc_html__('Dim Opacity', 'king-addons')), 'type' => Controls_Manager::SLIDER, 'size_units' => ['%'], 'range' => [ '%' => [ 'min' => 10, 'max' => 100, ], ], 'default' => [ 'size' => 45, 'unit' => '%', ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-dim-opacity: calc({{SIZE}} / 100);', ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_highlight_unique_background', [ 'label' => $this->get_pro_label(esc_html__('Unique Background', 'king-addons')), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-unique-bg: {{VALUE}};', ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_highlight_unique_border', [ 'label' => $this->get_pro_label(esc_html__('Unique Border', 'king-addons')), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-unique-border: {{VALUE}};', ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_highlight_unique_text', [ 'label' => $this->get_pro_label(esc_html__('Unique Text', 'king-addons')), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-unique-text: {{VALUE}};', ], 'classes' => $this->get_pro_control_class(), ] ); $this->end_controls_section(); } /** * Register sticky style controls (Pro). */ protected function register_style_sticky_controls(): void { $this->start_controls_section( 'kng_style_sticky_section', [ 'label' => $this->get_pro_label(esc_html__('Sticky Styles', 'king-addons')), 'tab' => Controls_Manager::TAB_STYLE, 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_sticky_background', [ 'label' => $this->get_pro_label(esc_html__('Sticky Background', 'king-addons')), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-sticky-bg: {{VALUE}};', ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_sticky_divider', [ 'label' => $this->get_pro_label(esc_html__('Sticky Divider', 'king-addons')), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-sticky-divider: {{VALUE}};', ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_sticky_shadow_color', [ 'label' => $this->get_pro_label(esc_html__('Sticky Shadow', 'king-addons')), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-sticky-shadow: {{VALUE}};', ], 'classes' => $this->get_pro_control_class(), ] ); $this->end_controls_section(); } /** * Register search style controls (Pro). */ protected function register_style_search_controls(): void { $this->start_controls_section( 'kng_style_search_section', [ 'label' => $this->get_pro_label(esc_html__('Search Styles', 'king-addons')), 'tab' => Controls_Manager::TAB_STYLE, 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_search_background', [ 'label' => $this->get_pro_label(esc_html__('Background', 'king-addons')), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-search-bg: {{VALUE}};', ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_search_border', [ 'label' => $this->get_pro_label(esc_html__('Border Color', 'king-addons')), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-search-border: {{VALUE}};', ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_search_text_color', [ 'label' => $this->get_pro_label(esc_html__('Text Color', 'king-addons')), 'type' => Controls_Manager::COLOR, 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards' => '--kng-cmc-search-text: {{VALUE}};', ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_group_control( Group_Control_Typography::get_type(), [ 'name' => 'kng_search_typography', 'selector' => '{{WRAPPER}} .king-addons-comparison-matrix-cards__search-input', 'classes' => $this->get_pro_control_class(), ] ); $this->add_control( 'kng_search_radius', [ 'label' => $this->get_pro_label(esc_html__('Border Radius', 'king-addons')), 'type' => Controls_Manager::SLIDER, 'size_units' => ['px', '%'], 'range' => [ 'px' => ['min' => 0, 'max' => 40], '%' => ['min' => 0, 'max' => 100], ], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__search-input' => 'border-radius: {{SIZE}}{{UNIT}};', ], 'classes' => $this->get_pro_control_class(), ] ); $this->add_responsive_control( 'kng_search_padding', [ 'label' => $this->get_pro_label(esc_html__('Padding', 'king-addons')), 'type' => Controls_Manager::DIMENSIONS, 'size_units' => ['px', 'em'], 'selectors' => [ '{{WRAPPER}} .king-addons-comparison-matrix-cards__search-input' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};', ], 'classes' => $this->get_pro_control_class(), ] ); $this->end_controls_section(); } /** * Render premium upgrade notice. */ public function register_pro_notice_controls(): void { if (!$this->can_use_pro()) { Core::renderProFeaturesSection($this, '', Controls_Manager::RAW_HTML, 'comparison-matrix-cards', [ 'Highlight differences modes and visitor toggle', 'Sticky header inside widget', 'Dynamic data sources (ACF, WooCommerce)', 'Feature search and filtering', ]); } } /** * Add per-plan feature value controls. * * @param Repeater $repeater Repeater instance. * @param int $index Plan index. * @param string $label Label. * @param array $condition Optional condition. * @param string $classes Optional classes. */ protected function add_feature_value_controls(Repeater $repeater, int $index, string $label, array $condition = [], string $classes = ''): void { $type_key = 'kng_feature_value_' . $index . '_type'; $text_key = 'kng_feature_value_' . $index . '_text'; $type_control = [ 'label' => $label . ' ' . esc_html__('Value Type', 'king-addons'), 'type' => Controls_Manager::SELECT, 'default' => 'included', 'options' => [ 'included' => esc_html__('Included', 'king-addons'), 'excluded' => esc_html__('Excluded', 'king-addons'), 'limited' => esc_html__('Limited', 'king-addons'), 'text' => esc_html__('Text', 'king-addons'), ], 'separator' => 'before', ]; if (!empty($condition)) { $type_control['condition'] = $condition; } if ($classes !== '') { $type_control['classes'] = $classes; } $repeater->add_control($type_key, $type_control); $text_condition = [ $type_key => 'text', ]; if (!empty($condition)) { $text_condition = array_merge($text_condition, $condition); } $text_control = [ 'label' => $label . ' ' . esc_html__('Text', 'king-addons'), 'type' => Controls_Manager::TEXT, 'default' => '', 'condition' => $text_condition, ]; if ($classes !== '') { $text_control['classes'] = $classes; } $repeater->add_control($text_key, $text_control); } /** * Build render context. * * @param array $settings Settings. * @param int $plan_count Plan count. * * @return array */ protected function get_render_context(array $settings, int $plan_count): array { $can_pro = $this->can_use_pro(); $highlight_enabled = $can_pro && (($settings['kng_highlight_enable'] ?? '') === 'yes'); $search_enabled = $can_pro && (($settings['kng_search_enable'] ?? '') === 'yes'); $sticky_enabled = $can_pro && (($settings['kng_sticky_enable'] ?? '') === 'yes'); return [ 'plan_count' => $plan_count, 'preset' => $settings['kng_preset'] ?? 'minimal', 'mobile_layout' => $settings['kng_mobile_layout'] ?? 'stack', 'equal_height' => ($settings['kng_equal_height'] ?? '') === 'yes', 'hide_scrollbar' => ($settings['kng_hide_scrollbar'] ?? '') === 'yes', 'highlight_enabled' => $highlight_enabled, 'highlight_mode' => $settings['kng_highlight_mode'] ?? 'dim', 'highlight_compare' => $settings['kng_highlight_compare'] ?? 'normalized', 'highlight_style' => $settings['kng_highlight_style'] ?? 'background', 'highlight_default' => ($settings['kng_highlight_default'] ?? '') === 'yes', 'highlight_toggle' => $highlight_enabled && (($settings['kng_highlight_toggle'] ?? '') === 'yes'), 'highlight_label' => $settings['kng_highlight_toggle_label'] ?? esc_html__('Highlight differences', 'king-addons'), 'search_enabled' => $search_enabled, 'search_placeholder' => $settings['kng_search_placeholder'] ?? esc_html__('Search features', 'king-addons'), 'search_tooltip' => ($settings['kng_search_includes_tooltip'] ?? '') === 'yes', 'sticky_enabled' => $sticky_enabled, 'sticky_shadow' => ($settings['kng_sticky_shadow'] ?? '') === 'yes', 'sticky_mobile_mode' => $settings['kng_sticky_mobile_mode'] ?? 'compact', ]; } /** * Build wrapper classes. * * @param array $settings Settings. * @param array $context Context. * * @return array */ protected function get_wrapper_classes(array $settings, array $context): array { $classes = [ 'king-addons-comparison-matrix-cards', 'king-addons-comparison-matrix-cards--preset-' . ($context['preset'] ?? 'minimal'), 'king-addons-comparison-matrix-cards--mobile-' . ($context['mobile_layout'] ?? 'stack'), ]; if (!empty($context['equal_height'])) { $classes[] = 'king-addons-comparison-matrix-cards--equal-height'; } if (!empty($context['hide_scrollbar'])) { $classes[] = 'king-addons-comparison-matrix-cards--hide-scrollbar'; } if (!empty($context['highlight_enabled'])) { $classes[] = 'is-highlight-enabled'; $classes[] = 'is-highlight-mode-' . ($context['highlight_mode'] ?? 'dim'); $classes[] = 'is-highlight-style-' . ($context['highlight_style'] ?? 'background'); } if (!empty($context['search_enabled'])) { $classes[] = 'has-search'; } if (!empty($context['sticky_enabled'])) { $classes[] = 'is-sticky-enabled'; if (!empty($context['sticky_shadow'])) { $classes[] = 'has-sticky-shadow'; } $mobile_mode = $context['sticky_mobile_mode'] ?? 'compact'; if ($mobile_mode === 'off') { $classes[] = 'is-sticky-mobile-off'; } elseif ($mobile_mode === 'compact') { $classes[] = 'is-sticky-compact'; } } unset($settings); return $classes; } /** * Build wrapper attributes. * * @param array $settings Settings. * @param array $context Context. * * @return string */ protected function get_wrapper_attributes(array $settings, array $context): string { $columns_setting = isset($settings['kng_columns']) ? (int) $settings['kng_columns'] : 3; $columns_setting = max(1, min($columns_setting, $this->can_use_pro() ? 6 : 3)); $plan_count = (int) ($context['plan_count'] ?? 0); $columns = $plan_count > 0 ? min($columns_setting, $plan_count) : $columns_setting; $attributes = [ 'data-widget-id' => $this->get_id(), 'data-plan-count' => (string) ($context['plan_count'] ?? 0), 'data-mobile-layout' => (string) ($context['mobile_layout'] ?? 'stack'), 'data-highlight-enable' => !empty($context['highlight_enabled']) ? 'yes' : 'no', 'data-highlight-mode' => (string) ($context['highlight_mode'] ?? 'dim'), 'data-highlight-compare' => (string) ($context['highlight_compare'] ?? 'normalized'), 'data-highlight-style' => (string) ($context['highlight_style'] ?? 'background'), 'data-highlight-default' => !empty($context['highlight_default']) ? 'yes' : 'no', 'data-highlight-toggle' => !empty($context['highlight_toggle']) ? 'yes' : 'no', 'data-search-enable' => !empty($context['search_enabled']) ? 'yes' : 'no', 'data-search-tooltip' => !empty($context['search_tooltip']) ? 'yes' : 'no', 'data-sticky-enable' => !empty($context['sticky_enabled']) ? 'yes' : 'no', 'data-sticky-shadow' => !empty($context['sticky_shadow']) ? 'yes' : 'no', 'style' => '--kng-cmc-columns: ' . $columns . ';', ]; $output = []; foreach ($attributes as $key => $value) { $output[] = esc_attr($key) . '="' . esc_attr($value) . '"'; } if (!empty($settings['kng_sticky_offset']['size'])) { $output[] = 'data-sticky-offset="' . esc_attr((string) $settings['kng_sticky_offset']['size']) . '"'; } return $output ? ' ' . implode(' ', $output) : ''; } /** * Render controls bar (search + toggle). * * @param array $context Context. */ protected function render_controls_bar(array $context): void { $has_search = !empty($context['search_enabled']); $has_toggle = !empty($context['highlight_toggle']); if (!$has_search && !$has_toggle) { return; } ?>
$plan Plan data. * @param array> $features Feature list. * @param int $index Plan index starting at 0. */ protected function render_card(array $plan, array $features, int $index): void { $badge = trim((string) ($plan['badge'] ?? '')); $title = trim((string) ($plan['name'] ?? '')); $description = trim((string) ($plan['description'] ?? '')); $price = $plan['price'] ?? ''; $subtitle = trim((string) ($plan['subtitle'] ?? '')); $footer_note = trim((string) ($plan['footer_note'] ?? '')); $button_label = trim((string) ($plan['cta_label'] ?? '')); $button_link = $plan['cta_link'] ?? []; $button_attributes = $this->get_link_attributes($button_link); ?>

>
    render_feature_rows($features, $index); ?>
> $features Feature list. * @param int $index Plan index. */ protected function render_feature_rows(array $features, int $index): void { $previous_group = ''; foreach ($features as $feature) { $label = trim((string) ($feature['label'] ?? '')); $tooltip = trim((string) ($feature['tooltip'] ?? '')); $group = trim((string) ($feature['group'] ?? '')); $feature_id = (string) ($feature['id'] ?? $label); if ($group !== '' && $group !== $previous_group) { $previous_group = $group; ?> 'excluded', 'text' => '', ]; $value_type = $value['type'] ?? 'excluded'; $value_text = $value['text'] ?? ''; $item_attributes = $this->render_attributes([ 'data-feature-id' => $feature_id, 'data-feature-label' => $label, 'data-feature-tooltip' => $tooltip, 'data-feature-group' => $group, 'data-value-type' => $value_type, 'data-value-text' => $value_text, ]); ?>
  • >
    get_tooltip_id($feature_id); ?> render_tooltip_icon(); ?>
    render_feature_icon($value_type); ?>
    • get_id() . '-tooltip-' . $feature_id; } /** * Build link attributes string. * * @param array $link Link data. * * @return string */ protected function get_link_attributes(array $link): string { if (empty($link['url'])) { return ''; } $attributes = [ 'href' => esc_url($link['url']), 'target' => !empty($link['is_external']) ? '_blank' : '_self', ]; $rel = []; if (!empty($link['nofollow'])) { $rel[] = 'nofollow'; } if (!empty($link['is_external'])) { $rel[] = 'noopener'; } if ($rel) { $attributes['rel'] = implode(' ', array_unique($rel)); } return $this->render_attributes($attributes); } /** * Render attributes array to HTML string. * * @param array $attributes Attributes. * * @return string */ protected function render_attributes(array $attributes): string { $output = []; foreach ($attributes as $key => $value) { if ($value === '') { continue; } $output[] = esc_attr($key) . '="' . esc_attr($value) . '"'; } return implode(' ', $output); } /** * Build render data based on source. * * @param array $settings Settings. * * @return array */ protected function get_render_data(array $settings): array { $source = $settings['kng_data_source'] ?? 'manual'; $can_pro = $this->can_use_pro(); if ($source !== 'manual' && !$can_pro) { return [ 'plans' => [], 'features' => [], 'pro_locked' => true, ]; } if ($source === 'acf') { return $this->get_acf_data($settings); } if ($source === 'woo') { return $this->get_woo_data($settings); } return $this->get_manual_data($settings); } /** * Get manual data. * * @param array $settings Settings. * * @return array */ protected function get_manual_data(array $settings): array { $plans = $this->get_manual_plans($settings); $features = []; $feature_rows = $settings['kng_features'] ?? []; if (!is_array($feature_rows)) { $feature_rows = []; } foreach ($feature_rows as $feature_row) { $label = trim((string) ($feature_row['kng_feature_label'] ?? '')); if ($label === '') { continue; } $values = []; for ($i = 1; $i <= count($plans); $i++) { $values[] = $this->get_feature_value($feature_row, $i); } $features[] = [ 'id' => (string) ($feature_row['_id'] ?? sanitize_title($label)), 'label' => $label, 'tooltip' => trim((string) ($feature_row['kng_feature_tooltip'] ?? '')), 'group' => trim((string) ($feature_row['kng_feature_group'] ?? '')), 'values' => $values, ]; } return [ 'plans' => $plans, 'features' => $features, ]; } /** * Get manual plans list. * * @param array $settings Settings. * * @return array> */ protected function get_manual_plans(array $settings): array { $plans = $settings['kng_plans'] ?? []; if (!is_array($plans)) { return []; } $limit = isset($settings['kng_plans_count']) ? (int) $settings['kng_plans_count'] : 3; $limit = max(2, min(6, $limit)); if (!$this->can_use_pro()) { $limit = min(3, $limit); } $plans = array_slice($plans, 0, $limit); $normalized = []; foreach ($plans as $plan) { $link = $plan['kng_plan_cta_link'] ?? []; $normalized[] = [ 'name' => $plan['kng_plan_name'] ?? '', 'badge' => $plan['kng_plan_badge'] ?? '', 'description' => $plan['kng_plan_description'] ?? '', 'price' => $plan['kng_plan_price'] ?? '', 'subtitle' => $plan['kng_plan_subtitle'] ?? '', 'cta_label' => $plan['kng_plan_cta_label'] ?? '', 'cta_link' => $this->normalize_link($link, $plan['kng_plan_cta_label'] ?? ''), 'footer_note' => $plan['kng_plan_footer_note'] ?? '', ]; } return $normalized; } /** * Get ACF data. * * @param array $settings Settings. * * @return array */ protected function get_acf_data(array $settings): array { if (!function_exists('get_field')) { return [ 'plans' => [], 'features' => [], ]; } $post_id = $this->resolve_acf_post_id($settings); $plans_key = trim((string) ($settings['kng_acf_plans_repeater'] ?? '')); if ($plans_key === '') { return [ 'plans' => [], 'features' => [], ]; } $rows = get_field($plans_key, $post_id); if (!is_array($rows)) { return [ 'plans' => [], 'features' => [], ]; } $limit = $this->get_max_plans_limit($settings); $rows = array_slice($rows, 0, $limit); $plans = []; $features_map = []; $feature_order = []; $feature_repeater = trim((string) ($settings['kng_acf_plan_features_repeater'] ?? '')); $label_field = trim((string) ($settings['kng_acf_feature_label_field'] ?? '')); $value_field = trim((string) ($settings['kng_acf_feature_value_field'] ?? '')); $type_field = trim((string) ($settings['kng_acf_feature_value_type_field'] ?? '')); $tooltip_field = trim((string) ($settings['kng_acf_feature_tooltip_field'] ?? '')); $group_field = trim((string) ($settings['kng_acf_feature_group_field'] ?? '')); foreach ($rows as $plan_index => $row) { if (!is_array($row)) { continue; } $plans[] = $this->map_acf_plan($row, $settings); if ($feature_repeater === '' || $label_field === '' || $value_field === '') { continue; } $feature_rows = $row[$feature_repeater] ?? []; if (!is_array($feature_rows)) { continue; } foreach ($feature_rows as $feature_row) { if (!is_array($feature_row)) { continue; } $label = trim((string) ($feature_row[$label_field] ?? '')); if ($label === '') { continue; } $group_value = $group_field ? (string) ($feature_row[$group_field] ?? '') : ''; $key_base = $group_value !== '' ? $group_value . '-' . $label : $label; $key = sanitize_title($key_base); if ($key === '') { $key = 'feature-' . md5($key_base); } if (!isset($features_map[$key])) { $features_map[$key] = [ 'id' => $key, 'label' => $label, 'tooltip' => $tooltip_field ? (string) ($feature_row[$tooltip_field] ?? '') : '', 'group' => $group_value, 'values' => [], ]; $feature_order[] = $key; } $type_override = $type_field ? (string) ($feature_row[$type_field] ?? '') : ''; $value = $this->normalize_feature_value($feature_row[$value_field] ?? '', $type_override); $features_map[$key]['values'][$plan_index] = $value; } } $features = []; foreach ($feature_order as $key) { $feature = $features_map[$key]; $feature['values'] = $this->fill_feature_values($feature['values'], count($plans)); $features[] = $feature; } return [ 'plans' => $plans, 'features' => $features, ]; } /** * Resolve ACF post ID. * * @param array $settings Settings. * * @return int */ protected function resolve_acf_post_id(array $settings): int { if (($settings['kng_acf_post_source'] ?? 'current') === 'custom') { return max(1, (int) ($settings['kng_acf_post_id'] ?? 0)); } return (int) get_the_ID(); } /** * Map ACF plan row to plan data. * * @param array $row Plan row. * @param array $settings Settings. * * @return array */ protected function map_acf_plan(array $row, array $settings): array { $name_field = trim((string) ($settings['kng_acf_plan_name_field'] ?? '')); $badge_field = trim((string) ($settings['kng_acf_plan_badge_field'] ?? '')); $desc_field = trim((string) ($settings['kng_acf_plan_description_field'] ?? '')); $price_field = trim((string) ($settings['kng_acf_plan_price_field'] ?? '')); $subtitle_field = trim((string) ($settings['kng_acf_plan_subtitle_field'] ?? '')); $cta_label_field = trim((string) ($settings['kng_acf_plan_cta_label_field'] ?? '')); $cta_link_field = trim((string) ($settings['kng_acf_plan_cta_link_field'] ?? '')); $footer_field = trim((string) ($settings['kng_acf_plan_footer_field'] ?? '')); $cta_label = $cta_label_field ? (string) ($row[$cta_label_field] ?? '') : ''; $cta_link = $cta_link_field ? ($row[$cta_link_field] ?? []) : []; $link = $this->normalize_link($cta_link, $cta_label); return [ 'name' => $name_field ? (string) ($row[$name_field] ?? '') : '', 'badge' => $badge_field ? (string) ($row[$badge_field] ?? '') : '', 'description' => $desc_field ? (string) ($row[$desc_field] ?? '') : '', 'price' => $price_field ? (string) ($row[$price_field] ?? '') : '', 'subtitle' => $subtitle_field ? (string) ($row[$subtitle_field] ?? '') : '', 'cta_label' => $cta_label !== '' ? $cta_label : ($link['title'] ?? ''), 'cta_link' => $link, 'footer_note' => $footer_field ? (string) ($row[$footer_field] ?? '') : '', ]; } /** * Get WooCommerce data. * * @param array $settings Settings. * * @return array */ protected function get_woo_data(array $settings): array { if (!class_exists('WooCommerce') || !function_exists('wc_get_product')) { return [ 'plans' => [], 'features' => [], ]; } if (($settings['kng_woo_compare_variations'] ?? '') === 'yes') { $variation_data = $this->get_woo_variations_data($settings); if (!empty($variation_data['plans'])) { return $variation_data; } } $products = $this->get_woo_products($settings); if (count($products) < 2) { return [ 'plans' => [], 'features' => [], ]; } $plans = []; foreach ($products as $product) { $plans[] = $this->map_woo_plan($product, $settings); } $features = $this->get_woo_features($products, $settings); return [ 'plans' => $plans, 'features' => $features, ]; } /** * Get WooCommerce products. * * @param array $settings Settings. * * @return array */ protected function get_woo_products(array $settings): array { $source = $settings['kng_woo_products_source'] ?? 'manual'; $limit = $this->get_max_plans_limit($settings, 'kng_woo_products_limit'); $products = []; if ($source === 'manual') { $ids = $settings['kng_woo_products'] ?? []; if (!is_array($ids)) { $ids = []; } foreach ($ids as $id) { $product = wc_get_product((int) $id); if ($product) { $products[] = $product; } } } else { $current_id = (int) get_the_ID(); $current_product = $current_id ? wc_get_product($current_id) : null; $ids = []; if ($current_product) { if ($source === 'related') { $ids = wc_get_related_products($current_id, $limit); } elseif ($source === 'upsell') { $ids = $current_product->get_upsell_ids(); } elseif ($source === 'cross_sell') { $ids = $current_product->get_cross_sell_ids(); } } $ids = array_slice(array_filter(array_map('intval', $ids)), 0, $limit); foreach ($ids as $id) { $product = wc_get_product($id); if ($product) { $products[] = $product; } } } return array_slice($products, 0, $limit); } /** * Get WooCommerce variations data for a single variable product. * * @param array $settings Settings. * * @return array */ protected function get_woo_variations_data(array $settings): array { $ids = $settings['kng_woo_products'] ?? []; if (!is_array($ids) || empty($ids)) { return [ 'plans' => [], 'features' => [], ]; } $ids = array_values(array_filter(array_map('intval', $ids))); if (empty($ids)) { return [ 'plans' => [], 'features' => [], ]; } $product_id = (int) $ids[0]; $product = $product_id ? wc_get_product($product_id) : null; if (!$product || !$product->is_type('variable')) { return [ 'plans' => [], 'features' => [], ]; } $limit = $this->get_max_plans_limit($settings, 'kng_woo_products_limit'); $variation_ids = array_slice($product->get_children(), 0, $limit); $variations = []; foreach ($variation_ids as $variation_id) { $variation = wc_get_product((int) $variation_id); if ($variation) { $variations[] = $variation; } } if (count($variations) < 2) { return [ 'plans' => [], 'features' => [], ]; } $plans = []; foreach ($variations as $variation) { $plans[] = $this->map_woo_variation_plan($variation, $product, $settings); } return [ 'plans' => $plans, 'features' => $this->get_woo_features($variations, $settings), ]; } /** * Map WooCommerce product to plan data. * * @param WC_Product $product Product. * @param array $settings Settings. * * @return array */ protected function map_woo_plan(WC_Product $product, array $settings): array { $show_price = ($settings['kng_woo_show_price'] ?? '') === 'yes'; $cta_mode = $settings['kng_woo_cta_mode'] ?? 'product'; $cta_label = $settings['kng_woo_cta_label'] ?? esc_html__('View Product', 'king-addons'); $link = [ 'url' => '', 'is_external' => false, 'nofollow' => false, 'title' => '', ]; if ($cta_mode === 'add_to_cart') { $link['url'] = $product->add_to_cart_url(); } else { $link['url'] = get_permalink($product->get_id()); } return [ 'name' => $product->get_name(), 'badge' => '', 'description' => '', 'price' => $show_price ? $product->get_price_html() : '', 'subtitle' => '', 'cta_label' => $cta_label, 'cta_link' => $link, 'footer_note' => '', ]; } /** * Map WooCommerce variation to plan data. * * @param WC_Product $variation Variation product. * @param WC_Product $parent Parent product. * @param array $settings Settings. * * @return array */ protected function map_woo_variation_plan(WC_Product $variation, WC_Product $parent, array $settings): array { $show_price = ($settings['kng_woo_show_price'] ?? '') === 'yes'; $cta_mode = $settings['kng_woo_cta_mode'] ?? 'product'; $cta_label = $settings['kng_woo_cta_label'] ?? esc_html__('View Product', 'king-addons'); $name_mode = $settings['kng_woo_variation_title_mode'] ?? 'full'; $subtitle_mode = $settings['kng_woo_variation_subtitle_mode'] ?? 'none'; $link = [ 'url' => '', 'is_external' => false, 'nofollow' => false, 'title' => '', ]; if ($cta_mode === 'add_to_cart') { $link['url'] = $variation->add_to_cart_url(); } else { $link['url'] = $this->get_variation_permalink($variation, $parent); } $parent_name = $parent->get_name(); $variation_name = $variation->get_formatted_name(); if ($variation_name === '') { $variation_name = $parent_name; } $variation_attributes = $this->format_variation_attributes($variation); $name = $variation_name; if ($name_mode === 'attributes') { $name = $variation_attributes !== '' ? $variation_attributes : $parent_name; } elseif ($name_mode === 'parent') { $name = $parent_name; } $subtitle = ''; if ($subtitle_mode === 'attributes') { $subtitle = $variation_attributes; } if ($subtitle !== '' && $subtitle === $name) { $subtitle = ''; } return [ 'name' => $name, 'badge' => '', 'description' => '', 'price' => $show_price ? $variation->get_price_html() : '', 'subtitle' => $subtitle, 'cta_label' => $cta_label, 'cta_link' => $link, 'footer_note' => '', ]; } /** * Build variation permalink with preselected attributes. * * @param WC_Product $variation Variation product. * @param WC_Product $parent Parent product. * * @return string */ protected function get_variation_permalink(WC_Product $variation, WC_Product $parent): string { $permalink = get_permalink($parent->get_id()); if (!$permalink) { return ''; } if (!method_exists($variation, 'get_variation_attributes')) { return $permalink; } $attributes = $variation->get_variation_attributes(); if (!is_array($attributes) || empty($attributes)) { return $permalink; } $query_args = []; foreach ($attributes as $key => $value) { $value = is_array($value) ? implode(', ', $value) : (string) $value; if ($value === '') { continue; } $query_args[(string) $key] = $value; } if (empty($query_args)) { return $permalink; } $query_args['variation_id'] = (string) $variation->get_id(); return add_query_arg($query_args, $permalink); } /** * Format variation attributes for labels or subtitles. * * @param WC_Product $variation Variation product. * * @return string */ protected function format_variation_attributes(WC_Product $variation): string { if (!method_exists($variation, 'get_variation_attributes')) { return ''; } $attributes = $variation->get_variation_attributes(); if (!is_array($attributes) || empty($attributes)) { return ''; } $parts = []; foreach ($attributes as $key => $value) { $value = is_array($value) ? implode(', ', $value) : (string) $value; if ($value === '') { continue; } $taxonomy = str_replace('attribute_', '', (string) $key); $label = ''; if ($taxonomy !== '') { if (function_exists('wc_attribute_label')) { $label = wc_attribute_label($taxonomy); } if ($label === '') { $label = ucwords(str_replace(['pa_', '-', '_'], ' ', $taxonomy)); } } $value_label = $value; if ($taxonomy !== '' && taxonomy_exists($taxonomy)) { $term = get_term_by('slug', $value, $taxonomy); if ($term && !is_wp_error($term)) { $value_label = $term->name; } } if ($label !== '') { $parts[] = $label . ': ' . $value_label; } else { $parts[] = $value_label; } } return implode(', ', $parts); } /** * Build feature list from WooCommerce attributes. * * @param array $products Products. * @param array $settings Settings. * * @return array> */ protected function get_woo_features(array $products, array $settings): array { $attributes = $settings['kng_woo_attributes'] ?? []; if (!is_array($attributes)) { return []; } $features = []; foreach ($attributes as $attribute) { $slug = trim((string) ($attribute['kng_woo_attr_slug'] ?? '')); if ($slug === '') { continue; } $label_override = trim((string) ($attribute['kng_woo_attr_label'] ?? '')); $label = $label_override; if ($label === '') { if (function_exists('wc_attribute_label')) { $label = wc_attribute_label($slug); } else { $label = $slug; } } $group = trim((string) ($attribute['kng_woo_attr_group'] ?? '')); $tooltip = trim((string) ($attribute['kng_woo_attr_tooltip'] ?? '')); $fallback = trim((string) ($attribute['kng_woo_attr_fallback'] ?? '')); $id_base = $group !== '' ? $group . '-' . $slug : $slug; $feature_id = sanitize_title($id_base); if ($feature_id === '') { $feature_id = 'feature-' . md5($id_base); } $values = []; foreach ($products as $product) { $raw = $this->get_product_attribute_value($product, $slug, $fallback); $values[] = $this->normalize_feature_value($raw); } $features[] = [ 'id' => $feature_id, 'label' => $label, 'tooltip' => $tooltip, 'group' => $group, 'values' => $values, ]; } return $features; } /** * Get product attribute value with fallback. * * @param WC_Product $product Product. * @param string $slug Attribute slug. * @param string $fallback Fallback meta key. * * @return mixed */ protected function get_product_attribute_value(WC_Product $product, string $slug, string $fallback) { $value = ''; if (taxonomy_exists($slug) && !$product->is_type('variation')) { $terms = wc_get_product_terms($product->get_id(), $slug, ['fields' => 'names']); if (!empty($terms) && is_array($terms)) { $value = implode(', ', $terms); } } else { $value = $product->get_attribute($slug); } if ($value === '' && $product->is_type('variation')) { $parent = wc_get_product($product->get_parent_id()); if ($parent) { if (taxonomy_exists($slug)) { $terms = wc_get_product_terms($parent->get_id(), $slug, ['fields' => 'names']); if (!empty($terms) && is_array($terms)) { $value = implode(', ', $terms); } } else { $value = $parent->get_attribute($slug); } } } if ($value === '' && $fallback !== '') { $meta_value = get_post_meta($product->get_id(), $fallback, true); if ($meta_value !== '') { $value = $meta_value; } } return $value; } /** * Normalize feature value for rendering. * * @param mixed $value Raw value. * @param string $type_override Optional type. * * @return array{type: string, text: string} */ protected function normalize_feature_value($value, string $type_override = ''): array { $type_override = strtolower(trim($type_override)); if ($type_override !== '') { $type_override = $this->sanitize_feature_type($type_override); } if ($type_override !== '') { return [ 'type' => $type_override, 'text' => $type_override === 'text' ? (string) $value : '', ]; } if (is_bool($value)) { return [ 'type' => $value ? 'included' : 'excluded', 'text' => '', ]; } if (is_array($value)) { $value = implode(', ', array_map('strval', $value)); } $value = trim((string) $value); if ($value === '') { return [ 'type' => 'excluded', 'text' => '', ]; } $normalized = strtolower($value); $included_values = ['yes', 'true', 'included', 'available', 'check']; $excluded_values = ['no', 'false', 'excluded', 'not available', 'x', '-']; $limited_values = ['limited', 'partial', 'some']; if (in_array($normalized, $included_values, true)) { return [ 'type' => 'included', 'text' => '', ]; } if (in_array($normalized, $excluded_values, true)) { return [ 'type' => 'excluded', 'text' => '', ]; } if (in_array($normalized, $limited_values, true)) { return [ 'type' => 'limited', 'text' => '', ]; } return [ 'type' => 'text', 'text' => $value, ]; } /** * Sanitize feature type. * * @param string $type Type. * * @return string */ protected function sanitize_feature_type(string $type): string { $allowed = ['included', 'excluded', 'limited', 'text']; return in_array($type, $allowed, true) ? $type : ''; } /** * Get manual feature value for plan index. * * @param array $feature Feature data. * @param int $index Plan index (1-based). * * @return array{type: string, text: string} */ protected function get_feature_value(array $feature, int $index): array { $type_key = 'kng_feature_value_' . $index . '_type'; $text_key = 'kng_feature_value_' . $index . '_text'; $type = (string) ($feature[$type_key] ?? 'excluded'); $type = in_array($type, ['included', 'excluded', 'limited', 'text'], true) ? $type : 'excluded'; $text = trim((string) ($feature[$text_key] ?? '')); return [ 'type' => $type, 'text' => $text, ]; } /** * Fill missing feature values with defaults. * * @param array $values Values. * @param int $count Plan count. * * @return array */ protected function fill_feature_values(array $values, int $count): array { for ($i = 0; $i < $count; $i++) { if (!isset($values[$i])) { $values[$i] = [ 'type' => 'excluded', 'text' => '', ]; } } ksort($values); return array_values($values); } /** * Normalize link data. * * @param mixed $link Link data. * @param string $label_fallback Label fallback. * * @return array */ protected function normalize_link($link, string $label_fallback = ''): array { if (is_string($link)) { $link = [ 'url' => $link, ]; } if (!is_array($link)) { $link = []; } return [ 'url' => $link['url'] ?? '', 'is_external' => !empty($link['target']) || !empty($link['is_external']), 'nofollow' => !empty($link['nofollow']), 'title' => $link['title'] ?? $label_fallback, ]; } /** * Get max plan limit based on settings. * * @param array $settings Settings. * @param string $key Optional key. * * @return int */ protected function get_max_plans_limit(array $settings, string $key = 'kng_max_plans'): int { $limit = isset($settings[$key]) ? (int) $settings[$key] : 4; $limit = max(2, min(8, $limit)); if (!$this->can_use_pro()) { $limit = min(3, $limit); } return $limit; } /** * Check if we are in Elementor editor mode. */ protected function is_editor_mode(): bool { return class_exists(Plugin::class) && Plugin::$instance->editor->is_edit_mode(); } /** * Check if Pro is available. */ protected function can_use_pro(): bool { return function_exists('king_addons_can_use_pro') && king_addons_can_use_pro(); } /** * Get Pro label helper. * * @param string $label Label. * * @return string */ protected function get_pro_label(string $label): string { if ($this->can_use_pro()) { return $label; } return $label . ' '; } /** * Get pro control class helper. */ protected function get_pro_control_class(): string { return $this->can_use_pro() ? '' : 'king-addons-pro-control'; } }