Holidayz mewayz

Holidayz in 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 has three distinct user types:

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

help with customer support, view bookings, and run basic operations under the Company's oversight.

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.

Holidayz Dashboard

• 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 card computed from available rooms ÷ booked

noches-habitación

• Reservas recientes lista con acciones rápidas de aprobar / rechazar
• Próximos registros de entrada for the next 7 days

Gestión de salas

Browse Rooms

• 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 Save.

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 → Hotel Customers.
• 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).

• Customers can also self-register through the public site at

/{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. Customer adds rooms to cart on the public site.
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 — Inbound messages from the public contact form
• 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"
• Testimonials Settings — Customer testimonials
• 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.
• About-Us Settings — 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}	Single room detail page (signed URL hides internal ID)
`/{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

The package adds 20+ tables, all prefixed 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 is purpose-built for

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.