// phpcs:disable Generic.Commenting.DocComment.MissingShort
/** @noinspection PhpIllegalPsrClassPathInspection */
/** @noinspection AutoloadingIssuesInspection */
// phpcs:enable Generic.Commenting.DocComment.MissingShort
if ( ! defined( 'ABSPATH' ) ) {
use WPForms\Admin\Forms\Tags;
* Settings management panel.
class WPForms_Builder_Panel_Settings extends WPForms_Builder_Panel {
// Define panel information.
$this->name = esc_html__( 'Settings', 'wpforms-lite' );
$this->slug = 'settings';
$this->icon = 'fa-sliders';
* Filters the form data for the form builder.
* @param array $form_data Form data.
$this->form_data = apply_filters( 'wpforms_builder_panel_settings_init_form_data', $this->form_data );
* Output the Settings panel sidebar.
public function panel_sidebar() {
// Sidebar contents are not valid unless we have a form.
'general' => esc_html__( 'General', 'wpforms-lite' ),
'anti_spam' => esc_html__( 'Spam Protection and Security', 'wpforms-lite' ),
'themes' => esc_html__( 'Themes', 'wpforms-lite' ),
'notifications' => esc_html__( 'Notifications', 'wpforms-lite' ),
'confirmation' => esc_html__( 'Confirmations', 'wpforms-lite' ),
* Filters builder settings sections.
* @param array $sections Sections.
* @param array $form_data Form data.
$sections = (array) apply_filters( 'wpforms_builder_settings_sections', $sections, $this->form_data ); // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName
foreach ( $sections as $slug => $section ) {
$this->panel_sidebar_section( $section, $slug );
public function enqueues() {
$min = wpforms_get_min_suffix();
'wpforms-builder-settings',
WPFORMS_PLUGIN_URL . "assets/js/admin/builder/settings{$min}.js",
'wpforms-builder-settings',
'wpforms_builder_settings',
'choicesjs_config' => $this->get_choicesjs_config(),
'all_tags_choices' => Tags::get_all_tags_choices(),
* Get Choices.js configuration.
private function get_choicesjs_config(): array {
$config = Tags::get_choicesjs_config();
$config['noResultsText'] = esc_html__( 'Press Enter or "," key to add new tag', 'wpforms-lite' );
* Output the Settings panel primary content.
public function panel_content() {
// Check if there is a form created.
echo '<div class="wpforms-alert wpforms-alert-info">';
__( 'You need to <a href="#" class="wpforms-panel-switch" data-panel="setup">setup your form</a> before you can manage the settings.', 'wpforms-lite' ),
echo '<div class="wpforms-panel-content-section wpforms-panel-content-section-general">';
echo '<div class="wpforms-panel-content-section-title">';
esc_html_e( 'General', 'wpforms-lite' );
esc_html__( 'Form Name', 'wpforms-lite' ),
'default' => $this->form->post_title,
esc_html__( 'Form Description', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Enter descriptive text or instructions to help your users understand the requirements of your form.', 'wpforms-lite' ),
'input_class' => 'wpforms-smart-tags-enabled',
if ( $this->form->post_type === 'wpforms-template' ) {
esc_html__( 'Template Description', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Describe the use case for your template. Only displayed internally.', 'wpforms-lite' ),
$this->general_setting_tags();
esc_html__( 'Submit Button Text', 'wpforms-lite' ),
'default' => esc_html__( 'Submit', 'wpforms-lite' ),
'submit_text_processing',
esc_html__( 'Submit Button Processing Text', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Enter the submit button text you would like the button display while the form submit is processing.', 'wpforms-lite' ),
$this->general_setting_advanced();
echo '<div class="wpforms-panel-content-section wpforms-panel-content-section-notifications" data-panel="notifications">';
* @param WPForms_Builder_Panel_Settings $settings Current settings.
do_action( 'wpforms_form_settings_notifications', $this ); // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName
echo '<div class="wpforms-panel-content-section wpforms-panel-content-section-confirmation" data-panel="confirmations">';
* @param WPForms_Builder_Panel_Settings $settings Current settings.
do_action( 'wpforms_form_settings_confirmations', $this ); // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName
* @param WPForms_Builder_Panel_Settings $settings Current settings.
do_action( 'wpforms_form_settings_panel_content', $this ); // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName
* Output the Tags setting.
private function general_setting_tags() {
if ( ! empty( $this->form_data['settings']['form_tags'] ) ) {
'taxonomy' => WPForms_Form_Handler::TAGS_TAXONOMY,
'name' => $this->form_data['settings']['form_tags'],
$form_tags = is_wp_error( $form_tags ) ? [] : (array) $form_tags;
$tags_value = wp_list_pluck( $form_tags, 'term_id' );
$tags_options = wp_list_pluck( $form_tags, 'name', 'term_id' );
esc_html__( 'Tags', 'wpforms-lite' ),
'options' => $tags_options,
'tooltip' => esc_html__( 'Mark form with the tags. To create a new tag, simply type it and press Enter.', 'wpforms-lite' ),
* Output the *CAPTCHA settings.
* @noinspection HtmlUnknownTarget
private function general_setting_advanced() {
esc_html__( 'Form CSS Class', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Enter CSS class names for the form wrapper. Multiple class names should be separated with spaces.', 'wpforms-lite' ),
esc_html__( 'Submit Button CSS Class', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Enter CSS class names for the form submit button. Multiple names should be separated with spaces.', 'wpforms-lite' ),
esc_html__( 'Enable Prefill by URL', 'wpforms-lite' ),
'<a href="%1$s" target="_blank" rel="noopener noreferrer">%2$s</a>',
wpforms_utm_link( 'https://wpforms.com/developers/how-to-enable-dynamic-field-population/', 'Builder Settings', 'Prefill by URL Tooltip' ),
esc_html__( 'How to use Prefill by URL', 'wpforms-lite' )
esc_html__( 'Enable AJAX form submission', 'wpforms-lite' ),
'tooltip' => esc_html__( 'Enables form submission without page reload.', 'wpforms-lite' ),
* Fires after general settings.
* @param WPForms_Builder_Panel_Settings $settings Current settings.
do_action( 'wpforms_form_settings_general', $this ); // phpcs:ignore WPForms.PHP.ValidateHooks.InvalidHookName
// Wrap advanced settings to the unfoldable group.
wpforms_panel_fields_group(
'group' => 'settings_advanced',
'title' => esc_html__( 'Advanced', 'wpforms-lite' ),
new WPForms_Builder_Panel_Settings();