217

Product support

Get help in the plugin support forum.

Categories

Features

This plugin can be used as a shared webmail client for your team or to convert mails for use in another plugin (e.g. as part of a support desk or CRM like my CRM plugin).

STATUS FEATURE
YES COMPOSE (HTML) MAIL
YES REPLY TO (HTML) MAIL
YES SAVE A COPY OF SENT MAILS ON THE MAILSERVER
YES USE OCTOBER CMS MAIL TEMPLATE (briddle.mail::mail.message)
YES LIMIT FETCHING MAIL TO X DAYS
YES ADDING A SIGNATURE
YES CONTENT TEMPLATES
YES MULTILINGUAL
YES PERMISSIONS
YES EXTENDABLE USING EVENTS

Please note that this plugin is not intended to be a full featured Webmail client (e.g. it lacks the ability to save drafts, delete messages, handle attachments and CC/BCC/Forward messages).

Installation

To install from the Marketplace, click on the "Add to Project" button and then select the project you wish to add it to before updating the project in the backend of your website to pull in the plugin.

To install from the backend, go to Settings -> Updates & Plugins -> Install Plugins and then search for Briddle.Mail.

Like this plugin?

If you like this plugin, you can help me to develop it further, provide support for it or make new plugins by making a donation with PayPal (left side of the page) or giving this plugin a good review :).

My other plugins include:

Inbox

Hello, I am Wiego Bergsma. Please start by reading the whole documentation! If you have any questions, find a bug or experience difficulties getting the plugin to work please use the Support Forum. Only leave a Review if you are happy with the plugin or are still unhappy with the plugin after reaching out to me in the Support Forum. Thank you! Wiego

Getting started

This plugin requires the PHP IMAP Extension (see bottom of this page)

  1. Install Briddle.Mail
  2. Go to Settings > Mail > Webmail
  3. Provide the credentials to your mail server and other settings

Settings (Settings > Mail > Webmail)

Please see IMAP documentation to find the correct settings for your server.

A mailbox name consists of a server and a mailbox path on this server. The special name INBOX stands for the current users personal mailbox. Mailbox names that contain international characters besides those in the printable ASCII space have to be encoded with imap_utf7_encode().

The server part, which is enclosed in '{' and '}', consists of the servers name or ip address, an optional port (prefixed by ':'), and an optional protocol specification (prefixed by '/').

The server part is mandatory in all mailbox parameters.

All names which start with { are remote names, and are in the form "{" remote_system_name [":" port] [flags] "}" [mailbox_name] where:

  • remote_system_name - Internet domain name or bracketed IP address of server.
  • port - optional TCP port number, default is the default port for that service
  • flags - optional flags, see following table.
  • mailbox_name - remote mailbox name, default is INBOX

More info

Mailbox example

{imap.vevida.com:993/imap/ssl/novalidate-cert/debug}INBOX

or (non-SSL):

{imap.vevida.com:143/imap}INBOX

Sent folder example

{imap.vevida.com:993/imap/ssl/novalidate-cert/debug}Sent

Username example

user@domain.com

Mail template for outgoing mail

A mail template called briddle.mail::mail.message should have been automagically created for you using {{ content|raw }} for its content.

Extending this plugin using events

This plugin uses the briddle.mail.sent event to make the to, subject, content and action fields available to your plugin when sending mail.

Event::listen('briddle.mail.sent', function($to,$subject,$content,$action) {
    if(null!==$action && $action=='mail') {
        Log::info($subject);
    }
});

This plugin uses the briddle.mail.extendPopupView view event to allow your plugin to inject additional buttons into the HTML of the popup form for sending mails.

Event::listen('briddle.mail.extendPopupView', function($controller) {
    return '<button type="submit" name="action" value="task" class="btn btn-default">Convert to task</button>';
});

Installing PHP IMAP extension

If the PHP IMAP extension is not installed you can try the following from the console (this assumes PHP 7):

yum install sclo-php70-php-imap
sudo systemctl restart httpd
1.1.5

Bugfix in handling corrupted time parameters

Aug 21, 2019

1.1.4

Automagically generate mail template

Aug 21, 2019

1.1.3

Provided better IMAP feedback for errors and a check for IMAP support

Aug 21, 2019

1.1.2

Added user friendly mail authentication handling

Mar 05, 2019

1.1.1

Added permission to configure mail

Dec 13, 2018

1.1.0

Added content templates

Dec 12, 2018

1.0.8

Bugfix in reading malformed multipart mails.

Dec 11, 2018

1.0.7

Bugfix in reply mail.

Dec 11, 2018

1.0.6

Update of the handling of briddle.mail.sent and briddle.mail.extendPopupView event.

Dec 10, 2018

1.0.5

Handling of briddle.mail.sent and briddle.mail.extendPopupView event.

Dec 10, 2018

1.0.4

Bugfix closing IMAP when composing new message.

Dec 10, 2018

1.0.3

Added signature.

Dec 10, 2018

1.0.2

Added info about original mail in reply, disabled visual hints in TinyMCE, made TinyMCE toolbar editable, moved plugin config to Mail category, added briddle.mail.sent event.

Dec 10, 2018

1.0.1

Initialize plugin.

Dec 08, 2018