MyListing | WooCommerce Email Templates

The {CODICTS} MyListing | WooCommerce Email Templates plugin lets you create fully custom HTML email templates for both MyListing theme notifications and WooCommerce transactional emails. Instead of editing theme template files directly, you design email templates in a built-in code editor with syntax highlighting, use simple

placeholders for dynamic content, and the plugin compiles and deploys the finished templates automatically.

Templates are assigned directly from MyListing’s notification settings page or WooCommerce’s email settings page — the plugin injects a dropdown selector into each, so you never leave the familiar settings interface.

Installation & Activation

Start by downloading the plugin from the Downloads page on your dashboard on the CoDicts website.

After downloading, install and activate the plugin in WordPress by navigating to “Plugins” > “Add New” > “Upload Plugin” and selecting the downloaded zip file. Click “Install Now” and then “Activate”.

On activation, the plugin adds an “Email Templates” menu item in the admin sidebar with the CoDicts {C} icon. It also deploys any previously saved template assignments to the child theme.

Key Features

How It Works

The plugin works in three stages:

1. Create a template — You write an HTML email template in the built-in code editor, using [tag] placeholders for dynamic content like [reciever-name] or [listing-name].

2. Assign the template — From MyListing’s notification settings or WooCommerce’s email settings, you select your template from a dropdown that the plugin injects into the settings page.

3. The plugin compiles and deploys — When you save settings, the plugin replaces all [tag] placeholders with the appropriate PHP code and writes the compiled template file to the child theme directory. MyListing and WooCommerce then automatically use your custom template when sending emails.

For example, you write:

<h1>Hi [reciever-name],</h1>
<p>Your listing <a href="[listing-url]">[listing-name]</a> has been updated.</p>

And the recipient receives:

<h1>Hi John,</h1>
<p>Your listing <a href="https://example.com/listing/sunrise-cafe">Sunrise Café</a> has been updated.</p>

Accessing the Email Templates Manager

1. In the WordPress admin sidebar, click “Email Templates” (identified by the CoDicts {C} icon).

2. This displays the template list table showing all created templates with their title, type, author, and date.

Alternatively, go to Plugins → Installed Plugins, find the plugin, and click the Settings link.

Creating a New Email Template

1. From the Email Templates list page, click “Add New”.

2. Enter a title for your template (e.g., “Custom Welcome Email”).

3. Select the Template Type:

4. The available tags update based on the selected type — MyListing tags or WooCommerce tags are shown above the editor.

5. Write your HTML email content in the CodeMirror code editor. Use the [tag] placeholders shown above the editor for dynamic content.

6. Click Save.

Important: The template type cannot be changed after the template is first saved. Create a new template if you need a different type.

Editing an Existing Template

1. From the Email Templates list page, click the template’s title or the Edit link in the row actions.

2. Modify the title or HTML body as needed.

3. Click Save.

If this template is currently assigned to a notification, the compiled file in the child theme is automatically regenerated.

Duplicating a Template

Click the Duplicate button in the Status sidebar (when editing) or the Duplicate link in the row actions on the list page. A copy is created with _copy appended to the title. The duplicate is independent — changes to one do not affect the other.

Deleting a Template

Click the Delete button in the Status sidebar (when editing) or the Delete link in the row actions. For bulk deletion, check multiple templates and select Delete from the Bulk Actions dropdown. When a template is deleted, its compiled file is also removed from the child theme — the notification reverts to the default email template.

Assigning Templates to MyListing Notifications

1. Navigate to Starter Theme → Settings → Notifications (MyListing’s settings page).

2. For each notification type (e.g., “Listing Submitted,” “Listing Approved”), a dropdown selector appears below the enable/disable toggle.

3. The dropdown lists all templates of type My Listing.

4. Select a template to assign it to that notification. The dropdown is only visible when the notification is set to “enabled.”

5. Click Save Changes.

The plugin compiles and deploys the template file to the child theme. The next time that notification fires, your custom template is used.

Assigning Templates to WooCommerce Emails

1. Navigate to WooCommerce → Settings → Emails.

2. Click on a specific email type (e.g., “New order,” “Processing order”).

3. A new row appears in the email settings with a template dropdown listing all templates of type WooCommerce.

4. Select a template and click Save changes.

Note: When a WooCommerce email template is assigned, the plugin automatically forces the “Email type” to HTML and disables the email type selector, because custom templates require HTML mode.

Reverting to the Default Template

To revert any notification to its default template, go to the notification’s settings page, change the template dropdown back to “– Select A Template –“, and save. The compiled file is removed and the default template is used.

Using Template Tags

Template tags are placeholders written as [tag-name] in your template body. At compile time, they are replaced with PHP code that outputs dynamic content. For example:

<h1>Hello [reciever-name],</h1>
<p>Your listing <a href="[listing-url]">[listing-name]</a> has been updated.</p>

Available tags are displayed above the code editor and update based on the selected template type (My Listing or WooCommerce).

Note: The tag names [reciever-email] and [reciever-name] use this exact spelling. The plugin will not recognize [receiver-email] with an “i.”

Using Conditional Tags

Conditional tags let you show content only when certain conditions are met. They use an opening [tag] and closing

syntax:

[claim-status-approved]
<p>Your claim has been approved! 🎉</p>
[/claim-status-approved]

[claim-status-declined]
<p>Unfortunately, your claim has been declined.</p>
[/claim-status-declined]

The content between the tags only renders when the condition matches (e.g., claim status is “approved”).

Using PHP in Templates

For advanced customization, you can embed raw PHP directly in your templates:

<p>Current date: <?php echo date('F j, Y'); ?></p>
<p>Site name: <?php echo get_bloginfo('name'); ?></p>

Important: Because templates support raw PHP, only trusted administrators should have access to create or edit templates.

MyListing Template Tags

MyListing Conditional Tags

[claim-status-approved] [/claim-status-approved]

[claim-status-pending] [/claim-status-pending]

[claim-status-declined] [/claim-status-declined]

<h1>Great news, [reciever-name]!</h1>
<p>Your listing <strong>[listing-name]</strong> has been approved and is now live.</p>
<a href="[listing-url]" class="mbtn mbtn1">View Your Listing</a>