=== Click to Chat ===
Requires at least: 4.6
Tested up to: 6.1.1
Requires PHP: 5.6
Contributors: holithemes
Stable tag: 3.23
Tags: whatsapp, whatsapp business, click to chat, whatsapp chat, whatsapp support, whatsapp group, click to chat for whatsapp, WhatsApp WooCommerce, whatsapp wordpress, whatsapp floating button, chat, holithemes
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WhatsApp Chat🔥. Let's make your Web page visitors Contact you through "WhatsApp", "WhatsApp Business"

== Description ==

WhatsApp Chat🔥. Let's make your Web page visitors Contact you through "WhatsApp" or "WhatsApp Business" with a single Click (WhatsApp Chat, Group, Share)

[Demo](https://holithemes.com/plugins/click-to-chat/list-of-styles/)  |  [Documentation](https://holithemes.com/plugins/click-to-chat/)  |  [Support](https://holithemes.com/plugins/click-to-chat/support/)

== WhatsApp Chat ==

Add 'WhatsApp' or 'WhatsApp Business' Number and let your website visitors contact you with a single click.

**📱 Mobile:**  Navigate to WhatsApp Mobile App.

**💻 Desktop:** Navigate to the WhatsApp Desktop App or Web WhatsApp page (web.whatsapp.com)


== 💎 Styles ==

Select a Style that matches your Website's design.

* 8 pre-defined customizable styles/designs
* Add your own Image/GIF
* Custom Element/Design (convert any element to a WhatsApp Chat element)
* Shortcodes (Add WhatsApp button/icon with inline the content)
* Different Styles, Positions for Mobile, Desktop
* Choose a style and customize it to match the website's design

[list of Styles](https://holithemes.com/plugins/click-to-chat/list-of-styles/)  |  ✏️[Customize Styles](https://holithemes.com/plugins/click-to-chat/customize-styles/)


= 💡 Add Own Image =

Instead of selecting a pre-defined style, add any Image/Animated-image/GIF.

== 🌈 Custom Element == 

Convert any Element as a WhatsApp Chat Element by adding  

* Class/ID name: 'ctc_chat' (or)
* Href/link: '#ctc_chat'

The custom design element will navigate to WhatsApp based on plugin settings (WhatsApp Number, pre-filled message, Analytics, .... ). 
(e.g. menu item, button, image, link - just add ctc_chat as a class name)

[Custom Element](https://holithemes.com/plugins/click-to-chat/custom-element/)

== 👑 Greetings Dialog ==

Encourage user engagement by displaying the perfect message at the perfect time

* [Greetings-1](https://holithemes.com/plugins/click-to-chat/greetings-1/): Customizable Design
* [Greetings-2](https://holithemes.com/plugins/click-to-chat/greetings-2/): Content Specific Design
* [Greetings-Form](https://holithemes.com/plugins/click-to-chat/greetings-form/): Form Filling before initializing the chat [PRO]
* [Multi-Agent](https://holithemes.com/plugins/click-to-chat/multi-agent): Displays multiple WhatsApp accounts with different time ranges [PRO]

= ⌛ Greetings Actions =

* **Click**: Displays Greetings when clicked on any element with the Class name: 'ctc_greetings'
* **ViewPort**: Displays Greetings When an element is in/reached viewport(25% margin) with the Class name: 'ctc_greetings_now' [PRO]
* **Time, Scroll** Display Greetings based on time, scroll [PRO]

[Actions](https://holithemes.com/plugins/click-to-chat/greetings-actions/)

== ✳️ Position to Place == 

* Add WhatsApp at any position of the screen  
    (not limited to fixed positions).
* Different positions for Mobile and Desktop.  
     
== ⏩ Pre-filled Message ==

Text that appears in the WhatsApp chat window when the user clicks on the WhatsApp. 

Users can easily start the conversation.

Variables to change values dynamically  

* **{site}** -> Website Title
* **{title}** -> Page Title
* **{url}** -> Web page URL
* **[url]** -> Web page full URL including query parameters

With these variables, we can understand from which page the user started WhatsApp chat.
 
[Pre-filled Message](https://holithemes.com/plugins/click-to-chat/pre-filled-message/)

== 🎁 WooCommerce ==

= Overwrite Settings =

Separate settings for WooCommerce Single product pages

* Pre-filled Message
* Call to Action
* Greetings Template, Content [PRO]

Additional variables, specific to WooCommerce single product page to change values dynamically   

* **{product}** -> Product Name
* **{price}** -> Product Price (current price)
* **{regular_price}** -> Regular product price (without any sale)
* **{sku}** -> Stock keeping unit

For Shop, Cart, Checkout, and Account pages we can overwrite at page level settings

= Add WhatsApp - Single Product Pages = 

* Before Main Content
* Before Product
* Before Product Summary
* Product Summary
* Before Add to Cart Form
* Before Cart Button
* After Cart Button
* After Add to Cart Form
* After Product
* After product summary

[Add WhatsApp Icon/Button in WooCommerce Product pages](https://holithemes.com/plugins/click-to-chat/add-whatsapp-in-woocommerce-single-product-pages/)

= 💰 Add WhatsApp - Shop Page =

Add WhatsApp to WooCommerce Products list (shop page, related products list)

[Shop page](https://holithemes.com/plugins/click-to-chat/whatsapp-chat-in-woocommerce-shop-page/)

= 📒 Page Level Settings =

At the page level, we can overwrite the settings for each post. We can add a different Whatsapp Number, Prefilled Message, Call to Action for each post
(while editing the post, in the right sidebar 'Click to Chat' meta box)

* WhatsApp Number
* Call to Action
* Pre-filled Message
* Display Settings

PRO:

* Styles
* Time Delay
* Scroll Delay
* Greetings Template
* Greetings Header, Main, Bottom Content

[Page-level settings](https://holithemes.com/plugins/click-to-chat/change-values-at-page-level/)

== 📈 Analytics ==

Creates an Event when the user clicks on the WhatsApp Icon/button.

[Google Analytics](https://holithemes.com/plugins/click-to-chat/google-analytics/)

[Facebook Pixel](https://holithemes.com/plugins/click-to-chat/facebook-pixel/)

[Google Ads Conversations](https://holithemes.com/plugins/click-to-chat/google-ads-conversion/)

== Webhooks ==

Connect other applications using Integrate, Automation tools like Zapier, IFTTT, Pipedream, etc.

[Webhooks](https://holithemes.com/plugins/click-to-chat/webhooks)

== ⭐ PRO ==

* Random Numbers
* Business hours: Offline/Online Settings
    * Change WhatsApp number When Offline
    * Change call to Action When Offline
    or 
    * Hide When Offline
    * Show/Hide on selected time range in a day
    * Show/Hide on selected days in a week
* Webhooks - Dynamic variables
    * {url} - replace with current page URL
    * {time} - time the user interacted with WhatsApp Button/Icon
    * {number} - WhatsApp Number for that icon/button
* Greetings
    * Greetings From filling before initiating the chat
    * Actions: Display/reappear based on Time, Page Scroll, Click, ViewPort(When an element is in/reached ViewPort)
* Position to place
    * Fixed: Fixed position on the screen (default position)
    * Absolute: Fixed position to the body content. (Moves as the user scrolls the page)
* Time Delay - Displays WhatsApp after some time delay
* Scroll Action - Displays WhatsApp after user scrolls the page by a given percentage
* Display based on Website visitor's login status
* Page-level settings - Change styles, time delay, scroll delay, Greetings Template, and Greetings Content
* WooCommerce
    * Overwrite greetings template, Content for Single product pages.
    * Overwrite settings for Shop, Checkout, and Account pages at page-level settings
* Multi-Agent: Displays multiple WhatsApp chat accounts [NEW]
    * Set Multiple time ranges for each agent
    * Hide or Display agent with the next available time

🔆 [PRO](https://holithemes.com/plugins/click-to-chat/pricing/)

== 🎯 Localization ==

Click to Chat is Compatible with translation plugins. [WPML](https://wpml.org/), Polylang.

It is easy to set up different values for each language   

* WhatsApp Number
* Call to Action
* Pre-filled Message
* Greetings Content
* Group ID
* Share Text

Setup for [WPML](https://holithemes.com/plugins/click-to-chat/translate-click-to-chat-settings-using-wpml-plugin/), [Polylang](https://holithemes.com/plugins/click-to-chat/translate-click-to-chat-settings-using-polylang-plugin/)

== 🚀 Performance ==

* Rich in features, but the site’s front end is very lightweight.

We highly concentrate on speed and performance.

== 👓 Display Settings == 

Show/Hide styles based on 

* Post type
* Post Id
* Category name
* Device Type(Mobile, Desktop)
* WooCommerce single product pages

PRO:

* Time delay
* Scroll delay
* Selected time range in a day
* Selected Days in a week
* Website visitor login status

== ✅ Opt-in ==

Make the website users opt-in / accept consent before initiating the chat.

[Opt-in](https://holithemes.com/plugins/click-to-chat/opt-in/)

== ⛳ Shortcodes ==

Use shortcodes to instert a WhatsApp icon or button with inline the Post content, widget area.

change the default setting values using shortcode attributes - WhatsApp Number, Style, Pre-filled message, Call to Action.

= Chat Shortcodes =

[ht-ctc-chat]

To change the WhatsApp number use the 'number' attribute

[ht-ctc-chat number=915123456789]

[Shortcodes for Chat](https://holithemes.com/plugins/click-to-chat/shortcodes-chat/)

= Group =

Enable the Group chat feature and add WhatsApp Group id in the plugin settings.

Make it easy for your customers to join Whatsapp Group.

[Group](https://holithemes.com/plugins/click-to-chat/group-chat-feature/)

= Share =

Let users share your website with their WhatsApp contacts and get more leads.

[Share](https://holithemes.com/plugins/click-to-chat/share-feature/)

= 🌏 Help Translate The Plugin =

Help by [Translating the plugin](https://translate.wordpress.org/projects/wp-plugins/click-to-chat-for-whatsapp/) to be available in more languages  


== screenshots ==

1. 8 Styles, 1 Add own image / GIF Style
1. Chat Settings - Enter WhatsApp Number, prefilled message, call to action, desktop: web view / desktop app view
1. Style, position to place (at any position of the screen) - Desktop, Mobile
1. Add WhatsApp Menu item (Custom Element)
1. Change Values at the page level: 'WhatsApp Number', 'Call to action', 'Group ID'
1. Shortcodes - add style with inline the content
1. Style - 5 - Image with content box
1. Style - 8 - Materialize button
1. Style - 99 - Add your own Image / GIF(Animated Image)
1. Customize Styles
1. Enable Group, Share Settings
1. Group settings page
1. Share settings page
1. Display settings
1. Webhooks
1. prefilled, call to action for WooCommerce single product pages
1. Animations
1. Analytics - Google Analytics, Facebook Pixel, Google Ads Conversations


== Installation ==

= From Dashboard ( WordPress admin ) =
* plugins -> Add New
* search for 'click to chat'
* click on Install Now and then Activate.

= using FTP or similar =
* Unzip "Click-to-Chat" file and 
* Upload "Click-to-Chat" folder to the "/wp-content/plugins/" directory.
* Activate the plugin through the "Plugins" menu in WordPress.

== Frequently Asked Questions ==

= WhatsApp Number = 

Enter the WhatsApp number with country code 

E.g.
country code +1
number: 6123456789
** WhatsApp number: 16123456789 **

[https://holithemes.com/plugins/click-to-chat/whatsapp-number/](WhatsApp Number)


= Pre-filled Message =

Makes the users start the conversation easily.

Add variables to change values dynamically  
`
{url} -> Web page URL
{title} -> Page Title
{site} -> Website Title
`

E.g.

    Hi {site}!!
    Name: 
    I like to know more information about this {title}, {url}.

Additional variables for WooCommerce single product pages  
```
{product} -> Product Name
{price} -> Product Price (current price might be the sale price/regular price)
{regular_price} -> Regular product price (with out any sale)
{sku} ->Stock keeping unit
```

E.g.

    Hi {site}!!
    Name: 
    I like to buy this {product}, {url}


With this prefilled text, we can know from which page the user started the conversation, the purpose of the contact, and their details

= Call to Action =

Text that appears along with the icon/button.

E.g.

`WhatsApp us`

For WooCommerce single product pages
E.g.

`Chat to buy, only {sku} stock left`

= Select Styles =

Select styles based on Device.
* Style for Desktop
* Style for Mobile

**For selecting styles: plugin detects the device(mobile, desktop) based on HTTP User Agent (using wp_is_mobile)**

Styles are customizable according to website theme.

= Position to place the styles =

Add Styles at any position of the screen (not just fixed to selected positions). 

*Position to place* settings

E.g.  

> bottom-right corner:
bottom: 10px
right: 10px

> Center of the Screen (bottom-center)
bottom: 10px 
right: 50%

> Center of the Screen (left-center)
bottom: 50%
right: 10px

Plugin supports all CSS units as the suffix. (px, %, rem,...)

[position to place](https://holithemes.com/plugins/click-to-chat/position-to-place/)

= Localization - WPML, Polylang =

From WPML, Polylang Settings -> 'String Translations' and filter strings to 'Click to chat for WhatsApp' and change value based on language.

* User Input (Plugin Settings values): - 'Click to chat for WhatsApp'  
* Admin strings (Plugin Settings) - text domain: 'click-to-chat-for-whatsapp'

> Help plugin by [Translating Setting page, Readme text](https://translate.wordpress.org/projects/wp-plugins/click-to-chat-for-whatsapp/)

= Shortcodes Attributes =

Shortcodes by default get values from the plugin settings page. Override these values using attributes.

- number
- call_to_action
- pre_filled
- style

E.g.

    [ht-ctc-chat number=915123456789]

[Shortcodes for Chat](https://holithemes.com/plugins/click-to-chat/shortcodes-chat/)

= GDPR = 

"Click to Chat" don't collect any of the user data and don't use cookies.

= Opt-in =

User consent before starting the chat.

Opt-in[https://holithemes.com/plugins/click-to-chat/opt-in/]

= Show/Hide on Selected pages/devices = 

[Show only on selected pages](https://holithemes.com/plugins/click-to-chat/show-only-on-selected-pages/)

[Hide only on selected pages](https://holithemes.com/plugins/click-to-chat/hide-only-on-selected-pages/)

[Show/Hide on Mobile/Desktop](https://holithemes.com/plugins/click-to-chat/show-hide-on-mobile-desktop/)

= WhatsApp Group Invite/chat = 

[Enable Group Feature](https://holithemes.com/plugins/click-to-chat/enable-group-feature/) Add [WhatsApp group id](https://holithemes.com/plugins/click-to-chat/find-whatsapp-group-id/) at plugin settings page. and let user join in WhatsApp Group.

= WhatsApp Share =

[Enable Share feature](https://holithemes.com/plugins/click-to-chat/enable-share-feature/) and let users share your website easily.

Add variables to change values dynamically  
    {url} -> Web page URL
    {title} -> Page Title
    {site} -> Website Title

Share Text - E.g.

> Checkout this Awesome page {title}, {url}

= AMP Compatibility =

Click to Chat is Compatible with (AMP)[https://wordpress.org/plugins/amp/] plugin. AMP won't load plugins JavaScript files so limited functionality available.

= 🔧 Basic Troubleshooting = 

* Clear cache
    * from Cache plugins
    * Server side cache (some hosting providers adds cache functionality by default)
    * CDN cache (Cache invalidation)
* Check Display settings
* (page level settings)[https://holithemes.com/plugins/click-to-chat/change-values-at-page-level/]

✍️ For any queries, please contact us.

= ❤️ Support / Contact =

For any issues with the plugin / suggestions: 

* 📧 [ctc@holithemes.com](mailto:ctc@holithemes.com) 

* [WhatsApp](http://api.whatsapp.com/send?phone=919494429789&text=Hi%20HoliThemes,%20I%20have%20a%20question:)  

* WordPress [new topic](https://wordpress.org/support/plugin/click-to-chat-for-whatsapp/) 

= ⭐️ Give Support =

If you like the plugin, support the developers by giving [5 star rating](https://wordpress.org/support/plugin/click-to-chat-for-whatsapp/reviews/#new-post)  

Thank you so much in advance from "Click to Chat" Team

== Upgrade Notice ==

= using FTP or similar =
* Delete Click-to-Chat folder - your setting will not lost.
* unzip Click-to-Chat file and 
* Upload "Click-to-Chat" folder to the "/wp-content/plugins/" directory.
* Activate the plugin through the "Plugins" menu in WordPress.

= From Dashboard ( WordPress admin ) =
* When a new version is released - we can see the 'update now' link at wp-admin -> plugins
* click on 'update now'
or
* since WordPress 5.5, If auto update for the plugin is enabled, the plugin will update automatically when a new version is released

After Activating the plugin, add a WhatsApp Number in the plugin settings.

== Changelog ==

= 3.23 =
* URL Structure(web WhatsApp) is moved to 'Click to Chat' main settings page
* Fix: style 3 shortcode image height and width both not added.
* Fix: number not saving. conflict issue.

= 3.22 =
* Webhook data can share in JSON or String (stringify JSON) format

= 3.21 =
* Hide Chat widget While editing the page using page builders
* Fix: intlinput function not defined.

= 3.20 =
* Enhancement: AMP Compatibility

= 3.19 =
* Enhancement: Greetings
* Fix: prefilled message if % sign is added
* Fix: themes styles conflict with svg images

= 3.18.1 =
* Enhancement: Shortcodes

= 3.18 = 
* Enhancement: [Greetings Actions](https://holithemes.com/plugins/click-to-chat/greetings-actions/)
    * Add class name 'ctc_greetings' or 'ctc_greetings_now' to any element to display greetings dialog on click.
    * PRO: Add class name 'ctc_greetings_now' to any element to display greetings dialog when element reached viewport. 
    
= 3.17.1 = 
* Fix: TypeError

= 3.17 = 
* Fix: TypeError

= 3.16 = 
* Enhancement: Shortcodes
* PRO: Greetings [Multi Agent](https://holithemes.com/plugins/click-to-chat/multi-agent)

= 3.15 = 
* Fix: Style-7 Extend - shortcode - fontsize settings
* Fix: prefilled message with special characters

= 3.14 = 
* Enhancement: Sortable items with handler
* Analytics count - track all clicks or one click per session

= 3.13 =
* Fix: svg icon not displaying properly while using some cache plugins

= 3.12.2 =
* Enhancement: Greetings settings
* WhatsApp popup window width updated to display qr code in initial viewport

= 3.12.1 =
* WhatsApp popup window dimensions adjusted for better appearance
* Enhancement: compatibility with amp plugin

= 3.12 =
* New: URL Open Target window - New, Same, popup.
* URL structure for desktop: wa.me, web.whatsapp
* URL structure for mobile: wa.me, WhatsApp://
* Web WhatsApp settings moved to other settings page with Enhancements.

= 3.11 =
* Enhancement: added hooks for developers to create Extenstions
* Updated Admin settings page content

= 3.10 =
* More position to Add WhatsApp at WooCommerce Single product pages

= 3.9.11 =
* Fix: compatibility issues

= 3.9.10 =
* Fix: uncaught error at Greetings page

= 3.9.9 =
* Enhancement: opt-in, greetings features

= 3.9.8 =
* Enhancement: Admin Greetings page

= 3.9.7 =
* New: opt-in - user consent before initiate the chat
* Enhancement: Greetings Text Editor, can add background color to text.

= 3.9.6 =
* Enhancement: click to chat admin page for WooCommerce

= 3.9.5 =
* Fix: display settings for custom post types

= 3.9.4 =
* Enhancement: Webhooks, greetings, admin interface.

= 3.9.3 =
* Enhancement: Greetings feature
* Open Greetings dialog: 
    * Click on any element which contains Class /Id name: 'ctc_greetings'
    * When an element is in viewport(25% margin) which contains Class name: 'ctc_greetings_now' [PRO]

[changelog](https://holithemes.com/plugins/click-to-chat/changelog/)