Extensions Wiki » Extensions » MailArchive Application

MailArchive Application

Last modified by Manuel Smeria on 2014/01/21 12:34
email_addAn application to manage a mail archive inside XWiki
TypeXAR
Developed by

Jeremie Bousquet

LicenseGNU Lesser General Public License 2.1
Compatibility

Tested on XWiki Enterprise 4.4.1

Installable with the Extension Manager

View Source

Download v0.2

Description

Foreword

This application allows to persist emails read from configured server(s) into XWiki pages.

  • This component is still in BETA stage
  • Use it with caution and expect big api breakages until version 1.0 is reached
  • This application is far from final and not everything works
  • When upgrading to next versions of this application you may have to purge all mails that were persisted as there might not be an automated migration procedure

If you still want to test take a look at it and maybe contribute to make the final version better. Please continue reading ! emoticon_smile

Introduction

This application allows managing a mail archive into XWiki and offers the following possibilities:

  • ADMINISTRATE: configure connections to mail servers, mailing-lists, mail types, parameterize the way emails are stored and presented, etc.
  • OPERATE: based on what is configured, allows you to create loading sessions, automate them, debug them, etc.
  • CONSULT: for end-users, various screens allow to navigate loaded emails (something close to famous nabble, markmail, and so on...)
  • It is highly recommended that you read the Documentation before installing and using this application
  • This is not the kind of application that can be used without initial configuration, using only default values emoticon_wink

The Design page can also be interesting reading and gives more details about the development progress and link to the JIRA project.

To know what is already implemented, what to expect to work and what is known not to work at all, please consult the release notes of each version below.

Screenshots

It would be too long to list all of the available screens, so here are some basic screenshots. You should consult the Documentation for more details.

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager).

You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions

Once the XAR file is imported proceed to MailArchive.Admin.

Release Notes

v0.2

Bugs

  • Closed XMAILARCH-4 Not possible to specify per-server network proxy
  • Closed XMAILARCH-8 Many UIs do not manage properly "mail type" multi-valued field
  • Closed XMAILARCH-9 MailClassSheet uses wrong local url to retrieve emails information
  • Closed XMAILARCH-10 User Guide screenshots are not the correct ones
  • Closed XMAILARCH-11 Topics page are created with wrong parent
  • Closed XMAILARCH-16 Tags assigned to pages for mail types use "name" instead of "display name" value
  • Closed XMAILARCH-18 Feeds Generator is broken
  • Closed XMAILARCH-19 Manage multiple types for an email
  • Closed XMAILARCH-21 Avatar photo of mail author in forum view is not properly resized
  • Closed XMAILARCH-22 "<<invalid content>>" in forum view mails content
  • Closed XMAILARCH-27 UI does not manage correctly "From" fields not containing "Personal" part
  • Closed XMAILARCH-30 Topics Assignment: incorrectly manage mail related to existing topic but having empty reply-to-id and topic id (and non-empty refs)

Improvements

Tasks

  • Closed XMAILARCH-1 Add possibility to specify network proxy for mail servers connection
  • Closed XMAILARCH-24 Migrate to recent version of xwiki, and maintain version compatible with 3.5.1 in a dedicated branch

Known Issues on JIRA

v0.1

First (beta) release:

  • What you can expect to WORK:
    • You should be able to configure servers, mailing-lists and mail types
    • You should be able to download emails and have them persisted in XWiki
    • You should be able to browse the archive, the topics, and the emails
  • What will NOT work:
    • Display of emails details/headers is broken
    • Statistics may be broken or feel unfinished
    • Some options/objects in administration part may not be saved when required, so you might have to use "edit objects" on conf pages to force saving of needed values
    • Sometimes, parsing of emails break depending on email content, so some mails may not be loaded properly
    • Loading UI is unfinished, and for now it's not possible to automate email loading using XWiki scheduler
    • TimeLine view does not work
    • The "Feeds Generator" does not use configured types, but a built-in list not matching anything useful. By the way, in fact, the "Feeds Generator" is mostly broken
    • See open issues in JIRA project
    • There may be quite a few others I don't know or remember ...

Dependencies

  • org.xwiki.contrib.mailarchive:xwiki-contrib-mailarchive-api 0.2
  • coldserenity:tabs-macro 1.0.1
Tags:
Created by Jeremie Bousquet on 2012/09/14 12:44

Download XWiki

Get Connected