Devenia IMAP Intake
Conecta un buzón IMAP con tu plugin de WordPress
Lee mensajes y archivos adjuntos de un buzón IMAP existente mediante una interfaz PHP. Tu plugin decide cuándo leer y qué hacer con el resultado.
Versión 1.0.1 · GPL-2.0-or-later
Un buzón y una entrega clara
Tu plugin proporciona el servidor, el puerto, la carpeta y las credenciales. Devenia IMAP Intake abre la carpeta en modo de solo lectura mediante una conexión TLS verificada y devuelve las cabeceras, las direcciones de los remitentes y los bytes decodificados de los adjuntos. El mensaje original permanece en la carpeta y conserva su estado de lectura.
Tu plugin decide cuándo conectarse y se encarga del control de acceso, los reintentos, la deduplicación y el almacenamiento. También establece el tamaño máximo del mensaje completo en cada descarga.
Lee el mensaje. Tu plugin se encarga del resto.
El mensaje permanece en el buzón. El receptor lo lee y decodifica sus adjuntos; tu plugin aplica sus propias reglas y decide qué hacer después.
El receptor conecta el buzón con tu código; no decide cómo se procesa el mensaje.
Ejemplo: procesar un buzón compartido
Imagina un plugin de WordPress que procesa los mensajes enviados a [email protected]. La persona que lo desarrolla lo conecta al buzón IMAP existente y establece un tamaño máximo de mensaje. El receptor devuelve mensajes y adjuntos; el plugin que lo llama comprueba lo que ya se ha procesado y decide cómo almacenar o tratar cada elemento.
El ejemplo es ilustrativo. El receptor es una interfaz de lectura para desarrolladores; no es un servicio de correo web ni envía correo por SMTP.
Usa los identificadores en su contexto
Los UID identifican mensajes únicamente dentro de una cuenta, una carpeta y un valor UIDVALIDITY determinados. Compara el UIDVALIDITY actual con el valor guardado antes de reutilizar un cursor.
UIDVALIDITY
Identifica la serie actual de UID de la carpeta seleccionada.
UID
Identifica un mensaje dentro de esa cuenta, carpeta y serie de UID.
Requisitos y disponibilidad
Necesitas WordPress 6.9 o posterior, PHP 8.1 o posterior con OpenSSL y mbstring, certificados de autoridad de confianza y un servidor IMAP con un certificado TLS válido. La conexión admite TLS implícito o STARTTLS.
Descarga el ZIP de arriba y prueba la integración en una copia de pruebas antes de usarla con un buzón en producción.
En WordPress, abre Plugins → Añadir nuevo plugin → Subir plugin, elige el ZIP e instala y activa Devenia IMAP Intake. Llama a la interfaz desde tu propio plugin después de que se hayan cargado los plugins activos. Guarda las credenciales del buzón en la configuración protegida de tu aplicación.
Abrir una carpeta y leer un mensaje
Este ejemplo utiliza un dominio reservado. Obtén $password de una configuración protegida y $saved_uid_validity de tu propia aplicación. En el primer uso, determina el UIDVALIDITY de la carpeta antes de guardar un cursor. fetch() aplica el límite de bytes al mensaje completo antes de decodificarlo.
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', 'Comprueba el cursor guardado antes de continuar.' );
}
if ( $uids ) {
$message = $mailbox->fetch( $uids[0], wp_max_upload_size() );
if ( is_wp_error( $message ) ) {
return $message;
}
}
} finally {
$mailbox->close();
}
La interfaz ofrece Mailbox::open(), uid_validity(), uids(), fetch() y close(). Un mensaje recuperado incluye cabeceras, direcciones de remitentes y adjuntos con sus bytes decodificados.
En un proceso de producción, gestiona los errores, selecciona el UID con tu propio cursor y valida los remitentes según tus reglas. Marca el procesamiento como terminado solo cuando hayan concluido correctamente los pasos posteriores. Abre una sesión nueva tras una lectura IMAP fallida.
Si falla la conexión, comprueba el nombre del servidor, el puerto, el modo TLS, las credenciales y la cadena de certificados de confianza. Si un mensaje supera tu límite de bytes, decide cómo debe tratarlo tu aplicación antes de volver a intentarlo.
Lee mensajes con tu propio plugin de WordPress
Descarga el plugin, comprueba los requisitos y prueba la conexión con tu aplicación.
