<?php //phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
/**
* Jetpack comments admin menu file.
*
* @package automattic/jetpack
*/
/**
* Class Jetpack_Comments_Settings
* This class represents the comments settings functionality.
*/
class Jetpack_Comments_Settings {
/** Variables *************************************************************/
/**
* The Jetpack Comments singleton
*
* @var Highlander_Comments_Base
*/
public $jetpack_comments;
/**
* The default comment form greeting - blank to start with
*
* @var string
*/
public $default_greeting = ''; // Set in constructor.
/**
* The default comment form color scheme - an empty array to start with
*
* @var string
*/
public $color_schemes = array();
/**
* Initialize class
*/
public static function init() {
static $instance = false;
if ( ! $instance ) {
$instance = new Jetpack_Comments_Settings( Jetpack_Comments::init() );
}
return $instance;
}
/**
* Constructor
*
* @param Highlander_Comments_Base $jetpack_comments The Jetpack Comments singleton.
*/
public function __construct( Highlander_Comments_Base $jetpack_comments ) {
$this->jetpack_comments = $jetpack_comments;
// Setup settings.
add_action( 'admin_init', array( $this, 'add_settings' ) );
$this->setup_globals();
}
/** Private Methods ****************************************************** */
/**
* Set any global variables or class variables
*
* @since JetpackComments (1.4)
*/
protected function setup_globals() {
// Default option values.
$this->default_greeting = __( 'Leave a Reply', 'jetpack' );
// Possible color schemes.
$this->color_schemes = array(
'light' => __( 'Light', 'jetpack' ),
'dark' => __( 'Dark', 'jetpack' ),
'transparent' => __( 'Transparent', 'jetpack' ),
);
}
/** Settings ************************************************************* */
/**
* Add the Jetpack settings to WordPress's discussions page
*
* @since JetpackComments (1.4)
*/
public function add_settings() {
// Create the section.
add_settings_section(
'jetpack_comment_form',
__( 'Comments', 'jetpack' ),
array( $this, 'comment_form_settings_section' ),
'discussion'
);
/**
* Clever Greeting
*/
add_settings_field(
'highlander_comment_form_prompt',
__( 'Greeting Text', 'jetpack' ),
array( $this, 'comment_form_greeting_setting' ),
'discussion',
'jetpack_comment_form'
);
register_setting(
'discussion',
'highlander_comment_form_prompt',
array( $this, 'comment_form_greeting_sanitize' )
);
/**
* Color Scheme
*/
add_settings_field(
'jetpack_comment_form_color_scheme',
__( 'Color Scheme', 'jetpack' ),
array( $this, 'comment_form_color_scheme_setting' ),
'discussion',
'jetpack_comment_form'
);
register_setting(
'discussion',
'jetpack_comment_form_color_scheme',
array( $this, 'comment_form_color_scheme_sanitize' )
);
}
/**
* Discussions setting section blurb
*
* @since JetpackComments (1.4)
*/
public function comment_form_settings_section() {
?>
<p id="jetpack-comments-settings"><?php esc_html_e( 'Adjust your Comments form with a clever greeting and color-scheme.', 'jetpack' ); ?></p>
<?php
}
/**
* Custom Comment Greeting Text
*
* @since JetpackComments (1.4)
*/
public function comment_form_greeting_setting() {
// The greeting.
$greeting = get_option( 'highlander_comment_form_prompt', $this->default_greeting );
?>
<input type="text" name="highlander_comment_form_prompt" id="jetpack-comment-form-greeting" value="<?php echo esc_attr( $greeting ); ?>" class="regular-text">
<p class="description"><?php esc_html_e( 'A few catchy words to motivate your readers to comment', 'jetpack' ); ?></p>
<?php
}
/**
* Sanitize the clever comment greeting
*
* @since JetpackComments (1.4)
* @param string $val The contact form greeting string.
* @return string
*/
public function comment_form_greeting_sanitize( $val ) {
// Delete if empty or the default.
if ( empty( $val ) || ( $this->default_greeting === $val ) ) {
delete_option( 'highlander_comment_form_prompt' );
return false;
}
return wp_kses( $val, array() );
}
/**
* Comment Form Color Scheme Setting
*
* @since JetpackComments (1.4)
*/
public function comment_form_color_scheme_setting() {
// The color scheme.
$scheme = get_option( 'jetpack_comment_form_color_scheme', $this->jetpack_comments->default_color_scheme );
?>
<fieldset>
<legend class="screen-reader-text"><?php esc_html_e( 'Color Scheme', 'jetpack' ); ?></legend>
<?php foreach ( $this->color_schemes as $key => $label ) : ?>
<label>
<input type="radio" name="jetpack_comment_form_color_scheme" id="jetpack-comment-form-color-scheme" value="<?php echo esc_attr( $key ); ?>" <?php checked( $scheme, $key ); ?>>
<?php echo esc_attr( $label ); ?>
</label>
<br />
<?php endforeach; ?>
</fieldset>
<?php
}
/**
* Sanitize the color scheme
*
* @since JetpackComments (1.4)
* @param string $val The color scheme string.
* @return string
*/
public function comment_form_color_scheme_sanitize( $val ) {
// Delete the option if it's unknown, or the default.
if (
empty( $val ) || ! array_key_exists( $val, $this->color_schemes )
||
$val === $this->jetpack_comments->default_color_scheme
) {
delete_option( 'jetpack_comment_form_color_scheme' );
return false;
}
return $val;
}
}
Jetpack_Comments_Settings::init();