Les séjours et l'éditeur de séjour
Ce que contient un séjour, comment l'équipe en ajoute et en modifie un dans le tableau de bord, ses photographies et ses tarifs, et comment la publication décide de ce que montre le site.
Pour le pack Full Stack
Ce que contient un séjour
| Partie | Valeurs |
|---|---|
| Textes, en anglais et en arabe | Titre (160 caractères), description courte (500), description (5000), l'indication de lieu que lisent les voyageurs à la place d'une adresse (500), et jusqu'à 20 règles du règlement intérieur. L'anglais est obligatoire pour le titre. |
| Type | villa, apartment, cabin, chalet, loft ou cottage, chacun avec sa propre icône sur le site |
| Destination | Une des destinations de la société |
| Capacité | Chambres, lits, salles de bain, nombre maximal de voyageurs logés, et une surface facultative en mètres carrés |
| Tarifs | Un tarif par nuit et des frais de ménage, en dollars américains entiers, et le nombre minimal de nuits |
| Arrivée | Heures d'arrivée et de départ, 15:00 et 11:00 par défaut, issues des paramètres de la société |
| Équipements | N'importe lequel des 18 que crée le seed : Wi-Fi, cuisine, piscine, jacuzzi, parking, climatisation, chauffage, lave-linge, espace de travail, cheminée, vue sur la mer, vue sur la montagne, jardin, barbecue, animaux acceptés, borne de recharge, salle de sport, lit bébé |
| Photographies | Jusqu'à 30, dans l'ordre où le site les montre ; la première est la photographie de la carte et de la couverture |
| Statut | draft ou published |
| Interne | Une référence attribuée dans l'ordre (S001, S002 et ainsi de suite), un slug d'adresse fait à partir du titre, un indicateur de mise en avant sur la page d'accueil et des notes que le site ne montre jamais |
Il y a un seul tarif par nuit et par séjour : pas de tarifs saisonniers ou de week-end, ni de taxes ou de frais de service. Un devis est le tarif par nuit fois le nombre de nuits plus les frais de ménage une fois, et la réservation garde les chiffres avec lesquels elle a été faite, donc un changement de tarif ultérieur ne modifie jamais ce qu'un voyageur a accepté de payer.
La publication et ce que montre le site
| Statut | Sur le site |
|---|---|
| Brouillon | Masqué, et répond comme introuvable sur chaque route publique. Chaque nouveau séjour commence ici. |
| Publié | Listé, consultable, réservable, dans le sitemap, et sélectionnable pour la page d'accueil. La première publication fixe sa date de publication, qu'une republication ultérieure conserve. |
- La publication est refusée tant que le séjour n'a pas trois photographies (« Add three photographs before publishing this stay. ») ni son titre, sa description courte, sa description et son indication de lieu dans les deux langues.
- Pour retirer un séjour du site, remettez-le en brouillon : il disparaît de chaque page publique et garde ses réservations, ses avis et son historique. Le tableau de bord n'a pas de bouton de suppression. La route de suppression de l'API ne supprime un séjour que tant qu'aucune de ses réservations ne retient de nuits ; toute réservation non annulée, une réservation terminée comprise, le conserve (« This stay still has bookings that are not cancelled, so it cannot be deleted. »).
- Le hero et les séjours en vedette de la page d'accueil se choisissent sous Paramètres, Page d'accueil, parmi les séjours publiés.
La liste des séjours
- Les totaux des séjours, publiés et en brouillon, une recherche par nom ou référence de séjour, et des filtres de statut, de type et de destination, les plus récemment mis à jour d'abord.
- Le bouton Open de chaque ligne ouvre l'éditeur de séjour, et Add stay en commence un nouveau.
- Le tableau de bord n'a pas de bouton de suppression : un séjour quitte le site en repassant en brouillon. La route de suppression de l'API existe pour les outils propres à un développeur.
L'éditeur de séjour
/en/dashboard/stays/new ajoute un séjour, enregistré en brouillon, et /en/dashboard/stays/<id> en modifie un. L'éditeur réunit ses parties sur une seule page, avec une carte de publication à côté.
| Partie | Ce qu'il contient |
|---|---|
| Contenu | Le titre, la description courte et la description dans les deux langues, et le slug d'adresse |
| Type et destination | Le type de lieu, sa destination, et l'indication de lieu dans les deux langues |
| Capacité | Voyageurs, chambres, lits, salles de bain et surface |
| Tarifs et arrivée | Tarif par nuit, frais de ménage, nuits minimales, heures d'arrivée et de départ |
| Équipements | Une liste à cocher des équipements |
| Règlement intérieur | Une liste de règles, chacune dans les deux langues, ajoutées et retirées avec les boutons Add et Remove |
| Photographies | Envoyées depuis l'ordinateur et ordonnées avec Move earlier et Move later ; la position un est la couverture |
| Publication | Save, Publish ou Unpublish, l'indicateur de mise en avant sur la page d'accueil, et View stay une fois publié |
Les photographies sont envoyées au moment où elles sont ajoutées et réencodées par l'API en JPEG, de 1920 pixels de large au plus, avec une copie plus petite pour les cartes de séjour.
L'éditeur vérifie la capacité comme le fait l'API : chambres 0 ou plus, pour un studio ; lits, salles de bain et voyageurs 1 ou plus ; et la surface, qui peut rester vide, 1 ou plus quand elle est renseignée. Il n'a aucun champ pour la position sur la carte ni pour le titre et la description SEO et ne les envoie jamais, donc un enregistrement conserve les valeurs que le séjour contient déjà.
Qui peut faire quoi
| Permission | Autorise |
|---|---|
stays.view | Voir chaque séjour, brouillons compris |
stays.create | Ajouter des séjours |
stays.edit | Modifier les détails, les tarifs et les photographies |
stays.publish | Publier et dépublier |
stays.delete | Supprimer des séjours par la route de suppression de l'API (le tableau de bord n'a pas de bouton de suppression) |
Les deux rôles du seed, Super Admin et Manager, détiennent les cinq.
Ce que vérifie l'API
- Le type, la destination et chaque clé d'équipement sont validés par rapport à leurs listes, et un nombre ou un montant en dessous de son minimum est refusé en nommant le champ : les chambres peuvent être 0, et tous les autres nombres commencent à 1 (au moins un lit, une salle de bain, un voyageur et une nuit, et un tarif par nuit d'un dollar). La surface est facultative, et d'au moins un mètre carré quand elle est renseignée ; les frais de ménage peuvent être 0.
- Un slug est rendu unique à partir du titre quand il n'est pas fourni, un slug déjà utilisé est refusé, et une référence n'est jamais attribuée deux fois.
- L'API accepte aussi la position d'un séjour sur la carte (
latitude,longitude), son titre et sa description SEO dans les deux langues et les légendes des photographies ; le seed les remplit pour les séjours de démonstration, et la page du séjour ne dessine sa carte que si une position est définie. L'éditeur de séjour n'envoie jamais la position sur la carte ni les textes SEO, ils se définissent donc par l'API, et un enregistrement depuis l'éditeur les laisse tels quels. - La liste du site accepte
destination(slug),checkInetcheckOut(YYYY-MM-DD, les deux ou aucun),guests,type,sort(recommended,price_asc,price_desc,rating), et la pagination avecpageetpage_size(6 par défaut, 24 au plus). Une valeur inconnue dans l'un d'eux est refusée plutôt qu'ignorée.