Home

Blacklist

provvede una blacklist per i destinatari delle Notifiche: se l'indirizzo è in blacklist non vengono inviate notifiche.

Funzioni

#!php

/**
 * indica se l'indirizzo (o numero sms) indicato è inserito in blacklist
 * - se l'indirizzo è in blacklist ma in status 'cleared' viene conisderato NON in blacklist
 * @param string $address  l'indirizzo da verificare
 * @return mixed false se l'indirizzo non è in blacklist. Oppure lo status in cui si trova in blacklist (spam, bounce, unsubscribed)
 */
function is_blacklisted( $address )
#!php

/**
 * inserisce un indirizzo in blacklist.
 * se l'indirizzo è già presente ne aggiorna lo status
 * @param string $address L'indirizzo da inserire
 * @param string $status lo status da assegnarre in blacklist. A scelta tra 'spam', 'bounce', 'unsubscribed', 'cleared'. E' iin pratica il motivo per cui è in blacklist.
 * @param string $servizio la voce della tassonomia @see 'servizi_notifica' a cui appartiene questo indirizzo. Default = 'email'
* @param string $description Optional. La descrizione del motivo per cui l'indirizzo viene rimosso dalla blacklist. Viene inserito in post_excerpt e poi ad ogni aggiornamento di status trasferito nella cronologia
 */
function make_blacklisted( $address, $status, $servizio = 'email', $description = '' )
#!php

/**
 * Rimuovi un indirizzo dalla blacklist.
 *  - in realtà non lo rimuove, ma ne cambia lo status in 'cleared'
 * @param string $address  L'indirizzo da rimuovere
 * @param string $description Optional. La descrizione del motivo per cui l'indirizzo si trova in blacklist. Viene aggiunto in un commento allegato.
 */
function remove_blacklisted( $address, $description = '' )
#!php

/**
 * Funzione Helper: aggiunge un commento con lo status e la motivazione agli indirizzi in blacklist
 * @param int $blacklisted_id l'ID dell'indirizzo inserito in blacklist
 * @param string $status lo status da assegnarre in blacklist. A scelta tra 'spam', 'bounce', 'unsubscribed', 'cleared'. E' iin pratica il motivo per cui è in blacklist.
 * @param string $description Optional. La descrizione del motivo per cui l'indirizzo si trova in blacklist.
 */
function add_blacklist_history( $blacklisted_id, $status, $description = '')
#!php

/**
 * Ogni volta che cambiamlo status di un elemento in blacklist, aggiorna la cronologia dell'elemento
 * aggiungendo il contenuto di 'post_excerpt' che contiene il motivo più recente di cambio status in blacklist
 */
add_action(  'transition_post_status',  'update_blackilsted_history', 10, 3 );

Campi

Core

Nome slug rest note
Destinatario title (Obbligatorio) Email oppure numero sms ecc.
Causa excerpt Il motivo per cui Destinatario è in questo status in blacklist. Viene trasferito automaticamente nella Cronologia dell'elemento ad ogni cambio di status con add_action( 'transition_post_status', 'update_blackilsted_history', 10, 3 );.
Status status Lo stato dell'elemento in blacklist. in pratica il motivo per cui si trova in blacklist (vei elenco più sotto)

Taxonomies

Nome slug rest note
Servizio di invio servizio_notifica quale servizio è stato usato? : email, sms, slack, ecc

Status:

Nome slug note
Spam spam
Rimbalza bounce
Disiscritto unsubscribed
Invia cleared

Cronologia

Ad oggni cambio di status di un elemento in Blacklist (incluso inserimento e rimozione) il motivo/errore che ha generato il cambio di status viene copiato dal post_excerpt e viene aggiunto in un commento (wp_comment).