Filtrer mon widget par catégorie – via le code d’intégration

Filtrer mon widget par catégorie – via le code d’intégration

Introduction

Ce tutoriel technique vous permettra de filtrer le contenu affiché dans votre Widget Itinéraires, plus précisément sur votre carte par sous-catégories de points d’intérêt.

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 de points d’intérêt que vous souhaitez filtrer, séparés par un point-virgule (paramètre “mb_sub-categories-poi”).
  2. La liste des différentes catégories & sous-catégories se trouvent ici : https://ws.cirkwi.com/tuto/categories.php
  3. Le code devrait donc ressembler à ça :
<?php
$code_html = file_get_contents("https://www.modulesbox.com/fr/api/module/XXX?mb_key=XXX&mb_sub-categories-poi=1;2&".$_SERVER["QUERY_STRING"]);
echo $code_html;
?>

Votre carte possède maintenant uniquement les POI qui sont dans la catégorie 1 ou 2.

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 des points d’intérêt que vous souhaitez filtrer, séparés par un point-virgule (paramètre “mb_sub-categories-poi”).
  2. La liste des différentes catégories & sous-catégories se trouve ci-dessous, ou ici : https://ws.cirkwi.com/tuto/categories.php
  3. 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_sub-categories-poi" : "1;2"
	}});
</script>
<div id="mb-module-XXX"></div>

Dans l’exemple ci-dessus, la carte affichera uniquement les points d’intérêts qui sont dans la catégorie 1 OU 2.

Filtrer mon widget par identifiants d’objets – via le code d’intégration

Filtrer mon widget par identifiants d’objets – via le code d’intégration

Introduction

Ce tutoriel technique vous permettra de filtrer le contenu affiché dans votre Widget Itinéraires; plus précisément sur votre carte en fonction d’identifiants de parcours & de points d’intérêt (POIs).

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 d’identifiants que vous souhaitez filtrer, séparés par un point-virgule (paramètre “mb_list-circuit-id” pour filtrer parmi les parcours, « mb_list-poi-id » pour filtrer parmi les points d’intérêts).

  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;
?>

Désormais votre carte affiche uniquement les parcours / points d’intérêts qui sont présents dans le(s) paramètre(s) renseigné(s).

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 d’identifiants que vous souhaitez filtrer, séparés par un point-virgule (paramètre “mb_list-circuit-id” pour filtrer parmi les parcours, « mb_list-poi-id » pour filtrer parmi les points d’intérêts).
  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-poi-id : "78002;59980",
	    mb_list-circuit-id : "12345;67891"
	}});
</script>
<div id="mb-module-XXX"></div>

Désormais votre carte affiche uniquement les parcours / points d’intérêts qui sont présents dans le(s) paramètre(s) renseigné(s).

 

Intégrer un widget sur Wix

Intégrer un widget sur Wix

Après avoir configuré votre widget, vous arrivez à la dernière étape où vous devez copier le code d’intégration dans l’administration de votre site Wix. 

Wix permet d’intégrer un widget aussi bien avec le code JavaScript qu’avec le code PHP. Nous vous conseillons néanmoins de faire l’intégration en JavaScript. Voici quelques explications qui vous permettront d’arriver à vos fins facilement :

Etape 1 : Récupérer le code d’intégration

  1. Widget Itinéraires

Etape 2 : Se rendre sur Wix

Vous souhaitez plus d’informations sur les widgets ?

 

Intégrer avec le code Javascript

Etape 1 : Récupérer le code d'intégration

Cas 1: Vous souhaitez intégrer un widget Itinéraires (pro.cirkwi.com)

  • Dans l’étape du code d’insertion, cliquez sur « Le code d’insertion en Javascript »
  • Sélectionnez et copiez le code (ctrl C ou edition/copier)
code-insertion-js
Étape 2 : sur WIX
  1. Maintenant, allez sur le tableau de bord puis dans la section My Site appuyez sur « modifier ».

2. Vous allez être redirigé sur l’administration de votre site Wix (une adresse qui ressemblerait à editor.wix.com/monsite).

3. En haut à gauche de la page, sélectionnez la page sur laquelle vous voulez intégrer le widget.

tuto_wix_001

4. Appuyez sur le bouton « Ajouter » puis sur le bouton avec le symbole « + ».

tuto_wix_002

5. Cliquez ensuite sur « Intégration », « intégration personnalisé » puis « intégrer un widget ». Déplacez l’encadré où vous voulez sur la page agrandissez/réduisez l’encadré comme bon vous semble.

6. Cliquez sur « saisir code ».

7. Une fenêtre s’ouvre en bas a droite de votre page. Sélectionnez « Code », coller le code d’intégration en JavaScript, puis cliquez sur « Mettre à jour ».

8. Voici un aperçu de que vous devriez obtenir :

Widget Itinéraires : Vous pouvez agrandir le widget en cliquant sur les bords et en les glissant vers le bas de la page.

9. Une fois les bords ajustés, vous devriez avoir un rendu comme suit :

Widget Itinéraires :

Intégrer un widget sur Jimdo

Intégrer un widget sur Jimdo

Après avoir configuré votre widget, vous arrivez à la dernière étape où vous devez copier le code d’intégration dans l’administration de votre site Jimdo, soit en PHP soit en Javascript. Jimdo permet d’intégrer un widget aussi bien avec le code Javascript qu’avec le code PHP. Nous vous conseillons néanmoins de faire l’intégration en JavaScript. Voici quelques explications qui vous permettront d’arriver à vos fins facilement :

Etape 1 : Récupérer le code d’intégration du widget itinéraires

Etape 2 : Se rendre sur Jimdo

Intégrer avec le code Javascript

Etape 1 : Récupérer le code d’intégration
  • Sur pro.cirkwi.com, dans l’étape du code d’insertion, cliquez sur « Le code d’insertion en Javascript ».
  • Sélectionnez et copiez le code (ctrl C ou edition/copier).
code-insertion-js
Étape 2 : sur Jimdo

Attention: votre site internet doit être créer via l’option créator, le mode « expert », pour permettre l’intégration du widget. 

  1. Maintenant, allez sur le tableau de bord puis dans la section My Site appuyez sur « modifier ».
  2. Vous allez être redirigé sur l’administration de votre site Jimdo (une adresse qui ressemblerai à www.monsite.jimdo.com).
  3. Allez sur la page où vous souhaitez intégrer le widget.
integration-jimdo

         4. Cliquez sur « Ajouter un élément ».

integration-jimdo-ajouter-element

        5. Cliquez sur « Éléments supplémentaires et services externes ».

integration-jimdo-ajouter-element2

          6. Cliquez sur « Widget HTML ».

integration-jimdo-ajouter-element3

         7. Une fenêtre s’ouvre, c’est le moment de coller votre code d’insertion en Javascript. Cliquez ensuite sur « Enregistrer ».

integration-jimdo-ajouter-element4

Après un cours temps de chargement, voici le résultat que vous devriez obtenir:

integration-jimdo-resultat

Vous pouvez aller consulter la page de votre site internet. Le widget est maintenant affiché 🙂
Si quelque chose ne fonctionne pas ou que le widget s’affiche mal, contactez notre support en ligne.

Installer un widget sur un site DRUPAL 7 et 8

Installer un widget sur un site DRUPAL 7 et 8

  1. Rendez-vous sur votre administration Drupal et connectez-vous à votre compte.
  2. Installez le module « PHP filter ».
    Vous constaterez peut-être un message d’avertissement indiquant que ce module n’est pas couvert par la politique de conseil en sécurité de Drupal. En effet, puisqu’il vient modifier le fonctionnement initial de Drupal. Cependant, il est nécessaire afin que celui-ci puisse interpréter le code d’insertion PHP de votre widget Cirkwi dans le corps d’un article ou d’une page.
  3. Si ce n’est pas déjà fait, il est temps de paramétrer votre premier widget sur Pro.cirkwi.com.
  4. A la dernière étape de configuration de votre widget, dans la page « Insertion », copiez le code PHP.
  5. Retournez sur Drupal, dans la modification d’une page de votre site et choisissez le forme de texte « PHP code».
  6. Collez le code PHP où vous souhaitez ajouter le widget. Enregistrez.
  7. Allez sur votre site et rechargez la page où est intégrée le widget.

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