You are viewing a plain text version of this content. The canonical link for it is here.
Posted to server-dev@james.apache.org by er...@apache.org on 2010/12/06 14:16:27 UTC
svn commit: r1042622 -
/james/server/trunk/src/site/xdoc/config-listmanager.xml
Author: eric
Date: Mon Dec 6 13:16:26 2010
New Revision: 1042622
URL: http://svn.apache.org/viewvc?rev=1042622&view=rev
Log:
Add listmanager faq text to conf page.
Modified:
james/server/trunk/src/site/xdoc/config-listmanager.xml
Modified: james/server/trunk/src/site/xdoc/config-listmanager.xml
URL: http://svn.apache.org/viewvc/james/server/trunk/src/site/xdoc/config-listmanager.xml?rev=1042622&r1=1042621&r2=1042622&view=diff
==============================================================================
--- james/server/trunk/src/site/xdoc/config-listmanager.xml (original)
+++ james/server/trunk/src/site/xdoc/config-listmanager.xml Mon Dec 6 13:16:26 2010
@@ -25,8 +25,21 @@
<body>
+<p>
+ <div class="ui-widget">
+ <div class="ui-state-error ui-corner-all" style="padding: 0 .7em;">
+ <p><span class="ui-icon ui-icon-alert" style="float: left; margin-right: .3em;"></span>
+ <strong>This page still contains text related to James 2.3 and needs to
+ be updated for James 3.0</strong>
+ </p>
+ </div>
+ </div>
+</p>
+
<section name="List Manager Configuration">
+ <subsection>
+
<p>Consult <a href="https://svn.apache.org/repos/asf/james/server/tags/james-server-3.0-M2/container-spring/src/main/config/examples/james-listmanager.xml">james-listmanager.xml</a> in SVN to get some examples and hints.</p>
<p>One of the frequent questions on the James-User Mailing List is how
@@ -43,41 +56,7 @@
<i>transport</i> processor), the repository goes into the
<users-store> block.</p>
- <subsection name="Setting up the Mailets">
-
- <p>You need to setup two mailets.</p>
-
- <p>The first mailet that you need to setup is an instance of the <a
- href="dev-provided-mailets.html#AvalonListservManager">Avalon Listserv
- Manager</a> mailet. This will handle subscribing and unsubscribing.
- [Note: the current code does not support confirmed opt-in, just basic
- commands.] The <a
- href="dev-provided-matchers.html#CommandForListserv">CommandForListserv</a>
- matcher is used to invoke match messages containing commands for the
- mailing list.</p>
-
- <p>The second mailet is an instance of the <a
- href="dev-provided-mailets.html#AvalonListserv">Avalon Listserv</a>
- mailet. That mailet actually receives messages for the list and
- causes them to be distributed. The <a
- href="dev-provided-matchers.html#RecipientIs">RecipientIs</a> matcher
- is used to match messages intended for the mailing list.</p>
-
- <p>The following illustrates the two <mailet> elements that need to be added:</p>
-
- <source>
-<mailet match="CommandForListserv=<i>list-name</i>@<i>domain</i>"
- class="AvalonListservManager">
- <repositoryName><i>list-name</i></repositoryName>
-</mailet>
-
-<mailet match="RecipientIs=<i>list-name</i>@<i>domain</i>" class="AvalonListserv">
- <repositoryName><i>list-name</i></repositoryName>
- ... list options ...
-</mailet>
- </source>
-
- </subsection>
+ </subsection>
<subsection name="Setting up the Repository">
@@ -113,6 +92,56 @@
<destination URL="file://var/lists/<i>list-name</i>/" />
</repository>
</source>
+
+ </subsection>
+
+ <subsection name="Alternate Explanation">
+
+ <p>James currently includes only the most basic list functionality, users can subscribe and unsubscribe, but there is no moderation of messages or subscriptions</p>
+ <p>To enable a list you need the following in config.xml in the root processor block and above the final mailet block -</p>
+ <source>
+<mailet match="CommandForListserv=james@localhost"
+ class="AvalonListservManager">
+ <repositoryName>list-james</repositoryName>
+</mailet>
+</source>
+ <p>that will intercept the command emails sent to
+<ul>
+ <li>james-on@localhost to subscribe the sender</li>
+ <li>james-off@localhost to unsubscribe the sender</li>
+ </ul>
+ </p>
+ <p>and-</p>
+ <source>
+<mailet match="RecipientIs=james@localhost" class="AvalonListserv">
+ <membersonly> false </membersonly>
+ <attachmentsallowed> true </attachmentsallowed>
+ <replytolist> true </replytolist>
+ <repositoryName>list-james</repositoryName>
+ <subjectprefix>JamesList</subjectprefix>
+</mailet>
+</source>
+ <p>Which will distribute the mail to the current subscribers</p>
+ <p>in addition to the above you need to have a repository configured in the users-store block(usually near the bottom of config.xml) like so (database)-</p>
+ <source>
+<repository name="list-james"
+ class="org.apache.james.userrepository.ListUsersJdbcRepository"
+ destinationURL="db://maildb/lists/list-james">
+ <sqlFile>file://conf/sqlResources.xml</sqlFile>
+</repository>
+</source>
+ <p>Database users will also need to ensure that they have <a href="2.3.1/using_database.html">configured a data-source</a> named to match the destination URL</p>
+ <p>Using the filesystem:-</p>
+ <source>
+<repository name="list-james"
+ class="org.apache.james.userrepository.UsersFileRepository">
+ <destination URL="file://var/lists/list-james/"/>
+</repository>
+</source>
+ <p>Restart James, send a mail to james-on@localhost and you should be subscribed.</p>
+ <p>The repository, be it a database table or directory in the filesystem will be created automatically.</p>
+ <p>Database users can manipulate the users repository using SQL, and hence any application capable of running SQL queries against it.</p>
+
</subsection>
</section>
@@ -120,7 +149,7 @@
<section name="miResources.xml">
<p>Consult <a href="https://svn.apache.org/repos/asf/james/server/tags/james-server-3.0-M2/container-spring/src/main/config/examples/miResources.xml">miResources.xml</a> in SVN to get some examples and hints.</p>
-
+
</section>
</body>
---------------------------------------------------------------------
To unsubscribe, e-mail: server-dev-unsubscribe@james.apache.org
For additional commands, e-mail: server-dev-help@james.apache.org