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).