Updates the folder input text and adds docs note for how to figure out the folder separator value

This commit is contained in:
Trenton Holmes 2022-03-28 10:21:14 -07:00
parent d4153607c9
commit 035130ecdc
2 changed files with 12 additions and 1 deletions

View File

@ -178,6 +178,14 @@ These are as follows:
automatically or manually and tell paperless to move them to yet another folder automatically or manually and tell paperless to move them to yet another folder
after consumption. It's up to you. after consumption. It's up to you.
.. note::
When defining a mail rule with a folder, you may need to try different characters to
define how the sub-folders are separated. Common values include ".", "/" or "|", but
this varies by the mail server. Unfortunately, this isn't a value we can determine
automatically. Either check the documentation for your mail server, or check for
errors in the logs and try different folder separator values.
.. note:: .. note::
Paperless will process the rules in the order defined in the admin page. Paperless will process the rules in the order defined in the admin page.

View File

@ -119,7 +119,10 @@ class MailRule(models.Model):
_("folder"), _("folder"),
default="INBOX", default="INBOX",
max_length=256, max_length=256,
help_text=_("Subfolders must be separated by dots."), help_text=_(
"Subfolders must be separated by a delimiter, often a dot ('.') or "
" slash ('/'), but it varies by mail server.",
),
) )
filter_from = models.CharField( filter_from = models.CharField(