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

Ricevitore di posta in stile Art Déco che smista buste e un documento allegato.

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.

Una casella IMAP esistente fornisce messaggi e allegati al plugin WordPress tramite il ricevitore.

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.

Ricevitore di posta in stile Art Déco che smista buste e un documento allegato.