Je filters als Sieve-script bekijken, downloaden en terugzetten

De filters die je in de webmail maakt, bewaart de mailserver als één tekstbestand: een Sieve-script. Dat script kun je bekijken, als bestand downloaden en later weer terugzetten. Handig als back-up, om te begrijpen wat je filters precies doen, of om je filters mee te nemen naar een andere mailbox.

Wat is een filterset?

Je filters draaien niet in de webmail, maar op de mailserver, op het moment dat een bericht in je mailbox wordt afgeleverd. Ze zijn geschreven in Sieve, een eenvoudige taal speciaal voor het filteren van mail. Jij vult in de webmail een formulier in, en de webmail schrijft daar het script van.

Een filterset is dat complete script: alle filters van één mailbox in één bestand. Ook je afwezigheidsbericht staat erin, want dat is technisch gezien ook een filter. Je kunt meer filtersets hebben, maar er is er altijd maar één actief.

Je filterset bekijken

1. Log in op de webmail en klik in het menu op Instellingen en dan op Filters.
2. Klik op Acties en kies Filterset bewerken.

Je ziet nu het script als tekst. Een voorbeeld zoals de webmail het schrijft:

require ["fileinto"];
# rule:[Nieuwsbrieven]
if exists "List-Id"
{
	fileinto "Nieuwsbrieven";
	stop;
}
# rule:[Facturen]
if allof (header :contains "subject" "factuur")
{
	fileinto "INBOX.Facturen";
}
# rule:[Collega]
if false # header :contains "from" "collega@example.com"
{
	fileinto "INBOX.Team";
}

Zo lees je het:

• require ["fileinto"]; vraagt de server om de uitbreiding die nodig is om mail naar een map te verplaatsen. De webmail zet dit er zelf boven.
• # rule:[Nieuwsbrieven] is een opmerking met de naam van je filter. Daaraan herkent de webmail je filters.
• if exists "List-Id" is de voorwaarde: het bericht heeft een kopregel List-Id, zoals nieuwsbrieven en mailinglijsten.
• fileinto "Nieuwsbrieven"; verplaatst het bericht naar die map. stop; betekent dat de volgende filters niet meer naar dit bericht kijken.
• header :contains "subject" "factuur" is in het formulier Onderwerp bevat factuur. Hoofdletters maken daarbij niet uit.
• if false # ... is een uitgeschakeld filter. De oude voorwaarde staat als opmerking achter #, zodat je het filter later weer kunt aanzetten.

De server leest het script van boven naar beneden. Daarom doet de volgorde van je filters ertoe.

Je filterset downloaden als back-up

1. Ga naar Instellingen > Filters.
2. Klik op Acties en kies Download.

Je krijgt een tekstbestand (.txt) met de naam van je filterset. Bewaar het op een veilige plek. Zo heb je een kopie als je per ongeluk een filter weggooit, en kun je vergelijken als je filters ineens anders werken. Ga je verhuizen naar een andere mailbox of een andere server, download het script dan vóór je de oude mailbox opzegt.

Een script terugzetten

1. Open het bewaarde bestand in een teksteditor, zoals Kladblok of TextEdit, en kopieer de hele inhoud.
2. Ga in de webmail naar Instellingen > Filters > Acties > Filterset bewerken.
3. Selecteer de tekst die er staat, vervang die door de gekopieerde tekst en klik op Opslaan.
4. Kijk in de lijst bij Filters of je filters er weer staan, en stuur jezelf een testmail om te zien of ze werken.

Alles wat er stond, wordt vervangen door het script dat je plakt. Wil je alleen een paar filters terug, kopieer dan alleen die blokken, van de regel # rule:[...] tot en met de sluitende }, en zet ze op de juiste plek in het bestaande script. Staat er in het geplakte deel een uitbreiding die nog niet bij require bovenaan staat, voeg die dan daar toe.

Klopt er iets niet in het script, zoals een ontbrekende puntkomma of accolade, dan wordt het niet opgeslagen en krijg je een foutmelding. Je filters blijven dan zoals ze waren.

Goed om te weten

• Per mailbox. Een filterset hoort bij één mailbox. Heb je meer mailboxen, download dan van elke mailbox het script.
• Alleen nieuwe mail. Een teruggezet filter werkt op mail die daarna binnenkomt. Mail die al in je mailbox staat, verplaats je zelf.
• Afwezigheidsbericht. Staat er in je back-up een afwezigheidsbericht met oude datums, kijk dan na het terugzetten bij Instellingen > Afwezigheidsbericht of het goed staat.
• Voor het hele domein. Wil je iets voor alle mailboxen van je domein regelen, zoals een afzender blokkeren, gebruik dan het onderdeel SPAM Filters in DirectAdmin. Zie Server-side e-mailregels (filters op de server).

De stappen voor een nieuw filter staan in de Roundcube-handleiding bij Een filter maken en Voorbeelden van handige filters. De taal zelf staat beschreven in RFC 5228 (Engels).