array( __CLASS__, 'sanitize_design' ) ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_bg_type', array( 'sanitize_callback' => array( __CLASS__, 'sanitize_bg_type' ) ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_bg_color', array( 'sanitize_callback' => 'sanitize_hex_color' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_bg_image', array( 'sanitize_callback' => 'esc_url_raw' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_heading_text', array( 'sanitize_callback' => 'sanitize_text_field' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_grant_text', array( 'sanitize_callback' => 'sanitize_text_field' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_primary_color', array( 'sanitize_callback' => 'sanitize_hex_color' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_secondary_color', array( 'sanitize_callback' => 'sanitize_hex_color' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_participation_text', array( 'sanitize_callback' => 'wp_kses_post' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_enable_signature', array( 'type' => 'integer', 'sanitize_callback' => array( __CLASS__, 'sanitize_checkbox' ), ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_signature_image', array( 'sanitize_callback' => 'esc_url_raw' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_signature_name', array( 'sanitize_callback' => 'sanitize_text_field' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_signature_desc', array( 'sanitize_callback' => 'sanitize_text_field' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_header_type', array( 'sanitize_callback' => array( __CLASS__, 'sanitize_header_type' ) ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_logo', array( 'sanitize_callback' => 'esc_url_raw' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_logo_width', array( 'sanitize_callback' => 'absint' ) ); register_setting( 'aimslms_certificate_settings', 'aimslms_cert_bg_image_opacity', array( 'sanitize_callback' => array( __CLASS__, 'sanitize_opacity' ) ) ); } /** * Restricts the certificate design option to a known template key. * * @param string $value Submitted design key. * @return string Sanitized design key, defaulting to 'modern'. */ public static function sanitize_design( $value ) { $allowed = array( 'modern', 'classic', 'elegant' ); $value = sanitize_key( $value ); return in_array( $value, $allowed, true ) ? $value : 'modern'; } /** * Restricts the certificate background type option to a known value. * * @param string $value Submitted background type. * @return string Sanitized background type, defaulting to 'color'. */ public static function sanitize_bg_type( $value ) { $allowed = array( 'color', 'image' ); $value = sanitize_key( $value ); return in_array( $value, $allowed, true ) ? $value : 'color'; } /** * Restricts the certificate header type option to a known value. * * @param string $value Submitted header type. * @return string Sanitized header type, defaulting to 'title'. */ public static function sanitize_header_type( $value ) { $allowed = array( 'logo', 'title' ); $value = sanitize_key( $value ); return in_array( $value, $allowed, true ) ? $value : 'title'; } /** * Normalizes the "enable signature" checkbox to a strict 1/0. * * @param mixed $value Submitted checkbox value. * @return int 1 if checked, 0 otherwise. */ public static function sanitize_checkbox( $value ) { return '1' === (string) $value ? 1 : 0; } /** * Clamps the certificate background image opacity to the 0.1–1 range * used by the settings slider. * * @param mixed $value Submitted opacity value. * @return float Sanitized opacity between 0.1 and 1. */ public static function sanitize_opacity( $value ) { $value = (float) $value; return max( 0.1, min( 1, $value ) ); } /** * Renders the certificate settings screen and the preview link. * * @return void */ public static function render() { $site_logo_id = get_theme_mod( 'custom_logo' ); $site_logo = $site_logo_id ? wp_get_attachment_image_url( $site_logo_id, 'full' ) : ''; $designs = AIMSLMS_Certificate_Generator::get_designs(); $current_design = get_option( 'aimslms_cert_design', 'modern' ); // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- read-only display flag set by WP's own options.php redirect, on a manage_options-gated screen. if ( isset( $_GET['settings-updated'] ) ) { echo '
' . esc_html__( 'Certificate settings saved.', 'aims-infosoft-lms' ) . '