Mail-Comment

Prueba de concepto para añadir comentarios en sitios estáticos utilizando correo electrónico.
Prototype to add comments to static sites using email.

---

📋 Características / Features

• Sin registro / No registration: cualquier usuario con correo electrónico puede comentar / any user with email can comment.
• Moderación / Moderation: aprovecha filtros de spam del proveedor de correo / use existing spam filters.
• Filtros / Filters: palabras clave y dominios específicos / keywords and domain filters.
• Exportación / Export options: HTML, Markdown, RSS/XML.
• Integración / Integration:
  • Hugo: añade comentarios al final de los posts / append comments to Hugo posts.
  • WordPress: webhook para instancias headless / webhook for headless WordPress.

---

⚙️ Instalación / Installation

git clone https://git.interlan.ec/Drk0027/mail-comment.git
cd mail-comment
pip install -r requirements.txt
cp .env.example .env
python -m venv venv
source venv/bin/activate
python email-processor.py

📄 Configuración .env / .env Configuration

env
DOMAIN_TO_SEARCH=midominio.com
IGNORE_KEYWORDS=publicidad,notificacion,spam

SAVE_HTML=True
SAVE_MARKDOWN=True
SAVE_XML=True
SEND_WEBHOOK=True

WP_WEBHOOK_URL=https://tusitio.com/wp-json/tudominio/v1/recibir-comentario
WEBHOOK_SECRET_TOKEN=mi_clave_secreta_123

HUGO_DIR=/home/user/quickstart/
APPEND_HUGO=True

▶️ Ejecución / Run

python email-processor.py

El script / The script:

• Conecta al servidor IMAP / Connects to IMAP server.
• Revisa mensajes en INBOX / Checks INBOX messages.
• Valida dominio y asunto / Validates domain and subject.
• Filtra spam / Filters spam.
• Exporta comentarios / Exports comments.
• Integra en Hugo o WordPress / Integrates with Hugo or WordPress.
• Borra mensajes procesados / Deletes processed messages.

⚠️ Advertencia / Warning

Publicar tu correo puede exponerte a spam / Publishing your email may expose you to spam.

Se recomienda usar una cuenta dedicada / Use a dedicated account.

Gmail puede funcionar con claves de aplicación / Gmail may work with app passwords.

📚 Recursos / Resources

Repositorio principal / Main repo

Funciones WordPress / WordPress functions

Delta Chat Providers

Entrada en el blog/ Blog Entry

📌 Estado / Status Prototipo en desarrollo / Prototype in development. Pruebas con Hugo (QuickStart) y flujo básico de WordPress / Tested with Hugo (QuickStart) and basic WordPress flow.

📌 Autoría y versión

• Autor: (Drk0027)
• Versión: 0.1.0 (prototipo inicial)
• Licencia: MIT

🤝 Contribuciones por correo

Este proyecto no acepta pull requests en línea.
Si deseas contribuir:

1. Haz tus cambios en una rama local.
2. Genera un parche con:

   git format-patch origin/main
   

Envía el parche por correo a: drk0027@interlan.ec

El autor revisará y aplicará el parche si es aceptado.

Nota: recuerda incluir una descripción clara en el asunto del correo.