<?php
/**
 * Pro upgrade notice - a single, dismissible admin notice for the FREE plugin.
 *
 * Generated from projects/plugins/_tools/templates/class-pro-upgrade-notice.php.tpl
 * by projects/plugins/_tools/sync-upgrade-notice.mjs. Every Big Bad free plugin
 * ships this exact file; only the class-name prefix differs (WordPress.org asks
 * for a unique prefix per plugin, so a shared generic class name is not used).
 *
 * What it does (WordPress.org guideline-compliant, safe for the FREE tier):
 *   - Shows ONE informational notice, only to users with the configured
 *     capability, and only on the Plugins screen and this plugin's own admin
 *     pages - never site-wide.
 *   - Hidden permanently for a user once dismissed (per-user meta, nonce
 *     protected), and hidden whenever Pro is active or a Pro license key is
 *     stored locally.
 *   - No Pro code, no licensing code, no external HTTP, no tracking. The only
 *     link is a normal link to the plugin's own page; nothing is sent unless
 *     the user clicks it.
 *   - No translation happens in this class (a variable text domain fails
 *     Plugin Check); the plugin passes already-translated strings.
 *   - All output is escaped.
 *
 * @package BigBad_Free_Plugin
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

if ( ! class_exists( 'BBADRS_Pro_Upgrade_Notice' ) ) :

	/**
	 * Config-driven Pro upgrade notice.
	 */
	class BBADRS_Pro_Upgrade_Notice {

		const META_PREFIX        = 'bba_pun_dismissed_';
		const LEGACY_META_PREFIX = 'bba_ptn_dismissed_';
		const DISMISS_ARG        = 'bba_pun_dismiss';

		/**
		 * Notice config.
		 *
		 * @var array
		 */
		private static $config = array();

		/**
		 * Register the notice.
		 *
		 * @param array $args {
		 *     @type string   $id             Required. Plugin slug.
		 *     @type string   $url            Required. The plugin's own page.
		 *     @type string[] $page_prefixes  Required. Admin `page` slugs (prefix match) where it may show.
		 *     @type string   $pro_filter     Filter returning bool "Pro active" (optional).
		 *     @type string   $license_option Option holding a Pro license key (optional).
		 *     @type string   $capability     Capability required to see it.
		 *     @type array    $strings        Pre-translated: headline, body, cta, dismiss.
		 * }
		 * @return void
		 */
		public static function register( $args ) {
			$args = wp_parse_args(
				$args,
				array(
					'id'             => '',
					'url'            => '',
					'page_prefixes'  => array(),
					'pro_filter'     => '',
					'license_option' => '',
					'capability'     => 'manage_options',
					'strings'        => array(),
				)
			);

			if ( '' === $args['id'] || '' === $args['url'] || empty( $args['strings']['headline'] ) || empty( $args['strings']['cta'] ) ) {
				return;
			}

			self::$config = $args;
			add_action( 'admin_init', array( __CLASS__, 'handle_dismiss' ) );
			add_action( 'admin_notices', array( __CLASS__, 'maybe_render' ) );
		}

		/**
		 * Whether the current admin screen is one where the notice may appear:
		 * the Plugins screen, or one of this plugin's own pages.
		 *
		 * @return bool
		 */
		private static function is_allowed_screen() {
			$screen = function_exists( 'get_current_screen' ) ? get_current_screen() : null;
			if ( $screen && 'plugins' === $screen->id ) {
				return true;
			}

			// phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only screen check, no state change.
			$page = isset( $_GET['page'] ) ? sanitize_key( wp_unslash( $_GET['page'] ) ) : '';
			if ( '' === $page ) {
				return false;
			}

			foreach ( (array) self::$config['page_prefixes'] as $prefix ) {
				if ( '' !== $prefix && 0 === strpos( $page, $prefix ) ) {
					return true;
				}
			}

			return false;
		}

		/**
		 * Whether the notice should show for the current user on this screen.
		 *
		 * @return bool
		 */
		private static function is_eligible() {
			$n = self::$config;

			if ( empty( $n ) || ! current_user_can( $n['capability'] ) ) {
				return false;
			}

			if ( '' !== $n['pro_filter'] && (bool) apply_filters( $n['pro_filter'], false ) ) {
				return false;
			}

			if ( '' !== $n['license_option'] ) {
				$key = get_option( $n['license_option'], '' );
				if ( ! empty( $key ) ) {
					return false;
				}
			}

			$user_id = get_current_user_id();
			if ( $user_id ) {
				// A dismissal of this notice, or of the earlier notice it replaced, is respected.
				if ( get_user_meta( $user_id, self::META_PREFIX . $n['id'], true ) || get_user_meta( $user_id, self::LEGACY_META_PREFIX . $n['id'], true ) ) {
					return false;
				}
			}

			return self::is_allowed_screen();
		}

		/**
		 * Render the notice when eligible.
		 *
		 * @return void
		 */
		public static function maybe_render() {
			if ( ! self::is_eligible() ) {
				return;
			}

			$n = self::$config;
			$s = $n['strings'];

			$dismiss_url = wp_nonce_url(
				add_query_arg( self::DISMISS_ARG, rawurlencode( $n['id'] ) ),
				self::DISMISS_ARG . '_' . $n['id']
			);

			echo '<div class="notice notice-info bba-pun-notice">';
			echo '<p><strong>' . esc_html( $s['headline'] ) . '</strong>';
			if ( ! empty( $s['body'] ) ) {
				echo '<br />' . esc_html( $s['body'] );
			}
			echo '</p>';
			echo '<p>';
			echo '<a class="button" href="' . esc_url( $n['url'] ) . '" target="_blank" rel="noopener noreferrer">' . esc_html( $s['cta'] ) . '</a>';
			echo ' <a class="button-link" style="margin-left:10px;" href="' . esc_url( $dismiss_url ) . '">' . esc_html( ! empty( $s['dismiss'] ) ? $s['dismiss'] : 'Dismiss' ) . '</a>';
			echo '</p>';
			echo '</div>';
		}

		/**
		 * Handle a dismissal click for THIS plugin's notice. Persists to user
		 * meta so the notice never shows again for that user.
		 *
		 * @return void
		 */
		public static function handle_dismiss() {
			if ( empty( self::$config ) || ! isset( $_GET[ self::DISMISS_ARG ] ) ) {
				return;
			}

			$id = sanitize_key( wp_unslash( $_GET[ self::DISMISS_ARG ] ) );
			if ( $id !== self::$config['id'] ) {
				return;
			}

			$nonce = isset( $_GET['_wpnonce'] ) ? sanitize_text_field( wp_unslash( $_GET['_wpnonce'] ) ) : '';
			if ( ! wp_verify_nonce( $nonce, self::DISMISS_ARG . '_' . $id ) ) {
				return;
			}

			$user_id = get_current_user_id();
			if ( $user_id ) {
				update_user_meta( $user_id, self::META_PREFIX . $id, 1 );
			}

			wp_safe_redirect( remove_query_arg( array( self::DISMISS_ARG, '_wpnonce' ) ) );
			exit;
		}
	}

endif;