Met de Akismet API is het mogelijk om spam te detecteren en zo te voorkomen dat het in de mailbox terecht komt.

Op basis van alle berichten die Akismet binnen krijgt wordt bepaald welke berichten, afzenders, teksten, enz. vermoedelijk Spam zijn. De Akismet plugin in nodum biedt de mogelijkheid informatie bij Akismet aan te leveren, waarop Akismet een true of een false teruggeeft. Een true houdt in dat je vermoedelijk met Spam te maken hebt, en kan je dus doen besluiten een bericht te weigeren (of met een spam-notitie af te handelen). Indien er Spam wordt gedetecteerd dan kan er bijvoorbeeld ook een captcha worden getoond. Dit kan je instellen om te voorkomen dat wel gewenste personen niet meer een reactie kunnen achter laten met jouw reactieformulier.

In 3 makkelijke op een volgende stappen voeg je Akismet toe. Deze drie stappen werken voor de meeste API's binnen nodum hetzelfde. Eerst een API-key bij de softwareleverancier ophalen, die toevoegen in de configuratie en dan in de code de API aanroepen. Op de website van Akismet kan je gratis een API key aanmaken. De website van Akismet kan je hier vinden.

Als je deze hebt voeg je dit toe in je configuratie van je project. Je kunt dit vinden onder instellingen (meest linkse kolom en dan in het "general" bestand)

[akismet]
    apikey        = 'e4blab874nknds'
    commenttype   = 'contact-form' 
    ; Either: comment / forum-post / blog-post / contact-form / tweet

Nadat je de juiste API-key in de configuratie hebt toegevoegd, kan nodum verbinding maken met de techniek van Akismet. Je hebt een koppeling gelegd. De laatste stap is om deze koppeling aan te roepen in de code. Hieronder zie je daar een voorbeeld van.

{% if api.Akismet_isSpam('Hey, bellen jullie mij terug?', 'Wietse Wind', 'test@wietse.com') %}
    <p class="alert alert-rood text-center">
        Dit is waarschijnlijk Spam!
    </p>
{% else %}
    <p class="alert alert-groen text-center">
        Bedankt voor je reactie.
    </p>
{% endif %}

Met de update van versie 2.1.4 geeft nodum je al een suggestie van de argumenten die horen bij api.Akismet_isSpam.
Je krijgt dan api.Akismet_isSpam( string text, string author, string authorMail, string type ) te zien. Zo zien je dat je 3 argumenten kunt invullen in een vaste volgorde. Eerst de tekst 'Hey bellen jullie mij terug' dan de afzendersnaam en als laatste het e-mailadres van de afzender.

Wil je weten hoe deze API werkt lees hier dan meer over in de blogpost op onze commmunity.