334 lines
11 KiB
PHP
334 lines
11 KiB
PHP
<?php
|
|
/**
|
|
* Admin settings page (Settings → Font del Bosc Temps) and its AJAX
|
|
* endpoints for API key tests and nearest-station detection.
|
|
*
|
|
* @package FontdelboscEltemps
|
|
*/
|
|
|
|
defined( 'ABSPATH' ) || exit;
|
|
|
|
/**
|
|
* See the file header block for the class documentation.
|
|
*/
|
|
final class Fontdelbosc_Admin {
|
|
|
|
/**
|
|
* Registers the admin hooks.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function init(): void {
|
|
add_action( 'admin_menu', array( __CLASS__, 'add_settings_page' ) );
|
|
add_action( 'admin_init', array( __CLASS__, 'register_settings' ) );
|
|
add_action( 'admin_notices', array( __CLASS__, 'maybe_show_notice' ) );
|
|
add_action( 'wp_ajax_fontdelbosc_test_api', array( __CLASS__, 'ajax_test_api' ) );
|
|
add_action( 'wp_ajax_fontdelbosc_find_station', array( __CLASS__, 'ajax_find_station' ) );
|
|
}
|
|
|
|
/**
|
|
* Adds the settings page under Settings.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function add_settings_page(): void {
|
|
add_options_page(
|
|
'Font del Bosc — El Temps',
|
|
'Font del Bosc Temps',
|
|
'manage_options',
|
|
'fontdelbosc-eltemps',
|
|
array( __CLASS__, 'render_settings_page' )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Renders the settings page view.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function render_settings_page(): void {
|
|
if ( ! current_user_can( 'manage_options' ) ) {
|
|
return;
|
|
}
|
|
|
|
require FONTDELBOSC_ELTEMPS_PLUGIN_DIR . 'admin/views/settings-page.php';
|
|
}
|
|
|
|
/**
|
|
* Registers the option group, sections and fields via the Settings API.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function register_settings(): void {
|
|
register_setting(
|
|
'fdb_settings',
|
|
'fontdelbosc_options',
|
|
array(
|
|
'sanitize_callback' => array( __CLASS__, 'sanitize' ),
|
|
'show_in_rest' => false,
|
|
)
|
|
);
|
|
|
|
add_settings_section( 'fdb_section_keys', __( 'API Keys', 'fontdelbosc-eltemps' ), '__return_false', 'fontdelbosc-eltemps' );
|
|
add_settings_section( 'fdb_section_cache', __( 'Cache Settings', 'fontdelbosc-eltemps' ), '__return_false', 'fontdelbosc-eltemps' );
|
|
add_settings_section( 'fdb_section_display', __( 'Display Options', 'fontdelbosc-eltemps' ), '__return_false', 'fontdelbosc-eltemps' );
|
|
|
|
add_settings_field( 'fdb_field_aemet_key', __( 'AEMET API key', 'fontdelbosc-eltemps' ), array( __CLASS__, 'field_aemet_key' ), 'fontdelbosc-eltemps', 'fdb_section_keys' );
|
|
add_settings_field( 'fdb_field_meteocat_key', __( 'Meteocat API key', 'fontdelbosc-eltemps' ), array( __CLASS__, 'field_meteocat_key' ), 'fontdelbosc-eltemps', 'fdb_section_keys' );
|
|
add_settings_field( 'fdb_field_ttl_current', __( 'Current conditions cache (seconds)', 'fontdelbosc-eltemps' ), array( __CLASS__, 'field_ttl_current' ), 'fontdelbosc-eltemps', 'fdb_section_cache' );
|
|
add_settings_field( 'fdb_field_ttl_forecast', __( 'Forecast cache (seconds)', 'fontdelbosc-eltemps' ), array( __CLASS__, 'field_ttl_forecast' ), 'fontdelbosc-eltemps', 'fdb_section_cache' );
|
|
add_settings_field( 'fdb_field_ttl_historical', __( 'Historical data cache (seconds)', 'fontdelbosc-eltemps' ), array( __CLASS__, 'field_ttl_historical' ), 'fontdelbosc-eltemps', 'fdb_section_cache' );
|
|
add_settings_field( 'fdb_field_attribution', __( 'Display Options', 'fontdelbosc-eltemps' ), array( __CLASS__, 'field_attribution' ), 'fontdelbosc-eltemps', 'fdb_section_display' );
|
|
add_settings_field( 'fdb_field_delete', __( 'Uninstall', 'fontdelbosc-eltemps' ), array( __CLASS__, 'field_delete' ), 'fontdelbosc-eltemps', 'fdb_section_display' );
|
|
}
|
|
|
|
/**
|
|
* Sanitizes the option array on save.
|
|
*
|
|
* @param mixed $input Raw input.
|
|
* @return array<string,mixed>
|
|
*/
|
|
public static function sanitize( mixed $input ): array {
|
|
$input = is_array( $input ) ? $input : array();
|
|
$old = (array) get_option( 'fontdelbosc_options', array() );
|
|
|
|
$aemet_key = sanitize_text_field( Fontdelbosc_Payload::str( Fontdelbosc_Payload::get( $input, 'aemet_api_key' ) ) ?? '' );
|
|
$meteo_key = sanitize_text_field( Fontdelbosc_Payload::str( Fontdelbosc_Payload::get( $input, 'meteocat_api_key' ) ) ?? '' );
|
|
|
|
return array(
|
|
'aemet_api_key' => '' === $aemet_key ? Fontdelbosc_Payload::str( Fontdelbosc_Payload::get( $old, 'aemet_api_key' ) ) ?? '' : $aemet_key,
|
|
'meteocat_api_key' => '' === $meteo_key ? Fontdelbosc_Payload::str( Fontdelbosc_Payload::get( $old, 'meteocat_api_key' ) ) ?? '' : $meteo_key,
|
|
'meteocat_station_code' => sanitize_text_field( Fontdelbosc_Payload::str( Fontdelbosc_Payload::get( $old, 'meteocat_station_code' ) ) ?? '' ),
|
|
'cache_ttl_current' => max( 60, min( 86400, Fontdelbosc_Payload::int( Fontdelbosc_Payload::get( $input, 'cache_ttl_current' ) ) ?? 600 ) ),
|
|
'cache_ttl_forecast' => max( 60, min( 86400, Fontdelbosc_Payload::int( Fontdelbosc_Payload::get( $input, 'cache_ttl_forecast' ) ) ?? 3600 ) ),
|
|
'cache_ttl_historical' => max( 60, min( 604800, Fontdelbosc_Payload::int( Fontdelbosc_Payload::get( $input, 'cache_ttl_historical' ) ) ?? 86400 ) ),
|
|
'display_attribution' => ! empty( Fontdelbosc_Payload::get( $input, 'display_attribution' ) ),
|
|
'delete_data_on_uninstall' => ! empty( Fontdelbosc_Payload::get( $input, 'delete_data_on_uninstall' ) ),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Renders the AEMET API key field. The stored key is never rendered;
|
|
* only its last 4 characters are shown as a hint.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function field_aemet_key(): void {
|
|
$key = Fontdelbosc_Plugin::get_options()['aemet_api_key'];
|
|
|
|
printf(
|
|
'<input type="password" autocomplete="new-password" class="regular-text" name="fontdelbosc_options[aemet_api_key]" value="" />'
|
|
);
|
|
|
|
self::key_hint( $key );
|
|
|
|
echo '<p class="description"><a href="https://opendata.aemet.es/centrodedescargas/altaUsuario" target="_blank" rel="noopener noreferrer">opendata.aemet.es</a></p>';
|
|
}
|
|
|
|
/**
|
|
* Renders the Meteocat API key field. The stored key is never rendered;
|
|
* only its last 4 characters are shown as a hint.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function field_meteocat_key(): void {
|
|
$key = Fontdelbosc_Plugin::get_options()['meteocat_api_key'];
|
|
|
|
printf(
|
|
'<input type="password" autocomplete="new-password" class="regular-text" name="fontdelbosc_options[meteocat_api_key]" value="" />'
|
|
);
|
|
|
|
self::key_hint( $key );
|
|
|
|
echo '<p class="description"><a href="https://apidocs.meteocat.gencat.cat/" target="_blank" rel="noopener noreferrer">apidocs.meteocat.gencat.cat</a></p>';
|
|
}
|
|
|
|
/**
|
|
* Prints the "current key" hint when a key is stored, leaving the field
|
|
* itself empty so submitting the form without retyping keeps the key.
|
|
*
|
|
* @param string $key Stored API key.
|
|
* @return void
|
|
*/
|
|
private static function key_hint( string $key ): void {
|
|
if ( '' === $key ) {
|
|
return;
|
|
}
|
|
|
|
printf(
|
|
'<p class="description">%s</p>',
|
|
sprintf(
|
|
/* translators: %s: last 4 characters of the stored API key. */
|
|
esc_html__( 'Current key ends in …%s', 'fontdelbosc-eltemps' ),
|
|
esc_html( substr( $key, -4 ) )
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Renders the current conditions TTL field.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function field_ttl_current(): void {
|
|
$value = Fontdelbosc_Plugin::get_options()['cache_ttl_current'];
|
|
|
|
printf(
|
|
'<input type="number" min="60" max="86400" step="10" class="small-text" name="fontdelbosc_options[cache_ttl_current]" value="%d" />',
|
|
esc_attr( (string) $value )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Renders the forecast TTL field.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function field_ttl_forecast(): void {
|
|
$value = Fontdelbosc_Plugin::get_options()['cache_ttl_forecast'];
|
|
|
|
printf(
|
|
'<input type="number" min="60" max="86400" step="10" class="small-text" name="fontdelbosc_options[cache_ttl_forecast]" value="%d" />',
|
|
esc_attr( (string) $value )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Renders the historical data TTL field.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function field_ttl_historical(): void {
|
|
$value = Fontdelbosc_Plugin::get_options()['cache_ttl_historical'];
|
|
|
|
printf(
|
|
'<input type="number" min="60" max="604800" step="10" class="small-text" name="fontdelbosc_options[cache_ttl_historical]" value="%d" />',
|
|
esc_attr( (string) $value )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Renders the attribution toggle.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function field_attribution(): void {
|
|
$options = Fontdelbosc_Plugin::get_options();
|
|
|
|
printf(
|
|
'<label><input type="checkbox" name="fontdelbosc_options[display_attribution]" value="1" %s /> %s</label>',
|
|
checked( ! empty( $options['display_attribution'] ), true, false ),
|
|
esc_html__( 'Show data source attribution', 'fontdelbosc-eltemps' )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Renders the uninstall data-deletion toggle.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function field_delete(): void {
|
|
$options = Fontdelbosc_Plugin::get_options();
|
|
|
|
printf(
|
|
'<label><input type="checkbox" name="fontdelbosc_options[delete_data_on_uninstall]" value="1" %s /> %s</label>',
|
|
checked( ! empty( $options['delete_data_on_uninstall'] ), true, false ),
|
|
esc_html__( 'Delete all plugin data on uninstall', 'fontdelbosc-eltemps' )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Shows an informational notice when no API key is configured and the
|
|
* plugin is running on the Open-Meteo fallback.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function maybe_show_notice(): void {
|
|
if ( ! current_user_can( 'manage_options' ) ) {
|
|
return;
|
|
}
|
|
|
|
$options = Fontdelbosc_Plugin::get_options();
|
|
|
|
if ( '' !== $options['aemet_api_key'] || '' !== $options['meteocat_api_key'] ) {
|
|
return;
|
|
}
|
|
|
|
$screen = get_current_screen();
|
|
|
|
if ( null === $screen || ! in_array( $screen->base, array( 'plugins', 'dashboard', 'options-general' ), true ) ) {
|
|
return;
|
|
}
|
|
|
|
printf(
|
|
'<div class="notice notice-info is-dismissible"><p>%s</p></div>',
|
|
esc_html__( 'No weather API keys are configured. Data is served by Open-Meteo (no key required).', 'fontdelbosc-eltemps' )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* AJAX handler: tests an API source connectivity.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function ajax_test_api(): void {
|
|
check_ajax_referer( 'fontdelbosc_admin', 'nonce' );
|
|
|
|
if ( ! current_user_can( 'manage_options' ) ) {
|
|
wp_send_json_error( array( 'message' => 'forbidden' ) );
|
|
}
|
|
|
|
$raw = isset( $_POST['source'] ) && is_string( $_POST['source'] ) ? wp_unslash( $_POST['source'] ) : '';
|
|
$source = sanitize_key( $raw );
|
|
$options = Fontdelbosc_Plugin::get_options();
|
|
$ok = false;
|
|
|
|
switch ( $source ) {
|
|
case 'aemet':
|
|
$ok = '' !== $options['aemet_api_key'] && null !== Fontdelbosc_Api_Aemet::get_daily( $options['aemet_api_key'] );
|
|
break;
|
|
case 'meteocat':
|
|
$ok = '' !== $options['meteocat_api_key'] && null !== Fontdelbosc_Api_Meteocat::get_hourly( $options['meteocat_api_key'] );
|
|
break;
|
|
case 'open-meteo':
|
|
$ok = null !== Fontdelbosc_Api_OpenMeteo::get_current();
|
|
break;
|
|
}
|
|
|
|
if ( $ok ) {
|
|
wp_send_json_success( array( 'message' => 'ok' ) );
|
|
}
|
|
|
|
wp_send_json_error( array( 'message' => 'failed' ) );
|
|
}
|
|
|
|
/**
|
|
* AJAX handler: finds and stores the XEMA station closest to Font del Bosc.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function ajax_find_station(): void {
|
|
check_ajax_referer( 'fontdelbosc_admin', 'nonce' );
|
|
|
|
if ( ! current_user_can( 'manage_options' ) ) {
|
|
wp_send_json_error( array( 'message' => 'forbidden' ) );
|
|
}
|
|
|
|
$options = Fontdelbosc_Plugin::get_options();
|
|
|
|
if ( '' === $options['meteocat_api_key'] ) {
|
|
wp_send_json_error( array( 'message' => 'no-key' ) );
|
|
}
|
|
|
|
$station = Fontdelbosc_Api_Meteocat::find_nearest_station( $options['meteocat_api_key'] );
|
|
|
|
if ( null === $station ) {
|
|
wp_send_json_error( array( 'message' => 'failed' ) );
|
|
}
|
|
|
|
$options['meteocat_station_code'] = $station['codi'];
|
|
update_option( 'fontdelbosc_options', $options );
|
|
|
|
wp_send_json_success( $station );
|
|
}
|
|
}
|