Extension:BounceHandler/pt-br

A extensão BounceHandler permite às wikis manipular e-mails devolvidos de forma eficiente, fazendo o seguinte:
 * Generate a VERP "Variable envelope Return-Path" on  email invocations.
 * Bounces can be directly fed to the  API from the MTA using a curl POST request

Usando a biblioteca compositora instalada PEAR mimeDecode para extrair os cabeçalhos de e-mail:

 * Você pode instalar a biblioteca Plancake mail parse para o funcionamento eficaz da extensão BounceHandler. Isso pode garantir que você retire os cabeçalhos corretos do email rejeitado, efetivamente. Você pode instalá-lo da seguinte maneira em

Alternatively, the extension has got its own set of regex functions to extract the e-mail headers, but not recommended for extensive use

Configuração
The extension requires the Mail Transfer Agent (MTA) installed in your mail server to HTTP POST the incoming bounce email to the extension API named as. This can be done by adding the corresponding configurations to your MTA configuration.

Adding bouncehandler router and transport to your exim configuration
You can redirect all your bounce emails to the bouncehandler API directly to do the processing. You can edit your Exim configurations to route all bounce emails to a bounce-handler-router and do HTTP POST to the extension API, which is the recommended method.

Adicione o seguinte em seu arquivo

Under the variable declaration section:

under router configuration:

under transports, we need to write the configuration that would HTTP POST to our bouncehandler API

Encontre mais detalhes aqui.

API
The BounceHandler extesnsion installs an API  to receive the HTTP POST from the mail server. The API has a parameter  to which the entire bounce email is url encoded to. This helps in avoiding the use of a separate bounce collector inbox or other IMAP features for the extension to work.

Example API call:

This would send a bounce email with the body  for processing.

Endereço do VERP
The extension creates a unique VERP address as the Return Path header to every single email send from the wiki installation. The generated VERP address is of the form wiki-testwiki-2a-nanrfx-Tn14EQZWaotS2XNn@verpwebhost.wmflabs.org The general template of the generated VERP address is: $prefix-$wikiName-base36( $userID )-base36( $timestamp )-base64( hash( $algorithm, $key, $prefix ) )@$email_domain