Edit File by line
/home/zeestwma/richards.../wp-conte.../plugins/wpforms-.../src/Integrat.../Elemento...
File: Widget.php
<?php
[0] Fix | Delete
[1] Fix | Delete
// phpcs:disable Generic.Commenting.DocComment.MissingShort
[2] Fix | Delete
/** @noinspection PhpUndefinedNamespaceInspection */
[3] Fix | Delete
/** @noinspection PhpUndefinedClassInspection */
[4] Fix | Delete
// phpcs:enable Generic.Commenting.DocComment.MissingShort
[5] Fix | Delete
[6] Fix | Delete
namespace WPForms\Integrations\Elementor;
[7] Fix | Delete
[8] Fix | Delete
use Elementor\Plugin;
[9] Fix | Delete
use Elementor\Widget_Base;
[10] Fix | Delete
use Elementor\Controls_Manager;
[11] Fix | Delete
[12] Fix | Delete
/**
[13] Fix | Delete
* WPForms widget for Elementor page builder.
[14] Fix | Delete
*
[15] Fix | Delete
* @since 1.6.2
[16] Fix | Delete
*/
[17] Fix | Delete
class Widget extends Widget_Base {
[18] Fix | Delete
[19] Fix | Delete
/**
[20] Fix | Delete
* Script dependencies.
[21] Fix | Delete
*
[22] Fix | Delete
* @since 1.9.1
[23] Fix | Delete
*
[24] Fix | Delete
* @return array
[25] Fix | Delete
*/
[26] Fix | Delete
public function get_script_depends(): array {
[27] Fix | Delete
[28] Fix | Delete
return [ 'wpforms-elementor' ];
[29] Fix | Delete
}
[30] Fix | Delete
[31] Fix | Delete
/**
[32] Fix | Delete
* Get widget name.
[33] Fix | Delete
*
[34] Fix | Delete
* Retrieve shortcode widget name.
[35] Fix | Delete
*
[36] Fix | Delete
* @since 1.6.2
[37] Fix | Delete
*
[38] Fix | Delete
* @return string Widget name.
[39] Fix | Delete
*/
[40] Fix | Delete
public function get_name() {
[41] Fix | Delete
[42] Fix | Delete
return 'wpforms';
[43] Fix | Delete
}
[44] Fix | Delete
[45] Fix | Delete
/**
[46] Fix | Delete
* Get widget title.
[47] Fix | Delete
*
[48] Fix | Delete
* Retrieve shortcode widget title.
[49] Fix | Delete
*
[50] Fix | Delete
* @since 1.6.2
[51] Fix | Delete
*
[52] Fix | Delete
* @return string Widget title.
[53] Fix | Delete
*/
[54] Fix | Delete
public function get_title() {
[55] Fix | Delete
[56] Fix | Delete
return __( 'WPForms', 'wpforms-lite' );
[57] Fix | Delete
}
[58] Fix | Delete
[59] Fix | Delete
/**
[60] Fix | Delete
* Get widget icon.
[61] Fix | Delete
*
[62] Fix | Delete
* Retrieve shortcode widget icon.
[63] Fix | Delete
*
[64] Fix | Delete
* @since 1.6.2
[65] Fix | Delete
*
[66] Fix | Delete
* @return string Widget icon.
[67] Fix | Delete
*/
[68] Fix | Delete
public function get_icon() {
[69] Fix | Delete
[70] Fix | Delete
return 'icon-wpforms';
[71] Fix | Delete
}
[72] Fix | Delete
[73] Fix | Delete
/**
[74] Fix | Delete
* Get widget keywords.
[75] Fix | Delete
*
[76] Fix | Delete
* Retrieve the list of keywords the widget belongs to.
[77] Fix | Delete
*
[78] Fix | Delete
* @since 1.6.2
[79] Fix | Delete
*
[80] Fix | Delete
* @return array Widget keywords.
[81] Fix | Delete
*/
[82] Fix | Delete
public function get_keywords() {
[83] Fix | Delete
[84] Fix | Delete
return [
[85] Fix | Delete
'form',
[86] Fix | Delete
'forms',
[87] Fix | Delete
'wpforms',
[88] Fix | Delete
'contact form',
[89] Fix | Delete
'sullie',
[90] Fix | Delete
'the dude',
[91] Fix | Delete
];
[92] Fix | Delete
}
[93] Fix | Delete
[94] Fix | Delete
/**
[95] Fix | Delete
* Get widget categories.
[96] Fix | Delete
*
[97] Fix | Delete
* @since 1.6.2
[98] Fix | Delete
*
[99] Fix | Delete
* @return array Widget categories.
[100] Fix | Delete
*/
[101] Fix | Delete
public function get_categories() {
[102] Fix | Delete
[103] Fix | Delete
return [
[104] Fix | Delete
'basic',
[105] Fix | Delete
];
[106] Fix | Delete
}
[107] Fix | Delete
[108] Fix | Delete
/**
[109] Fix | Delete
* Register widget controls.
[110] Fix | Delete
*
[111] Fix | Delete
* Adds different input fields to allow the user to change and customize the widget settings.
[112] Fix | Delete
*
[113] Fix | Delete
* @since 1.6.2
[114] Fix | Delete
*/
[115] Fix | Delete
protected function register_controls() { // phpcs:ignore PSR2.Methods.MethodDeclaration.Underscore
[116] Fix | Delete
[117] Fix | Delete
$this->content_controls();
[118] Fix | Delete
}
[119] Fix | Delete
[120] Fix | Delete
/**
[121] Fix | Delete
* Register content tab controls.
[122] Fix | Delete
*
[123] Fix | Delete
* @since 1.6.2
[124] Fix | Delete
*
[125] Fix | Delete
* @noinspection PhpUndefinedMethodInspection
[126] Fix | Delete
* @noinspection HtmlUnknownTarget
[127] Fix | Delete
*/
[128] Fix | Delete
protected function content_controls() {
[129] Fix | Delete
[130] Fix | Delete
$this->start_controls_section(
[131] Fix | Delete
'section_form',
[132] Fix | Delete
[
[133] Fix | Delete
'label' => esc_html__( 'Form', 'wpforms-lite' ),
[134] Fix | Delete
'tab' => Controls_Manager::TAB_CONTENT,
[135] Fix | Delete
]
[136] Fix | Delete
);
[137] Fix | Delete
[138] Fix | Delete
$forms = $this->get_forms();
[139] Fix | Delete
[140] Fix | Delete
if ( empty( $forms ) ) {
[141] Fix | Delete
$this->add_control(
[142] Fix | Delete
'add_form_notice',
[143] Fix | Delete
[
[144] Fix | Delete
'show_label' => false,
[145] Fix | Delete
'type' => Controls_Manager::RAW_HTML,
[146] Fix | Delete
'raw' => wp_kses(
[147] Fix | Delete
__( '<b>You haven\'t created a form yet.</b><br> What are you waiting for?', 'wpforms-lite' ),
[148] Fix | Delete
[
[149] Fix | Delete
'b' => [],
[150] Fix | Delete
'br' => [],
[151] Fix | Delete
]
[152] Fix | Delete
),
[153] Fix | Delete
'content_classes' => 'elementor-panel-alert elementor-panel-alert-info wpforms-elementor-no-forms-notice',
[154] Fix | Delete
]
[155] Fix | Delete
);
[156] Fix | Delete
}
[157] Fix | Delete
[158] Fix | Delete
$this->add_control(
[159] Fix | Delete
'form_id',
[160] Fix | Delete
[
[161] Fix | Delete
'label' => esc_html__( 'Form', 'wpforms-lite' ),
[162] Fix | Delete
'type' => Controls_Manager::SELECT,
[163] Fix | Delete
'label_block' => true,
[164] Fix | Delete
'options' => $forms,
[165] Fix | Delete
'default' => '0',
[166] Fix | Delete
]
[167] Fix | Delete
);
[168] Fix | Delete
[169] Fix | Delete
$this->add_control(
[170] Fix | Delete
'edit_form',
[171] Fix | Delete
[
[172] Fix | Delete
'show_label' => false,
[173] Fix | Delete
'type' => Controls_Manager::RAW_HTML,
[174] Fix | Delete
'raw' => wp_kses( /* translators: %s - WPForms documentation link. */
[175] Fix | Delete
__( 'Need to make changes? <a href="#">Edit the selected form.</a>', 'wpforms-lite' ),
[176] Fix | Delete
[ 'a' => [] ]
[177] Fix | Delete
),
[178] Fix | Delete
'condition' => [
[179] Fix | Delete
'form_id!' => '0',
[180] Fix | Delete
],
[181] Fix | Delete
]
[182] Fix | Delete
);
[183] Fix | Delete
[184] Fix | Delete
$this->add_control(
[185] Fix | Delete
'test_form_notice',
[186] Fix | Delete
[
[187] Fix | Delete
'show_label' => false,
[188] Fix | Delete
'type' => Controls_Manager::RAW_HTML,
[189] Fix | Delete
'raw' => sprintf(
[190] Fix | Delete
wp_kses( /* translators: %s - WPForms documentation link. */
[191] Fix | Delete
__( '<b>Heads up!</b> Don\'t forget to test your form. <a href="%s" target="_blank" rel="noopener noreferrer">Check out our complete guide!</a>', 'wpforms-lite' ),
[192] Fix | Delete
[
[193] Fix | Delete
'b' => [],
[194] Fix | Delete
'br' => [],
[195] Fix | Delete
'a' => [
[196] Fix | Delete
'href' => [],
[197] Fix | Delete
'rel' => [],
[198] Fix | Delete
'target' => [],
[199] Fix | Delete
],
[200] Fix | Delete
]
[201] Fix | Delete
),
[202] Fix | Delete
'https://wpforms.com/docs/how-to-properly-test-your-wordpress-forms-before-launching-checklist/'
[203] Fix | Delete
),
[204] Fix | Delete
'condition' => [
[205] Fix | Delete
'form_id!' => '0',
[206] Fix | Delete
],
[207] Fix | Delete
'content_classes' => 'elementor-panel-alert elementor-panel-alert-info',
[208] Fix | Delete
]
[209] Fix | Delete
);
[210] Fix | Delete
[211] Fix | Delete
$this->add_control(
[212] Fix | Delete
'add_form_btn',
[213] Fix | Delete
[
[214] Fix | Delete
'show_label' => false,
[215] Fix | Delete
'label_block' => false,
[216] Fix | Delete
'type' => Controls_Manager::BUTTON,
[217] Fix | Delete
'button_type' => 'default',
[218] Fix | Delete
'separator' => 'before',
[219] Fix | Delete
'text' => '<b>+</b>' . esc_html__( 'New form', 'wpforms-lite' ),
[220] Fix | Delete
'event' => 'elementorWPFormsAddFormBtnClick',
[221] Fix | Delete
]
[222] Fix | Delete
);
[223] Fix | Delete
[224] Fix | Delete
$this->add_legacy_styles_notice();
[225] Fix | Delete
[226] Fix | Delete
$this->end_controls_section();
[227] Fix | Delete
[228] Fix | Delete
$this->start_controls_section(
[229] Fix | Delete
'section_display',
[230] Fix | Delete
[
[231] Fix | Delete
'label' => esc_html__( 'Display Options', 'wpforms-lite' ),
[232] Fix | Delete
'tab' => Controls_Manager::TAB_CONTENT,
[233] Fix | Delete
'condition' => [
[234] Fix | Delete
'form_id!' => '0',
[235] Fix | Delete
],
[236] Fix | Delete
]
[237] Fix | Delete
);
[238] Fix | Delete
[239] Fix | Delete
$this->add_control(
[240] Fix | Delete
'display_form_name',
[241] Fix | Delete
[
[242] Fix | Delete
'label' => esc_html__( 'Form Name', 'wpforms-lite' ),
[243] Fix | Delete
'type' => Controls_Manager::SWITCHER,
[244] Fix | Delete
'label_on' => esc_html__( 'Show', 'wpforms-lite' ),
[245] Fix | Delete
'label_off' => esc_html__( 'Hide', 'wpforms-lite' ),
[246] Fix | Delete
'return_value' => 'yes',
[247] Fix | Delete
'condition' => [
[248] Fix | Delete
'form_id!' => '0',
[249] Fix | Delete
],
[250] Fix | Delete
]
[251] Fix | Delete
);
[252] Fix | Delete
[253] Fix | Delete
$this->add_control(
[254] Fix | Delete
'display_form_description',
[255] Fix | Delete
[
[256] Fix | Delete
'label' => esc_html__( 'Form Description', 'wpforms-lite' ),
[257] Fix | Delete
'type' => Controls_Manager::SWITCHER,
[258] Fix | Delete
'label_on' => esc_html__( 'Show', 'wpforms-lite' ),
[259] Fix | Delete
'label_off' => esc_html__( 'Hide', 'wpforms-lite' ),
[260] Fix | Delete
'separator' => 'after',
[261] Fix | Delete
'return_value' => 'yes',
[262] Fix | Delete
'condition' => [
[263] Fix | Delete
'form_id!' => '0',
[264] Fix | Delete
],
[265] Fix | Delete
]
[266] Fix | Delete
);
[267] Fix | Delete
[268] Fix | Delete
$this->end_controls_section();
[269] Fix | Delete
}
[270] Fix | Delete
[271] Fix | Delete
/**
[272] Fix | Delete
* Add legacy styles notice.
[273] Fix | Delete
*
[274] Fix | Delete
* @since 1.9.6
[275] Fix | Delete
*
[276] Fix | Delete
* @noinspection PhpUndefinedMethodInspection
[277] Fix | Delete
* @noinspection HtmlUnknownTarget
[278] Fix | Delete
*/
[279] Fix | Delete
private function add_legacy_styles_notice() {
[280] Fix | Delete
[281] Fix | Delete
$is_modern = wpforms_get_render_engine() === 'modern';
[282] Fix | Delete
$is_full_styles = (int) wpforms_setting( 'disable-css', '1' ) === 1;
[283] Fix | Delete
[284] Fix | Delete
if ( ! $is_modern || ! $is_full_styles ) {
[285] Fix | Delete
$notice_text = ! $is_modern
[286] Fix | Delete
? __( 'Upgrade your forms to use our modern markup and unlock extensive style controls.', 'wpforms-lite' )
[287] Fix | Delete
: __( 'Update your forms to use base and form theme styling and unlock extensive style controls.', 'wpforms-lite' );
[288] Fix | Delete
[289] Fix | Delete
$this->add_control(
[290] Fix | Delete
'legacy_styling_notice',
[291] Fix | Delete
[
[292] Fix | Delete
'show_label' => false,
[293] Fix | Delete
'type' => Controls_Manager::RAW_HTML,
[294] Fix | Delete
'raw' => sprintf(
[295] Fix | Delete
wp_kses( /* translators: %s - WPForms documentation link. */
[296] Fix | Delete
__( '<b>Want to customize your form styles without editing CSS?</b> <p>%1$s</p> <a href="%2$s" target="_blank" rel="noopener noreferrer">Learn more</a>', 'wpforms-lite' ),
[297] Fix | Delete
[
[298] Fix | Delete
'b' => [],
[299] Fix | Delete
'p' => [],
[300] Fix | Delete
'a' => [
[301] Fix | Delete
'href' => [],
[302] Fix | Delete
'rel' => [],
[303] Fix | Delete
'target' => [],
[304] Fix | Delete
],
[305] Fix | Delete
]
[306] Fix | Delete
),
[307] Fix | Delete
$notice_text,
[308] Fix | Delete
wpforms_utm_link( 'https://wpforms.com/docs/styling-your-forms/', 'Elementor Widget Settings', 'Form Styles Documentation' )
[309] Fix | Delete
),
[310] Fix | Delete
'content_classes' => 'elementor-panel-alert elementor-panel-alert-warning wpforms-legacy-styles-notice',
[311] Fix | Delete
]
[312] Fix | Delete
);
[313] Fix | Delete
}
[314] Fix | Delete
}
[315] Fix | Delete
[316] Fix | Delete
/**
[317] Fix | Delete
* Render widget output.
[318] Fix | Delete
*
[319] Fix | Delete
* @since 1.6.2
[320] Fix | Delete
*/
[321] Fix | Delete
protected function render() {
[322] Fix | Delete
[323] Fix | Delete
if ( Plugin::$instance->editor->is_edit_mode() ) {
[324] Fix | Delete
$this->render_edit_mode();
[325] Fix | Delete
} else {
[326] Fix | Delete
$this->render_frontend();
[327] Fix | Delete
}
[328] Fix | Delete
}
[329] Fix | Delete
[330] Fix | Delete
/**
[331] Fix | Delete
* Render widget output in edit mode.
[332] Fix | Delete
*
[333] Fix | Delete
* @since 1.6.3.1
[334] Fix | Delete
*
[335] Fix | Delete
* @noinspection PhpPossiblePolymorphicInvocationInspection
[336] Fix | Delete
*/
[337] Fix | Delete
protected function render_edit_mode() {
[338] Fix | Delete
[339] Fix | Delete
$form_id = $this->get_settings_for_display( 'form_id' );
[340] Fix | Delete
[341] Fix | Delete
// Popup markup template.
[342] Fix | Delete
echo wpforms_render( 'integrations/elementor/popup' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
[343] Fix | Delete
[344] Fix | Delete
if ( count( $this->get_forms() ) < 2 ) {
[345] Fix | Delete
[346] Fix | Delete
// No forms block.
[347] Fix | Delete
echo wpforms_render( 'integrations/elementor/no-forms' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
[348] Fix | Delete
[349] Fix | Delete
return;
[350] Fix | Delete
}
[351] Fix | Delete
[352] Fix | Delete
if ( empty( $form_id ) ) {
[353] Fix | Delete
[354] Fix | Delete
// Render form selector.
[355] Fix | Delete
echo wpforms_render( // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
[356] Fix | Delete
'integrations/elementor/form-selector',
[357] Fix | Delete
[
[358] Fix | Delete
'forms' => $this->get_form_selector_options(),
[359] Fix | Delete
],
[360] Fix | Delete
true
[361] Fix | Delete
);
[362] Fix | Delete
[363] Fix | Delete
return;
[364] Fix | Delete
}
[365] Fix | Delete
[366] Fix | Delete
// Finally, render selected form.
[367] Fix | Delete
$this->render_frontend();
[368] Fix | Delete
}
[369] Fix | Delete
[370] Fix | Delete
/**
[371] Fix | Delete
* Render widget output on the frontend.
[372] Fix | Delete
*
[373] Fix | Delete
* @since 1.6.3.1
[374] Fix | Delete
*/
[375] Fix | Delete
protected function render_frontend() {
[376] Fix | Delete
[377] Fix | Delete
// Render selected form.
[378] Fix | Delete
$this->render_form();
[379] Fix | Delete
}
[380] Fix | Delete
[381] Fix | Delete
/**
[382] Fix | Delete
* Render widget as plain content.
[383] Fix | Delete
*
[384] Fix | Delete
* @since 1.6.2
[385] Fix | Delete
*/
[386] Fix | Delete
public function render_plain_content() {
[387] Fix | Delete
[388] Fix | Delete
$this->render_form();
[389] Fix | Delete
}
[390] Fix | Delete
[391] Fix | Delete
/**
[392] Fix | Delete
* Render a form.
[393] Fix | Delete
*
[394] Fix | Delete
* @since 1.8.3
[395] Fix | Delete
*
[396] Fix | Delete
* @noinspection PhpPossiblePolymorphicInvocationInspection
[397] Fix | Delete
*/
[398] Fix | Delete
public function render_form() {
[399] Fix | Delete
[400] Fix | Delete
wpforms_display(
[401] Fix | Delete
$this->get_settings_for_display( 'form_id' ),
[402] Fix | Delete
$this->get_settings_for_display( 'display_form_name' ) === 'yes',
[403] Fix | Delete
$this->get_settings_for_display( 'display_form_description' ) === 'yes'
[404] Fix | Delete
);
[405] Fix | Delete
}
[406] Fix | Delete
[407] Fix | Delete
/**
[408] Fix | Delete
* Get form list.
[409] Fix | Delete
*
[410] Fix | Delete
* @since 1.6.2
[411] Fix | Delete
*
[412] Fix | Delete
* @returns array Array of forms.
[413] Fix | Delete
*/
[414] Fix | Delete
public function get_forms() {
[415] Fix | Delete
[416] Fix | Delete
static $forms_list = [];
[417] Fix | Delete
[418] Fix | Delete
if ( empty( $forms_list ) ) {
[419] Fix | Delete
$forms_obj = wpforms()->obj( 'form' );
[420] Fix | Delete
$forms = $forms_obj ? $forms_obj->get() : null;
[421] Fix | Delete
[422] Fix | Delete
if ( ! empty( $forms ) ) {
[423] Fix | Delete
$forms_list[0] = esc_html__( 'Select a form', 'wpforms-lite' );
[424] Fix | Delete
[425] Fix | Delete
foreach ( $forms as $form ) {
[426] Fix | Delete
$forms_list[ $form->ID ] = mb_strlen( $form->post_title ) > 100 ? mb_substr( $form->post_title, 0, 97 ) . '...' : $form->post_title;
[427] Fix | Delete
}
[428] Fix | Delete
}
[429] Fix | Delete
}
[430] Fix | Delete
[431] Fix | Delete
return $forms_list;
[432] Fix | Delete
}
[433] Fix | Delete
[434] Fix | Delete
/**
[435] Fix | Delete
* Get form selector options.
[436] Fix | Delete
*
[437] Fix | Delete
* @since 1.6.2
[438] Fix | Delete
*
[439] Fix | Delete
* @returns string Rendered options for the select tag.
[440] Fix | Delete
*/
[441] Fix | Delete
public function get_form_selector_options() {
[442] Fix | Delete
[443] Fix | Delete
$forms = $this->get_forms();
[444] Fix | Delete
$options = '';
[445] Fix | Delete
[446] Fix | Delete
foreach ( $forms as $form_id => $form ) {
[447] Fix | Delete
$options .= sprintf(
[448] Fix | Delete
'<option value="%d">%s</option>',
[449] Fix | Delete
(int) $form_id,
[450] Fix | Delete
esc_html( $form )
[451] Fix | Delete
);
[452] Fix | Delete
}
[453] Fix | Delete
[454] Fix | Delete
return $options;
[455] Fix | Delete
}
[456] Fix | Delete
}
[457] Fix | Delete
[458] Fix | Delete
It is recommended that you Edit text format, this type of Fix handles quite a lot in one request
Function