Intégrer mes SityGuides dans mon Site Web ¶

Il est dès maintenant possible d'intégrer les différentes randonnées d'un compte Sity dans un site web externe. 

Comment fonctionne le module d'intégration ?

Il s'agit d'un simple morceau de code à copier-coller dans votre site. Ce code va dès lors contacter nos serveurs et intégrer automatiquement vos différents SityGuides dans votre site. 
Le module d'intégration va automatiquement ajouter à votre site : 

- Une page présentant les différents SityGuides avec un moteur de recherche latéral. 
- Une visualisation en mode carte générale qui se filtre en fonction des choix de l'utilisateur 
- Une fiche de détails de chaque SityGuide

Lorsque vous mettez à jour un SityGuide, les modifications sont automatiquement répercutées sur votre site. 
 

Quels sont les prérequis ? ¶

- Il est nécessaire de réserver sur votre site une page d'une largeur minimale de 750px. 
- Disposer d'une clef d'accès à l'API Sity 
 

Procéder à l'intégration ¶

Le script suivant doit simplement être copié collé dans votre site, en prenant soin de remplacer  "VOTRE_CLEF_API" par votre votre clef d'accès à l'API

Script à intégrer dans le body de votre page web à l'emplacement d'affichage souhaité : 

<script type="text/javascript" src="http://api.geolives.com/VOTRE_CLEF_API/TrailManager?action=intScript&lang=fr">

Vos randonnées sont alors automatiquement importées dans votre site voir un exemple. 
 

En cas de problème¶

Il est possible de tester le bon fonctionnement du module avec votre clef d'API sur notre page de test 
 

---

Réglages avancés¶

Différentes options avancées existent et peuvent être appliquées à votre site. 
Par défaut, un moteur de recherche générique est automatiquement inclus dans module d'intégration et les résultats sont présentes sous forme de "bulles"
Toutes les randonnées sont également présentées à l'utilisateur 
 

Filtrage¶

Il est possible verrouiller directement les randonnées présentées sur un ou plusieurs critères. 
Attention : Ces filtres sont indépendants du formulaire de recherche et sont ajoutés à toutes les requêtes de recherche de randos. 
Exemple : Si votre code d'intégration spécifie un filtre sur le sport "vélo", seuls les SityGuides dans la catégorie vélo seront présentés, même si l'utilisateur sélectionnait une autre catégorie dans le module de recherche.
 

Comment filtrer ? ¶

Il suffit de passer des arguments supplémentaires au code d'intégration dans un paramètre "filter". 
Exemple:

<script type="text/javascript" src="http://api.geolives.com/VOTRE_CLEF_API/TrailManager?action=intScript&lang=fr&filter=msq_ville=30007;activite=1;...">

L'utilisation est filtres est décrite plus en détails sur la page des description des services API dans la rubrique intScript. 

 

Une présentation spécifique¶

Une présentation plus spécifique peut être appliquée par compte client. 
Cette modification doit être effectuée par Geolives en interne, ou si vous ou votre prestataire informatique en est capable, au travers d'un fichier HTML spécifique qui sera prochainement décrit dans ce wiki