Devenia IMAP Intake
Porta una casella IMAP nel tuo plugin WordPress
Leggi messaggi e allegati da una casella IMAP esistente tramite un’interfaccia PHP. Il tuo plugin decide quando leggere e come usare il risultato.
Versione 1.0.1 · GPL-2.0-or-later
Una casella, una suddivisione chiara dei compiti
Il tuo plugin fornisce server, porta, cartella e credenziali. Devenia IMAP Intake apre la cartella in sola lettura tramite una connessione TLS verificata e restituisce intestazioni, indirizzi dei mittenti e byte decodificati degli allegati. Il messaggio resta nella cartella e il suo stato di lettura non cambia.
Il tuo plugin decide quando connettersi e gestisce controllo degli accessi, nuovi tentativi, deduplicazione e archiviazione. Imposta anche la dimensione massima del messaggio completo per ogni lettura.
Leggi il messaggio. Il tuo plugin decide cosa fare.
Il messaggio rimane nella casella. Il ricevitore lo legge e decodifica gli allegati; il tuo plugin applica le proprie regole e decide il passo successivo.
Il ricevitore collega la casella al tuo codice; non decide come elaborare il messaggio.
Esempio: elaborare una casella condivisa
Immagina un plugin WordPress che elabori i messaggi inviati a [email protected]. Chi lo sviluppa lo collega alla casella IMAP esistente e imposta la dimensione massima dei messaggi. Il ricevitore restituisce messaggi e allegati; il plugin chiamante verifica quali ha già gestito e decide come archiviarli o elaborarli.
Questo è un esempio illustrativo. Il ricevitore è un’interfaccia di lettura per sviluppatori: non è una webmail e non invia posta tramite SMTP.
Usa gli identificativi nel contesto giusto
Gli UID identificano i messaggi solo all’interno di uno specifico account, cartella e valore UIDVALIDITY. Confronta il valore UIDVALIDITY attuale con quello salvato prima di riutilizzare un cursore.
UIDVALIDITY
Identifica la serie di UID attuale della cartella selezionata.
UID
Identifica un messaggio all’interno di quell’account, cartella e serie di UID.
Requisiti e disponibilità
Servono WordPress 6.9 o successivo, PHP 8.1 o successivo con OpenSSL e mbstring, certificati CA attendibili e un server IMAP con un certificato TLS valido. La connessione supporta TLS implicito o STARTTLS.
Scarica il file ZIP qui sopra e prova l’integrazione su una copia di staging prima di usarla con una casella in produzione.
In WordPress apri Plugin → Aggiungi nuovo plugin → Carica plugin, scegli il file ZIP, installalo e attiva Devenia IMAP Intake. Richiama l’interfaccia dal tuo plugin dopo il caricamento dei plugin attivi. Conserva le credenziali della casella nella configurazione protetta della tua applicazione.
Apri una cartella e leggi un messaggio
Questo esempio usa un dominio riservato. Ricava $password dalla configurazione protetta e $saved_uid_validity dalla tua applicazione. Al primo utilizzo, determina l’UIDVALIDITY della cartella prima di salvare un cursore. fetch() applica il limite in byte all’intero messaggio prima della decodifica.
use Devenia\ImapIntake\Mailbox;
$mailbox = Mailbox::open( array(
'host' => 'imap.example.com',
'port' => 993,
'username' => '[email protected]',
'password' => $password,
'folder' => 'INBOX',
'encryption' => 'ssl',
'timeout' => 15,
) );
if ( is_wp_error( $mailbox ) ) {
return $mailbox;
}
try {
$validity = $mailbox->uid_validity();
$uids = $mailbox->uids();
if ( is_wp_error( $uids ) ) {
return $uids;
}
if ( $validity !== $saved_uid_validity ) {
return new WP_Error( 'mailbox_changed', 'Controlla il cursore salvato prima di continuare.' );
}
if ( $uids ) {
$message = $mailbox->fetch( $uids[0], wp_max_upload_size() );
if ( is_wp_error( $message ) ) {
return $message;
}
}
} finally {
$mailbox->close();
}
L’interfaccia offre Mailbox::open(), uid_validity(), uids(), fetch() e close(). Il messaggio letto comprende intestazioni, indirizzi dei mittenti e allegati con i rispettivi byte decodificati.
In produzione, gestisci gli errori, scegli l’UID usando il tuo cursore e verifica i mittenti secondo le tue regole. Registra il completamento solo dopo che l’elaborazione successiva è riuscita. Dopo una lettura IMAP non riuscita, apri una nuova sessione.
Se la connessione non riesce, controlla nome del server, porta, modalità TLS, credenziali e catena dei certificati attendibili. Se un messaggio supera il limite in byte, decidi come deve gestirlo l’applicazione prima di riprovare.
Leggi i messaggi con il tuo plugin WordPress
Scarica il plugin, verifica i requisiti e prova la connessione con la tua applicazione.
