=== CHRS EZTexting Sync for Gravity Forms ===
Contributors: chrsinteractive
Tags: gravity forms, eztexting, sms, text messaging, contacts
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 8.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Integrate Gravity Forms with EZTexting to automatically add contacts to your EZTexting account when forms are submitted.

== Description ==

**CHRS EZTexting Sync for Gravity Forms** seamlessly connects your Gravity Forms with your EZTexting account. When users submit a form, their contact information is automatically synced to EZTexting, allowing you to build your SMS marketing lists effortlessly.

= Features =

* **Automatic Contact Sync** - Automatically create or update contacts in EZTexting when forms are submitted
* **Field Mapping** - Map any form field to EZTexting contact properties (phone, name, email)
* **Custom Fields Support** - Map form fields to your EZTexting custom contact fields
* **Group Assignment** - Automatically add contacts to one or more EZTexting groups
* **Conditional Logic** - Only sync contacts when specific conditions are met
* **Multiple Feeds** - Create multiple feeds per form for different scenarios
* **Secure Authentication** - Supports both Basic Authentication and OAuth2
* **Error Logging** - Detailed logging and admin notifications for failed syncs
* **Entry Notes** - See sync status directly on form entries

= Requirements =

* WordPress 6.0 or higher
* PHP 8.2 or higher
* Gravity Forms 2.5 or higher
* An active EZTexting account

= How It Works =

1. Install and activate the plugin
2. Enter your EZTexting API credentials in the plugin settings
3. Create a feed on any Gravity Form
4. Map your form fields to EZTexting contact fields
5. Select which groups to add contacts to
6. Form submissions will now sync to EZTexting automatically

= Links =

* [EZTexting](https://www.eztexting.com/)

== External Services ==

This plugin connects to the EZTexting API to sync contact information from your Gravity Forms submissions to your EZTexting account.

= What is EZTexting? =

EZTexting is a third-party SMS marketing platform that allows businesses to send text messages to their customers and manage contact lists.

= What data is sent? =

When a form is submitted and a feed is configured, the following data may be sent to EZTexting:

* Phone number (required)
* First name
* Last name
* Email address
* Any custom fields you have mapped in the feed configuration
* Group assignments

= When is data sent? =

Data is sent to EZTexting only when:

1. A Gravity Form with an active EZTexting feed is submitted
2. The feed's conditional logic (if configured) is met
3. A valid phone number is provided in the mapped field

= Service Links =

* [EZTexting Website](https://www.eztexting.com/)
* [EZTexting Terms of Service](https://www.eztexting.com/terms-of-service)
* [EZTexting Privacy Policy](https://www.eztexting.com/privacy-policy)

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Go to Plugins > Add New
3. Search for "CHRS EZTexting Sync for Gravity Forms"
4. Click "Install Now" and then "Activate"

= Manual Installation =

1. Download the plugin zip file
2. Log in to your WordPress admin panel
3. Go to Plugins > Add New > Upload Plugin
4. Choose the zip file and click "Install Now"
5. Activate the plugin

= Configuration =

1. Go to Forms > Settings > EZTexting
2. Enter your EZTexting account email and password
3. Click "Test Connection" to verify your credentials
4. Save your settings

= Creating a Feed =

1. Edit any Gravity Form
2. Go to Settings > EZTexting
3. Click "Add New" to create a feed
4. Configure field mappings and group assignments
5. Save the feed

== Frequently Asked Questions ==

= Do I need a paid EZTexting account? =

Yes, you need an active EZTexting account with API access to use this plugin.

= What phone number format is required? =

Phone numbers must be valid 10-digit US phone numbers. The plugin automatically strips formatting characters.

= Can I add contacts to multiple groups? =

Yes, you can select multiple groups for each feed. Contacts will be added to all selected groups.

= What happens if the API call fails? =

Form submissions will still complete successfully. Failed API calls are logged and an admin notification is displayed. You can view details in the entry notes.

= How do I create custom fields in EZTexting? =

Custom fields must be created in your EZTexting dashboard before they appear in the plugin. Go to [EZTexting Custom Fields](https://spa.eztexting.com/custom-contact-fields) to manage your custom fields.

= How do I create groups in EZTexting? =

Groups must be created in your EZTexting dashboard before they appear in the plugin. Go to [EZTexting Groups](https://spa.eztexting.com/groups) to manage your groups.

= Is the data sent securely? =

Yes, all API communications use HTTPS encryption. Your credentials are stored securely in the WordPress database.

== Screenshots ==

1. Plugin settings page - Configure your EZTexting API credentials and authentication method
2. Form Settings menu - Access the EZTexting feed option from any form's settings
3. Feed list page - View and manage all EZTexting feeds for a form
4. Feed configuration - Map form fields to EZTexting contact properties
5. Groups and custom fields - Assign contacts to groups and map custom field data
6. Entry notes - View sync status and API responses directly on form entries

== Changelog ==

= 1.0.0 =
* Initial release
* Basic and OAuth2 authentication support
* Contact creation and updates
* Group assignment
* Custom field mapping
* Conditional logic support
* Error logging and admin notifications

== Upgrade Notice ==

= 1.0.0 =
Initial release of CHRS EZTexting Sync for Gravity Forms.