Configuration

Configuration manual for PageSeeder

Incoming emails

Incoming emails trigger specific operations in PageSeeder.

Incoming email domain

By default, PageSeeder will process incoming emails from the domain defined by the emailDomain property in the  template properties. If the emailDomain property is set to "pshosts", PageSeeder will process any incoming email from hosts.

For information for the sender email domain see From address.

Recipients

Valid PageSeeder recipients must match the incoming email domain defined above and their local part (i.e. the part before the '@') must match one of these values:

  • [group_name]
  • [uri_id]-[fragment]
  • [comment_id]-reply
  • [group_name]//returned

Switches

A number of switches can be used to change how incoming emails are processed. Switches are appended to the normal recipient and all start with '--'.

  • --announce will cause the email to sent to all members regardless of their notification settings
  • --silent will prevent the email from being sent to anyone in the group, but will still be recorded as a comment in the group
  • --preserve will prevent PageSeeder from using the new-comment template and will forward the email verbatim to group members.
  • --announce--preserve combines the announce and preserve switches
  • --noreply ignore the email regardless of prefix

Group comments

All groups have a group email address defined as:

[group_name]@[incoming_domain]

When incoming emails arrive at this address, the email is considered to be a general comment for that group. It is sent to all members of the group who have elected to receive emails and is processed by PageSeeder using the new-comment email template.

If the group name specified in the email address does not match a valid group name, a delivery error is sent back to the sender.

Summary of group email recipients

ProcessingEmail address
Normal[group_name]@[incoming_domain]
Silent[group_name]--silent@[incoming_domain]
Announce[group_name]--announce@[incoming_domain]
Preserve[group_name]--preserve@[incoming_domain]
Announce & preserve[group_name]--announce--preserve@[incoming_domain]

 

Document comments

Comments on a specific document instead of a general comment on the group have the following format:

[uri_id]-[fragment]@[incoming_domain]

The URI ID must be a number corresponding to a valid document. 

Replies

Replies to comments, workflow and edit notes have the following format:

[comment_id]-reply@[incoming_domain]

The comment ID must be a number corresponding to a valid comment, workflow and edit note. Otherwise a delivery error is sent back to the sender.

Note

If a comment belongs on multiple groups, replies to that comment are automatically posted on all these groups.

Group returned address

Any incoming email arriving at:

[group_name]//returned@[incoming_domain]

Will automatically be forwarded to the mailReturnedAddress defined in the group properties of that group.

Postmaster

The default Sender for emails sent by PageSeeder is

pageseeder@[incoming_domain]

Note

Replying to this address has no effect - the email is automatically ignored by the mail server. 

Ignored recipients

The following recipients are always ignored:

error@[incoming_domain]
email_suppressed@[incoming_domain]
no_email@[incoming_domain]

As well as any recipient ending with --noreply

Delivery error

Any incoming email that is not a valid PageSeeder email recipient will return an email to the sender coming from pageseeder@[outgoing_domain].

Created on , last edited on