=== DITS Easy Callback Button ===
Contributors: ditsagency
Donate link: https://dits.agency
Tags: callback, contact, phone, request, modal
Requires at least: 5.2
Tested up to: 6.9
Stable tag: 1.1.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A simple floating callback button and modal form to request a call back from your clients.

== Description ==
DITS Easy Callback Button adds a floating button that allows site visitors to request a callback easily.
This plugin is translation-ready.

== Installation ==
1. Upload `dits-easy-callback-button` to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Configure the options in the admin panel.

== Third-party Resources ==

* Resource Name: Phone Icon (phone.svg)
  License: GPLv2 or later
  License URI: https://www.gnu.org/licenses/gpl-2.0.html

* Resource Name: Telegram Icon (telegram.svg)
  License: GPLv2 or later
  License URI: https://www.gnu.org/licenses/gpl-2.0.html

* Resource Name: Viber Icon (viber.svg)
  License: GPLv2 or later
  License URI: https://www.gnu.org/licenses/gpl-2.0.html

* Resource Name: WhatsApp Icon (whatsapp.svg)
  License: GPLv2 or later
  License URI: https://www.gnu.org/licenses/gpl-2.0.html

* Resource Name: IMask.js
  License: MIT
  License URI: https://github.com/uNmAnNeR/imaskjs
  Source: https://imask.js.org/

* Resource Name: MicroModal (micromodal.min.js)
  License: MIT
  License URI: https://opensource.org/licenses/MIT
  Source: https://github.com/ghosh/Micromodal

== External Services ==

This plugin provides an option to contact via WhatsApp.

When enabled, the plugin generates a link to the WhatsApp API service
(https://api.whatsapp.com/send).

Data sent:
- Phone number configured by the site administrator

Data is sent only when a visitor clicks the WhatsApp button.

This service is provided by WhatsApp (Meta):
Terms of Service: https://www.whatsapp.com/legal/terms-of-service
Privacy Policy: https://www.whatsapp.com/legal/privacy-policy

* AJAX callback request

This plugin handles callback requests via an AJAX POST request to the WordPress backend.

Data sent:
- Phone number entered by the visitor

This data is used only to send an email to the site administrator(s) with the request details.
No data is shared with third parties outside of the configured email recipients.


== Development ==

This plugin uses npm and Gulp with Rollup to bundle JavaScript assets.

The following third-party libraries are bundled into the production files:
- imask (https://github.com/uNmAnNeR/imaskjs)
- micromodal (https://micromodal.vercel.app)

Source files are located in:
- src/js/
- src/icons/
- src/css/

To build assets:
1. npm install
2. gulp build

== Licenses ==

This plugin bundles the following third-party libraries:

- imask – MIT License
- micromodal – MIT License

All bundled libraries are compatible with GPL-2.0-or-later.


== Frequently Asked Questions ==
= Can I change the button color? =
Yes, use the color pickers in the plugin settings.

= Can I send callback requests to multiple email addresses? =
Yes. In the plugin settings, you can enter multiple recipient email addresses separated by commas.
For example: admin@example.com, support@example.com, manager@example.com

== Changelog ==

= 1.1.0 =
* FEATURE: Added a default phone input mask that is automatically applied if no custom mask is configured.
* IMPROVEMENT: Added informational helper text explaining that the default mask will be used when no custom mask is set.
* IMPROVEMENT: Minor UI and design adjustments for improved visual consistency.
* FIX: Fixed an issue where the modal window did not close correctly in some cases.

= 1.0.1 =
* FEATURE: Added developer hooks (actions and filters) to allow logging of callback requests.
* IMPROVEMENT: Added descriptive helper text for the Telegram username field to ensure correct link formatting.
* IMPROVEMENT: Improved Telegram link compatibility by allowing 'tg://' protocol in secure URL functions.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.1.0 =
Introduces a default phone input mask and improves modal behavior and UI consistency. Updating is recommended.

= 1.0.1 =
Added new hooks for logging and improved the Telegram settings interface. Recommended for better stability.

= 1.0.0 =
First stable version.