Virtual Attachments (virtual-attachments) Plugin

The virtual attachments plugin automatically creates an email message in a virtual folder for every attachment that exists in a mailbox.

It is used by OX App Suite if the virtual attachment view has been activated in the software.

Configuration

dovecot.conf

First, you'll have to load the plugin which also requires the virtual plugin to be loaded:

mail_plugins = $mail_plugins virtual virtual_attachments

Namespace

Then, you'll have to create a Namespaces for the virtual-attachments.

namespace virtual {
  prefix = virtual/
  separator = /
  location = virtual:/etc/dovecot/virtual:INDEX=~/virtual
}

namespace virtual-attachments {
  prefix = virtual-attachments/
  separator = /
  location = attachments:~/virtual-attachments

  mailbox virtual/All {
    auto = create
  }
}

For each folder that you want an attachments folder for, you need to create a corresponding folder in the Virtual Attachments namespace. The mailbox names need to match existing real or virtual mailboxes. Those mailboxes will be mirrored below the virtual-attachments namespace. Each of the mirrored mailboxes will contain one mail per attachment found in the referenced mailbox. The virtual-attachments mailboxes can be namespace/mailbox/auto = auto-created.

For example:

• Attachments in INBOX are in virtual-attachments/INBOX
• Attachments in virtual/All are in virtual-attachments/virtual/All

Storage Location With Obox

When using the virtual-attachments plugin with obox, the virtual INDEX location must point to a directory named virtual-attachments in the user home directory.

This way the virtual-attachments indexes are added to the obox root index bundles and will be preserved when user moves between backends or when metacache is cleaned.

location = attachments:~/virtual-attachments

The virtual-attachments indexes & cache will be stored in the user root bundle.

It is possible to disable storing virtual indexes in the user root bundle using metacache_disable_secondary_indexes.