Holidayz mewayz

Holidayz en Mewayz

El complemento Holidayz es una plataforma completa de reservas de hoteles y alquileres vacacionales: sitio web de cara al público más administración para el operador.

módulo original de Mewayz — sin Mewayz aguas arriba. Documentación redactada a partir del código fuente del paquete en packages/mewayz/Holidayz/.

URL de demostración

Introducción

El complemento Holidayz es un módulo completo de alquiler vacacional y reservas de hotel: un sitio web de reservas de cara al público (con un diseño similar al de Airbnb / Booking.com) acompañado de un panel de administración para que el operador gestione hoteles, habitaciones, precios, calendarios, clientes y reservas.

Es independiente del Mewayz genérico Reservas módulo — Holidayz conserva el suyo propio holidayz_* conjunto de tablas y está diseñado específicamente para los flujos de trabajo de hoteles y alquileres vacacionales: características de las habitaciones, instalaciones, ventanas de reserva de varias noches, cuentas de clientes, cupones, contenido de blog y una superficie de marketing completa (hero, blog, sobre nosotros, preguntas frecuentes, testimonios).

Cómo habilitar este módulo

Para configurar el complemento Holidayz, puedes seguir este enlace: Configurar el complemento.

El complemento está restringido por PlanModuleCheck:Holidayz. Actívalo en el plan del operador o por inquilino a través de la Complementos página de administración.

Tres roles de usuario

Holidayz tiene tres tipos de usuarios distintos:

1. Administración / Empresa — El propietario del hotel. Tiene la gestión completa del

propiedad: crea y edita tipos de habitación, fija precios, gestiona cupones, consulta el panel con analíticas de reservas / ingresos / ocupación, aprueba o rechaza reservas, gestiona la base de datos de clientes, atiende reseñas y consultas de contacto, y configura la imagen de marca y el contenido del sitio web (banners, preguntas frecuentes, testimonios, enlaces sociales).

2. Personal — Operador limitado. Subrol dentro de la empresa; puede

ayudar con la atención al cliente, ver reservas y ejecutar operaciones básicas bajo la supervisión de la Compañía.

3. Cliente — Visitante público. Se registra con correo electrónico y contraseña,

explora los listados de hoteles, comprueba la disponibilidad de habitaciones, añade habitaciones al carrito, aplica cupones, completa el pago, consulta reservas anteriores junto con los recibos, y puede enviar reseñas y mensajes de contacto.

Panel de control de Holidayz

• Ve a Holidayz en la barra lateral.
• El panel en /holidayz/ muestra:
• Total de reservas tarjeta con desglose por estado (pagado /

pendiente / cancelado)

• Ingresos tarjeta con tendencia mes a mes
• Tasa de ocupación tarjeta calculada a partir de habitaciones disponibles ÷ reservadas

noches-habitación

• Reservas recientes lista con acciones rápidas de aprobar / rechazar
• Próximos registros de entrada durante los próximos 7 días

Gestión de salas

Explorar habitaciones

• Ve a Holidayz → Habitaciones.
• Cada fila muestra el nombre de la habitación, el tipo de habitación, el precio base y el actual

estado de disponibilidad y acciones rápidas.

Crear una habitación

• Haz clic en + Nueva sala.
• Campos del formulario:
• Nombre + Descripción
• Precio base por noche
• Capacidad (máx. de invitados)
• Configuración de camas (queen, doble individual, etc.)
• Características de la sala — Selección múltiple (Wi-Fi, aire acondicionado, TV, etc.)
• Instalaciones — Selección múltiple (piscina, gimnasio, desayuno incluido)
• Tasas de impuestos — Selección múltiple desde holidayz_room_taxes
• Fotos — Subida múltiple; la primera foto se convierte en portada
• Etiquetas — Para búsqueda/filtro en el sitio público
• Haz clic en Guardar.

Características de la habitación

• Holidayz → Características de la habitación — CRUD para servicios y comodidades

(Wi-Fi, aire acondicionado, TV, minibar, etc.) que se pueden asignar a las habitaciones.

Instalaciones

• Holidayz → Instalaciones — CRUD para instalaciones a nivel de hotel (piscina,

gimnasio, estacionamiento, desayuno). Las instalaciones se pueden padre → hijo jerárquico (p. ej. "Spa → Masaje", "Spa → Hammam").

Gestión de cupones

• Ve a Holidayz → Cupones.
• Crea códigos de descuento con:
• Código — lo que el cliente escribe al pagar
• Tipo de descuento — Porcentaje o cantidad fija
• Valor del descuento
• Ventana de validez — valid_from y valid_to fechas
• Límite de uso — Total máximo de canjes
• Límite por cliente — Canjes máximos por cliente
• Uso registrado en holidayz_coupon_usages.

Clientes de hotel

• Ve a Holidayz → Clientes del hotel.
• Base de datos de clientes gestionada por el operador: útil para administrar a los clientes recurrentes

huéspedes y contactar con ellos para marketing.

• Cada cliente tiene: nombre, correo electrónico, teléfono, fecha de nacimiento, dirección e identificación

número (para el cumplimiento del registro del hotel).

• Los clientes también pueden registrarse por sí mismos a través del sitio público en

/{userSlug}/hotel/register.

Reservas de habitaciones

• Ve a Holidayz → Reservas de Habitaciones.
• La lista completa de reservas de todas las salas y clientes.
• Estados: borrador → pagado → cancelado.
• Acciones por fila: ver detalle, aprobar, rechazar, editar,

eliminar, imprimir (recibo en PDF).

Ciclo de vida de la reserva

1. El cliente agrega habitaciones al carrito en el sitio público.
2. El cliente aplica un cupón (opcional) y procede al pago.
3. El pago se procesa a través de la capa PSP estándar de Mewayz (Stripe,

Razorpay, PayPal, etc.: las pasarelas que estén activas en la plataforma).

4. Tras el pago exitoso, la reserva pasa a pagado estado. Si

se requiere aprobación del administrador, la reserva permanece en estado pendiente hasta que un operador hace clic Aprobar.

5. La cancelación genera un reembolso según la política del operador.

Reseñas

• Ve a Holidayz → Reseñas.
• Reseñas de habitaciones enviadas por los clientes (tras la estancia) con valoración por estrellas

y comentar.

• Los operadores pueden ver, ocultar o eliminar reseñas.

Contacto, Boletines, Blogs

• Contactos — Mensajes entrantes del formulario de contacto público
• Boletines — Lista de correo captada a través del registro en el boletín
• Blogs — CRUD completo del blog; las entradas publicadas aparecen en

/{userSlug}/hotel/blog

Configuración del sistema

La Configuración del sistema menú que controla el sitio web público del operador:

• Configuración de marca — Logotipo, favicon, nombre del hotel
• Configuración de banners — Imagen de banner principal + texto
• Ajustes destacados — Qué habitaciones destacar en la página de inicio
• Configuración de destinos — Destinos destacados
• Configuración de Por qué elegirnos — Sección "Por qué elegirnos"
• Configuración de testimonios — Testimonios de clientes
• Configuración de consejos de viaje — Contenido editorial
• Configuración del boletín — Texto de la sección de boletín
• Configuración de enlaces sociales — Enlaces de Twitter / IG / FB / etc.
• Configuración sobre nosotros — Contenido de la página Acerca de
• Configuración de contacto — Contenido de la página de contacto
• Páginas personalizadas — Páginas CMS personalizadas (privacidad, términos, etc.)
• Configuración de Preguntas Frecuentes — entradas de preguntas frecuentes

Superficie pública del frontend

El sitio web público está alojado en /{userSlug}/hotel/... donde {userSlug} es el slug del inquilino del operador.

Ruta	Propósito
/{userSlug}/hotel/	Página de inicio con portada, habitaciones destacadas y blog
/{userSlug}/hotel/hotels	Listado de hoteles + habitaciones (búsqueda + filtro)
/{userSlug}/hotel/hotel/{encryptedRoom}	Página de detalles de habitación individual (la URL firmada oculta la identificación interna)
`/{userSlug}/hotel/about	contacto	blog	faq`	Páginas de marketing
/{userSlug}/hotel/cart	Carrito: consulta la disponibilidad, añade o quita artículos
/{userSlug}/hotel/checkout	Pago: aplicar o quitar cupones, pagar
/{userSlug}/hotel/booking-confirm/{encryptedBooking}	Página de confirmación
/{userSlug}/hotel/booking/{encryptedBooking}/receipt	Recibo apto para impresión
/{userSlug}/hotel/login, /register, /forgot-password	Autenticación de clientes (solo invitados)
/{userSlug}/hotel/profile	Perfil de cliente autenticado

Tablas de la base de datos

El paquete agrega más de 20 tablas, todas con prefijo holidayz_:

• holidayz_setups, holidayz_destinations, holidayz_custom_pages
• holidayz_rooms, holidayz_room_images, holidayz_room_tags,

holidayz_room_features, holidayz_room_taxes, holidayz_room_room_features

• holidayz_facilities, holidayz_facility_children
• holidayz_coupons, holidayz_coupon_usages
• holidayz_hotel_customers, holidayz_password_resets
• holidayz_room_bookings, holidayz_room_booking_items,

holidayz_room_booking_item_facilities, holidayz_room_booking_item_taxes

• holidayz_carts, holidayz_cart_items, además de su _instalaciones

y _impuestos pivotes

• holidayz_contacts, holidayz_reviews
• holidayz_blogs, holidayz_newsletters

Permisos

La visibilidad de la barra lateral de administración y el acceso a las rutas de administración se controlan mediante permisos de Spatie, principalmente `manage-holidayz- dashboard` y permisos por recurso (manage-holidayz-rooms, manage-holidayz-bookings, etc.). Asígnalos en **Configuración → Roles y permisos**.

Notas del operador

• IDs cifrados — Tanto las páginas de detalle de la habitación como la reserva

las confirmaciones usan URLs firmadas de Laravel ({encryptedRoom}, {encryptedBooking}) para que los IDs numéricos internos no queden expuestos en la barra de direcciones.

• Integración de pagos — Holidayz usa el mismo Mewayz compartido

Capa de PSP; las pasarelas de pago que estén activas en la plataforma (Stripe, Razorpay, PayPal, etc.) funcionan automáticamente para el pago del hotel, sin necesidad de configurar una pasarela aparte.

• Contenido multilingüe — Entradas de blog, descripciones de hoteles y

las páginas personalizadas admiten el spatie/laravel-translatable patrón utilizado en todo Mewayz.

• Independiente de las reservas — Holidayz está diseñado específicamente para

hoteles y no comparte tablas con el módulo genérico de Reservas.

• La userSlug en las URL públicas se asigna al inquilino del operador, así que

cada revendedor de marca blanca tiene su propio sitio web Holidayz bajo su propio slug.