Skip to content

Advanced configurations

Setup inbound emails

This additional step allows you to have one mailbox for each group so members can post by email to create discussions and reply to discussions emails to create new comments.

Note

Inbound email support is experimental but in use on several instances. You might however experience bugs, please report them if it happens to your installation.

  • You need an email address on a server with imap support. It must either be a catch all on a subdomain (or even on a domain) or a server supporting "+" addressing (gmail for example allows this).
  • You need the php imap extension
  • Configuration happens in your .env

Let's say you installed Agorakit on agora.example.org :

  • Create a catchall mailbox on * .@agora.example.org
  • Edit your .env file and add/define the following settings:
# Inbox mail box server settings, use for incoming emails.
# Set INBOX_DRIVER to null to disable this feature
INBOX_DRIVER=imap
INBOX_HOST=yourmailhost.tld
INBOX_USERNAME=username of the mailbox
INBOX_PASSWORD=password of the mailbox
INBOX_PREFIX=
INBOX_SUFFIX=@agora.example.org

Definign prefixes and suffixes

You need to fill prefix and suffix. Two cases there :

  • For a catch all there is no prefix. The suffix in the above example would be @agora.example.org . This will create emails like group-slug@agora.example.com

  • On the other hand if you use "+" addressing (a gmail box for instance, let's call it agorakit@gmail.com),

    • prefix will be agorakit+
    • suffix will be @gmail.com

    This will create emails like agorakit+group-slug@gmail.com

If you enable inbound email, the mailbox will be automatically checked and processed email will be put in a "processed" folder under INBOX. Failed emails will be similarly put a "failed" folder under INBOX for inspection.

External authentification

Info

External authentification has been removed. I have fery few (if any) people ask for it. It is a privacy invading feature so no developement has been done on ths front. Feel free to submit PR if you want this.