'manual|day|week', 'count'=>int] public const KEY_STATUS = 'aipub_post_status'; // draft|pending|private|publish public const KEY_ATTACH = 'aipub_attachments'; // int[] media IDs public const KEY_BRAND = 'aipub_brand_strategy'; // array public const KEY_KEYWORDS = 'aipub_keywords'; // string[] /*-------------------------------------------------------------- * Register all settings *------------------------------------------------------------*/ public static function register(): void { register_setting( 'aipub_settings', self::KEY_LICENSE, [ 'type' => 'string', 'sanitize_callback' => 'sanitize_text_field', 'default' => '', ] ); register_setting( 'aipub_settings', self::KEY_API, [ 'type' => 'string', 'sanitize_callback' => [ __CLASS__, 'sanitize_api_key' ], ] ); register_setting( 'aipub_settings', self::KEY_MODEL, [ 'type' => 'string', 'sanitize_callback' => 'sanitize_text_field', 'default' => 'o1', ] ); register_setting( 'aipub_settings', self::KEY_SCHEDULE, [ 'type' => 'array', 'sanitize_callback' => [ __CLASS__, 'sanitize_schedule' ], 'default' => [ 'interval' => 'manual', 'count' => 0 ], ] ); register_setting( 'aipub_settings', self::KEY_STATUS, [ 'type' => 'string', 'sanitize_callback' => [ __CLASS__, 'sanitize_status' ], 'default' => 'pending', ] ); register_setting( 'aipub_settings', self::KEY_ATTACH, [ 'type' => 'array', 'sanitize_callback' => [ __CLASS__, 'sanitize_int_array' ], 'default' => [], ] ); register_setting( 'aipub_settings', self::KEY_BRAND, [ 'type' => 'array', 'sanitize_callback' => [ __CLASS__, 'sanitize_brand' ], 'default' => [], ] ); register_setting( 'aipub_settings', self::KEY_KEYWORDS, [ 'type' => 'array', 'sanitize_callback' => [ __CLASS__, 'sanitize_keywords' ], 'default' => [], ] ); } /*-------------------------------------------------------------- * Sanitisation callbacks *------------------------------------------------------------*/ public static function sanitize_api_key( $val ): string { $val = trim( $val ); return str_starts_with( $val, 'sk-' ) ? $val : ''; } public static function sanitize_schedule( $arr ): array { $interval = in_array( $arr['interval'] ?? 'manual', [ 'manual', 'day', 'week' ], true ) ? $arr['interval'] : 'manual'; $count = (int) ( $arr['count'] ?? 0 ); if ( 'manual' === $interval ) { $count = 0; } else { $max = ( 'day' === $interval ) ? 24 : 70; // spec: ≤24/day; weekly cap liberal $count = max( 1, min( $max, $count ) ); } return [ 'interval' => $interval, 'count' => $count ]; } public static function sanitize_status( $status ): string { $allowed = [ 'draft', 'pending', 'private', 'publish' ]; return in_array( $status, $allowed, true ) ? $status : 'pending'; } public static function sanitize_int_array( $arr ): array { return array_filter( array_map( 'intval', (array) $arr ) ); } public static function sanitize_keywords( $arr ): array { return array_values( array_unique( array_filter( array_map( 'sanitize_text_field', (array) $arr ) ) ) ); } /** * Sanitize the Brand Strategy option value. * * @param array $arr Raw array of brand elements. * @return array Sanitized array with textarea fields cleaned. */ public static function sanitize_brand( $arr ): array { $sanitized = []; foreach ( (array) $arr as $key => $value ) { $sanitized[ $key ] = sanitize_textarea_field( $value ); } return $sanitized; } /*-------------------------------------------------------------- * Getters *------------------------------------------------------------*/ public static function license(): string { return get_option( self::KEY_LICENSE, '' ); } public static function api_key(): string { return get_option( self::KEY_API, '' ); } public static function model(): string { return get_option( self::KEY_MODEL, 'o1' ); } public static function schedule(): array { return get_option( self::KEY_SCHEDULE, [ 'interval' => 'manual', 'count' => 0 ] ); } public static function post_status(): string { return get_option( self::KEY_STATUS, 'pending' ); } public static function attachments(): array { return get_option( self::KEY_ATTACH, [] ); } public static function brand(): array { return get_option( self::KEY_BRAND, [] ); } public static function keywords(): array { return get_option( self::KEY_KEYWORDS, [] ); } /** * Verify that the essential General Settings are saved. * Required fields per spec §4.1: api_key and model. * * @return bool True when all mandatory options are present. */ public static function is_complete(): bool { return ! empty( self::api_key() ) && ! empty( self::model() ); } } /* Bootstrap registration */ add_action( 'admin_init', [ \AiPublisher\Settings::class, 'register' ] );