<?php
/**
 * Plugin Name:       A1 Tools
 * Plugin URI:        https://tools.a-1chimney.com
 * Description:       Connects your WordPress site to the A1 Tools platform for centralized management of contact information, social media links, and business details.
 * Version:           2.5.10
 * Requires at least: 5.0
 * Requires PHP:      7.4
 * Author:            A1 Chimney
 * Author URI:        https://a-1chimney.com
 * Text Domain:       a1-tools
 * License:           GPLv2 or later
 * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
 */

// Prevent direct file access.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

// Plugin constants.
define( 'A1TOOLS_VERSION', '2.5.10' );
define( 'A1TOOLS_PLUGIN_DIR', plugin_dir_path( __FILE__ ) );
define( 'A1TOOLS_PLUGIN_URL', plugin_dir_url( __FILE__ ) );
define( 'A1TOOLS_DEFAULT_API_URL', 'https://tools.a-1chimney.com/api/website_variables.php' );
define( 'A1TOOLS_CACHE_KEY', 'a1tools_site_variables' );
define( 'A1TOOLS_DEFAULT_CACHE_EXPIRY', 300 ); // 5 minutes default
define( 'A1TOOLS_DEFAULT_STORES_API_URL', 'https://tools.a-1chimney.com/api/group_stores.php' );
define( 'A1TOOLS_STORES_CACHE_KEY', 'a1tools_group_stores' );
define( 'A1TOOLS_DEFAULT_FRANCHISES_API_URL', 'https://tools.a-1chimney.com/api/site_franchises.php' );
define( 'A1TOOLS_FRANCHISES_CACHE_KEY', 'a1tools_site_franchises' );
define( 'A1TOOLS_DEFAULT_CITY_PAGES_API_URL', 'https://tools.a-1chimney.com/api/site_city_pages.php' );
define( 'A1TOOLS_CITY_PAGES_CACHE_KEY', 'a1tools_city_pages' );
define( 'A1TOOLS_DEFAULT_SERVICES_API_URL', 'https://tools.a-1chimney.com/api/site_services.php' );
define( 'A1TOOLS_DEFAULT_REVIEWS_API_URL', 'https://tools.a-1chimney.com/api/group_reviews.php' );
define( 'A1TOOLS_DEFAULT_BEFORE_AFTER_API_URL', 'https://tools.a-1chimney.com/api/group_before_after.php' );
define( 'A1TOOLS_DEFAULT_TEAM_API_URL', 'https://tools.a-1chimney.com/api/group_team.php' );
define( 'A1TOOLS_DEFAULT_FAQ_API_URL', 'https://tools.a-1chimney.com/api/group_faq.php' );
define( 'A1TOOLS_SERVICES_CACHE_KEY', 'a1tools_services' );
define( 'A1TOOLS_REVIEWS_CACHE_KEY', 'a1tools_reviews' );
define( 'A1TOOLS_BEFORE_AFTER_CACHE_KEY', 'a1tools_before_after' );
define( 'A1TOOLS_TEAM_CACHE_KEY', 'a1tools_team' );
define( 'A1TOOLS_FAQ_CACHE_KEY', 'a1tools_faq' );
define( 'A1TOOLS_DEFAULT_SEO_LOCATIONS_API_URL', 'https://tools.a-1chimney.com/api/site_seo_locations.php' );
define( 'A1TOOLS_SEO_LOCATIONS_CACHE_KEY', 'a1tools_seo_locations' );

// Import/Export functionality.
require_once A1TOOLS_PLUGIN_DIR . 'includes/class-a1-tools-import-export.php';
A1Tools_Import_Export::get_instance();

// Media Management functionality.
require_once A1TOOLS_PLUGIN_DIR . 'includes/class-a1-tools-media-management.php';
A1Tools_Media_Management::get_instance();

/**
 * One-time upgrade routine. Cleans up options removed in newer versions.
 *
 * Tracked via the `a1tools_db_version` option so it only runs when the
 * stored version differs from A1TOOLS_VERSION.
 *
 * @since 2.4.0
 * @return void
 */
function a1tools_maybe_upgrade() {
	$installed = get_option( 'a1tools_db_version', '0.0.0' );
	if ( version_compare( $installed, A1TOOLS_VERSION, '>=' ) ) {
		return;
	}
	if ( version_compare( $installed, '2.4.0', '<' ) ) {
		// Removed in 2.4.0: target board/group IDs (never sent to server; routing is server-side).
		delete_option( 'a1tools_form_board_id' );
		delete_option( 'a1tools_form_group_id' );
	}
	if ( version_compare( $installed, '2.4.2', '<' ) ) {
		// 2.4.2 fixes a TTL bug where get_option('a1tools_cache_expiry') was
		// multiplied by MINUTE_IN_SECONDS even though the admin form already
		// stored seconds. The "No caching (0)" option in particular passed 0
		// to set_transient(), which WordPress treats as "no expiration" — so
		// every cached payload (site variables, city pages, franchises, etc.)
		// could persist indefinitely. Wipe all a1tools transients here so
		// the corrected logic rebuilds them with the right TTL.
		if ( function_exists( 'a1tools_clear_cache' ) ) {
			a1tools_clear_cache();
		}
	}
	update_option( 'a1tools_db_version', A1TOOLS_VERSION, false );
}
add_action( 'admin_init', 'a1tools_maybe_upgrade' );

// Split-file includes (data, shortcodes, REST, Yoast, Elementor, admin, forms).
require_once A1TOOLS_PLUGIN_DIR . 'includes/a1-tools-data.php';
require_once A1TOOLS_PLUGIN_DIR . 'includes/a1-tools-shortcodes.php';
require_once A1TOOLS_PLUGIN_DIR . 'includes/a1-tools-rest-api.php';
require_once A1TOOLS_PLUGIN_DIR . 'includes/a1-tools-yoast.php';
require_once A1TOOLS_PLUGIN_DIR . 'includes/a1-tools-elementor-init.php';
require_once A1TOOLS_PLUGIN_DIR . 'includes/a1-tools-admin.php';
require_once A1TOOLS_PLUGIN_DIR . 'includes/a1-tools-forms.php';

// ============================================================================
// SOCIAL ICONS WIDGET
// ============================================================================

/**
 * A1 Tools Social Icons Widget.
 *
 * @since 1.2.0
 */
class A1Tools_Social_Icons_Widget extends WP_Widget {

	/**
	 * Constructor.
	 */
	public function __construct() {
		parent::__construct(
			'a1tools_social_icons',
			__( 'A1 Tools Social Icons', 'a1-tools' ),
			array(
				'description' => __( 'Display social media icons from A1 Tools with customizable styling.', 'a1-tools' ),
				'classname'   => 'a1tools-social-widget',
			)
		);
	}

	/**
	 * Frontend display.
	 *
	 * @param array $args     Widget arguments.
	 * @param array $instance Widget instance.
	 */
	public function widget( $args, $instance ) {
		$vars = a1tools_get_site_variables();
		if ( ! $vars ) {
			return;
		}

		// Widget settings with defaults.
		$title         = ! empty( $instance['title'] ) ? $instance['title'] : '';
		$shape         = ! empty( $instance['shape'] ) ? $instance['shape'] : 'rounded';
		$style         = ! empty( $instance['style'] ) ? $instance['style'] : 'default';
		$size          = ! empty( $instance['size'] ) ? (int) $instance['size'] : 40;
		$icon_size     = ! empty( $instance['icon_size'] ) ? (int) $instance['icon_size'] : 18;
		$spacing       = ! empty( $instance['spacing'] ) ? (int) $instance['spacing'] : 8;
		$alignment     = ! empty( $instance['alignment'] ) ? $instance['alignment'] : 'left';
		$custom_color  = ! empty( $instance['custom_color'] ) ? $instance['custom_color'] : '';
		$hover_effect  = ! empty( $instance['hover_effect'] ) ? $instance['hover_effect'] : 'scale';

		// Platform configurations with official colors.
		$platforms = array(
			'facebook_url'        => array( 'label' => 'Facebook', 'icon' => 'fab fa-facebook-f', 'color' => '#1877F2' ),
			'instagram_url'       => array( 'label' => 'Instagram', 'icon' => 'fab fa-instagram', 'color' => '#E4405F' ),
			'youtube_url'         => array( 'label' => 'YouTube', 'icon' => 'fab fa-youtube', 'color' => '#FF0000' ),
			'twitter_url'         => array( 'label' => 'X (Twitter)', 'icon' => 'svg-x', 'color' => '#000000' ),
			'linkedin_url'        => array( 'label' => 'LinkedIn', 'icon' => 'fab fa-linkedin-in', 'color' => '#0A66C2' ),
			'tiktok_url'          => array( 'label' => 'TikTok', 'icon' => 'fab fa-tiktok', 'color' => '#000000' ),
			'yelp_url'            => array( 'label' => 'Yelp', 'icon' => 'fab fa-yelp', 'color' => '#D32323' ),
			'google_business_url' => array( 'label' => 'Google', 'icon' => 'fab fa-google', 'color' => '#4285F4' ),
			'pinterest_url'       => array( 'label' => 'Pinterest', 'icon' => 'fab fa-pinterest-p', 'color' => '#E60023' ),
			'bbb_url'             => array( 'label' => 'BBB', 'icon' => 'fas fa-shield-alt', 'color' => '#006CB7' ),
			'nextdoor_url'        => array( 'label' => 'Nextdoor', 'icon' => 'fas fa-home', 'color' => '#8ED500' ),
			'houzz_url'           => array( 'label' => 'Houzz', 'icon' => 'fab fa-houzz', 'color' => '#4DBC15' ),
			'angi_url'            => array( 'label' => 'Angi', 'icon' => 'fas fa-tools', 'color' => '#FF6153' ),
			'thumbtack_url'       => array( 'label' => 'Thumbtack', 'icon' => 'fas fa-thumbtack', 'color' => '#009FD9' ),
			'homeadvisor_url'     => array( 'label' => 'HomeAdvisor', 'icon' => 'fas fa-home', 'color' => '#EF6C00' ),
		);

		// Check if any platforms have URLs.
		$has_platforms = false;
		foreach ( $platforms as $key => $data ) {
			if ( ! empty( $vars[ $key ] ) ) {
				$has_platforms = true;
				break;
			}
		}

		if ( ! $has_platforms ) {
			return;
		}

		// Generate unique ID for this widget instance.
		$widget_id = 'a1tools-social-' . $this->number;

		// Build inline styles.
		$container_styles = array(
			'text-align' => $alignment,
		);

		$link_styles = array(
			'width'           => $size . 'px',
			'height'          => $size . 'px',
			'margin'          => '0 ' . ( $spacing / 2 ) . 'px ' . $spacing . 'px',
			'font-size'       => $icon_size . 'px',
			'display'         => 'inline-flex',
			'align-items'     => 'center',
			'justify-content' => 'center',
			'text-decoration' => 'none',
			'transition'      => 'all 0.3s ease',
		);

		// Shape styles.
		switch ( $shape ) {
			case 'circle':
				$link_styles['border-radius'] = '50%';
				break;
			case 'square':
				$link_styles['border-radius'] = '0';
				break;
			case 'rounded':
			default:
				$link_styles['border-radius'] = '8px';
				break;
		}

		// Output widget.
		// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Widget args are pre-escaped by WordPress.
		echo $args['before_widget'];

		if ( $title ) {
			// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Widget args are pre-escaped by WordPress.
			echo $args['before_title'] . esc_html( apply_filters( 'widget_title', $title ) ) . $args['after_title'];
		}

		// Build CSS for this widget instance.
		$css = '#' . esc_attr( $widget_id ) . ' { ';
		foreach ( $container_styles as $prop => $val ) {
			$css .= esc_attr( $prop ) . ':' . esc_attr( $val ) . ';';
		}
		$css .= '}';
		$css .= '#' . esc_attr( $widget_id ) . ' .a1tools-social-icon { ';
		foreach ( $link_styles as $prop => $val ) {
			$css .= esc_attr( $prop ) . ':' . esc_attr( $val ) . ';';
		}
		$css .= '}';

		// Style-specific CSS.
		if ( 'default' === $style || 'official' === $style ) {
			// Official colors or custom color background.
			$css .= '#' . esc_attr( $widget_id ) . ' .a1tools-social-icon { color: #fff; }';
		} elseif ( 'outline' === $style ) {
			$css .= '#' . esc_attr( $widget_id ) . ' .a1tools-social-icon { background: transparent; border: 2px solid; }';
		} elseif ( 'minimal' === $style ) {
			$css .= '#' . esc_attr( $widget_id ) . ' .a1tools-social-icon { background: transparent; }';
		} elseif ( 'light' === $style ) {
			$css .= '#' . esc_attr( $widget_id ) . ' .a1tools-social-icon { background: #f5f5f5; }';
		} elseif ( 'dark' === $style ) {
			$css .= '#' . esc_attr( $widget_id ) . ' .a1tools-social-icon { background: #333; color: #fff; }';
		}

		// Hover effects.
		if ( 'scale' === $hover_effect ) {
			$css .= '#' . esc_attr( $widget_id ) . ' .a1tools-social-icon:hover { transform: scale(1.1); }';
		} elseif ( 'lift' === $hover_effect ) {
			$css .= '#' . esc_attr( $widget_id ) . ' .a1tools-social-icon:hover { transform: translateY(-3px); box-shadow: 0 4px 12px rgba(0,0,0,0.2); }';
		} elseif ( 'rotate' === $hover_effect ) {
			$css .= '#' . esc_attr( $widget_id ) . ' .a1tools-social-icon:hover { transform: rotate(15deg); }';
		} elseif ( 'pulse' === $hover_effect ) {
			$css .= '#' . esc_attr( $widget_id ) . ' .a1tools-social-icon:hover { animation: a1tools-pulse 0.5s ease; }';
			$css .= '@keyframes a1tools-pulse { 0%, 100% { transform: scale(1); } 50% { transform: scale(1.15); } }';
		}

		// Add CSS using WordPress enqueue system.
		wp_register_style( 'a1tools-social-widget-' . $this->number, false, array(), A1TOOLS_VERSION );
		wp_enqueue_style( 'a1tools-social-widget-' . $this->number );
		wp_add_inline_style( 'a1tools-social-widget-' . $this->number, $css );

		// Output icons container.
		echo '<div id="' . esc_attr( $widget_id ) . '" class="a1tools-social-icons-styled">';

		foreach ( $platforms as $key => $data ) {
			if ( ! empty( $vars[ $key ] ) ) {
				// Determine background/border color.
				$item_color = $custom_color ? $custom_color : ( 'official' === $style || 'default' === $style ? $data['color'] : '' );

				$inline_style = '';
				if ( 'default' === $style || 'official' === $style ) {
					$inline_style = 'background-color:' . esc_attr( $item_color ) . ';';
				} elseif ( 'outline' === $style ) {
					$icon_color   = $custom_color ? $custom_color : $data['color'];
					$inline_style = 'border-color:' . esc_attr( $icon_color ) . ';color:' . esc_attr( $icon_color ) . ';';
				} elseif ( 'minimal' === $style ) {
					$icon_color   = $custom_color ? $custom_color : $data['color'];
					$inline_style = 'color:' . esc_attr( $icon_color ) . ';';
				} elseif ( 'light' === $style ) {
					$icon_color   = $custom_color ? $custom_color : $data['color'];
					$inline_style = 'color:' . esc_attr( $icon_color ) . ';';
				}

				echo '<a href="' . esc_url( $vars[ $key ] ) . '" class="a1tools-social-icon" target="_blank" rel="noopener noreferrer" title="' . esc_attr( $data['label'] ) . '" style="' . esc_attr( $inline_style ) . '">';
				echo wp_kses( a1tools_get_icon_html( $data['icon'] ), a1tools_icon_allowed_tags() );
				echo '<span class="screen-reader-text">' . esc_html( $data['label'] ) . '</span>';
				echo '</a>';
			}
		}

		echo '</div>';

		// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- Widget args are pre-escaped by WordPress.
		echo $args['after_widget'];
	}

	/**
	 * Backend form.
	 *
	 * @param array $instance Widget instance.
	 */
	public function form( $instance ) {
		$title        = ! empty( $instance['title'] ) ? $instance['title'] : '';
		$shape        = ! empty( $instance['shape'] ) ? $instance['shape'] : 'rounded';
		$style        = ! empty( $instance['style'] ) ? $instance['style'] : 'default';
		$size         = ! empty( $instance['size'] ) ? (int) $instance['size'] : 40;
		$icon_size    = ! empty( $instance['icon_size'] ) ? (int) $instance['icon_size'] : 18;
		$spacing      = ! empty( $instance['spacing'] ) ? (int) $instance['spacing'] : 8;
		$alignment    = ! empty( $instance['alignment'] ) ? $instance['alignment'] : 'left';
		$custom_color = ! empty( $instance['custom_color'] ) ? $instance['custom_color'] : '';
		$hover_effect = ! empty( $instance['hover_effect'] ) ? $instance['hover_effect'] : 'scale';
		?>
		<p>
			<label for="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>"><?php esc_html_e( 'Title:', 'a1-tools' ); ?></label>
			<input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'title' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'title' ) ); ?>" type="text" value="<?php echo esc_attr( $title ); ?>">
		</p>

		<p>
			<label for="<?php echo esc_attr( $this->get_field_id( 'style' ) ); ?>"><?php esc_html_e( 'Style:', 'a1-tools' ); ?></label>
			<select class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'style' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'style' ) ); ?>">
				<option value="default" <?php selected( $style, 'default' ); ?>><?php esc_html_e( 'Official Colors (Filled)', 'a1-tools' ); ?></option>
				<option value="outline" <?php selected( $style, 'outline' ); ?>><?php esc_html_e( 'Outline', 'a1-tools' ); ?></option>
				<option value="minimal" <?php selected( $style, 'minimal' ); ?>><?php esc_html_e( 'Minimal (Icon Only)', 'a1-tools' ); ?></option>
				<option value="light" <?php selected( $style, 'light' ); ?>><?php esc_html_e( 'Light Background', 'a1-tools' ); ?></option>
				<option value="dark" <?php selected( $style, 'dark' ); ?>><?php esc_html_e( 'Dark Background', 'a1-tools' ); ?></option>
			</select>
		</p>

		<p>
			<label for="<?php echo esc_attr( $this->get_field_id( 'shape' ) ); ?>"><?php esc_html_e( 'Shape:', 'a1-tools' ); ?></label>
			<select class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'shape' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'shape' ) ); ?>">
				<option value="rounded" <?php selected( $shape, 'rounded' ); ?>><?php esc_html_e( 'Rounded', 'a1-tools' ); ?></option>
				<option value="circle" <?php selected( $shape, 'circle' ); ?>><?php esc_html_e( 'Circle', 'a1-tools' ); ?></option>
				<option value="square" <?php selected( $shape, 'square' ); ?>><?php esc_html_e( 'Square', 'a1-tools' ); ?></option>
			</select>
		</p>

		<p>
			<label for="<?php echo esc_attr( $this->get_field_id( 'size' ) ); ?>"><?php esc_html_e( 'Button Size (px):', 'a1-tools' ); ?></label>
			<input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'size' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'size' ) ); ?>" type="number" min="20" max="100" value="<?php echo esc_attr( $size ); ?>">
		</p>

		<p>
			<label for="<?php echo esc_attr( $this->get_field_id( 'icon_size' ) ); ?>"><?php esc_html_e( 'Icon Size (px):', 'a1-tools' ); ?></label>
			<input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'icon_size' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'icon_size' ) ); ?>" type="number" min="10" max="60" value="<?php echo esc_attr( $icon_size ); ?>">
		</p>

		<p>
			<label for="<?php echo esc_attr( $this->get_field_id( 'spacing' ) ); ?>"><?php esc_html_e( 'Spacing (px):', 'a1-tools' ); ?></label>
			<input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'spacing' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'spacing' ) ); ?>" type="number" min="0" max="50" value="<?php echo esc_attr( $spacing ); ?>">
		</p>

		<p>
			<label for="<?php echo esc_attr( $this->get_field_id( 'alignment' ) ); ?>"><?php esc_html_e( 'Alignment:', 'a1-tools' ); ?></label>
			<select class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'alignment' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'alignment' ) ); ?>">
				<option value="left" <?php selected( $alignment, 'left' ); ?>><?php esc_html_e( 'Left', 'a1-tools' ); ?></option>
				<option value="center" <?php selected( $alignment, 'center' ); ?>><?php esc_html_e( 'Center', 'a1-tools' ); ?></option>
				<option value="right" <?php selected( $alignment, 'right' ); ?>><?php esc_html_e( 'Right', 'a1-tools' ); ?></option>
			</select>
		</p>

		<p>
			<label for="<?php echo esc_attr( $this->get_field_id( 'hover_effect' ) ); ?>"><?php esc_html_e( 'Hover Effect:', 'a1-tools' ); ?></label>
			<select class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'hover_effect' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'hover_effect' ) ); ?>">
				<option value="scale" <?php selected( $hover_effect, 'scale' ); ?>><?php esc_html_e( 'Scale', 'a1-tools' ); ?></option>
				<option value="lift" <?php selected( $hover_effect, 'lift' ); ?>><?php esc_html_e( 'Lift with Shadow', 'a1-tools' ); ?></option>
				<option value="rotate" <?php selected( $hover_effect, 'rotate' ); ?>><?php esc_html_e( 'Rotate', 'a1-tools' ); ?></option>
				<option value="pulse" <?php selected( $hover_effect, 'pulse' ); ?>><?php esc_html_e( 'Pulse', 'a1-tools' ); ?></option>
				<option value="none" <?php selected( $hover_effect, 'none' ); ?>><?php esc_html_e( 'None', 'a1-tools' ); ?></option>
			</select>
		</p>

		<p>
			<label for="<?php echo esc_attr( $this->get_field_id( 'custom_color' ) ); ?>"><?php esc_html_e( 'Custom Color (optional):', 'a1-tools' ); ?></label>
			<input class="widefat" id="<?php echo esc_attr( $this->get_field_id( 'custom_color' ) ); ?>" name="<?php echo esc_attr( $this->get_field_name( 'custom_color' ) ); ?>" type="text" value="<?php echo esc_attr( $custom_color ); ?>" placeholder="#000000">
			<small><?php esc_html_e( 'Leave empty to use official brand colors', 'a1-tools' ); ?></small>
		</p>
		<?php
	}

	/**
	 * Save widget settings.
	 *
	 * @param array $new_instance New instance values.
	 * @param array $old_instance Old instance values.
	 * @return array Sanitized instance.
	 */
	public function update( $new_instance, $old_instance ) {
		$instance                 = array();
		$instance['title']        = ! empty( $new_instance['title'] ) ? sanitize_text_field( $new_instance['title'] ) : '';
		$instance['shape']        = ! empty( $new_instance['shape'] ) ? sanitize_text_field( $new_instance['shape'] ) : 'rounded';
		$instance['style']        = ! empty( $new_instance['style'] ) ? sanitize_text_field( $new_instance['style'] ) : 'default';
		$instance['size']         = ! empty( $new_instance['size'] ) ? absint( $new_instance['size'] ) : 40;
		$instance['icon_size']    = ! empty( $new_instance['icon_size'] ) ? absint( $new_instance['icon_size'] ) : 18;
		$instance['spacing']      = isset( $new_instance['spacing'] ) ? absint( $new_instance['spacing'] ) : 8;
		$instance['alignment']    = ! empty( $new_instance['alignment'] ) ? sanitize_text_field( $new_instance['alignment'] ) : 'left';
		$instance['custom_color'] = ! empty( $new_instance['custom_color'] ) ? sanitize_hex_color( $new_instance['custom_color'] ) : '';
		$instance['hover_effect'] = ! empty( $new_instance['hover_effect'] ) ? sanitize_text_field( $new_instance['hover_effect'] ) : 'scale';

		return $instance;
	}
}

/**
 * Register the social icons widget.
 *
 * @since 1.2.0
 * @return void
 */
function a1tools_register_widgets() {
	register_widget( 'A1Tools_Social_Icons_Widget' );
}
add_action( 'widgets_init', 'a1tools_register_widgets' );

/**
 * Enqueue plugin styles.
 *
 * Note: Font Awesome is required for social icons but is NOT bundled with this plugin.
 * Most themes include Font Awesome. If icons don't appear, add Font Awesome to your theme
 * or use a Font Awesome plugin.
 *
 * @since 1.2.0
 * @return void
 */
function a1tools_enqueue_scripts() {
	// Register inline styles for social icons if needed.
	wp_register_style( 'a1tools-social', false, array(), A1TOOLS_VERSION );
	wp_enqueue_style( 'a1tools-social' );

	// Add basic screen-reader-text class if not provided by theme.
	$inline_css = '.a1tools-social-links .screen-reader-text,
.a1tools-social-icons-styled .screen-reader-text {
	clip: rect(1px, 1px, 1px, 1px);
	position: absolute !important;
	height: 1px;
	width: 1px;
	overflow: hidden;
}';
	wp_add_inline_style( 'a1tools-social', $inline_css );
}
add_action( 'wp_enqueue_scripts', 'a1tools_enqueue_scripts' );