WooCommerce E-Mail Attachment Documentation

[toc]

Introduction

With this WooCommerce extension you can add attachments to the emails generated by WooCommerce. You can attach any file type(s) to your WooCommerce emails and there’s no limitation regarding the number of attachments. You can also add additional CC and BCC recipients to your WooCommerce emails and you can add a notification headline and a notification text to the footer of the emails to make the recipients aware of the email attachments.

Starting with version 3.0 the plugin now recognizes and supports all emails added by WooCommerce plugin. Additional emails generated by WooCommerce extensions are also recognized, if these plugins use and support the WooCommerce email API (i.e. like the subscription or booking extensions).

WPML is supported since version 3.0. You can translate the notification headline and notification text into all
WPML languages and you can select one, more or all languages for each email attachment. Depending on the user-selected
language the corresponding attachment(s) and notification texts are used for the emails.

Installation

  • Unzip and upload the plugin folder to your /wp-content/plugins/ directory
  • Activate the extension through the “Plugins” menu in WordPress
  • Go to WooCommerce -> Settings -> E-Mail Attachments and configure the settings —- or
wc_settings_tab
  • Click the “Settings” – link in the “Plugins” menu and configure the settings

plugins_settings_tab

General Settings Page

The following settings are general plugin settings. Settings concerning emails are used for all emails.

The “Save Changes” button saves all settings (general and email) at once – you don’t need to switch between the option pages/tabs to save all settings.

general_settings_tab
  1. “Delete options on deactivate:” if deactivated (= set by default & default WordPress behavior) all your general settings
    and email settings are saved for the next activation. We recommend to keep this option deactivated. The uploaded attachments are never removed, even if the checkbox
    is checked. To remove the uploaded attachments you have to use the link on the plugin page.
  2. “Delete options on uninstall:” if activated (= set by default & default WordPress behavior) all your general settings
    and email settings are removed. We recommend to deactivate this option, if you intend to reactivate the plugin later and want to keep
    your settings. The uploaded attachments are never removed. To remove the uploaded attachments you have to use the link on the plugin page.
  3. “Upload folder:” You can enter a subfolder located inside the standard WordPress upload folder, where the
    files uploaded with this plugin are stored. You can change this folder at any time, but already uploaded files are not moved to the
    new folder.
  4. “Attachment notification headline:” This text will be added as a notification headline to the footer of
    an email. Leave empty, if you do not want a notification headline. This entry is ignored, if WPML is activated.
  5. “Attachment notification headline with activated WPML :” Translate your notification headline into one of the
    active WPML languages. Depending on the current active language in the frontend the corresponding notification headline will be taken.
  6. “Attachment notification text:” This text will be added as a notification text to the footer of
    an email. Leave empty, if you do not want a notification text. This entry is ignored, if WPML is activated.
  7. “Attachment notification text with activated WPML:” Translate your notification text into one of the
    active WPML languages. Depending on the current active language in the frontend the corresponding notification text will be taken.
  8. “always show the attachment notification:” Activate it, if you want to display notifications (headline and/or text), even if NO attachments are added.

E-Mail Settings Page

The following settings are used for specific types of emails.

The “Save Changes” button saves all settings (general and email) at once – you don’t need to switch between the option pages/tabs to save all settings.

  1. “Select type of E-Mail for settings:” This dropdown list shows all emails registered by the WooCommerce
    email API. Select the email you want to edit and the input fields below will change and show the settings for the selected email.
  2. “CC, BCC:” Add additional recipients. Leave empty if not required. Separate multiple addresses with “,”. WordPress automatically eliminates duplicate email addresses.

Attachment Files Management:

attachment_management

With the “Select files or upload new files” button you can open the WordPress media uploader. Files you
upload are stored in the folder you specified in the upload folder of the settings page and can be filtered (or you can select any of the files of the media gallery):
media_uploader_emails

The uploaded files are part of your media gallery and you can use/embed them anywhere on your website.

The selected files are displayed in the “Selected files” list and you can change the order of the files via drag’n drop.
The files will be attached to the email in the order you specified.

The “Remove” button removes the file only from the list, but it DOES NOT delete them.

When WPML is active, you see a language column with a list of checkboxs for all active languages. Select the language(s) which should use the email attachments. “All” (= checked by default) adds the attachment for all languages. If you deactivate or uninstall WPML, your settings will be preserved and will be active if WPML is activated again.

Deleting Attachments

As attachments become part of the media library, you may use them anywhere on your website as any other media attachment or media file. Therefore you must initiate the deletion of the files manually. Make sure, you are not using them anywhere on your website before doing so, otherwise you might have broken links on your website if you used or embedded the files on your website.

plugins_delete_tab

You must delete the files from the media gallery page, this will give you more control what is actually deleted by WordPress.

Test 3

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.