wiki:MailArchivePlugin

Version 5 (modified by figaro, 9 years ago) (diff)

Cosmetic changes

Email archive for storing emails in Trac

Description

This plugin adds a new main menu item Mail Archive that can be used to browse and view archived emails and email attachments.

Key features:

  • Import emails to Trac's database from an IMAP account
  • A new mailarchive resource realm
  • mailarchive: wiki links (plus mail:, email:, and emailarchive: synonyms)
  • [[MailQuery(searchterm)]] macro
  • New trac-admin mailarchive fetch command
  • New Trac permission MAIL_ARCHIVE_VIEW
  • Trac Search integration

Known Problems

  • A reset of uids on the IMAP server could lead to problems, eg duplicate / unarchived emails (#11535)

Bugs/Feature Requests

Existing bugs and feature requests for MailArchivePlugin are here.

If you have any issues, create a new ticket.

defect

3 / 6

enhancement

3 / 4

task

0 / 1

Download

Download the zipped source from here.

Source

You can check out MailArchivePlugin from here using Subversion, or browse the source with Trac.

Installation

Installation of the plugin requires the usual step, e.g. easy_install http://trac-hacks.org/svn/mailarchiveplugin/trunk and enable it in Trac's plugin admin page or by adding mailarchive.* = enabled to the [components] section in the trac.ini file.

A database upgrade will be required as usual: trac-admin path-to-your-trac-environment upgrade.

Assign the new MAIL_ARCHIVE_VIEW permission to the appropriate Trac groups / users, eg in Trac's permission admin page.

Additionally you need an email IMAP account that only contains all the emails you want to archive. If you don't already have this, you could create a new separate email account (e.g. trac-archive@example.com) and copy all emails you want to appear in Trac's mail archive to that account.

Actually archiving the emails from that IMAP account into Trac's database must be done separately using a new trac-admin mailarchive fetch <host> <username> <password> command. You should configure (e.g. using a cron job in Unix, or using a scheduled task in Windows) it to be periodically called. Replace <host>, <username> and <password> with your email host, username and password.

Example

Schedule a task to call the following command every 15 minutes: trac-admin path-to-your-trac-environment mailarchive fetch imap.example.com trac-archive@example.com password123

Make sure that the emails to be archived are marked as unread or very recent, ie from today, as only such emails will be considered for archiving.

Recent Changes

17666 by lucid on 2020-01-26 13:08:38
MailArchivePlugin: Python3 compatibility.
(see #13739)
17565 by lucid on 2019-11-18 18:02:16
MailArchivePlugin: Fix DB upgrades: Add upgrades to setup.py / eggs.
(fix #13647)
17557 by lucid on 2019-11-17 09:09:09
MailArchivePlugin: Add comment field and filter UI.

  • Fix Javascript folding (Jinja block head)
  • Bump version to 1.3

(fix #13647)
(fix #13648)

(more)

Author/Contributors

Author: lucid
Maintainer: lucid
Contributors:

Attachments (2)

Download all attachments as: .zip