Modifier le visuel des PDF de vos parcours

Modifier le visuel des PDF de vos parcours

Pour chaque itinéraire que vous avez créé, il vous est possible de paramétrer et personnaliser la mise en page du PDF qui sera généré et diffusé sur le réseau Cirkwi.
Certaines options sont gratuites, d’autres sont accessibles par la souscription à notre formule PDF Premium.

Choisir votre Template

Deux templates sont mis à votre disposition pour choisir de mettre ou non des photos sur votre itinéraire.

Intégrer votre propre PDF

Vous pouvez très simplement remplacer le PDF généré par votre propre PDF. Dans ce cas là, nous ne stockons pas vos fichiers. Celui-ci doit donc être disponible depuis une URL de téléchargement. Il vous suffit donc de cliquer sur « J’ai mon propre PDF » et compléter le champ « Lien vers votre PDF personnalisé » avec une URL dirigeant vers le téléchargement de votre PDF.

PDF – Premium : Personnalisez votre fiche parcours

Si vous avez souscrit à un abonnement Premium, vous pouvez personnaliser divers éléments de votre PDF :

  • Page de couverture : Vous pouvez ajouter une couverture personnalisée à votre fiche PDF. Treize images thématiques différentes vous sont proposées comme fond pour cette couverture.
  • Personnalisation des couleurs : Vous pouvez personnaliser la couleur générale de la fiche et les couleurs des blocs dans les listes de POI ou d’infos parcours.
  • Modifier les polices : Choisissez la police de caractère des titres et des textes descriptifs.

Certains éléments sont automatiquement personnalisés :

  • Votre logo dans le document
  • Le nom de votre structure sur la couverture
  • L’URL de votre site web sur la page de couverture
Personnalisation premium

Créer un PDF sur mesure

Vous désirez générer des PDF complètement personnalisés contenant vos parcours mais aussi n’importe quel objets touristiques que vous avez créé sur Cirkwi (générer un catalogue contenant vos hébergements partenaires par exemple) ?
Nous vous proposons un service de création de canevas sur mesure. Changer l’organisation des documents, s’adapter entièrement à une charte graphique, ajouter des informations complémentaires,…tout devient possible !
Contactez-nous pour recevoir un devis personnalisé.

Fond de carte du PDF

Si vous avez souscrit à l’abonnement Premium, vous avez la possibilité de choisir le fond de carte de votre PDF.

  • Open Street Map : la version classique et gratuite de la carte du monde.
  • Données IGN : la version améliorée, enrichie et payante de la carte du monde. Retrouvez toutes les informations sur les PDF en cliquant ici.

Comment créer ma clé Google ?

Comment créer ma clé Google ?

Etape 1

Tout d’abord connectez-vous à votre compte Google Cloud Platform et créez un projet : grâce au menu du haut « Sélectionnez un projet ».

Etape 2

Vous devez ensuite activer 3 APIs/services depuis la bibliothèque du tableau de bord :

Etape 3

Créez ensuite un identifiant. Vous avez besoin d’une Clé API : https://console.cloud.google.com/apis/credentials

  • Si vous créez cette clé pour votre widget :
    Vous pouvez ensuite la renseigner dans la partie personnalisation lors de la configuration du widget.
    Si vous le souhaitez, vous pouvez restreindre l’utilisation de votre clé à un site web ou une IP.
  • Si vous créez cette clé pour votre générateur de widgets ou votre application mobile :
    La clé obtenue devra être communiquée à votre contact projet ou à l’adresse support@cirkwi.com pour être activée sur votre compte.
    Attention pour un générateur vous ne devez pas mettre de restriction sur l’IP ou l’url.

Pas le temps ?

Nous vous proposons de créer et configurer la clé pour vous ! Si le forfait d’accompagnement vous intéresse, n’hésitez pas à nous contacter à l’adresse support@cirkwi.com ( à partir de 500€ TTC).

Important

Après un certain seuil d’utilisation mensuel, les services et APIs Google peuvent devenir payants. Les tarifs sont disponibles à cette adresse.

Vous avez la possibilité de maîtriser votre budget en configurant votre compte de facturation Google. Il vous permet de définir un budget limite.

Fonds de carte – Intégrez votre clé Google dans vos widgets

Fonds de carte – Intégrez votre clé Google dans vos widgets

L’affichage de certains fonds de carte nécessite l’intégration d’une clé spécifique (payante ou gratuite selon le fournisseur de fonds de carte et/ou votre consommation) donnant l’autorisation à vos widgets d’accéder aux fonds de cartes via son API.
C’est devenu le cas dans les widgets Cirkwi en ce qui concerne l’accès aux fonds de carte fournis par Google qui, depuis juin 2018, a modifié sa tarification ainsi que les barèmes d’utilisation de leurs APIs gratuites (fonds de cartes, services de recherche et de géolocalisation,…).
Ceci ne concerne que les widgets créés dans le mode avancé, les widgets créés en mode simplifié utilisant depuis toujours les fonds de carte Open Street Map comme fond de carte par défaut.
Le tutoriel ci-dessous, vous explique comment intégrer votre propre clé (Google ) dans votre widget en 3 étapes simples.

Paramétrez en mode avancé

  1. Rendez-vous dans votre générateur de widgets, ouvrez le paramétrage d’un widget en cliquant sur le bouton « Editer ».
Editer un module
  1. Cliquez sur l’onglet »Personnaliser » et ouvrez le volet « Fonds de carte ».
Onglet personnaliser template tourisme
Clé google map modules tourisme
  1. Intégrez votre clé Google dans le champs dédié et cliquez sur OK.
Saisir clé google map modules tourisme
  1. Vous n’avez plus qu’à choisir les fonds de carte que vous désirez afficher.
Choisir fond de carte du modules

Informations complémentaires

  • Pour limiter votre consommation de requête, configurez comme fonds de carte par défaut de votre widget d’autres fonds de carte gratuits que les fonds de carte Google.
  • Si vous n’avez pas encore de clé Google, nous vous expliquons comment souscrire à leurs services sur cette page.
  • Pour en savoir plus sur les nouveaux barèmes Google et connaître les seuils de gratuité, consultez cette page, si vous êtes organisations à but non lucratif vous pouvez bénéficiez d’avantages spécifiques.
  • Tous les outils Google sont dorénavant regroupés dans la Google Cloud Platform au sein de laquelle vous pouvez contrôlez votre consommation, paramétrer un budget permettant le dépassement des quotas ou non.

Obtenir une clé OpenCage pour activer la recherche par lieu sur mes widgets

Obtenir une clé OpenCage pour activer la recherche par lieu sur mes widgets

Comme vous le savez peut-être, les widgets Cirkwi utilisent une fonctionnalité d’auto-complétion pour permettre aux utilisateurs de rechercher les lieux de leur choix.

Vous avez la possibilité de relier cette fonctionnalité à votre une licence OpenCage, et Cirkwi vous fait profiter de 10% de réduction à vie !

Comment en profiter ?

  1. Tout d’abord, inscrivez-vous sur le site d’OpenCage : https://opencagedata.com/
    Lors de votre inscription vous avez accès à la licence gratuite qui limite votre utilisation à 2500 requêtes par jours.
  2. Une fois connecté, rendez-vous sur le tableau de bord OpenCage, dans la partie « Subscription ».
    Opencage subscription
  3. Sélectionnez ensuite la formule qui vous intéresse. Vous pouvez choisir un paiement annuel ou mensuel.
  4. Vous pouvez alors entrer le code de réduction : CIRKWI10
OOpencage find discount code
Opencage add discount code
  1. La réduction apparaît ensuite à l’écran.
Opencage discount applied
  1. Remplissez le formulaire, entrez vos informations de facturation puis validez. Voilà ! Vous pouvez directement utiliser l’API en profitant des avantages de votre souscription! OpenCage vous fera parvenir les factures mensuellement ou annuellement en fonction de votre choix de formule.

Synchronisation de PIVOT vers Cirkwi

Synchronisation de PIVOT vers Cirkwi

Depuis juin 2018, Cirkwi et le CGT se sont associés pour mettre en place un pont entre la base de données PIVOT et celle de Cirkwi. Cette page s’adresse à tous les partenaires du CGT et a pour but d’expliquer comment fonctionne la synchronisation entre les deux bases de données ainsi que les procédures à respecter pour bien utiliser les différents outils. En respectant ces procédures, vous éviterez de perdre du travail de saisie qui n’aurait pas été effectué correctement.

Règles de base de la synchronisation

La synchronisation entre les bases de données Pivot et Cirkwi n’est pas une synchronisation dans les deux sens. Le flux de données est à sens unique, c’est à dire que les données sont envoyées de Pivot vers Cirkwi et non l’inverse.
Les caractéristiques principales à retenir à propos de cette connexion sont :

  1. La base de données PIVOT est la base de données maître, c’est elle qui alimente la base de données Cirkwi et non l’inverse.
  2. Aucune modification effectuée sur les itinéraires ou les POI dans l’outil d’édition Cirkwi n’aura d’impact direct et automatique sur vos données dans PIVOT.
  3. Les modifications effectuées directement dans l’outil d’édition Cirkwi sur des objets issus de PIVOT seront écrasées lors de la synchronisation entre les bases.
  4. Pour mettre à jour des données issues de la base de données PIVOT dans Cirkwi, vous devez les modifier dans PIVOT et non dans Cirkwi (cf schéma).
  5. Cela ne vous empêche pas d’utiliser Cirkwi comme outil d’édition/de création de vos tracés (cf explications ci-après).
  6. Votre fiche de profil publique visible sur notre réseau de promotion (nom, coordonnées, logo, etc.) est uniquement gérée via Cirkwi.com dans la partie « Gérer mon compte ».
  7. Les données synchronisées sont potentiellement diffusées sur Cirkwi.com (et son réseau de diffusion) et sont exploitables dans les différents services proposés par Cirkwi (widgets cartographiques, génération et mise en page automatique de PDF, Applications en marque blanche…).
  8. Dans la partie « Mon administration » de cirkwi.com, vous pouvez aussi consulter les statistiques de diffusion de vos itinéraires et paramétrer vos PDF. L’utilisation et la gestion des widgets de diffusion cartographique se fait dans la rubrique « Modules » de ce site.
Synchronisation BDD PIVOT - Cirkwi

Importez vos données PIVOT dans Cirkwi

Pour envoyer vos données de PIVOT vers Cirkwi, vous devez d’abord vous assurer que votre compte PIVOT a bien été relié à Cirkwi. N’hésitez pas à contacter votre référent PIVOT au CGT pour en savoir plus sur le sujet.
Un tutoriel spécifique vous expliquant comment envoyer vos itinéraires et vos offres dans les outils et le réseau de promotion Cirkwi depuis votre administration PIVOT sera bientôt mis à disposition.

Utilisez Cirkwi pour éditer vos itinéraires

Il vous est toujours possible d’utiliser l’outil de création d’itinéraires Cirkwi pour éditer des traces importées depuis PIVOT ou pour en créer de nouvelles. Cependant, étant donné que la synchronisation ne fonctionne que dans un sens et afin d’éviter que votre travail ne soit perdu lors des synchronisations quotidiennes entre les bases, il est impératif que vous suiviez la méthode décrite ci-dessous.

A. Utilisez Cirkwi pour éditer vos itinéraires

  1. Rendez-vous sur www.Cirkwi.com, identifiez-vous, cliquez sur le menu en haut à gauche et ensuite sur « Créer un circuit ».
  2. Dans la liste des itinéraires importés, cliquez sur le bouton « Modifier » de l’itinéraire dont vous voulez modifier le tracé. Pour en savoir plus sur l’outil d’édition, consultez nos tutos.
  3. Une fois dans le mode édition du parcours, cliquez sur « Tracer et ajouter des étapes » dans la barre d’outil du dessus.
  4. Vous pouvez alors modifier le tracé de votre circuit grâce à notre outil d’édition. Attention ! Seules les modification du tracé seront récupérées (pas celles des infos parcours, ni celles des points d’intérêts), toutes les autres modifications doivent être effectuées dans PIVOT directement.
  5. Enregistrez vos modifications, vous pouvez ensuite cliquer sur « Prévisualiser ». Sur la fiche de consultation, cliquez sur « Télécharger le GPX » pour récupérer le fichier de la trace que vous allez importer directement dans PIVOT en remplacement de la trace éditée.
  6. Attention ! Pour éviter que vos modifications ne soient écrasées dans Cirkwi lors de la synchronisation, il est conseillé de récupérer le fichier GPX de la trace modifiée le jour de la modification.
Synchronisation BDD PIVOT-Cirkwi - Édition de tracés

B. Créer le tracé d’un nouvel itinéraire avec Cirkwi

Vous pouvez utiliser Cirkwi comme outil pour créer vos tracés GPX que vous importerez ensuite dans PIVOT.

  1. Rendez-vous sur www.Cirkwi.com, connectez-vous, cliquez sur le menu en haut à gauche et ensuite sur « Créer un circuit ». Une fois dans le back office (Board), cliquez sur « Créer un Circuit » .
  2. L’outil de création d’itinéraire s’ouvre, cliquez directement sur « Tracer et ajouter des étapes » dans la barre d’outil du dessus. Attention ! Il n’est pas nécessaire de remplir les champs de l’onglet « Rédiger la présentation », ni de créer ou ajouter des POI ou des infos parcours, ces informations ne seront pas récupérées et devront être saisie directement dans PIVOT.
  3. Vous pouvez alors créer l’itinéraire de votre circuit grâce à notre outil d’édition. Pour en savoir plus sur celui-ci consultez nos tutos.
  4. Enregistrez vos modifications et cliquez sur « Prévisualiser ». Sur la fiche de consultation qui s’affiche, cliquez sur « Télécharger le GPX » pour récupérer le fichier de la trace que vous allez importer directement dans PIVOT.
  5. Créez la fiche de votre itinéraire dans PIVOT avec le ficher GPX et propulsé là dans le flux Cirkwi (contactez le CGT pour en savoir plus).
  6. Supprimez l’itinéraire que vous venez de créer dans Cirkwi.
  7. Durant la prochaine synchronisation, votre circuit sera importé dans Cirkwi et diffusé selon les règles définies.

Retirer un circuit de la synchronisation

Les critères déterminant la publication d’une offre Pivot dans le flux Cirkwi sont les suivants :

  • Le filtre ‘Cirkwi’ dans le panneau identification de la fiche
  • Les tags publics dans le panneau Cirkwi de la fiche

Afin de retirer un circuit du flux envoyé à Cirkwi – et donc entrainer sa suppression – il faut décocher le filtre ‘Cirkwi’ dans le panneau identification et décocher les cases (Tags publics : Cirkwi et Réseau cdf) dans le panneau « Cirkwi » du bordereau.

Modifier les informations de mon compte (Nom, email, logo, statut…) sur Cirkwi

Modifier mon compte sur Cirkwi

Pour modifier les informations de votre compte :

  • Connectez-vous à votre compte sur Cirkwi.com dans la partie Circuits & Itinéraires 
  • Dans le menu latéral gauche, allez dans la rubrique « Gérer mon compte »
  • Vous pouvez modifier :
    • email de connexion
    • mot de passe
    • identifiants (nom, prénom, adresse…)
    • statut particulier ou professionnel. Pour s’enregistrer en tant que professionnel, il vous suffit de cocher la case « je suis un professionnel ».
    • visuel ( logo, photo de profil)
    • préférences
    • etc
  • N’oubliez pas d’Enregistrer en bas de page !

Remarque :

  • Les modifications se diffusent en quelques minutes, en fonction du nombre de circuits/POIs dont vous êtes propriétaire
  • Pour éviter tout désagrément, nous vous invitons à vider le cache de votre navigateur avant de visualiser la mise à jour de vos données.

Intégrer un widget sur Joomla

Intégrer un widget sur Joomla

Pour intégrer le widget dans votre site Joomla, c’est très facile ! Voici les étapes à suivre qui vous guideront pas à pas pour l’installation des widgets sur un site Joomla.

  1. Télécharger le fichier .zip du widget « ModulesBOX ».

  2.  Allez dans votre administration Joomla. Installez cette nouvelle extension en vous rendant sur la page « Installer Extensions » à laquelle on accède en cliquant sur Extensions > Gérer > Installation. Puis uploadez le répertoire « Mod_modulesbox.zip ».

  3. Allez dans la gestion de vos modules en cliquant sur Extensions > Modules et activez le module « ModulesBOX » en cliquant sur la petite croix rouge. Puis cliquez sur le titre du widget pour accéder à l’administration du widget.

  4. Dans la colonne de droite, publié le widget et ajoutez lui une position.
  1. Puis, dans le champs « code de configuration » inscrire en remplaçant les valeurs:

    id_utilisateur:xxx;cle:xxx;id_module:xxxx

    Vous trouverez l’id_module et la clé dans le code d’insertion php et l’id_utilisateur dans l’onglet mon profil de la section mon compte en cliquant sur « Afficher mon id utilisateur ».

  1. Dans la partie assignation des menus de l’administration du module, assignez le « Sur toutes les pages ».
  1. Enregistrez.

  2. Intégrez le code ci-dessous dans les pages de contenu où vous souhaitez intégrer votre widget en mettant la valeur de la position du widget sélectionnée plus haut:

    {loadposition nomdelaposition}

  3. Enfin, rechargez la page de votre site où est intégré le widget. Normalement, le widget est affiché.

Intégration dans une page utilisant de la réécriture d’url

Intégration dans une page utilisant de la réécriture d'URL (url rewriting)

Votre site utilise de la réécriture d'URL ?

Il suffit de modifier les paramètres de votre code d’insertion pour que tout fonctionne.

Voici les différentes possibilités que vous trouverez dans ce tuto:

Cas A – Version PHP (recommandé)

1ère solution : une seule url

2ème solution : une url différente pour la recherche et la consultation 

3ème solution : une url différente pour la recherche et la consultation avec des paramètres

4ème solution : une url différente pour la recherche, la consultation de circuits et la consultation de points d’intérêt avec des paramètres

Cas B – Version JavaScript

1ère solution : une seule url

2ème solution : une url différente pour la recherche et la consultation 

3ème solution : une url différente pour la recherche et la consultation avec des paramètres

4ème solution : une url différente pour la recherche, la consultation de circuits et la consultation de points d’intérêt avec des paramètres

Option(s) supplémentaire(s)

Choix du mode de transformation du titre dans l’URL pour la version PHP et JavaScript

Cas A – Version PHP (recommandé)

Comme pour une insertion classique, récupérez depuis l’interface le code d’insertion PHP du type : 
<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

1ère solution : une seule url

1. Ajoutez simplement le paramètre «mb_url_rewrited» au code d’insertion, de cette manière : 

<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_url_rewrited=URL_DE_VOTRE_PAGE&mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

Exemple

<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_url_rewrited=https:://www.mondomaine.com/randonnees&mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

2. Assurez-vous d’avoir correctement paramétré vos configurations de réécriture d’url. Ci-dessous un exemple avec un fichier «.htaccess» dans un cas où le widget à été intégré dans un fichier nommé randonnes.php :

Options +FollowSymlinks
RewriteEngine on

RewriteRule ^randonnees$ randonnees.php? [QSA,L]

Resultat de l'exemple

Pour la page de recherche : 

https://www.mondomaine.com/randonnees 

Pour une fiche de consultation : 

https://www.mondomaine.com/randonnees?mb_page=poi&mb_id=393326&mb_titre=marie-thierry&mbScrollTo=module 

2ème solution : une url différente pour la recherche et la consultation 

1. Ajoutez simplement les paramètre «mb_url_rewrited_search» et «mb_url_rewrited_consultation» au code d’insertion, de cette manière :

<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_url_rewrited_search=URL_DE_VOTRE_PAGE_DE_RECHERCHE&mb_url_rewrited_consultation=URL_DE_VOTRE_PAGE_DE_CONSULTATION&mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

Exemple

<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_url_rewrited_search=https:://www.mondomaine.com/recherche&mb_url_rewrited_consultation=https:://www.mondomaine.com/randonnees&mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

2. Assurez-vous d’avoir correctement paramétré vos configurations de réécriture d’url. Ci-dessous un exemple avec un fichier «.htaccess» dans un cas où le widget à été intégré dans un fichier nommé randonnes.php :

Options +FollowSymlinks
RewriteEngine on

RewriteRule ^randonnees$ randonnees.php? [QSA,L]
RewriteRule ^recherche$ randonnees.php? [QSA,L]

Resultat de l'exemple

Pour la page de recherche : 

https://www.mondomaine.com/recherche

Pour une fiche de consultation : 

https://www.mondomaine.com/randonnees?mb_page=poi&mb_id=393326&mb_titre=marie-thierry&mbScrollTo=module 

3ème solution : une url différente pour la recherche et la consultation avec des paramètres

1. Ajoutez simplement les paramètre «mb_url_rewrited_search» et «mb_url_rewrited_consultation» au code d’insertion, de cette manière :

<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_url_rewrited_search=URL_DE_VOTRE_PAGE_DE_RECHERCHE&mb_url_rewrited_consultation=URL_DE_VOTRE_PAGE_DE_CONSULTATION&mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

2. Ajoutez également les paramètre ID ET SLUG* ET TYPE entourés de % à votre url dans «mb_url_rewrited_consultation» de cette manière :

*Le slug est une phrase formatée de façon à ce qu’elle s’affiche correctement dans une URL, exemple : https://www.mondomaine.com/voici-un-slug-formaté

<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_url_rewrited_search=URL_DE_VOTRE_PAGE_DE_RECHERCHE&mb_url_rewrited_consultation=URL_DE_VOTRE_PAGE_DE_CONSULTATION/%ID%/%SLUG%/%TYPE%/&mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

Exemple

<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_url_rewrited_search=https:://www.mondomaine.com/randonnees&mb_url_rewrited_consultation=https:://www.mondomaine.com/randonnees/%ID%/%SLUG%/%TYPE%/&mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

3. Assurez-vous d’avoir correctement interpréter les paramètres «mb_titre», «mb_id» & «mb_page» dans vos configurations de réécriture d’url. Ci-dessous un exemple avec un fichier «.htaccess» dans un cas où le widget à été intégré dans un fichier nommé randonnes.php :

Options +FollowSymlinks
RewriteEngine on

RewriteRule ^randonnees/$ randonnees.php? [QSA,L]
RewriteRule ^(.*)/([0-9]*)/([a-zA-Z0-9-]*)/([a-zA-Z0-9-]*)/\??(.*)$ $1/?mb_id=$2&mb_titre=$3&mb_page=$4$5 [QSA,L]

Resultat de l'exemple

Pour la page de recherche : 

https:://www.mondomaine.com/randonnees

Pour une fiche de consultation : 

https:://www.mondomaine.com/randonnees/393326/chapelle-st-tugen/poi/?&mbScrollTo=module 

4ème solution : une url différente pour la recherche, la consultation de circuits et la consultation de points d'intérêts avec des paramètres

1. Ajoutez simplement les paramètre «mb_url_rewrited_search», «mb_url_rewrited_consultation» et «mb_url_rewrited_consultation_poi» au code d’insertion, de cette manière :

<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_url_rewrited_search=URL_DE_VOTRE_PAGE_DE_RECHERCHE&mb_url_rewrited_consultation=URL_DE_VOTRE_PAGE_DE_CONSULTATION_CIRCUIT&mb_url_rewrited_consultation_poi=URL_DE_VOTRE_PAGE_DE_CONSULTATION_POINT_INTERET&mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

2. Ajoutez également les paramètre ID ET SLUG* ET TYPE entourés de % à votre url dans «mb_url_rewrited_consultation» et «mb_url_rewrited_consultation_poi» de cette manière :

<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_url_rewrited_search=URL_DE_VOTRE_PAGE_DE_RECHERCHE&mb_url_rewrited_consultation=URL_DE_VOTRE_PAGE_DE_CONSULTATION_CIRCUIT/%ID%/%SLUG%/%TYPE%/&mb_url_rewrited_consultation_poi=URL_DE_VOTRE_PAGE_DE_CONSULTATION_POINT_INTERET/%ID%/%SLUG%/%TYPE%/&mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

Exemple

<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_url_rewrited_search=https:://www.mondomaine.com/randonnees&mb_url_rewrited_consultation=https:://www.mondomaine.com/randonnees/%ID%/%SLUG%/%TYPE%/&mb_url_rewrited_consultation_poi=https:://www.mondomaine.com/points-d-interet/%ID%/%SLUG%/%TYPE%/&mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

3. Assurez-vous d’avoir correctement interpréter les paramètres «mb_titre», «mb_id» & «mb_page» dans vos configurations de réécriture d’url. Ci-dessous un exemple avec un fichier «.htaccess» dans un cas où le widget à été intégré dans un fichier nommé randonnes.php :

Options +FollowSymlinks
RewriteEngine on

RewriteRule ^randonnees/$ randonnees.php? [QSA,L]
RewriteRule ^(.*)/([0-9]*)/([a-zA-Z0-9-]*)/([a-zA-Z0-9-]*)/\??(.*)$ $1/?mb_id=$2&mb_titre=$3&mb_page=$4$5 [QSA,L]

Resultat de l'exemple

Pour la page de recherche : 

https://www.mondomaine.com/randonnees

Pour une fiche de consultation circuit :

https://www.mondomaine.com/randonnees/387448/circuit-de-la-minardiere/circuit/?mbScrollTo=module

Pour une fiche de consultation point d’intérêt :

https://www.mondomaine.com/point-d-interet/1482631/eglise-saint-phalier/poi/?mbScrollTo=module

Cas B – Version JavaScript

Comme pour une insertion classique, récupérez depuis l’interface le code d’insertion PHP du type :

<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "LANGUE"});
</script>
<div id="mb-module-XXX"></div>

1ère solution : une seule url

1. Ajoutez simplement le paramètre «mb_url_rewrited» au code d’insertion, de cette manière : 

<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "LANGUE",
	params:{
	    mb_url_rewrited : "URL_DE_VOTRE_PAGE"
	}});
</script>
<div id="mb-module-XXX"></div>

Exemple 

<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "LANGUE",
	params:{
	    mb_url_rewrited : "https:://www.mondomaine.com/randonnees"
	}});
</script>
<div id="mb-module-XXX"></div>

2. Assurez-vous d’avoir correctement paramétré vos configurations de réécriture d’url. Ci-dessous un exemple avec un fichier «.htaccess» dans un cas où le widget à été intégré dans un fichier nommé randonnes.php :

Options +FollowSymlinks
RewriteEngine on

RewriteRule ^randonnees/$ randonnees.php? [QSA,L]

Resultat de l'exemple

Pour la page de recherche : 

https://www.mondomaine.com/randonnees 

Pour une fiche de consultation : 

https://www.mondomaine.com/randonnees?mb_page=poi&mb_id=393326&mb_titre=marie-thierry&mbScrollTo=module 

2ème solution : une url différente pour la recherche et la consultation 

1. Ajoutez simplement les paramètre «mb_url_rewrited_search» et «mb_url_rewrited_consultation» au code d’insertion, de cette manière :

<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "LANGUE",
	params:{
	    mb_url_rewrited_search : "URL_DE_VOTRE_PAGE_DE_RECHERCHE",
	    mb_url_rewrited_consultation : "URL_DE_VOTRE_PAGE_DE_CONSULTATION"
	}});
</script>
<div id="mb-module-XXX"></div>

Exemple 

<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "LANGUE",
	params:{
	    mb_url_rewrited_search : "https:://www.mondomaine.com/recherche",
	    mb_url_rewrited_consultation : "https:://www.mondomaine.com/randonnees"
	}});
</script>
<div id="mb-module-XXX"></div>

2. Assurez-vous d’avoir correctement paramétré vos configurations de réécriture d’url. Ci-dessous un exemple avec un fichier «.htaccess» dans un cas où le widget à été intégré dans un fichier nommé randonnes.php :

Options +FollowSymlinks
RewriteEngine on

RewriteRule ^randonnees$ randonnees.php? [QSA,L]
RewriteRule ^recherche$ randonnees.php? [QSA,L]

Resultat de l'exemple

Pour la page de recherche : 

https://www.mondomaine.com/recherche

Pour une fiche de consultation : 

https://www.mondomaine.com/randonnees?mb_page=poi&mb_id=393326&mb_titre=marie-thierry&mbScrollTo=module 

3ème solution : une url différente pour la recherche et la consultation avec des paramètres

1. Ajoutez simplement les paramètre «mb_url_rewrited_search» et «mb_url_rewrited_consultation» au code d’insertion, de cette manière :

<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "LANGUE",
	params:{
	    mb_url_rewrited_search : "URL_DE_VOTRE_PAGE_DE_RECHERCHE",
	    mb_url_rewrited_consultation : "URL_DE_VOTRE_PAGE_DE_CONSULTATION"
	}});
</script>
<div id="mb-module-XXX"></div>

2. Ajoutez également les paramètre ID ET SLUG* ET TYPE entourés de % à votre url dans «mb_url_rewrited_consultation» de cette manière :

*Le slug est une phrase formatée de façon à ce qu’elle s’affiche correctement dans une URL, exemple : https://www.mondomaine.com/voici-un-slug-formaté

<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "LANGUE",
	params:{
	    mb_url_rewrited_search : "URL_DE_VOTRE_PAGE_DE_RECHERCHE",
	    mb_url_rewrited_consultation : "URL_DE_VOTRE_PAGE_DE_CONSULTATION/%ID%/%SLUG%/%TYPE%/"
	}});
</script>
<div id="mb-module-XXX"></div>

Exemple 

<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "LANGUE",
	params:{
	    mb_url_rewrited_search : "https:://www.mondomaine.com/randonnees",
	    mb_url_rewrited_consultation : "https:://www.mondomaine.com/randonnees/%ID%/%SLUG%/%TYPE%/"
	}});
</script>
<div id="mb-module-XXX"></div>

3. Assurez-vous d’avoir correctement interpréter les paramètres «mb_titre», «mb_id» & «mb_page» dans vos configurations de réécriture d’url. Ci-dessous un exemple avec un fichier «.htaccess» :

Options +FollowSymlinks
RewriteEngine on

RewriteRule ^randonnees/$ randonnees.php? [QSA,L]
RewriteRule ^(.*)/([0-9]*)/([a-zA-Z0-9-]*)/([a-zA-Z0-9-]*)/\??(.*)$ $1/?mb_id=$2&mb_titre=$3&mb_page=$4$5 [QSA,L]

Resultat de l'exemple

Pour la page de recherche : 

https://www.mondomaine.com/randonnees

Pour une fiche de consultation : 

https://www.mondomaine.com/randonnees/393326/chapelle-st-tugen/poi/?&mbScrollTo=module 

4ème solution : une url différente pour la recherche, la consultation de circuits et la consultation de points d'intérêts avec des paramètres

1. Ajoutez simplement les paramètre «mb_url_rewrited_search», «mb_url_rewrited_consultation» et «mb_url_rewrited_consultation_poi» au code d’insertion, de cette manière :

<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "LANGUE",
	params:{
	    mb_url_rewrited_search : "URL_DE_VOTRE_PAGE_DE_RECHERCHE",
	    mb_url_rewrited_consultation : "URL_DE_VOTRE_PAGE_DE_CONSULTATION_CIRCUIT",
	    mb_url_rewrited_consultation_poi : "URL_DE_VOTRE_PAGE_DE_CONSULTATION_POINT_INTERET"
	}});
</script>
<div id="mb-module-XXX"></div>

2. Ajoutez également les paramètre ID ET SLUG* ET TYPE entourés de % à votre url dans «mb_url_rewrited_consultation» et «mb_url_rewrited_consultation_poi» de cette manière :

<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "LANGUE",
	params:{
	    mb_url_rewrited_search : "URL_DE_VOTRE_PAGE_DE_RECHERCHE",
	    mb_url_rewrited_consultation : "URL_DE_VOTRE_PAGE_DE_CONSULTATION_CIRCUIT/%ID%/%SLUG%/%TYPE%/",
	    mb_url_rewrited_consultation_poi : "URL_DE_VOTRE_PAGE_DE_CONSULTATION_POINT_INTERET/%ID%/%SLUG%/%TYPE%/"
	}});
</script>
<div id="mb-module-XXX"></div>

Exemple 

<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "LANGUE",
	params:{
	    mb_url_rewrited_search : "https://www.mondomaine.com/randonnees",
	    mb_url_rewrited_consultation : "https://www.mondomaine.com/randonnees/%ID%/%SLUG%/%TYPE%/",
	    mb_url_rewrited_consultation_poi : "https://www.mondomaine.com/point-d-interet/%ID%/%SLUG%/%TYPE%/"
	}});
</script>
<div id="mb-module-XXX"></div>

3. Assurez-vous d’avoir correctement interpréter les paramètres «mb_titre», «mb_id» & «mb_page» dans vos configurations de réécriture d’url. Ci-dessous un exemple avec un fichier «.htaccess» :

Options +FollowSymlinks
RewriteEngine on

RewriteRule ^randonnees/$ randonnees.php? [QSA,L]
RewriteRule ^(.*)/([0-9]*)/([a-zA-Z0-9-]*)/([a-zA-Z0-9-]*)/\??(.*)$ $1/?mb_id=$2&mb_titre=$3&mb_page=$4$5 [QSA,L]

Resultat de l'exemple

Pour la page de recherche : 

https://www.mondomaine.com/randonnees

Pour une fiche de consultation circuit :

https://www.mondomaine.com/randonnees/387448/circuit-de-la-minardiere/circuit/?mbScrollTo=module

Pour une fiche de consultation point d’intérêt :

https://www.mondomaine.com/point-d-interet/1482631/eglise-saint-phalier/poi/?mbScrollTo=module

Option(s) supplémentaire(s)

Choix du mode de transformation du titre dans l’URL pour la version PHP et JavaScript

Le nouveau paramètre « mb_url_rewrited_consultation_slug_mode » permet de modifier la manière dont le code génère le slug dans l’url (cf: 3ème solution de chaque cas). Les deux seules valeurs qui sont actuellement utilisables sont « DEFAULT » pour utiliser la génération de slug de WordPress par défaut de Cirkwi et « WP_SANITIZE_TITLE_WITH_DASHES » qui permet d’utiliser la génération de slug de WordPress (cf: <https://developer.wordpress.org/reference/functions/sanitize_title_with_dashes/>).

Si le paramètre n’est pas présent dans l’url ou si la valeur de ce paramètre n’est pas correcte alors le slug se générera en utilisant l’algorithme de Cirkwi.

Exemple d’intégration PHP :

<?php
$code_html = file_get_contents("https://www.modulesbox.com/LANGUE/api/module/XXX?mb_url_rewrited_search=https:://www.mondomaine.com/randonnees&mb_url_rewrited_consultation=https:://www.mondomaine.com/randonnees/%ID%/%SLUG%/%TYPE%/&mb_key=XXX&mb_url_rewrited_consultation_slug_mode=WP_SANITIZE_TITLE_WITH_DASHES&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

Exemple d’intégration JavaScript : 

<script type="text/javascript" src="https://modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
    mbLoadModule({
        id: "XXXX",
        locale: "fr",
        params: {
            mb_url_rewrited_consultation_slug_mode: 'WP_SANITIZE_TITLE_WITH_DASHES',
            mb_url_rewrited_consultation: 'https:://www.mondomaine.com/randonnees/%ID%/%SLUG%/%TYPE%/',
            mb_url_rewrited_search: 'https:://www.mondomaine.com/randonnees'
        }
    });
</script>
<div id="mb-module-XXXX"></div>

Filtrer mon widget par mots-clés – via le code d’intégration

Filtrer mon widget par mots-clés via le code d’intégration​

Introduction

Ce tutoriel technique vous permettra de filtrer le contenu affiché sur votre carte en fonction d’un ou plusieurs mots clés.

Cas A – Version PHP (recommandé)

  1. Récupérez le code d’insertion PHP depuis votre interface de gestion de widgets, il devrait ressembler à ça :
<?php
$code_html = file_get_contents("https://www.modulesbox.com/fr/api/module/XXX?mb_key=XXX&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>
  1. Ajoutez ensuite en paramètre la liste des mots clés que vous souhaitez filtrer, séparés par un point-virgule (paramètre “mb_list-keyword”).
  2. Le code devrait donc ressembler à ça :
<?php
$code_html = file_get_contents("https://www.modulesbox.com/fr/api/module/XXX?mb_key=XXX&mb_list-keywords=nancy;porte&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

Dans l’exemple ci-dessus, la carte affichera uniquement les parcours / points d’intérêts qui contiennent au moins dans le titre ou la description, “nancy”, “porte” ou “nancy” et “porte”.

Cas B – Version JavaScript

  1. Récupérez le code d’insertion JavaScript depuis votre interface de gestion de widgets, il devrait ressembler à ça :
<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "fr"});
</script>
<div id="mb-module-XXX"></div>
  1. Ajoutez ensuite en paramètre la liste de mots clés que vous souhaitez filtrer, séparés par un point-virgule (paramètre “mb_list-keyword”) :
  2. Le code devrait donc ressembler à ça :
<script type="text/javascript" src="https://www.modulesbox.com/js/module-loader.js" id="mb-module-loader"></script>
<script type="text/javascript">
	mbLoadModule({ id: XXX, locale: "fr",
	params:{
	    "mb_list-keywords" : "nancy;porte"
	}});
</script>
<div id="mb-module-XXX"></div>

Dans l’exemple ci-dessus, la carte affichera uniquement les parcours / points d’intérêts qui contiennent au moins dans le titre ou la description, “nancy”, “porte” ou “nancy” et “porte”.