: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
namespace WPForms\Integrations\Elementor;
use Elementor\Widget_Base;
use Elementor\Controls_Manager;
* WPForms widget for Elementor page builder.
class Widget extends Widget_Base {
* Retrieve shortcode widget name.
* @return string Widget name.
public function get_name() {
* Retrieve shortcode widget title.
* @return string Widget title.
public function get_title() {
return __( 'WPForms', 'wpforms-lite' );
* Retrieve shortcode widget icon.
* @return string Widget icon.
public function get_icon() {
* Retrieve the list of keywords the widget belongs to.
* @return array Widget keywords.
public function get_keywords() {
* @return array Widget categories.
public function get_categories() {
* Register widget controls.
* Adds different input fields to allow the user to change and customize the widget settings.
protected function register_controls() { // phpcs:ignore PSR2.Methods.MethodDeclaration.Underscore
$this->content_controls();
* Register content tab controls.
protected function content_controls() {
$this->start_controls_section(
'label' => esc_html__( 'Form', 'wpforms-lite' ),
'tab' => Controls_Manager::TAB_CONTENT,
$forms = $this->get_forms();
'type' => Controls_Manager::RAW_HTML,
__( '<b>You haven\'t created a form yet.</b><br> What are you waiting for?', 'wpforms-lite' ),
'content_classes' => 'elementor-panel-alert elementor-panel-alert-info wpforms-elementor-no-forms-notice',
'label' => esc_html__( 'Form', 'wpforms-lite' ),
'type' => Controls_Manager::SELECT,
'type' => Controls_Manager::RAW_HTML,
'raw' => wp_kses( /* translators: %s - WPForms documentation link. */
__( 'Need to make changes? <a href="#">Edit the selected form.</a>', 'wpforms-lite' ),
'type' => Controls_Manager::RAW_HTML,
wp_kses( /* translators: %s - WPForms documentation link. */
__( '<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' ),
'https://wpforms.com/docs/how-to-properly-test-your-wordpress-forms-before-launching-checklist/'
'content_classes' => 'elementor-panel-alert elementor-panel-alert-info',
'type' => Controls_Manager::BUTTON,
'button_type' => 'default',
'text' => '<b>+</b>' . esc_html__( 'New form', 'wpforms-lite' ),
'event' => 'elementorWPFormsAddFormBtnClick',
$this->end_controls_section();
$this->start_controls_section(
'label' => esc_html__( 'Display Options', 'wpforms-lite' ),
'tab' => Controls_Manager::TAB_CONTENT,
'label' => esc_html__( 'Form Name', 'wpforms-lite' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => esc_html__( 'Show', 'wpforms-lite' ),
'label_off' => esc_html__( 'Hide', 'wpforms-lite' ),
'display_form_description',
'label' => esc_html__( 'Form Description', 'wpforms-lite' ),
'type' => Controls_Manager::SWITCHER,
'label_on' => esc_html__( 'Show', 'wpforms-lite' ),
'label_off' => esc_html__( 'Hide', 'wpforms-lite' ),
$this->end_controls_section();
protected function render() {
if ( Plugin::$instance->editor->is_edit_mode() ) {
$this->render_edit_mode();
$this->render_frontend();
* Render widget output in edit mode.
protected function render_edit_mode() {
$form_id = $this->get_settings_for_display( 'form_id' );
// Popup markup template.
echo wpforms_render( 'integrations/elementor/popup' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
if ( count( $this->get_forms() ) < 2 ) {
echo wpforms_render( 'integrations/elementor/no-forms' ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
if ( empty( $form_id ) ) {
echo wpforms_render( // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
'integrations/elementor/form-selector',
'forms' => $this->get_form_selector_options(),
// Finally, render selected form.
$this->render_frontend();
* Render widget output on the frontend.
protected function render_frontend() {
static $is_root_vars_displayed = false;
$css_vars_obj = wpforms()->get( 'css_vars' );
if ( ! empty( $css_vars_obj ) && wpforms_get_render_engine() === 'modern' && ! $is_root_vars_displayed ) {
$css_vars_obj->output_root( true );
$is_root_vars_displayed = true;
* Render widget as plain content.
public function render_plain_content() {
public function render_shortcode() {
_deprecated_function( __METHOD__, '1.8.3 of the WPForms plugin', __CLASS__ . '::render_form()' );
'[wpforms id="%1$d" title="%2$s" description="%3$s"]',
absint( $this->get_settings_for_display( 'form_id' ) ),
sanitize_key( $this->get_settings_for_display( 'display_form_name' ) === 'yes' ? 'true' : 'false' ),
sanitize_key( $this->get_settings_for_display( 'display_form_description' ) === 'yes' ? 'true' : 'false' )
public function render_form() {
$this->get_settings_for_display( 'form_id' ),
$this->get_settings_for_display( 'display_form_name' ) === 'yes',
$this->get_settings_for_display( 'display_form_description' ) === 'yes'
* @returns array Array of forms.
public function get_forms() {
if ( empty( $forms_list ) ) {
$forms = wpforms()->get( 'form' )->get();
if ( ! empty( $forms ) ) {
$forms_list[0] = esc_html__( 'Select a form', 'wpforms-lite' );
foreach ( $forms as $form ) {
$forms_list[ $form->ID ] = mb_strlen( $form->post_title ) > 100 ? mb_substr( $form->post_title, 0, 97 ) . '...' : $form->post_title;
* Get form selector options.
* @returns string Rendered options for the select tag.
public function get_form_selector_options() {
$forms = $this->get_forms();
foreach ( $forms as $form_id => $form ) {
'<option value="%d">%s</option>',