=== Additional Custom Emails for WooCommerce ===
Contributors: wpcodefactory, algoritmika, anbinder, karzin, omardabbas, kousikmukherjeeli, aegkr
Tags: woocommerce, emails, email, custom email, custom emails
Requires at least: 4.4
Tested up to: 6.6
Stable tag: 3.3.1
License: GNU General Public License v3.0
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Take full control over the emails you send and customize your WooCommerce emails with our plugin.

== Description ==

> “Great plugin! Great Support!: The best plugin for sending custom emails. Great integration in WooCommerce.
The best Support Team.” – ⭐⭐⭐⭐⭐  [wicresetpl](https://wordpress.org/support/topic/great-plugin-great-support-1734/)

Communication is key in business, and your customers would appreciate knowing the status of their orders from the moment of checking out till the moment it’s shipped in front of their doors, that’s why you need our ‘Additional Custom Emails for WooCommerce’ plugin.

WooCommerce by default allows you to send emails based on several triggers (that are located under WooCommerce Settings >> Emails) like "New order", "Failed order" and so on.

Our plugin allows you to add more emails than the defaults one by WooCommerce.

Our plugin’s numerous configuration options allow for full control over what you can do with it. You can notify your customers when order status changed to "Completed", or only when it changed from "Pending payment" to "Completed".

You can also add custom emails based on custom order statuses you have in your store, and these are automatically added to the plugin's triggers list. And with multilingual support you can expand your reach for the whole world not just English-speaking countries.

Our customers really love this plugin, read the full description to learn about all of its features and understand why they’re loving it.

#### Useful Links ####
* [**Plugin Main Page**](https://wpfactory.com/item/custom-emails-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme)
* [**Plugin Support Forum**](https://wpfactory.com/support/item/custom-emails-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme )
* [**Documentation & How to**](https://wpfactory.com/docs/custom-emails-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme )


## 🚀 Main Features: FREE Version##

Additional Custom Emails for WooCommerce plugin allows for full control over your communication with your customers and expands your reach to connect with your audience beyond just your store, the free version alone would allow you to do a lot, for the free version you can send one custom email based on these triggers:

### 🚀 **Send email on Order status update** ###
Notify your customers of the status of their orders, once their order is "shipped" or "completed" give them a note through the email of the state of their order.

### 🚀 **Send email based on custom triggers** ###
Set any custom trigger you want to notify your customers when it happens and our plugin will allow you to send custom emails to your customers based on these custom triggers.

### 🚀 **Delay Emails** ###
In case you want to delay your emails for any reason you can use our plugin for that purpose, for example you can use to send custom email one week after order was completed.

### 🚀 **Require/exclude order product(s)** ###
You can send emails only if some products or categories were selected, so you have further control over when to send your custom emails.

### 🚀 **Set minimum/maximum order amount** ###
Say you want to offer free shipping for customers with order amount above certain limit, you can use this feature to notify your customers of their eligibility for free shipping using this feature. Generally if you want your customers with order amounts above or below certain limits to be notified you can use this feature to notify them.

### 🚀 **Require/exclude order payment gateways or shipping methods** ###
If you want to require specific payment getaways or specific shipping methods you can use this criteria to send emails only to customers who align with this criteria.

### 🚀 **Require/exclude order user roles or users** ###
Specify which emails to send to which user roles or whether you want to specify specific user to send the emails to.

### 🚀 **Set subject, heading and content** ###
Set the subject, the heading, and the content of your custom email so you send the right message to the right people, you can use placeholders and short codes here for more personalization and customization of your email.

### 🚀 **Attach files to the custom emails** ###
If you want to send any kind of files through your custom emails our plugin allows you to attach files to your emails which gives you more control over your custom email.

### 🚀 **Set email type** ###
Send your emails in TXT, HTML, or Multipart format or Wrap your emails in WooCommerce email template if you like.

### 🚀 **Send emails manually or in bulk** ###
From the order actions box you can specify whether to send your custom email manually or in bulk.

### 🚀 **Set email recipient(s)** ###
Specify the recipients of the custom email you are setting and who should receive this email.

### 🚀 **Set email’s admin title** ###
Set the admin title of the email that will show up as the sender in the recipient's inbox.

### 🚀 **WPML and Polylang compatible** ###
Our plugin has multilingual support and is compatible with WPML and Polylang.

### 🚀 **“High-Performance Order Storage (HPOS)” compatible.** ###
This means your website can be as fast as it needs to be because HPOS allows for maximum efficiency when it comes to handling orders data at WooCommerce, so your store will can be customizable and efficient.

USE CASES:
### 🚀 **Send Email Based on Order status when it gets updated** ###
Once the status of the order is changed from "shipping" to "completed" or from any other state to the other this trigger allows you to send custom to notify your customers with this status update.

### 🚀 **Send Email Based on Subscriptions** ###
Notify your customers of the state of their subscription whether they're subscribed or subscription status updated from one state to the other, you can also notify them about the renewal state of their subscription.

> “nice plugin: Very easy to use! Does what is says…I did not find any problems so far.
Thanks.” – ⭐⭐⭐⭐⭐ [vladimiryo](https://wordpress.org/support/topic/nice-plugin-4732/)

> “Woocommerce Subscription cancellation notification: This great simple to use plugin allowed me to add a free Subscription cancellation notification” – ⭐⭐⭐⭐⭐ [2u2a](https://wordpress.org/support/topic/woocommerce-subscription-cancellation-notification/)

## 🏆 Pro Version ##

With our pro version you will have unlimited access to all of our custom emails and custom triggers so you can send your customers as many amount of emails as you want with any type of trigger you can imagine.


## 💯 Why WPFactory?##

* **Experience You Can Trust:** Over a decade in the business
* **Wide Plugin Selection:** Offering 65+ unique and powerful plugins
* **Highly-Rated Support:** Backed by hundreds of 5-star reviews
* **Expert Team:** Dedicated developers and technical support at your service

___

## What's Next? Check More Plugins by WPFactory##

If you're enjoying our plugin, we'd love for you to explore our other offerings. WPFactory has a diverse range of plugins tailored to enhance your experience.

Dive in and discover more tools to empower your WooCommerce Store!


* [**Min Max Step Quantity**](https://wpfactory.com/item/product-quantity-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme "**Min Max Step Quantity**"): Define a min max, step and default quantity for products, show a dropdown, quantities on archive/categories pages, use decimal quantities, and much more on WooCommerce stores (**[Try our Free version](https://wordpress.org/plugins/product-quantity-for-woocommerce/ "Try our Free version")**)

* [**Cost of Goods for WooCommerce**](https://wpfactory.com/item/cost-of-goods-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme "**Cost of Goods WooCommerce**"): Make informed decisions to maximize profits, correctly calculate Cost of Goods Sold (COGS) for your WooCommerce store and enhance your financial management capabilities (**[Try our Free version](https://wordpress.org/plugins/cost-of-goods-for-woocommerce/ "Try our Free version")**)

* [**Maximum Products per User**](https://wpfactory.com/item/maximum-products-per-user-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme "**Maximum Products per User**"): Set personalized purchase limits for your customers, define maximum product quantities, catered to specific user roles & selected date range (**[Try our Free version](https://wordpress.org/plugins/maximum-products-per-user-for-woocommerce/ "Try our Free version")**)

* [**Order Minimum/Maximum Amount**](https://wpfactory.com/item/order-minimum-maximum-amount-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme "**Order Minimum/Maximum Amount**"): Set tailored minimum and maximum order thresholds, by sum, quantity, weight, or volume, customize limits by user role, specific user, product category, shipping method, payment gateway, or even by currency (**[Try our Free version](https://wordpress.org/plugins/order-minimum-amount-for-woocommerce/ "Try our Free version")**)

* [**EU/UK VAT Manager for WooCommerce**](https://wpfactory.com/item/eu-vat-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme "**EU/UK VAT Manager for WooCommerce**"): Streamline your WooCommerce store’s EU/UK VAT compliance effortlessly, automate VAT settings, validation (VIES), and how to apply taxes, ensuring a seamless and compliant customer experience (**[Try our Free version](https://wordpress.org/plugins/eu-vat-for-woocommerce/ "Try our Free version")**)

* [**Email Verification for WooCommerce**](https://wpfactory.com/item/email-verification-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme "**Email Verification for WooCommerce**"): Enhance WooCommerce security and credibility with Email Verification best plugin. Ensure genuine customer interactions, eliminate spam, and elevate email marketing efficiency (**[Try our Free version](https://wordpress.org/plugins/maximum-products-per-user-for-woocommerce/ "Try our Free version")**)

* [**Free Shipping Over Amount for WooCommerce**](https://wpfactory.com/item/amount-left-free-shipping-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme "**Free Shipping Over Amount for WooCommerce**"): WooCommerce Advanced Free Shipping plugin, use our plugin to quality customers for free shipping when they spend specific amount, by showing a bar on remaining amounts they need to spend to qualify for free shipping (**[Try our Free version](https://wordpress.org/plugins/amount-left-free-shipping-woocommerce/ "Try our Free version")**)

* [**Dynamic Pricing & Bulk Quantity Discounts**](https://wpfactory.com/item/product-price-by-quantity-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme "**Dynamic Pricing & Bulk Quantity Discounts**"): Create and manage advanced dynamic pricing and bulk discount rules for WooCommerce, encouraging bulk purchases and driving your sales to new heights (**[Try our Free version](https://wordpress.org/plugins/wholesale-pricing-woocommerce/ "Try our Free version")**)

> “This plugin is exactly what I needed, and Tom (and the wider team) at WPFactory go above and beyond to help if you need support. I have no hesitation in recommending this plugin to anyone looking to send well designed custom emails from WooCommerce.” – ⭐⭐⭐⭐⭐ [Shannon Novak](https://wpfactory.com/item/custom-emails-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme)

> “Najlepsza wtyczka do wysyłania niestandardowych wiadomości email.” – ⭐⭐⭐⭐⭐ [Mariusz](https://wpfactory.com/item/custom-emails-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme)

> “This plugin is fantastic - it offers a wide range of customization options, and the support is simply outstanding. The team responded quickly to my feature request and went above and beyond to assist me with any other issues. I highly recommend this plugin and the fantastic support that comes with it.” – ⭐⭐⭐⭐⭐ [Alex Nimanaj](https://wpfactory.com/item/custom-emails-for-woocommerce/?utm_source=wporg&utm_medium=organic&utm_campaign=readme)

> “Top functionality and control options. Great support!: This plugin helped a lot in designing an individual solution for a customer requirement due to its numerous configuration options.” – ⭐⭐⭐⭐⭐ [suessbot](https://wordpress.org/support/topic/top-functionality-and-control-options-great-support/)

== Installation ==

1. Upload the entire plugin folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Start by visiting plugin settings at "WooCommerce > Settings > Custom Emails".

== Changelog ==

= 3.3.1 - 11/10/2024 =
* Dev - Admin settings descriptions updated.

= 3.3.0 - 10/10/2024 =
* Dev - General - "Replace line breaks" option added (defaults to `yes`).
* Dev - Key Manager - Library updated.

= 3.2.0 - 28/09/2024 =
* Fix - Pro - Admin Options - Admin actions - Orders > Bulk actions - HPOS compatibility (`wc-orders` page).
* Dev - "Key Manager" added.

= 3.1.2 - 27/09/2024 =
* Fix - Resolved Ctrl+Z shortcut issue in the rich text editor.
* Dev - Added search field to the shortcode selector.
* Dev - PHP 8.2 compatibility - "Creation of dynamic property is deprecated" notice fixed.

= 3.1.1 - 19/09/2024 =
* Fix - Email content - Rich text editor - Resolved vertical scroll issue in the "Text" mode.

= 3.1.0 - 18/09/2024 =
* Dev - Email content - Integrated a rich text editor.
* Dev - Subject / Email heading / Email content - Added a shortcode selector.
* WC tested up to: 9.3.

= 3.0.5 - 04/09/2024 =
* Dev - Trash buttons added.
* WC tested up to: 9.2.

= 3.0.4 - 18/08/2024 =
* Dev - Shortcodes - `[order_user_meta]` shortcode added.
* Dev - Shortcodes - `[order_details]` - `add_product_desc` attribute added (defaults to `no`).
* Dev - Shortcodes - `[order_details]` - `add_product_short_desc` attribute added (defaults to `no`).
* Tested up to: 6.6.

= 3.0.3 - 30/07/2024 =
* WC tested up to: 9.1

= 3.0.2 - 28/07/2024 =
* WC tested up to: 9.0.

= 3.0.1 - 05/06/2024 =
* Dev - Shortcodes - `[order_details]` - `add_product_images` attribute added (defaults to `no`).
* Dev - Shortcodes - `[order_item_product_images]` shortcode added.
* WC tested up to: 8.9.

= 3.0.0 - 15/05/2024 =
* Dev - Code refactoring.
* WooCommerce added to the "Requires Plugins" (plugin header).

= 2.9.9 - 06/05/2024 =
* Dev - "Email Sender Options" subsection added ("From"/"Reply-to" name/address).

= 2.9.8 - 03/05/2024 =
* Dev - Order Options - Require/Exclude products/users - Admin options are loaded only in the backend now.

= 2.9.7 - 02/05/2024 =
* Dev - Shortcodes - `[order_details]` - `add_product_links` attribute added (defaults to `no`).

= 2.9.6 - 29/04/2024 =
* Dev - Shortcodes - `[order_customer_order_notes]` shortcode added.
* WC tested up to: 8.8.

= 2.9.5 - 08/04/2024 =
* Dev - Shortcodes - `[order_total_items_qty]` shortcode added.
* Tested up to: 6.5.

= 2.9.4 - 01/04/2024 =
* Dev - Shortcodes - `[order_view_url]` shortcode added.
* Dev - Shortcodes - `[order_edit_url]` shortcode added.
* Dev - Shortcodes - `[order_received_url]` shortcode added.
* Dev - Shortcodes - `[order_cancel_url]` shortcode added.
* Dev - Shortcodes - `[order_shipping_address_map_url]` shortcode added.
* Dev - Shortcodes - `[order_id]` shortcode added.
* WC tested up to: 8.7.

= 2.9.3 - 13/03/2024 =
* Dev - Triggers - Extra - "Customer address changed" and "Customer address saved" triggers added.
* Dev - Scheduled - Admin - Object ID validation added.

= 2.9.2 - 01/03/2024 =
* Readme.txt - Changelog - Truncated (full changelog moved to the `changelog.txt` file).
* Readme.txt - Tags - `woo commerce` tag removed.

= 2.9.1 - 29/02/2024 =
* Dev - Developers - `alg_wc_custom_emails_delay_start_time` filter added.
* Dev - Developers - `alg_wc_custom_emails_email_sent` action added.
* Dev - Developers - `alg_wc_custom_emails_exclude_recipients` filter added.
* Dev - Code refactoring.

= 2.9.0 - 21/02/2024 =
* Dev - Order Options - Require/Exclude order status - "WooCommerce Subscriptions" statuses added.
* Dev - Shortcodes - `[order_checkout_payment_url]` shortcode added.
* Dev - Send email - Now trying to get object ID with the `get_id()` method (e.g., for "WooCommerce Subscriptions" status update hooks).
* Typos fixed in the plugin description section in readme.txt.
* WC tested up to: 8.6.

= 2.8.1 - 15/02/2024 =
* Dev - Shortcodes - `[order_billing_email]` shortcode added.
* Dev - Shortcodes - `[order_billing_phone]` shortcode added.

= 2.8.0 - 29/01/2024 =
* Dev - Order Options - "Require order status" option added.
* Dev - Order Options - "Exclude order status" option added.
* Dev - Debug - "Current filter" added to the "Triggered" log message.

= 2.7.3 - 11/01/2024 =
* Dev - Advanced Options - "Stop emails" option added.

= 2.7.2 - 09/01/2024 =
* Dev - Shortcodes - `[order_billing_first_name]` shortcode added.
* Dev - Shortcodes - `[order_billing_last_name]` shortcode added.
* Dev - Shortcodes - `[order_customer_note]` shortcode added.
* Dev - Shortcodes - Developers - `alg_wc_custom_emails_shortcode_prefix` filter added.
* Dev - Shortcodes - Code refactoring.
* WC tested up to: 8.5.

= 2.7.1 - 21/12/2023 =
* Dev - Email Data - "Email style" option added.
* Dev - Code refactoring.

= 2.7.0 - 19/12/2023 =
* Dev - General - "Scheduler" option added (defaults to "WP Cron").

= 2.6.3 - 18/12/2023 =
* Readme.txt file error fixed.

= 2.6.2 - 18/12/2023 =
* Readme.txt file updated.

= 2.6.1 - 14/12/2023 =
* Dev - Shortcodes - `[if]` - `case_insensitive` attribute added.
* Dev - Shortcodes - `[if]` - `operator` - `find` and `not_find` operators added.
* WC tested up to: 8.4.

= 2.6.0 - 30/11/2023 =
* Dev - Triggers - Extra - "Product published" and "Product updated" triggers added.
* Dev - Shortcodes - `[product_func]` shortcode added.
* Dev - Code refactoring.

= 2.5.0 - 22/11/2023 =
* Dev - Order Options - "Require users" option added.
* Dev - Order Options - "Exclude users" option added.
* Dev - Order Options - "Require user roles" option added.
* Dev - Order Options - "Exclude user roles" option added.
* Dev - Code refactoring.

= 2.4.0 - 17/11/2023 =
* Dev - General - Advanced Options - "Use actions for WC email template" option removed (now always using actions).
* Dev - Email Data - "WC email template" option renamed to "Header & footer". Now the option is applied to "Plain text" emails as well.
* Dev - Using overridable email templates now.
* Dev - Code refactoring.
* Dev - Developers - `alg_wc_custom_emails_get_wc_email_template_part` filter removed.
* Tested up to: 6.4.
* WC tested up to: 8.3.

= 2.3.0 - 03/11/2023 =
* Fix - Admin Options - Admin actions - Orders > Bulk actions - HPOS compatibility (`wc-orders` page).
* WC tested up to: 8.2.

= 2.2.9 - 25/09/2023 =
* WC tested up to: 8.1.
* Plugin icon, banner updated.

= 2.2.8 - 17/08/2023 =
* Dev - Developers - `alg_wc_custom_emails_is_enabled` filter - `$do_force_send` parameter added.

= 2.2.7 - 16/08/2023 =
* Fix - Declaring HPOS compatibility for the free plugin version, even if the Pro version is activated.
* Dev - General - "Base dir" option added (defaults to "WP root directory"). Affects the "Email attachments" options.
* Dev - Debug - Email attachments info added.

= 2.2.6 - 09/08/2023 =
* Dev - Admin settings - Delay - Description updated.
* Tested up to: 6.3.
* WC tested up to: 8.0.

= 2.2.5 - 04/08/2023 =
* Dev - Shortcodes - `[user_prop]` shortcode added.
* Dev - Developers - `alg_wc_custom_emails_is_user_email` filter - `current_filter()` parameter added.

= 2.2.4 - 03/08/2023 =
* Dev - Shortcodes - `[order_item_meta]` shortcode added.

= 2.2.3 - 18/07/2023 =
* Dev - "High-Performance Order Storage (HPOS)" compatibility.
* Dev - Developers - `alg_wc_custom_emails_subject` filter added.
* Dev - Developers - `alg_wc_custom_emails_content` filter added.
* WC tested up to: 7.9.

= 2.2.2 - 18/07/2023 =
* Dev - Developers - `alg_wc_custom_emails_do_send_order_email` filter added.

= 2.2.1 - 28/06/2023 =
* Dev - Shortcodes - `[order_payment_method_id]` shortcode added.

= 2.2.0 - 22/06/2023 =
* Dev - Order Options - "Require payment gateways" option added.
* Dev - Order Options - "Exclude payment gateways" option added.
* Dev - Order Options - "Require shipping methods" option added.
* Dev - Order Options - "Exclude shipping methods" option added.
* Dev - General - Advanced Options - "Use actions for WC email template" option added (defaults to `no`).
* Dev - Developers - `alg_wc_custom_emails_get_wc_email_template_part` filter added.

= 2.1.0 - 18/06/2023 =
* Fix - Admin settings - "Shortcodes" link fixed in the "placeholder text".
* Dev - General - "Enable plugin" option removed.
* Dev - General - "Custom triggers" option added.
* Dev - Shortcodes - `[if]` - `operator` - `in` and `not_in` operators added.
* Dev - Shortcodes - `[order_item_product_ids]` shortcode added.
* Dev - Shortcodes - `[order_downloads]` shortcode added.
* Dev - Shortcodes - `[order_user_data]` shortcode added. E.g., `[order_user_data key="user_nicename"]`.
* Dev - Shortcodes - `[order_user_id]` shortcode added.
* Dev - Developers - `alg_wc_ce_send_email()` function added.
* Dev - Developers - `alg_wc_custom_emails_check_order_products` filter added.
* Dev - Developers - `alg_wc_custom_emails_check_order_product_terms` filter added.
* Dev - Code refactoring.
* WC tested up to: 7.8.

= 2.0.0 - 09/05/2023 =
* Dev - Code refactoring - `Alg_WC_Custom_Email` class.
* WC tested up to: 7.6.

[See changelog for all versions](https://plugins.svn.wordpress.org/custom-emails-for-woocommerce/trunk/changelog.txt).

== Upgrade Notice ==

= 1.0.0 =
This is the first release of the plugin.