Desarrollo WordPress personalizado en Sevilla

Un plugin WordPress propio para vender visitas guiadas en Sevilla: plazas sin sobreventa, turnos por idioma, estándares de código y seguridad de WordPress, RGPD y botón de pago conforme a la ley de consumidores.

Desarrollo WordPress personalizado

Mi lugar en la comunidad WordPress

  • Tengo cuenta en wordpress.org desde 2006.
  • He contribuido al núcleo de WordPress en las versiones 7.0 y 7.1.
  • Mantengo 30 plugins en wordpress.org.
  • Organizo WordCamps y hablo en ellos como ponente.
  • He asistido a todas las WordCamp Europe de 2017 a 2026.
  • Meetup local de WordPress: WordPress Sevilla

Mi perfil en WordPress.org

Las reservas de una empresa de visitas guiadas en Sevilla suelen llegar por tres canales a la vez: correo, WhatsApp y una pasarela de pago que no sabe cuántas plazas le quedan a cada guía. Me llamo Mariusz Szatkowski, escribo código para WordPress desde 2006 y desarrollo plugins a medida desde Gdynia (Polonia), en remoto y con todo el proyecto documentado por escrito. En esta guía repaso qué debe resolver un plugin de reservas de visitas guiadas para aguantar un sábado de primavera con todos los turnos llenos, y qué estándares de código y de seguridad del proyecto WordPress conviene exigir a quien lo programe.

#Antes de programar: ¿te sirve un plugin que ya existe?

Hay plugins de reservas genéricos con muchas instalaciones, y para una empresa con una sola visita diaria en un idioma suelen bastar. Lo primero que hago con tu encargo es comprobar si alguno cubre tus reglas sin forzarlo. Si la respuesta es sí, te lo digo por escrito y no escribo una línea de código.

El desarrollo propio compensa cuando tu operativa no cabe en un modelo simple de recurso y hueco horario. Algunas señales:

  • Un mismo recorrido sale a la misma hora en castellano, inglés y francés, y cada idioma tiene su guía y su aforo.
  • El grupo máximo depende del guía asignado o del monumento, no de la visita.
  • Parte de tus visitas incluye la entrada a un monumento con horario propio que cambia según la temporada.
  • Vendes también a agencias y hoteles, que reservan bloques de plazas y pagan después.
  • Necesitas que el guía vea en el móvil la lista del turno sin entrar en el escritorio de WordPress.

Si te reconoces en dos o tres de esas líneas, un plugin propio, pequeño y bien escrito, suele dar menos trabajo a medio plazo que un plugin genérico lleno de parches.

#El modelo de datos: visitas, turnos y reservas

En el plugin separo tres cosas que los formularios improvisados suelen mezclar.

La visita es el producto: recorrido, duración, punto de encuentro, idiomas posibles y texto descriptivo. La guardo como tipo de contenido propio de WordPress, así tu equipo la edita con el editor de bloques como cualquier página, con sus traducciones.

El turno es una salida concreta: fecha, hora de inicio, idioma, guía y capacidad. Los turnos se generan a partir de reglas de temporada que defines tú, y van en una tabla propia, porque una empresa activa acumula miles de ellos y consultarlos como entradas de WordPress es lento.

La reserva une a una persona con un turno: número de plazas, estado (retenida, pagada, cancelada) y los datos mínimos para que el guía pueda trabajar.

Las horas se calculan siempre con la zona horaria del sitio. WordPress ofrece wp_timezone(), que devuelve un objeto DateTimeZone con la zona configurada en Ajustes. Con Europe/Madrid bien puesta, el cambio de hora de marzo y octubre no desplaza ningún turno ni la hora que recibe el cliente en el correo de confirmación.

Patio de las Doncellas, Real Alcázar de Sevilla

Foto: Benjamin Smith, CC BY-SA 4.0, Wikimedia Commons.

Las reglas de temporada pesan mucho en Sevilla: según su web oficial, el Real Alcázar abre de 09:30 a 17:00 de octubre a marzo y de 09:30 a 19:00 de abril a septiembre. Si una de tus visitas recorre el interior, el último turno de invierno no puede salir a la misma hora que en verano. Te recomiendo guardarlo en el plugin como una regla con fechas de inicio y fin, para que no dependa de que alguien lo recuerde. Las entradas al monumento y su reserva siguen siendo cosa tuya: el plugin solo impide vender turnos que no encajan en ese horario.

#Sin sobreventa: cómo se descuentan las plazas

El fallo más caro de un sistema de reservas es vender la plaza 21 de un grupo de 20. Suele pasar cuando el código lee cuántas plazas quedan, comprueba que hay sitio y luego guarda la reserva en dos pasos. Si dos personas pagan en el mismo segundo, las dos leen el mismo número.

Lo evito con una sola consulta que suma las plazas solo si caben, para que sea la base de datos quien decida:

$updated = $wpdb->query(
	$wpdb->prepare(
		'UPDATE %i SET booked = booked + %d WHERE id = %d AND booked + %d <= capacity',
		$wpdb->prefix . 'tour_slots',
		$seats,
		$slot_id,
		$seats
	)
);

if ( 1 !== $updated ) {
	// No quedan plazas suficientes en este turno: no se crea la reserva.
}

Todos los valores pasan por $wpdb->prepare(), que según su referencia oficial admite los marcadores %d, %f, %s y, desde WordPress 6.2, %i para nombres de tabla o columna. Los marcadores van sin comillas y cada uno necesita su argumento.

Mientras el cliente paga, la reserva queda retenida con una hora de caducidad. Si abandona la pasarela, una tarea programada libera las plazas. Aquí hay un detalle que conviene conocer: el manual de WP-Cron explica que las tareas se comprueban en cada carga de página y no corren de forma continua, de modo que una tarea prevista para una hora puede ejecutarse mucho después si nadie visita la web. Para reservas eso no vale, así que dejo documentado cómo enlazar WP-Cron con el programador de tareas del servidor y desactivar la ejecución por visita con define( 'DISABLE_WP_CRON', true ); en wp-config.php.

#Seguridad: lo que pide el manual de WordPress

Un formulario de reservas es un punto de entrada público a tu base de datos. Sigo el manual de seguridad de WordPress punto por punto, y estas son las reglas que más pesan en un plugin así.

#Sanear y validar todo lo que entra

El nombre pasa por sanitize_text_field(), el correo por sanitize_email(), y el número de plazas se valida como entero dentro del rango del turno antes de tocar nada. La documentación de saneamiento detalla qué hace cada función.

#Escapar tarde

La guía de escapado recomienda escapar lo más tarde posible, justo al imprimir, porque así una revisión de código ve de un vistazo que la salida es segura. En el listado de turnos que ve el guía, cada nombre sale con esc_html() y cada enlace con esc_url().

#Nonces contra CSRF, permisos para todo lo demás

Los formularios llevan nonce, pero el manual de nonces es claro: nunca deben usarse para autenticación, autorización ni control de acceso. Esa parte la hace current_user_can(). En el plugin creo un rol de guía con una capacidad propia para ver sus turnos, sin acceso a pedidos, ajustes ni usuarios.

#Rutas REST con permiso explícito

La app del guía y el calendario público leen datos por la API REST. La guía de rutas propias indica que cada ruta necesita permission_callback y que solo las rutas públicas usan __return_true. En la práctica: la disponibilidad de turnos es pública, la lista de asistentes de un turno exige la capacidad del guía.

#Estándares de código y revisión automática

Un plugin que sigue los WordPress Coding Standards para PHP (comparaciones Yoda, visibilidad declarada en cada método, una clase por archivo, consultas preparadas) lo puede leer y mantener cualquier desarrollador WordPress.

La comprobación es automática. El proyecto WordPress-Coding-Standards publica las reglas para PHP_CodeSniffer en los conjuntos WordPress-Core, WordPress-Extra y WordPress-Docs, y se instala en el propio proyecto con Composer:

composer config allow-plugins.dealerdirect/phpcodesniffer-composer-installer true
composer require --dev wp-coding-standards/wpcs:"^3.0"

Además paso Plugin Check, la herramienta oficial de WordPress.org que ejecuta la mayoría de las comprobaciones aplicadas a los plugins nuevos que se envían al directorio. Señala problemas de seguridad, internacionalización, rendimiento y accesibilidad, y se ejecuta desde Herramientas en el escritorio o desde WP-CLI con wp plugin check. Tu plugin no tiene que publicarse en el directorio para beneficiarse de esa revisión.

Dos detalles más que dejo resueltos desde el principio:

  • Traducciones: todos los textos visibles pasan por las funciones de traducción con un dominio de texto que, como pide el manual de internacionalización, coincide con el slug del plugin. Con los textos preparados para traducir, el correo de confirmación puede salir en el idioma del turno.
  • Desinstalación limpia: con un archivo uninstall.php, según los métodos de desinstalación, al borrar el plugin desaparecen sus opciones y tablas. Te aconsejo que antes de borrar el plugin avise de las reservas futuras y permita exportarlas.

#Datos de tus clientes: lo justo y con fecha de borrado

El RGPD pide que los datos sean adecuados, pertinentes y limitados a lo necesario (artículo 5.1.c, «minimización de datos») y que no se guarden más tiempo del necesario (artículo 5.1.e). El artículo 25 añade la protección de datos desde el diseño y por defecto. Todo ello en el texto del Reglamento.

En un plugin de visitas guiadas eso se traduce en decisiones concretas:

  • El formulario pide nombre, correo, idioma y número de plazas. El teléfono es opcional y solo aparece si tú decides que el guía puede avisar de cambios por esa vía.
  • No hay campo de nacionalidad, fecha de nacimiento ni documento de identidad salvo que una visita concreta lo exija y lo justifiques.
  • Cada reserva tiene un plazo tras la fecha de la visita a partir del cual el plugin anonimiza los datos personales y conserva solo lo que necesitas para la contabilidad.
  • El plugin se registra en las herramientas de privacidad de WordPress mediante los filtros wp_privacy_personal_data_exporters y wp_privacy_personal_data_erasers, de modo que una solicitud de acceso o de supresión se atiende desde Herramientas sin consultas manuales a la base de datos.

Si durante el desarrollo trabajo con una copia de reservas reales, firmamos antes un contrato de encargado del tratamiento conforme al artículo 28 del RGPD. Mi recomendación es trabajar con datos de prueba siempre que se pueda.

#Lo que la ley de consumidores pide a tu proceso de reserva

Vender una visita guiada online a un particular es un contrato a distancia, y el Texto Refundido de la Ley General para la Defensa de los Consumidores y Usuarios tiene tres artículos que afectan directamente al plugin.

ArtículoQué diceCómo lo recojo en el plugin
98.2El botón que confirma el pedido debe decir solo “pedido con obligación de pago” o una fórmula análoga no ambigua; si no, el consumidor no queda obligadoTexto del botón fijo, traducido en cada idioma y fuera del alcance de cambios accidentales
103 l)No hay derecho de desistimiento en servicios relacionados con actividades de esparcimiento si el contrato prevé una fecha concretaLa política de cancelación la defines tú en los ajustes
97.1 m)Si no hay desistimiento, hay que indicar al consumidor que no le asiste ese derechoAviso visible antes del pago y en el correo de confirmación

El artículo 98.3 añade que la web debe indicar, a más tardar al inicio del proceso de compra, las modalidades de pago aceptadas. Por eso conviene mostrar esas modalidades ya en la ficha de la visita. La redacción de tus condiciones generales y de tu política de cancelación corresponde a tu asesoría; yo me encargo de que el plugin las muestre donde la ley lo pide.

#Cómo trabajo un encargo así

  1. Inventario por escrito. Me envías tus visitas, idiomas, puntos de encuentro, aforos, reglas de temporada y cómo cobras hoy. Una hoja de cálculo basta.
  2. Construir o comprar. Reviso los plugins de reservas existentes contra ese inventario y te digo por escrito si alguno encaja.
  3. Alcance y supuestos. Si seguimos, recibes un documento con lo que hace el plugin, lo que queda fuera, qué datos guarda y los criterios de aceptación.
  4. Desarrollo en pruebas. Programo en un entorno de pruebas con control de versiones y paso WordPress Coding Standards y Plugin Check sobre cada entrega.
  5. Aceptación. Pruebas casos reales: turno lleno, pago abandonado, cambio de hora, cancelación, solicitud de borrado de datos.
  6. Publicación y mantenimiento. Publico con vuelta atrás preparada. Si quieres que después me ocupe de actualizar y vigilar el plugin, lo pactamos en un acuerdo separado.

Todo el proyecto se lleva por correo y documentos compartidos, sin reuniones. El diseño gráfico y la maqueta de las vistas los aportas tú o tu diseñador; yo los convierto en plantillas y bloques que funcionan en móvil.

#Qué preparas tú, aunque no trabajes conmigo

Esta lista te sirve para pedir presupuesto a cualquier desarrollador y comparar respuestas:

  • Lista de visitas con duración, punto de encuentro e idiomas.
  • Aforo máximo por turno y si depende del guía o del monumento.
  • Reglas de temporada con fechas de inicio y fin.
  • Cómo reservan las agencias y los hoteles y cómo te pagan.
  • Política de cancelación y texto legal revisado por tu asesoría.
  • Qué datos necesita de verdad el guía el día de la visita.
  • Pasarela de pago que ya usas o quieres usar.
  • Acceso al hosting y a una copia de la web para el entorno de pruebas.

Si vendes la entrada al monumento junto con la visita, o ya tienes una tienda WooCommerce, dilo desde el principio: cambia la arquitectura. Para tiendas existentes, mira también mi página de desarrollo WooCommerce en Sevilla.

#Preguntas frecuentes

#¿Por qué no usar un plugin de reservas que ya existe?

Si uno encaja, es la mejor opción y te lo diré. El código propio compensa cuando tus reglas (aforo por guía, turnos por idioma, horarios que cambian con la temporada del monumento) obligan a forzar un plugin genérico con parches que luego nadie mantiene.

#¿Cómo evita el plugin vender la misma plaza dos veces?

Las plazas se descuentan con una única consulta que solo prospera si queda capacidad, y una reserva sin pagar se guarda como retención con fecha de caducidad. Si dos personas pulsan a la vez, la base de datos deja pasar a una sola.

#¿Mis clientes pueden cancelar una visita guiada comprada online?

El artículo 103 l) del TRLGDCU excluye el derecho de desistimiento en los servicios relacionados con actividades de esparcimiento con fecha concreta. Tu política de cancelación la decides tú, y el artículo 97.1 m) te obliga a informar antes de la compra de que ese derecho no existe.

#¿Qué texto debe llevar el botón de pago?

El artículo 98.2 del TRLGDCU pide que diga solo “pedido con obligación de pago” o una fórmula análoga no ambigua. Si no, el cliente no queda obligado por el pedido. El plugin deja ese texto fijo y traducido en cada idioma.

#¿Qué datos personales guarda el plugin?

Los que la visita necesita: nombre, correo, teléfono si el guía tiene que avisar y el idioma. Cada dato tiene un plazo de borrado y el plugin se conecta a las herramientas de exportación y borrado de datos de WordPress.

#¿Puedo pasar el código a otro desarrollador más adelante?

Sí. Sigue los estándares de WordPress, pasa Plugin Check y viene con documentación, así que cualquier desarrollador WordPress puede leerlo y seguir trabajando sobre él.

#Escríbeme con tu lista de visitas

Si te cansa cuadrar turnos en una hoja de cálculo cada noche, mándame tu caso desde la página de contacto. Me sirve la dirección de tu web, la lista de visitas con sus idiomas, cómo entran hoy las reservas, los plugins instalados y la fecha a la que quieres llegar, por ejemplo la Semana Santa o el arranque de la primavera. Con eso preparo una primera estimación por escrito, sin coste, y te pregunto lo que me falte.

¿Buscas el servicio: Desarrollo WordPress personalizado en Sevilla?

Describe tu proyecto por e-mail. Respondo en 48 horas.

Describe tu proyecto

Explora otros servicios WordPress y base de conocimiento