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

110 lines
2.9 KiB
PHP
Raw Permalink Normal View History

2024-07-17 16:17:54 +02:00
<?php
/**
2024-08-15 15:59:58 +02:00
* General settings class.
2024-07-17 16:17:54 +02:00
*
2024-08-15 15:59:58 +02:00
* 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.
2024-07-17 16:17:54 +02:00
*
* @package Activitypub_Event_Extensions
* @since 1.0.0
*/
namespace Activitypub_Event_Extensions\Admin;
2024-08-15 15:59:58 +02:00
// Exit if accessed directly.
defined( 'ABSPATH' ) || exit; // @codeCoverageIgnore
2024-07-17 16:17:54 +02:00
use Activitypub_Event_Extensions\Plugins\Event_Plugin;
use Activitypub_Event_Extensions\Setup;
2024-07-17 16:17:54 +02:00
/**
2024-09-11 07:59:53 +02:00
* Class responsible for the ActivityPub Event Extension related Settings.
2024-07-17 16:17:54 +02:00
*
2024-09-11 07:59:53 +02:00
* Class which handles the "General" settings page for the ActivityPub Event Extension Plugin,
* providing options for configuring various general settings.
2024-07-17 16:17:54 +02:00
*
* @since 1.0.0
*/
class Settings_Page {
2024-08-15 15:59:58 +02:00
const STATIC = 'Activitypub_Event_Extensions\Admin\Settings_Page';
2024-08-27 21:23:33 +02:00
const SETTINGS_SLUG = 'activitypub-event-extensions';
2024-07-17 16:17:54 +02:00
/**
* Warning if the plugin is Active and the ActivityPub plugin is not.
2024-09-11 07:59:53 +02:00
*
* @return void
2024-07-17 16:17:54 +02:00
*/
2024-09-11 07:59:53 +02:00
public static function admin_menu(): void {
2024-07-17 16:17:54 +02:00
\add_options_page(
'Activitypub Event Extension',
__( 'ActivityPub Events', 'activitypub-event-extensions' ),
2024-07-17 16:17:54 +02:00
'manage_options',
2024-08-15 15:59:58 +02:00
self::SETTINGS_SLUG,
array( self::STATIC, 'settings_page' )
2024-07-17 16:17:54 +02:00
);
}
/**
* Adds Link to the settings page in the plugin page.
* It's called via apply_filter('plugin_action_links_' . PLUGIN_NAME).
*
2024-08-15 15:59:58 +02:00
* @param array $links Already added links.
2024-09-11 07:59:53 +02:00
*
2024-08-15 15:59:58 +02:00
* @return array Original links but with link to setting page added.
*/
2024-09-11 07:59:53 +02:00
public static function settings_link( $links ): array {
return array_merge(
$links,
array(
2024-08-15 15:59:58 +02:00
'<a href="' . admin_url( 'options-general.php?page=' . self::SETTINGS_SLUG ) . '">Settings</a>',
)
);
}
2024-07-17 16:17:54 +02:00
2024-08-27 21:23:33 +02:00
/**
* Receive the event categories (terms) used by the event plugin.
*
* @param Event_Plugin $event_plugin Contains info about a certain event plugin.
2024-08-27 21:23:33 +02:00
*
* @return array An array of Terms.
*/
2024-09-11 07:59:53 +02:00
private static function get_event_terms( $event_plugin ): array {
2024-09-18 21:26:53 +02:00
$taxonomy = $event_plugin::get_event_category_taxonomy();
if ( $taxonomy ) {
2024-08-27 21:23:33 +02:00
$event_terms = get_terms(
array(
'taxonomy' => $taxonomy,
2024-08-27 21:23:33 +02:00
'hide_empty' => true,
)
);
return ! is_wp_error( $event_terms ) ? $event_terms : array();
2024-07-17 16:17:54 +02:00
} else {
2024-08-27 21:23:33 +02:00
return array();
2024-07-17 16:17:54 +02:00
}
2024-08-27 21:23:33 +02:00
}
2024-07-17 16:17:54 +02:00
2024-08-27 21:23:33 +02:00
/**
2024-09-11 07:59:53 +02:00
* Preparing the data and loading the template for the settings page.
*
* @return void
2024-08-27 21:23:33 +02:00
*/
2024-09-11 07:59:53 +02:00
public static function settings_page(): void {
2024-08-27 21:23:33 +02:00
$plugin_setup = Setup::get_instance();
2024-07-17 16:17:54 +02:00
2024-08-27 21:23:33 +02:00
$event_plugins = $plugin_setup->get_active_event_plugins();
2024-07-17 16:17:54 +02:00
2024-08-27 21:23:33 +02:00
$event_terms = array();
foreach ( $event_plugins as $event_plugin ) {
$event_terms = array_merge( $event_terms, self::get_event_terms( $event_plugin ) );
2024-08-27 21:23:33 +02:00
}
2024-07-17 16:17:54 +02:00
2024-07-18 17:46:29 +02:00
$args = array(
2024-08-27 21:23:33 +02:00
'slug' => self::SETTINGS_SLUG,
'event_terms' => $event_terms,
2024-07-18 17:46:29 +02:00
);
2024-07-17 16:17:54 +02:00
2024-08-27 21:23:33 +02:00
\load_template( ACTIVITYPUB_EVENT_EXTENSIONS_PLUGIN_DIR . 'templates/settings.php', true, $args );
2024-07-17 16:17:54 +02:00
}
}