array( 'post', 'page' ), 'supported_post_statuses' => array( 'publish', 'future', 'draft', 'pending', 'private' ), 'redirect_ownership_mode' => self::MODE_SLUGH, 'redirect_private_posts' => false, 'rollback_reverse_redirect' => true, 'preserve_modified_date' => true, 'woocommerce_enabled' => true, 'trial_mode' => false, 'allow_external_destinations' => false, 'integrity_excluded_meta' => array(), 'scan_batch_size' => 500, 'job_batch_size' => 25, 'delete_data_on_uninstall' => false, ); } /** * Retrieve all settings merged with defaults. * * @return array */ public static function get_all() { $stored = get_option( self::OPTION_NAME, array() ); if ( ! is_array( $stored ) ) { $stored = array(); } return wp_parse_args( $stored, self::get_defaults() ); } /** * Retrieve a single setting. * * @param string $key Setting key. * @param mixed $default_value Optional fallback default. * @return mixed */ public static function get( $key, $default_value = null ) { $all = self::get_all(); if ( array_key_exists( $key, $all ) ) { return $all[ $key ]; } return $default_value; } /** * Sanitize a full or partial settings array against the known keys. * * Unknown keys are dropped; missing keys keep their current value. * * @param array $settings Raw settings. * @return array Clean, complete settings. */ public static function sanitize( array $settings ) { $current = self::get_all(); $defaults = self::get_defaults(); $clean = array(); foreach ( $defaults as $key => $default_value ) { $value = array_key_exists( $key, $settings ) ? $settings[ $key ] : $current[ $key ]; if ( is_bool( $default_value ) ) { $clean[ $key ] = (bool) $value; } elseif ( is_int( $default_value ) ) { $clean[ $key ] = max( 1, absint( $value ) ); } elseif ( is_array( $default_value ) ) { $clean[ $key ] = is_array( $value ) ? array_values( array_unique( array_filter( array_map( 'sanitize_text_field', $value ) ) ) ) : array(); } else { $clean[ $key ] = sanitize_key( (string) $value ); } } if ( ! in_array( $clean['redirect_ownership_mode'], array( self::MODE_SLUGH, self::MODE_SEO_PLUGIN, self::MODE_SLUG_ONLY ), true ) ) { $clean['redirect_ownership_mode'] = self::MODE_SLUGH; } $clean['supported_post_types'] = array_map( 'sanitize_key', $clean['supported_post_types'] ); $clean['supported_post_statuses'] = array_values( array_intersect( array_map( 'sanitize_key', $clean['supported_post_statuses'] ), PostTypes::SUPPORTED_STATUSES ) ); $clean['scan_batch_size'] = min( 2000, max( 50, $clean['scan_batch_size'] ) ); $clean['job_batch_size'] = min( 100, max( 1, $clean['job_batch_size'] ) ); return $clean; } /** * Update all settings, logging the change in the audit log. * * @param array $settings New settings array (partial arrays keep existing values). * @return bool */ public static function update_all( array $settings ) { $before = self::get_all(); $clean = self::sanitize( $settings ); if ( $before === $clean && false !== get_option( self::OPTION_NAME, false ) ) { return true; } $updated = update_option( self::OPTION_NAME, $clean ); if ( $updated && class_exists( '\SlugH\Jobs\AuditLogger' ) && did_action( 'plugins_loaded' ) ) { $changed_before = array(); $changed_after = array(); foreach ( $clean as $key => $value ) { if ( ! array_key_exists( $key, $before ) || $before[ $key ] !== $value ) { $changed_before[ $key ] = isset( $before[ $key ] ) ? $before[ $key ] : null; $changed_after[ $key ] = $value; } } if ( ! empty( $changed_after ) ) { \SlugH\Jobs\AuditLogger::log( 'settings_update', 'settings', 0, $changed_before, $changed_after ); } } return $updated; } /** * Update a single setting value. * * @param string $key Setting key. * @param mixed $value New value. * @return bool */ public static function update( $key, $value ) { return self::update_all( array( $key => $value ) ); } /** * Delete plugin settings option. * * @return bool */ public static function delete_all() { return delete_option( self::OPTION_NAME ); } /** * Whether SlugH creates redirects itself (ownership mode 1). * * @return bool */ public static function slugh_owns_redirects() { return self::MODE_SLUGH === self::get( 'redirect_ownership_mode' ); } }