72 lines
1.7 KiB
PHP
72 lines
1.7 KiB
PHP
<?php
|
|
/**
|
|
* @package Polylang
|
|
*/
|
|
|
|
namespace WP_Syntex\Polylang\Options\Business;
|
|
|
|
use WP_Error;
|
|
use WP_Syntex\Polylang\Options\Primitive\Abstract_Boolean;
|
|
use WP_Syntex\Polylang\Options\Options;
|
|
|
|
defined( 'ABSPATH' ) || exit;
|
|
|
|
/**
|
|
* Class defining the "Detect browser language" boolean option.
|
|
* /!\ Sanitization depends on `force_lang`: this option must be set AFTER `force_lang`.
|
|
*
|
|
* @since 3.7
|
|
*/
|
|
class Browser extends Abstract_Boolean {
|
|
/**
|
|
* Returns option key.
|
|
*
|
|
* @since 3.7
|
|
*
|
|
* @return string
|
|
*
|
|
* @phpstan-return 'browser'
|
|
*/
|
|
public static function key(): string {
|
|
return 'browser';
|
|
}
|
|
|
|
/**
|
|
* Sanitizes option's value.
|
|
* Can populate the `$errors` property with blocking and non-blocking errors: in case of non-blocking errors,
|
|
* the value is sanitized and can be stored.
|
|
*
|
|
* @since 3.7
|
|
*
|
|
* @param bool $value Value to sanitize.
|
|
* @param Options $options All options.
|
|
* @return bool|WP_Error The sanitized value. An instance of `WP_Error` in case of blocking error.
|
|
*/
|
|
protected function sanitize( $value, Options $options ) {
|
|
if ( 3 === $options->get( 'force_lang' ) && ! class_exists( 'PLL_Xdata_Domain', true ) ) {
|
|
// Cannot share cookies between domains without Polylang Pro.
|
|
return false;
|
|
}
|
|
|
|
/** @var bool|WP_Error */
|
|
$value = parent::sanitize( $value, $options );
|
|
return $value;
|
|
}
|
|
|
|
/**
|
|
* Returns the description used in the JSON schema.
|
|
*
|
|
* @since 3.7
|
|
*
|
|
* @return string
|
|
*/
|
|
protected function get_description(): string {
|
|
return sprintf(
|
|
/* translators: %1$s and %2$s are "true/false" values. */
|
|
__( 'Detect preferred browser language on front page: %1$s to detect, %2$s to not detect.', 'polylang' ),
|
|
'`true`',
|
|
'`false`'
|
|
);
|
|
}
|
|
}
|