=== Easy Chat Support - Capripio ===
Contributors: capripio
Tags: live chat, chat widget, wordpress chat, customer support, website chat
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a fast, lightweight live chat widget to your WordPress site. No third-party service, no signup, and no API keys required.

== Description ==

**Easy Chat Support - Capripio** is a simple live chat plugin for WordPress. Add a live chat widget to your website and reply to visitors from your WordPress dashboard.

### No Third-Party Service Required

Unlike many live chat plugins, **Easy Chat Support - Capripio** runs entirely on your own WordPress website.

* No third-party chat service
* No account or signup required
* No API keys
* No monthly subscription
* No visitor data sent to another company
* Install, activate, and start chatting in minutes

Your visitors chat directly with you, and you reply from your WordPress dashboard. Everything stays on your own website.

### Live Chat Widget

* Lightweight live chat widget
* Works on desktop and mobile
* Unlimited visitors
* Unlimited conversations
* Unlimited messages
* Choose your widget color
* Display the widget in the bottom-left or bottom-right corner
* Welcome message
* Offline message
* Set your business hours

### Dashboard Inbox

* Reply from your WordPress dashboard
* Real-time messaging
* Search conversations by visitor name or email
* Load older conversations as far back as you need
* Close conversations when finished

### Email Notifications

* Get an email when a visitor sends a new message

### Chat History That Sticks

* Visitors who leave and come back later pick up their conversation where they left off
* Logged-in users (for example WooCommerce customers) see the same conversation on any browser or device
* Name and email are pre-filled for logged-in users
* Works with page caching: the widget refreshes its security token automatically

### Message Retention

* Automatically delete conversations that have had no activity for a set number of days
* Active conversations are never deleted, however long ago they started
* Delete conversations manually with one click
* Choose how long to keep chat history

### Fast and Lightweight

Easy Chat Support - Capripio is built for speed.

* Loads only a small script and stylesheet
* Checks for new messages only while the chat window is open
* No unnecessary background processes

### Upgrade to Pro

"Easy Chat Support Pro - Capripio" adds powerful features for growing teams.

* Multiple support agents
* Conversation assignment
* Canned replies
* Internal notes
* Tags
* File uploads
* Typing indicators
* Read receipts
* Visitor details (browser, device, and country)
* Company logo
* Dark mode
* CSV export

Learn more:
https://capripio.com/capripio-easy-chat-support

== Installation ==

1. Upload the plugin to `/wp-content/plugins/capripio-easy-chat-support`, or install it from **Plugins → Add New**.
2. Activate the plugin.
3. Go to **Chat Support → Settings**.
4. Choose your widget color, position, welcome message, and business hours.
5. Your live chat widget is ready. New messages will appear in **Chat Support → Inbox**.

== Frequently Asked Questions ==

= Do I need a third-party service? =

No. Everything runs on your own WordPress website. You do not need to create an account, sign up for another service, or use API keys.

= Does this slow down my website? =

No. The plugin is lightweight. It loads a small script and stylesheet and checks for new messages only while the chat window is open.

= Can I customize the chat widget? =

Yes. You can choose your widget color, position, welcome message, offline message, and business hours.

= Can I keep or delete old messages? =

Yes. Keep your chat history forever (the default), or turn on **Settings → Retention** to automatically delete conversations that have had no new messages for a set number of days. The count starts from a conversation's last activity, not from when it began, so ongoing chats are never removed.

= Will visitors lose their chat if they leave my website? =

No. A visitor's conversation is remembered in their browser, so when they come back they see the full history and can keep chatting. If they are logged in to your site, the conversation is linked to their account instead, so it also follows them to other browsers and devices. A guest who switches device or clears their browser data starts a new chat, but the old conversation stays in your Inbox.

= Does it work with page caching plugins? =

Yes. If a cached page contains an expired security token, the widget fetches a fresh one automatically instead of losing the visitor's conversation.

= Is there a Pro version? =

Yes. "Easy Chat Support Pro - Capripio" includes multiple agents, canned replies, file uploads, internal notes, visitor details, and more.

= Will it work with my theme? =

Yes. The chat widget is a floating element that works independently of your theme, so it works with most WordPress themes.


== Screenshots ==

1. The lightweight live chat widget visitors see on your website.
2. The built-in inbox where you manage and reply to conversations from your WordPress dashboard.
3. The settings page for customizing your chat widget, notifications, branding, and message retention.
4. The optional pre-chat form for collecting visitor details before a chat begins.

== Changelog ==

= 1.1.0 =
* New: Logged-in users' conversations are linked to their account and follow them across browsers and devices. The Inbox shows which registered user started a chat.
* New: The pre-chat form is pre-filled with a logged-in user's name and email.
* New: Message retention now counts days from a conversation's last activity instead of when it started, so active conversations are never deleted.
* Fix: Returning visitors could lose their chat history after a temporary network or server error. Only a conversation that was actually deleted is now forgotten.
* Fix: Chats no longer reset when a page cache serves an expired security token; the widget fetches a fresh one and retries.
* Fix: Logged-in visitors could not start or continue a chat because their requests were rejected as invalid.
* New: Search the Inbox by visitor name or email, and load older conversations with "Load more" (the Inbox previously showed only the 20 most recent).
* New: Delete a single conversation from the Inbox.
* New: Links in notification emails now open the conversation directly.
* New: Basic protection against spam: limits on how fast new chats and messages can be sent, and at most one notification email per conversation every few minutes.
* Fix: Messages containing "&", "<" or ">" were saved incorrectly (e.g. "Tom & Jerry" showed as "Tom &amp; Jerry", and "I <3 it" became "I").
* Fix: The widget no longer checks for new messages while the chat window is closed, and loads nothing until a visitor first opens it.
* Fix: Double-clicking "Start chat" could create two conversations.
* Fix: In the Inbox, switching conversations could briefly show messages from the previous conversation, and a reply could occasionally appear twice.
* Fix: A message that fails to send is now marked "Not sent" in the widget instead of looking delivered.
* Pro: Files sent by an agent are now shown to the visitor, and every file appears once, in its place in the conversation.
* Pro: Deleting a conversation (manually or through retention) now also deletes its uploaded files, notes, tags and assignment. Uninstalling with "delete all data" removes uploaded files and the agent capability too.
* Pro: Desktop and sound notifications no longer fire for your own replies or when you close a conversation.
* Pro: Administrators are shown as always having agent access on the Agents page, instead of a toggle that did nothing.
* Pro: Deleting all canned replies no longer brings the defaults back.
* Pro: An admin chatting through the front-end widget is now treated as the visitor, not the agent, for typing, read receipts and uploads.
* Pro: Visitor file uploads are rate limited.

= 1.0.4 =
* Update: Freemius SDK to 2.13.5 as security patch.

= 1.0.3 =

* Fix: A conversation or message that failed to save no longer reports success back to the visitor.
* Fix: New conversations now correctly show as "New" in the Inbox until an agent replies, instead of always showing as "Open".
* Fix: Scheduled message retention cleanup now uses the site's configured time zone, so conversations are no longer deleted a day early or late.

= 1.0.1 =

* Security: Verify visitor ownership before allowing access to conversations or sending messages.

= 1.0.0 =

* Initial release.

== Upgrade Notice ==

= 1.1.0 =
Visitors no longer lose their chat history, logged-in users keep their conversation across devices, retention only deletes inactive conversations, and the Inbox gains search, "Load more" and delete. Also fixes messages containing "&" or "<" being saved incorrectly.


= 1.0.4 =
* Update: Freemius SDK to 2.13.5 as security patch.

= 1.0.3 =

Bug fix update: message-save failures are now reported correctly, the Inbox "New" count works again, and retention cleanup respects your site's time zone.

= 1.0.1 =

Security update. All users should upgrade.