Alojamientos y el editor de alojamientos

Qué contiene un alojamiento, cómo lo añade y lo edita el equipo en el panel, sus fotografías y precios, y cómo la publicación decide lo que muestra el sitio web.

Para el paquete Full Stack

Qué contiene un alojamiento

Parte	Valores
Textos, en inglés y árabe	Título (160 caracteres), descripción corta (500), descripción (5000), la pista de ubicación que leen los huéspedes en lugar de una dirección (500) y hasta 20 normas de la casa. El inglés es obligatorio para el título.
Tipo	`villa`, `apartment`, `cabin`, `chalet`, `loft` o `cottage`, cada uno con su propio icono en el sitio web
Destino	Uno de los destinos de la empresa
Capacidad	Dormitorios, camas, baños, el máximo de huéspedes que aloja y una superficie opcional en metros cuadrados
Precios	Una tarifa por noche y una tarifa de limpieza, en dólares estadounidenses enteros, y el número mínimo de noches
Llegada	Horas de check-in y check-out, `15:00` y `11:00` por defecto, desde los ajustes de la empresa
Comodidades	Cualquiera de las 18 que crea la carga inicial: Wi-Fi, cocina, piscina, jacuzzi, aparcamiento, aire acondicionado, calefacción, lavadora, zona de trabajo, chimenea, vistas al mar, vistas a la montaña, jardín, barbacoa, admite mascotas, cargador para vehículos eléctricos, gimnasio, cuna
Fotografías	Hasta 30, en el orden en que las muestra el sitio web; la primera es la fotografía de la tarjeta y de la portada
Estado	`draft` o `published`
Interno	Una referencia asignada en orden (`S001`, `S002` y así sucesivamente), un slug de dirección creado a partir del título, un indicador de destacado en la página de inicio y notas que el sitio web nunca muestra

Hay una tarifa por noche por alojamiento: sin tarifas de temporada ni de fin de semana, impuestos ni cargos por servicio. Una cotización es la tarifa por noche por el número de noches más la tarifa de limpieza una vez, y la reserva conserva las cifras con las que se hizo, así que un cambio posterior de tarifa nunca altera lo que un huésped aceptó pagar.

Publicación y lo que muestra el sitio web

Estado	En el sitio web
Borrador	Oculto, y responde como no encontrado en todas las rutas públicas. Todo alojamiento nuevo empieza aquí.
Publicada	Listado, con búsqueda, reservable, en el mapa del sitio y seleccionable para la página de inicio. La primera publicación fija su fecha de publicación, que una nueva publicación posterior conserva.

Se rechaza la publicación hasta que el alojamiento tenga tres fotografías ("Añade tres fotografías antes de publicar este alojamiento.") y su título, descripción corta, descripción y pista de ubicación en ambos idiomas.
Para retirar un alojamiento del sitio web, devuélvelo a borrador: desaparece de todas las páginas públicas y conserva sus reservas, reseñas e historial. El panel no tiene botón para eliminar. La ruta de eliminación de la API quita un alojamiento solo mientras ninguna de sus reservas ocupe noches; cualquier reserva que no esté cancelada, incluida una completada, lo conserva ("Este alojamiento aún tiene reservas que no están canceladas, así que no se puede eliminar.").
El hero y los alojamientos destacados de la página de inicio se eligen en Ajustes, Página de inicio, entre los alojamientos publicados.

La lista de alojamientos

Recuentos de alojamientos totales, publicados y en borrador, una búsqueda por nombre o referencia, y filtros por estado, tipo y destino, con los actualizados más recientemente primero.
El botón Abrir de cada fila abre el editor de alojamientos, y Añadir alojamiento empieza uno nuevo.
El panel no tiene botón para eliminar: un alojamiento sale del sitio web volviendo a borrador. La ruta de eliminación de la API está pensada para las herramientas propias de un desarrollador.

El editor de alojamientos

/en/dashboard/stays/new añade un alojamiento, guardado como borrador, y /en/dashboard/stays/<id> cambia uno. El editor reúne sus partes en una página, con una tarjeta de publicación a su lado.

Parte	Qué contiene
Contenido	El título, la descripción corta y la descripción en ambos idiomas, y el slug de la dirección
Tipo y destino	El tipo de lugar, su destino y la pista de ubicación en ambos idiomas
Capacidad	Huéspedes, dormitorios, camas, baños y superficie
Precios y llegada	Tarifa por noche, tarifa de limpieza, noches mínimas, horas de check-in y check-out
Comodidades	Una lista de comprobación de las comodidades
Normas de la casa	Una lista de normas, cada una en ambos idiomas, que se añaden y se quitan con los botones Añadir y Quitar
Fotografías	Se suben desde el equipo y se ordenan con Mover antes y Mover después; la posición uno es la portada
Publicación	Guardar, Publicar o Despublicar, el indicador de destacado en la página de inicio y Ver alojamiento una vez publicado

Las fotografías se suben al añadirlas y la API las recodifica como JPEG, de 1920 píxeles de ancho como máximo, con una copia más pequeña para las tarjetas de alojamientos.

El editor comprueba la capacidad como lo hace la API: dormitorios 0 o más, para un estudio; camas, baños y huéspedes 1 o más; y la superficie, que puede quedar vacía, 1 o más cuando se indica. No tiene campos para la posición en el mapa ni para el título y la descripción SEO y nunca los envía, así que un guardado conserva los valores que el alojamiento ya tiene.

Quién puede hacer qué

Permiso	Permite
`stays.view`	Ver todos los alojamientos, incluidos los borradores
`stays.create`	Añadir alojamientos
`stays.edit`	Cambiar datos, precios y fotografías
`stays.publish`	Publicar y despublicar
`stays.delete`	Eliminar alojamientos mediante la ruta de eliminación de la API (el panel no tiene botón para eliminar)

Los dos roles de la carga inicial, Super Admin y Manager, tienen los cinco.

Qué comprueba la API

El tipo, el destino y cada clave de comodidad se validan contra sus listas, y un recuento o un importe por debajo de su mínimo se rechaza nombrando el campo: los dormitorios pueden ser 0, y todos los demás recuentos empiezan en 1 (al menos una cama, un baño, un huésped y una noche, y una tarifa por noche de un dólar). La superficie es opcional, y de un metro cuadrado como mínimo cuando se indica; la tarifa de limpieza puede ser 0.
Un slug se hace único a partir del título cuando no se indica, se rechaza un slug que ya está en uso, y una referencia nunca se asigna dos veces.
La API también acepta la posición en el mapa de un alojamiento (latitude, longitude), su título y descripción SEO en ambos idiomas y los pies de las fotografías; la carga inicial los rellena para los alojamientos de demostración, y la página del alojamiento dibuja su mapa solo cuando hay una posición definida. El editor de alojamientos nunca envía la posición en el mapa ni los textos SEO, así que se definen mediante la API, y un guardado desde el editor los deja como están.
La lista del sitio web acepta destination (slug), checkIn y checkOut (YYYY-MM-DD, ambos o ninguno), guests, type, sort (recommended, price_asc, price_desc, rating), y pagina con page y page_size (6 por defecto, 24 como máximo). Un valor desconocido en cualquiera de ellos se rechaza en lugar de ignorarse.

Referencia de la API