Changeset 3750893

Timestamp:

10/16/2026 05:56:02 PM (4 weeks ago)

Author:

vectorilo

Message:

Release 1.4

Location:

viswapp-chat-widget

Files:

• tags/1.4.0 (added)
• tags/1.4.0/assets (added)
• tags/1.4.0/assets/admin.css (added)
• tags/1.4.0/assets/admin.js (added)
• tags/1.4.0/assets/cart-capture.js (added)
• tags/1.4.0/assets/form-block.js (added)
• tags/1.4.0/includes (added)
• tags/1.4.0/includes/class-viswapp-forms.php (added)
• tags/1.4.0/includes/class-viswapp-login.php (added)
• tags/1.4.0/includes/class-viswapp-widget-frontend.php (added)
• tags/1.4.0/includes/class-viswapp-widget-options.php (added)
• tags/1.4.0/includes/class-viswapp-widget-settings.php (added)
• tags/1.4.0/includes/class-viswapp-woo-carts.php (added)
• tags/1.4.0/readme.txt (added)
• tags/1.4.0/uninstall.php (added)
• tags/1.4.0/viswapp-chat-widget.php (added)
• trunk/assets/form-block.js (added)
• trunk/includes/class-viswapp-forms.php (added)
• trunk/includes/class-viswapp-widget-settings.php (modified) (6 diffs)
• trunk/readme.txt (modified) (8 diffs)
• trunk/uninstall.php (modified) (2 diffs)
• trunk/viswapp-chat-widget.php (modified) (5 diffs)

viswapp-chat-widget/trunk/includes/class-viswapp-widget-settings.php

@@ -65 +65 @@
         ]);
 
+        // Web forms ([viswapp_form] and the VisWapp form block)
+        register_setting(self::GROUP, VisWapp_Forms::OPTION, [
+            'type'              => 'array',
+            'sanitize_callback' => [$this, 'sanitize_forms'],
+            'default'           => VisWapp_Forms::defaults(),
+        ]);
+
         // WooCommerce abandoned carts (the tab is only shown, and so only posted, with WooCommerce)
         if (VisWapp_Woo_Carts::woo_active()) {
@@ -111 +118 @@
     }
 
+    public function sanitize_forms($input): array
+    {
+        $input = is_array($input) ? wp_unslash($input) : [];
+
+        // A pasted embed code (a form's Share tab) fills both addresses
+        $code = trim((string) ($input['embed'] ?? ''));
+        if ($code !== '') {
+            $parsed = VisWapp_Forms::parse_embed($code);
+            if (empty($parsed['api'])) {
+                add_settings_error(self::PAGE, 'forms_embed', __('That embed code has no data-api. Copy the “Embed on a page” code from VisWapp → Web Forms → Share.', 'viswapp-chat-widget'));
+            }
+            $input = array_merge($input, $parsed);
+        }
+
+        $clean = VisWapp_Forms::sanitize($input);
+        // Only when forms are being set up: the tab is posted with every save
+        if (($code !== '' || $clean['api'] !== '' || $clean['src'] !== '') && !VisWapp_Forms::ready($clean)) {
+            add_settings_error(self::PAGE, 'forms_api', __('Forms need the VisWapp API address: paste a form’s embed code, or set up the chat widget first.', 'viswapp-chat-widget'), 'warning');
+        }
+
+        return $clean;
+    }
+
     public function sanitize_login($input): array
     {
@@ -201 +231 @@
         $wo       = $woo ? VisWapp_Woo_Carts::get() : [];
         $wooReady = $woo && VisWapp_Woo_Carts::ready($wo);
+        $fo       = VisWapp_Forms::get();
+        $formsReady = VisWapp_Forms::ready($fo);
         // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- only picks the open tab
         $tab = isset($_GET['vw_tab']) ? sanitize_key(wp_unslash($_GET['vw_tab'])) : 'chat';
-        if (!in_array($tab, $woo ? ['chat', 'login', 'woo'] : ['chat', 'login'], true)) {
+        if (!in_array($tab, $woo ? ['chat', 'login', 'forms', 'woo'] : ['chat', 'login', 'forms'], true)) {
             $tab = 'chat';
         }
@@ -217 +249 @@
                     <?php esc_html_e('Login with WhatsApp', 'viswapp-chat-widget'); ?>
                     <span class="vw-dot <?php echo esc_attr($loginReady ? 'is-on' : ''); ?>" aria-hidden="true"></span></a>
+                <a href="<?php echo esc_url(add_query_arg('vw_tab', 'forms')); ?>" class="nav-tab <?php echo esc_attr($tab === 'forms' ? 'nav-tab-active' : ''); ?>" data-tab="forms">
+                    <?php esc_html_e('Web forms', 'viswapp-chat-widget'); ?>
+                    <span class="vw-dot <?php echo esc_attr($formsReady ? 'is-on' : ''); ?>" aria-hidden="true"></span></a>
                 <?php if ($woo) : ?>
                 <a href="<?php echo esc_url(add_query_arg('vw_tab', 'woo')); ?>" class="nav-tab <?php echo esc_attr($tab === 'woo' ? 'nav-tab-active' : ''); ?>" data-tab="woo">
@@ -448 +483 @@
 
                 <?php
+                $this->render_forms($fo, $formsReady, $tab === 'forms');
                 if ($woo) {
                     $this->render_woo($wo, $wooReady, $tab === 'woo');
@@ -456 +492 @@
             </form>
         </div>
+        <?php
+    }
+
+    /** Web forms tab: where forms load from, and how to add one */
+    private function render_forms(array $fo, bool $ready, bool $open): void
+    {
+        $name = VisWapp_Forms::OPTION;
+        ?>
+            <div class="vw-pane" data-pane="forms" <?php echo esc_attr($open ? '' : 'hidden'); ?>>
+                <div class="vw-status <?php echo esc_attr($ready ? 'is-on' : 'is-off'); ?>">
+                    <?php if ($ready) : ?>
+                        <strong><?php esc_html_e('Forms are ready to add to your pages.', 'viswapp-chat-widget'); ?></strong>
+                        <span><?php echo esc_html((string) wp_parse_url(VisWapp_Forms::api($fo), PHP_URL_HOST)); ?></span>
+                    <?php else : ?>
+                        <strong><?php esc_html_e('Not set up yet.', 'viswapp-chat-widget'); ?></strong>
+                        <span><?php esc_html_e('Paste a form’s embed code below and save.', 'viswapp-chat-widget'); ?></span>
+                    <?php endif; ?>
+                </div>
+
+                <div class="vw-card">
+                    <h2><?php esc_html_e('1. Connect to VisWapp', 'viswapp-chat-widget'); ?></h2>
+                    <p class="description">
+                        <?php esc_html_e('Build lead forms in VisWapp → Web Forms. Every response becomes a contact, and can create a lead, send a WhatsApp message, add a Google Sheet row or call your webhook. If the chat widget is set up, forms already work: its API address is used.', 'viswapp-chat-widget'); ?>
+                    </p>
+                    <table class="form-table" role="presentation">
+                        <tr>
+                            <th scope="row"><label for="vw-forms-embed"><?php esc_html_e('Embed code', 'viswapp-chat-widget'); ?></label></th>
+                            <td><textarea id="vw-forms-embed" class="large-text code" rows="3" name="<?php echo esc_attr($name); ?>[embed]" placeholder="<?php esc_attr_e('Paste the embed code from VisWapp → Web Forms → Share', 'viswapp-chat-widget'); ?>"></textarea>
+                                <p class="description"><?php esc_html_e('Optional. Any form’s “Embed on a page” code from VisWapp → Web Forms → Share fills the two addresses below.', 'viswapp-chat-widget'); ?></p></td>
+                        </tr>
+                        <tr>
+                            <th scope="row"><label for="vw-forms-api"><?php esc_html_e('API address', 'viswapp-chat-widget'); ?></label></th>
+                            <td><input id="vw-forms-api" type="url" class="regular-text code" name="<?php echo esc_attr($name); ?>[api]" value="<?php echo esc_attr($fo['api']); ?>" placeholder="<?php echo esc_attr(VisWapp_Forms::api(array_merge($fo, ['api' => ''])) ?: 'https://…/api'); ?>">
+                                <p class="description"><?php esc_html_e('The data-api of the embed code. Empty: the chat widget’s Data API address.', 'viswapp-chat-widget'); ?></p></td>
+                        </tr>
+                        <tr>
+                            <th scope="row"><label for="vw-forms-src"><?php esc_html_e('Script address', 'viswapp-chat-widget'); ?></label></th>
+                            <td><input id="vw-forms-src" type="url" class="regular-text code" name="<?php echo esc_attr($name); ?>[src]" value="<?php echo esc_attr($fo['src']); ?>" placeholder="<?php echo esc_attr(VisWapp_Forms::src(array_merge($fo, ['src' => '']))); ?>">
+                                <p class="description"><?php esc_html_e('Where f.js loads from. Empty: next to the chat widget script. It is only added to pages that show a form.', 'viswapp-chat-widget'); ?></p></td>
+                        </tr>
+                    </table>
+                </div>
+
+                <div class="vw-card">
+                    <h2><?php esc_html_e('2. Add a form to a page', 'viswapp-chat-widget'); ?></h2>
+                    <p class="description"><?php esc_html_e('In the block editor, add the “VisWapp form” block and paste the form key. Or use the shortcode anywhere shortcodes work:', 'viswapp-chat-widget'); ?></p>
+                    <p><code>[viswapp_form id="vw_frm_…"]</code> — <?php esc_html_e('the form in the page', 'viswapp-chat-widget'); ?></p>
+                    <p><code>[viswapp_form id="vw_frm_…" mode="popup" label="Get a quote" position="right"]</code> — <?php esc_html_e('a floating button that opens it', 'viswapp-chat-widget'); ?></p>
+                    <p class="description">
+                        <?php
+                        printf(
+                            /* translators: %s: this site's domain */
+                            esc_html__('If a form limits where it can be embedded (Share → Where can it be embedded?), add %s there.', 'viswapp-chat-widget'),
+                            '<code>' . esc_html((string) wp_parse_url(home_url(), PHP_URL_HOST)) . '</code>'
+                        );
+                        ?>
+                    </p>
+                </div>
+
+                <p class="vw-foot">
+                    <?php esc_html_e('Privacy: form answers are sent straight to VisWapp and are not stored in WordPress. Page caching: forms work on cached pages.', 'viswapp-chat-widget'); ?>
+                </p>
+            </div>
         <?php
     }

viswapp-chat-widget/trunk/readme.txt

@@ -1 +1 @@
 === VisWapp Chat Widget ===
 Contributors: vectorilo
-Tags: chat, live chat, whatsapp, whatsapp login, abandoned cart
+Tags: chat, whatsapp, lead form, whatsapp login, abandoned cart
 Requires at least: 5.8
 Tested up to: 7.1
 Requires PHP: 7.4
-Stable tag: 1.3.1
+Stable tag: 1.4.0
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
-VisWapp chat widget, one-tap "Continue with WhatsApp" login and WhatsApp reminders for abandoned WooCommerce carts.
+VisWapp chat widget, lead forms, one-tap "Continue with WhatsApp" login and WhatsApp reminders for abandoned WooCommerce carts.
 
 == Description ==
@@ -21 +21 @@
 * When an identified customer logs out, their chat is cleared from that browser.
 * Login with WhatsApp: a "Continue with WhatsApp" button on the WordPress login page, WooCommerce My account and checkout, or anywhere with the [viswapp_login] shortcode. WhatsApp opens with a message ready; the customer taps send and is logged in. Existing users are matched by WhatsApp number or WooCommerce billing phone; new numbers can get an account automatically.
+* Lead forms: add a form from VisWapp → Web Forms to any page with the "VisWapp form" block or the [viswapp_form] shortcode, in the page or as a popup button. Every response becomes a VisWapp contact and can create a lead, send a WhatsApp message, add a Google Sheet row or call your webhook.
 * Abandoned cart recovery (WooCommerce): carts are sent to VisWapp once the shopper's phone or email is known, and VisWapp sends a WhatsApp reminder with a link that restores the cart and opens checkout.
 
@@ -43 +44 @@
 4. In VisWapp, click Go live when you are ready (test mode works on your allowed domains too).
 
+To add a lead form:
+
+1. In VisWapp, build and publish a form under Web Forms, and copy its form key (vw_frm_…) from the Share tab.
+2. In WordPress, add the "VisWapp form" block to a page and paste the key, or use the shortcode [viswapp_form id="vw_frm_…"].
+3. Forms use the chat widget's API address. Without the chat widget, paste the form's "Embed on a page" code in Settings → VisWapp → Web forms.
+
 To turn on abandoned cart recovery (WooCommerce):
 
@@ -69 +76 @@
     }, 10, 2 );
 
+== Lead forms ==
+
+The block and the shortcode print a placeholder that the VisWapp forms script (f.js) fills in. The script is added only to pages that show a form, and each form is drawn in its own isolated area, so your theme's styles don't change it.
+
+    [viswapp_form id="vw_frm_…"]
+    [viswapp_form id="vw_frm_…" mode="popup" label="Get a quote" position="left"]
+
+* id: the form key from VisWapp → Web Forms → Share (required).
+* mode: inline (the form in the page, default) or popup (a floating button in the form's colour that opens it).
+* label and position: the popup button's text (default: the form title) and corner (right or left).
+
+The form's look, questions, thank-you message and what happens with each response are all set in VisWapp; changes show on your site straight away. Responses record the page they came from and its UTM tags.
+
+Developers can change the printed markup with the viswapp_form_markup filter ($html, $key, $atts); its output is checked against an allow-list.
+
 == External services ==
 
@@ -75 +97 @@
 * Chat widget. On the pages you choose, visitors' browsers load the widget script from the address in your install snippet (by default https://cdn.viswapp.com/w.js) and talk to your VisWapp Data API address. The widget sends the page address and referrer, the page and browser language, basic device details (browser, screen size, time zone), UTM parameters and what the visitor types in the chat. With "Identify logged-in users" on, the logged-in user's ID, name, email and phone number are sent, signed on your server.
 * Login with WhatsApp. On the login, My account and checkout pages (and wherever you place [viswapp_login]) browsers load login.js from your VisWapp sign-in address. When a customer signs in, your server sends the one-time code and your client credentials to that address (/oauth/token) and receives the customer's verified WhatsApp number.
+* Lead forms. On pages that show a [viswapp_form] shortcode or a VisWapp form block, browsers load f.js (by default from next to the chat widget script, e.g. https://cdn.viswapp.com/f.js) and read the form from your VisWapp API address. When a visitor submits, their answers, the page address and referrer and the page's UTM parameters are sent to VisWapp. In the block editor, the form's title is read from the same address for the preview.
 * Abandoned cart recovery (WooCommerce). Once a shopper's phone number or email is known, your server sends the cart (products, quantities, prices, totals, cart link) and the shopper's name, phone number, email, country and marketing consent to your VisWapp delivery URL, and again when the cart changes or the order is placed.
 
@@ -82 +105 @@
 == Privacy ==
 
+Lead form answers (for example name, phone number and email) are sent straight from the visitor's browser to VisWapp and are not stored in WordPress. Mention your forms in your privacy policy, and add a consent checkbox to forms that lead to WhatsApp messages.
+
 With abandoned cart recovery on, cart contents (products, quantities, prices, totals) and the shopper's name, phone number and email address are sent to VisWapp so WhatsApp cart reminders can be sent. The plugin adds suggested text to Settings → Privacy → Policy guide; add it to your privacy policy. Use the consent checkbox where the law requires opt-in for marketing messages. Cart links are stored on your site for 14 days.
 
 == Frequently Asked Questions ==
+
+= How do I add a lead form? =
+
+Add the "VisWapp form" block and paste the form key (vw_frm_…) from VisWapp → Web Forms → Share, or use [viswapp_form id="vw_frm_…"]. Set mode="popup" for a floating button instead. The form must be published in VisWapp; until then visitors see that it is not accepting responses.
+
+= The form says it is not available on this website =
+
+The form only allows some websites. In VisWapp → Web Forms → Share → Where can it be embedded?, add your site's domain.
 
 = Can I put the WhatsApp login button on my own page? =
@@ -138 +171 @@
 = What happens when I delete the plugin? =
 
-Its settings, the saved Identity secret, the WhatsApp Login and abandoned-cart secrets, and saved cart links are removed from WordPress. Chats, contacts and carts stay in VisWapp.
+Its settings (including the Web forms tab), the saved Identity secret, the WhatsApp Login and abandoned-cart secrets, and saved cart links are removed from WordPress. Chats, contacts and carts stay in VisWapp.
 
 == Screenshots ==
@@ -148 +181 @@
 5. Abandoned cart recovery settings for WooCommerce and The WhatsApp reminder with a link that restores the cart.
 
-
 == Changelog ==
+
+= 1.4.0 =
+* Lead forms from VisWapp → Web Forms: the "VisWapp form" block (with a preview of the form in the editor) and the [viswapp_form] shortcode, in the page or as a popup button. The forms script loads only on pages with a form.
+* Settings → VisWapp → Web forms tab: paste a form's embed code, or let forms use the chat widget's API address.
 
 = 1.3.1 =

viswapp-chat-widget/trunk/uninstall.php

@@ -3 +3 @@
  * Deleting the plugin removes its settings, the saved Identity secret, the
  * WhatsApp Login client secret, the abandoned-cart settings and webhook
- * secret, and the saved cart-recovery links. Users keep their viswapp_phone
+ * secret, the web forms settings, and the saved cart-recovery links. Users keep their viswapp_phone
  * meta. Chats, contacts and carts stay in VisWapp.
  */
@@ -21 +21 @@
     delete_option('viswapp_woo_carts');
     delete_option('viswapp_woo_carts_secret');
+    delete_option('viswapp_forms_settings');
 
     // Cart-recovery links and rate-limit counters (transients stored in the options table)

viswapp-chat-widget/trunk/viswapp-chat-widget.php

@@ -3 +3 @@
  * Plugin Name:       VisWapp Chat Widget
  * Plugin URI:        https://viswapp.com
- * Description:       Login with WhatsApp (one tap on wp-login, WooCommerce and the [viswapp_login] shortcode), the VisWapp website chat widget and WooCommerce abandoned cart reminders on WhatsApp. Settings → VisWapp.
- * Version:           1.3.1
+ * Description:       Login with WhatsApp (one tap on wp-login, WooCommerce and the [viswapp_login] shortcode), the VisWapp website chat widget, VisWapp lead forms (the [viswapp_form] shortcode and block) and WooCommerce abandoned cart reminders on WhatsApp. Settings → VisWapp.
+ * Version:           1.4.0
  * Requires at least: 5.8
  * Requires PHP:      7.4
@@ -18 +18 @@
 }
 
-define('VISWAPP_WIDGET_VERSION', '1.3.1');
+define('VISWAPP_WIDGET_VERSION', '1.4.0');
 define('VISWAPP_WIDGET_FILE', __FILE__);
 define('VISWAPP_WIDGET_DIR', plugin_dir_path(__FILE__));
@@ -28 +28 @@
 require_once VISWAPP_WIDGET_DIR . 'includes/class-viswapp-login.php';
 require_once VISWAPP_WIDGET_DIR . 'includes/class-viswapp-woo-carts.php';
+require_once VISWAPP_WIDGET_DIR . 'includes/class-viswapp-forms.php';
 
 // The Identity secret is read only when signing, so it isn't loaded on every request
@@ -36 +37 @@
     add_option(VisWapp_Login::OPTION, VisWapp_Login::defaults());
     VisWapp_Woo_Carts::install();
+    add_option(VisWapp_Forms::OPTION, VisWapp_Forms::defaults());
 });
 
@@ -45 +47 @@
     (new VisWapp_Login())->register();
     (new VisWapp_Woo_Carts())->register(); // does nothing without WooCommerce
+    (new VisWapp_Forms())->register();
 });