tab_text ) ) {
$this->tab_text = $this->title;
}
// Register the settings section.
$this->register_section();
}
/**
* Helper method to determine if we're viewing the current settings screen.
*
* @since 2.5.0
*
* @param string $tab Current settings tab (general|tools|restrict-content|broadcasts).
* @return bool
*/
public function on_settings_screen( $tab ) {
// phpcs:disable WordPress.Security.NonceVerification
// Bail if we're not on the settings screen.
if ( ! array_key_exists( 'page', $_REQUEST ) ) {
return false;
}
if ( sanitize_text_field( wp_unslash( $_REQUEST['page'] ) ) !== '_wp_convertkit_settings' ) {
return false;
}
// Define current settings tab.
// General screen won't always be loaded with a `tab` parameter.
$current_tab = ( array_key_exists( 'tab', $_REQUEST ) ? sanitize_text_field( wp_unslash( $_REQUEST['tab'] ) ) : 'general' );
// Return whether the request is for the current settings tab.
return ( $current_tab === $tab );
// phpcs:enable
}
/**
* Register settings section.
*/
public function register_section() {
// Register settings sections.
foreach ( $this->settings_sections as $name => $settings_section ) {
// Determine if this settings section needs to be wrapped in its own container.
$wrap = array();
if ( $settings_section['wrap'] ) {
$wrap = array(
'before_section' => $this->get_render_container_start(),
'after_section' => $this->get_render_container_end(),
);
}
add_settings_section(
( $name === 'general' ? $this->name : $this->name . '-' . $name ),
$settings_section['title'],
$settings_section['callback'],
$this->settings_key,
$wrap
);
}
// Register settings fields.
$this->register_fields();
// Register setting to store data in options table.
register_setting(
$this->settings_key,
$this->settings_key,
array( $this, 'sanitize_settings' )
);
}
/**
* Register fields for this section
*/
public function register_fields() {
}
/**
* Prints help info for this section
*/
abstract public function print_section_info();
/**
* Returns the URL for the ConvertKit documentation for this setting section.
*/
abstract public function documentation_url();
/**
* Outputs success and/or error notices if required.
*
* @since 2.0.0
*/
public function maybe_output_notices() {
// Define notices that might be displayed as a notification.
$notices = array();
/**
* Register success and error notices for settings screens.
*
* @since 2.5.1
*
* @param array $notices Regsitered success and error notices.
* @return array
*/
$notices = apply_filters( 'convertkit_settings_base_register_notices', $notices );
// Output the verbose error description if supplied (e.g. OAuth).
if ( isset( $_REQUEST['error_description'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$this->output_error( sanitize_text_field( wp_unslash( $_REQUEST['error_description'] ) ) ); // phpcs:ignore WordPress.Security.NonceVerification
}
// Output error notification if defined.
if ( isset( $_REQUEST['error'] ) && array_key_exists( sanitize_text_field( wp_unslash( $_REQUEST['error'] ) ), $notices ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$this->output_error( $notices[ sanitize_text_field( wp_unslash( $_REQUEST['error'] ) ) ] ); // phpcs:ignore WordPress.Security.NonceVerification
}
// Output success notification if defined.
if ( isset( $_REQUEST['success'] ) && array_key_exists( sanitize_text_field( wp_unslash( $_REQUEST['success'] ) ), $notices ) ) { // phpcs:ignore WordPress.Security.NonceVerification
$this->output_success( $notices[ sanitize_text_field( wp_unslash( $_REQUEST['success'] ) ) ] ); // phpcs:ignore WordPress.Security.NonceVerification
}
}
/**
* Renders the section
*/
public function render() {
/**
* Performs actions prior to rendering the settings form.
*
* @since 1.9.6
*/
do_action( 'convertkit_settings_base_render_before' );
do_settings_sections( $this->settings_key );
settings_fields( $this->settings_key );
if ( ! $this->save_disabled ) {
submit_button();
}
/**
* Performs actions after rendering of the settings form.
*
* @since 1.9.6
*/
do_action( 'convertkit_settings_base_render_after' );
}
/**
* Outputs opening .metabox-holder and .postbox container div elements,
* used before beginning a setting screen's output.
*
* @since 2.0.0
*/
public function render_container_start() {
echo $this->get_render_container_start(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
}
/**
* Outputs closing .metabox-holder and .postbox container div elements,
* used after finishing a setting screen's output.
*
* @since 2.0.0
*/
public function render_container_end() {
echo $this->get_render_container_end(); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
}
/**
* Returns opening .metabox-holder and .postbox container div elements,
* used before beginning a section of a settings screen output.
*
* @since 2.7.1
*/
public function get_render_container_start() {
return '
';
}
/**
* Returns closing .metabox-holder and .postbox container div elements,
* used after finishing a section of a settings screen output.
*
* @since 2.7.1
*/
public function get_render_container_end() {
return '
';
}
/**
* Redirects to the settings screen.
*
* @since 2.2.9
*/
public function redirect() {
wp_safe_redirect(
add_query_arg(
array(
'page' => '_wp_convertkit_settings',
'tab' => $this->name,
),
'options-general.php'
)
);
exit();
}
/**
* Redirects to the settings screen with an error notice key.
*
* The function maybe_output_notices() will then output the translated error notice
* based on the supplied key.
*
* @since 2.5.1
*
* @param string $error The error notice key, registered using `convertkit_settings_base_register_notices`.
*/
public function redirect_with_error_notice( $error ) {
wp_safe_redirect(
add_query_arg(
array(
'page' => '_wp_convertkit_settings',
'tab' => $this->name,
'error' => $error,
),
'options-general.php'
)
);
exit();
}
/**
* Redirects to the settings screen with the verbose error description.
*
* @since 2.5.1
*
* @param string $error_description The error description.
*/
public function redirect_with_error_description( $error_description ) {
wp_safe_redirect(
add_query_arg(
array(
'page' => '_wp_convertkit_settings',
'tab' => $this->name,
'error_description' => $error_description,
),
'options-general.php'
)
);
exit();
}
/**
* Redirects to the settings screen with a success notice key.
*
* The function maybe_output_notices() will then output the translated success notice
* based on the supplied key.
*
* @since 2.5.1
*
* @param string $success The success notice key, registered using `convertkit_settings_base_register_notices`.
*/
public function redirect_with_success_notice( $success ) {
wp_safe_redirect(
add_query_arg(
array(
'page' => '_wp_convertkit_settings',
'tab' => $this->name,
'success' => $success,
),
'options-general.php'
)
);
exit();
}
/**
* Outputs the given success message in an inline notice.
*
* @since 2.0.0
*
* @param string $success_message Success Message.
*/
public function output_success( $success_message ) {
?>