(string) get_bloginfo( 'name' ), 'from_email' => (string) get_option( 'admin_email' ), 'subject' => __( 'Your proof is ready to review — order {order_number}', 'proofkit' ), 'link_expiry_days' => 30, 'max_size_mb' => 25, 'allowed_exts' => array( 'pdf', 'ai', 'eps', 'png', 'jpg', 'jpeg', 'tif', 'tiff' ), 'enable_svg' => 0, 'delete_data' => 0, 'retention_months' => 12, ); } /** * Returns defaults merged with the stored option. * * @return array */ public static function all(): array { if ( null !== self::$cache ) { return self::$cache; } $stored = get_option( self::OPTION, array() ); if ( ! is_array( $stored ) ) { $stored = array(); } $settings = array_merge( self::defaults(), $stored ); $exts = $settings['allowed_exts']; if ( ! is_array( $exts ) && ! is_string( $exts ) ) { $exts = array(); } $settings['allowed_exts'] = self::normalise_extensions( $exts ); self::$cache = $settings; return self::$cache; } /** * Returns one setting value. * * @param string $key Setting key. * @param mixed $default Fallback when the key is unknown. * @return mixed */ public static function get( string $key, mixed $default = null ): mixed { $all = self::all(); return array_key_exists( $key, $all ) ? $all[ $key ] : $default; } /** * Sanitises and saves settings, dropping unknown keys. * * @param array $data Raw settings data. * @return void */ public static function update( array $data ): void { $defaults = self::defaults(); $current = self::all(); $clean = array(); foreach ( $defaults as $key => $default ) { $clean[ $key ] = array_key_exists( $key, $current ) ? $current[ $key ] : $default; } if ( array_key_exists( 'from_name', $data ) ) { $clean['from_name'] = self::sanitise_text( $data['from_name'] ); } if ( array_key_exists( 'from_email', $data ) ) { $clean['from_email'] = sanitize_email( self::scalar_string( $data['from_email'] ) ); } if ( array_key_exists( 'subject', $data ) ) { $clean['subject'] = self::sanitise_text( $data['subject'] ); } if ( array_key_exists( 'link_expiry_days', $data ) ) { $clean['link_expiry_days'] = self::clamp_int( $data['link_expiry_days'], 1, 365 ); } if ( array_key_exists( 'max_size_mb', $data ) ) { $clean['max_size_mb'] = self::clamp_int( $data['max_size_mb'], 1, 100 ); } if ( array_key_exists( 'retention_months', $data ) ) { $clean['retention_months'] = self::clamp_int( $data['retention_months'], 1, 120 ); } if ( array_key_exists( 'enable_svg', $data ) ) { $clean['enable_svg'] = empty( $data['enable_svg'] ) ? 0 : 1; } if ( array_key_exists( 'delete_data', $data ) ) { $clean['delete_data'] = empty( $data['delete_data'] ) ? 0 : 1; } if ( array_key_exists( 'allowed_exts', $data ) ) { $exts = $data['allowed_exts']; if ( ! is_array( $exts ) && ! is_string( $exts ) ) { $exts = array(); } $clean['allowed_exts'] = self::normalise_extensions( $exts ); } else { $clean['allowed_exts'] = self::normalise_extensions( $clean['allowed_exts'] ); } update_option( self::OPTION, $clean ); update_option( 'proofkit_delete_data', empty( $clean['delete_data'] ) ? '0' : '1' ); self::reset_cache(); } /** * Returns enabled extensions, lowercase and without dots. * * @return array */ public static function allowed_extensions(): array { $exts = self::normalise_extensions( self::get( 'allowed_exts', array() ) ); if ( 1 !== (int) self::get( 'enable_svg', 0 ) ) { $exts = array_values( array_diff( $exts, array( 'svg' ) ) ); } return $exts; } /** * Returns the maximum upload size in bytes. * * @return int */ public static function max_bytes(): int { $megabytes = max( 1, min( 100, (int) self::get( 'max_size_mb', 25 ) ) ); return $megabytes * MB_IN_BYTES; } /** * Clears the cached settings. * * @return void */ public static function reset_cache(): void { self::$cache = null; } /** * Normalises an extension list against the allow-list. * * Accepts a comma/space separated string or an array. Values are lowercased, * dots stripped, de-duplicated and limited to known extensions. * * @param string|array $value Raw extension list. * @return array */ public static function normalise_extensions( string|array $value ): array { if ( is_string( $value ) ) { $parts = preg_split( '/[\s,]+/', $value, -1, PREG_SPLIT_NO_EMPTY ); $value = false === $parts ? array() : $parts; } $clean = array(); foreach ( $value as $ext ) { if ( ! is_string( $ext ) ) { continue; } $ext = ltrim( strtolower( trim( $ext ) ), '.' ); if ( '' === $ext || ! in_array( $ext, self::EXT_ALLOWLIST, true ) ) { continue; } $clean[] = $ext; } return array_values( array_unique( $clean ) ); } /** * Sanitises a scalar text value. * * @param mixed $value Raw value. * @return string */ private static function sanitise_text( mixed $value ): string { return is_scalar( $value ) ? sanitize_text_field( (string) $value ) : ''; } /** * Casts a scalar value to string. * * @param mixed $value Raw value. * @return string */ private static function scalar_string( mixed $value ): string { return is_scalar( $value ) ? (string) $value : ''; } /** * Casts to a non-negative integer and clamps it. * * @param mixed $value Raw value. * @param int $min Minimum. * @param int $max Maximum. * @return int */ private static function clamp_int( mixed $value, int $min, int $max ): int { $number = is_scalar( $value ) ? absint( $value ) : 0; return max( $min, min( $max, $number ) ); } }