[Koha-bugs] [Bug 36115] New: Improve documentation for Return-Path (branches.branchreturnpath)

[bugzilla-daemon at bugs.koha-community.org]

https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=36115

            Bug ID: 36115
           Summary: Improve documentation for Return-Path
                    (branches.branchreturnpath)
 Change sponsored?: ---
           Product: Koha
           Version: master
          Hardware: All
                OS: All
            Status: NEW
          Severity: enhancement
          Priority: P5 - low
         Component: Documentation
          Assignee: koha-bugs at lists.koha-community.org
          Reporter: magnus at libriotech.no
        QA Contact: testopia at bugs.koha-community.org

I am not sure if the code or the documentation is the problem here, but let's
start with the documentation. 

For reference, the manual says this today: 

Email: the email address field is not required, but it should be filled for
every library in your system
 - Note: Be sure to enter a library email address to make sure that notices are
sent to and from the right address
 - Note: If no email address is entered here, the address in the
KohaAdminEmailAddress system preference will be used to send notices from this
library

Reply-To: you can enter a different ‘Reply-To’ email address. This is the email
address that all replies will go to.
 - Note: If no email address is entered here, the address in the ReplytoDefault
system preference will be used to receive replies to this library

Return-Path: you can enter a different ‘Return-Path’ email address. This is the
email address that all bounced messages will go to.
 - Note: If no email address is entered here, the address in the
ReturnpathDefault system preference will be used to receive bounced messages
from this library.

https://koha-community.org/manual/latest/en/html/administration.html#adding-a-library

Mu scenario is as follows: We host Koha for a number of libraries that want to
send messages to their patrons by email. For some libraries we can't send email
through their SMTP for different reasons. So we set up a noreply address with a
domain that we control, so that we can use that as the sender of the emails,
and we can do our best to set up SPF, DKIM etc for it, so it won't be seen as
spam by services such as Gmail. 

Based on the description above, I set it up like this: 

Email = noreply
Reply-To = real library email
Return-Path = real library email

But it turns out that when postfix was processing the email, and passing it on
to our SMTP server, it was seeing the "real library email" from the Return-Path
setting as the "from" address, not the "noreply" address that we wanted it to
see. 

So the question is: 
- Is the code wrong in using the Return-Path address as the "from" address? 
- Or is the documentation wrong in saying that the Return-Path is just for
bounced messages? 

See also: Bug 28729 - Return-path header not set in emails

-- 
You are receiving this mail because:
You are the assignee for the bug.
You are watching all bug changes.