gnu-social

History

Diogo Cordeiro c18f26145c [CORE] Move core plugins to a new modules directory For reference (raised by rozzin in IRC): * http://foldoc.org/module * http://foldoc.org/library * http://foldoc.org/plugin As noted by XRevan86, modules are not necessarily non-essential. As we will keep the modules directory in GS root [therefore, near to plugins/], it is evidenced the difference between both. This is a simple yet fundamental structural change. It doesn't change functionality but makes clearer the way we understand GNU social's internals.		2021-07-16 19:44:33 +01:00
..
lib	plugins onAutoload now only overloads if necessary (extlibs etc.)	2013-08-28 16:10:30 +02:00
locale	[CORE] Move core plugins to a new modules directory	2021-07-16 19:44:33 +01:00
ImapPlugin.php	[VersionBump] 1.19.0, fairly late	2019-06-07 15:02:08 +01:00
README	Add an IMAP daemon so StatusNet can process incoming user posts via catch-all mailbox (in addition to the pre-existing script alias method)	2010-01-08 18:52:43 -05:00

README

The IMAP plugin allows for StatusNet to check a POP or IMAP mailbox for
incoming mail containing user posts.

Installation
============
addPlugin('imap', array(
    'mailbox' => '...',
    'user' => '...',
    'password' => '...'
));
to the bottom of your config.php

Also, make sure:
$config['mail']['domain'] = 'yourdomain.example.net';
is set in your config.php

Create a catch-all account for your domain, and use this account with this
plugin. Whenever a user sends a message to their personal notice posting
address, the message should end up in this mailbox, and then the plugin daemon
will pick it up and post the notice on the user's behalf.

The daemon included with this plugin must be running. It will be started by
the plugin along with their other daemons when you run scripts/startdaemons.sh.
See the StatusNet README for more about queuing and daemons.

Settings
========
mailbox*: the mailbox specifier.
    See http://www.php.net/manual/en/function.imap-open.php for details
user*: username to use when authenticating to the mailbox
password*: password to use when authenticating to the mailbox
poll_frequency: how often (in seconds) to check for new messages