Documentation de l'extension HBook pour WordPress

Si vous avez des questions pour lesquelles vous ne trouvez pas de réponse dans cette documentation, n'hésitez pas à nous envoyer un message via notre page de contact que vous trouverez ici.

Installation de l'extension

Il y a deux méthodes pour installer l'extension WordPress :

1. en utilisant l'outil d'installation de WordPress
2. en téléversant l'extension via FTP

1. En utilisant l'outil d'installation de WordPress

1. Allez dans le menu Extensions > Ajouter
2. Cliquez sur Téléverser
3. Sélectionnez le fichier compressé hbook.zip
4. Cliquez sur Installer
5. Une fois que vous avez installé l'extension, cliquez sur Activer

2. En téléversant l'extension via FTP

1. Allez dans le menu Downloads de CodeCanyon et téléchargez l'extension Lorsque vous téléchargez l'extension, vous obtenez toujours la dernière version disponible.

• Si vous procédez via FTP:
  2. Décompressez le zip afin d'avoir un dossier hbook que vous pourrez transférer ensuite sur votre serveur.
  3. Transférer le dossier hbook dans le répertoire wp-content/plugins/ sur votre serveur
• Si vous travaillez depuis votre Gestionnaire de fichiers
  2. Téléversez le fichier compressé hbook.zip dans le répertoire wp-content/plugins/ sur votre serveur
  3. Cliquez sur extraire pour le décompresser

4. Connectez-vous à WordPress puis allez dans le menu Extensions
5. Trouvez l'extension HBook et cliquez sur Activer

---

Une fois que vous avez installé et activé l'extension HBook, vous devrez valider votre licence afin de débloquer les menus et fonctionnalités de HBook. Cela s'effectue en renseignant Code d'Achat dans le menu HBook->Licence.

Mises à jour de l'extension

Afin d'ajouter de nouvelles fonctionnalités, de rester à jour avec les évolutions du software WordPress, de corriger d'éventuels bugs, nous mettons régulièrement à jour l'extension HBook.

Il y a deux méthodes pour mettre à jour l'extension :

• Mises à jour automatique
• Mise à jour via FTP ou Gestionnaire de fichiers

Quelle que soit la méthode choisie, il est toujours conseillé de faire une sauvegarde. It is not compulsory but backing up periodically your entire installation (entire directory structure + database) is a good idea, especially before making any update to themes, plugins, core files, etc. Pour en savoir plus à ce sujet, voir ici.

Mises à jour automatique

Lorsqu'une nouvelle version d'HBook est sortie, vous verrez une notification dans la page "Extensions" vous pourrez faire la mise à jour en cliquant sur Mettre à jour maintenant.

Mise à jour via FTP ou Gestionnaire de fichiers

1. Allez dans le menu Downloads de CodeCanyon et téléchargez à nouveau l'extension Lorsque vous téléchargez l'extension, vous obtenez toujours la dernière version disponible.
2. Allez dans le menu Extensions et désactivez HBook
3. Sur votre serveur, effacez le répertoire hbook que vous trouverez dans wp-content/plugins. Notez qu'aucun de vos contenus ou paramètres seront effacés.
• Si vous procédez via FTP:
  4. Décompressez le zip afin d'avoir un dossier hbook que vous pourrez transférer ensuite sur votre serveur.
  5. Transférer le dossier hbook dans le répertoire wp-content/plugins/ sur votre serveur
• Si vous travaillez depuis votre Gestionnaire de fichiers
  4. Téléversez le fichier compressé hbook.zip dans le répertoire wp-content/plugins/ sur votre serveur
  5. Cliquez sur extraire pour le décompresser
6. Trouvez l'extension HBook dans le menu HBook et cliquez sur Activer

---

Notifications de mises à jour pour un achat effectué directement avec Maestrel

Si vous avez acheté HBook en tant qu'extension incluse avec un de nos thèmes Maestrel, nous vous enverrons une notification par email chaque fois qu'une mise à jour de HBook ou de nos thèmes est disponible. Vous avez toujours la possibilité de "Vous désabonner" de ces emails.




Notifications de mise à jour pour un achat effectué sur CodeCanyon

Si vous souhaitez recevoir un email de notification lorsqu'une nouvelle version de HBook est disponible, vous pouvez cocher la case Get notified by email if this item is updated dans le page Downloads de CodeCanyon.

Types d'hébergement

Dans cette section de la documentation, vous trouverez des informations au sujet du menu Types d'hébergement du menu HBook. Pour que l'extension fonctionne, vous devez créer au moins 1 type d'hébergement.

---

Créer un nouveau Type d'hébergement

Vous pouvez créer autant de types d'hébergement que vous le souhaitez. Pour chaque type d'hébergement (par exemple"Chambre double), vous pourrez indiquer combien vous en avez de ce type (par exemple "10" chambres doubles).

• Cliquez sur Ajouter un nouveau Type d'hébergement


• Indiquez le Titre de l'Hébergement et la Description de l'hébergement. Vous pouvez utiliser les shortcodes ou les blocs pour afficher un formulaire de recherche, un calendrier de disponibilités, une grille tarifaire...
  
  Avec l'éditeur Classique :
  Avec l'éditeur Gutenberg :
  
  1. Indiquez le Titre de l'Hébergement : ceci est le nom du type d'hébergement tel qu'il apparaîtra dans le front-end. Vous pouvez créer un nom différent pour le côté admin (voir ci-dessous)
  2. Vous verrez apparaître l'id de l'hébergement ici : vous pourrez en avoir besoin lors de l'utilisation des shortcodes
  3. Si vous souhaitez utiliser les pages de types d'hébergement créés dans HBook pour montrer vos hébergements, indiquez le contenu de votre page ici. Vous pouvez utiliser les shortcodes de HBook pour ajouter une table tarifaire, un calendrier de disponibilité ou un formulaire de recherche. Par défaut, si un de ces shortcodes est utilisé dans une page de "Type d'hébergement", HBook affichera la table tarifaire, le calendrier de disponibilité pour cet hébergement.


• Si vous le souhaitez, vous pouvez choisir une Image mise en avant qui apparaîtra dans la liste des résultats de recherche et dans les listes de types d'hébergement.
  

---

Paramètres du type d'hébergement

Les paramètres sont ici pour fournir les informations nécessaires au système de réservation. La Capacité d'accueil normale, la Capacité d'accueil maximale et le Nombre d'hébergements de ce type sont les seuls paramètres requis pour qu'HBook fonctionne.
Voici les paramètres que vous trouverez pour les types d'hébergement :

• Paramètres généraux
• Paramètres de capacité d'accueil
• Descriptions
• Options d'affichage
• Blocages automatiques
• Réservation multiple

---

Paramètres généraux

1. Indiquez le nombre d'hébergements de ce type (requis)
2. Si vous avez plusieurs hébergements pour un certain Type d'Hébergement, vous pouvez vouloir personnaliser les noms/numéros pour chaque hébergement. Si vous cliquez sur Modifier la numérotation des hébergements, vous pourrez renommer chaque hébergement de ce type.

---

Paramètres de capacité d'accueil

1. Entrez la capacité d'accueil normale (requis) : cela correspond au nombre de personnes pour lequel est défini le tarif de base de l'hébergement comme renseigné dans HBook->Tarifs.
2. Entrez la capacité d'accueil maximum (requis) : cela correspond au nombre maximum de personnes que peut contenir l'hébergement.
3. Entrez la capacité d'accueil minimum (optionnel) : si vous souhaitez appliquer un nombre minimum de personnes requis, vous pouvez l'indiquer ici.

Si vos tarifs changent selon le nombre de personnes :

• Vous utiliserez la capacité d'accueil normale afin d'indiquer le nombre de personnes jusqu'auquel s'applique le tarif de base comme indiqué dans HBook > Tarifs. Et vous indiquerez la "Capacité d'accueil maximum" au nombre de personnes maximum que ce type d'hébergement peut accueillir.
• Vous pourrez ensuite indiquer dans HBook > Tarifs le "Tarif par adulte supplémentaire (au-dessus de la capacité normale d'accueil)" ainsi que le "Tarif par enfant supplémentaire (au-dessus de la capacité normale d'accueil)".

Vous pouvez voir des exemples de paramétrage des capacités d'accueil ici.

---

Descriptions

1. Indiquez la description affichée dans les résultats de recherche (optionnel) : cela sera utilisé lors de l'utilisation du shortcode [hb_booking_form] ou du bloc "Formulaire de réservation".
2. Entrez la Description affichée dans la liste des types d'hébergement (optionnel) : cela sera montré lors de l'utilisation du shortcode [hb_accommodation_list] ou du bloc "Liste de type d'hébergement".
3. Vous pouvez donner un nom abrégé au type d'hébergement. Celui-ci sera utilisé dans la page Réservations. Ceci pourrait être utile si vous avez un long nom d'hébergement que vous souhaitez garder pour le front-end mais simplifier pour le calendrier du back-end.

---

Options d'affichage

1. Vous pouvez définir vos préférences en ce qui concerne la Présentation du type d'hébergement. HBook vous permet de :
   • utiliser l'article par défaut de HBoook
   • appliquer un modèle de pages
   • ou utiliser un autre article ou une autre page pour présenter votre type d'hébergement
   
   
2. Entrez le prix de départ (optionnel) : cela sera affiché dans la liste des types d'Hébergements lors de l'utilisation du shortcode [hb_accommodation_list].

Si vous souhaitez utiliser le post du type d'hébergement pour présenter cet hébergement :

1. Vous inquerez que vous utilisez cette page pour présenter votre type d'hébergement....
2. ... puis choisir le modèle/template qui sera utilisé

Si vous souhaitez utiliser une autre page pour présenter cet hébergement :

1. Vous indiquerez que vous utilisez un autre article ou une autre page pour présenter votre type d'hébergement...
2. ... et vous entrerez l'id de la page ou du post qui doit être utilisé.

Cela aura plusieurs impacts :

• Vous pouvez utiliser les shortcodes de HBook sur la page utilisée pour présenter cet hébergement sans avoir besoin de spécifier l'id du type d'hébergement. HBook saura que c'est pour ce type d'hébergements.
• À l'étape de sélection du type d'hébergement, le bouton "Voir cet hébergement" ouvrira un nouvel onglet avec la page indiquée pour la présentation de ce type d'hébergement.
• À l'étape de sélection du type d'hébergement, si vous avez indiqué que la vignette et le titre sont des liens, un nouvel onglet sera ouvert avec la page indiquée pour la présentation de ce type d'hébergement.
• Dans la liste des types d'hébergement, si vous avez indiqué que la vignette est un lien, un nouvel onglet sera ouvert avec la page indiquée pour la présentation de ce type d'hébergement.

---

Blocages automatiques

1. Indiquez le temps de préparation. HBook bloquera automatiquement x jours avant la date d'arrivée et après la date de départ de la réservation.
2. Indiquez les hébergements liés : y vous indiquerez ici les ids des hébergements qui doivent être automatiquement bloqués lorsque ce type d'hébergement est réservé. Si vous avez besoin de spécifier le nombre d'hébergements qui ont besoin d'être bloqués pour chaque type d'hébergement lié, vous pouvez indiquer ce nombre entre ().
Vous pouvez voir des exemples de paramétrage d'hébergements liés ici.

---

Réservation multiple

Indiquez si vous souhaitez exclure ou non ce type d'hébergement des résultats de recherche lors d'une réservation avec hébergements multiples.

• Lorsque ce paramètre est à "Toujours", HBook ne montrera jamais ce type d'hébergement dans les résultats de recherche lorsque plusieurs hébergements sont nécessaires.
• Lorsque ce paramètre est à "Pour les recherches globales uniquement", HBook ne montrera pas ce type d'hébergement dans les résultats de recherche lors d'une recherche globale, si plusieurs hébergements sont nécessaires. Par contre, lors d'une recherche pour un type d'hébergement spécifique, il sera possible de réserver plusieurs hébergements de ce type, s'il est possible d'héberger le nombre de personnes recherchées avec plusieurs hébergements de ce type.
• Lorsque ce paramètre est à "Jamais", HBook montrera ce type d'hébergement dans les résultats de recherche uniquement lorsque le nombre de personnes recherchées correspond à la capacité d'accueil de ce type d'hébergement. Cet hébergement n'apparaîtra pas dans un résultat de recherche comprenant plusieurs hébergements.

---

Exemples de paramétrages de capacité d'accueil :

• Tarif par hébergement indépendamment du nombre de clients
  Dans cet exemple, nous avons une chambre de type "Chambre triple" qui peut accueillir 2 ou 3 personnes. Le tarif est de 75€ par chambre en saison "Hiver" et de 95€ par chambre en saison "Été" (que ce soit pour 2 ou 3 personnes).
  Capacité d'accueil normale et maximum correspondent au nombre maximum de personnes qui peuvent être accueillies dans ce type d'hébergement. la capacité minimum d'accueil est de 2 pour empêcher ce type de chambre d'être réservée par 1 seule personne. Nous utilisons uniquement le Tarif de base puisqu'il n'y a pas besoin de définir des "Prix supplémentaire".
• Tarif de base pour l'hébergement auquel s'ajoute un tarif par personne supplémentaire
  Dans cet exemple, nous avons un appartement pour 4 personnes maximum que nous louons à la semaine ; le tarif est identique pour 1 ou 2 personnes, mais un supplément s'ajoute pour les 3ème et 4èmes personnes.
  La capacité d'accueil normale est de 2 personnes et la capacité maximale est de 4 personnes (cela nous permettra de définir le tarif pour 1 ou 2 personnes puis le tarif par personne supplémentaire). Dans HBook->Tarifs, nous indiquons le "Tarif de base" au tarif pour 1/2 personnes, puis nous utilisons le "Tarif par personne supplémentaire" pour indiquer le prix à appliquer pour les 3ème et 4ème personnes.
• Le tarif est par personne et non par hébergement
  Dans cet exemple, nous avons un appartement familial qui peut héberger jusqu'à 5 personnes. Le prix est par personne : un adulte paiera €50 par nuit et un enfant sera facturé à 30€ par nuit.
  La capacité d'accueil normale est de 1 personne et la capacité maximale est de 5 personnes (cela permettra de définir un prix par personne). La capacité d'accueil minimum est de 2 personnes. Dans HBook->Tarifs, nous indiquons le "Tarif de base" correspondant au prix pour 1 adulte. Ensuite, nous indiquons le "Prix par adulte au-dessus de la capacité d'accueil normale" à 50€ (prix par adulte) et le "Prix par enfant au-dessus de la capacité d'accueil normale" à 30€ (prix par enfant).
• Type d'hébergement avec une capacité d'accueil minimum. Dans cet exemple, nous avons une maison de vacances qui peut être louée par chambre ou dans son intégralité. Nous avons créé un type d'hébergement "Maison de vacances complète" mais nous ne souhaitons pas qu'elle soit réservée par moins de 5 personnes. Ainsi, ce Type d'Hébergement ne sera pas montré dans les résultats de recherche si la recherche est pour moins de 5 personnes.

Exemples de paramétrage d'hébergements liés :

• Lorsqu'une réservation est reçue pour un hébergement de ce type, un hébergement du type ayant l'accom_id 2 est automatiquement bloqué pour ces dates.
• Lorsqu'une réservation est reçue pour un hébergement de ce type, un hébergement du type ayant l'id 2, un hébergement du type ayant l'id 3 et un hébergement du type ayant l'id 4 doivent être bloqués pour ces dates.
• Lorsqu'une réservation est reçue pour un hébergement de ce type, 3 hébergements du type ayant l'id 2 et 5 hébergements du type ayant l'id 3 doivent être automatiquement bloqués pour ces dates.

Paramétrage des prix

Dans cette section de la documentation, vous trouverez des informations au sujet des sous-menus suivants de HBook :

1. Saisons
2. Règles de réservations
3. Tarifs
4. Services supplémentaires
5. Taxes

---

1. Saisons

Vous trouverez la page pour le paramétrage des Saisons dans le menu HBook > Saisons. Pour que l'extension fonctionne correctement, vous devez créer au moins 1 saison. Notez que puisque l'intégralité des jours réservables doivent appartenir à une saison, vous devez définir une/des saison(s) avec une date de fin correspondant au moins à la Date maximum pouvant être sélectionnée pour une réservation (ce paramètre se trouve dans HBook > Divers).

Étape 1 : Créer une nouvelle saison

1. Cliquer sur Ajouter une nouvelle saison
2. Entrez un nom
3. Choisissez le statut de la saison :
   • Prioritaire: ceci est le statut le plus fort. Lorsqu'une date est trouvée dans plusieurs saisons, si elle appartient à une saison "Prioritaire", alors les règles et tarifs appliqués seront ceux associés à cette saison.
   • Regulière: ceci est le statut intermédiaire. Lorsqu'une date est trouvée dans plusieurs saisons, si il n'y a pas de saison "Prioritaire", mais une saison "Régulière", alors les règles et tarifs appliqués seront ceux associés à cette saison.
   • Par défaut : ceci est le statut le plus bas. Lorsqu'une date est trouvée uniquement dans une saison "Par défaut", alors les règles et tarifs appliqués seront ceux associés à cette saison.
4. Cliquer sur Sauvegarder

Ajouter une ou plusieurs périodes pour la saison

5. Cliquer sur l'icône +.
6. Entrez une date de début
7. Entrez une date de fin
8. Selectionnez les jours concernés pour cette période
9. Cliquer sur Sauvegarder

---

Exemples :

1. Basse saison, Été et Très haute saison
2. Jours en semaine, Week-end et Saison haute
3. Été, Vacances scolaires et reste de l'année :

---

2. Règles de réservations

Vous trouverez la page des Règles de réservation dans le menu HBook > Règles de réservation. Les Règles de réservation sont optionnelles. Il y a 5 types de règles de réservation.

1. Jours d'arrivée : définissez quels sont les jours autorisés pour une arrivée.
2. Jours de départ : définissez quels sont les jours autorisés pour un départ.
3. Durée minimum de séjour : définissez la durée minimum de séjour.
4. Durée maximum de séjour : définissez la durée maximum de séjour.
5. Règles avancées : definissez les règles avancées afin de créer des conditions obligatoires de séjour, des tarifs spéciaux, des remises ou des coupons.

---

Jour autorisés d'arrivée et de départ

Avec les Jours d'arrivée autorisés et Jours de départ autorisés, vous pouvez indiquer quels jours vos clients peuvent débuter et terminer leur séjour. Cela peut être paramétré différemment selon les saisons et les types d'hébergement.

Exemples :

1. Jour de rotation le samedi toute l'année pour tous les types d'hébergement :
2. Jours d'arrivée et de départ différents selon les saisons :

---

Durée minimum et maximum de séjour

Avec les paramètres de Durée minimum et Durée maximum de séjour, vous pouvez indiquer le nombre de nuits minimum et maximum autorisés. Cela peut être paramétré différemment selon les saisons et les types d'hébergement.

Exemples :

1. Durée minimum de séjour différente selon les saisons (7 nuits minimum en période de "Vacances" et 2 nuits en "Hors saison" :
2. Durée minimum de séjour selon le type d'hébergement et la saison :
3. Durée maximum de séjour pour l'ensemble des types d'hébergement et des saisons :

---

Règles avancées

Ceci est un outil robuste qui vous permettra de définir des paramètres conditionnels. Cet outil a deux buts :

• définir les conditions pour différents scénarios de réservation qui ne peuvent pas être paramétrés avec uniquement les paramètres ci-dessus
• définir les conditions dans lesquelles une remise ou un coupon peuvent être appliqués

Il y a 5 types de règles avancées :

1. Obligatoire : si le jour d'arrivée sélectionné comme date d'arrivée correspond à l'un des jours d'arrivée indiqués dans la règle avancée, la demande de réservation doit remplir les conditions indiquées dans la règle (contrainte de réservation).
2. Tarif Spécial :si la recherche de disponibilité correspond aux critères définis dans la règle, le tarif spécial est appliqué. Vous indiquerez le tarif correspondant à cette règle dans le menu HBook > Tarifs
3. Obligatoire et Tarif Spécial : la règle est à la fois une règle de réservation obligatoire (contraignante) et associé à un tarif spécial.
4. Remise : si la recherche de disponibilité correspond aux critères de la règle, alors une remise est appliquée. Vous définirez le type de remise (pourcentage ou montant fixe) ainsi que sa valeur pour chaque type hébergement et chaque saison concernée dans Tarifs > Remises.
5. Coupon : si la recherche de disponibilité correspond aux critères de la règle et si le client a entré un coupon valide, une remise sera appliquée. Vous définirez le nom du coupon, le type de remise (pourcentage ou montant fixe) ainsi que sa valeur pour chaque type d'hébergement et chaque saison concernée dans Tarifs > Coupons.

Étape 1 : Créer une règle de réservation avancée

Pour créer une règle avancée, cliquez sur Ajouter une règle.

Étape 2: Indiquez les attributs de la nouvelle règle

1. Indiquez le nom de la règle
2. Sélectionnez le type de règle
3. Sélectionnez un ou plusieurs jours d'arrivée
4. Sélectionnez un ou plusieurs jours de départ
5. Entrez le nombre minimum de jours (si applicable)
6. Entrez le nombre maximum de jours (si applicable)
7. Sélectionnez pour quel(s) types d'hébergement cette règle est applicable. Vous ne verrez ce paramètre pour les règles de type "Obligatoire" et "Obligatoire avec tarif spécial". Pour les règles avancées de type "Tarif spécial", "Remise" et "Coupon", vous indiquez les types d'hébergements et saisons directement dans la page Tarifs.
8. Sélectionnez pour quelle(s) saisons cette règle est applicable. Vous ne verrez ce paramètre pour les règles de type "Obligatoire" et "Obligatoire avec tarif spécial". Pour les règles avancées de type "Tarif spécial", "Remise" et "Coupon", vous indiquez les types d'hébergements et saisons directement dans la page Tarifs.
9. Cliquer sur Sauvegarder

Exemples :

1. Durée fixe de séjour pour une arrivée sur un jour précis (Si l'arrivée est un lundi, le départ doit obligatoirement se faire le vendredi suivant :
2. Remises différentes pour des séjours compris entre 10 et 29 nuits et des séjours de 30 nuits ou plus :
3. Coupons avec conditions d'application (seulement valides pour des séjours entre 3 et 7 nuits) :

---

3. Tarifs

Vous trouverez la page des Tarifs dans le menu HBook > Tarifs. Une fois que vous avez créé un Type d'Hébergement et une Saison, vous pouvez définir les tarifs.

Ci-dessous est montré un exemple d'une table tarifaire pour un établissement avec 2 types d'hébergement et 3 saisons.

---

Si vous avez indiqué une capacité maximum différente de la capacité normale d'accueil, vous pourrez définir ici le Tarif de base qui correspond au prix appliqué pour tout nombre de personnes inférieur ou égal à la capacité normale. Vous pouvez indiquer le Prix par adulte au-dessus de la capacité d'accueil normale et le Prix par enfant au-dessus de la capacité d'accueil normale.
Voir les Exemples ci-dessous.

---

Tarifs spéciaux

Si vous avez créé une ou des Règles avancées de type "Tarif Spécial"vous pourrez définir ces tarifs en sélectionnant la règle correspondante à associer au tarif. Vous pouvez utiliser un même nom de règles pour des Types d'hébergement et/ou des Saisons différentes.
Voir les exemples ci-dessous.

---

Remises

Les remises sont appliquées au prix total lorsque les critères de recherche correspondent aux critères de la règle avancée définie dans Règles de réservation > Règles avancées. Si vous avez créé des règles avancées de type "Remise", vous pourrez définir le montant et le type de remise en créant une nouvelle remise.
Voir les exemples ci-dessous.

Voici des exemples de conditions de "Remise" créés dans HBook > Règles de réservation > Règles avancées de réservation

Et nous ajoutons ensuite le montant de la remise dans HBook > Tarifs > Remises

---

Coupons

Vous pouvez créer des codes promo que vous donnez au client afin qu'ils puissent bénéficier d'une remise en entrant ce code au moment de la réservation.

• Vous pouvez créer un code promo en spécifiant le Type d'Hébergement et la Saison pour lesquels le coupon s'applique. Dans ce cas, il n'y a pas de conditions particulières d'application de cette remise, tant que le client entre le coupon.
• Pour créer des conditions d'application plus strictes, vous pouvez créer une règle avancée de type "Coupon". Dans ce cas, la remise sera appliquée uniquement si les conditions du séjour correspondent aux conditions définies dans la règle.

1. Indiquez le code du coupon
2. Sélectionnez pour quel(s) type(s) d'hébergement ce coupon est applicable.
3. Si vous souhaitez associer certaines conditions pour que le coupon soit valable, vous devrez créer une Règle avancée de réservation et vous pourrez la sélectionner ici
4. Vous trouverez ici le compteur pour le nombre de fois où le coupon a été utilisé
5. Vous pouvez définir un nombre maximum d'utilisation
6. Vous pouvez définir une date limite pour l'utilisation du coupon. Le coupon doit être utilisé avant la date d'expiration pour être valable
7. Indiquez le montant et le type. Si vous souhaitez offrir une remise de 10%, vous indiquerez "10" comme montant et le type sera "Pourcentage". Si vous souhaitez offrir une remise de 20€ vous indiquerez "20" comme montant et le type sera "Fixe".

Vous pouvez utiliser un même nom de coupon pour des Types d'hébergement et/ou des Saisons différentes. Voir les exemples ci-dessous.

---

4. Services supplémentaires

Vous trouverez la page des Services supplémentaires dans le menu HBook > Services supplémentaires. Si vous souhaitez offrir à vos clients la possibilité d'ajouter des services supplémentaires à leur réservation, vous pouvez définir ceux-ci dans cette page. Un service supplémentaire peut être une simple option ou un choix à faire parmi de multiples options. Il existe différents types de services supplémentaires qui induiront différents types de calculs de prix :

• par personne : vous pouvez définir un prix différent pour les adultes et les enfants. Le montant est appliqué une seule fois.
• par personne par jour : vous pouvez définir un prix différent pour les adultes et les enfants. Le montant est multiplié par le nombre de nuits.
• une seule fois: il ne sera appliquée qu'une seule fois pour la réservation
• par hébergement: il sera multiplié par le nombre d'hébergements réservés.
• par hébergement par jour : Le montant est multiplié par le nombre de nuits et par le nombre d'hébergements réservés.
• quantité : vous indiquez le prix pour 1 et le client indique la quantité désirée Vous pouvez définir un montant maximum
• quantité par jour : vous indiquez le prix pour 1 et le client indique la quantité désirée. Vous pouvez définir un montant maximum Le montant est multiplié par le nombre de nuits.

---

• Pour créer un service supplémentaire :
  1. Cliquez sur Ajouter un service supplémentaire
  2. Indiquez le nom du service
  3. Indiquez s'il y a plusieurs options pour ce service Si il y a plusieurs choix possibles, vous devez tout d'abord sauvegarder avant de pouvoir ajouter les choix.
  4. Sélectionnez le type de service
  5. Entrez le montant
  6. Sélectionnez le type d'hébergement concernés par le service
  7. Cliquer sur Sauvegarder
• Pour créer un service supplémentaire :
  1. Cliquez sur Ajouter un service supplémentaire
  2. Indiquez le nom du service
  3. Indiquez s'il y a plusieurs options pour ce service Si il y a plusieurs choix possibles, vous devez tout d'abord sauvegarder avant de pouvoir ajouter les choix.
  4. Indiquez si le service supplémentaire est associé à un type d'hébergement ou à la réservation
  5. Sélectionnez le type de service
  6. Entrez le montant
  7. Si vous avez indiqué à l'étape 4 qu'il est associé à l'hébergement, indiquez les types d'hébergements pour lesquels il est proposé.
  8. Cliquer sur Sauvegarder

• Veuillez trouver ci-dessous un exemple de services supplémentaires et leur paramétrage :

  Veuillez trouver ci-dessous un exemple de services supplémentaires et leur paramétrage :

---

5. Taxes

Vous trouverez la page des Taxes dans le menu HBook > Taxes. Une taxe correspond à des frais supplémentaires obligatoires qui s'ajoutent au prix de la réservation automatiquement. Notre système de taxes est très flexible pour prendre en compte de nombreuses situations. Vous pouvez définir des taxes qui seront calculées en tant quel :

• un montant fixe
• un pourcentage

Les tarifs peuvent s'appliquer sur :

• le prix de l'hébergement
• le prix des services supplémentaires
• l'ensemble des prix

---

Pour ajouter une taxe

1. Cliquez sur Ajouter une taxe
2. Indiquez le nom de la taxe
3. Sélectionnez le type de taxe : cela peut être une taxe de montant fixe ou un pourcentage

Les paramètres sont différents selon que vous utilisiez une taxe fixe ou en pourcentage.

Taxes à montant fixe

Il existe différents types de taxes fixes qui induiront différents types de calculs de prix :

• par personne : vous pouvez définir un prix différent pour les adultes et les enfants. Le montant est appliqué une seule fois.
• par personne par jour : vous pouvez définir un prix différent pour les adultes et les enfants. Le montant est multiplié par le nombre de nuits.
• par hébergement: il sera multiplié par le nombre d'hébergements réservés.
• par hébergement par jour : Le montant est multiplié par le nombre de nuits et par le nombre d'hébergements réservés.
• par réservation : le montant est appliqué une seule fois

Selon le type de taxe fixe que vous choisissez, nous sélectionnons automatiquement où le prix doit être montré. Vous pouvez cependant modifier ce choix par défaut : inclus dans le tarif, ajouté au prix de l'item ou ajouté au prix final.

4. Sélectionnez le type de taxes
5. Spécifiez si le montant de la taxe doit être ajouté au prix total (dans le résumé), ajouté au prix de l'hébergement/prix des services supplémentaires ou bien inclus dans les prix paramétrés (dans HBook > Tarifs)
6. Indiquez le montant de la taxe
7. Sélectionnez le(s) types d'hébergement concernés par cette taxe

Taxes en pourcentage

4. Sélectionnez sur quels prix la taxe doit être appliquée : le prix des services supplémentaires, celui de l'hébergement ou bien l'ensemble des prix
5. Si la taxe s'applique sur l'hébergement, indiquez si la taxe est calculée par personne par nuit
6. Spécifiez si le montant de la taxe doit être ajouté au prix total (dans le résumé), ajouté au prix de l'hébergement/prix des services supplémentaires ou bien inclus dans les prix paramétrés (dans HBook > Tarifs)
7. Indiquez le pourcentage à appliquer
8. Sélectionnez le(s) types d'hébergement concernés par cette taxe

Paramétrages avancés pour les taxes complexes

Afin de permettre le paramétrage de taxes qui ont une structure complexe, nous avons ajouté des paramètres supplémentaires pour les taxes en pourcentage qui sont appliquées sur le prix de l'hébergement et avec un prix par personne par nuit.

1. Indiquez un montant plancher
2. Indiquez un montant plafond
3. Indiquez si la taxe calculée (sur le prix de l'hébergement divisé par le nombre de personnes et le nombre de nuits) doit être ensuite multiplié par le nombre d'adultes/enfants/nuits.

---

Veuillez trouver ci-dessous un exemple de taxes et leur paramétrage :

Paramétrage des paiements

Dans cette section de la documentation, vous trouverez des informations au sujet du menu Paiements du menu HBook.

---

Paramètres du paiement des réservations

HBook vous permet d'offrir à vos clients un choix de méthode de paiement.

• Si vos clients n'ont pas le choix en ce qui concerne le mode de paiement :


• Si vos clients peuvent choisir parmi différentes options de paiement :

Voici une explication détaillée des différentes options de paiement :

1. Paiement hors-ligne : le paiement doit avoir lieu en dehors de HBook. C'est le cas si le client paie par exemple par virement bancaire, en chèques, à l'arrivée, etc.
2. Laisser les données de cartes bancaires: cette option n'est possible que si vous avez activé Stripe. Vous devez également activer l'option "Conserver les données de carte bancaire" dans les Paramètres de Stripe
3. Payer un acompte en ligne : le client paiera uniquement un acompte au moment de la réservation. Vous choisirez le type d'acompte et vous pouvez également demander le paiement en intégralité si la date d'arrivée est dans les "x" jours à venir.
4. Payer la totalité en ligne : le client paiera la totalité du séjour au moment de la réservation.

---

Caution

Une caution est une somme d'argent qui est gardée pendant la durée du séjour pour couvrir d'éventuelles dégradations ou pertes causées par le client.

Différentes options existent pour couvrir les besoins dans différentes situations : vous pouvez vouloir informer vos clients que vous appliquez une caution, mais ne pas vouloir en demander le paiement au moment de la réservation, l'inclure ou non au prix total, demander son paiement au moment de la réservation ou plus tard...

1. définissez si vous appliquez une caution ou non
2. définissez si la caution doit être payée par le client : dans ce cas, le montant de la caution sera ajouté au prix total de la réservation (indépendamment de si le paiement a lieu en ligne ou non)
3. définissez le montant de la caution

Si vous demandez à ce que la caution soit payée et si vous avez paramétré les options de paiement avec acompte (une partie du montant de la réservation payée en avance), alors vous verrez dans les Paramètres de la caution une nouvelle option afin de définir si le montant de la caution doit être ajouté au montant de l'acompte ou non :

---

Paramètres de l'acompte

Un acompte correspond à une partie du prix total du séjour qui est payée à l'avance par le client afin de bloquer sa réservation.

1. Il existe différentes options pour l'acompte : aucun, pourcentage, une nuit ou montant fixe.
2. Vous indiquerez ici le montant : par exemple, si vous demandez un acompte de 50%, vous indiquerez "50".
3. Si vous avez défini qu'une caution doit être payée, vous trouverez ici cette option. Cela vous permet de définir si vous exigez le paiement de la caution avec celui de l'acompte ou non.
4. Si vous proposez le paiement d'un acompte ou en totalité, mais que vous souhaitez forcer la demande du paiement en totalité si la date d'arrivée est proche de la date actuelle, vous indiquerez le nombre de jours à partir de la date du jour, pour lesquels l'option de paiement de l'acompte ne doit pas être proposée. Par exemple, si vous souhaitez proposer le paiement en totalité uniquement (et ne pas montrer l'option permettant de payer un acompte) si la date d'arrivée est dans les 7 prochains jours, vous indiquerez "7" comme valeur.

---

Paramétrage des prix

Choisissez votre devise et indiquez les options concernant les paramètres d'affichage du prix.

---

Activation des passerelles de paiement

Vous pouvez choisir quelles passerelles de paiement vous souhaitez activer pour le paiement en ligne. HBook inclut PayPal et Stripe comme passerelle de paiement intégrées par défaut à l'extension.

• Paramètres Paypal : définissez vos paramètres de compte PayPal.
  Souvenez-vous que vous devez indiquer les API Sandbox si vous souhaitez utiliser l'environement test (faux paiement). Et que vous devez entrer les API Live pour les paiements réels.
• Paramètres Stripe : définissez vos paramètres de compte Stripe.

  Si vous souhaitez conserver les données de carte bancaire pour débiter la carte ultérieurement, vous devez sélectionner "Oui". Cette fonctionnalité n'est disponible qu'avec Stripe. Vous pouvez opter pour cette option

  • si vous ne souhaitez pas demander de paiement au moment de la réservation, mais demander les informations de carte bancaire pour effectuer un débit ultérieurement.
  • si vous avez demandé le paiement d'un acompte au moment de la réservation et que vous souhaitez débiter le solde restant ultérieurement
  • si vous souhaitez conserver les informations de carte bancaire afin de débiter la carte en cas de "non-présentation" du client
  Souvenez-vous d'indiquer vos infos (Secret key et Publishable key) de Test si vous utilisez la Sandbox (environnement de test - faux paiements). Et vos clés Live Secret et Publishable si vous n'utilisez pas la Sandbox.
  
  Pour trouver les cartes test que vous pouvez utiliser dans l'environnement Sandbox, cliquez ici.

Modules complémentaires pour HBook

HBook inclut PayPal et Stripe comme passerelle de paiement intégrées par défaut à l'extension. Nous avons développé des modules complémentaires pour offrir d'autres passerelles de paiement, notamment les principales banques françaises.

• Voir l'ensemble des passerelles de paiement disponibles ici
• Consultez la documentation pour les modules complémentaires ici dans cette documentation.

Paramétrage des emails

Dans cette section de la documentation, vous trouverez des informations au sujet du menu Emails :

• Créer un modèle d'email
• Logs des emails
• Listes des variables

---

Créer un modèle d'email

HBook vous permet de créer une diversité de modèles d'email qui peuvent être envoyés automatiquement ou manuellement, en prenant en compte le statut de la réservation et du paiement, la langue ainsi que le type d'hébergement.

• Pour créer un modèle d'email, suivez les étapes ci-dessous :
  1. Cliquez sur Ajouter un nouveau modèle de courrier électronique
  2. Indiquez le nom de ce nouveau modèle
  3. Indiquez le destinataire dans le champ À: : Indiquez un email complet, par exemple Nom <email@domaine.com>. Si le champ est laissé vide, l'email de l'admin WordPress sera utilisé.
  4. Indiquez l'email correspondant au Répondre à :. Cet email sera utilisé au lieu du "De" lors d'une réponse.
  5. Indiquez l'expéditeur dans le champ De :. Si le champ est laissé vide, l'adresse email par défaut, telle qu'indiquée dans HBook > Divers sera utilisée. Si cette dernière n'est pas paramétrée, HBook utilisera l'email de l'administrateur WordPress.
  6. Indiquez le BCC.
  7. Indiquez le sujet de ce nouveau modèle
  8. Écrivez le corps du message
  9. Sélectionnez si vous souhaitez utiliser le format Text ou HTML
  10. Si vous souhaitez ajouter une pièce jointe, vous pouvez la sélectionner ici. Cela ouvrira votre Bibliothèque Medias WordPress à partir de laquelle vous pouvez sélectionner les documents à inclure.
  11. Il est possible de créer des modèles d'email pour les situations suivantes :
      • Lors d'une action: l'email sera envoyé automaiquement lorsqu'une réservation est reçue, confirmée ou annulée...
      • Programmé: l'email est programmé pour être envoyé "x" jours avant/après la date d'arrivée ou de départ
      • Manuellement: l'email est envoyé manuellement depuis la liste de réservation
      Le paramétrage est différent pour chacun de ces cas et vous trouverez des explications détaillées ci-dessous.

Lors d'une action

1. Sélectionnez lors de quelles actionscet email doit être automatiquement envoyé. Il y a 4 actions différentes et vous pouvez sélectionner plusieurs actions qui doivent déclencher l'envoi.
   • Envoi automatique lorsqu'une réservation est faite sur votre site par le client (front-end)
   • Envoi automatique lorsqu'une réservation est ajoutée depuis l'admin (page Réservations > Ajouter une réservation)
   • Automatiquement lorsque vous confirmez une réservation : vous cliquez sur la "coche" verte dans la colonne "Action". Merci de noter que cliquer sur "Confirmer" déclenche l'envoi de tout email associé à cette action, même si vous ne recevez pas une confirmation de réservations. Voir Paramètres de confirmation pour de plus amples détails.
   • Automatiquement lorsque vous annulez une réservation : vous cliquez sur la "croix rouge" dans la colonne "Action".
2. Indiquez le/les statuts de paiementpour lesquels ce modèle doit être envoyé. Il y a 3 statuts de paiement différents et vous pouvez en sélectionner plusieurs pour un même modèle.
   • Payée
   • Paiement incomplet
   • Non payée
3. Sélectionnez pour quel(s) types d'hébergement ce modèle est applicable.
4. Si vous avez activé la réservation multiple dans HBook > Divers, vous pouvez indiquer si ce modèle doit être envoyé pour une réservation de multiples hébergements
5. Si votre site web est en multilangues, sélectionnez pour quelle(s) langues ce modèle est applicable.

Programmé

1. Indiquez l'échéance pour cet envoi programmé :
   • Indiquez le nombre de jours
   • Indiquez si l'email doit être envoyé "x" jours avant la date d'arrivée, après la date d'arrivée, avant la date de départ, après la date de départ
2. Indiquez le/les statuts de réservationpour lesquels ce modèle doit être envoyé. Il y a 3 statuts de réservations différents et vous pouvez en sélectionner plusieurs pour un même modèle.
   • Nouvelle
   • En attente
   • Confirmée
3. Indiquez le/les statuts de paiementpour lesquels ce modèle doit être envoyé. Il y a 3 statuts de paiement différents et vous pouvez en sélectionner plusieurs pour un même modèle.
   • Payée
   • Paiement incomplet
   • Non payée
4. Sélectionnez pour quel(s) types d'hébergement ce modèle est applicable.
5. Si vous avez activé la réservation multiple dans HBook > Divers, vous pouvez indiquer si ce modèle doit être envoyé pour une réservation de multiples hébergements
6. Si votre site web est en multilangues, sélectionnez pour quelle(s) langues ce modèle est applicable.

Manuellement

1. Sélectionnez pour quel(s) types d'hébergement ce modèle est applicable.
2. Si vous avez activé la réservation multiple dans HBook > Divers, vous pouvez indiquer si ce modèle doit être envoyé pour une réservation de multiples hébergements
3. Si votre site web est en multilangues, sélectionnez pour quelle(s) langues ce modèle est applicable.

---

Voici un exemple d'une liste de modèles d'email:

---

Logs des emails

HBook conserve un log des emails envoyés. Ils apparaissent dans l'ordre chronologique inverse à la date/heure d'envoi.

1. Ceci correspond à la date/heure d'envoi, heure locale
2. Vous trouverez ici l'id de la réservation pour laquelle cet email a été envoyé.
3. Si un modèle d'email a été utilisé, vous trouverez ici le nom de ce modèle.
4. La raison du déclenchement de cet email automatique est indiquée ici. Vous verrez ainsi si l'email a été envoyé manuellement, lors d'une action ou du fait d'un email programmé.
5. Le statut d'envoi de l'email est indiqué ici. Si un email n'est pas envoyé, vous verrez ici l'erreur lors de l'envoi.
6. Vous pouvez effacer tous les logs

---

Liste des variables qui peuvent être utilisées dans les modèles d'email, modèles de document ou l'export ical

Vous trouverez la liste des variables qui peuvent être utilisées sous le tableau des modèles d'emai (et également sous la table des modèles de documents dans HBook > Documents.

• Pour tout champ ajouté pour le formulaire de détails client et réservation, une nouvelle variable sera automatiquement ajoutée.
• Toute variable associée à la Réservation commence par "[resa_...]".

Voici quelques informations au sujet des variables disponibles (liées à la réservation :

• [resa_id] : l'id de la réservation
• [resa_ids]: pour une réservation multiple, cette variable montrera la liste des ids des réservations qui la compose
• [resa_alphanum_id]: un numéro aléatoire alphanumerique qui peut servir de numéro de réservation
• [resa_invoice_id]: l'id de la facture de la réservation
• [resa_check_in] : la date d'arrivée de la réservation
• [resa_check_in] : la date de départ de la réservation
• [resa_number_of_nights] : le nombre de nuits de la réservation
• [resa_accommodation] : le nom du type d'hébergement réservé (par ex: "Chambre double")
• [resa_accommodation_num] : le numéro/nom de l'hébergement réservé (ex: "201" s'il s'agit de la chambre double 201)
• [resa_adults] : le nombre d'adultes
• [resa_children] : le nombre d'enfants
• [resa_persons]: le nombre de personnes
• [resa_admin_comment] : le contenu du commentaire affiché dans la section "Commentaires" de la liste de Réservations
• [resa_extras] : la liste des services supplémentaires sélectionnés
• [resa_coupon_code]: le code du coupon qui a été utilisé
• [resa_coupon_amount]: le montant du coupon utilisé
• [resa_invoice_table] : affiche une table (type facture) avec l'ensemble des prix détaillés. Merci de noter que cette variable ne peut être utilisée que pour des emails de type HTML.
• [resa_price] : le prix total de la réservation
• [resa_accom_list_price]: le prix brut de l'hébergement. Ceci correspond au prix de l'hébergement avant toute remise ou taxe appliquée sur ce prix
• [resa_accom_list_price_per_night]: le prix brut de l'hébergement, divisé par le nombre de nuits. Ceci correspond au prix de l'hébergement avant toute remise ou taxe appliquée sur ce prix, puis divisé par le nombre de nuits.
• [resa_deposit] : le montant de l'acompte tel que paramétré dans Paramètres de l'acompte
• [resa_price_minus_deposit] : le prix de la réservation une fois l'acompte déduit
• [resa_paid] : le montant déjà payé
• [resa_remaining_balance] : le reste dû
• [resa_bond] : le montant de la caution telle que paramétrée dans Paramètres de la caution
• [resa_price_including_bond] : le prix de la réservation avec la caution comprise
• [resa_deposit_including_bond] : le montant de l'acompte avec la caution comprise
• [resa_remaining_balance_including_bond] : le reste dû avec la caution comprise
• [resa_payment_type] : la méthode de paiement sélectionnée (hors-ligne, acompte, intégralité)
• [resa_payment_gateway] : la passerelle de paiement utilisée (Stripe, PayPal,...)
• [resa_origin]: l'origine de la réservation (site web ou nom du calendrier ical)
• [resa_received_on_date] : la date de réception de la réservation
• [resa_received_on] : la date et l'heure de réception de la réservation
• [resa_x_days_before_check_in]: la date correspondant à "x" jours avant la date d'arrivée. Vous devez remplacer "x" par le nombre de jours. Par exemple [resa_21_days_before_check_in]
• [resa_x_days_after_check_in]: la date correspondant à "x" jours après la date d'arrivée. Vous devez remplacer "x" par le nombre de jours. Par exemple [resa_2_days_after_check_in]
• [resa_x_days_before_check_out]: la date correspondant à "x" jours avant la date de départ. Vous devez remplacer "x" par le nombre de jours. Par exemple [resa_1_days_before_check_out]
• [resa_x_days_after_check_out]: la date correspondant à "x" jours après la date de départ. Vous devez remplacer "x" par le nombre de jours. Par exemple [resa_14_days_after_check_out]
• [today_date]: la date du jour

Toute variable associée au Client commence par "[customer_...]". Ces variables sont fréquemment sans ambigüité, par exemple :

• [customer_id] : id du client
• [customer_first_name] : prénom du client
• [customer_first_name] : nom du client
• [customer_email] : email du client
• ...

Autres réglages

Dans cette section de la documentation, vous trouverez des informations au sujet des menus Apparence et Divers de HBook (Paramètres pour la réservation multiple, la confirmation, les dates d'ouverture, etc.)

---

1. Apparence

Dans le sous-menu Apparence de HBook, vous pouvez effectuer les réglages suivants :

• définir les paramètres généraux (Largeur maximale des formulaires, espacement du haut de page, position des formulaires... :


• personnaliser l'apparence des boutons :


• personnaliser l'apparence des inputs et selects :


• personnaliser l'apparence de la grille tarifaire :


• changer les couleurs des calendriers :


• change the "Number of persons" pop-up appearance:


• ajouter des CSS personnalisés :

---

2. Divers

Dans le sous-menu Divers de HBook, vous pouvez effectuer les réglages suivants :

• Réservation multiple
• Paramètres de confirmation
• Statuts des réservations
• Id de la facture et numéro de réservation
• Opening dates
• Format des dates (pour le front-end)
• Termes et conditions, Politique de confidentialité
• Paramètres d'import
• Remise à zéro de HBook
• Divers

---

Réservation multiple

1. Indiquez si vous souhaitez activer la réservation multiple
2. Si vous avez activé la réservation multiple, vous pouvez indiquer si vous souhaitez l'activer pour le front-end (côté client) ou si vous ne souhaitez l'activer que pour le back-end (côté admin).
3. Indiquez si vous préférez que HBook utilise la capacité d'accueil normale ou maximum pour remplir les hébergements, lorsque HBook suggère plusieurs hébergements dans les résultats de recherche.
4. Lors de l'utilisation de la "Capacité normale", vous pouvez paramétrer HBook afin d'éviter les personnes seules dans un hébergement, lorsque cela est possible.

HBook montrera des suggestions :

• lorsque vous avez indiqué que vous ne souhaitiez pas afficher un champ "Nombre d'hébergements" dans le formulaire de recherche.
• lorsque HBook ne trouve pas de résultats pour le nombre d'hébergement spécifié (et le nombre de personnes souhaitées pour chaque hébergement), mais qu'il est tout de même possible d'héberger le nombre de personnes recherchées aux dates recherchées, avec une combinaison d'hébergements différente.

---

Paramètres de confirmation

• Vous pouvez indiquer si une confirmation est nécessaire avant que les dates soient bloquées dans le calendrier et qu'un hébergement soit associé à la réservation. Ce paramétrage peut être différent selon que la réservation ait été payée ou non en ligne.
• Lorsqu'une confirmation est requise pour la réservation, cela signifie que cette réservation aura le statut "En cours" et que l'hébergement restera disponible tant que vous n'aurez pas cliqué sur "Confirmer". Cela fonctionne comme dans le cadre de demandes de réservations ouvertes tant qu'aucune n'est confirmée. Vous pouvez ainsi recevoir plusieurs demandes pour une même période et décider quelle demande vous acceptez et lesquelles vous refusez.

---

Statuts des réservations

Vous pouvez indiquer le statut des réservations selon son origine (reçues du front-end, ajoutées directement de l'admin, importées via ical).

---

Id de la facture et numéro de réservation

Vous pouvez personnaliser le numéro de la facture :

1. Vous indiquerez ici la structure du numéro de facture. Vous pouvez utiliser les variables suivantes : %year, %month and %counter
2. Vous pouvez indiquer manuellement la prochaine occurence du compteur pour le prochain numéro de facture.
3. Vous pouvez indiquer la fréquence de remise à zéro du compteur. Ainsi, HBook remettra automatiquement la variable %counter à "1" soit annullement, mensuellement ou jamais.

HBook vous permet d'avoir un numéro de réservation aléatoire, en plus de l'id de la réservation et du numéro de facture. Ce numéro de réservation sera affiché dans la liste des réservations, et vous pouvez également l'inclure dans les Documents ou les Emails grâce à la variable [resa_alphanum_id]

4. Vous pouvez décider d'utiliser un numéro de réservation alphanumerique.

---

Opening dates

Vous pouvez définir ici la fenêtre de réservation :

1. Vous indiquerez ici la date minimum sélectionnable. Cela peut être défini par :
   • un nombre de jours à partir de la date du jour. Ceci vous sera utile si vous souhaitez empêcher les réservations de dernières minutes.
   • une date spécifique. Ceci vous sera utile si vous n'êtes pas ouverts toute l'année. Cette date correspondra à votre date d'ouverture.
2. Vous indiquerez là la date maximum sélectionnable. Cela peut être défini par :
   • un nombre de mois à partir de la date du jour. Ceci vous sera utile si vous souhaitez proposer une fenêtre de réservation par exemple limitée aux 6 mois maximum de la date du jour.
   • une date spécifique. Ceci vous sera utile si vous n'êtes pas ouverts toute l'année. Cette date correspondra à votre date de fermeture.

---

Format des dates (pour le front-end)

Vous pouvez modifier les formats de dates et le premier jour de la semaine. Si vous avez un site multi-langue, vous pouvez définir cela différemment pour chaque langue (voir capture d'écran).

---

Termes et conditions, Politique de confidentialité

1. Si vous souhaitez ajouter des termes et conditions qui devront obligatoirement être acceptés, cochez cette case. Le texte apparaitront sera affichée juste avant le bouton "Réservez maintenant".
2. Si vous souhaitez ajouter une politique de confidentialité qui devra obligatoirement être acceptée, cochez cette case. Le texte sera affiché juste avant le bouton "Réservez maintenant".

---

Import/export des paramètres HBook

Vous pouvez exporter ou importer un fichier de paramètres Ce fichier est au format .json et vous sera très utile si vous souhaitez par exemple transférer une installation HBook avec ses paramètres, types d'hébergement, clients et réservations.

---

Remise à zéro de HBook

1. Remize à zéro de HBook: les tables des clients, dates bloquées et réservations seront vidées. Ceci est utile pour effacer des tests, par exemple avant une mise en production. Les ids des prochaines réservations et des prochains clients commenceront de nouveau à partir de l'id "1"
2. Remise à zéro des dates bloquées et des réservations : la liste des clients est conservée mais les tables des réservations et des dates bloquées seront vidées. Les ids des prochaines réservations commenceront de nouveau à partir de l'id "1"
3. Delete only reservations imported from external calendars (iCal sync): any reservation received on your website will be kept but all reservations imported from external calendars will be removed, whatever their status is. Ceci est utile si vous avez des soucis de paramétrage de synchronisation ical et que vous souhaitez avoir une liste de réservation nette, avec uniquement les réservations reçue sur votre site web, afin de re-paramétrer la sync ical correctement.
4. Delete only reservations with status "Cancelled": all reservations that have "Cancelled" status will be deleted from the reservation table.
5. Delete only past reservations: all past reservations will be deleted from the reservation table.
6. Delete only past blocked dates: all past bloqued dates will be deleted from the reservation table.

---

Divers

1. Langue de l'administration : vous pouvez définir ici si vous souhaitez utiliser les traductions de l'admin HBook existantes (si disponible dans votre langue). Pour voir la liste actualisée de l'ensemble des traductions disponibles, vous pouvez consulter cet article de notre base de connaissances.
2. Reservations list default filter: you can set here the default filter for the Reservations list.
3. Valeurs par défaut des filtres de la liste de Réservations : vous pouvez paramétrer l'ensemble des valeurs par défaut des différents filtres de la liste de Réservations.
4. Délai d'archivage : HBook archive automatiquement vos réservations, passé un certain délai. Vous trouverez l'ensemble des réservations archivées dans Réservations > Réservations archivées. Vous indiquerez ici le délai en nombre de mois avant archivage automatique.
5. Email logs retention period: HBook keep logs of the emails sent. Here you will enter the period of logs retention, in months.
6. Adresse email par défaut: Lorsqu'aucune adresse email n'est renseignée, HBook utilisera cette adresse email par défaut. Si ce champ est laissé vide, HBook utilisera l'email de l'administrateur WordPress.
7. Slug des types d'hébergement :modifier le slug des types d'hébergements dans l'url. La valeur par défaut est "hb_accommodation"
8. Indiquez si vous souhaitez que toutes les tables/données HBook soient supprimées lorsque vous désinstallez l'extension depuis le menu Extensions.
9. Indiquez si vous souhaitez un redimensionnement des images de façon dynamique ou statique. HBook utilise Aqua Resizer pour retailler les images. Si vous souhaitez utiliser vos propres fonctions pour retailler les images, vous choisirez statique et vous utiliserez le filtre HBook.
10. Ajuster le délai avant que ne se produise un timeout pour le côté front
11. Ajuster le délai avant que ne se produise un timeout pour le côté admin

Personnalisation des formulaires

Dans cette section de la documentation, vous trouverez des informations au sujet des menus Formulaire de recherche et Formulaire informations client/réservation de HBook.

---

Le menu Formulaire de recherche vous permet de personnaliser le formulaire de recherche ainsi que l'étape de sélection du type d'hébergement :

1. Formulaire de recherche : dans cette section, vous pourrez personnaliser les champs du formulaire de recherche.
2. Sélection de l'hébergement : dans cette section, vous pourrez personnaliser ce qui est affiché à l'étape du choix du type d'hébergement.

Le menu Formulaire des informations client/réservation vous permet de personnaliser les informations clients ainsi que les informations de réservation dont vous avez besoin :

3. Formulaire des informations clients/réservation : dans cette section, vous pourrez personnaliser le formulaire que remplit le client pour les informations détaillées le concernant et concernant sa réservation.

---

1. Formulaire de recherche

Personnalisez les différents champs du formulaire de recherche.

---

2. Sélection du type d'hébergement

Personnalisation de la sélection du type d'hébergement.

1. Indiquez si vous souhaitez permettre aux clients de choisir leur hébergement. Par exemple, le client pourra non seulement choisir le type de chambre "Chambre double" mais il pourra également choisir quelle chambre double il souhaite réserver parmi celles disponibles. Vous pouvez ajouter un texte explicatif dans HBook > Texte > Sélection du type d'hébergement si vous souhaitez donner de plus amples détails pour cette étape du processus de réservation.
2. Indiquez si le titre du type d'hébergement doit avoir un lien vers la page utilisée pour l'affichage du type d'hébergement
3. Indiquez si vous souhaitez montrer une vignette. La vignette correspond à l'image mise en avant du post utilisé pour montrer le type d'hébergement
4. Indiquez si la vignette du type d'hébergement doit avoir un lien vers la page utilisée pour l'affichage du type d'hébergement
5. Indiquez la largeur de la vignette en pixels
6. Indiquez la hauteur de la vignette en pixels
7. Indiquez si un bouton "Voir type d'hébergement" doit être affiché. Ce bouton ouvrira dans un nouvel onglet la page utilisée pour l'affichage du type d'hébergement.
8. Indiquez si les prix doivent être affichés. Vous aurez toujours besoin de paramétrer les prix dans la partie admin mais vous pouvez décider de ne pas les afficher en front-end.
9. Indiquez si le détail du prix doit être affiché
10. Choisissez l'état par défaut du détail du prix : si "fermé", le client devra cliquer pour voir le détail du prix
11. Choisissez si le détail complet du prix de l'hébergement doit être affiché (découpe du nombre de nuits avec leurs tarifs respectifs).
12. Indiquez si vous souhaitez afficher le nombre d'hébergements disponibles
13. Si vous souhaitez afficher le nombre d'hébergements disponibles, mais uniquement si en-dessous d'un certain nombre, vous pouvez paramétrer le seuil. Ce message sera montré dès qu'il ne restera plus que ce nombre d'hébergements de disponible.

---

3. Formulaire de détails clients et de réservation

Personnaliser les champs du Formulaire des informations clients et de réservation. Vosu pouvez glisser-déposer les champs pour les ré-ordonner Les types de champs possibles sont:

1. Si vous souhaitez obtenir certaines informations de vos clients au sujet de leur réservation, vous pouvez inclure des champs qui seront affichés directement après les Services Supplémentaires. Dans l'exemple ci-dessous, nous avons choisi de tout d'abord afficher des champs liés à la réservation, avant les champs concernant les informations clients de type email, nom, adresse,...
2. Vous pouvez indiquer si un champ est affiché : ceci peut être utile si vous souhaitez modifier le formulaire sans pour autant effacer les champs (par exemple si vous pensez les utiliser ultérieurement, vous n'aurez pas besoin de les recréer).
   Vous pouvez également indiqué qu'un champ est requis : cela signifie que si le client ne le remplit pas, un message sera montré au client pour lui signaler qu'il doit renseigner ce champ.
3. Vous pouvez indiquer que le champ est Uniquement pour l'admin. Il ne sera pas affiché dans le formulaire infos résa/client du front end, mais sera montré lorsque vous ajoutez une réservation depuis l'admin ou si vous éditez les informations de la réservation ou du client depuis l'admin.
4. Choisissez le type de champ. Voici les champs existants :
   • Texte
   • Email
   • Nombre
   • Zone de texte
   • Select
   • Boutons radio
   • Cases à cocher
   • Titre
   • Sous-titre
   • Explication
   Vous pouvez également ajouter un saut de colonne ou un séparateur
5. Spécifiez si l'information doit être associée au Client ou à la Réservation.
   Si associé au Client, cette information apparaîtra dans la colonne "Client", dans la liste de réservation ainsi que dans HBook > Clients. Les informations clients sont mises à jour à chaque fois qu'une nouvelle réservation est faite pour ce client. Chaque client est identifié par son email.
   Si associé à la "Réservation", cette information sera affichée dans la colonne "Informations" et peut être différente selon la réservation, même lorsque le client est le même (par exemple : une heure d'arrivée, un numéro de vol...).
6. Vous pouvez présenter votre formulaire en colonnes et vous choisirez donc une largeur de colonne : cela peut être Pleine, Demi colonne ou bien Un-tiers de colonne. Ainsi, vous pouvez organiser la disposition de votre formulaire comme bon vous semble.
7. Vous pouvez ajouter un saut de colonne si vous souhaitez forcer le retour à la ligne suivante

Personnalisation des textes et traductions

Dans cette section de la documentation, vous trouverez des informations concernant :

1. Traductions côté client (front-end)
2. Traductions côté admin (back end)

---

1. Côté client (front-end)

Comment modifier et/ou traduire les textes affichés par le plugin?

Le menu Texte est utile pour personnaliser et traduire tout texte affiché par HBook. La page Texte vous permet de voir et éditer les chaînes de caractères affichées par HBook pour toutes les langues que vous avez paramétrées. Vous trouverez une liste des différentes sections afin de faciliter la recherche et la navigation à la section dans laquelle se trouve le texte que vous souhaitez modifier ou traduire.

• Si vous utilisez les plugins WPML, Polylang ou QtranslateX, les langues seront automatiquement ajoutées dans HBook->Text, une fois qu'elles ont été créés dans le plugin multi-langue.
• Si la langue de votre site, comme définie dans Paramètres->Géneral-> Langue du site est différente de l'anglais US, votre langue apparaîtra également automatiquement dans HBook->Texte.



Pour personnaliser ou traduire les chaînes de caractères :

1. Choisissez la section dans laquelle le texte apparaît et trouvez le texte affiché par le plugin
2. Modifier ou traduisez le texte
3. Sauvegardez vos modifications
Bon à savoir : les textes commençant par % sont des variables utilisées pour afficher des informations calculées automatiquement par le plugin (prix, nombres de nuits...). Ces variables ne doivent pas être modifiées.

---

Comment importer/exporter des fichiers de traductions pour le côté-client (front-end)?

La page Langues vous permet d'importer ou d'exporter des fichiers de traductions pour le côté-client (front-end> :



Vous pouvez utiliser l'outil d'import/export de HBook pour importer/exporter un fichier .txt ou .po. (les fichiers .po sont couramment utilisés par les outils de traductions). Notez que vous n'avez pas besoin d'utiliser un fichier .po pour traduire les chaines de caractères affichées par HBook en front-end mais l'outil d'import/export peut être pratique (par exemple si vous utilisez des traductions faites par un tiers).

---

2. Côté admin (back end)

HBook inclut les fichiers de traductions côté admin pour de nombreuses langues. Pour connaître l'ensemble des langues proposées à ce jour, merci de consulter cet article de notre base de connaissances.

---

Comment changer la langue d'administration de HBook à une langue pour laquelle la traduction est proposée ?

Vous trouverez un paramètre "Langue de l'administration" dans HBook > Divers > Divers et vous pouvez le paramétrer dans "Langue de l'utilisateur"

---

Comment traduire HBook dans une autre langue?

Si la langue de votre choix n'est pas disponible ou si vous souhaitez modifier les traductions existantes, vous devrez créer les fichiers de traductions. Le plugin HBook respecte les standards WordPress pour l'internationalisation. Vous trouverez ci-dessous les instructions pour traduire HBook avec Poedit.

1. Télécharger et installer Poedit
2. Choisissez "Créez une nouvelle traduction"

Si vous souhaitez mettre à jour ou modifier une traduction existante :

3. Ouvrez le fichier .po file correspondant que vous trouverez dans wp-content/plugins/hbook/languages/admin-language-files folder
4. Traduisez les chaînes de caractères manquantes
5. Sauvegardez le fichier .po

Si vous souhaitez créer une nouvelle traduction :

3. Ouvrez le ficheir .pot
4. Cliquez sur File -> Sauvegarder comme... : choisissez le répertoire wp-content/plugins/hbook/languages/admin-language-files et donnez à votre fichier le nom hbook-admin- suivi de votre locale. Par exemple, si vous souhaitez traduire le plugin en suédois, le fichier sera hbook-admin-sv_SE.po. Le fichier .mo sera automatiquement créé lors de la sauvegarde.
5. Traduire les chaines de caractère que vous souhaitez utiliser.
6. Sauvegarder à nouveau pour mettre à jour les fichiers .po et .mo

Vous trouverez un paramètre "Langue de l'administration" dans HBook > Divers > Divers et vous pouvez le paramétrer dans "Langue de l'utilisateur"

Si vous désirez partager vos traductions pour d'autres langues, n'hésitez pas à nous contacter à support@maestrel.com. Ceci sera très apprécié des utilisateurs qui utilisent cette langue !

Voir cette page pour trouver votre code de locale.

iCal import/export/synchronization

Dans cette section de la documentation, vous trouverez des informations au sujet du menu Synchronisation iCal de Hbook.

1. Qu'est-ce que la synchronisation iCal?
2. Presentation of iCal synchronization table
3. Presentation of iCal synchronization settings
4. Comprendre les notifications affichées dans la page Réservations
5. Ressources : guides pas-à-pas, problèmes fréquents

HBook allows you to import, export and synchronize calendars using iCal feeds or files. HBook synchronizes by default hourly with the calendars added.

---

Qu'est-ce que la synchronisation iCal?

Ical est un format de fichiers très pratique pour échanger des calendriers. Ce format est utilisé par:

• des applications de type Agenda/Calendrier : iCal, Google Calendar, Outlook Calendar...
• des plateformes de réservations et OTA : AirBnb, booking.com, TripAdvisor, Expedia, VRBO, HomeAway, etc...

Ce que nous appelons synchronisation est en fait un import d'un flux de données ical qui est effectué à intervalle régulier par chaque calendrier/plateforme/OTA de façon indépendante. Voici ce qui se passe :

• Chaque heure (ou à la fréquence indiquée dans HBook > Sync iCal > Paramètres de la sync iCal), HBook vérifie les flux iCal de tous les calendriers ajoutés dans HBook > Sync iCal > Calendriers synchronisés. Vous pouvez rafraîchir vos calendriers manuellement (= lancer manuellement la sync) en cliquant sur le bouton "Mettre à jour les calendriers". Toute nouvelle réservation sera importée dans HBook et apparaîtra dans la liste de réservation. 
• À leur propre fréquence, les calendriers externes (AirBnb, TripAdvisor, booking.com, HomeAway, Expedia, VRBO, etc...) procèdent de la même manière et appellent les flux iCal de HBook afin de mettre à jour leurs calendriers. Il vous faut bien ajouter l'url des calendriers HBook dans chaque plateforme/calendrier externe. L'évènement/réservation sera importée (Google ou iCal ou toute application de calendriers) ou les dates seront bloquées (AirBnb, TripAdvisor, booking.com, HomeAway ou toute OTA/plateforme de réservation). Les informations affichées au sujet de ces réservations/dates non-disponibles importées dépendent de chaque plateforme. Certaines applications/plateformes de réservations ont un bouton/lien pour rafraîchir les calendriers (= lancer la synchronisation manuellement).

---

Presentation of iCal synchronization table

• Pour exporter un calendrier HBook pour un de vos hébergements, vous pouvez :
  1. Cliquez ici afin d'obtenir l'url du calendrier. Vous pouvez copier et coller cet url pour entrer l'url de ce calendrier HBook dans vos calendriers externes. You can add up to 3 query parameters to the URL:
     • agenda: by default, it is set to "no". You will pass it to "yes" for agendas (Google Calendars, etc.). With this parameter set to "yes", the date are formatted with an additional time information (by default, 3pm for check-in and 11am for check-out). This is useful for agendas, so you can see the reservation across the days.
     • future_only: by default, it is set to "yes". You will pass it to "no" if you wish to have all past reservations/blocked dates included in the export (by default, up to 2 years in the past).
     • reservations_only: by default, it is set to "no". You will pass it to "yes" if you have set that you wish to include blocked dates in the export (in HBook - Ical sync - Export settings) but wish to override the setting for a calendar where you wish to export only the reservations.

     A couple of examples:
     https://mywebsite.com/?feed=hbook-calendar.ics&accom_id=102&accom_num=1&agenda=yes
     https://mywebsite.com/?feed=hbook-calendar.ics&accom_id=102&accom_num=1&agenda=yes&reservations_only=yes
     https://mywebsite.com/?feed=hbook-all-calendars.ics&future_only=no
     https://mywebsite.com/?feed=hbook-all-calendars.ics&&key=KBDEHAOEY25RPNO&agenda=yes

  2. Télécharger le fichier .ics du calendrier HBook de cet hébergement.


• Pour importer un fichier .ics d'un calendrier externe pour un hébergement HBook:
  3. Cliquez sur Importer un fichier .ics et sélectionnez le fichier .ics qui doit être importé. Tout évènement futur de ce calendrier sera traité. Un message de notification vous indiquera le résultat de l'import.


• To synchronize HBook calendar with another iCal calendar:
  4. Cliquez sur Nouveau calendrier
  5. Enter the Name you wish to give to the calendar you will synchronize with.
  6. Indiquez l'url de ce calendrier
  7. Cliquez sur Ajouter
  Tout évènement futur de ce calendrier sera traité. Un message de notification vous indiquera le résultat de l'import.


• The list of the calendars which are synchronized with HBook appears in the last column:
  8. Le nom du calendrier
  9. Cliquez sur Editer pour modifier le nom ou l'url du calendrier
  10. Click Delete if you wish to stop synchronizing HBook calendar with this calendar

---

Presentation of iCal synchronization settings

Afin de s'adapter à la diversité des calendriers exterenes proposant la synchronisation iCal et afin de vous offrir des options de synchronisation, vous trouverez les paramètres suivants :

Paramètres de notifications

HBook peut sauvegarder et afficher ces notifications concernant la synchronisation.

1. Indiquez si vous souhaitez qu'HBook garde des logs des notifications. Nous recommandons d'activer les notifications au moins lors de la mise en place de la synchronisation afin de pouvoir surveiller toute erreur et de faciliter le debug.
2. Indiquez si vous souhaitez afficher les notifications qui apparaîtront en haut de la page Réservations.

Paramètres d'import

1. Indiquez la fréquence souhaitée de synchronisation. Merci de noter que cela affecte uniquement la fréquence à laquelle HBook met à jour ses calendriers en prenant en compte les modifications/nouvelles réservations reçues sur vos calendriers externes. Cela n'a aucun impact sur la fréquence de mise à jour des calendriers externes (AirBnb, booking.com, Expedia...), qui font cette mise à jour à leur propre fréquence, indépendamment d'HBook.
2. Si les dates d'une réservation ont été modifiées dans le calendrier externe, souhaitez-vous qu'HBook mette automatiquement à jour les dates de la réservation correspondante de la liste de réservation. Cette option devra être désactivée si un de vos calendriers externes ne suit pas les standards iCal (par exemple si l'UID n'est pas conservée).

Dans certains cas, il se peut que vous avez besoin d'empêcher HBook d'importer certaines dates qui sont incluses dans l'export d'un calendrier externe. Ceci peut arriver lorsque des calendriers externes ajoutent dans le contenu de l'export des dates non disponibles du fait de paramètres spécifiques à une plateforme. Par exemple, il se peut qu'aucun tarif ne soit indiqué pour une période lointaine ou pour une date spécifique, certains jours peuvent être bloqués du fait d'un paramètre de fenêtre de réservation ou de délai (afin d'éviter les réservations de dernières minutes). Cela va créer des réservations "fausses" ou "fantômes" qui seront importées dans votre liste de réservations. Vous utiliserez donc les paramètres suivants pour paramétrer la fenêtre d'import des réservations via iCal:

3. Indiquez le nombre de mois maximum d'import à partir d'aujourd'hui comme date maximum.
4. Indiquez le nombre de jours à partir de la date du jour afin de déterminer la date minimum d'import.
5. Si vous n'acceptez pas de réservations d'une seule nuit dans aucun de vos calendriers externes, vous pouvez l'indiquer ici. HBook ignorera tout évènement d'une seule nuit lors de l'import iCal

Paramètres d'export

1. Vous pouvez choisir d'inclure ou non dans l'export les dates bloquées (ajoutées depuis Réservations > Bloquer des hébergements).
2. Vous pouvez choisir d'inclure ou non dans l'export les dates bloquées du fait d'un "Temps de préparation".
3. Vous pouvez choisir d'inclure dans l'export uniquement les réservations avec le statut "Confirmée".
4. La propriété iCal Résumé (SUMMARY) est une ligne courte de description de la réservation. Vous pouvez utiliser les variables listées afin de personnaliser cette description de réservation. Certains calendriers externes peuvent afficher ce "Résumé" afin de vous aider à identifier la réservation.
5. La propriété Description (DESCRIPTION) est un champ plus détaillé qui permet de communiquer des informations au sujet de la réservation. Vous pouvez utiliser les variables listées afin de personnaliser cette description de réservation. Certains calendriers externes peuvent afficher cette "Description", mais ce n'est pas toujours le cas.

---

Comprendre les notifications affichées dans la page Réservations

Une fois mise en place, la synchronisation est effectuée de manière automatique. Il est cependant important de vérifier de façon régulière que tout fonctionne comme il se doit. We display notifications on top of the Reservations page when there are any sync errors..

Ces messages sont ici pour vous aider à surveiller la synchronisation. Cela peut être :

• une erreur de connexion : cela signifie simplement qu'HBook n'a pas pu se connecter au serveur du calendrier externe. Comme la synchronisation est lancée toutes les heures (ou à votre fréquence préférée) vous pouvez ignorer ce message, sauf dans le cas où il serait répété à chaque synchronisation. Dans ce cas, nous vous invitons à choisir une fréquence moins élevée (certains serveurs considèrent les requêtes trop fréquentes comme potentiellement dangereuses et refusent l'accès) et à vous rapprocher de votre hébergeur afin de voir s'ils ont des logs de ces refus de connexions.
• une réservation n'a pas pu être importée : vous devriez vérifier pourquoi ces dates ne sont pas disponibles dans HBook. Les dates de la réservation non importée sont indiquées pour vous aider à vérifier cela.
• une réservation a été modifiée : vous devriez vérifier s'il est possible de modifier la réservation dans HBook et mettre à jour manuellement en conséquence.

---

Ressources : guides pas-à-pas, problèmes fréquents

Au vu de la complexité de la synchronisation iCal et du fait que des plateformes/calendriers tiers sont impliqués, la mise en place et le paramétrage de la synchronisation peuvent être complexes. Nous avons rédigé de nombreux articles dans notre base de connaissances afin de vous aider à établir les synchronisations avec chaque calendrier externe et afin de trouver des solutions aux problèmes fréquents. Cliquer ici pour voir l'ensemble des articles à ce sujet.

N'hésitez pas à nous envoyer un message via notre page de contact que vous trouverez ici. Nous serons ravis de vous aider !

Shortcodes / Blocs

Pour afficher un formulaire de recherche, un formulaire de réservation, un calendrier de disponibilités, une grille tarifaire ou une liste de types d'hébergement, HBook utilise des shortcodes mais vous pouvez également utiliser les blocs si vous êtes avec l'éditeur Gutenberg. Vous pouvez afficher ces éléments HBook n'importe où sur votre site internet : dans une page, un article, un widget, une barre latérale,...

• Si vous utilisez l'éditeur Gutenberg, vous trouverez facilement les blocs HBook en tapant "HBook" dans la barre de recherche des blocs :
• Si vous préférez utiliser les shortcodes, vous les écrirez là où vous souhaitez les utiliser dans le contenu de page/article/widget. Par exemple :

---

Nous présentons ci-dessous en détails chaque shortcode et le bloc Gutenberg correspondant à chaque shortcode.

1. Formulaire de réservations
   • Shortcode [hb_booking_form]
   • Formulaire de réservation - Bloc Gutenberg


2. Liste de types d'hébergement
   • Shortcode [hb_accommodation_list]
   • Liste de types d'hébergement - Bloc Gutenberg


3. Calendrier de disponibilités
   • Shortcode [hb_availability]
   • Calendrier de disponibilités - Bloc Gutenberg


4. Grille tarifaire
   • Shortcode [hb_rates]
   • Grille tarifaire - Bloc Gutenberg


5. Résumé de réservation
   • Shortcode [hb_reservation_summary]
   • Résumé de réservation - Bloc Gutenberg


Merci de noter que les shortcodes proposent plus de paramètres que les blocs, l'ensemble des paramètres disponibles pour les shortcodes n'étant pas tous montrés dans les options du bloc. Si vous utilisez l'éditeur Gutenberg, mais souhaitez utiliser des paramètres non disponibles avec les blocs HBook, vous utiliserez un bloc Shortcode dans lequel vous pouvez écrire le shortcode HBook avec ses paramètres.

---

1. Formulaire de réservations

Vous utiliserez ce shortcode ou ce bloc pour afficher un formulaire de recherche/réservation. Le processus de réservation se fait en différentes étapes et vous pouvez mettre en place une redirection aux étapes suivantes :

• Résultats de recherche : une fois que le client a indiqué ses dates, nombre de personnes et nombre d'hébergements recherchés. Cette redirection ne peut se faire que pour une recherche globale.
• Formulaire infos client/réservations : une fois que le client a choisi son/ses hébergements
• Résumé et remerciement : à la dernière étape de la réservation, lors de l'affichage de l'écran de confirmation de la réservation/demande de réservation

---

Shortcode [hb_booking_form]

Vous utiliserez le shortcode [hb_booking_form] pour afficher un formulaire de recherche sur une page de votre site.

Paramètres :

• all_accom : si vous affichez le formulaire sur une page d'un type d'hébergement, le formulaire de recherche sera par défaut uniquement pour cet hébergement. Si vous souhaitez qu'HBook effectue la recherche pour l'ensemble des types hébergements, il faudra ajouter le paramètre all_accom à yes.
• accom_id : utilisez ce paramètre pour que le formulaire de recherche ne fasse la recherche que pour un certain type d'hébergement. Vous trouverez l'ID d'un type d'hébergement dans le post du type d'hébergement, juste sous le titre.
• search_only : utilisez ce paramètre pour afficher seulement un formulaire de recherche. Une fois que le client a cliqué sur le bouton "Rechercher", il sera redirigé vers la page correspondant à l'url entrée comme valeur pour le paramètre redirection_url. Ce paramètre ne peut être utilisé que lors d'une recherche globale, et non sur une page d'hébergement ou avec le paramètre "accom_id".
• redirection_url : ajouter ce paramètre si vous souhaitez utiliser le paramètre search_only ou si vous souhaitez rediriger le client après sélection de l'hébergement. Ce paramètre doit contenir l'url de la page où vous redirigerez votre client. Cette même page devra contenir le shortcode [hb_booking_form].
• force_display_thumb : ajouter ce paramètre si vous souhaitez forcer l'affichage de la vignette lorsque la recherche porte sur un seul type d'hébergement. Par défaut, HBook n'affiche pas la vignette et la description si vous n'avez qu'un seul type d'hébergement ou si la recherche n'est que pour un type d'hébergement spécifique. Vous pouvez donner la valeur yes à ce paramètre et la vignette sera affichée.
• force_display_desc : ajouter ce paramètre si vous souhaitez forcer l'affichage de la Description lorsque la recherche porte sur un seul type d'hébergement. Par défaut, HBook n'affiche pas la vignette et la description si vous n'avez qu'un seul type d'hébergement ou si la recherche n'est que pour un type d'hébergement spécifique. Vous pouvez donner la valeur yes à ce paramètre et la description sera affichée.
• form_id : ajoutez ce paramètre pour pouvoir définir l'identifiant du formulaire avec l'id de votre choix. Ceci peut être utile si vous souhaitez par exemple appliquer un style différent à certains formulaires ou si vous avez des scripts js spécifiques à appliquer à ce formulaire.
• search_form_placeholder : ce paramètre est utile si vous souhaitez passer outre le paramétrage par défaut et utiliser des labels/placeholder à la place. Vous trouverez les paramètres généraux (définis par défaut) dans HBook > Formulaire de recherche.
• thank_you_page_url :ce paramètre est utile si vous souhaitez rediriger votre client sur une page différente lors de l'affichage de l'écran de confirmation de réservation/demande de réservation, habituellement appelée "Page de remerciements/Thank you page". Dans cette "Page de remerciements", il est obligatoire d'ajouter un shortcode [hb_reservation_summary] ou un bloc "Résumé de réservation".
  Si vous utiliser le paramètre "redirection_url" pour le shortcode [hb_booking_form], vous n'ajouterez pas le paramètre "thank_you_page_url" dans ce shortcode-ci, mais dans celui présent sur la page où le client est redirigé pour entrer ses infos client/réservation.

Exemples :


[hb_booking_form search_only="yes" redirection_url="https://www.abc.com/main-booking-form"]
Avec le shortcode ci-dessus, votre client indiquera les dates d'arrivée et de départ ainsi que le nombre d'adultes/enfants si requis. Lorsqu'il cliquera sur le bouton "Rechercher", il sera redirigé vers une autre page pour les étapes suivantes de la réservation (sélection de l'hébergement et des services supplémentaires, informations client, paiement et confirmation)


[hb_booking_form redirection_url="https://www.abc.com/main-booking-form"]
Avec le shortcode ci-dessus, votre client indiquera les dates d'arrivée et de départ ainsi que le nombre d'adultes/enfants si requis. Les résultats de la recherche seront affichés et c'est uniquement après avoir choisi le type d'hébergement qu'il sera redirigé sur une page différente. Ensuite, il pourra séléctionner les services supplémentaires, ajouter les informations client, etc...
Il est obligatoire d'avoir un shortcode [hb_booking_form] ou bloc "Formulaire de réservation" sur la pae sur laquelle le client est redirigé.

[hb_booking_form thank_you_page_url="https://www.abc.com/thank-you"]
Avec ce shortcode, le client sera redirigé à votre "Page de remerciements/Thank you page" pour la dernière étape du processus de réservation, ce qui correspond au moment où est affiché à l'écran la confirmation de réservation/demande de réservation avec le résumé. Dans cette "Page de remerciements", il est obligatoire d'ajouter un shortcode [hb_reservation_summary] ou un bloc "Résumé de réservation".

[hb_booking_form force_display_desc="yes" force_display_thumb="yes"]
Avec ce shortcode, la vignette et la description seront affichées même dans le cas d'une recherche sur un seul type d'hébergement.

[hb_booking_form force_display_desc="yes" force_display_thumb="yes"]
Avec ce shortcode, la vignette et la description seront affichées même dans le cas d'une recherche sur un seul type d'hébergement.

---

Formulaire de réservation - Bloc Gutenberg


1. Sélectionnez pour quel types d'hébergement est le formulaire de réservation.
2. Indiquez si vous souhaitez que ce formulaire soit un Formulaire de recherche uniquement. Si c'est un "Formulaire de recherche uniquement" qui est affiché, il est obligatoire d'indiquer la page de Redirection. Le client va indiquer les dates recherchées et le nombre de personnes. Une fois que le client a cliqué sur le bouton "Rechercher", il sera redirigé vers la page indiquée dans le paramètre Redirection. Ce paramètre ne peut être utilisé que lors d'une recherche globale, et non sur une page d'hébergement ou pour un type d'hébergement spécifique.
3. Iindiquez la page de Redirection. Vous pouvez utiliser ce paramètre combiné avec le paramètre "Formulaire de recherche uniquement" ou bien seul. Si vous l'utilisez seul (sans activer "Formulaire de recherche uniquemen", les clients entrent les dates recherchées, le nombre de personnes, puis choisissent leur(s) hébergement(s) dans la liste des résultats. C'est ensuite qu'ils seront redirigés vers la page indiquée dans "Redirection" afin de renseigner les informations client/réservation.
4. Iindiquez la page de Remerciements. Vous pouvez utiliser ce paramètre pour rediriger vos clients à votre propre "Page de remerciements/Thank you page" pour la dernière étape du processus de réservation, ce qui correspond au moment où est affiché à l'écran la confirmation de réservation/demande de réservation avec le résuméa.
Se référer à cet article de notre base de connaissances pour de plus amples informations concernant la réservation multiple.

---

2. Liste de types d'hébergement

Vous utiliserez ce shortcode ou ce bloc pour afficher une liste de types d'hébergement. Vous pouvez indiquer le nombre de colonnes, si vous souhaitez inclure un formulaire de réservation, un bouton pour voir une présentation détaillée du type d'hébergement, quels types d'hébergements vous souhaitez afficher (possible avec le shortcode uniquement)...

Vous indiquerez la "Description affichée dans la liste des types d'hébergement" dans la section Descriptions des paramètres du type d'hébergement.

---

Shortcode [hb_accommodation_list]

Utilisez le shortcode [hb_accommodation_list] pour afficher une liste des types d'hébergement.

Paramètres :

• accom_ids : utilisez ce paramètre pour choisir d'afficher uniquement certains types d'hébergement dans la liste. Indiquez les ids des types d'hébergement que vous souhaitez montrer. Défault : vide (tous les types d'hébergements seront montrés)
• book_button : utilisez ce paramètre si vous souhaitez ajouter un formulaire de recherche sous chaque type d'hébergement présenté. Défaut : oui.
• view_button : utilisez ce paramètre si vous souhaitez ajouter un bouton qui renvoie vers la page du type d'hébergement, pour une présentation détaillée. Défault: no.
• redirection_url : si vous paramétrez "book_button" à "yes" et souhaitez que le client soit redirigé à une autre page pour les étapes suivantes de la réservation, utilisez ce paramètre. Indiquez l'url de la page sur laquelle il doit être renvoyé grâce à ce paramètre.
• nb_columns : utilisez ce paramètre pour indiquer le nombre de colonnes pour l'affichage des types d'hébergements. Ce sera le nombre maximum de colonnes utilisées (selon taille de l'écran/élément). Défault : 2.
• show_thumbnail : utilisez ce paramètre pour choisir si vous souhaitez afficher la vignette de l'hébergement ou non. Défaut : oui.
• thumbnail_link: here you can set if you wish the thumbnail to have a link to the accommodation page or not. Défaut : oui.
• title_link: here you can set if you wish the title to have a link to the accommodation page or not. Défaut : oui.
• title_tag : utilisez ce paramètre pour modifier le type de titre (h1, h2, h3, h4,...). Défault : h2.
• thumb_width : utilisez ce paramètre pour modifier la largeur de la vignette. Défault : 150px.
• thumb_height : utilisez ce paramètre pour modifier la hauteur de la vignette. Défault : 150px.

Exemples :
[hb_accommodation_list view_button="yes" book_button="yes" redirection_url="https://mywebsite.com/booking-form/" nb_columns="4" ]
[hb_accommodation_list thumbnail_link="no" title_link="no"]
[hb_accommodation_list title_tag="h4" thumb_width="300" thumb_height="200"]
[hb_accommodation_list accom_ids="12,14,24,37" book_button="no"]

À noter que vous pouvez modifier la taille de la vignette affichée dans les résultats de recherche dans la page HBook->Formulaires. Se référer à cette section de la documentation.

---

Liste de types d'hébergement - Bloc Gutenberg


1. Choisissez le nombre de colonnes
2. Indiquez si vous souhaitez montrer une vignette
3. Indiquez si vous souhaitez que la vignette soit cliquable, avec un lien vers la page du type d'hébergement
4. Indiquez la largeur de la vignette
5. Indiquez la hauteur de la vignette
6. Indiquez si vous souhaitez afficher un bouton Voir cet hébergement, qui ouvrira dans un nouvel onglet la page du type d'hébergement.
7. Indiquez si vous souhaitez afficher un bouton Réserver maintenant, qui affichera un formulaire de réservation sous le descriptif du type d'hébergement
8. Si vous avez indiqué vouloir afficher un bouton "Réservez maintenant", indiquez la page de Redirection si vous souhaitez qu'HBook redirige vers une page différente pour le reste du processus de réservation. Les clients seront redirigés vers la page indiquée dans "Redirection" afin de renseigner les informations client/réservation.

---

3. Calendrier de disponibilités

Vous utiliserez ce shortcode ou ce bloc pour afficher un calendrier de disponibilités. Vous pouvez spécifier pour quel type d'hébergement vous souhaitez afficher un calendrier de disponibilités, ainsi que la présentation (uniquement avec le shortcode).

---

Shortcode [hb_availability]

Utilisez le shortcode [hb_availability] pour afficher un calendrier de disponibilités.

Paramètres :

• accom_id : ce paramètre peut être utilisé pour indiquer quels types d'hébergement sont concernés.
  - ajouter ce paramètre et donnez-lui la valeur "all" si vous souhaitez afficher un calendrier de disponibilité globale (est-ce que votre établissement est complet pour ce jour-ci ou non ?)
  - spécifiez comme valeur l'id du type d'hébergement si vous souhaitez afficher un calendrier de disponibilités pour un type d'hébergement spécifique
  - si vous êtes dans la page utilisée pour afficher l'hébergement, vous n'avez pas besoin d'inclure ce paramètre. Par défaut, HBook affichera le calendrier pour cet hébergement.
  Vous trouverez l'ID d'un type d'hébergement dans le post du type d'hébergement, juste sous le titre.
  
  Par exemple : [hb_availability accom_id="5"] ou [hb_availability accom_id="all"]
• calendar_sizes : ajoutez ce paramètre si vous souhaitez modifier le nombre de mois affichés selon la taille de l'écran. Défaut : "2x1, 1x1". Cela signifie que le calendrier aura 2 colonnes si l'espace est assez large et 1 seule colonne pour un espace plus petit.
  
  Par exemple : [hb_availability calendar_sizes="3x2,2x2,1x1"] (3 colonnes et 2 rangées, ou 2 colonnes et 2 rangées, ou 1 colonne et 1 rangée, selon la taille disponible)

---

Calendrier de disponibilités - Bloc Gutenberg


• Sélectionnez pour quel types d'hébergement est le calendrier de réservation.
Si vous choisissez d'afficher un calendrier de disponibilités pour "Tous" les types d'hébergement, HBook montrera la disponibilité globale. Une date sera indiquée comme "Non-disponible" lorsque l'établissement est complet et qu'aucun hébergement n'est disponible pour cette date.

---

4. Grille tarifaire

Vous utiliserez ce shortcode ou ce bloc pour afficher une grille tarifaire. Il existe différentes options pour l'organisation des tarifs, ainsique pour le types de tarifs à afficher.

---

Shortcode [hb_rates]

Utilisez le shortcode [hb_rates] pour afficher une grille tarifaire.

Paramètres :

• accom_id : Si vous êtes dans la page utilisée pour afficher l'hébergement, vous n'avez pas besoin d'inclure ce paramètre. Par défaut, HBook affichera le calendrier pour cet hébergement.<br/> Si vous souhaitez afficher une grille tarifaire en dehors de la page de l'hébergement, il vous faudra utiliser ce paramètre et indiquer l'ID du type d'hébergement concerné. Vous trouverez l'ID d'un type d'hébergement dans le post du type d'hébergement, juste sous le titre. Par exemple : [hb_rates accom_id="5"]
• type : vous pouvez choisir de n'afficher les tarifs que pour un certain type de tarifs. Il existe 3 types de tarifs : normal(lorsqu'il n'y a pas plus de personnes que la capacité normale d'accueil), adulte (tarif par adulte au-dessus de la capacité normale d'accueil) enfant (tarif par adulte au-dessus de la capacité normale d'accueil). Défault : normal
  Par exemple, le shortcode [hb_rates type="child"] affichera uniquement les tarifs par enfant supplémentaire.
• seasons : utilisez ce paramètre pour afficher les tarifs correspondants à une ou plusieurs saisons spécifiques. Par exemple, le shortcode [hb_rates seasons="été,automne"] affichera une grille tarifaire pour les saisons "été" et "automne".
• rule : utilisez ce paramètre pour afficher les tarifs correspondants seulement à une règle avancée "Special rate".
• days : utilisez ce paramètre pour afficher le tarif uniquement pour certains jours
  Par exemple, [hb_rates days="4,5"] affichera les tarifs uniquement pour les nuits de vendredi et samedi).
• show_global_price : utilisez ce paramètre et indiquez la valeur yes pour afficher le prix global au lieu d'un prix par nuit. Par exemple, si vous avez un tarif à la semaine, vous préférez peut-être afficher le tarif pour 7 nuits plutôt qu'un tarif par nuit. Défault: no.
• custom_text_after_amount : grâce à ce paramètre, vous pouvez personnaliser le texte affiché après le prix dans la table tarifaire.
• show_season_name : utilisez ce paramètre et indiquez la valeur yes pour montrer une colonne avec le nom de la saison. Vous pouvez personnaliser et traduire le nom de vos saisons (si vous avez par exemple un site en multi-langue) dans HBook > Texte > Grille tarifaire Défault : yes.
• chronological : utilisez ce paramètre et indiquez la valeur "yes" pour que les saisons soient affichées dans l'ordre chronologique. Défault: no.

Exemples :

[hb_rates show_global_price="yes" custom_text_after_amount="par semaine"] affichera un prix global avec le texte "par semaine" ajouté juste après le prix.

[hb_rates season="Ma saison" rule="Ma règle"] affichera une table tarifaire avec uniquement les tarifs pour la saison "Ma saison" et la règle "Ma règle".

[hb_rates show_season_name="no" chronological="yes"] affichera une grille tarifaire pour toutes les saisons pour le tarif de base. Cette grille affichera les dates des saisons par ordre chronologic mais n'affichera pas le nom des saisons.

---

Grille tarifaire - Bloc Gutenberg


1. Sélectionnez pour quel types d'hébergement est le calendrier de réservation.
2. Sélectionnez quels type de tarifs vous souhaitez afficher : le tarif de base, le tarif par adulte supplémentaire, le tarif par enfant supplémentaire
3. Choisissez la façon dont les tarifs doivent être présentés : chronologiquement ou groupés par saisons. Vous êtes concernés par ce paramètre seulement si vous avez des saisons qui sont formées de différentes périodes.

---

5. Résumé de réservation et Page de remerciements

Vous utiliserez le shorcode ou bloc du Résumé de réservation uniquement si vous avez une Page de remerciements / Thank you page spécifique sur laquelle vous souhaitez rediriger votre client lors de l'affichage de l'écran de confirmation de réservation/demande de réservation.

Shortcode [hb_reservation_summary]

Indiquez le shortcode [hb_reservation_summary] dans votre "Page de remerciements", si vous utilisez le paramètre "thank you_page_url" dans le shortcode pour afficher un formulaire de réservation. Lorsque vos clients sont redirigés vers votre "Page de remerciements" page, ils verront le résumé de la réservation ainsi que les messages de confirmation et remerciements.

Paramètres : aucun

---

Résumé de réservation - Bloc Gutenberg



Il n'y a aucun paramètre pour ce bloc

Page des Réservations

Dans cette section de la documentation, vous trouverez des informations au sujet du menu Réservations de HBook.

Toutes les réservations reçues sur votre site internet sont affichées dans la page Réservations. La page des réservations est séparée en 6 parties.

1. Calendrier
2. Bloquer un hébergement
3. Ajouter une réservation
4. Reservations list
5. Réservations archivées
6. Exporter les réservations

---

A notice can appear at the top of the Reservations page if there has been any errors of synchronization. Voir ici pour mieux comprendre ce que ces notifications signifient. Vous pouvez désactiver ces notifications dans le menu Sync iCal > Paramètres de la sync iCal.

---

1. Calendrier

1. Sélectionnez quels type d'hébergement vous souhaitez afficher
2. La date du jour est surlignée avec un léger fond bleu
3. Aller deux semaines en arrière.
4. Sélectionnez un mois précis de l'année dans le calendrier pop-up
5. Aller deux semaines en avant.
6. Une réservation confirmée apparaîtra en verte
7. Une nouvelle réservation apparaîtra en jaune
8. Un hébergement bloqué apparaîtra en rose

---

2. Bloquer un hébergement

Cet outil vous permet de définir lorsqu'un hébergement n'est pas disponible à la réservation. Cela peut vous être utile si vous avez plusieurs périodes de fermeture dans l'année par exemple ou si vous recevez des réservations d'une autre manière et souhaitez mettre à jour vos disponibilités sans entrer toutes les informations de réservation.

1. Sélectionnez quel(s) types d'hébergement sont concernés.
2. Sélectionnez quel numéros d'hébergements sont concernés.
3. Sélectionnez la date À partir de laquelle l'hébergement n'est pas disponible.
4. Sélectionnez la date Jusqu'à laquelle l'hébergement n'est pas disponible.
5. Ajoutez un commentaire si vous le souhaitez.
6. Cliquez sur Bloquer hébergement

Un liste des hébergements qui sont bloqués est affichée.

---

3. Ajouter une réservation

• Ici vous pouvez ajouter manuellement une réservation. Cela peut vous être utile si vous avez reçu des réservations d'une autre source (téléphone, email...) et souhaitez entrer toutes les informations relatives à la réservation.

  1. Choisissez une date d'arrivée.
  2. Choisissez une date de départ.
  3. Indiquez le nombre d'adultes et d'enfants.
  4. Sélectionnez le type d'hébergement.
  5. Cliquez sur Vérifier la disponibilité et les prix




• Une liste de type d'hébergements disponibles sera affichée et vous pourrez choisir le(s) type(s) d'hébergement :




• Une fois que vous avez sélectionné le type d'hébergement, vous indiquerez les détails de la réservation et du client :

  
  1. Sélectionnez le numéro d'hébergement.
  2. Sélectionnez les services supplémentaires
  3. Vous pouvez définir un prix différent de celui calculé automatiquement par HBook. Pour cela, vous utiliserez une remise (fixe ou pourcentage).
  4. Le calcul des taxes globales pour cette réservation sera affiché
  5. Vous indiquerez les informations relatives au client : vous pouvez choisir un client existant si ce n'est pas la première fois que ce client vient dans votre établissement ou ajouter les informations pour ce client
  6. Vous pouvez ajouter ici un commentaire pour cette réservation
  7. Si vous avez un plugin de multi-langues (comme Polylang ou WPML), vous pourrez sélectionner la langue pour cette réservation.

---

• Ici vous pouvez ajouter manuellement une réservation. Cela peut vous être utile si vous avez reçu des réservations d'une autre source (téléphone, email...) et souhaitez entrer toutes les informations relatives à la réservation.

  1. Choisissez une date d'arrivée.
  2. Choisissez une date de départ.
  3. Indiquez si vous souhaitez ajouter une réservation avec hébergements multiples
  • Si vous souhaitez ajouter une réservation pour un seul hébergement, vous sélectionnerez "Non"
    4. Indiquez le nombre d'adultes
    5. Indiquez le nombre d'enfants.
    6. Sélectionnez le type d'hébergement.
  • Si vous souhaitez ajouter une réservation pour plusieurs hébergements, vous sélectionnerez "Oui"
    4. Indiquez le nombre d'hébergements.
    5. Indiquez le nombre d'adultes et d'enfants. pour chaque hébergement.
  
  

• Une liste de type d'hébergements disponibles sera affichée et vous pourrez choisir le(s) type(s) d'hébergement :




• Vous pourrez choisir chaque hébergement et les services supplémentaires à ajouter :

  
  1. Sélectionnez le numéro d'hébergement.
  2. Sélectionnez les services supplémentaires



• À l'étape suivante, vous verrez le résumé de la réservation, avec le détails des prix :

  



• Vous pourrez indiquer les informations clients et ajouter un commentaire admin optionnel :

  
  1. Vous indiquerez les informations relatives au client : vous pouvez choisir un client existant si ce n'est pas la première fois que ce client vient dans votre établissement ou ajouter les informations pour ce client
  2. Vous pouvez ajouter ici un commentaire pour cette réservation
  3. Si vous avez un plugin de multi-langues (comme Polylang ou WPML), vous pourrez sélectionner la langue pour cette réservation.

---

4. Liste de réservations

Vous trouverez ci-dessous un exemple de ce à quoi peut ressembler une liste de réservation :

---

Filtrer et ordonner les réservations

• Vous pouvez filtrer les réservations par id, numéro de réservation, client, statut, date d'arrivée, date de départ, date d'arrivée et date de départ, réservations en cours, type d'hébergement.
• Vous pouvez ordonner les réservations par date de réception ou date d'arrivée.

---

Colonne "Statut de la réservation"

1. Si vous avez indiqué vouloir utiliser un numéro de réservation, il sera affiché ici.

Dans HBook > Divers > Statuts des réservations, vous pouvez indiquer le statut par défaut des réservations selon qu'elles soient reçues sur votre site depuis le côté client (front-end), ajoutées depuis l'admin de HBook ou importées via la sync iCal. Voir cette section de la documentation pour plus de détails.
A reservation can have 4 status différents:

2. En attente : la réservation demande confirmation de votre part. Une réservation "En attente" n'apparaît pas dans le calendrier (puisque l'hébergement exact n'est pas alloué pour l'instant). Vous ne pouvez voir ce statut que si vous avez défini dans HBook > Divers > Paramètres de confirmation qu'une réservation doit être confirmée avant que les dates soient bloquées.
3. Annulée :la réservation a été annulée, mais n'est pas effacée. Vous pouvez toujours voir les détails de cette réservation mais elle n'apparaît pas dans le calendrier.
4. Confirmée : cela peut être le statut par défaut de la réservation. Lorsque vous cliquez sur l'action "Confirmer", le statut de la réservation peut changer de "En attente" à "Confirmée" si vous acceptez la demande de réservation (Voir Paramètres de confirmation) ou le statut peut passer de "Nouvelle" à "Confirmée", ce qui équivaut à indiquer que vous en avez pris connaissance.
5. Nouvelle : cela peut être le statut par défaut de la réservation. La réservation vient d'être reçue sur votre site et vous n'avez pas encore signalé qu'elle a été lue (en cliquant sur la coche verte).

---

Colonnes "Arrivée/Départ", "Type d'hébergement (numéro)", "Informations", "Commentaires"

1. Pour éditer les dates d'une réservation: cliquez sur Éditer et ensuite renseignez les nouvelles dates.
2. Pour modifier le type d'hébergement/numéro qui est alloué à la réservation: cliquez sur Éditer puis sélectionnez le type d'hébergement/numéro parmi les hébergements disponibles.
3. Pour modifier le nombre de clients: cliquez sur Éditer et indiquez le nouveau nombre d'adultes/enfants.
4. Vous pouvez voir les services supplémentaires choisis
5. Pour ajouter un commentaire, cliquez sur Ajouter un commentaire. Les commentaires peuvent être modifiés également.

---

Colonnes "Client", "Prix/Paiement", "Actions":

1. Si vous cliquez sur "Plus d'info", vous verrez l'ensemble des informations relatives au client. Pour éditer les informations client: cliquer sur Éditer et ajouter/éditer les informations.
2. Une réservation peut avoir trois statuts de paiement: :
   • Non-payé : aucun paiement n'a été effectué pour cette réservation
   • Partiel : la réservation a été partiellement payée (par exemple paiement de l'acompte)
   • Payée : la réservation a été entièrement payée
3. Toutes les informations relatives au paiement sont affichées ici: le montant déjà payé, le reste dû, la remise appliquée, le montant de la caution.
4. Pour éditer le prix, le montant payé ou le reste dû: cliquer sur Éditer le paiement. Vous pouvez également Marquer comme payée.
5. Il est possible d'ajouter ou éditer une Remise qui peut être appliquée soit sur le prix de l'hébergement, soit sur le prix global. Vous verrez les informations relatives à la remise.
6. Si une modification du prix de la réservation a eu lieu (vous avez édité les dates, nombres de personnes, l'hébergement ou bien ajouté une remise...), vous verrez, pour information, l'ancien prix avec un fond gris.
7. Vous verrez un log des emails pour cette réservation
8. Il existe différentes actions qui peuvent être effectuées pour une réservation: Confirmer, Annuler, Envoyer un email, Ouvrir un document ou bien Supprimer. Nous présentons ci-dessous en détails chaque action.

Avec la passerelle de paiement Stripe (uniquement), vous pouvez débiter une carte de crédit qui aura été enregistrée: cliquer sur Débiter et indiquez le montant à débité. Vous pouvez également effectuer un remboursement de tout ou partie du paiement en cliquant sur "Rembourser". Vous indiquerez le montant à rembourser.

---

Actions pouvant être effectuées pour une réservation

Vous pouvez faire 5 types d'actions pour une réservation :
• Marquer comme Confirmée :
  • Si vous avez indiqué qu'une réservation doit être confirmée avant que les dates soient bloquées, cette action ajoutera la réservation au calendrier.
  • Si une réservation n'a pas besoin d'être confirmée, alors cette action ne fera rien d'autre que de modifier le statut à Confirmée et envoyer tout email automatique associé à l'action de confirmation. Vous signalez en cliquant sur "Confirmer" que vous avez lu/vu la réservation.
  • Si vous avez indiqué qu'un/des email(s) doivent être envoyé(s) lors de cette action, les emails seront automatiquement envoyés. Cela a lieu dans tous les cas.
• Annuler
• Envoyer un email
  1. Sélectionnez le modèle d'email que vous souhaitez utiliser. Vous pouvez définir différents modèles dans Emails
  2. Éditer le message si vous souhaitez le personnaliser. Envoyer
  3. Si vous souhaitez ajouter une/des pièce(s) jointe(s), choisissez-les.
  Pour un log détaillé des emails envoyés, vous pouvez regarder dans HBook > Emails.


• Ouvrir un document : vous pouvez choisir parmi les documents que vous avez créés dans Documents
• Supprimer : merci de noter qu'une réservation qui a été effacée ne peut être restaurée, car elle a été supprimée de la base de donnée.

---

5. Réservations archivées

Afin de maintenir une liste de réservation claire et d'améliorer la vitesse de chargement, HBook peut archiver automatiquement les anciennes réservations.

• Les réservations archivées sont listées par mois et quand vous cliquez sur le mois, vous verrez l'ensemble des réservations de ce mois.
• Par défaut, les réservations sont automatiquement archivées lorsque le départ eu lieu le deuxième mois précédent le mois en cours. Vous pouvez modifier ce délai d'archivage dans HBook > Divers > Divers

6. Exporter les réservations

Vous pouvez exporter vos réservations au format .csv, fichier qui peut être importé dans des logiciels de type Excel.

1. Filtrez les réservations que vous souhaitez exporter
2. Sélectionnez pour quels type d'hébergement vous souhaitez faire l'export
3. Choisissez quelles informations doivent être exportées parmi les informations de réservation et du client
4. Cliquez sur Télécharger

Clients

Dans cette section de la documentation, vous trouverez des informations au sujet du menu Clients de HBook. Vous pouvez gérer ici votre liste de clients et les informations associées à chaque client.

---

Ici sont listés l'ensemble de vos clients. L'id d'un client est associée à l'email du client, ce qui signifie que si une réservation est effectuée pour un client existant, toute information associée au "Client" - tel que paramétré dans HBook > Formulaire infos client/réservation - sera mise à jour si elle est modifiée.

1. Vous pouvez effectuer une recherche dans la table des clients. Vous pouvez également ordonner les clients par id ou nom de famille
2. Vous pouvez voir l'historique des réservations d'un client. Si vous cliquez sur le nombre de réservations effectuées par le client, vous verrez la liste de réservations pour ce client.
3. Vous pouvez modifier les informations pour ce client ou bien effacer ce client de la liste. Il sera supprimé de la base de données.

Documents

Dans cette section de la documentation, vous trouverez des informations au sujet du menu Documents de HBook.s Vous pouvez gérer ici votre liste de clients et les informations associées à chaque client.

---

Vous pouvez créer des modèles de document. Depuis la liste de réservation, vous trouverez une action "Ouvrir un document". Vous pouvez choisir le modèle de document que vous souhaitez ouvrir et HBook va automatiquement le générer, de façon dynamique (en remplaçant les variables par les informations spécifiques à cette réservation. Ceci peut être très utile pour afficher/imprimer/télécharger des factures, contrats, reçus,etc...

1. Cliquez sur Ajouter un nouveau modèle de document
2. Indiquez le nom de ce nouveau modèle.
3. Ajouter le contenu HTML de votre modèle de document. Vous pouvez utiliser toutes les variables listées. Pour comprendre à quoi correspond chaque variable, vous pouvez consulter cette section de la documentation.
4. Ne pas oublier de sauvegarder.

Passerelles de paiement pour HBook (modules complémentaires)

HBook inclut les passerelles de paiement Stripe et PayPal. Nous avons développé des modules complémentaires afin d'ajouter des passerelles de paiement à HBook. Voir l'ensemble des passerelles de paiement disponibles pour HBook

Vous trouverez ci-dessous la documentation concernant les modules complémentaires pour HBook :

• 2Checkout
• Authorize.net
• Axepta - BNP Paribas
• BarclayCard
• BillPlz
• CardLink - Eurobank and Alphabank
• Cecabank
• Clic&Pay - Crédit du Nord Group
• Converge
• E-Transactions Up2Pay - Crédit Agricole
• Instamojo
• Iyzipay
• Lyra
• Mercadopago
• Mercanet
• Mollie
• Monetico - Crédit Mutuel, CIC, Desjardins
• Montonio
• OnePay Vietnam
• PayBox
• PayFast
• PayLine
• PayPlug
• Payrexx
• Paysera
• PayU Poland/Hungary/Czech Republic
• PayU Romania/Rusia
• PayU Latam
• PayU Money
• PayZen
• Razorpay
• RedSys
• Scellius - La Banque Postale
• Sogecommerce - Société Générale
• Square
• SystemPay - Caisse d'Épargne and Banque Populaire
• Viva Wallet

---

Une fois que vous avez téléchargé le module complémentaire, vous pouvez le téléverser et l'activer depuis Extensions comme vous le feriez avec tout autre extension.

Pour chaque passerelle de paiement, deux environnements sont disponibles:

• Test/Pré-production/Sandbox) : cela correspond à de faux paiements (aucune transaction réelle), très utile pour vérifier que tout fonctionne normalement
• Live/Production : ceci correspond à des paiements réels

Vous pouvez modifier tout texte affiché par les modules complémentaires dans HBook > Texte. Vous pouvez également ajouter un texte personnalisé sous le formulaire et pour certaines passerelles, vous pouvez choisir quelles icônes vous souhaitez afficher.

---

2Checkout pour HBook

1. Une fois que vous avez installé et activé l'extension 2Checkout pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite 2Checkout comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Indiquez vos informations 2Checkout pour les environenments "Sandbox" et "Live" dans HBook > Paiement > Paramètres 2Checkout Ces paramètres indifférents pour l'environnement Sandbox et Live. Seuls les paramètres "Live" ou "Test" changerons l'environnement à un paiement réel ou sandbox. Vous pouvez voir les transactions des deux environnements depuis votre 2Checkout dashboard.


4. Depuis votre 2Checkout dashboard, vous trouverez votre "Merchant ID" et la "Secret key" dans Integrations > Webhook and API.


5. Dans Integrations > Webhook and API vous devrez cocher la case "Header URL" et sélectionez l'option "Enable return after sale". Nous nous occupons de l'url de retour Vous n'avez rien d'autre à faire. Ceci est essentiel, car cela va forcer la redirection vers votre site internet une fois le paiement effectué. HBook a besoin de ce retour vers le site marchand afin d'afficher les résultats de la transaction, de mettre à jour les informations de réservation, d'envoyer les emails automatiques, etc... Voir capture d'écran ci-dessous:

---

Authorize.net pour HBook

1. Une fois que vous avez installé et activé l'extension Authorize.net pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite Authorize.net comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Indiquez vos informations Authorize.net pour les environnements "Sandbox" et "Live" dans HBook > Paiement > Paramètres Authorize.net Ces paramètres sont différents pour l'environnement Sandbox et Live.


4. Dans votre dashboard d'Authorize.net, vous devez créer un Webhook depuis Account > Business settings > Webhooks. Merci de regarder attentivement la capture d'écran ci-après pour comprendre comment paramétrer le Webhook. Le "name" n'a pas vraiment d'importance, mais la structure de l'url est importante: vous ajouterez "/confirmation-authorize" à l'url de base de votre site WordPress. Vous indiquerez ainsi "www.domain.com/confirmation-authorize", en remplaçant "www.domain.com" par l'url de votre site WordPress. Si vous utilisez des sites différents en pré-production et production, assurez-vous d'indiquer à chaque fois le webook correct, lorsque vous changez de mode. Dans le dashboard de Sandbox Authorize.net, vous indiquez l'url du webhook de votre site de pre-production. Dans le dashboard de Authorize.net (Live), vous indiquez l'url du webhook de votre site de production.


5. Assurez-vous de toujours choisir le mode "Live" dans Account > Security settings > Test mode. Ceci doit toujours être à "Live" même dans l'environnement Sandbox; sinon les webhook ne sont pas appelés. Aucune transaction réelle n'aura lieu avec le compte Authorize.net Sandbox, même si vous indiquez "Live" dans les paramètres du mode Test. ;-)

Comment créer un compte Sandbox Authorize.net et un compte Live Authorize.net?

• Vous pouvez créer un compte Sandbox depuis cette page.
• Vous pouvez créer un compte Authorize.net depuis cette page et l'url de login est : https://account.authorize.net/.

Où trouver les informations API Authorize.net qui doivent être renseignées dans HBook > Paiements > Paramètres Authorize.net?

Vous trouverez les informations API dans le dashnboard de Authorize.net: Account > Security Settings > API Credentials & Keys. Vous aurez besoin de "API Login ID" et de "Transaction Key". Vous pouvez générer une "Signature Key".

Vous avez besoin de "API Login ID", "Transaction Key" et de créer une "Signature Key".

Merci de noter que ces paramètres sont différents en mode Sandbox et en mode Live

Quelles cartes bancaires de Test puis-je utiliser ?

Vous trouverez les cartes de tests ici.

Qu'est-il nécéssaire de faire lorsque vous passez du mode Sandbox au mode Live pour Authorize.net?

• Indiquez les Live Authorize.net "API Login ID", "Transaction Key" et créez une "Signature Key"
• Ajouter l'url du webhook de production(live) dans votre dashboard Authorize.net

---

Axepta for HBook - BNP Paribas

1. Once you have activated Axepta for HBook plugin in you need to validate the licence in HBook > Licence.
2. Set Axepta as active payment gateways in HBook > Payments > Active payment gateways
3. Enter your Axepta information in HBook > Payment > Axepta settings For the Test environment, the BNP_DEMO_AXEPTA test account is used by default. The Merchant ID, Blowfish Key and HMAC Key are provided by BNP Paribas. If you only allow credit card payments, you can indicate it in the settings. The customer will be redirected directly to Axepta credit card form screen. Else, the customer will go through Axepta payment method selection screen.

---

BarclayCard for HBook

1. Une fois que vous avez installé et activé l'extension BarclayCard pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite BarclayCard comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Indiquez vos informations BarclayCard dans HBook > Paiement > Paramètres BarclayCard.
   

   Les "SHA-IN passphrase" et "SHA-OUT passphrase" sont différentes pour chaque environnement.

   


4. Depuis votre tableau de bord de BarclayCard, vous trouverez votre "SHA-IN passphrase" dans Confirguration > Technical information > Data and origin verification.


5. Vous devez paramétrer correctement BarclayCard pour le "Transaction feedback" et obtenir votre "SHA-OUT passphase". Merci de consulter ci-dessous la configuration requise dans Confirguration > Technical information > Transaction feedback. Ceci est essentiel, car cela va forcer la redirection vers votre site internet une fois le paiement effectué. HBook a besoin de ce retour vers le site marchand afin d'afficher les résultats de la transaction, de mettre à jour les informations de réservation, d'envoyer les emails automatiques, etc.... Voir capture d'écran ci-dessous:


6. Il est recommandé d'effectuer le paramétrage suivant afin d'obtenir un meilleur rendu de la page de paiemen:
   
   • Dans Configuration > Template > Template selection, choisissez le modèle "BarclaysResponsivePaymentPageTemplate"
   • Dabs Configuration > Template > File manager, téléverser un fichier logo.png afin d'inclure votre logo dans la page de paiement

---

BillPlz Malaysia pour HBook

1. Une fois que vous avez installé et activé l'extension BillPlz pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite BillPlz comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres BillPlz, vous aurez besoin d'ajouter les informations suivantes: Secret Key, X-Signature key, et Collection ID

Comment créer un compte Sandbox BillPlz et un compte Live BillPlz?

• Vous pouvez créer un compte Sandbox depuis cette page.
• Vous pouvez créer un compte Live depuis cette page.

Oú trouver la Collection ID?

Vous devez créer une Collection dans le menu "Billing" de votre tableau de bord BillPlz. Vous pourrez ensuite copier la "Collection ID".

Où trouver les Secret Key et X-Signature key?

Vous les trouverez dans le menu Settings de votre tableau de bord BillPlz.

---

CardLink pour HBook - Eurobank et Alphabank

1. Une fois que vous avez installé et activé l'extension CardLink pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite CardLink comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. In HBook > Payments > CardLink settings, choose if you are using Eurobank/WorldLine, Alphabank/Nexi or CardLink One payment gateway. Vous aurez besoin d'ajouter les informations suivantes qui vous seront communiquées par votre banque:

---

Cecabank pour HBook

Le module Cecabank inclut les fichiers de traduction à l'espagnol. Si votre site est en espagnol, vous verrez automatiquement l'admin en espagnol.

• Une fois que vous avez installé et activé l'extension Cecabank pour HBook, vous devrez valider votre licence dans HBook > Licence.
• Activez ensuite Cecabank comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
• Dans HBook > Paiements > Paramètres Monetico, vous aurez besoin d'ajouter les informations suivantes: Merchant ID, Adquirer BIN et Terminal ID
• Vous trouverez ces informations dans le tableau de bord de Cecabank dans Cecabank > TPV Virtual > Datos generales. Veuillez vous assurer que vous consultez le bon environnement : "Datos de pruebas" pour l'environnement Test et "Datos reales" pour celui " Live".
  1. Voici où trouver les informations : Merchant ID, Adquirer BIN et Terminal ID
  2. Voici comment vous devez paramétrer Cecabank pour que le statut de la transaction soit communiqué par Cecabank à votre "URL online OK". Cette url aura toujours le format suivant: www.mysite.com/confirmation-cecabank. You will modify "mywebsite" with your own domain name.

Qu'est-il nécéssaire de faire lorsque vous passez du mode Sandbox au mode Live pour Cecabank?

• Indiquez la "Clave de encriptación" de l'environnement "Live"
• Ajouter l'url du webhook "URL online OK" Live dans votre tableau de bord de Cecabank.

---

Clic&Pay pour HBook - Groupe Crédit du Nord

Le module Clic&Pay inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension Clic&Pay pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite Clic&Pay comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. In HBook > Payments > Clic&Pay settings, set Clic&Pay payment gateway. Vous aurez besoin d'ajouter les informations suivantes:
4. Vous trouverez votre "Shop ID (identifiant boutique)" et vos "Clés" dans Paramétrage > Boutiques > Clés. Si vous souhaitez activer le paiement par "Cheques-Vacances Connect" dans HBook, assurez-vous d'inidiquer les "Shop ID" et "Clés" de votre compte CVCO du Back Office de Clic&Pay.

---

Elavon Converge pour HBook

1. Une fois que vous avez installé et activé l'extension Elavon Converge pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite Elavon Converge comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres Elavon Converge, vous aurez besoin d'ajouter les informations suivantes: "Merchant ID", "User ID", "Pin"

Comment créer un compte Sandbox Elavon Converge ?

• Pour créer un compte Sandbox/DEMO Elavon Converge, vous devez contacter Elavon Converge. Vous pouvez consulter cet article pour vérifier les informations que vous devez fournie à Elavon Converge : https://developer.elavon.com/na/docs/converge/1.0.0/integration-guide/api_introduction. Vous devrez communiquer votre addresse IP, l'URL de votre site web, et votre URL pour la fonctionnalité "Exports script"
• Cette URL Exports script aura toujours le format suivant: www.mysite.com/confirmation-converge.

Oú trouver mon PIND pour le compte Elavon Converge?

Le PIN est associé à l'utilisateur du terminal. Allez dans la section Employees, puis sélectionnez l'utilisateur. Vous pourrez ainsi obtenir le PIN.

Comment personnaliser la Page de paiement dans Elavon converge?

• Allez dans Settings > Advanced API Settings > Hosted Payments
• Nous utilisons la "Payment modal". Cliquez sur Set up
• Vous pouvez ainsi personnalier le formulaire de la page de paiement. Nous conseillons l'ajout d'un logo pour une meilleur expérience utilisateur.

Quelles cartes bancaires de Test puis-je utiliser?

You can find the test card details on this page.

Qu'est-il nécéssaire de faire lorsque vous passez du mode Sandbox au mode Live pour Elavon Converge?

Vous devrez communiquer <b3>votre addresse IP</b3>, <b4>l'URL de votre site web</b4>, et votre <b5>URL pour la fonctionnalité "Exports script"</b5>

---

E-Transactions Up2Pay pour HBook

Le module E-Transactions inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension E-Transactions Up2Pay pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite E-TransactionsUp2Pay comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres E-Transactions Up2Pay, indiquez les paramètres de la passerelle de paiement. Vous aurez besoin d'ajouter les informations suivantes qui vous seront communiquées par votre banque:
4. Vous pouvez activer la méthode de paiement "Chèques Vacances Connect". Il est nécessaire d'avoir signé un contrat avec ANCV et de contacter E-Transactions pour les informer que vous souhaitez activer ce moyen de paiement.

What are the required customer details fields?

E-Transactions Up2Pay requires the following fields: 'first_name', 'last_name', 'address_1', 'city', 'country_iso', 'zip_code', 'phone'.

---

Où trouver ma clé HMAC?

Vous devez générer votre clé HMAC depuis le tableau de bord de Vision. Merci de noter que la clé HMAC est différente en mode Test(Pré-production) et en mode Live(Production)

---

Instamojo pour HBook

1. Une fois que vous avez installé et activé l'extension Instamojo pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite Instamojo comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres Instamojo, vous aurez besoin d'ajouter les informations suivantes: API Key et Auth token

Comment créer un compte Sandbox Instamojo et un compte Live Instamojo?

• Vous pouvez créer un compte Sandbox depuis cette page.
• Vous pouvez créer un compte Live depuis cette page.

Où trouver les API Key et Auth token?

Vous les trouverez dans le menu Developers de votre dashboard de Instamojo.

---

Iyzipay for HBook

1. Once you have activated Iyzipay for HBook plugin, you need to validate the licence in HBook > Licence.
2. In HBook > Payments > Active payment gateways, you will activate Iyzipay.
3. In HBook > Payments > Iyzipay settings, you will need to add the API Key and the Secret Key:
4. In HBook > Details form, you will need to create a new field "buyer_identity". This is a required field for Iyzipay and you have to name it this way in the details form fields, for HBook to be able to recognize it. You can modify the displayed label in HBook > Text > Details form, so you have a proper label for it for your customers.

How to create a Sandbox Iyzipay and a Live Iyzipay account?

• Vous pouvez créer un compte Sandbox depuis cette page.
• Vous pouvez créer un compte Live depuis cette page.

Where to find the API Key and Secret Key?

You will find them in the menu Settings > Merchant settings of your Iyzipay dashboard..

---

Lyra pour HBook

Le module Lyra inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension Lyra pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite Lyra comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres Lyra, indiquez les paramètres de la passerelle de paiement. Vous aurez besoin d'ajouter les informations suivantes:
4. Vous trouverez votre "Shop ID (identifiant boutique)" et vos "Clés" dans Paramétrage > Boutiques > Clés. Si vous souhaitez activer le paiement par "Cheques-Vacances Connect" dans HBook, assurez-vous d'inidiquer les "Shop ID" et "Clés" de votre compte CVCO du Back Office de Clic&Pay.

---

MercadoPago pour HBook

Le module MercadoPago inclut les fichiers de traduction à l'espagnol. Si votre site est en espagnol, vous verrez automatiquement l'admin en espagnol.

1. Une fois que vous avez installé et activé l'extension MercadoPago pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite MercadoPago comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres MercadoPago, vous aurez besoin d'ajouter les informations suivantes:

Où trouver mon Access Token?

Vous trouverez votre "Access Token" dans le Dashboard ou dans le menu MercadoPago Tu Negocio> Configuración> Gestión y Administración> Credenciales.

---

Mercanet pour HBook

Le module Mercanet inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension Mercanet pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite MercadoPago comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Si vous êtes en environnement Test, aucun autre paramétrage n'est nécessaire.
4. Si vous êtes en environnement Live, vous aurez besoin d'ajouter les informations suivantes: Votre "Merchant ID" est fourni par BNP Paribas Mercanet.

Où trouver les Secret Key et Version key pour l'environnement "Live"?

Vous trouverez des instructions pour récupérer votre "Secret Key" et "Version Key" ici dans la documentation de BNP Paribas Mercanet.

Quelles cartes bancaires de Test puis-je utiliser?

Vous trouverez les cartes de tests dans cette section de la documentation de BNP Paribas Mercanet..

---

Mollie pour HBook

Le module Mollie inclut les fichiers de traduction au néerlandais. Si votre site est en néerlandais, vous verrez automatiquement l'admin en néerlandais.

1. Une fois que vous avez installé et activé l'extension Mollie pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite Mollie comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres Mollie, indiquez les paramètres de la passerelle de paiement. Vous aurez besoin d'ajouter les informations suivantes:

Où trouver les clés API?

Vous les trouverez dans le menu Developers de votre dashboard de Mollie. Voir cet article de Mollie.

Quelles méthodes de paiement disponibles dans Mollie peuvent être utilisées avec HBook?

Vous trouverez ci-dessous la liste des méthodes de paiement que vous pouvez utiliser et qui fonctionneront correctement avec HBook:

• Carte bancaire
• Ideal
• Bancontact
• GiroPay
• KBC
• Sofort
• EPS
• PaySafeCard

Les méthodes de paiement ci-dessous ne sont pas utilisables:

• PayPal: vous devrez utiliser la passerelle PayPal déjà disponible depuis HBook
• ING et Belfius Pay button
• Bank transfer: vous devrez utiliser l'option "Paiement hors-ligne" de HBook

---

Montonio for HBook

1. Once you have activated Montonio for HBook plugin, you need to validate the licence in HBook > Licence.
2. In HBook > Payments > Active payment gateways, you will activate Montonio.
3. In HBook > Payments > Montonio settings, set Montonio payment gateway. Vous aurez besoin d'ajouter les informations suivantes:
4. If you wish to show the Credit cards option in the payment methods, you will need to have completed the Stripe onboarding through Montonio's Partner System, for your customers to pay with Credit cards.

Où trouver les clés API?

You will find them in the menu API Keys of your Montonio Store dashboard. Please note that you will have a set of keys for the "Sandbox" environment and another set for the "Live" environment..

---

Monetico - Crédit Mutuel, CIC, Desjardins

Le module Monetico inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension Monetico pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite Monetico comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres Monetico, vous aurez besoin d'ajouter les informations suivantes:
4. Si vous avez sélectionné l'option "Retour immédiat" de Monetico, contactez Monetico afin de leur communiquer l'url de retour. Cette url aura toujours le format suivant: www.mysite.com/confirmation-monetico. Merci de noter que vous aurez besoin de les contacter à nouveau pour mettre à jour votre "Url de retour" si vous avez un environnement production(live) différent de celui de pré-production(test).

Quelles cartes bancaires de Test puis-je utiliser?

Lorsque vous serez redirigé vers la page de paiement de Monetico, vous verrez un bouton "Test cards". Cela génèrera automatiquement les informations de cartes bancaires de tests. Vous pouvez faire des simulations pour différentes situations. Plus d'information ici.

---

OnePay Vietnam pour HBook

1. Une fois que vous avez installé et activé l'extension OnePayUne fois que vous avez installé et activé l'extension OnePay pour HBook, vous devrez valider votre licence dans HBook > Licence. pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite OnePay comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres OnePay, indiquez les paramètres de la passerelle de paiement.
4. Si vous êtes en environnement Test, aucun autre paramétrage n'est nécessaire.
Si vous êtes en environnement Test, vous aurez besoin d'ajouter les informations suivantes fournies par OnePay: Merchant ID, Access code et Hash key.
5. Vous devrez les indiquer pour les paiements Domestiques et Internationaux payments.

PayBox pour HBook

Le module PayBox inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension PayBox pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite PayBox comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres PayBox, indiquez les paramètres de la passerelle de paiement. Vous aurez besoin d'ajouter les informations suivantes qui vous seront communiquées par votre banque:

Où trouver ma clé HMAC?

Vous devez générer votre clé HMAC depuis le tableau de bord de Vision. Merci de noter que la clé HMAC est différente en mode Test(Pré-production) et en mode Live(Production)

Activez le retour automatique vers le site marchand

Vous devez contacter PayBox afin d'activer le "retour immédiat vers la boutique".

---

PayFast pour HBook

1. Une fois que vous avez installé et activé l'extension PayFast pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite PayFast comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres PayFast, vous aurez besoin d'ajouter les informations suivantes: Merchant ID, Merchant Key et Salt Passphrase

Où trouver les informations Merchant ID et Merchant Key?

Vous trouverez des instructions pour créer votre "Merchant ID " et "Merchant Key" ici dans la documentation de PayFast.

Comment créer ma Salt Passphrase?

Vous trouverez des instructions pour créer votre "Salt Passphrase " ici dans la documentation de PayFast.

---

PayLine pour HBook

Le module PayLine inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension PayLine pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite PayLine comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres PayLine, indiquez les paramètres de la passerelle de paiement. Vous aurez besoin d'ajouter les informations suivantes qui vous seront communiquées par PayLine :

Quelles cartes bancaires de Test puis-je utiliser?

Vous trouverez les cartes de tests dans cet article de PayLine.

---

PayPlug pour HBook

Le module PayPlug inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension PayPlug pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite PayPlug comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres PayPlug, indiquez les paramètres de la passerelle de paiement. Vous devez indiquer votre "Secret Key" que vous trouverez dans tableau de bord de PayPlug.
4. Vous pouvez personnaliser la page de paiement de PayPlug directement depuis votre tableau de bord PayPlug.

Où trouver la Secret Key?

Vous la trouverez dans le menu Settings > API keys de votre tableau de bord PayPlug. Veuillez vous assurer que vous entrez la "TEST Key" lorsque vous êtes en mode "Test" et de même, que vous indiquez la "LIVE key" en mode "Live".

Quelles cartes bancaires de Test puis-je utiliser?

Vous trouverez les cartes de tests dans cet article de PayPlug.

---

Payrexx pour HBook

Le module Payrexx inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension Payrexx pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite Payrexx comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres Payrexx, indiquez les paramètres de la passerelle de paiement. Vous aurez besoin d'ajouter les informations suivantes qui vous seront communiquées par Payrexx :
4. Vous pouvez personnaliser la page de paiement de Payrexx directement depuis votre tableau de bord PayPlug.

Qu'est-il nécéssaire de faire lorsque vous passez du mode Sandbox au mode Live?

Payrexx fonctionne avec un compte seulement, et non un compte "demo/test" et un compte "live". Pour indiquer qu'une intégration API est en mode "test", vous paramétrerez chaque PSP en mode test individuellement. Vous pouvez effectuer cette action dans votre compte Payrexx en allant à Payment Provider - Configure. Nous conseillons la création d'une seconde intégration API, en plus de celle fournie par défaut. Une des intégrations sera en mode "Test" et l'autre sera votre intégration en mode "Live". Dans HBook > Paiements > Paramètres Payrexx, vous avez la possibilité d'ajouter les Instance name et API Key à la fois pour les environnements "Test" et "Live".

Où trouver les Instance name et API key?

• Votre Instance name est créée au moment où vous ouvrez un compte Payrexx ou lorsque vous créez une nouvelle Intégration API depuis votre tableau de bord. Vous pouvez également trouver votre "Instance name" dans l'URL de la page de paiement, communiquée par Payrexx lors de l'ouverture de votre compte. Par exemple, avec "hbook" comme "Instance name", l'url de la page de paiement sera "https://hbook.payrexx.com".
• Vous trouverez votre API key dans le menu Integrations > API & Plugins de votre tableau de bord Payrexx.

Quelles cartes bancaires de Test puis-je utiliser?

Vous trouverez les cartes de tests dans cet article de Payrexx.

---

PaySera pour HBook

1. Une fois que vous avez installé et activé l'extension PaySera pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite PaySera comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres PaySera, vous aurez besoin d'ajouter les informations suivantes: Project ID and Sign password
4. Dans votre tableau de bord de Paysera, allez à Projects and Activities > My projects, cliquez sur Project settings > Payment collection service settings et vérifier les informations suivantes :
   • Allow test payments
   • Accept inflows from any informational system (query website address will not be checked)

Où trouver les informations Project ID et Sign password?

You can find the steps to create your Project ID and Sign password in this help article from PaySera.

Quelles méthodes de paiement disponibles dans PaySera peuvent être utilisées avec HBook?

• Carte bancaire
• PaySera Wallet

---

PayU for HBook (Poland, Hungary, Czech Republic)

1. Une fois que vous avez installé et activé l'extension PayU pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite PayU comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres PayU, vous aurez besoin d'ajouter les informations suivantes: POS ID, MD5 Key, Client ID et Client Secret.

Comment créer un compte Sandbox PayU.com ?

Vous pouvez créer un compte Sandbox depuis cette page.

Quelles cartes bancaires de Test puis-je utiliser?

Vous trouverez les cartes de tests dans cette section de la documentation de PayU..

Où trouver les informations POS ID et MD5 Key, Client ID et Client Secret?

Vous trouverez toutes ces informations dans l'onglet POS, après avoir choisi d'éditer votre Shop dans Online payments > My shops.

---

PayU for HBook (Romania, Rusia)

1. Une fois que vous avez installé et activé l'extension PayU pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite PayU comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres PayU, vous aurez besoin d'ajouter les informations suivantes: POS ID, MD5 Key, Client ID et Client Secret.
4. In Pay U dashboard, in the IPN settings tab in Account management > Account settings, you need to setup PayU IPN. It will always be following the format: https://mywebsite.com/confirmation-payuroru. You will modify "mywebsite" with your own domain name.
.

Quelles cartes bancaires de Test puis-je utiliser?

Vous trouverez les cartes de tests dans cette section de la documentation de PayU..

Where to find my Merchant Code and Secret Key?

You can find these credentials in the API Keys tab in Account management > Account settings.

---

PayULatam pour HBook

Le module PayULatam inclut les fichiers de traduction à l'espagnol. Si votre site est en espagnol, vous verrez automatiquement l'admin en espagnol.

1. Une fois que vous avez installé et activé l'extension PayULatam pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite PayULatam comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres PayULatam, indiquez les paramètres de la passerelle de paiement. Choisissez votre pays.
4. Si vous êtes en environnement Test, aucun autre paramétrage n'est nécessaire.
5. Si vous êtes en environnement Live, vous aurez besoin d'ajouter les informations suivantes:

Où trouver les informations Merchant ID, API Key et Account ID?

Voir cet article de PayULatam.

---

PayUMoney pour HBook

1. Une fois que vous avez installé et activé l'extension PayUMoney pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite PayUMoney comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres PayUMoney, indiquez les paramètres de la passerelle de paiement.

Où trouver les Key et Salt?

Vous trouverez les informations Key et Salt dans votre dashboard de PayUMoney. Veuillez vous assurer que vous entrez les Test Key et Test Salt lorsque vous êtes en mode Test, mais les Live Key et Live Salt une fois passé en mode Live.

---

PayZen pour HBook

1. Une fois que vous avez installé et activé l'extension PayZen pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite PayZen comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. In HBook > Payments > Payzen settings, set PayZen payment gateway. Vous aurez besoin d'ajouter les informations suivantes:
4. Vous trouverez votre "Shop ID (identifiant boutique)" et vos "Clés" dans Paramétrage > Boutiques > Clés. Si vous souhaitez activer le paiement par "Cheques-Vacances Connect" dans HBook, assurez-vous d'inidiquer les "Shop ID" et "Clés" de votre compte CVCO du Back Office de PayZen.

---

RedSys pour HBook

Le module RedSys inclut les fichiers de traduction à l'espagnol. Si votre site est en espagnol, vous verrez automatiquement l'admin en espagnol.

1. Une fois que vous avez installé et activé l'extension RedSys pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite RedSys comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiement > Paramètres RedSys, indiquez les paramètres communiqués par RedSys. Vous aurez besoin d'ajouter les informations suivantes qui vous seront communiquées par votre banque:

---

Scellius pour HBook - La Banque Postale

Le module Scellius inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension Scellius pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite Scellius comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. In HBook > Payments > Scellius settings, set Scellius payment gateway. Vous aurez besoin d'ajouter les informations suivantes:
4. Vous trouverez votre "Shop ID (identifiant boutique)" et vos "Clés" dans Paramétrage > Boutiques > Clés. Si vous souhaitez activer le paiement par "Cheques-Vacances Connect" dans HBook, assurez-vous d'inidiquer les "Shop ID" et "Clés" de votre compte CVCO du Back Office de Scellius.

---

SogeCommerce pour HBook - Société Générale

Le module SogeCommerce inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension SogeCommerce pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite SogeCommerce comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres SogeCommerce, indiquez les paramètres de la passerelle de paiement. Vous aurez besoin d'ajouter les informations suivantes:
4. Vous trouverez votre "Shop ID (identifiant boutique)" et vos "Clés" dans Paramétrage > Boutiques > Clés. Si vous souhaitez activer le paiement par "Cheques-Vacances Connect" dans HBook, assurez-vous d'inidiquer les "Shop ID" et "Clés" de votre compte CVCO du Back Office de SogeCommerce.

---

Square pour HBook

1. Une fois que vous avez installé et activé l'extension Square pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite Square comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres Square, indiquez les paramètres de la passerelle de paiement. Vous aurez besoin d'ajouter les informations suivantes:

Où trouver les informations Location ID et Access token?

• Vous devrez utiliser l'action create an application dans le dashboard de Square Developer. Vous pouvez par exemple la nommer "HBook Booking system".
• Sandbox et Live Location ID


• Sandbox Access token


• Live Access token

Quelles cartes bancaires de Test/Sandbox puis-je utiliser?

Vous trouverez les cartes de tests dans cet article de Square.

---

SystemPay pour HBook - Caisse d'Épargne and Banque Populaire

Le module SystemPay inclut les fichiers de traduction au français. Si votre site est en français, vous verrez automatiquement l'admin en français.

1. Une fois que vous avez installé et activé l'extension SystemPay pour HBook, vous devrez valider votre licence dans HBook > Licence.
2. Activez ensuite SystemPay comme passerelle de paiement dans HBook > Paiments > Activer passerelles de paiement
3. Dans HBook > Paiements > Paramètres SystemPay, indiquez les paramètres de la passerelle de paiement. Vous aurez besoin d'ajouter les informations suivantes:
4. Vous trouverez votre "Shop ID (identifiant boutique)" et vos "Clés" dans Paramétrage > Boutiques > Clés. Si vous souhaitez activer le paiement par "Cheques-Vacances Connect" dans HBook, assurez-vous d'inidiquer les "Shop ID" et "Clés" de votre compte CVCO du Back Office de SystemPay.

---

Viva Wallet for HBook

1. Once you have activated Viva Wallet for HBook plugin, you need to validate the licence in HBook > Licence.
2. In HBook > Payments > Active payment gateways, you will activate Viva Wallet.
3. In HBook > Payments > Viva Wallet settings, set Viva Wallet payment gateway. Vous aurez besoin d'ajouter les informations suivantes:
4. In Viva Wallet dashboard, you will need to create a webhook. Navigate to Settings > API Access and go to the tab Webhooks. You will need to indicate :
   • the URL of the webhook. You will indicate it as "www.domain.com/confirmation-vivawallet", changing "www.domain.com" to your actual WordPress site url.
   • set it as "Active"
   • select the event type "Transaction Payment Created"
   

Do I need to whitelist VivaWallet IPs? Where can I get information ?

If you have troubles to verify your Webhook url, you should whitelist VivaWallet IPs to make sure you receive the webhook call. You can find the list of VivaWallet IPs here.

How to create a Sandbox Viva Wallet account ?

Vous pouvez créer un compte Sandbox depuis cette page.

How to create a Live Viva Wallet account ?

You can create your Live Account from here.

Where to find the Source Code, Merchant ID, API Key, Client ID and Client Secret, ?

• Source Code: You will need to create a website/app in Viva Wallet dashboard. Navigate to Sales > Online Payments > Websites/Apps. Click on "New app/website" and check below for the settings. You can name it for example "VivaWallet HBook".
• When you create or edit a website/app, you will see the following settings. Please make sure that you enter the "Success URL" and "Failure URL" as described.
• Merchant ID, API Key, Client ID and Client Secret : Navigate to Settings > API Access.

Quelles cartes bancaires de Test/Sandbox puis-je utiliser?

Vous trouverez les cartes de tests dans cet article de Square.

---

Personnalisation de l'extension

Afin de faciliter la personnalisation du plugin, différents filtres et actions ont été créés. Nous recommandons d'insérer le custom code dans le fichier functions.php de votre thème-enfant afin de garantir que ce code ne soit pas effacé lors de la mise à jour du plugin ou du thème.

Filtres relatifs au post de type d'hébergements

• hb_accommodation_cpt
• hb_accommodation_public
• hb_accommodation_has_archive
• hb_accommodation_supports
• hb_accommodation_taxonomies

Filtres relatifs au formulaire de recherche

• hb_search_form_markup
• hb_search_form_title

Filtres relatifs à la sélection du type d'hébergement

• hb_available_accommodation_markup
• hb_first_available_accom_num

Filtres relatifs à la sélection des services supplémentaires

• hb_extra_name
• hb_extras_form_markup
• hb_resa_extra_formatting

Filtres relatifs au formulaire de détails client/résa

• hb_details_form_markup_before_field
• hb_details_form_markup_after_field
• hb_details_form_markup

Filtres relatifs à l'étape de paiement

• hb_payment_types
• hb_stripe_credit_cards_icons

Filtres relatifs au résumé de la réservation et à la zone du bouton final "Réservez maintenant"

• hb_resa_summary_markup
• hb_resa_summary_no_external_payment_markup
• hb_resa_summary_external_payment_markup
• hb_policies_area_markup
• hb_confirm_area_markup

Filtres relatifs à la facture

• hb_invoice_table_style
• hb_invoice_table_markup

Filtres relatifs aux actions associées à la réservation et au client

• hb_create_reservation
• hb_create_customer
• hb_reservations_updated
• hb_blocked_accom_updated

Filtres relatifs aux shorcodes [hb_accommodation_list], [hb_rates], [hb_availability]

• hb_accommodation_list_markup
• hb_rates_markup
• hb_availability_on_click_refresh

Filtres relatifs aux rôles ajoutés par HBook ("Reservation manager", "Reservation reader", "Pricing manager", et "HBook manager")

• hb_resa_reader_capabilities
• hb_resa_manager_capabilities
• hb_pricing_manager_capabilities
• hb_hbook_manager_capabilities

Filters for automatic emails

• hb_email_actions : permet d'ajouter des actions qui déclenchent l'envoi d'un email (comme par exemple de cliquer sur "Marquer comme payée")
• hb_scheduled_min_hour : to change the sending window minimum hour of the day
• hb_scheduled_max_hour : to change the sending window maximum hour of the day. Default is 11pm

Divers

• hb_language_list
• hb_uncompleted_resa_deletion_delay
• hb_old_resa_logs_deletion_delay
• hb_retina_scale_factor
• hb_image_sizes
• hb_strings: permet d'ajouter des chaînes de caractères externes à HBook > Texte
• hb_ical_additional_info

Fonctions js

Le plugin HBook appelle aussi les deux fonctions JavaScript suivantes:

• hbook_show_accom_list
• hbook_reservation_done

---

hb_accommodation_taxonomies

Ceci est un filtre qui s'applique aux taxonomies Paramètre qui est passé dans la fonction register_post_type utilisée pour créer les posts de Types d'Hébergement.

Paramètre:

• $taxonomies: (tableau) liste des taxonomies.

Exemple:
Ajout des catégories pour les postes de Type d'Hébergement.

function categories_for_accommodation( $taxonomies ) {
	$taxonomies[] = 'category';
	return $taxonomies;
}
add_filter( 'hb_accommodation_taxonomies', 'categories_for_accommodation' );

Merci de noter que par défaut les posts utilisant un "custom post type" ne sont pas inclus dans les pages d'archives. Afin d'ajouter ces posts (si vous souhaitez par exemple avoir une page pour une catégorie), vous devrez ajouter le code suivant:

function hbook_add_custom_types( $query ) {
	if( (is_category() || is_tag()) && $query->is_archive() && empty( $query->query_vars['suppress_filters'] ) ) {
	$query->set( 'post_type', array(
	'post', 'hb_accommodation'
		));
	}
	return $query;
}
add_filter( 'pre_get_posts', 'hbook_add_custom_types' );

hb_accommodation_has_archive

Ce filtre s'applique au paramètre has_archive qui est passé à la fonction register_post_type utilisée pour créer les posts de Types d'Hébergement.

Paramètres: aucun

Exemple:
Pour désactiver l'archive pour les posts de type d'hébergement:

function hb_disable_archive() {
	return false;
}
add_filter( 'hb_accommodation_has_archive', 'hb_disable_archive' );

hb_accommodation_supports

Ce filtre s'applique au paramètre supports qui est passé à la fonction register_post_type utilisée pour créer les posts de Types d'Hébergement.

Paramètre:

• $supports: (tableau) liste des éléments.

Exemple:
Ajout des "excerpts" pour les posts de type d'hébergement.

function support_for_excerpts( $supports ) {
	$supports[] = 'excerpt';
	return $supports;
}
add_filter( 'hb_accommodation_supports', 'support_for_excerpts' );

hb_search_form_markup

Ce filtre s'applique au balisage HTML du formulaire de recherche.

Paramètres :

• $output: (chaîne de caractères) le code HTML du formulaire.
• $form_id: (chaîne de caractères) l'id du formulaire tel que passé au shortcode [hb_booking_form] grâce au paramètre form_id.

hb_search_form_title

Ce filtre s'applique au titre du formulaire de recherche.

Paramètre:

• $title: (chaîne de caractères) le code HTML du titre du formulaire.

Exemple:

function change_title_tag( $title ) {
	return str_replace( 'h3', 'h2', $title );
}
add_filter( 'hb_search_form_title', 'change_title_tag' );

hb_extra_name

Ce filtre s'applique aux noms de chaque service supplémentaire (les services supplémentaires sont montrés après la selection de l'hébergement).

Paramètre:

$display_name, $option, $price
• $display_name: (chaîne de caractères) nom de l'extra tel qu'il sera affiché
• $extra: (tableau) information concernant l'extra
• $price: (tableau) prix de l'extra

hb_extras_form_markup

Ce filtre s'applique au balisage HTML du formulaire qui affiche les services supplémentaires.

Paramètre:

• $output: (chaîne de caractères) le code HTML du formulaire.

hb_resa_extra_formatting

Ce filtre est appliqué aux noms de chaque service supplémentaire choisi (dans les emails envoyés par HBook).

Paramètre:

• $formatted_extra_name: (chaîne de caractères) le nom formaté du service supplémentaire
• $extra_name: (chaîne de caractères) le nom du service supplémentaire
• $extra_value: (chaîne de caractères) la valeur de l'option choisie
• $option_choice_name: (chaîne de caractères) le nom de l'option choisie

hb_details_form_markup

Ce filtre s'applique au balisage HTML du formulaire de détails client/réservation.

Paramètre:

• $output: (chaîne de caractères) le code HTML du formulaire.

hb_payment_types

Ce filtre peut être utilisé pour modifier l'ordre des méthodes de paiement listée, lorsque vous offrez le choix au client (paiement à l'arrivée, d'un acompte ou de la totalité)

Paramètre:

• $types: (tableau) liste des méthodes de paiement autorisés. L'ordre par défaut est: array( 'offline', 'store_credit_card', 'deposit', 'full' ).

Exemple:
Modification de l'ordre afin que le paiement hors ligne (à l'arrivée par exemple) soit affiché en dernier.

function custom_payment_type_order( $types ) {
	$types = array( 'deposit', 'full', 'store_credit_card', 'offline' );
	return $types;
}
add_filter( 'hb_payment_types', 'custom_payment_type_order' );

hb_stripe_credit_cards_icons

This filter is applied to the set which credit card icons you wish to display in the Stripe payment form.

Paramètre:

• $icons: (array) list of credit card icons. Default value is : array( 'mastercard', 'visa', 'americanexpress' ). Possible values are : 'amazon', 'americanexpress', 'delta', ''diners', discover', 'ebay', ''jcb', maestro', 'mastercard', 'solo', 'visa', 'visaelectron', 'switch'

Exemple:
Display only visa and mastercard icons.

function custom_stripe_payment_icons( $types ) {
	$icons = array( 'visa', 'mastercard' );
	return $icons;
}
add_filter( 'hb_stripe_credit_cards_icons', 'custom_stripe_payment_icons' );

hb_policies_area_markup

This filter is applied to the part of the booking form where customers aknowledge Privacy policy, Terms and conditions.

Paramètre:

• $output: (chaîne de caractères) le code HTML du formulaire.

Exemple:
Add a checkbox to signup to a MailChimp newsletter. This requires MC4WP plugin and custom integration. Please check this article of our knowledgebase.

function add_mailchimp_to_details_form( $output ) {
    $output .= '<h3 class="hb-title hb-title-terms">Our newsletter</h3>';
    $output .= '<p>';
    $output .= '<label>';
    $output .= '<input type="checkbox" name="mc4wp-subscribe" value="1" />';
    $output .= 'Yes! Subscribe me to the your monthly newsletter.</label>';
    $output .= '</p>';
    return $output;
}

add_filter( 'hb_policies_area_markup', 'add_mailchimp_to_details_form' );

hb_invoice_table_style

Ce filtre s'applique aux styles de la facture. Vous trouverez les styles appliqués dans wp-content/plugins/hbook/utils/utils.php. Cherchez la fonction nommée "get_invoice_table".

Paramètres:

• $style: (chaîne de caractères) l'ensemble des styles CSS appliqués.
• $resa: (tableau) l'information de réservation

hb_create_reservation

Cette action est exécutée lorsqu'une nouvelle réservation est ajoutée à la table de réservations de la base de donnée.

Paramètre:

• $resa_info: (tableau) toutes les informations de la nouvelle réservation.

hb_create_customer

Cette action est exécutée lorsqu'un nouveau client est ajouté à la table de clients de la base de donnée.

Paramètre:

• $customer_info: (tableau) toutes les informations du nouveau client.

hb_reservations_updated

Cette action est exécutée lorsque la table de réservation de la base de données est mise à jour.

Paramètres: aucun

hb_blocked_accom_updated

Cette action est exécutée lorsque la table contenant les hébergements bloqués est mise à jour.

Paramètres: aucun

hb_accommodation_list_markup

This hook can be used to modify the display of the accommodation list.

Paramètre:

• $output: (string) that contains the output of the accommodation list markup.

Exemple:
For the accommodation list thumbnail to open the accommodation type post in the same tab.

Ajoutez dans le fichier functions.php de votre thème-enfant:

			function change_target_self( $output ) {
				return str_replace( '_blank', '_self', $output );
			}
			add_filter( 'hb_accommodation_list_markup', 'change_target_self' );
			

hb_resa_manager_capabilities

Ce filtre est appliqué à la liste des capacités de l'utilisateur ayant le rôle "Gestion des réservations".

Paramètre:

• $capabilities: (array) contient la liste des différentes "capabilities".

Exemple:
Si votre thème redirige automatiquement tout utilisateur avec la capacité "read" vers le front-end, vous pouvez ajouter des capacités qui sont celles des roles "Contributor" ou "Author". Pour consulter l'ensemble des capacités et roles WordPress. se référer à https://codex.wordpress.org/Roles_and_Capabilities

	function hb_add_capabiliites_to_manager( $capabilities ) {
		$added_capabilities = array( 'edit_posts', 'delete_pots' );
		$capabilities = array_merge( $added_capabilities, $capabilities );
		return $capabilities;
	}
	add_filter( 'hb_resa_manager_capabilities', 'hb_add_capabiliites_to_manager' );
	

hb_email_actions

Ce filtre est appliqué à l'ensemble des actions que vous pouvez voir dans la colonne "Actions " du menu HBook > Emails.

Paramètre:

• $actions: (tableau) contient les différentes actions avec: une clé (chaine de caractères) => valeur (chaine de caractères). Les clés à utiliser sont 'action_value' et 'action_text'.

Exemple:

function add_action_to_email_actions( $actions ) {
	$actions[] = array(
		'action_value' => 'resa_marked_paid',
		'action_text' => esc_html__( 'Reservation marked as paid', 'hbook-admin' ),
	);
	return $actions;
}
add_filter( 'hb_email_actions', 'add_action_to_email_actions' );

Puis dans la fonction public function hb_update_resa_paid() que vous trouverez dans le répertoire hbook/admin-pages/admin-ajax-actions.php, vous ajouterez:

$this->utils->send_email( 'resa_marked_paid', $_POST['resa_id'] );

Cette fonction deviendra donc:

public function hb_update_resa_paid() {
	if ( $this->hb_verify_nonce() && $this->hb_user_can_manage_resa() ) {
		if ( $this->hbdb->update_resa_paid( $_POST['resa_id'], $_POST['resa_price'], $_POST['resa_paid'] ) !== false ) {
			echo( 'paid updated' );
			$this->utils->send_email( 'resa_marked_paid', $_POST['resa_id'] );
		} else {
			echo( 'Database error.' );
		}
	}
	die;
}

hb_scheduled_min_hour

Automatics emails are triggered, by default, between 7am and 11pm (timezone set in WordPress Settings), as soon there is a visit on your website (admin or front-end).
Default is 7 (7am). Expect a number between 0 and 23.

Paramètres: aucun

Exemple:

function change_minimum_scheduled_hour() {
	return 9;
}
add_filter( 'hb_scheduled_min_hour', 'change_minimum_scheduled_hour' );

hb_scheduled_max_hour

Automatics emails are triggered, by default, between 7am and 11pm (timezone set in WordPress Settings), as soon there is a visit on your website (admin or front-end).
Default is 23 (11pm). Expect a number between 0 and 23.

Paramètres: aucun

Exemple:

function change_maximum_scheduled_hour() {
	return 20;
}
add_filter( 'hb_scheduled_max_hour', 'change_maximum_scheduled_hour' );

hb_language_list

Ce filtre s'applique à la liste des langues gérées par HBook dans le cas d'un site multi-langues.

Paramètre:

• $langs: (tableau) une clé (chaîne de caractères) => valeur (chaîne de caractères) tableau qui contient les informations concernant les différentes langues (la clé est la locale de la langue, la valeur est le nom de la langue).

Exemple:
Si vous utilisez un plugin multi-langue qui n'est pas Polylang ou WPML et pour lequel les langues ne sont pas détectées automatiquement par HBook:

function new_language_list( $langs ) {
	$added_languages = array(
			'fr_FR' => 'French',
			'it_IT' => 'Italian',
			'es_ES' => 'Spanish',
			'de_DE' => 'German'
	);
	$langs = array_merge( $added_languages, $langs );
	return $langs;
}
add_filter( 'hb_language_list', 'new_language_list' );

hb_uncompleted_resa_deletion_delay

Expect a returned value as: (integer + "MINUTE" or "HOUR") the delay before HBook delete a reservation that was not completed and is shown as "Processing" status (the customer closed the tab, left the payment process, etc.). By default, HBook delete these uncompleted resrevation after 1 hour.

Exemple:
Deleting uncompleted reservations after 30 MINUTE.

function custom_uncompleted_resa_deletion_delay( $default_delay ) {
	return '30 MINUTE';
}
add_filter( 'hb_uncompleted_resa_deletion_delay', 'custom_uncompleted_resa_deletion_delay' );

hb_old_resa_logs_deletion_delay

• Expect a returned value as: (integer + "DAY" or "MONTH") the delay of log retention for HBook reservation status changes. These logs are used by ourselves or webdevelopers for debug purposes. By default, HBook delete these logs after 14 days.

Exemple:
Retaining logs for 28 DAY.

function custom_resa_logs_deletion_delay( $default_delay ) {
	return '28 DAY';
}
add_filter( 'hb_old_resa_logs_deletion_delay', 'custom_resa_logs_deletion_delay' );

hb_retina_scale_factor

Paramètre:

• $retina_scale_factor: (entier) le facteur d'échelle appliqué aux images affichées par HBook (par défaut, l'échelle est de 1).

Exemple:
Afficher les images pour les appareils supportant le retina x 3.

function custom_retina_scale_factor( $retina_scale_factor ) {
	return 3;
}
add_filter( 'hb_retina_scale_factor', 'custom_retina_scale_factor' );

hb_image_sizes

Paramètre:

• $sizes: (tableau) une clé (chaîne de caractères) => valeur (chaîne de caractères) tableau contenant les différentes tailles, chaque taille ayant les clés "width" et "height" Ceci pourrait être utile si vous avez choisi dans HBook > Misc > Misc que vous utilisiez un redimensionnemnt des images "Statique". Lorsque vous choisissez "Statique", HBook n'utilise pas AquaResizer.

hb_ical_additional_info

Paramètre:

• $default_comment_data: (array) an array of values that will be looked for in the DESCRIPTION field of the ical content of an external calendar. When found, HBook will show the value of this field in the column "Comments" for the reservation.

---

 

Fonctions JavaScript

hbook_show_accom_list

Le plugin HBook essaie d'appeler cette fonction chaque fois que la liste des types d'hébergement disponible est montrée.

Exemple:
Lancer une fonction JavaScript après que la liste des types d'hébergement disponible a été affichée.

Ajoutez dans le fichier functions.php de votre thème-enfant:

add_action( 'wp_enqueue_scripts', 'enqueue_my_js_scripts' );

function enqueue_my_js_scripts() {
	wp_enqueue_script( 'my-script', get_stylesheet_directory_uri() . '/my-script.js', array(), null, true );
}

et dans le répertoire du thème-enfant, créez un fichier my-script.js file qui contiendra:

function hbook_show_accom_list() {
	my_js_function();
}

hbook_reservation_done

HBook essaie d'appeler cette fonction chaque fois qu'une réservation est complétée avec succès par un client.

Exemple:
Lancer une fonction JavaScript après qu'une réservation a été reçue. Ceci peut être utilisé par exemple si vous avez un code de conversion de Google Analytics, un snippet de Adwords...

Ajoutez dans le fichier functions.php de votre thème-enfant:

add_action( 'wp_enqueue_scripts', 'enqueue_my_js_scripts' );

function enqueue_my_js_scripts() {
	wp_enqueue_script( 'my-script', get_stylesheet_directory_uri() . '/my-script.js', array(), null, true );
}

et dans le répertoire du thème-enfant, créez un fichier my-script.js file qui contiendra:

function hbook_reservation_done() {
	my_js_function();
}

FAQ

Trouvez une réponse immédiate aux questions fréquemment posées dans notre base de connaissance