# HG changeset patch # User Paul Boddie # Date 1391213847 -3600 # Node ID e33539cc607c0ada87c1173b1d523623f0b5e650 # Parent 4974bff0308777ebe0fffe70149613f53c79ca14 Added documentation about relaying incoming messages along with a related page. diff -r 4974bff03087 -r e33539cc607c README.txt --- a/README.txt Sat Feb 01 01:04:25 2014 +0100 +++ b/README.txt Sat Feb 01 01:17:27 2014 +0100 @@ -198,6 +198,26 @@ added to this mapping and specify the same relaying user; there is no restriction on each fingerprint needing to map to a different user. +The Relaying User and Incoming Messages +--------------------------------------- + +The relaying user may also be configured to accept incoming messages for +routing to remote recipients. + +Firstly, a home page must be defined for the relaying user, and a suitable +template is provided in the resource_pages directory as the RelayingUser file. + +Secondly, a user actions definition for the user should be added to the user +actions mapping (described below), allowing the relaying user to write to the +message store associated with the user's home page. For example: + + RelayingUser:: store:RelayingUser + +Upon receiving an incoming message directed towards a known remote recipient, +the message will be placed in the message store for the relaying user, and +this store will then act as a queue for the dispatch of these messages to +remote sites. + The Username-to-Actions Mapping ------------------------------- diff -r 4974bff03087 -r e33539cc607c resource_pages/RelayingUser --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/resource_pages/RelayingUser Sat Feb 01 01:17:27 2014 +0100 @@ -0,0 +1,3 @@ +#acl RelayingUser:read,write All: + +This is the relaying user's placeholder page for !MoinMessage.