Utilizzo di Akismet nei moduli di contatto
Questo testo è stato tradotto automaticamente. Se vuoi visualizzare il testo originale in inglese, fai clic qui.
Akismet è stato creato inizialmente per filtrare lo spam dai commenti del blog, ma può fare lo stesso anche per i moduli di contatto. Se stai sviluppando un modulo di contatto e vuoi integrarlo con Akismet, segui le istruzioni riportate di seguito.
Per prima cosa, leggi la documentazione dell’endpoint API comment-check, quindi applica le seguenti modifiche ai parametri per la tua implementazione:
permalink: Usa l’URL del modulo di contatto.
comment_type: Usa contact_form
comment_author: Se il tuo modulo di contatto ha un campo per il nome completo della persona che lo compila, usalo qui.
comment_author_email: Se il tuo modulo di contatto ha un campo singolo per l’indirizzo e-mail dell’utente, usalo qui.
comment_author_url: Se il tuo modulo ha un campo singolo in cui l’utente può inserire il proprio URL, usalo qui.
Per ogni altro campo del modulo in cui l’utente digita liberamente del testo, invia ciascun campo come parametro a sé, nel formato contact_form_field_fieldname, dove fieldname è una versione normalizzata dell’etichetta del campo. Ad esempio, se hai un campo chiamato “Phone Number” in cui l’utente inserisce 1234567, invia contact_form_field_phone_number=1234567. Un campo chiamato “Where did you hear about us?” verrebbe denominato contact_form_field_where_did_you_hear_about_us.
Se uno dei parametri non è applicabile al tuo modulo, omettilo del tutto anziché inviare un valore vuoto. Ad esempio, se non è presente un campo e-mail, non inviare affatto il parametro comment_author_email.
Importante: non includere nella richiesta contenuti che non siano stati digitati liberamente dall’utente. Ad esempio, le selezioni da menu a discesa e le etichette delle caselle di controllo selezionate devono essere omesse dalla richiesta ad Akismet.
Spam non rilevato e falsi positivi
È importante che il tuo modulo di contatto supporti l’invio di segnalazioni ad Akismet per spam non rilevato e falsi positivi. La tua implementazione dovrebbe salvare la richiesta originariamente inviata all’endpoint comment-check, in modo da poterla riutilizzare a questo scopo.
Quando un invio è contrassegnato come spam, invia nuovamente la richiesta comment-check originale, ma indirizzala all’endpoint submit-spam.
Quando un invio è contrassegnato come falso positivo, invia nuovamente la richiesta comment-check originale, ma indirizzala all’endpoint submit-ham.
Prima del lancio
Prima di rilasciare l’integrazione con Akismet del tuo modulo di contatto, controlla la seguente lista di controllo:
☐ Assicurati che il tuo modulo di contatto consenta all’utente di specificare la propria chiave API Akismet (se la chiave non è predefinita).
☐ Assicurati che il tuo modulo di contatto verifichi che una chiave API fornita dall’utente sia valida al momento dell’inserimento, e solo in quel momento.
☐ Assicurati che il tuo modulo di contatto includa i metadati raccomandati nelle richieste ad Akismet, come indirizzo IP, user agent, referrer e permalink.
☐ Assicurati che il tuo modulo di contatto includa tutti i campi in cui l’utente ha inserito un valore, inviandoli come contact_form_field_[fieldname]
☐ Assicurati che il tuo modulo di contatto non invii ad Akismet campi che non contengono un valore digitato dall’utente.
☐ Assicurati che il tuo modulo di contatto supporti la segnalazione degli invii come spam non rilevato.
☐ Assicurati che il tuo modulo di contatto supporti la segnalazione degli invii come falsi positivi.
Se tutti questi punti sono soddisfatti, complimenti! La tua integrazione è pronta per il lancio.
