Pedraza Mahou Reservations

Plugin WordPress para gestionar reservas de cestas picnic Mahou en la web del Gran Castillo de Pedraza. Funciona mediante shortcodes insertables en contenedores de Elementor y no crea cabeceras, pies ni estructura global de página.

Requisitos

• WordPress con PHP 8.0 o superior.
• Permisos para instalar y activar plugins.
• Configuración correcta de envío de correo en WordPress. Se recomienda SMTP transaccional en producción.

Instalación

1. Comprime la carpeta pedraza-mahou-reservations en un archivo ZIP.
2. En WordPress, ve a Plugins > Añadir nuevo > Subir plugin.
3. Sube el ZIP, instala y activa el plugin.
4. Al activar el plugin se crea la tabla personalizada de reservas mediante dbDelta.

Shortcodes

Formulario público de reserva:

[pedraza_mahou_reservations]

Panel privado de gestión:

[pedraza_mahou_reservations_admin]

Ambos shortcodes imprimen únicamente el contenido funcional del plugin, por lo que pueden insertarse dentro de contenedores de Elementor.

Configuración inicial

En el admin de WordPress, entra en Ajustes > Reservas Pedraza Mahou y configura:

• Usuario del panel privado.
• Nueva contraseña del panel privado.
• Email interno de recepción.
• Nombre del remitente.
• Email del remitente.
• Asunto del email al cliente.
• Asunto del email interno.
• Enlace a Política de Privacidad.
• Enlace a Política de Cookies.
• Enlace a Aviso Legal.
• Intervalo de refresco automático del panel privado.
• Propietario y repositorio de GitHub para actualizaciones.
• Token GitHub opcional si el repositorio es privado.

Los enlaces legales vienen precargados con las URLs oficiales del Gran Castillo de Pedraza y puedes cambiarlos desde ajustes si más adelante hiciera falta.

La contraseña del panel privado se guarda con password_hash() usando bcrypt. El campo de contraseña nunca muestra el valor actual y solo cambia si se rellena una nueva contraseña.

Actualizaciones desde GitHub

El plugin usa YahnisElsts/plugin-update-checker instalado por Composer y empaquetado dentro de vendor/. No hace falta instalar nada adicional en WordPress.

Configuración por defecto:

• Propietario: daviidxestrada
• Repositorio: pedraza-mahou-reservations

Para publicar una nueva versión:

1. Actualiza la cabecera Version del plugin y la constante PMR_VERSION en pedraza-mahou-reservations.php.
2. Actualiza Stable tag y el changelog en readme.txt.
3. Regenera el ZIP del plugin.
4. Haz commit y push a GitHub.
5. Crea una release con tag semántico superior a la versión instalada, por ejemplo v1.0.6, adjuntando el asset pedraza-mahou-reservations.zip.
6. WordPress detectará la nueva versión desde Escritorio > Actualizaciones o desde la pantalla de plugins. PUC ignora releases marcadas como pre-release.

Si el repositorio es privado, configura un token con permiso de lectura del repositorio. Puedes hacerlo de dos formas:

define('PMR_GITHUB_TOKEN', 'github_pat_xxx');

También puedes definir el propietario y el repositorio por constantes:

define('PMR_GITHUB_OWNER', 'daviidxestrada');
define('PMR_GITHUB_REPO', 'pedraza-mahou-reservations');

Si no usas constantes, puedes guardar estos valores desde Ajustes > Reservas Pedraza Mahou. El token queda almacenado en las opciones de WordPress.

Funcionamiento de reservas

El formulario público permite solicitar una reserva sin pago online. Al enviar una solicitud:

• Se valida nonce, honeypot, fecha, email, teléfono, número de cestas y consentimiento RGPD obligatorio.
• El teléfono se selecciona con país, bandera y prefijo, se valida según el país y se guarda en formato internacional E.164.
• Se aplica rate limit básico por IP.
• Se genera una referencia correlativa con prefijo A, comenzando en A101.
• Se guarda la reserva en tabla personalizada.
• Se envía email HTML al cliente.
• Se envía email HTML interno al equipo.
• Se muestra al usuario una confirmación con su referencia.

El pago se realiza presencialmente en taquilla el día de la recogida.

El selector de fecha utiliza Flatpickr 4.6.13, empaquetado localmente bajo licencia MIT. Muestra un calendario en español adaptado al sistema visual de la web, limita la selección a fechas válidas y mantiene el formato interno compatible con WordPress.

El selector internacional de teléfono utiliza intl-tel-input 29.0.3, empaquetado localmente bajo licencia MIT. No necesita servicios externos para mostrar países, banderas o validar el número.

Los iconos se renderizan como SVG inline basados en Lucide, con clases y estilos aislados para evitar interferencias del tema o de Elementor.

Los emails transaccionales utilizan una plantilla HTML responsive con estilos inline para mantener una presentación consistente en los principales clientes de correo. Se solicita League Spartan y Montserrat mediante Google Fonts, pero algunos clientes como Gmail u Outlook bloquean fuentes externas; en esos casos se utilizan automáticamente alternativas locales optimizadas para Apple, Windows y otros sistemas.

Panel privado

El shortcode [pedraza_mahou_reservations_admin] muestra un login propio independiente del login estándar de WordPress.

El panel autenticado permite:

• Ver todas las reservas pendientes en la sección Por preparar.
• Ver las reservas entregadas en una sección Completadas separada.
• Ver el total de reservas y cestas pendientes.
• Buscar por referencia, nombre, teléfono o email.
• Consultar desde móvil tarjetas claras con fecha, cestas, teléfono, email, observaciones y acción principal.
• Ver las pendientes ordenadas por fecha de recogida más cercana.
• Marcar una reserva como completada para moverla automáticamente a Completadas.
• Devolver una reserva completada a Por preparar.
• Actualizar manual o automáticamente ambas listas.
• Cerrar sesión.

La sesión privada se mantiene mediante cookie firmada con HMAC, HttpOnly, SameSite=Lax y Secure cuando la web usa HTTPS.

Limpieza de reservas de prueba

Desde Ajustes > Reservas Pedraza Mahou > Herramientas de pruebas, un administrador de WordPress puede vaciar todas las reservas guardadas.

La operación:

• Elimina reservas pendientes, completadas y canceladas.
• Conserva todos los ajustes, credenciales y enlaces del plugin.
• Está protegida con permisos de administrador, nonce y confirmación.
• Hace que la siguiente reserva vuelva a utilizar la referencia A101.

Seguridad

El plugin aplica:

• Nonces en formularios y acciones AJAX.
• Sanitización de entradas.
• Escape de salidas HTML.
• Queries dinámicas con $wpdb->prepare().
• Validación de email, teléfono, fecha y cantidad.
• Honeypot antispam.
• Rate limit básico de reservas por IP.
• Rate limit básico de login privado por IP.
• Contraseñas privadas con bcrypt.
• Verificación de contraseña con password_verify().
• Cookies firmadas para el panel privado.
• DONOTCACHEPAGE y cabeceras no-cache en el panel privado.

Campos guardados

La tabla personalizada guarda:

• id
• reference
• pickup_date
• basket_count
• observations
• full_name
• email
• phone
• rgpd_consent
• marketing_consent
• status
• ip_address
• created_at
• updated_at

Estados disponibles:

• pending
• completed
• cancelled

Archivos principales

pedraza-mahou-reservations/
├── pedraza-mahou-reservations.php
├── composer.json
├── composer.lock
├── readme.txt
├── includes/
│   ├── class-pmr-activator.php
│   ├── class-pmr-database.php
│   ├── class-pmr-shortcodes.php
│   ├── class-pmr-reservations.php
│   ├── class-pmr-auth.php
│   ├── class-pmr-emails.php
│   ├── class-pmr-admin-settings.php
│   ├── class-pmr-update-checker.php
│   └── class-pmr-assets.php
├── assets/
│   ├── css/
│   │   └── pmr-styles.css
│   └── js/
│       └── pmr-scripts.js
└── README.md

Notas de producción

• Configura SMTP para mejorar la entregabilidad de emails.
• Revisa que los enlaces legales apunten a páginas publicadas.
• Evita cachear la página donde insertes el panel privado.
• Para RGPD, valida el texto legal final con el responsable legal del proyecto antes de publicar.