<?php
/**
 * Local, read-only discovery of the publisher's other WordPress plugins.
 *
 * @package LoggedAI
 */

namespace LoggedAI;

defined( 'ABSPATH' ) || exit;

/** No remote catalogue request, installation action, tracking or saved setting. */
final class PluginCollection {

	public const PAGE = 'logged-ai-more-plugins';

	/** Native authorized page hook returned by WordPress. @var string */
	private static string $hook = '';

	/** Register the optional site-administration page and its local stylesheet. */
	public static function boot(): void {
		add_action( 'admin_menu', array( self::class, 'register_page' ), 29 );
		add_action( 'admin_enqueue_scripts', array( self::class, 'enqueue' ), 1000 );
	}

	/** Keep the normal settings capability and native WordPress registration. */
	public static function register_page(): void {
		$hook = add_submenu_page(
			'logged-ai',
			__( 'More from Plugins.shop', 'logged-ai' ),
			__( 'More Plugins', 'logged-ai' ),
			'logged_ai_manage_settings',
			self::PAGE,
			array( self::class, 'page' )
		);
		self::$hook = is_string( $hook ) ? $hook : '';
	}

	/**
	 * Load only the collection page's local styling, after the workspace styles.
	 *
	 * @param string $hook Current native administration page hook.
	 */
	public static function enqueue( string $hook ): void {
		if ( '' === self::$hook || self::$hook !== $hook || ! current_user_can( 'logged_ai_manage_settings' ) ) {
			return;
		}
		wp_enqueue_style( 'logged-ai-plugin-collection', plugins_url( 'assets/plugin-collection.css', LOGGED_AI_FILE ), array( 'logged-ai-studio' ), LOGGED_AI_VERSION );
	}

	/**
	 * Bundled publisher catalogue, reviewed 3 November 2026; no visitor data.
	 *
	 * Counts and sections derive from this list. Product names are brand names.
	 * Adjacent use cases do not imply automatic integration with Logged.ai.
	 *
	 * @return array<string,array<string,mixed>> The sixteen other products.
	 */
	public static function products(): array {
		return array(
			'clickclue' => array(
				'name'                 => 'ClickClue',
				'category'             => __( 'Session replay', 'logged-ai' ),
				'description'          => __( 'Review consenting visitors’ recorded journeys and investigate where they get stuck.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/clickclue/',
				'featured'             => true,
				'why'                  => __( 'See where consenting visitors get stuck while you review what changed on your site.', 'logged-ai' ),
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => '',
			),
			'redirectnest' => array(
				'name'                 => 'RedirectNest',
				'category'             => __( 'Links & navigation', 'logged-ai' ),
				'description'          => __( 'Manage redirects and review broken-link problems.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/redirectnest/',
				'featured'             => true,
				'why'                  => __( 'Review broken links and redirects when page addresses change.', 'logged-ai' ),
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => '',
			),
			'antivirus' => array(
				'name'                 => 'Antivirus.ai',
				'category'             => __( 'WordPress security', 'logged-ai' ),
				'description'          => __( 'Review local security findings and decide what to investigate or repair.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/antivirus/',
				'featured'             => true,
				'why'                  => __( 'Review local security findings alongside your record of site changes.', 'logged-ai' ),
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => '',
			),
			'campaignbars' => array(
				'name'                 => 'CampaignBars',
				'category'             => __( 'Announcements & offers', 'logged-ai' ),
				'description'          => __( 'Publish targeted announcements, countdowns and copyable coupons without editing your theme.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/campaignbars/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => __( 'Pro plans available', 'logged-ai' ),
				'preview'              => false,
				'woocommerce'          => __( 'Optional WooCommerce workflows', 'logged-ai' ),
			),
			'cartdini' => array(
				'name'                 => 'Cartdini',
				'category'             => __( 'Checkout fields', 'logged-ai' ),
				'description'          => __( 'Ask checkout questions and keep the answers with each order.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/cartdini/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => __( 'Requires WooCommerce', 'logged-ai' ),
			),
			'catalogfaq' => array(
				'name'                 => 'Catalog FAQ',
				'category'             => __( 'Reusable answers', 'logged-ai' ),
				'description'          => __( 'Write answers once and reuse them across pages, products and FAQ groups.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/catalogfaq/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Preview · Free available', 'logged-ai' ),
				'availability_detail'  => __( 'Paid plans not open', 'logged-ai' ),
				'preview'              => true,
				'woocommerce'          => __( 'Optional WooCommerce workflows', 'logged-ai' ),
			),
			'customfields' => array(
				'name'                 => 'CustomFields',
				'category'             => __( 'Structured content', 'logged-ai' ),
				'description'          => __( 'Structure your content with reusable fields, repeaters and display tools.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/customfields/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => '',
			),
			'frictions' => array(
				'name'                 => 'Frictions',
				'category'             => __( 'Checkout investigations', 'logged-ai' ),
				'description'          => __( 'Investigate WooCommerce checkout errors with privacy-conscious replay.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/frictions/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => __( 'Requires WooCommerce', 'logged-ai' ),
			),
			'killerconversions' => array(
				'name'                 => 'KillerConversions',
				'category'             => __( 'Forms & enquiries', 'logged-ai' ),
				'description'          => __( 'Build enquiry forms and keep the entries in WordPress.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/killerconversions/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => '',
			),
			'newsletterplatform' => array(
				'name'                 => 'Newsletter Platform',
				'category'             => __( 'Newsletters & welcome emails', 'logged-ai' ),
				'description'          => __( 'Create newsletters and welcome emails in WordPress using your own mail provider.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/newsletterplatform/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => __( 'Optional WooCommerce workflows', 'logged-ai' ),
			),
			'orderfloor' => array(
				'name'                 => 'OrderFloor',
				'category'             => __( 'Order rules', 'logged-ai' ),
				'description'          => __( 'Set order minimums, quantity limits and pack sizes.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/orderfloor/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => __( 'Requires WooCommerce', 'logged-ai' ),
			),
			'orderworth' => array(
				'name'                 => 'OrderWorth',
				'category'             => __( 'Costs & contribution', 'logged-ai' ),
				'description'          => __( 'Review order contribution after recorded costs, expenses and refunds.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/orderworth/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => __( 'Requires WooCommerce', 'logged-ai' ),
			),
			'stockcontrols' => array(
				'name'                 => 'StockControls',
				'category'             => __( 'Inventory & purchasing', 'logged-ai' ),
				'description'          => __( 'Review stock changes, receive purchase orders and plan replenishment.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/stockcontrols/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => __( 'Requires WooCommerce', 'logged-ai' ),
			),
			'tocgenius' => array(
				'name'                 => 'TOC Genius',
				'category'             => __( 'Article navigation', 'logged-ai' ),
				'description'          => __( 'Help readers navigate long articles with clear contents and stable section links.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/tocgenius/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Preview · Free + Pro downloads', 'logged-ai' ),
				'availability_detail'  => __( 'Directory review pending', 'logged-ai' ),
				'preview'              => true,
				'woocommerce'          => '',
			),
			'wakemycart' => array(
				'name'                 => 'WakeMyCart',
				'category'             => __( 'Cart follow-up', 'logged-ai' ),
				'description'          => __( 'Remind consenting shoppers about unfinished carts.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/wakemycart/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => __( 'Requires WooCommerce', 'logged-ai' ),
			),
			'wishlistgenius' => array(
				'name'                 => 'WishlistGenius',
				'category'             => __( 'Wishlists & saved products', 'logged-ai' ),
				'description'          => __( 'Let shoppers save products, share a wishlist and return when they are ready.', 'logged-ai' ),
				'url'                  => 'https://plugins.shop/wishlistgenius/',
				'featured'             => false,
				'why'                  => '',
				'availability'         => __( 'Free edition available', 'logged-ai' ),
				'availability_detail'  => '',
				'preview'              => false,
				'woocommerce'          => __( 'Requires WooCommerce', 'logged-ai' ),
			),
		);
	}

	/** Authorize before rendering the read-only collection. */
	public static function page(): void {
		$scope = Scope::current( 'logged_ai_manage_settings' );
		if ( is_wp_error( $scope ) ) {
			wp_die( esc_html__( 'Workspace access denied.', 'logged-ai' ), '', array( 'response' => 403 ) );
		}
		nocache_headers();
		$products = self::products();
		$featured = array_filter( $products, static fn( array $product ): bool => $product['featured'] );
		$remaining = array_filter( $products, static fn( array $product ): bool => ! $product['featured'] );
		?>
		<main class="wrap logged-ai collection-page lai-plugin-collection" id="more-plugins" tabindex="-1">
			<header class="collection-heading">
				<div>
					<div class="lai-eyebrow"><?php esc_html_e( 'THE PLUGINS.SHOP COLLECTION', 'logged-ai' ); ?></div>
					<h1><?php esc_html_e( 'More from Plugins.shop', 'logged-ai' ); ?></h1>
					<p><?php
						/* translators: %s: number of other plugins in the publisher's collection. */
						echo esc_html( sprintf( _n( 'Explore %s other plugin, with useful companions first.', 'Explore all %s other plugins, with useful companions first.', count( $products ), 'logged-ai' ), number_format_i18n( count( $products ) ) ) );
					?></p>
				</div>
				<a href="<?php echo esc_url( 'https://plugins.shop/' ); ?>" class="lai-btn" target="_blank" rel="noopener noreferrer"><?php esc_html_e( 'Visit Plugins.shop', 'logged-ai' ); ?> <span aria-hidden="true">↗</span><span class="screen-reader-text"> <?php esc_html_e( '(opens in a new tab)', 'logged-ai' ); ?></span></a>
			</header>
			<section aria-labelledby="lai-companions-heading">
				<div class="collection-section-heading">
					<div>
						<h2 id="lai-companions-heading"><?php esc_html_e( 'Useful alongside Logged.ai', 'logged-ai' ); ?></h2>
						<p><?php esc_html_e( 'For visitor journeys, changed links and security investigations.', 'logged-ai' ); ?></p>
					</div>
					<span class="collection-count"><?php
						/* translators: %s: number of featured companion plugins. */
						echo esc_html( sprintf( _n( '%s useful companion', '%s useful companions', count( $featured ), 'logged-ai' ), number_format_i18n( count( $featured ) ) ) );
					?></span>
				</div>
				<div class="collection-grid"><?php foreach ( $featured as $slug => $product ) { self::card( $slug, $product ); } ?></div>
			</section>
			<section class="collection-more" aria-labelledby="lai-more-tools-heading">
				<div class="collection-section-heading">
					<div>
						<h2 id="lai-more-tools-heading"><?php esc_html_e( 'Explore more tools', 'logged-ai' ); ?></h2>
						<p><?php esc_html_e( 'For the other jobs your website needs to do.', 'logged-ai' ); ?></p>
					</div>
					<span class="collection-count"><?php
						/* translators: %s: number of remaining plugins after the featured companions. */
						echo esc_html( sprintf( _n( '%s more plugin', '%s more plugins', count( $remaining ), 'logged-ai' ), number_format_i18n( count( $remaining ) ) ) );
					?></span>
				</div>
				<div class="collection-grid"><?php foreach ( $remaining as $slug => $product ) { self::card( $slug, $product ); } ?></div>
			</section>
			<footer class="collection-footer">
				<p><?php esc_html_e( 'Choose the tools your website needs. Start with Free where available.', 'logged-ai' ); ?></p>
				<a href="<?php echo esc_url( 'https://plugins.shop/' ); ?>" target="_blank" rel="noopener noreferrer"><?php esc_html_e( 'Find your fit at Plugins.shop', 'logged-ai' ); ?> <span aria-hidden="true">↗</span><span class="screen-reader-text"> <?php esc_html_e( '(opens in a new tab)', 'logged-ai' ); ?></span></a>
			</footer>
		</main>
		<?php
	}

	/**
	 * Render one fixed catalogue entry with its locally bundled brand artwork.
	 *
	 * @param string $slug    Fixed catalogue identifier, never request input.
	 * @param array  $product Product from the bundled catalogue.
	 */
	private static function card( string $slug, array $product ): void {
		/* translators: %s: product brand name. */
		$link_label = sprintf( __( 'Explore plugin: %s (opens in a new tab)', 'logged-ai' ), $product['name'] );
		?>
		<article class="collection-card<?php echo $product['featured'] ? ' featured' : ''; ?>" data-product="<?php echo esc_attr( $slug ); ?>">
			<div class="collection-card-heading">
				<span class="collection-logo"><img src="<?php echo esc_url( plugins_url( 'assets/collection-logos/' . $slug . '.svg', LOGGED_AI_FILE ) ); ?>" alt="" width="34" height="34" decoding="async"></span>
				<div><h3><?php echo esc_html( $product['name'] ); ?></h3><p><?php echo esc_html( $product['category'] ); ?></p></div>
			</div>
			<p class="collection-description"><?php echo esc_html( $product['description'] ); ?></p>
			<?php if ( $product['featured'] ) : ?>
				<div class="collection-why"><strong><?php esc_html_e( 'WHY IT FITS', 'logged-ai' ); ?></strong><p><?php echo esc_html( $product['why'] ); ?></p></div>
			<?php endif; ?>
			<div class="collection-availability<?php echo $product['preview'] ? ' collection-preview-availability' : ''; ?>">
				<span><span aria-hidden="true"><?php echo $product['preview'] ? '◌' : '✓'; ?></span> <?php echo esc_html( $product['availability'] ); ?></span>
				<?php if ( '' !== $product['availability_detail'] ) : ?><span><?php echo esc_html( $product['availability_detail'] ); ?></span><?php endif; ?>
				<?php if ( '' !== $product['woocommerce'] ) : ?><span><?php echo esc_html( $product['woocommerce'] ); ?></span><?php endif; ?>
			</div>
			<a href="<?php echo esc_url( $product['url'] ); ?>" class="collection-link" target="_blank" rel="noopener noreferrer" aria-label="<?php echo esc_attr( $link_label ); ?>"><?php esc_html_e( 'Explore plugin', 'logged-ai' ); ?> <span aria-hidden="true">↗</span></a>
		</article>
		<?php
	}
}