Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

The plugin has three config options that you probably want to manually configure in your conf/local.protected.php. Here's an example:

$conf['authtype'] = 'authimap2';
$conf['plugin']['authimap2']['server'] = '{mail.example.com:993/imap/ssl}INBOX';                                   
$conf['plugin']['authimap2']['domain'] = 'example.com';                                                                 
$conf['plugin']['authimap2']['usedomain'] = 1;

The server setting requires a imap_open mailbox string. Here are a couple of examples:

• connect to an IMAP server running on port 143 on mail.example.com:
  {mail.example.com:143}INBOX
• connect to a POP3 server on port 110 on mail.example.com:
  {mail.example.com:110/pop3}INBOX
• connect to an SSL IMAP server:
  {mail.example.com:993/imap/ssl}INBOX
• connect to an SSL POP3 server with a self-signed certificate:
  {mail.example.com:995/pop3/ssl/novalidate-cert}

The domain setting is the E-Mail domain all your users use (the part after the @-character).

Enable the usedomain setting if users log in with their full email address instead of the local part only at your mailserver. Logins at DokuWiki always use the local part only.

• 2017-09-06
  • Initial release