WordPress WhatsApp Support

  • How to install plugin

    Step 1: Download the zip file from the codecanyon.net

    Step 2: Extract the downloaded zip file on your desktop or in any folder.

    Step 3: Open the extracted folder “wordpress-whatsapp-support“.

    Step 4: Here you found three folders 1) Documentation 2) License 3) Plugin.

    Step 5: Open “Plugin” folder. Now you found the main plugin file “plugin.zip“.

    Step 6: Log in to your WordPress admin panel.

    Step 7: Mouse over the “Plugins” menu and click on “Add new“.

    Step 8: Click on the “Upload Plugin” button and then click on the “Browse” button.

    Step 9: Select the “plugin.zip” file and click on the “Upload” button.

    Step 10: Now the final step, after uploading complete click on the “Activate Plugin” button.

  • Plugin Settings

    • Appearance

      Select Layout: You can select the layout according to your need.

      Layout Background Color: Set popup layout background color. Default #0dc152

      Layout Text Color: Set popup layout text color.#ffffff

      Enable Layout Gradient: Enable/ Disable popup background gradient.

      Show Only Icon on Mobile: Enable this option if you what to display an icon instead of text button on mobile.

    • Basic Settings

      X-axis Offset: Enter the value of x-axis ( horizontal ) widget spacing. In px ( pixels ) only. Default 12px.

      Y-axis Offset: Enter the value of y-axis ( vertical ) widget spacing. In px ( pixels ) only. Default 12px.

      Display On Desktop: Display on desktop/laptop.

      Display On Mobile: Display on mobile devices.

      Auto Popup: Enter the popup auto display time in seconds.

      Auto Popup Delay: Select the time in seconds for auto popup delay.

      Enable RTL: You can enable RTL ( Right to Left ) if your website has language like Arabic, Persian and Hebrew.

      Scroll Length: Display button when scroll length matched with above value. Default Blank.

      Filter By All Pages: You can hide/show widge on all pages on one click.

      Filter By FrontPage: You can hide/show widget on the front page.

      Hide Widget By URL: Hide widget by the URL

      Schedule: You can hide/ show the widget by your schedule time.

      Custom CSS: Enter your custom CSS.

    • Button Generator

      Button Generator is tool to generate unlimited WhatsApp contact buttons.

      //

    • Analytics

      Analytics is the inbuilt powerful feature of the WeCreativez WhatsApp Support. Here you can check the daily and monthly report.

      //

      //

    • Facebook and Google Analytics

      Facebook Pixel Click Tracking:

      Facebook Click Tracking: You can enable or disable Facebook pixel click tracking.

      FB Event: Enter the name of custom event to track on Facebook pixel.

      FB Event Label: Enter the label of custom event to track on Facebook pixel.

       

      Google Event Tracking:

      Google Event Tracking: You can enable or disable google event click tracking.

      GA Event: Enter the name of custom the event to track on Google Analytics.

      GA Event Category: Enter the name of the event category.

      GA Event Label: Enter the label of the event.

    • GDPR Settings

      GDPR Compliant Settings:

      GDPR: Enable/ Disable GDPR compliant.

      GDPR Message: Use shortcode {policy_url} to add privacy page link.

      Privacy page: Select your privacy page.

  • Third-party Compatibility

    • Dokan Multivendor Compatibility

      WhatsApp Support Dokan Multivendor Compatibility

      Allow your customers to direct contact with Dokan Vendors. Our plugin provides a beautiful and effortless way to start communicating between the Dokan vendors and the users/customers through WhatsApp. Our plugin is fully compatible with Dokan Lite and Dokan Pro.

       

      Requirement:

      1. WooCommerce 5 or higher installed and activated.
      2. Dokan Lite/Pro installed and activated.
      3. WordPress WhatsApp Support 2.3.0 or higher installed and activated.
        • Single Person layout activated.

      Features:

      1. Store Level (Priority 2):
        • The vendors can add WhatsApp Support number on their store page.
        • Admin can also add/edit vendor's WhatsApp Support number from edit vendor/ edit user page.
        • Admin can hide widget or product query button if WhatsApp Support number is not set at the Store Level.
      2. Product Level (Priority 1):
        • The vendors can add WhatsApp Support number on their product page.
        • Admin can also add/edit vendor's WhatsApp Support number by editing the vendor's product page from WooCommerce backend.
        • Admin can hide widget or product query button if WhatsApp Support number is not set at the Product Level. 

      Store Level and Product Level Priorities:

      Store Level allows vendors to add the WhatsApp Support number store wise whereas Product Level allows vendors to add the WhatsApp Support number product wise. You can use both the levels together by enabling them from the plugin settings. 

      Once the plugin finds a WhatsApp Support number at the Product Level priority 1 comes into the play and the support messages are sent to the support number entered at the Product Level. If the WhatsApp Support number is not set at the Product Level then the messages are sent to the Store Level WhatsApp Support number. In case, both Levels WhatsApp Support numbers are not set then messages will be sent to the Admin WhatsApp Support number.

       

      Settings:

      WhatsApp Support For Dokan: You can enable/disable the WordPress WhatsApp Support For Dokan Multivendor module.

      Vendor Support Widget: This option allows users or customers to contact the vendor through the popup widget.

      Vendor Support Product Query: This option allows users or customers to contact the vendor through the product query button.

       

      Product Level (Priority 1) Settings:

      Product Level: This feature allows vendors to add WhatsApp Numbers for customer support from their Dokan's edit product page.

      Hide Widget: Enable if you want to hide a widget on the product page if the product level WhatsApp Support number is empty.

      Hide Product Query: Enable if you want to hide the product query button on the product page if the product level WhatsApp Support number is empty.

       

      Store Level (Priority 2) Settings:

      Store Level: This feature allows vendors to add WhatsApp Number for customer support from their Dokan's store page.

      Hide Widget: Enable if you want to hide a widget on the product page if the store level WhatsApp Support number is empty.

      Hide Product Query: Enable if you want to hide the product query button on the product page if the store level WhatsApp Support number is empty.

       

  • Analytics

    • Built-in Analytics

      Our built-in analytics not collecting any personal data of the WhatsApp user. The data collected by our built-in analytics is the common data which can be collected by any non-WordPress plugin. Like, as IP address, browser information, etc.

       

      WordPress WhatsApp Support has a very powerful built-in analytics feature. Here you can track analytics and information. 

      Top 10 Click Analytics: Top 10 click analytics collects various kinds of information. Like, as the IP address of the user,  Top 10 referral links, Top 10 operating systems, and Top 10 browsers. This collected data will help you to know more about your customers who contacted you through our plugin.

      Built-in Analytics also has a feature to export analytics as a CSV.

    • Google Analytics 4

      WordPress WhatsApp Support Event Tracking in Google Analytics 4

      Requirements:

      1. Google Analytics 4 on your website

      Step 1: Insert gtag.js into your WordPress site if not inserted. To know more about how to generate and insert gtag.js, please read this article.

      Step 2: Goto the WordPress admin panel > WhatsApp Support > FB & GA Analytics.

      Step 3: Enable the "Google Event Tracking" option.

      Step 4: Enter the following details as per your need.

      1. GA Event: Enter the name of custom the event to track on Google Analytics 4.
      2. GA Event Category: Enter the name of the event category.
      3. GA Event Label: Enter the label of the event.

      Step 5: Hit on the Save Changes button to save the changes. 

       

      It will take 24-48 hours to show the entries on your Google Analytics 4 events dashboard.

       

      For Developers:

      You can hook the custom Google Analytics 4 event(s) with the WordPress WhatsApp Support message sent to trigger.

      jQuery( document.body ).on( 'wws_message_sent', function() {
          // Send custom event.
          gtag( "event", "Button Clicked", {
              "event_category": "WordPress WhatsApp Support",
              "event_label": "Support"
          } );
      } );
      
    • Google Tag Manager

      WordPress WhatsApp Support Event Tracking using Google Tag Manager

      Requirements:

      1. Google Tag Manager on your website
      2. WordPress WhatsApp Support version 2.4.0 or higher. 

      Step 1: Insert gtm.js into your WordPress site if not inserted. To know more about how to generate and insert gtm.js, please read this article.

      Step 2: Goto the WordPress admin panel > WhatsApp Support > FB & GA Analytics.

      Step 3: Enable the "Google Event Tracking" option.

      Step 3: Enable the "Google Event Tracking" option.

      Step 4: Enter the following details as per your need.

      1. GA Event: Enter the name of custom the event to track on Google Tag Manager.
      2. GA Event Category: Enter the name of the event category.
      3. GA Event Label: Enter the label of the event.

      Step 5: Hit on the Save Changes button to save the changes. 

      Step 6: Open https://tagmanager.google.com/ and select your Tag Manager Account, or create a new account if you haven’t. Under the Tag Manager Account, add your website as a new Container, which includes these details:

      Container Name: 'yourdomain.com'
      Container Type: 'Web'
      Container ID: This GTM ID will be given. e.g. 'GTM-ABCD123

      After that, you can enter the Container > Workspace and land on a new dashboard with a left panel including Overview, Tags, Triggers, Variables, etc.

      Step 7: Now Click on the Tags and the New button to create one.

      After clicking on the New button from the above step, a new slide popup will open. Enter any name like we entered the WhatsApp GTM then click on the pencil icon from the Tag Configuration.

      A new Choose tag type window will open to select the tag. From the tag list, select Google Analytics: GA4 Event.

      Now, Select the None - Manually Set ID From the Configuration Tag option. Enter Google Analytics 4 Measurement ID. Enter the Event Name which should be WeCreativez WhatsApp and then click on the pencil icon from Triggering.

      Now, click on the + icon from the Choose a trigger popup.

      Enter any name for the trigger like we entered WhatsApp Trigger and then click on the pencil button from the Trigger Configuration. 

      Now, select the Custom Event from the Choose trigger type popup.

      Now, Set the Event Name as WeCreativez WhatsApp, Trigger fire type as Some Custom Events.

      Select Event from the first dropdown, contains from the second dropdown, and enter WeCreativez WhatsApp into the third input box.

      Then click on the Save button to save the trigger.

      Click on the Save button again to save the Tag.

      Now, the Google Tag Manager event fires when the user/customer clicks on the send message button from the widget or when the user/customer clicks on the support person.

       

      It will take 24-48 hours to show the entries on your Google Analytics 4 events dashboard.

       

      For Developers:

      You can hook the custom Google Tag Manager event(s) with the WordPress WhatsApp Support message sent to trigger.

      jQuery( document.body ).on( 'wws_message_sent', function() {
          // Send dataLayer to GTM
          window.dataLayer.push( {
              'event': 'WeCreativez WhatsApp',
              'eventCategory': 'Category',
              'eventAction': 'Action',
              'eventLabel': 'Label'
          } );
      } );
  • How to

    • How to change pre-message text

      For Multiple Person Support:

      1: Click on WhatsApp Support from the admin menu.

      2: Now, click on the Manage Support Person(s) tab.

      3: Edit the support person you want to change the Support Pre Message.

      4: You can change the Pre Message from the Support Pre Message option.

      WordPress WhatsApp Support Pre-Mesage Settings

      • Use {title} placeholder to display the current page title in the chat.
      • Use {url} placeholder to display the current page URL in the chat.
      • Use {br} placeholder to break the line into a new line.

      5: Click on the "Save Changes" button to save the changes.

    • How to always widget pops up

      By default, WordPress WhatsApp Support pops up the widget only one time when user/customer open the website or re-open the website. 

      If you want to pops up the widget with every page load then copy the following snippet and paste it into the child theme's functions.php file.

      /**
       * WordPress WhatsApp Support always widget pops up.
       * 
       * @author WeCreativez
       * @link https://codecanyon.net/item/wordpress-whatsapp-support/20963962/
       * @support https://codecanyon.net/item/wordpress-whatsapp-support/20963962/support/
       */
      
      add_action( 'wp_enqueue_scripts', 'wws_snippet_always_widget_popup', 300 );
      
      function wws_snippet_always_widget_popup() {
      	wp_add_inline_script( 'wws-public-script', "sessionStorage.wwsAutoPopup = 'no'" );
      }
      
    • Open desktop app instead new tab

      By default, WordPress WhatsApp Support open WhatsApp on new tab on desktop. 

      If you want to open WhatsApp on WhatsApp desktop application then copy the following snippet and paste it into the child theme's functions.php file.

      /**
       * WordPress WhatsApp Support - Open desktop app instead new tab.
       * 
       * @author WeCreativez
       * @link https://codecanyon.net/item/wordpress-whatsapp-support/20963962/
       * @support https://codecanyon.net/item/wordpress-whatsapp-support/20963962/support/
       */
      add_filter( 'wws_whatsapp_desktop_api_url', 'wcz_wws_whatsapp_desktop_api_url', 20, 1 );
      
      function wcz_wws_whatsapp_desktop_api_url( $desktop_api_url ) {
          return 'https://api.whatsapp.com';
      }
    • Set different number by pages

      Using the WordPress WhatsApp Support plugin, you can set the different WhatsApp number on different pages. For example, Page Contact US can have WhatsApp number 1234567890 and page Sale Support can have WhatsApp number 9876543210.

      How to set different WhatsApp number on page or post:

      Step 1: Go to the edit page on which you want to change the WhatsApp number. Make sure you enabled the Single Person Layout from plugin settings.

      Step 2: Here you found the settings to change WhatsApp number for that particular page under the WordPress WhatsApp Support metabox.

      Step 3: Add the different WhatsApp number in Support Contact Number field. Here you also can change About Text, Per-defined message, Button text, etc...

      Step 4: Update the page or post.

      Now, the WhatsApp support number is different for that particular page.

      Note: Different WhatsApp numbers by posts and pages only support Single Person Layouts.
  • Other

  • Changelog

    VERSION 2.4.2

    • Tweak: Add wwsObj.whatsapp_web_api for wa.me redirection.
    • Dev: In troduce `wws_public_script_object` filter.
    • Remove: the ‘Enable jQuery’ option from the dev options.
    • Remove: dataLayer.push eventAction.

    VERSION 2.4.1

    • Fix: undefined function cal_days_in_month() issue on the analytics page.

    VERSION 2.4.0

    • Add: Multi Support Person schedule slots.
    • Improve: New way to adding & editing multiple support persons.
    • Tweak: Change the dataLayer event name.

    VERSION 2.3.3

    • Tweak: Add admin option to override product query button.

    VERSION 2.3.2

    • Fixed: PHP 8 warning with str_replace function.

    VERSION 2.3.1

    • Improved: Security and performance.
    • Fixed: Unknown bugs.

    VERSION 2.3.0

    • Added: Dokan Multivendor - Product Query button vendor support.
    • Added: Dokan Multivendor - Option to hide Product Query button if Store Level or Product Level number not set.

    VERSION 2.2.0

    • Added: Dokan Multivendor - Store level vendor support.
    • Added: Dokan Multivendor - Option to hide widget if Store Level or Product Level number not set.

    VERSION 2.1.2

    • Fixed: font-size and line-height issues.

    VERSION 2.1.1

    • Fixed: Admin image upload issues.

    VERSION 2.1.0

    • Improved: Security and performance.
    • Fully compatible with PHP 8

    VERSION 2.0.9

    • Added: Admin option to hide unavailable support person.
    • Removed: jQuery based admin setting tab switch.

    VERSION 2.0.8

    • Added: Option to change the support person availability text.

    VERSION 2.0.7

    • Improved: Security and performance.
    • Fixed: The layout 8 call icon does not remove the issue if the call field empty.

    VERSION 2.0.6

    • Added: Click to call for layout 8.
    • Improved: Template 8 layout and animations.
    • Fixed: missing and wrong text domains.
    • Removed: Language files, so the user can translate according to him.

    VERSION 2.0.5

    • Improved: Bug fixes.
    • Fixed: Current month chart data.
    • Fixed: Today click count value.

    VERSION 2.0.4

    • Improved: Security and performance.
    • Dev: Added wwsWidget.open() and wwsWidget.close() javascript triggers.

    VERSION 2.0.3

    • Updated: Third-party jQuery libraries.
    • Fixed: jQuery.browser is a deprecated notice in the console log.

    VERSION 2.0.2

    • More lightweight...
    • Dev: data attributes to generated buttons.
    • Fixed: The only icon trigger CSS issue.
    • Fixed: .map file error in console for admin.
    •  

    VERSION 2.0.1

    • Improved: Security and performance.
    • Fixed: Plugin activation page redirection.

    VERSION 2.0.0

    • Improved: Admin analytics page.
    • Improved: Plugin load time.
    • Added: Current month click analytics chart.
    • Added: Top 10 analytics. Like IP Address, Referral Links, Operating Systems, Browsers.
    • Added: "Quick Click Analytics" admin dashboard widget.
    • Removed: WOFF and TTF font and replaced with SVG icons.

    VERSION 1.9.9

    • Added: Dokan multivendor compatibility for single person support type.
    • Fixed: Auto popup issue.

    VERSION 1.9.8

    • Bugs and issues fix.
    • Performance and security improvements.

    VERSION 1.9.7

    • Added: Generated shortcode button analytics.
    • Added: WooCommerce query button analytics
    • Added: 'Through' column in analytics.
    • Security: AJAX check on analytics.
    • Fixed: Google & Facebook analytics.
    • Fixed: DataTable sorting images.
    • Fixed: Admin analytics table layout.
    • Fixed: Removed extra '/' slash from the file path. ( Thank you: KoolPal )
    • Fixed: Woo query button display issue while 'After add to cart' selected. ( Thank you: KoolPal )

    VERSION 1.9.6

    • Added: Single person support predefined text at page and post level.

    VERSION 1.9.5

    • Added: GA & FB analytic for layout 6 and 7.
    • Added: Better Custom CSS admin option.
    • Modified: Made layout 1 bit bigger and readable.
    • Modified: Made layout 2 bit bigger and readable.
    • Modified: Made layout 3 bit bigger and readable.
    • Modified: Trigger button layout to bigger.

    VERSION 1.9.4

    • Added: Single person support contact number at page and post level.
    • Added: About support message at page and post level.
    • Added: Trigger text at page and post level.
    • Updated: Plugin activation and update checker API.
    • Updated: Admin timepicker library.
    • Improved: Trigger button space between text and icon.
    • Improved: Admin multiperson add/edit view.

    VERSION 1.9.3

    • Dev: jQuery trigger when message sent successfully.

    VERSION 1.9.3

    • Performance and security improvements.
    • Dev: jQuery trigger when message sent successfully.

    VERSION 1.9.2

    • Added: No number mask option for admin.
    • Fixed: javascript issue, if mobile number mask empty.
    • Fixed: Product query {title} {url} tags issues.
    • Fixed: Layout 8, empty pre-message issue.

    VERSION 1.9.1

    • Added: Phone number mask to layout 6.
    • Fixed: Arial font dependency.
    • Fixed: PHP code error display on the product page.

    VERSION 1.9

    • Added: Multi support person randomize order option.
    • Performance and security improvements.

    VERSION 1.8.9

    • Added - Mobile number masking option.
    • Performance and security improvements.

    VERSION 1.8.8

    • Admin option tabs are not faster to navigate.
    • Increased performance

    VERSION 1.8.7

    • We rapidly improving our plugin by fixing the major and minor bugs. Please support us for the best.
    • We changed the plugin structure for better performance and security.

    VERSION 1.8.6

    • Fixed - Plugin activation and deactivation process.
    • Added - Hide widget by URL option for admin.

    VERSION 1.8.5

    • Added - Layout 8 - Multi Person Support layout with click to chat.
    • Added - Plugin automated update.

    VERSION 1.8.4

    • Added: Custom actions and hooks to make the plugin more customizable.
    • Added: Missing Custom CSS save option and escape outputs.

    VERSION 1.8.3

    • Security: Custom CSS output escape.

    VERSION 1.8.2

    • Added: Number validation on mobile number fields.
    • Added: More details to the layouts.
    • Fixed: Group invitation ID issue.
    • Fixed: Warning: count() Parameter must be an array or object that implements Countable…

    VERSION 1.8.1

    • Fixed: Layout 6 pre-defined message issue.
    • Fixed: Layout 6 UI issue.

    VERSION 1.8

    • Added: Layout 6 – WhatsApp and message field.
    • Added: QR code generator.
    • Fixed: UI issues.

    VERSION 1.7

    • Added: Brand new layout 7 with WhatsApp number field.
    • Added: More control on Facebook Pixel and Google Analytics.
    • Completely redesigned admin settings.
    • Performance and security improvements.
    • Added: Validation error animations.
    • Improved built-in analytics.
    • Added: Delete single or complete analytics.
    • Added: Admin option to move click button horizontal and vertical.
    • Added: Group invitation link generator.

    VERSION 1.6.5

    • Added: WPML dynamic string translation supported.
    • Added: Click tracking using Google analytics.
    • Added: Click tracking using Facebook Pixel.

    VERSION 1.6.4

    • Added: languages Arabic and Chinese.
    • Fixed: Admin tooltip alignment issue.
    • Added: Analytics deep report like Country, City, ZIP, Map, ISP and more.
    • Added: Export analytics in CSV.
    • Added: RTL Direction for languages like Arabic, Persian and Hebrew.
    • Removed: unnecessary filter by WordPress and WooCommerce from admin options.
    • Added: Enter key to send a message.

    VERSION 1.6

    • Increased performance and loading speed.
    • Clean Admin dashboard and beautiful help tooltip.
    • Added: Languages – German, Spanish(Spain), Hindi, Indonesian, Italian, Dutch, Portuguese (Brazil)
    • Added: Exclude product query button by products and categories.
    • Added: Predefined text admin option to append some tags like Page title and Page URL with user chat.
    • Added: WhatsApp Support Button generator via WPBakery.
    • Fixed: Layout 1, 2, and 6 center align issue.
    • Fixed: Non translate ready text to translate ready.

    VERSION 1.5.5

    • Added: Link Generator – Now you can generate WhatsApp Support link and share it with your users or clients.
    • Added: Filter by Exclude Page – You can select specific pages where you won’t want to display the support button.
    • Added: Show the only Icon on Phone – You can enable only trigger icon instead of text button on mobile devices.
    • Added: Referral in Analytics – Now you can see the referral or page the customer come from in analytics.

    VERSION 1.5.1

    • Fixed: Auto Popup Issue.