ServicesManager.php

<?php
/**
 * This class manages the known services that ClassifAI provides
 */

namespace Classifai\Services;

use function Classifai\should_use_legacy_settings_panel;
use function Classifai\safe_wp_remote_post;

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

class ServicesManager {

	/**
	 * @var array List of registered services
	 */
	public $services = [];

	/**
	 * @var array List of class instances being managed.
	 */
	public $service_classes;

	/**
	 * @var string Page title for the admin page
	 */
	protected $title;

	/**
	 * @var string Menu title of the admin page.
	 */
	protected $menu_title;

	/**
	 * ServicesManager constructor.
	 *
	 * @param array $services The list of services available.
	 */
	public function __construct( array $services = [] ) {
		$this->services        = $services;
		$this->service_classes = [];
		$this->get_menu_title();
	}

	/**
	 * Register the actions required for the settings page.
	 */
	public function register() {
		add_filter( 'language_processing_features', [ $this, 'register_language_processing_features' ] );
		add_filter( 'image_processing_features', [ $this, 'register_image_processing_features' ] );
		add_filter( 'content_recommendation_features', [ $this, 'register_recommendation_service_features' ] );

		foreach ( $this->services as $key => $service ) {
			if ( class_exists( $service ) ) {
				$this->service_classes[ $key ] = new $service();
			}
		}

		if ( should_use_legacy_settings_panel() ) {
			// Do the settings pages.
			$this->do_settings();
		}

		// Register the functionality
		$this->register_services();

		add_filter( 'classifai_debug_information', [ $this, 'add_debug_information' ], 1 );
	}

	/**
	 * Registers features under the Language Processing Service.
	 *
	 * @param array $features The list of features to be registered.
	 * @return array
	 */
	public function register_language_processing_features( array $features ): array {
		$core_features = [
			'\Classifai\Features\Classification',
			'\Classifai\Features\TitleGeneration',
			'\Classifai\Features\ExcerptGeneration',
			'\Classifai\Features\ContentGeneration',
			'\Classifai\Features\ContentResizing',
			'\Classifai\Features\KeyTakeaways',
			'\Classifai\Features\TextToSpeech',
			'\Classifai\Features\AudioTranscriptsGeneration',
			'\Classifai\Features\Moderation',
			'\Classifai\Features\Smart404',
			'\Classifai\Features\TermCleanup',
		];

		foreach ( $core_features as $feature ) {
			$features[] = $feature;
		}

		return $features;
	}

	/**
	 * Registers features under the Image Processing Service.
	 *
	 * @param array $features The list of features to be registered.
	 * @return array
	 */
	public function register_image_processing_features( array $features ): array {
		$core_features = [
			'\Classifai\Features\DescriptiveTextGenerator',
			'\Classifai\Features\ImageTagsGenerator',
			'\Classifai\Features\ImageCropping',
			'\Classifai\Features\ImageTextExtraction',
			'\Classifai\Features\ImageGeneration',
			'\Classifai\Features\PDFTextExtraction',
		];

		foreach ( $core_features as $feature ) {
			$features[] = $feature;
		}

		return $features;
	}

	/**
	 * Registers features under the Recommendation Service.
	 *
	 * @param array $features The list of features to be registered.
	 * @return array
	 */
	public function register_recommendation_service_features( array $features ): array {
		$core_features = [
			'\Classifai\Features\RecommendedContent',
		];

		foreach ( $core_features as $feature ) {
			$features[] = $feature;
		}

		return $features;
	}

	/**
	 * Get general ClassifAI settings
	 *
	 * @param string|bool $index Optional specific setting to be retrieved. If false, all settings will be returned.
	 * @return mixed
	 */
	public function get_settings( $index = false ) {
		$settings = get_option( 'classifai_settings', [] );

		// Special handling polyfill for pre-1.3 settings which were nested
		if ( ! isset( $settings['email'] ) && isset( $settings['registration']['email'] ) ) {
			$settings['email'] = $settings['registration']['email'];
		}

		if ( ! isset( $settings['license_key'] ) && isset( $settings['registration']['license_key'] ) ) {
			$settings['license_key'] = $settings['registration']['license_key'];
		}

		if ( ! $index ) {
			return $settings;
		} elseif ( ! isset( $settings[ $index ] ) ) {
			return '';
		} else {
			return $settings[ $index ];
		}
	}

	/**
	 * Create the settings pages.
	 */
	public function do_settings() {
		add_action( 'admin_menu', [ $this, 'register_admin_menu_item' ] );
		add_action( 'admin_init', [ $this, 'register_settings' ] );
		add_action( 'admin_init', [ $this, 'setup_fields_sections' ] );
	}

	/**
	 * Register the settings and sanitization callback method.
	 */
	public function register_settings() {
		register_setting( 'classifai_settings', 'classifai_settings', [ $this, 'sanitize_settings' ] );
	}

	/**
	 * Sanitize settings.
	 *
	 * @param mixed $settings The settings to be sanitized.
	 * @return array
	 */
	public function sanitize_settings( $settings ): array {
		$new_settings = [];

		// Save registration settings.
		if ( ! empty( $settings['email'] )
			&& ! empty( $settings['license_key'] )
			&& $this->check_license_key( $settings['email'], $settings['license_key'] )
		) {
			$new_settings['valid_license'] = true;
			$new_settings['email']         = sanitize_text_field( $settings['email'] );
			$new_settings['license_key']   = sanitize_text_field( $settings['license_key'] );
		} else {
			$new_settings['valid_license'] = false;
			$new_settings['email']         = isset( $settings['email'] ) ? sanitize_text_field( $settings['email'] ) : '';
			$new_settings['license_key']   = isset( $settings['license_key'] ) ? sanitize_text_field( $settings['license_key'] ) : '';

			add_settings_error(
				'registration',
				'classifai-registration',
				esc_html__( 'Invalid ClassifAI registration info. Please check and try again.', 'classifai' ),
				'error'
			);
		}

		// Save block AI bots setting.
		$new_settings['block_ai_bots'] = $settings['block_ai_bots'] ?? '0';

		return $new_settings;
	}

	/**
	 * Setup fields
	 */
	public function setup_fields_sections() {
		add_settings_section( 'classifai_settings', 'ClassifAI Settings', '', 'classifai_settings' );

		add_settings_field(
			'email',
			esc_html__( 'Registered Email', 'classifai' ),
			[ $this, 'render_email_field' ],
			'classifai_settings',
			'classifai_settings',
			[
				'label_for'    => 'email',
				'option_index' => 'registration',
				'input_type'   => 'text',
			]
		);

		add_settings_field(
			'registration-key',
			esc_html__( 'Registration Key', 'classifai' ),
			[ $this, 'render_password_field' ],
			'classifai_settings',
			'classifai_settings',
			[
				'label_for'    => 'license_key',
				'option_index' => 'registration',
				'input_type'   => 'password',
				'description'  => __( 'Registration is 100% free and provides update notifications and upgrades inside the dashboard.<br /><a href="https://classifaiplugin.com/#cta">Register for your key</a>', 'classifai' ),
			]
		);
	}

	/**
	 * Render the email field
	 */
	public function render_email_field() {
		$email = $this->get_settings( 'email' );
		?>
		<input type="text" name="classifai_settings[email]" class="regular-text" value="<?php echo esc_attr( $email ); ?>"/>
		<?php
	}

	/**
	 * Render the password field
	 */
	public function render_password_field() {
		$license_key = $this->get_settings( 'license_key' );
		?>
		<input type="password" name="classifai_settings[license_key]" class="regular-text" value="<?php echo esc_attr( $license_key ); ?>"/>
		<br /><span class="description"><?php _e( __( 'Registration is 100% free and provides update notifications and upgrades inside the dashboard.<br /><a href="https://classifaiplugin.com/#cta">Register for your key</a>', 'classifai' ) );// @codingStandardsIgnoreLine ?></span>
		<?php
	}

	/**
	 * Initialize the services.
	 */
	protected function register_services() {
		foreach ( $this->service_classes as $service_class ) {
			$service_class->init();
		}
	}

	/**
	 * Helper to return the $menu title
	 */
	protected function get_menu_title() {
		$registration_settings = get_option( 'classifai_settings' );
		$this->title           = esc_html__( 'ClassifAI', 'classifai' );
		$this->menu_title      = $this->title;

		if ( ! isset( $registration_settings['valid_license'] ) || ! $registration_settings['valid_license'] ) {
			/*
			 * Translators: Main title.
			 */
			$this->menu_title = sprintf( __( 'ClassifAI %s', 'classifai' ), '<span class="update-plugins"><span class="update-count">!</span></span>' );
		}
	}

	/**
	 * Return the list of registered services.
	 *
	 * @return array
	 */
	public function get_services(): array {
		return $this->services;
	}

	/**
	 * Register a sub page.
	 */
	public function register_admin_menu_item() {
		add_submenu_page(
			'tools.php',
			$this->title,
			$this->menu_title,
			'manage_options',
			'classifai',
			[ $this, 'render_settings_page' ]
		);
	}

	/**
	 * Render the main settings page for the Classifai plugin.
	 */
	public function render_settings_page() {

		if ( count( $this->services ) > 1 ) {
			// phpcs:ignore WordPress.Security.NonceVerification.Recommended
			$service = isset( $_GET['tab'] ) ? sanitize_text_field( wp_unslash( $_GET['tab'] ) ) : 'classifai_settings';
			if ( ! empty( $service ) && isset( $this->service_classes[ $service ] ) ) {
				// Render settings page for a specific service.
				$this->service_classes[ $service ]->render_settings_page();
				return;
			} else {
				?>
				<div class="classifai-content">
					<?php
					include_once CLASSIFAI_PLUGIN_DIR . '/includes/Classifai/Admin/templates/classifai-header.php';
					?>
					<div class="classifai-wrap wrap">
						<?php settings_errors(); ?>
						<form method="post" action="options.php">
							<?php
							settings_fields( 'classifai_settings' );
							do_settings_sections( 'classifai_settings' );
							submit_button();
							?>
						</form>
					</div>
				</div>
				<?php
			}
		} else {
			// Render settings page for the first (and only) settings page.
			$this->service_classes[0]->render_settings_page();
		}
	}

	/**
	 * Hit license API to see if key/email is valid
	 *
	 * @since  1.2
	 *
	 * @param string $email Email address.
	 * @param string $license_key License key.
	 * @return bool
	 */
	public function check_license_key( string $email, string $license_key ): bool {

		$request = safe_wp_remote_post(
			'https://classifaiplugin.com/wp-json/classifai-theme/v1/validate-license',
			[
				'timeout' => 10, // phpcs:ignore WordPressVIPMinimum.Performance.RemoteRequestTimeout.timeout_timeout
				'body'    => [
					'license_key' => $license_key,
					'email'       => $email,
				],
				'use_vip' => true,
			]
		);

		if ( is_wp_error( $request ) ) {
			return false;
		}

		if ( 200 === wp_remote_retrieve_response_code( $request ) ) {
			return true;
		}

		return false;
	}

	/**
	 * Adds debug information to the ClassifAI Site Health screen.
	 *
	 * @since 1.4.0
	 *
	 * @param array      $debug_information Array of lines representing debug information.
	 * @param array|null $settings Settings array. If empty, will be fetched.
	 * @return array Array with lines added.
	 */
	public function add_debug_information( array $debug_information, $settings = null ): array {
		if ( is_null( $settings ) ) {
			$settings = $this->sanitize_settings( $this->get_settings() );
		}

		$valid_license       = intval( $settings['valid_license'] ?? 0 );
		$valid_license_text  = 1 === $valid_license ? __( 'yes', 'classifai' ) : __( 'no', 'classifai' );
		$debug_information[] = [
			'label' => __( 'Valid license', 'classifai' ),
			'value' => $valid_license_text,
		];

		$debug_information[] = [
			'label' => __( 'Email', 'classifai' ),
			'value' => $settings['email'] ?? '',
		];

		return $debug_information;
	}
}