wordpress-activitypub-event-bridge/includes/admin/class-settings-page.php

<?php
/**
 * General settings class.
 *
 * This file contains the General class definition, which handles the "General" settings
 * page for the ActivityPub Event Extension Plugin, providing options for configuring various general settings.
 *
 * @package Activitypub_Event_Extensions
 * @since 1.0.0
 */

namespace Activitypub_Event_Extensions\Admin;

// Exit if accessed directly.
defined( 'ABSPATH' ) || exit; // @codeCoverageIgnore

use Activitypub_Event_Extensions\Plugins\Event_Plugin;
use Activitypub_Event_Extensions\Setup;

/**
 * Class responsible for the ActivityPub Event Extension related Settings.
 *
 * Class which handles the "General" settings page for the ActivityPub Event Extension Plugin,
 * providing options for configuring various general settings.
 *
 * @since 1.0.0
 */
class Settings_Page {
	const STATIC = 'Activitypub_Event_Extensions\Admin\Settings_Page';

	const SETTINGS_SLUG = 'activitypub-event-extensions';
	/**
	 * Warning if the plugin is Active and the ActivityPub plugin is not.
	 *
	 * @return void
	 */
	public static function admin_menu(): void {
		\add_options_page(
			'Activitypub Event Extension',
			__( 'ActivityPub Events', 'activitypub-event-extensions' ),
			'manage_options',
			self::SETTINGS_SLUG,
			array( self::STATIC, 'settings_page' )
		);
	}

	/**
	 * Adds Link to the settings page in the plugin page.
	 * It's called via apply_filter('plugin_action_links_' . PLUGIN_NAME).
	 *
	 * @param array $links    Already added links.
	 *
	 * @return array          Original links but with link to setting page added.
	 */
	public static function settings_link( $links ): array {
		return array_merge(
			$links,
			array(
				'<a href="' . admin_url( 'options-general.php?page=' . self::SETTINGS_SLUG ) . '">Settings</a>',
			)
		);
	}

	/**
	 * Receive the event categories (terms) used by the event plugin.
	 *
	 * @param Event_Plugin $event_plugin Contains info about a certain event plugin.
	 *
	 * @return array An array of Terms.
	 */
	private static function get_event_terms( $event_plugin ): array {
		$taxonomy = $event_plugin::get_event_category_taxonomy();
		if ( $taxonomy ) {
			$event_terms = get_terms(
				array(
					'taxonomy'   => $taxonomy,
					'hide_empty' => true,
				)
			);
			return ! is_wp_error( $event_terms ) ? $event_terms : array();
		} else {
			return array();
		}
	}

	/**
	 * Preparing the data and loading the template for the settings page.
	 *
	 * @return void
	 */
	public static function settings_page(): void {
		$plugin_setup = Setup::get_instance();

		$event_plugins = $plugin_setup->get_active_event_plugins();

		$event_terms = array();

		foreach ( $event_plugins as $event_plugin ) {
			$event_terms = array_merge( $event_terms, self::get_event_terms( $event_plugin ) );
		}

		$args = array(
			'slug'        => self::SETTINGS_SLUG,
			'event_terms' => $event_terms,
		);

		\load_template( ACTIVITYPUB_EVENT_EXTENSIONS_PLUGIN_DIR . 'templates/settings.php', true, $args );
	}
}