Documentation

01

Extensions
Parameters
Attach an Email to an Object
Configure a Google API mailbox

Extension Multi SMTP Configuration

DolNexus provides several optional Extensions that extend the core messaging and mail features. Each plugin can be enabled or disabled independently depending on your needs.

Below is a description of each available plugin.

Extension VCalendar Support

Adds support for VCalendar events. This plugin enables the handling and interpretation of VCalendar data inside DolNexus. It allows the system to recognize and process calendar event information received by email. File extension ICS

Typical use cases:

Email invitations
Calendar event attachments
Automatic event recognition from messages

Email Invitation

This feature only works if the default Dolibarr email sending configuration is enabled. The invitation is sent to the user (and therefore their email address) who creates the event in the calendar.

Calendar

To create an invitation, which is automatically sent by email, you must select a third party and/or contact who has a configured email address. When creating the event, you must select the type: Meeting

The email sent can be customized using email templates. In this case, you need to create an email template with the code: VCALENDAR_INVITATION

You can obtain the following override parameters:

__VCALENDAR_TITLE__: Subject
__VCALENDAR_DATE_START__: Start date/time
__VCALENDAR_DATE_END__: End date/time
__VCALENDAR_LOCATION__: Meeting location
__VCALENDAR_ORGANIZER__: Your name

Extension Multi Mailboxes Support

Allows multiple mailboxes per user and per group. This extension adds the ability to configure and use several email mailboxes for a single user or a user group.

Typical use cases:

Shared support inboxes
Multiple role-based mailboxes
Department mail accounts

Extension Multi SMTP Configuration

Multi-SMTP management. This plugin allows configuration and selection of multiple SMTP servers for outgoing emails.

Typical use cases:

Different SMTP per mailbox
Failover SMTP configuration
Per-context SMTP routing

Extension Unread Mail Counter (Cache)

Counts unread emails using a cache mechanism. This plugin maintains a cached counter of unread emails to improve performance and reduce mailbox scanning overhead.

Typical use cases:

Faster unread counters
Reduced IMAP load
Better UI responsiveness

Extension Advanced Configuration Options

Provides additional configuration options. This plugin unlocks advanced DolNexus configuration settings not available in the standard setup screens.

Typical use cases:

Fine tuning
Expert settings
Extended behavior controls

Available configuration options

IMAP read timeout (in seconds) after the negotiation phase.
Default value: 5

IMAP negotiation timeout (in seconds).
Default value: 1

Extension Mail Flag Management

Extended mail flag handling. This plugin enhances the management of mail flags and message status indicators.

Typical use cases:

Custom flags
Extended message state tracking
Advanced filtering support

DolNexus — Dynamic Settings

These dynamic parameters allow administrators to quickly adjust DolNexus behavior without modifying code. Changes apply immediately after update.

IMAP Negotiation Timeout (seconds)

Defines the allowed time for each IMAP negotiation step on the IMAP port.
Default: 1 second
Increase if your mail server responds slowly.

Agenda Action Code

Specifies the action code used when DolNexus creates events in the agenda.
Used for filtering and reporting calendar entries generated by DolNexus.

Messages Visible on Third Parties

Controls whether emails are visible on third-party (customer/supplier) cards.
Improves cross-navigation between messages and business records.

Emails Per Page

Number of emails displayed per page in message listings.
Lower values improve performance on large mailboxes.

Show Emails at Bottom of Listing

Displays the email preview panel below the message list instead of new page view.

Show Pagination Selector

Enables or disables the pagination control in message lists.

AJAX Auto-Refresh Linking

Activates AJAX-based refresh for message linking and UI updates.
Provides smoother interaction without full page reload.

Copy Sent Mail to Sent Folder

Automatically stores sent messages in the corresponding mailbox “Sent” folder.

Send Test Email for Connection Check

Allows sending a test email to validate IMAP configuration.

Compose Using Mail Templates

Enables the use of predefined templates when composing emails.

Replace mailto: Links

Intercepts mailto: links and redirects them to the DolNexus composer instead of the local mail client.

Attach an Email to an Object

DolNexus allows you to attach an email to a Dolibarr object so that it becomes part of its history and can be accessed directly from the object card.

An email can be attached to an object from several places in the interface: from the message list, from the email viewer, or while composing a message.

Supported target objects typically include:

Third parties
Contacts
Projects
Orders
Invoices
Proposals
Contracts

Once attached, the email is visible from the object itself inside the related message tabs. It will become public to all users and listed in the attached email list.

Attach from the Email Listing

You can attach an email directly from the messages listing page. Focus the link to field and start typing the reference you want to attach the mail to.

While typing, Dolnexus will look for reference in any type of objects and will show you a liste like below (the object is prefixed with it’s type) :

Once you have selected an object, you have confirm the attachement by clicking the lock button and also be invited to create an entry within the Agenda Module.

Attach from the Email Viewer

You can attach an email while reading it in full screen mode.

While typing, Dolnexus will look for reference in any type of objects and will show you a liste like below (the object is prefixed with it’s type) :

Once you have selected an object, you have confirm the attachement by clicking the lock button and also be invited to create an entry within the Agenda Module.

Attach While Composing an Email

You can attach an outgoing email to an object at composition time. If the sent mail copy feature is enabled and working, the message will be stored in the Sent folder and can then be attached to the selected object.