=== ActiveTrail for WooCommerce === Contributors: ActiveTrail Tags: activetrail, woocommerce, email marketing, automation, newsletter Requires at least: 6.0 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Integrate your WooCommerce store with ActiveTrail for powerful email marketing automation, customer sync, and dynamic coupons. == Description == ActiveTrail for WooCommerce seamlessly connects your online store with ActiveTrail's marketing automation platform, enabling you to create powerful email campaigns, track customer behavior, and boost sales through targeted marketing. ### Key Features **🔄 Real-time Customer Sync** * Automatically sync customers to ActiveTrail when they place orders * Respect customer consent preferences * Map WooCommerce order statuses to ActiveTrail events **📧 Email Marketing Integration** * Add consent checkbox to checkout form * Customizable consent text * GDPR compliant data handling **🛒 Cart Abandonment Tracking** * Track abandoned carts in real-time * Send cart data to ActiveTrail for recovery campaigns * Configurable abandonment timeframes **🎟️ Dynamic Coupon Management** * Create WooCommerce coupons via ActiveTrail API * REST API endpoints for coupon management * Automatic cleanup of expired coupons **📊 Product Feed Generation** * Generate XML product feeds in Google Shopping format * Separate feeds for Google Merchant Center and Facebook Catalog * Both feeds use XML format (Google Shopping compatible) * Automatic updates when products change **⚙️ Advanced Configuration** * Comprehensive settings panel * API connection testing * Debug mode for troubleshooting ### ActiveTrail Integration ActiveTrail is a leading email marketing and marketing automation platform that helps businesses: * Create professional email campaigns * Build automated marketing workflows * Track customer engagement and behavior * Increase sales through targeted messaging This plugin requires an active ActiveTrail account and API key. ### API Endpoints The plugin provides REST API endpoints for external integrations: * `POST /wp-json/activetrail/v1/coupon` - Create coupons * `DELETE /wp-json/activetrail/v1/coupon/{code}` - Delete coupons * `GET /wp-json/activetrail/v1/coupon/{code}/usage` - Get coupon usage ### Product Feeds Access your product feeds from the plugin settings page (WooCommerce > Settings > ActiveTrail > Product Export tab): * **Google Merchant Center XML Feed**: Available in the settings with a secure key * **Facebook Catalog XML Feed**: Available in the settings with a separate secure key Both feeds use the Google Shopping XML format and are automatically updated when products change. Each feed has its own secure URL that you can copy and use in your advertising platform. == Installation == ### Automatic Installation 1. Log in to your WordPress admin panel 2. Go to Plugins > Add New 3. Search for "ActiveTrail for WooCommerce" 4. Click "Install Now" and then "Activate" ### Manual Installation 1. Download the plugin zip file 2. Upload it via Plugins > Add New > Upload Plugin 3. Activate the plugin ### Configuration 1. Go to WooCommerce > Settings > ActiveTrail 2. Enter your ActiveTrail API key 3. Select your target group 4. Configure sync settings 5. Save changes == Frequently Asked Questions == = Do I need an ActiveTrail account? = Yes, you need an active ActiveTrail account and API key to use this plugin. You can sign up at [ActiveTrail.com](https://www.activetrail.com/). = Where do I find my API key? = Log in to your ActiveTrail account and navigate to Settings > API to generate your API key. = Will this plugin slow down my site? = No, the plugin is designed for optimal performance. API calls are made asynchronously and cart tracking uses efficient database operations. = Is this plugin GDPR compliant? = Yes, the plugin includes consent management features and only syncs data when customers provide consent (unless configured otherwise). = Can I customize the consent checkbox text? = Yes, you can customize the consent text in the plugin settings under WooCommerce > Settings > ActiveTrail. = What happens to my data if I uninstall the plugin? = The plugin will clean up its settings and tracking data. ActiveTrail coupons can optionally be preserved. = Does this work with variable products? = Yes, the plugin fully supports variable products and will include variations in product feeds and order data. = Can I test the API connection? = Yes, the settings page includes a "Test Connection" button to verify your API key and connection. == Screenshots == 1. Main settings page with API configuration 2. Order synchronization settings 3. Checkout consent checkbox 4. Product feed URLs (Google and Facebook XML feeds) 5. Cart abandonment tracking == Changelog == = 1.0.0 = * Initial release * Customer sync with ActiveTrail * Order status mapping * Cart abandonment tracking * Dynamic coupon creation * Product feed generation * Checkout consent management * REST API endpoints * Comprehensive admin interface == Upgrade Notice == = 1.0.0 = Initial release of ActiveTrail for WooCommerce. Install to start syncing your store with ActiveTrail. == Technical Requirements == * WordPress 6.0 or higher * WooCommerce 6.0 or higher * PHP 7.4 or higher * ActiveTrail account with API access * SSL certificate recommended == Support == For support and documentation: * [Plugin Documentation](https://webapi.mymarketing.co.il/api/docs/) * [ActiveTrail Support](https://www.activetrail.com/support/) * [WordPress Plugin Support](https://wordpress.org/support/plugin/activetrail-woocommerce/) == Privacy Policy == This plugin connects to ActiveTrail's external service to sync customer and order data. Data is only sent when: 1. Customers provide explicit consent (if consent is required) 2. Orders reach configured status levels 3. Carts are abandoned (if cart tracking is enabled) Data sent includes: * Customer email and name * Order details and items * Cart contents and abandonment data Please review ActiveTrail's privacy policy and ensure compliance with local data protection laws. == Third-party Services == This plugin integrates with: * **ActiveTrail API** (https://webapi.mymarketing.co.il/api/) - Used for customer sync, order data, and coupon management - Privacy Policy: https://www.activetrail.com/privacy-policy/ - Terms of Service: https://www.activetrail.com/terms-of-service/ == Developer Information == ### Hooks and Filters The plugin provides numerous hooks for customization: **Filters:** * `activetrail_customer_data` - Modify customer data before sync * `activetrail_order_data` - Modify order data before sync * `activetrail_cart_data` - Modify cart data before sync * `activetrail_feed_data` - Modify product feed data * `activetrail_product_feed_item` - Modify individual product data **Actions:** * `activetrail_customer_synced` - Fired after customer sync * `activetrail_order_synced` - Fired after order sync * `activetrail_cart_synced` - Fired after cart sync * `activetrail_coupon_created` - Fired after coupon creation ### Constants * `ACTIVETRAIL_WC_VERSION` - Plugin version * `ACTIVETRAIL_WC_PLUGIN_DIR` - Plugin directory path * `ACTIVETRAIL_WC_PLUGIN_URL` - Plugin URL == Contributing == This plugin is open source. Contributions are welcome via GitHub. == Credits == Developed by Or Malka for seamless ActiveTrail and WooCommerce integration.