=== Plugin Name ===
Contributors: zgilyana
Tags: free live chat, chat, live chat, livechat, live chat software, live chat widget, widget, mobile live chat, live support, customer support, help desk, customer feedback, olark, snapengage, zopim, casengo, zendesk, clickdesk, user tracking, visitor, visitor tracker, visitor monitor, whos online
Requires at least: 2.7
Tested up to: 4.1
Stable tag: 1.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Live chat software with real-time visitor monitoring for your WordPress site! Live chat with your visitors using a clean and easy-to-use interface.

== Description ==

[Formilla.com Live Chat Software](http://www.Formilla.com/ "Formilla.com Live Chat Software") offers **FREE live chat and Premium services** for your WordPress site.  Allow your visitors to chat with you live if they have any questions or need support.

**Formilla.com Live Chat Features:**

* **Installs Instantly:** You can use the out-of-the-box Formilla Live Chat web interface to begin live chat immediately.  The live chat button will appear on your WordPress site upon installation/activation of this plugin.

* **Google Talk Support:** Formilla.com Live Chat software allows you to use your favorite live chat client as long as it works with Google Talk (e.g. Pidgin, Trillian, IMO, etc.).

* **Mobile Chat:** Respond to chats from your iPhone, Android, or any smart phone live chat client supporting Google Talk (gtalk).  Our Google Talk option allows for up to four concurrent chats per chat agent.

* **Real-time Visitor Monitoring ([demo](http://www.Formilla.com/#visitor-monitoring "demo")):** Formilla Live Chat real-time visitor monitoring/tracking allows you to see the number of active visitors on your website, and initiate live chats with them.  View each visitor's page URL, referring site, new user vs. returning, and more.  Formilla Live Chat visitor monitoring comes with any of our Premium account packages.

* **Language Support (International):** Our Language support option allows you to customize the text of the live chat buttons, chat forms, and offline email forms.  Our Premium packages allow you to customize your live chat widget in any language, including Spanish, French, Indonesian, Portuguese, Chinese, Hindi, Italian, and much more! 

* **Pro-active Chat:** Enable pro-active chat to trigger live chat automatically with a visitor after a defined number of seconds.

* **User/Agent is Typing a Message...:** Now you don't need to wonder if the person you're chatting with is even on the other end! Formilla.com Live Chat keeps visitors and agents informed if the User or Agent is typing a message. This improves usability and makes conversations more enjoyable.

* **Desktop Notifications:** Make sure you don't miss any chats by enabling Desktop Notifications to see an alert box displayed every time you receive a chat.  This feature currently works with Chrome, Firefox, and Safari.   

* **Custom Banners, Colors, and Themes:** Formilla.com Live Chat software Premium packages allow you to customize your chat widgets to match your site's look and feel. Change the color of the chat button/widget, chat message and font color, backgrounds, etc. Upload your own online and offline live chat images to use in your header, footer, etc. to encourage customers to live chat!

* **Attention Grabbers:** Formilla.com Live Chat offers the Use of an Attention Grabber to get the attention of your visitors! Upload a custom image with your picture or any other message you'd like to communicate. Get creative and use it for marketing promotions too!  

* **Advanced Customization:** Formilla.com Live Chat software gives you the ability to stretch the width and height of the live chat button, add an image such as your logo, and control the location down to the pixel! You get access to the CSS for the live chat button and attention grabber to make it look perfect!

* **Require Email Address:** Before visitors start a live chat, you can require them to supply their email address first. 

* **Chat Button Location:** Easily move the position of the "Chat with us" and "Email us" buttons and forms to the bottom left or right of your website with our customization options.

* **Multiple Chat Agents:** Our Premium packages allow you to add multiple chat agents to your Formilla.com Live Chat account to support incoming live chats from your customers.

* **Offline Email Form:** Formilla.com Live Chat software automatically displays as an 'Email us' button on your site when you're offline.  You can manage offline messages through the Formilla.com Customer Inbox or on the go by using your preferred email client.  The Customer Inbox comes with your live chat software account as a Help Desk solution for managing customer email, customer feedback, prioritization, and ticket management.

* **Help Desk:** The Customer Inbox help desk allows you to search your live chat history or offline emails by customer email address, priority, status (new, read, pending, complete), flagged vs. unflagged, and also assign an item to another user of your Formilla.com Live Chat account.    

* **Chat History:** Access your live chat history and offline emails as well via the Formilla.com Live Chat Customer Inbox help desk solution.   

* **Export Email Data:** Formilla.com Live Chat software allows you to export your customers' email addresses from the Customer Inbox help desk to construct email marketing campaigns via your preferred tool.

* **Forward Offline Email:** Using the Formilla.com Live Chat Customer Inbox help desk, forward offline email submissions from your customers to other departments or support staff.

* **Add Private Comments:** Formilla.com Live Chat gives you the ability to add private comments to any live chat historical record in your Customer Inbox help desk.

* **Visitor Technical Info:** Formilla.com Customer Inbox help desk includes the customer's technical details such as operating system, browser, screen resolution, etc.  

* **Custom Fields:** Pass in custom fields from your website to Formilla.com Live Chat for easier tracking such as account IDs, customer IDs, name, phone, and more.  Some of this data will appear in the Customer Inbox, and also within the visitor monitoring/tracking view as well.  

* Get started immediately with our free live chat package that comes with 15 days of premium services as well.


== Installation ==
Manual Instructions:

1. Download and **unzip the formilla-live-chat.zip** to your wordpress **`/wp-content/plugins/`** directory
2. **Activate** the plugin through the **'Plugins' menu** in WordPress
3. Choose the **Get Started** link from the plugins page or navigate to the **'Formilla Chat'** menu item that appears on your WordPress Admin upon activating the plugin to complete registration
4. **That's it!**  Once registered, your live chat widget is created instantly and is available on your site for customers to chat with you.

== Frequently Asked Questions ==

= How do I install Formilla.com Live Chat software to my WordPress site? =
Follow our [quick installation video](http://www.youtube.com/watch?v=3qodtXvmpdg "quick installation video") tutorial or the Installation tab of this page.


= How do I start a test chat after installing Formilla Live Chat on my WordPress site? =
Watch our [video tutorial](https://www.youtube.com/watch?v=Cwy1VnSp3EA "video tutorial") to learn how.


= What is the Formilla 'Chat ID' under the WordPress plugin settings? =
The Chat ID is the unique identifier for your particular live chat widget. Your live chat widget won't display on your WordPress website unless you have a Chat ID entered on the settings page.  You will receive this ID via email upon registering with Formilla.com via the **Formilla Chat** link on your WordPress admin panel.


= Can I specify my hours of operation or simply that I am unavailable to chat? =
Access your wordpress admin panel and select the **Formilla Chat** link to access your Formilla.com Live Chat account.  Upon logging in, navigate to your live chat widget's Advanced Options by selecting from the menu as follows: **Live Chat** **-->** **View Widgets** then select the edit icon of your widget and modify the hours of operation from the **Advanced Options** tab.


= Can I receive an email notification when my customers use the 'Email us' button while I'm offline from chat? = 
Yes, the Email Notifications option is enabled by default for every Formilla.com Live Chat widget you create. Removing the email address(es) on the Advanced Options tab of the live chat widget configuration page disables the feature. Alternatively, you may add additional email recipients by simply comma-separating each email address.  You can respond to emails using your preferred email client, or directly from the Formilla.com Customer Inbox help desk.


= I've followed all the instructions but I still appear offline and see the "Email us" button on my site. How do I go online and get the button to say "Chat with us"? =
If you're using the Live Chat web interface, it behaves just like any chat client; you must login to Formilla.com (the chat client) via your **WordPress Admin Panel --> Formilla Chat** menu item, or directly at Formilla.com in a new browser window. Once you've logged in and navigated to the **Live Chat --> Live Chat Now** page, you're considered online and ready to accept chats. If you log off, your button will go to offline mode and display "Email us". If you're using Google Talk instead of the live chat web interface, simply log into your preferred chat client for either service and Formilla.com will recognize you're online and display "Chat with us" after a few seconds.  


= How do I appear offline so that customers cannot chat with me during that time? =
If you are currently not available to chat, just sign out of your Formilla.com Live Chat account and you will not receive any live chats during this time.  We took a very simple approach to appearing online versus offline for live chat.  If you are using Google Talk via Formilla.com Live Chat instead, simply sign out of your preferred client and Formilla.com will automatically update your status.      


= Is there a way for me to deactivate my live chat WordPress button momentarily without removing the plugin? =
Yes.  Access your wordpress admin panel and select the **Formilla Chat** link to access your Formilla.com Live Chat account.  Upon logging in, navigate to your live chat widget's Advanced Options by selecting from the menu as follows: **Live Chat --> View Widgets** then select the edit icon of your widget and **uncheck** the **Active Widget** option on the **Widget Details** tab.  This will simply hide the live chat button from your wordpress site.  Once ready, just **check** the same box and save for the button to re-appear. 


= How do I configure Google Talk (gtalk/gchat) instead of using the Formilla.com Live Chat standard offering? =
Start with our [Google Talk setup](https://www.youtube.com/watch?v=rhL_WIOKa48 "Google Talk setup") video.  Setup Google Talk by accessing your Formilla.com Live Chat account and navigate to **Account Settings --> Manage Users** and select the edit icon for the appropriate account. Under the **Chat Client dropdown**, choose Gtalk and provide your **Chat User Name**. Upon saving, you can log into your Google Talk chat client and you'll notice multiple Formilla.com chat bot invitations. You will need to accept the chat invitations to start using your chat client with Formilla.com. Once you accept the invitations, your chat button should turn to "Chat with us" after a few moments. If you log off from your client, the button will automatically recognize you are no longer available and change to "Email us".


= Can I proactively initiate a live chat session with my customers? =
Yes.  Simply access your WordPress admin panel and select the **Formilla Chat** link to access your Formilla.com Live Chat account.  Upon logging in, navigate to your live chat widget's Advanced Option by selecting from the menu as follows: **Live Chat** **-->** **View Widgets** then select the edit icon of your widget and **check** the **'Enable Auto Display'** field to configure proactive live chat from the **Advanced Options** tab.


= Does Formilla Live Chat work with my mobile phone (e.g. iPhone, Android, etc.)? =
Yes.  We recommend using mobile chat clients (e.g. Trillian) for use with Google Talk to chat from your mobile phone on the go! For those using the live chat web interface, it is currently not optimized for chat from your mobile phone. We have plans on introducing mobile support in the near future. 


= How do I end a chat using my Google Talk client if the user does not end it? =
To end a live chat session, simply send ~end via your Google Talk chat client. It's important to end chats upon completion to ensure your chat queue can receive new chats as they may arrive at any time while you're online.


= Is Google Hangouts the same thing as Google Talk, and will it work with Formilla.com Live Chat software? =
Google Hangouts is different from Google Talk. Unfortunately Google Hangouts will not work via Formilla.com Live Chat. You can either revert back to Google Talk or use our alternative Live Chat web interface.  If you're using Google Talk and you're still not able to receive/send messages, please make sure you don't have the Hangouts plugin/extension installed in Chrome either, since it will conflict with Google Talk.


= Does the free live chat package allow me to use a smart phone to chat with my customers? =
Yes. Our free live chat package can be configured with any smart phone or tablet using Google Talk to send and receive chats.


= What happens when I choose the 'Request Chat' action from the visitor monitoring dashboard? =
Formilla Live Chat will pop-up the live chat window to the corresponding visitor of your web site after a few seconds or on the next page load.


= How does real-time visitor monitoring work? =
Check out our [real-time visitor monitoring](https://www.youtube.com/watch?v=XW3jgyGxyyc "real time visitor monitoring") video for a short tutorial of the functionality.

= Can I modify the message displayed to my website visitors when I request a chat with them via the visitor monitoring page? =
Yes.  Start by logging in to your Formilla Live Chat account and navigate to the Advanced Options tab of your live chat widget's settings.  You can then modify the 'Request Chat Text' from the current default message and save the changes.  


= Is real time visitor monitoring only available to Premium accounts? =
Yes.  Currently the real time visitor monitoring/tracking feature of Formilla Live Chat is a Premium Solo or Premium account offering only. 


= Do I need to refresh the visitor monitoring page to show me the latest status of visitors/users on my web site? =
No.  You will see the data automatically refresh the user information every few seconds to show you the latest visitors on your web site, what page they're currently on, how long the user has been on your web site, whether they are new or returning, and more. 


= How does the 30 chats/emails limit on the standard free live chat package work? =
At the 1st of every month, the total count of chats/emails is set to 0 for all standard free live chat customers.  Each chat conversation counts as 1 chat, as does every offline email submission you receive.  Formilla.com will send you an email once you reach 20 or more chats in a month, and another email once you've reached 30.  


= Does the Customer Inbox Help Desk come with the standard free live chat package? =
Yes.  Our standard free live chat customers can enjoy the Help Desk feature absolutely free!  You can read and respond to offline emails, view chat history, add private notes to chat conversations or emails, search, and more!


= Can I enable the desktop notifications feature with the standard free live chat package? =
Yes.  The desktop notifications feature works with the standard free live chat or premium package and can be enabled from within your Formilla.com account, under Account Settings.  Desktop notifications work with Firefox, Chrome, and Safari at this time.  

== Screenshots ==

1. The Formilla Live Chat Dashboard where you can monitor your website visitors in real-time and initiate or respond to live chats.
2. The live chat widget installed on your WordPress site upon activation of Formilla.com Live Chat plugin.
3. From left to right: Our Email us button and form in English; a customized version of the Email us button and form in Spanish
4. Configure options for your chat widget such as proactive chat, hours of operation, and email notifications. 
5. Formilla.com Live Chat admin panel where the creativity begins :)
6. From left to right: Our original live chat button and form; a customized version of the chat button and form.
7. From left to right: Our original Email us button and form; a customized version of the Email us button and form.
8. Formilla.com Live Chat admin panel to select language and customize text
9. From left to right: Our original Live Chat button and form in English; a customized version of the chat button and form in Spanish
10. The Formilla Live Chat Customer Inbox help desk. View chat history, search and respond to offline email submissions, etc.

== Changelog ==

= 1.1 =
Due to WordPress guidelines, we've modified our plugin to launch Formilla outside of the WordPress admin panel. 

= 1.0.2 =
Officially WP 3.8 compliant. Fixed minor bug, updated readme text as well. 

= 1.0.1 =
Updated readme.txt to add more FAQ, installation video tutorial, new screenshots.  No other changes.

= 1.0 =
* Initial release