=== Plugin Hostify Booking Engine === Balise stable : 1.9 Contributeurs : hostify Nécessite au moins : 5,5 Testé jusqu’à : 6,6 Nécessite PHP : 7.4 Licence : Propriétaire URI de licence : license.txt Domaine du texte : hostifybooking Tags : hostify, réservation, gestion immobilière, pms, réservations, moteur de réservation, site de réservation, airbnb, booking.com, expedia, homeaway, agoda, tripadvisor == Description == Obtenez votre propre site de réservation gratuitement ! Commencez à convertir les réservations directes et à fidéliser votre clientèle. [Hostify.com](https://hostify.com) Créez votre propre site de réservation à l’aide de l’API du moteur de réservation Hostify. # Veuillez lire avant de mettre à jour ! Nous sommes ravis d’annoncer une nouvelle version de notre plugin qui apporte des améliorations et des changements significatifs. Cependant, cette mise à jour comprend plusieurs changements cassants qui nécessitent une attention particulière avant la mise à niveau. ## Informations critiques sur la mise à jour IMPORTANT : Il s’agit d’une mise à jour majeure qui introduit des changements cassants. Nous vous recommandons vivement de tester cette mise à jour sur un environnement intermédiaire avant de l’appliquer à votre site de production. ##Recommended Processus de mise à jour 1) Sauvegarde : Créez une sauvegarde complète de votre site web 2) Étape : Créer un environnement de mise en scène 3) Test : Installez la mise à jour sur votre site de staging 4) Vérifier : Testez minutieusement toutes les fonctionnalités du plugin 5) Examen : Vérifiez s’il y a des conflits avec d’autres plugins ou thèmes 6) Planifier : Planifiez la mise à jour de la production pendant les heures de faible trafic 7) Mise à jour : Ne procédez à la mise à jour de la production qu’après des tests de mise en scène réussis == Exigences == ⚠️ NOTE: ` Le plugin ne fonctionne pas correctement sur la plate-forme wordpress.com, vous devez donc utiliser un autre hébergement WP à la place. Nous kinsta.com recommandons pour un démarrage facile. ` Version de PHP : 7.4+, 8+ Extensions PHP : curl, json, mbstring. Le site web de production doit fonctionner via HTTPS. Vous devez savoir comment travailler avec des pages et des articles dans WordPress : → [Publication vs. Page](https://wordpress.com/support/post-vs-page/) → [Quelle est la différence entre les articles et les pages dans WordPress](https://www.wpbeginner.com/beginners-guide/what-is-the-difference-between-posts-vs-pages-in-wordpress/) → [Pages WordPress vs articles : quelle est la différence ?](https://ithemes.com/blog/wordpress-pages-vs-posts-whats-the-difference/) Vous devez savoir ce que sont les codes courts : → [Shortcodes dans WordPress](https://codex.wordpress.org/Shortcode) == Installation == 1. Décompressez le fichier zip et téléchargez le dossier « hostify-booking » extrait dans « /wp-content/plugins/ ». Ou vous pouvez utiliser l’installateur de plugins WordPress : Plugins → Add New → Upload Plugin, choisissez le fichier zip et appuyez sur le bouton « Installer maintenant ». 2. Activez le plugin via le menu « Plugins » 3. Configurez d’abord la configuration du site Web dans Hostify PMS (« Applications » → « WordPress ») : 3.1. Cliquez sur « Créer un nouveau site Web » et tapez un nouveau pseudo de configuration, par exemple « mon nouveau site Web » et enregistrez-le 3.2. Maintenant que vous êtes dans les paramètres du site Web, activez l’interrupteur en haut pour passer au mode « ON » en premier 3.3. Sur la page « Général », onglet « Connexion », vous pouvez trouver deux champs grisés : URL de l’API API WPKEY Veuillez copier leur contenu, ces informations que vous utiliserez ultérieurement. 3.4. Remplissez l’adresse du site web dans le champ « Domaine », (ex : https://mysite.com) 3.5. Dans l’onglet « Général"/"Principal », sélectionnez au moins une ville 3.6. Dans l’onglet « Général"/"Paiement/Prix », remplissez l'"E-mail de demandes directes » et réglez le reste des paramètres de paiement, cliquez sur le bouton « Enregistrer » 3.7. Ouvrez l’onglet « Annonces » et sélectionnez les annonces qui seront disponibles sur le site Web, cliquez sur « Enregistrer » 4. Retournez maintenant à l’administrateur WP de votre nouveau site Web et consultez « Paramètres » → « Hostify Booking Plugin » 4.1. Onglet « Paramètres API » : 4.1.1. Remplissez les champs URL de l’API et WPKEY de l’API en utilisant les données copiées précédemment Par exemple, cela peut ressembler à ceci : URL de l’API : https://pmsapi.hostify.com/ API WPKEY : x1NSd0xN6RzdcmFVWwYzRictMyLThwegHGRj= 4.1.2. Appuyez sur le bouton « Enregistrer les paramètres » 4.2. Onglet « Sélectionner les pages » : 4.2.1. Cliquez sur ces liens dans l’ordre : - Créer une page de résultats de recherche - Créer une page d’annonce unique - Créer une page de paiement - Créer une page de facturation Cela créera les pages nécessaires avec les codes courts nécessaires. 4.2.2. Plus tard, vous pouvez modifier l’une de ces sélections, vous êtes libre d’utiliser n’importe quelle page de votre site. 4.3. Dans l’onglet « Shortcodes », vous pouvez voir tous les shortcodes disponibles dans le plugin. 4.3.1. Sur la page où vous souhaitez afficher la liste de toutes les annonces disponibles, Placez le shortcode [hfy_listings] (s’il n’est pas ajouté automatiquement à l’étape 4.2.1) 4.3.2. Placez le shortcode [hfy_listing] sur la page « Annonce » (s’il n’est pas ajouté automatiquement à l’étape 4.2.1) 4.3.3. Placez le shortcode [hfy_payment] sur la page « Paiement » (s’il n’est pas ajouté automatiquement à l’étape 4.2.1) 4.3.4. Placez le shortcode [hfy_payment_charge] sur la page « Résultat du paiement » (s’il n’est pas ajouté automatiquement à l’étape 4.2.1) 4.3.5. N’importe lequel des shortcodes que vous pouvez placer sur n’importe quelle page, article ou widget où vous le souhaitez 5. Si tout est configuré correctement, vous pouvez ouvrir la page Annonces et voir la liste de vos propriétés sur votre site Web WP. == Espace invités == Si vous utilisez la possibilité d’inscrire/connecter des utilisateurs sur votre site (plugins comme Ultimate Member, ProfilePress, BuddyPress, S2Member, WP User Manager, bbPress, etc), le plugin Hostify permet d’ajouter quelques fonctions pour les utilisateurs enregistrés : - Substitution automatique des noms et des données personnelles de l’utilisateur dans le formulaire de paiement/demande - L’utilisateur peut voir une liste de ses réservations : à venir, en cours et passées - L’utilisateur peut ajouter des annonces à sa propre liste de souhaits - l’utilisateur peut annuler la réservation à venir (TODO) Nouveaux shortcodes ajoutés : [hfy_user_bookings_list type=""] [hfy_user_booking_manage] [hfy_user_wishlist] Veuillez lire la documentation pour un guide rapide. == Liste de tous les shortcodes disponibles == Liste des shortcodes que ce plugin fournit : Afficher le résultat de la recherche : [hfy_listings] [hfy_listings_map] [hfy_listings_map_toggle] [hfy_listings_selected] [hfy_top_listings] [hfy_recent_listings] Formulaire de recherche : [hfy_booking_search] [hfy_booking_search_popup] Une annonce distincte : [hfy_listing] Page de paiement : [hfy_payment] Options de paiement et extras : Bloc d’extras prédéfini : [hfy_payment_extras_set id=' ' ids='' detailed='' selected=''] ... texte personnalisé ... [/hfy_payment_extras_set] Bloc d’options avec cases à cocher : [hfy_payment_extras_optional id=' ' sauf='54,56,57' checked=''] Page de résultat du paiement (NetPay) : [hfy_payment_charge] Parties d’une seule annonce : [hfy_listing_info] [hfy_listing_title] [hfy_listing_room_type] [hfy_listing_facilities] [hfy_listing_gallery] [hfy_listing_image] [hfy_listing_amenities] [hfy_listing_booking_form] [hfy_listing_map] [hfy_listing_availability] [hfy_listing_reviews_count] [hfy_listing_reviews_summary] [hfy_listing_reviews_comments] [hfy_listing_virtual_tour] Sous l’ordre du jour de [hfy_listing_info] : [hfy_listing_info_summary] [hfy_listing_info_space] [hfy_listing_info_guest_access] [hfy_listing_info_interaction] [hfy_listing_info_notes] [hfy_listing_info_transit] [hfy_listing_info_neighbourhood] [hfy_listing_info_house_rules] [hfy_listing_info_prices] [hfy_listing_info_permit] Affichez la valeur de n’importe quel champ accessible à partir de l’objet Listing : [hfy_listing_field] Affichez la valeur de n’importe quel champ accessible à partir de l’objet Détails de l’annonce : [hfy_listing_details_field] == Paramètres des codes courts == [hfy_listings] villes=" » obtenir des annonces par ID de ville Ex : [hfy_listings cities="1,2"] - affichera les annonces par villes 1 et 2 tags=" » Obtenir des annonces par tags Ex : [hfy_listings tags="tag1,tag2"] sort=" » 0 - Aucun tri (par défaut) 1 - Trier par prix d’annonce, ordre décroissant (du plus élevé au plus bas) 2 - Trier par prix d’annonce, ordre croissant (du plus bas au plus haut) 3 - Trier par titre d’annonce 4 - Trier par pseudo d’annonce Ex : [hfy_listings sort="1"] Le paramètre de tri peut être passé dans le paramètre URL (...&sort=) ids=" » afficher une ou plusieurs annonces par leur(s) identifiant(s) Ex : [hfy_listings ids="1000,1050"] Remarque : Par défaut, le résultat est trié en fonction de l’ordre des ID passés. Si l’option « trier » est ajoutée, le tri du résultat correspondra à l’option spécifiée, par exemple : [hfy_listings ids="1050,1000 » sort="2"] - le résultat sera trié par prix, et non par ordre d’ID. with_amenities=" » false - sans commodités (par défaut) vrai - avec commodités Ex : [hfy_listings amenities="true"] [hfy_listings_map] ville=" » villes=" » obtenir des annonces par ID de ville Ex : [hfy_listings_map cities="1,2"] - affichera les annonces par villes 1 et 2 ids=" » afficher les annonces sur la carte par ID d’annonce Ex : [hfy_listings_map ids="1000,1050"] Remarque : si vous utilisez l’attribut « ids » pour [hfy_listings], utilisez-le ici aussi. closebutton=" » Afficher le bouton pour fermer la carte La valeur par défaut est « false » Ex : [hfy_listings_map closebutton="true"] tags=" » Obtenir des annonces par tags Ex : [hfy_listings_map tags="tag1,tag2"] [hfy_listing] [hfy_listing_info] [hfy_listing_info_summary] [hfy_listing_info_space] [hfy_listing_info_guest_access] [hfy_listing_info_interaction] [hfy_listing_info_notes] [hfy_listing_info_transit] [hfy_listing_info_neighbourhood] [hfy_listing_info_house_rules] id=" » peut être passé pour obtenir le résultat d’une liste par ID spécifiée, ex : [hfy_listing id="1234"] Si le paramètre id n’est pas spécifié, le code de liste sera extrait de l’URL, EX : https://site.com/listing/?id=1234 [hfy_listings_selected] villes=" » obtenir des annonces par ID de ville Ex : [hfy_listings_selected cities="1,2 » max="4"] - affichera les annonces par villes 1 et 2 paramcity="vrai » get by city ID donné dans le paramètre url (...&city_id=) Ex : [hfy_listings_selected paramcity="true"] - affichera les listes par paramètre dans l’url currentlistingcity="vrai » get by same city, à laquelle était liée la liste spécifiée dans le paramètre url (...&id=) Ex : [hfy_listings_selected currentlistingcity="true"] max=" » Limitez la sortie. La valeur par défaut est 4. Si « 0 » est passé, tous les éléments seront affichés, sans limite. Ex : [hfy_listings_selected villes="1,2,3,4 » max="8"] [hfy_top_listings] max=" » Limitez la sortie. La valeur par défaut est 4. Si « 0 » est passé, tous les éléments seront affichés, sans limite. Ex : [hfy_top_listings max="8"] [hfy_listing_reviews_comments] max=" » Limitez la sortie. La valeur par défaut est 3. Si « 0 » est passé, tous les éléments seront affichés, sans limite. Ex : [hfy_listing_reviews_comments max="8"] layout=" » Mode d’affichage de la liste des avis. layout="vertical » (par défaut) layout="horizontal » Ex : [hfy_listing_reviews_comments layout="horizontal"] [hfy_listing_reviews_summary] id=" » Obtenir les informations récapitulatives des avis pour une annonce spécifiée par ID ex : [hfy_listing_reviews_summary id="1234"] Si le paramètre id n’est pas spécifié, le code de l’annonce sera extrait de l’URL [hfy_listing_reviews_count] id=" » Obtenir le nombre d’avis pour une annonce spécifiée par ID ex : [hfy_listing_reviews_count id="1234"] Si le paramètre id n’est pas spécifié, le code de l’annonce sera extrait de l’URL [hfy_booking_search] advanced="vrai » Affichez des champs supplémentaires dans le formulaire de recherche pour la recherche avancée. Ex : [hfy_booking_search advanced="true"] tagsmenu=" » Remplacer les emplacements par les balises passées. Ex : [hfy_booking_search tagsmenu="tag1,tag2"] samepage=" » Soumettez le formulaire de recherche sur la même page au lieu de celle sélectionnée dans les paramètres du plugin (« Sélectionner des pages » → « Page Annonces »). Ex : [hfy_booking_search samepage="true"] [hfy_listing_virtual_tour] id=" » Affichage de la visite virtuelle d’une annonce par ID spécifiée ex : [hfy_listing_virtual_tour id="1234"] Si le paramètre id n’est pas spécifié, le code de l’annonce sera extrait de l’URL [hfy_listing_field] id=" » ID de l’annonce ex : [hfy_listing_field id="1234"] Si le paramètre id n’est pas spécifié, le code de l’annonce sera extrait de l’URL name=" » Nom du champ dans l’objet $listing->listing ex : [hfy_listing_field nom="rue"] La liste complète des champs peut être vue, par exemple, dans le modèle de liste remplacé, videz l’objet : php var_dump($listing- cotation) ; ?> [hfy_listing_details_field id=" » name=""] id=" » ID de l’annonce ex : [hfy_listing_details_field id="1234"] Si le paramètre id n’est pas spécifié, le code de l’annonce sera extrait de l’URL name=" » Nom du champ dans $listingDetails objet ex : [hfy_listing_details_field nom="person_capacity"] La liste complète des champs peut être vue, par exemple, dans le modèle de liste remplacé, videz l’objet : php var_dump($listingDetails) ; ? Paramètres communs à tous les shortcodes : nowrap="1 » Désactive le rendu du code d’habillage pour les shortodes :
][elapsed/time_elapsed/request_elapsed (s)] url \n paramètres post \n info d’erreur curl Vous pouvez également ajouter ces constantes pour afficher des informations étendues : define('HFY_API_LOG_DETAILED', true) ; en-têtes et réponse de log curl define('HFY_API_LOG_TRACE', true) ; Enregistrer wp_debug_backtrace = Les dates sélectionnées n’apparaissent pas après la sélection dans le formulaire de réservation = Vérifiez que le code court [hfy_listing_booking_form] n’est utilisé qu’une seule fois sur la page. = SEO ? = Le plugin inclut la prise en charge des plugins Yoast SEO et Rank Math : meta, URL, plan de site XML pour les annonces. Consultez les paramètres du plugin → SEO. = Je ne reçois aucun email du site = Il s’agit d’un problème d’un serveur ou d’un site spécifique. Cela ne s’applique pas au fonctionnement de ce plugin. Vérifiez si les paramètres de messagerie sont corrects sur le site/serveur, ou contactez le serveur et l’assistance du site. == Avis de mise à niveau == Depuis la version 1.9.0, le plugin prend en charge la vérification des mises à jour et donne la possibilité de mettre à jour simplement en un clic. = Étapes de mise à jour manuelle : = 1. Plugins → Ajouter un nouveau → Upload PLugin → le bouton « Remplacer le courant par le téléchargé ». 2. Ouvrez la page des paramètres : Paramètres → moteur de réservation Hostify, vérifiez les options et appuyez sur le bouton « Enregistrer les paramètres ». 3. Cliquez sur le bouton « Vider le cache ». = Après la mise à jour = Si vous avez des modèles de plugin Hostify redéfinis dans votre thème, comparez les modifications et corrigez/mettez à jour votre code si nécessaire. == Journal des modifications == Voir CHANGELOG.md