<?php
/**
 * A1 Tools Team Elementor Widget
 *
 * Displays team members in a grid or list layout with photos, roles, bios,
 * contact information, and certifications. Supports responsive column layouts
 * and featured-only filtering. Data comes from the a1tools_shortcode_team()
 * shortcode function.
 *
 * @package A1_Tools
 * @since   1.9.0
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class A1Tools_Team_Elementor_Widget
 */
class A1Tools_Team_Elementor_Widget extends \Elementor\Widget_Base {

	/**
	 * Get widget name.
	 */
	public function get_name() {
		return 'a1tools_team';
	}

	/**
	 * Get widget title.
	 */
	public function get_title() {
		return __( 'A1 Team', 'a1-tools' );
	}

	/**
	 * Get widget icon.
	 */
	public function get_icon() {
		return 'eicon-person';
	}

	/**
	 * Get widget categories.
	 */
	public function get_categories() {
		return array( 'general' );
	}

	/**
	 * Get widget keywords.
	 */
	public function get_keywords() {
		return array( 'team', 'staff', 'member', 'people', 'a1' );
	}

	/**
	 * Register widget controls.
	 */
	protected function register_controls() {
		// ── Content Tab ─────────────────────────────────────────────
		$this->start_controls_section(
			'content_section',
			array(
				'label' => __( 'Content', 'a1-tools' ),
				'tab'   => \Elementor\Controls_Manager::TAB_CONTENT,
			)
		);

		// Layout.
		$this->add_control(
			'layout',
			array(
				'label'   => __( 'Layout', 'a1-tools' ),
				'type'    => \Elementor\Controls_Manager::SELECT,
				'default' => 'grid',
				'options' => array(
					'grid' => __( 'Grid', 'a1-tools' ),
					'list' => __( 'List', 'a1-tools' ),
				),
			)
		);

		// Columns count.
		$this->add_responsive_control(
			'columns',
			array(
				'label'     => __( 'Columns', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::NUMBER,
				'min'       => 1,
				'max'       => 6,
				'default'   => 3,
				'condition' => array( 'layout' => 'grid' ),
				'selectors' => array(
					'{{WRAPPER}} .a1tools-team-grid' => 'grid-template-columns: repeat({{VALUE}}, 1fr) !important;',
				),
			)
		);

		// Show photo.
		$this->add_control(
			'show_photo',
			array(
				'label'        => __( 'Show Photo', 'a1-tools' ),
				'type'         => \Elementor\Controls_Manager::SWITCHER,
				'label_on'     => __( 'Yes', 'a1-tools' ),
				'label_off'    => __( 'No', 'a1-tools' ),
				'return_value' => 'yes',
				'default'      => 'yes',
			)
		);

		// Photo shape.
		$this->add_control(
			'photo_shape',
			array(
				'label'     => __( 'Photo Shape', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::SELECT,
				'default'   => 'circle',
				'options'   => array(
					'circle' => __( 'Circle', 'a1-tools' ),
					'square' => __( 'Square (Fill Card)', 'a1-tools' ),
				),
				'condition' => array( 'show_photo' => 'yes' ),
			)
		);

		// Show role.
		$this->add_control(
			'show_role',
			array(
				'label'        => __( 'Show Role', 'a1-tools' ),
				'type'         => \Elementor\Controls_Manager::SWITCHER,
				'label_on'     => __( 'Yes', 'a1-tools' ),
				'label_off'    => __( 'No', 'a1-tools' ),
				'return_value' => 'yes',
				'default'      => 'yes',
			)
		);

		// Show bio.
		$this->add_control(
			'show_bio',
			array(
				'label'        => __( 'Show Bio', 'a1-tools' ),
				'type'         => \Elementor\Controls_Manager::SWITCHER,
				'label_on'     => __( 'Yes', 'a1-tools' ),
				'label_off'    => __( 'No', 'a1-tools' ),
				'return_value' => 'yes',
				'default'      => 'yes',
			)
		);

		// Show phone.
		$this->add_control(
			'show_phone',
			array(
				'label'        => __( 'Show Phone', 'a1-tools' ),
				'type'         => \Elementor\Controls_Manager::SWITCHER,
				'label_on'     => __( 'Yes', 'a1-tools' ),
				'label_off'    => __( 'No', 'a1-tools' ),
				'return_value' => 'yes',
				'default'      => '',
			)
		);

		// Show email.
		$this->add_control(
			'show_email',
			array(
				'label'        => __( 'Show Email', 'a1-tools' ),
				'type'         => \Elementor\Controls_Manager::SWITCHER,
				'label_on'     => __( 'Yes', 'a1-tools' ),
				'label_off'    => __( 'No', 'a1-tools' ),
				'return_value' => 'yes',
				'default'      => '',
			)
		);

		// Show certifications.
		$this->add_control(
			'show_certifications',
			array(
				'label'        => __( 'Show Certifications', 'a1-tools' ),
				'type'         => \Elementor\Controls_Manager::SWITCHER,
				'label_on'     => __( 'Yes', 'a1-tools' ),
				'label_off'    => __( 'No', 'a1-tools' ),
				'return_value' => 'yes',
				'default'      => 'yes',
			)
		);

		// Featured only.
		$this->add_control(
			'featured_only',
			array(
				'label'        => __( 'Featured Only', 'a1-tools' ),
				'type'         => \Elementor\Controls_Manager::SWITCHER,
				'label_on'     => __( 'Yes', 'a1-tools' ),
				'label_off'    => __( 'No', 'a1-tools' ),
				'return_value' => 'yes',
				'default'      => '',
			)
		);

		// Category filter.
		$this->add_control(
			'category',
			array(
				'label'       => __( 'Category Filter', 'a1-tools' ),
				'type'        => \Elementor\Controls_Manager::TEXT,
				'placeholder' => __( 'e.g., Management', 'a1-tools' ),
				'description' => __( 'Show only members in this category. Leave blank for all.', 'a1-tools' ),
			)
		);

		// Category order.
		$this->add_control(
			'category_order',
			array(
				'label'       => __( 'Category Order', 'a1-tools' ),
				'type'        => \Elementor\Controls_Manager::TEXT,
				'placeholder' => __( 'Management, Technicians, Office', 'a1-tools' ),
				'description' => __( 'Comma-separated category names in display order. Leave blank for default order.', 'a1-tools' ),
			)
		);

		// Show category headings.
		$this->add_control(
			'show_category_heading',
			array(
				'label'        => __( 'Show Category Headings', 'a1-tools' ),
				'type'         => \Elementor\Controls_Manager::SWITCHER,
				'label_on'     => __( 'Yes', 'a1-tools' ),
				'label_off'    => __( 'No', 'a1-tools' ),
				'return_value' => 'yes',
				'default'      => 'yes',
			)
		);

		$this->end_controls_section();

		// ── Style: Card ────────────────────────────────────────────
		$this->start_controls_section(
			'style_card_section',
			array(
				'label' => __( 'Card', 'a1-tools' ),
				'tab'   => \Elementor\Controls_Manager::TAB_STYLE,
			)
		);

		$this->add_control(
			'card_bg_color',
			array(
				'label'     => __( 'Background Color', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::COLOR,
				'selectors' => array(
					'{{WRAPPER}} .a1tools-team-card' => 'background-color: {{VALUE}};',
				),
			)
		);

		$this->add_group_control(
			\Elementor\Group_Control_Border::get_type(),
			array(
				'name'     => 'card_border',
				'selector' => '{{WRAPPER}} .a1tools-team-card',
			)
		);

		$this->add_control(
			'card_border_radius',
			array(
				'label'      => __( 'Border Radius', 'a1-tools' ),
				'type'       => \Elementor\Controls_Manager::DIMENSIONS,
				'size_units' => array( 'px', '%' ),
				'selectors'  => array(
					'{{WRAPPER}} .a1tools-team-card' => 'border-radius: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
				),
			)
		);

		$this->add_responsive_control(
			'card_padding',
			array(
				'label'      => __( 'Padding', 'a1-tools' ),
				'type'       => \Elementor\Controls_Manager::DIMENSIONS,
				'size_units' => array( 'px', 'em' ),
				'selectors'  => array(
					'{{WRAPPER}} .a1tools-team-card' => 'padding: {{TOP}}{{UNIT}} {{RIGHT}}{{UNIT}} {{BOTTOM}}{{UNIT}} {{LEFT}}{{UNIT}};',
				),
			)
		);

		$this->add_group_control(
			\Elementor\Group_Control_Box_Shadow::get_type(),
			array(
				'name'     => 'card_shadow',
				'selector' => '{{WRAPPER}} .a1tools-team-card',
			)
		);

		$this->end_controls_section();

		// ── Style: Photo ───────────────────────────────────────────
		$this->start_controls_section(
			'style_photo_section',
			array(
				'label' => __( 'Photo', 'a1-tools' ),
				'tab'   => \Elementor\Controls_Manager::TAB_STYLE,
			)
		);

		$this->add_responsive_control(
			'photo_size',
			array(
				'label'     => __( 'Size', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::SLIDER,
				'range'     => array( 'px' => array( 'min' => 40, 'max' => 300 ) ),
				'default'   => array( 'size' => 100, 'unit' => 'px' ),
				'condition' => array( 'photo_shape' => 'circle' ),
				'selectors' => array(
					'{{WRAPPER}} .a1tools-team-photo--circle' => 'width: {{SIZE}}{{UNIT}}; height: {{SIZE}}{{UNIT}};',
				),
			)
		);

		$this->add_responsive_control(
			'photo_height',
			array(
				'label'     => __( 'Height', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::SLIDER,
				'range'     => array( 'px' => array( 'min' => 80, 'max' => 400 ) ),
				'default'   => array( 'size' => 200, 'unit' => 'px' ),
				'condition' => array( 'photo_shape' => 'square' ),
				'selectors' => array(
					'{{WRAPPER}} .a1tools-team-photo--square' => 'height: {{SIZE}}{{UNIT}};',
				),
			)
		);

		$this->add_group_control(
			\Elementor\Group_Control_Border::get_type(),
			array(
				'name'     => 'photo_border',
				'selector' => '{{WRAPPER}} .a1tools-team-photo',
			)
		);

		$this->end_controls_section();

		// ── Style: Name ────────────────────────────────────────────
		$this->start_controls_section(
			'style_name_section',
			array(
				'label' => __( 'Name', 'a1-tools' ),
				'tab'   => \Elementor\Controls_Manager::TAB_STYLE,
			)
		);

		$this->add_group_control(
			\Elementor\Group_Control_Typography::get_type(),
			array(
				'name'     => 'name_typography',
				'selector' => '{{WRAPPER}} .a1tools-team-name',
			)
		);

		$this->add_control(
			'name_color',
			array(
				'label'     => __( 'Color', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::COLOR,
				'selectors' => array(
					'{{WRAPPER}} .a1tools-team-name' => 'color: {{VALUE}};',
				),
			)
		);

		$this->end_controls_section();

		// ── Style: Role ────────────────────────────────────────────
		$this->start_controls_section(
			'style_role_section',
			array(
				'label' => __( 'Role', 'a1-tools' ),
				'tab'   => \Elementor\Controls_Manager::TAB_STYLE,
			)
		);

		$this->add_group_control(
			\Elementor\Group_Control_Typography::get_type(),
			array(
				'name'     => 'role_typography',
				'selector' => '{{WRAPPER}} .a1tools-team-role',
			)
		);

		$this->add_control(
			'role_color',
			array(
				'label'     => __( 'Color', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::COLOR,
				'selectors' => array(
					'{{WRAPPER}} .a1tools-team-role' => 'color: {{VALUE}};',
				),
			)
		);

		$this->end_controls_section();

		// ── Style: Bio ─────────────────────────────────────────────
		$this->start_controls_section(
			'style_bio_section',
			array(
				'label' => __( 'Bio', 'a1-tools' ),
				'tab'   => \Elementor\Controls_Manager::TAB_STYLE,
			)
		);

		$this->add_group_control(
			\Elementor\Group_Control_Typography::get_type(),
			array(
				'name'     => 'bio_typography',
				'selector' => '{{WRAPPER}} .a1tools-team-bio',
			)
		);

		$this->add_control(
			'bio_color',
			array(
				'label'     => __( 'Color', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::COLOR,
				'selectors' => array(
					'{{WRAPPER}} .a1tools-team-bio' => 'color: {{VALUE}};',
				),
			)
		);

		$this->end_controls_section();

		// ── Style: Column Layout ───────────────────────────────────
		$this->start_controls_section(
			'style_columns_section',
			array(
				'label'     => __( 'Column Layout', 'a1-tools' ),
				'tab'       => \Elementor\Controls_Manager::TAB_STYLE,
				'condition' => array( 'layout' => 'grid' ),
			)
		);

		$this->add_responsive_control(
			'column_gap',
			array(
				'label'     => __( 'Gap', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::SLIDER,
				'range'     => array( 'px' => array( 'min' => 0, 'max' => 60 ) ),
				'default'   => array( 'size' => 20, 'unit' => 'px' ),
				'selectors' => array(
					'{{WRAPPER}} .a1tools-team-grid' => 'gap: {{SIZE}}{{UNIT}};',
				),
			)
		);

		$this->end_controls_section();

		// ── Style: Category Heading ───────────────────────────────
		$this->start_controls_section(
			'style_category_heading_section',
			array(
				'label' => __( 'Category Heading', 'a1-tools' ),
				'tab'   => \Elementor\Controls_Manager::TAB_STYLE,
			)
		);

		$this->add_group_control(
			\Elementor\Group_Control_Typography::get_type(),
			array(
				'name'     => 'category_heading_typography',
				'selector' => '{{WRAPPER}} .a1tools-team-category-heading',
			)
		);

		$this->add_control(
			'category_heading_color',
			array(
				'label'     => __( 'Color', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::COLOR,
				'selectors' => array(
					'{{WRAPPER}} .a1tools-team-category-heading' => 'color: {{VALUE}};',
				),
			)
		);

		$this->add_control(
			'category_heading_border_color',
			array(
				'label'     => __( 'Border Color', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::COLOR,
				'selectors' => array(
					'{{WRAPPER}} .a1tools-team-category-heading' => 'border-bottom-color: {{VALUE}};',
				),
			)
		);

		$this->add_responsive_control(
			'category_heading_spacing',
			array(
				'label'     => __( 'Bottom Spacing', 'a1-tools' ),
				'type'      => \Elementor\Controls_Manager::SLIDER,
				'range'     => array( 'px' => array( 'min' => 0, 'max' => 50 ) ),
				'selectors' => array(
					'{{WRAPPER}} .a1tools-team-category-heading' => 'margin-bottom: {{SIZE}}{{UNIT}};',
				),
			)
		);

		$this->end_controls_section();
	}

	/**
	 * Render widget output on the frontend and in the editor.
	 *
	 * No content_template() is defined so Elementor always uses this PHP render,
	 * which ensures the editor preview shows real data and updates live when
	 * any content control is changed.
	 */
	protected function render() {
		$settings = $this->get_settings_for_display();

		// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- escaped inside shortcode function.
		echo a1tools_shortcode_team(
			array(
				'layout'                => $settings['layout'] ?? 'grid',
				'columns'               => $settings['columns'] ?? '3',
				'show_photo'            => $settings['show_photo'] ?? 'yes',
				'photo_shape'           => $settings['photo_shape'] ?? 'circle',
				'show_role'             => $settings['show_role'] ?? 'yes',
				'show_bio'              => $settings['show_bio'] ?? 'yes',
				'show_phone'            => $settings['show_phone'] ?? '',
				'show_email'            => $settings['show_email'] ?? '',
				'show_certifications'   => $settings['show_certifications'] ?? 'yes',
				'featured_only'         => $settings['featured_only'] ?? '',
				'category'              => $settings['category'] ?? '',
				'category_order'        => $settings['category_order'] ?? '',
				'show_category_heading' => $settings['show_category_heading'] ?? 'yes',
				'_elementor'            => 'yes',
			)
		);
	}
}