` tag and prints the "Save" button.
*
* @since 1.0
*
* @return (object) The class instance.
*/
protected function do_sections() {
$section_id = $this->get_section_id();
$html_id = explode( '|', $section_id );
$html_id = sanitize_html_class( implode( '--', $html_id ) );
$with_save_button = ! empty( $this->section_save_buttons[ $section_id ] );
/**
* Fires before a section.
*
* @since 1.0
*
* @param (bool) $with_save_button True if a "Save All Changes" button will be printed.
*/
do_action( 'secupress.settings.before_section_' . $this->sectionnow, $with_save_button );
$this->section_is_disabled = true;
echo '
';
echo '
';
$this->do_settings_sections();
echo '
';
if ( $with_save_button ) {
$args = array(
'type' => 'primary',
'name' => $this->sectionnow . '_submit',
);
if ( $this->section_is_disabled ) {
$args['wrap'] = true;
$args['other_attributes'] = array(
'disabled' => 'disabled',
'aria-disabled' => 'true',
);
}
/**
* Filter the arguments passed to the section submit button.
*
* @since 1.4.3 Add $this->sectionnow.
* @since 1.0.6
*
* @param (array) $args An array of arguments passed to the `submit_button()` method.
*/
$args = apply_filters( 'secupress.settings.section.submit_button_args', $args, $this->sectionnow );
/**
* Filter the arguments passed to the section submit button.
*
* @since 1.4.3
*
* @param (array) $args An array of arguments passed to the `submit_button()` method.
*/
$args = apply_filters( 'secupress.settings.section-' . $this->sectionnow . '.submit_button_args', $args );
call_user_func( array( __CLASS__, 'submit_button' ), $args );
}
echo '
';
/**
* Fires after a section.
*
* @since 1.0
*
* @param (bool) $with_save_button True if a "Save All Changes" button will be printed.
*/
do_action( 'secupress.settings.after_section_' . $this->sectionnow, $with_save_button );
$this->section_is_disabled = null;
return $this;
}
/**
* Like the real `do_settings_sections()` but using a custom `do_settings_fields()`.
*
* @since 1.0
*/
final protected function do_settings_sections() {
global $wp_settings_sections, $wp_settings_fields;
$section_id = $this->get_section_id();
if ( ! isset( $wp_settings_sections[ $section_id ] ) ) {
return;
}
foreach ( (array) $wp_settings_sections[ $section_id ] as $section ) {
$header_open_tag = false;
if ( $section['title'] ) {
echo '';
echo $label_open; ?>
' . $args['label'] . '
' : '';
echo $args['label_before'];
echo '
';
echo $args['label_after'];
?>
' : '';
echo $args['label_before'];
?>
>
$title ) {
$disabled = '';
if ( static::is_pro_feature( $args['name'] . '|' . $val ) && ! secupress_is_pro() ) {
$disabled = ' disabled="disabled"';
$has_disabled = true;
}
?>
>
(*) %s' ) : '';
break;
case 'checkbox' :
echo '
';
echo $label_open; ?>
';
echo '' . $args['label'] . ' ';
?>
';
break;
case 'checkboxes' :
case 'radioboxes' :
$value = array_flip( (array) $value );
foreach ( $args['options'] as $val => $title ) {
$args['label_for'] = $args['name'] . '_' . $val;
$disabled = static::is_pro_feature( $args['name'] . '|' . $val ) && ! secupress_is_pro() ? ' disabled="disabled"' : '';
$pro_class = '';
if ( static::is_pro_feature( $args['name'] . '|' . $val ) && ! secupress_is_pro() ) {
$pro_class = ' secupress-pro-option';
} elseif ( static::is_pro_feature( $args['name'] . '|' . $val ) ) {
$pro_class = ' secupress-show-pro';
}
?>
for="">
$title ) {
$args['label_for'] = $args['name'] . '_' . $val;
$disabled = static::is_pro_feature( $args['name'] . '|' . $val ) && ! secupress_is_pro() ? ' disabled="disabled"' : '';
$pro_class = '';
if ( static::is_pro_feature( $args['name'] . '|' . $val ) && ! secupress_is_pro() ) {
$pro_class = ' secupress-pro-option';
} elseif ( static::is_pro_feature( $args['name'] . '|' . $val ) ) {
$pro_class = ' secupress-show-pro';
}
if ( ! $disabled && strpos( $title, 'secupress-coming-soon-feature' ) !== false ) {
$disabled = ' disabled="disabled"';
}
?>
for="">
get_names();
$roles = array_map( 'translate_user_role', $roles );
foreach ( $roles as $val => $title ) {
?>
>
' . $args['label'] . '';
break;
default :
if ( secupress_is_pro() && function_exists( 'secupress_pro_' . $args['type'] . '_field' ) ) {
call_user_func( 'secupress_pro_' . $args['type'] . '_field', $args, $this );
} elseif ( method_exists( $this, $args['type'] ) ) {
call_user_func( array( $this, $args['type'] ), $args );
} else {
echo 'Missing or incorrect type'; // Do not translate.
}
}
// Helpers.
static::helpers( $args );
if ( $has_fieldset_end ) {
echo '';
}
}
/** Specific fields ========================================================================= */
/**
* Outputs the form used by the reset settings form
*
* @since 1.4.4
* @author Julio Potier
*/
protected function reset_settings_button() {
?>
%s' );
return;
}
$name = 'upload';
$type = 'help';
$description = __( 'Choose a file from your computer:', 'secupress' ) . ' (' . sprintf( __( 'Maximum size: %s', 'secupress' ), $size ) . ')';
/** This filter is documented in inc/classes/settings/class-secupress-settings.php */
$description = apply_filters( 'secupress.settings.help', $description, $name, $type );
?>
class="secupress-button" id="import">
%s' );
}
/**
* Outputs the export button.
*
* @since 1.0
* @author Julio Potier
*/
protected function export_form() {
?>
%s' );
}
/**
* Used to display buttons.
*
* @since 1.0
*
* @param (array) $args An array of parameters. See `::field()`.
*/
protected function field_button( $args ) {
if ( ! empty( $args['label'] ) ) {
$class = sanitize_html_class( $args['name'] );
$class .= ! empty( $args['style'] ) ? ' button-' . sanitize_html_class( $args['style'] ) : ' button-secondary';
$id = ! empty( $args['id'] ) ? ' id="' . $args['id'] . '"' : '';
if ( ! empty( $args['url'] ) ) {
echo '
' . $args['label'] . '';
}
else {
echo '' . $args['label'] . '';
}
}
// Helpers.
static::helpers( $args );
}
/**
* Helpers printed after a field.
*
* @since 1.0
*
* @param (array) $args An array containing a 'helpers' key.
* This 'helpers' key contains a list of arrays that contain:
* - (string) $description The text to print.
* - (string) $type The helper type: 'description', 'help', 'warning'.
* - (string) $class A html class to add to the text.
* - (string) $depends Like in `$this->do_settings_fields()`, used to show/hide the helper depending on a field value.
*/
protected static function helpers( $args ) {
if ( empty( $args['helpers'] ) || ! is_array( $args['helpers'] ) ) {
return;
}
foreach ( $args['helpers'] as $helper ) {
if ( empty( $helper['description'] ) ) {
continue;
}
$depends = '';
if ( ! empty( $helper['depends'] ) ) {
$helper['depends'] = explode( ' ', $helper['depends'] );
$depends = ' depends-' . implode( ' depends-', $helper['depends'] );
}
$class = ! empty( $helper['class'] ) ? ' ' . trim( $helper['class'] ) : '';
$name = $args['name'];
$type = $helper['type'];
$tag = preg_match( '@]@', $helper['description'] ) ? 'div' : 'p';
switch ( $type ) {
case 'description' :
$description = '<' . $tag . ' class="description desc' . $depends . $class . '">' . $helper['description'] . '';
break;
case 'help' :
$description = '<' . $tag . ' class="description help' . $depends . $class . '">' . $helper['description'] . '';
break;
case 'warning' :
$description = '<' . $tag . ' class="description warning' . $depends . $class . '">' . ( 'p' === $tag ? '' : '' ) . '' . __( 'Warning: ', 'secupress' ) . ' ' . $helper['description'] . ''; // Don't forget to close the
tag.
break;
default :
continue;
}
/**
* Filter the helper description.
*
* @since 1.0
*
* @param (string) $description The description.
* @param (string) $name The field name argument.
* @param (string) $type The helper type.
*/
echo apply_filters( 'secupress.settings.help', $description, $name, $type );
}
}
/** Fields related ========================================================================== */
/**
* Get a correct name for setting fields based on the current module.
*
* @since 1.0
*
* @param (string) $field A field name.
*
* @return (string)
*/
final protected function get_field_name( $field ) {
return "{$this->pluginnow}_{$field}";
}
/**
* Add a field. It's a wrapper for `add_settings_field()`.
*
* @since 1.0
*
* @param (array) $args An array of parameters:
* - (string) $title The row title/label.
* - (string) $description The row description.
* - (string) $field_type The field type.
* See `self::field()` for the other paramaters.
*
* @return (object) The class instance.
*/
protected function add_field( $args ) {
$args = wp_parse_args( $args, array(
'title' => '',
'description' => '',
'name' => '',
'field_type' => 'field',
) );
if ( empty( $args['name'] ) && ! empty( $args['label_for'] ) ) {
$args['name'] = $args['label_for'];
}
if ( false !== apply_filters( 'secupress.settings.field.' . $args['name'], false ) ) {
return;
}
// Get the title.
$title = $args['title'];
unset( $args['title'] );
// Get the callback.
if ( is_array( $args['field_type'] ) ) {
$callback = $args['field_type'];
} elseif ( method_exists( $this, $args['field_type'] ) ) {
$callback = array( $this, $args['field_type'] );
} else {
$callback = 'secupress_' . $args['field_type'];
}
add_settings_field(
'module_' . $this->modulenow . '|' . $this->pluginnow . '|' . $args['name'],
$title,
$callback,
$this->get_section_id(),
$this->get_section_id(),
$args
);
/**
* Triggered after a field is added.
*
* @since 1.0
*/
do_action( 'secupress.settings.after_field_' . $this->modulenow . '|' . $this->pluginnow );
return $this;
}
/**
* Like the `do_settings_fields()` WordPress function but:
* - `id` and `class` attributes can be added to the `tr` tag (the `class` attribute appeared in WP 4.3) with `row_id` and `row_class`.
* - The `$depends` parameter can be used to show/hide the row depending on a field value.
* - Automatically add some text to the row description if the field is pro and w're not using the pro version.
*
* @since 1.0
*
* @param (string) $page Slug title of the admin page who's settings fields you want to show.
* @param (string) $section Slug title of the settings section who's fields you want to show.
*/
final protected function do_settings_fields( $page, $section ) {
global $wp_settings_fields;
if ( ! isset( $wp_settings_fields[ $page ][ $section ] ) ) {
return;
}
foreach ( (array) $wp_settings_fields[ $page ][ $section ] as $field ) {
$id = '';
$field_id = isset( $field['id'] ) ? explode( '|', $field['id'] ) : array( '' );
$field_id = end( $field_id );
$is_free = ! secupress_is_pro();
$class = 'secupress-setting-row_' . sanitize_html_class( $field_id ) . ' secupress-setting-row ';
$class .= static::is_pro_feature( $field['args']['name'] ) && $is_free ? 'secupress-pro-row ' : '';
$class .= static::is_pro_feature( $field['args']['name'] ) && ! $is_free ? 'secupress-show-pro ' : '';
// Row ID.
if ( ! empty( $field['args']['row_id'] ) ) {
$id = ' id="' . esc_attr( $field['args']['row_id'] ) . '"';
}
// Row class.
if ( ! empty( $field['args']['row_class'] ) ) {
$class .= ' ' . $field['args']['row_class'];
}
if ( ! empty( $field['args']['depends'] ) ) {
$field['args']['depends'] = explode( ' ', $field['args']['depends'] );
$class .= ' depends-' . implode( ' depends-', $field['args']['depends'] );
}
if ( $class ) {
$class = ' class="' . esc_attr( trim( $class ) ) . '"';
}
unset( $field['args']['row_id'], $field['args']['row_class'] );
?>
>
' . $field['title'] . '';
echo '
' . $field['title'] . ' ';
} else {
echo '
' . $field['title'] . ' ';
}
}
/**
* Filter used to print or not the descriptions during the "expert" mode
* @param (bool) true to display, false to hide
*/
if ( $field['args']['description'] && apply_filters( 'secupress.settings.description', true ) ) {
echo '
' . $field['args']['description'] . '
';
}
unset( $field['args']['description'] );
$field_is_disabled = $this->field_is_disabled( $field['args'] );
if ( empty( $field['args']['disabled'] ) && $field_is_disabled ) {
$field['args']['disabled'] = true;
}
if ( $this->section_is_disabled && ! $field_is_disabled ) {
$this->section_is_disabled = false;
}
call_user_func( $field['callback'], $field['args'] );
?>
' . static::get_pro_version_string() . '';
}
?>
';
}
if ( ! is_array( $args['type'] ) ) {
$type = explode( ' ', $args['type'] );
} else {
$type = $args['type'];
}
$button_shorthand = array( 'primary' => 1, 'secondary' => 1, 'tertiary' => 1, 'small' => 1, 'large' => 1, 'delete' => 1 );
$classes = array( 'secupress-button' );
foreach ( $type as $t ) {
$classes[] = isset( $button_shorthand[ $t ] ) ? 'secupress-button-' . $t : $t;
}
$class = implode( ' ', array_unique( $classes ) );
// Default the id attribute to $name unless an id was specifically provided in $other_attributes.
$name = $args['name'];
$id = $args['name'];
if ( is_array( $args['other_attributes'] ) && isset( $args['other_attributes']['id'] ) ) {
$id = $args['other_attributes']['id'];
}
$attributes = '';
if ( is_array( $args['other_attributes'] ) ) {
foreach ( $args['other_attributes'] as $attribute => $value ) {
$attributes .= ' ' . $attribute . '="' . esc_attr( $value ) . '"';
}
} elseif ( ! empty( $args['other_attributes'] ) ) { // Attributes provided as a string.
$attributes = $args['other_attributes'];
}
// Don't output empty name and id attributes.
$name_attr = $name ? ' name="' . esc_attr( $name ) . '"' : '';
$id_attr = $id ? ' id="' . esc_attr( $id ) . '"' : '';
$label = esc_html( $args['label'] );
$button = '' . $label . ' ';
if ( $wrap ) {
$button = $wrap . $button . '
';
}
if ( $args['echo'] ) {
echo $button;
}
return $button;
}
/**
* Print the sidebar with Ads and cross-selling.
*
* @author Geoffrey Crofte
* @since 1.1.4
* @since 1.2 A method of this class. Was previously `secupress_print_sideads()`.
*/
protected function print_sideads() {
global $current_screen;
if ( SECUPRESS_PLUGIN_SLUG . '_page_' . SECUPRESS_PLUGIN_SLUG . '_modules' !== $current_screen->base ) {
return;
}
/**
* Give the possibility to hide the whole sidebar, don't do that!! ><
*
* @since 1.4
*
* @param (bool) false by default
*/
if ( false !== apply_filters( 'secupress.no_sidebar', false ) ) {
return;
}
?>
array(
'hook' => 'secupress_ad_before',
'when' => 'free', // For free || pro || both .
'content' => '
',
'content-fr_FR' => '
',
),
// 1 =>
);
}
foreach ( $sideads as $sidead ) {
if ( 'secupress_ad_before' !== $sidead['hook'] ) {
continue;
}
if ( ( 'free' === $sidead['when'] && ! secupress_is_pro() )
|| ( 'pro' === $sidead['when'] && secupress_is_pro() )
|| 'both' === $sidead['when']
) {
$content_locale = 'content-' . get_locale();
$content = isset( $sidead[ $content_locale ] ) ? $sidead[ $content_locale ] : $sidead['content'];
echo wp_kses_post( str_replace( '##SECUPRESS_ADMIN_IMAGES_URL##', SECUPRESS_ADMIN_IMAGES_URL, $content ) );
}
}
/**
* Triggered before the tool boxes.
*
* @since 1.4
*/
do_action( 'secupress.ad_before' );
}
?>
