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.

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”.