# WooMail - WooCommerce Email Customizer

Documentation version 2.2.11

## Introduction

- Item Name : WooMail - WooCommerce Email Customizer with Drag Drop Builder
- Item Version : v2.2.11
- Author : CidCode
- Support : http://support.cidcode.net

First of all, Thank you so much for purchasing this plugin.
You are entitled to get free lifetime updates to this product + exceptional support from the author directly.

With the help of our plugin you can customize follow email cases

1. New order
2. Cancelled order
3. Failed order
4. Order On-hold
5. Processing order
6. Completed order
7. Refunded order
8. Customer invoice
9. New Account
10. Reset Password
11. Customer Note

While customizing you can add dynamic information about product and order. Dynamic information can be added using shortcodes. It also supports multilanguage

#### Requirements

You will need the following sofwares to use this plugin.

1. PHP version 5.6 or greater
2. WordPress 4.1 or higher
3. WooCommerce 2.5 or higher

We recommend using PHP version 7.0,WordPress 4.9 and WooCommerce 3.0

## Installation #back to top

#### Upload via WordPress Admin

After downloading files from CodeCanyon, unzip the file , in there you will see email-customizer.zip file. It is the main plugin file. For installing go to the Plugins page, cick the Add new button, then upload plugin. After uploading plugin please activate it.

Ask a Question

#### Upload via FTP Server

For uploading via FTP you need desktop software.We recommend using FileZilla .
After downloading files from CodeCanyon, unzip the file , in there you will see email-customizer.zip file. It is the main plugin file. Unzip that file then start uploading plugin to /wp-content/plugins/ folder. Then go to the WordPress Plugins -> Installalled Plugins and activate plugin.

Ask a Question

## Load Template #back to top

- Step 1. Language - Our plugin supports multilanguage. By default, language will selected. You can create your template in your language.
- Step 2. Email Type - You should select email type which do you want to change
- Step 3. Example Order - It is the last step. After selecting order you will see data according to selecting order.

That data which you see in the canvas, is the only for example. In the real world, the data will be generate dynamically according to shortcodes

## Customizing Template #back to top

This plugin has 8 predefined elements and 7 row elements for creating email template.

#### Elements

1. Button
2. Text
3. Spacer
4. Video
5. Image
6. Divider
7. Menu
8. Social

#### Structure

Row elements created by grid system

1. Row 12
2. Row 6-6
3. Row 4-4-4
4. Row 3-3-3-3
5. Row 8-4
6. Row 4-8
7. Row 3-6-3

#### Control of Elements

1. Name of element( or row )
2. Duplicate. When click this button, clicked element(or row) will duplicate
3. Delete. When click this button, clicked element(or row) will remove
4. Move. With the help of this button you can change the position of element (or row)

#### How to change content of email

When you click any element in the canvas, at the left menu you will see settings according to selected element.
At the right image you can see the settings of video element.

#### Shortcode support

When you start editing text element, you can add shortcode for dynamic information of order and product.

## Controls #back to top

Import
- You can import a JSON file which exported from plugin
Export
- You can export template as a JSON or an HTML
Blank page
- With the of this button you can clean canvas and start again.
Templates
- For saving your time we are add some blocks,templates.
- Also, you can save your own template , then you will see those templates in My templates section
Help
- You can show or search list of shortcode.
Save
- After finishing designing template you should save it.
Options
-Save as Template You can save your own template.
-Save as ... After finishing the design of template you can save it for different language and email type.
-Send Email You can test template anytime with the help of send it to your email address.

## Custom Shortcode #back to top

You can create unlimited custom code with WooMail - WooCommerce Email Customizer.In the left menu you will see 'EC WOO Custom Shortcode' page.In that page you need just do 3 steps:

1. Shortcode name. Name should with under line ( _ ) not with probel.Ex: my_short_code
2. Content of shortcode
3. Publish

After adding custom code you should use with prefix(ec_woo_ ).
For example, you add my_short_code, in this case you should use [ec_woo_my_short_code]

Please be carefull when adding custom shortcode. Name should not be with probel. Ex: My code. It is wrong !
Name should with under line. For example: my_short_code.

## Shortcode List #back to top

#### General

[ec_woo_payment_method]
Get Payment method
[ec_woo_site_name]
Get Website Name
[ec_woo_site_url]
Get Website URL

#### User

[ec_woo_user_email]
Get User Email
[ec_woo_user_name]
Get User Name
[ec_woo_user_password]
Get User Password
[ec_woo_user_account_url]
Get User Account URL ( My account )
[ec_woo_user_password_reset_url]
Get User Password Reset UR
[ec_woo_user_activation_link]
Get User Activation URL
[ec_woo_user_id]
Get User Id

#### Order

[ec_woo_customer_notes]
Get Order Customer Notes
[ec_woo_customer_provided_note]
Get Order Customer Provided Note
[ec_woo_items]
Get Order Items with basic style
[ec_woo_items_1]
Get Order Items with modern style 1
[ec_woo_items_2]
Get Order Items with modern style 2
[ec_woo_items_3]
Get Order Items with modern style 3
[ec_woo_items_4]
Get Order Items with modern style 4
[ec_woo_items_5]
Get Order Items with modern style 5
[ec_woo_order_date]
Get Order Date (ex:Jul 25, 2018)
[ec_woo_order_datetime]
Get Order Datetime (ex:2018-07-25 05:48:07)
[ec_woo_order_fee]
Get Order Fee
[ec_woo_order_id]
Get Order ID
[ec_woo_order_link]
Get Order Link
[ec_woo_order_payment_method]
Get Order Payment Method
[ec_woo_order_payment_url]
Get Order Payment URL
[ec_woo_order_refund]
Get Order Refund
[ec_woo_order_sub_total]
Get Order Sub Total
[ec_woo_order_shipping]
Get Order Shipping
[ec_woo_order_time]
Get Order Time (ex:05:48:07)
[ec_woo_order_total]
Get Order Total
[ec_woo_transaction_id]
Get Transaction ID
[ec_woo_view_order_url]
Get View Order URL

#### Shipping

[ec_woo_shipping_address]
Get Shipping Address
[ec_woo_shipping_address_1]
Get Shipping Address 1
[ec_woo_shipping_address_2]
Get Shipping Address 2
[ec_woo_shipping_city]
Get Shipping City
[ec_woo_shipping_company]
Get Shipping Company
[ec_woo_shipping_country]
Get Shipping Country
[ec_woo_shipping_email]
Get Shipping Email
[ec_woo_shipping_first_name]
Get Shipping First Name
[ec_woo_shipping_last_name]
Get Shipping Last Name
[ec_woo_shipping_phone]
Get Shipping Phone
[ec_woo_shipping_postcode]
Get Shipping Post Code
[ec_woo_shipping_state]
Get Shipping State

#### Billing

[ec_woo_billing_address]
Get Billing Address
[ec_woo_billing_address_1]
Get Billing Address 1
[ec_woo_billing_address_2]
Get Billing Address 2
[ec_woo_billing_city]
Get Billing City
[ec_woo_billing_company]
Get Billing Company
[ec_woo_billing_country]
Get Billing Country
[ec_woo_billing_email]
Get Billing Email
[ec_woo_billing_first_name]
Get Billing First Name
[ec_woo_billing_last_name]
Get Billing Last Name
[ec_woo_billing_phone]
Get Billing Phone
[ec_woo_billing_postcode]
Get Billing Post Code
[ec_woo_billing_state]
Get Billing State

## Support #back to top

Please remember you have purchased a very affordable plugin and you have not paid for a full-time web design agency. Occasionally we will help with small tweaks, but these requests will be put on a lower priority due to their nature. Support is also 100% optional and we provide it for your convenience, so please be patient.

Please visit our suppor center

Support for my items includes:

- * Responding to questions or problems regarding the item and its features
- * Fixing bugs and reported issues
- * Providing updates to ensure compatibility with new software versions

Item support does not include:

- * Customization and installation services
- * Support for third party software and plug-ins

Before seeking support, please...

- * Make sure your question is a valid Plugin Issue and not a customization request.
- * Make sure you have read through the documentation and any related video guides before asking support on how to accomplish a task.
- * Make sure to double check the FAQs.
- * If you have customized your theme and now have an issue, back-track to make sure you didn't make a mistake. If you have made changes and can't find the issue, please provide us with your changelog.

## Version History (Changelog) #back to top

You can find the version history (changelog.txt) file on plugin folder or you can check changelog on plugin sale page.

Once again, thank you so much for purchasing this plugin. As I said at the beginning, I'd be glad to help you if you have any questions relating to this plugin. I'll do my best to assist.

#### Changelog

                    Version 2.2.11 | 26.05.2019
                    - Added : New shortcodes for Woo Subscription. ec_woo_wcs_id,ec_woo_wcs_price,etc. please check shortcode list for seeing all list.
                    - Added : Settings for hide 'custom shortcode' page from wordpress menu
                    - Added : Export/import all templates at once
                    - Added : Settings for showing information which are added from other plugins.
                    - Fixed : Image size problem in emails
                    - Fixed : Templates extra spaces problem
                    - Fixed : Shortcode 'ec_woo_order_link' problem
                    - Fixed : Templates table headers regarding mobile preview
                    - Fixed : Email notification in outlook was showed javascript:void text
                    - Fixed : All predefined templates problems
                    - Fixed : When showing downloadable products, bullets was showed in emails. now fixed.
                    - Fixed : Minor issues

                    --------------------

                    Version 2.2.10 | 25.04.2019
                    - Fixed : email responsive problem
                    - Fixed : builder UI problems

                    --------------------

                    Version 2.2.9 | 09.04.2019
                    - Added : new shortcode ec_woo_related_items. show your recommend items in your email and increase your sales.
                    - Added : integration 'WooCommerce Subscription'
                    - Fixed : RTL UI problems
                    - Fixed : Minor issues

                    --------------------

                    Version 2.2.8 | 25.03.2019
                    - Added : new shortcode ec_woo_order_shipping_total, show shipping information with fees
                    - Added : integration 'Motors' theme
                    - Added : 4 new shortcodes related 'Motors' theme: ec_woo_order_pickup_date,ec_woo_order_pickup_location,ec_woo_drop_date,ec_woo_drop_location
                    - Added : 2 new shortcodes ec_woo_user_account_url_2 ,ec_woo_user_password_reset_url_2 with custom text
                    - Fixed : json parse problems in the UI side
                    - Fixed : bugs in loading bank information
                    - Fixed : builder UI RTL support

                      --------------------

                    Version 2.2.5 | 08.03.2019
                    - Added : One of the valuable customer (@fenrirlin) prepaid 'Traditional Chinese' and 'Simplified Chinese' translations
                    - Added : new shortcodes for customer notes last message and last month
                    - Added : enable/disable for any email type.
                    - Fixed : improvement builder UI
                    - Fixed : shipping tracking info plugin integration
                    - Fixed : minor issues

                    --------------------

                    Version 2.1 | 16.01.2018
                    - Integrated : Woocommerce shipping tracking
                    - Added : showing product version, if it is not activating now possible activate it again.
                    - Added : internal log system
                    - Added : short codes for bank information
                    - Added : short codes will generate automatically,
                    so if you are using plugin which we integrated it you will see all available short codes
                    - Added : partial refund order email type supported
                    - Added : short code for showing order refund, order totals, etc. information

                    --------------------

                    Version 2.0 | 22.12.2018
                    - Integrated : Order delivery date plugin lite version
                    - Added : Line height option added to TinyMCE editor
                    - Fixed : Flexible checkout fields problems
                    - Fixed : Unicode problem when using different languages
                    - Fixed : After collapse/expand left menu, canvas background color changed default
                    - Fixed : Send Test Email feature. ( You should configure wp_mail correctly )
                    - Fixed : Convert URL problem in TinyMCE editor
                    - Fixed : Outlook issues
                    - Fixed : Minor bugs

                    --------------------

                    Version 1.9 | 20.11.2018
                    - Added : Linkable product names
                    - Added : Compatible with Woodmart WordPress Theme
                    - Added : Auto Update feature
                    - Added : URL to shortcode - ec_woo_view_order_url , previously showed just text
                    - Fixed : Unicode problem when sending emails
                    - Fixed : Image size problem
                    - Fixed : Email preview, Responsive image problems, Bugs in outlook, minor bugs

                    --------------------

                    Version 1.8 | 04.11.2018
                    - Fixed : responsive image problem in small devices
                    - Fixed : small issues when using RTL
                    - Fixed : when using the long product name, it went to the second line.
                    - Fixed : Minor bugs

                    ---------------------

                    Version 1.7 | 01.11.2018
                    - Added : now compatible with 'Woo Order Note template'
                    - Added : RTL Support
                    - Fixed : https problem in preview URL
                    - Updated : Social icons loaded from user's website , not from the CDN
                    - Fixed : Minor bugs

                    ---------------------

                    Version 1.6.1 | 23.10.2018
                    - Fixed : Templates tabs do not working properly.

                    ---------------------

                    Version 1.6 | 22.10.2018
                    - Added : Replace Email turn on/off feature
                    - Added : Email Preview functionality
                    - Added : Added time for the created date column in the 'My templates' tab.
                    - Added : now compatible with Instamojo
                    - Fixed : Minor bugs
                    - Fixed : Left panel switcher button
                    - Fixed : Mozilla browser bugs
                    - Fixed : bugs in woo 2.6 version

                    ---------------------
                    Version 1.5 | 03.10.2018
                    - Added : Flexible Woocommerce Checkout Field Editor compatible
                    - Added : WooCommerce Sequential Order Numbers Pro compatible
                    - Fixed : Minor bugs

                    ---------------------

                      Version 1.4 | 26.09.2018
                      - Added : Support 'Flexible Checkout Fields for WooCommerce' plugin
                      - Fixed : Send Test email bugs fixed
                      - Fixed : Removed other plugins admin notices from builder interface
                      - Fixed : CSS improvement in the builder interface
                      - Fixed : Minor bugs

                      ---------------------

                      Version 1.3 | 11.09.2018
                      - Added : 'Customer Note' email type
                      - Added : New selectors for adding custom CSS
                      - Fixed : Custom CSS bugs
                      - Fixed : Minor bugs

                      ---------------------

                      Version 1.2 | 11.09.2018
                      - Added : Custom CSS option.

                      ---------------------

                      Version 1.1 | 10.09.2018
                      - Added : Support custom fields ( 'WooCommerce Checkout Field Editor' )
                      - Added : 'Reset Password' & 'New Account' email types
                      - Added : New Short codes ( ec_woo_user_id, ec_woo_user_activation_link , ec_woo_user_password_reset_url , ec_woo_user_account_url , ec_woo_user_password )
                      - Added : SKU settings
                      - Added : Unlimited custom code. The users can create unlimited custom code
                      - Fixed : Minor bugs

                      ---------------------

                      Version 1.0.3 | 25.08.2018
                      - Fixed : Minor bugs

                      ---------------------
                      Version 1.0.2 | 23.08.2018
                      - Fixed : showing the 'Please wait' message and nothing happen. Now fixed.

                      ---------------------
                      Version 1.0.1 | 14.08.2018
                      - Fixed methods which have conflicts with other plugins
                      - Added .po file for translate

                      ---------------------

                      Version 1.0 | 27.07.2018
                      - Initial Release