FAQ Q173: J'ai besoin d'avoir plus de contrôle sur la prévisualisation du calendrier.

Vous pouvez obtenir le code HTML pour la prévisualisation du calendrier (à intégrer sur votre site web) dans les paramètres / intégrer avec mon site / widgets / prévisualisation du calendrier. Presque toutes les options peuvent être définies à l'aide de ce constructeur.

Seulement si les options standard ne sont pas suffisantes, veuillez continuer à lire ce document pour découvrir toutes les options que vous pouvez utiliser en changeant les paramètres URL de l'IFRAME du calendrier ou vous pouvez aussi simplement changer les valeurs par défaut globales pour tous les aperçus de calendrier utilisés pour votre site planyo dans Paramètres / Editeur de style CSS. Voici les paramètres qui peuvent être ajoutés ou modifiés :

style=XXX - ce paramètre est toujours ajouté automatiquement pour déterminer le style de prévisualisation du calendrier. Certains styles nécessitent certains paramètres, il est donc préférable de choisir le style dans l'interface utilisateur de Planyo, puis d'ajouter les paramètres optionnels énumérés ci-dessous. Vous pouvez choisir l'un des styles suivants :

default - le style dépendra des autres paramètres et de vos types de ressources. Ce sera toujours l'un des autres styles énumérés ci-dessous,
standard - prévisualisation du calendrier horizontal (large) standard,
variable-width - prévisualisation du calendrier à largeur variable (même chose que ci-dessus mais vous permet de définir le nombre de jours visibles),
multi-month-responsive - petit aperçu mensuel, le nombre de mois dépend de l'espace horizontal disponible,
multi-month - petit aperçu mensuel, vous pouvez déterminer le nombre de mois affichés à la fois,
week-grid - grille horaire (large),
week-grid-2 - grille horaire (étroite),
upcoming-av - calendrier des disponibilités à venir,
big - big calendar view, fonctionne particulièrement bien pour les ressources de type événement, il liste les ressources qui peuvent être louées à une date ou une heure donnée, y compris la quantité disponible.

resource_id=XXX - définit l'ID de la ressource unique à afficher.

days - si vous utilisez la prévisualisation du calendrier à largeur variable ou le style de grille de planification horaire, choisissez le nombre de jours qui seront affichés dans la prévisualisation.

month-count - pour le style de calendrier de prévisualisation des petits mois, choisissez combien de mois seront affichés.

nox=1 - pour le style de calendrier de prévisualisation des petits mois, ceci utilisera des couleurs au lieu de X rouge pour marquer les jours indisponibles.

fullh=1 - pour les heures de 24 heures à certains endroits, par défaut, vous verrez l'heure suivie de h, par exemple 10h. Avec le paramètre fullh=1, celui-ci sera remplacé par l'heure complète 10:00. Si vous réglez ce paramètre sur fullh=force, alors les heures ne seront jamais séparées des minutes (par défaut, elles peuvent être séparées en 2 lignes), ce qui élargit les colonnes.

custom-language=DE - définit la langue de l'aperçu du calendrier (si différente de la langue par défaut) -- la langue est sous la forme du code ISO à deux lettres (EN, DE, FR, ES, IT, etc.). feuille de style - URL de la feuille de style CSS à utiliser pour contrôler entièrement la conception du calendrier (couleurs, polices, etc.). Ce paramètre n'est laissé que pour des raisons de rétrocompatibilité. Vous devriez normalement éditer le CSS de base ici.

background=XXX - vous pouvez définir ici la couleur/image d'arrière-plan du calendrier.

resfilter=X,Y,Z - vous pouvez décider quelles ressources seront affichées (seulement dans le style horizontal) - voir plus ici.

propfilter_name=X&propfilter_value=Y - en utilisant cette paire de paramètres, vous pouvez filtrer vos ressources par la propriété personnalisée X -- seules les ressources dont la valeur de propriété est Y seront listées - voir plus ici. Ce filtre de ressources ne peut pas être combiné avec les autres.

prop_res_xxx=yyyyy - Un sélecteur de ressources alternatives à propfilter_name, propfilter_value (basé sur des valeurs d'avoirs miniers personnalisés) mais ce format vous permet d'appliquer plusieurs filtres d'avoirs miniers, par exemple prop_res_abc=1&prop_res_res_def=2 appliquerait à la fois les filtres abc et def). Voir Q205 pour la liste des propriétés de ressources personnalisées disponibles pour votre site planyo.

res_type_filter=event, res_type_filter_filter=non-événement - vous pouvez utiliser l'un de ces paramètres afin de n'afficher que les ressources qui sont de type événementiel ou non. Ce filtre ne peut pas être combiné avec les autres.

sort=prop_res_xxx - vous pouvez changer le critère de tri par défaut des ressources à l'une de vos propriétés de ressources personnalisées. Vous devez utiliser toutes les lettres minuscules, les espaces doivent être remplacés par des tirets et avec le préfixe prop_res_res_, par exemple pour la propriété "Number of persons", ceci doit être &sort=prop_res_number_of_persons.

default_view=day - utilisez-le avec le calendrier horizontal pour définir la vue par défaut au jour ; default_view=month définira la vue par défaut à l'affichage du mois ; dans le cas d'un grand style de calendrier, vous pouvez aussi utiliser default_view=week.

no_switching=1 - lorsqu'il est défini, l'utilisateur ne pourra pas basculer entre les vues jour/mois (ou jour/semaine/mois dans le cas du grand style de calendrier) ; ceci n'est utilisé qu'avec les styles de calendrier qui supportent ce choix.

show_count=1 - ceci affichera toujours la quantité disponible sous la forme d'un nombre (dans le mode standard, il faut survoler un carré pour voir la quantité disponible).

readonly=1 - ceci supprimera tous les liens vers le formulaire de réservation de l'aperçu du calendrier (cliquer sur les emplacements disponibles n'aura aucun effet). reset_cookie_date_date=1 - utilisez ce paramètre pour toujours réinitialiser la vue au mois courant

no_range=1 - utilisez ce paramètre pour les ressources basées sur les heures lorsque vous avez des temps de démarrage limités. Dans l'aperçu de disponibilité à venir, ce paramètre n'affichera que les heures de début possibles au lieu des plages horaires dans le cas de l'aperçu de disponibilité à venir (par exemple 4pm, 5pm, 6pm au lieu de 4pm-7pm). Dans le cas d'autres prévisualisations, toutes les heures qui ne sont pas des heures de début seront invisibles dans la mesure du possible (ou bien marquées comme non disponibles).

visible_items_per_column=X - pour l'aperçu du calendrier des disponibilités à venir, ceci définit le nombre maximum d'éléments par colonne (jour ou mois) listés directement, sans qu'il soit nécessaire de faire défiler la page suivante. Par défaut, cette valeur est fixée à 5.

set_date=YYYYYYY-MM-DD - vous pouvez définir le jour/mois qui sera affiché par défaut dans l'aperçu (normalement c'est le jour en cours ou la date de navigation précédemment enregistrée sur le navigateur de l'utilisateur sous forme de cookie). Veuillez noter que vous pouvez également saisir des valeurs textuelles comme aujourd'hui ou demain ou mercredi prochain (avec l'espace codé en %20 ou +, ex. set_date=Next+Wednesday) ou d'autres valeurs similaires (en utilisant next/previous/this/last suivi des jours de semaine, mois, etc.).

find_first_av=1 - définissez cette option si vous voulez que l'aperçu du calendrier aille à la première date disponible par défaut (ne pas utiliser avec set_date).

morning_icons=1 - ajoute une ligne de division diagonale aux jours où un autre client quitte le matin ou s'enregistre le soir ; ceci ne peut être utilisé que pour l'hébergement (lorsque le client réserve des nuits et non des jours) et avec des styles de calendrier standard, à largeur variable et multi-mois.

max_resources=xxx - au cas où vous avez plus de 30 ressources, elles seront paginées par défaut. Vous pouvez augmenter / diminuer le nombre de ressources par page en modifiant ce paramètre. La valeur autorisée (utilisée à la place de xxx) est de l'ordre de (5..100) separate-units=1 - dans le cas où vous avez plusieurs unités d'une ressource, elles seront listées dans des lignes séparées (dans les types de calendrier standard et à largeur variable).

no_start_time_time_check=1 - dans le cas où vous avez des jours de semaine d'arrivée spécifiques (ou, pour les ressources horaires, des heures de début spécifiques), ils seront par défaut marqués en jaune et seuls ces jours seront cliquables. Vous pouvez désactiver cette fonction à l'aide de ce paramètre. ignore_events=1 - si elle est définie, les ressources de type événement seront affichées comme les ressources normales, ce qui signifie que la disponibilité sera affichée pour toutes les dates (et pas seulement les dates de début, comme c'est le cas par défaut).

no_extra_info_info=1 - si vous utilisez ce paramètre avec la prévisualisation horizontale du calendrier, la disponibilité partielle sera affichée de la même manière que la disponibilité totale (sans information sur le nombre d'unités disponibles) et les périodes réservées et indisponibles seront affichées de la même manière ; si vous combinez ce paramètre avec no_start_time_check=1, la prévisualisation du calendrier n'affichera que deux états : disponible ou indisponible. Veuillez noter que cette option n'est définie par défaut que dans le cas du type de calendrier'Aperçu des petits mois'. Pour l'éteindre (pour afficher la différence entre indisponible et réservé), utilisez : no_extra_info_extra_info=0.

show_prep_time=1 - cette option marquera également le temps de préparation requis comme non disponible. Cela montrera clairement à vos clients que les heures/jours de préparation sont également indisponibles. Le temps de préparation est défini dans les paramètres des ressources (temps min. entre deux locations consécutives).

feedback_url - si vous utilisez une intégration avancée, le feedback_url détermine l'URL où le plugin/module planyo est intégré sur votre site web. En cliquant sur l'aperçu du calendrier, le formulaire de réservation s'ouvre sur votre site web au lieu du formulaire par défaut (lorsque ce paramètre est manquant) qui ouvre le formulaire de réservation sur planyo.fr.

calclass - si elle est définie, l'élément div de niveau supérieur dans le calendrier iframe inclura ce nom de classe. Cela vous permet de styliser le calendrier différemment en fonction de son emplacement.

desktop=1 - utilisez ce paramètre si vous ne voulez pas que planyo détecte les appareils mobiles et passez l'aperçu à une version compatible mobile (c'est fait par défaut).

force-style=1 - utilisez ce paramètre pour forcer le type de calendrier désiré même s'il n'est pas compatible avec le type de ressource (en fonction du jour ou de l'heure).

min_hour=X, max_hour=Y - pour les ressources horaires, la prévisualisation du calendrier calcule automatiquement les heures min. et max. à afficher dans la prévisualisation en fonction de vos paramètres de ressources. Il est possible de l'écraser avec ces paramètres, par exemple min_hour=8&max_hour=14 affichera les temps de 8:00 à 14:00.

Si vous souhaitez personnaliser l'aperçu du calendrier affiché non pas comme un widget séparé mais comme une partie d'un modèle (par exemple dans le formulaire de réservation ou les vues détaillées des ressources), vous pouvez utiliser la balise personnalisable $(calendar_preview_with_params?xxxx) où xxxx est une liste de paramètres ci-dessus. Si vous le souhaitez, dans Paramètres / intégrer avec mon site Web / widgets, vous pouvez utiliser l'interface de construction de calendrier afin d'obtenir la valeur exacte de la balise correspondant au type de calendrier et aux paramètres choisis. Veuillez noter que dans ce cas, vous pouvez également avoir besoin de contrôler la largeur et la hauteur de prévisualisation du calendrier et vous pouvez donc utiliser les paramètres fixed_width et fixed_width.

Exemple : dans le formulaire de réservation, vous souhaitez afficher l'aperçu du calendrier multimois de 3 mois pour la ressource courante uniquement. Il suffit d'utiliser un tag comme :

$(calendar_preview_with_params?resource_id=$(resource_id)&style=multi-month&month-count=3&morning_icons=1)