Updated Network (markdown) authored by Tom's avatar Tom
### Introduction Un network est une carte exploitant la base de donnée de Communecter. Il permet d'afficher tous les points correspondant à un tag (par exemple : #AMAP, #Culture, #Energie, ...) sur un périmètre défini (par exemple : plusieurs régions ou une seule ville).
Un network est une carte exploitant la base de donnée de Communecter. Il permet d'afficher tous les points correspondant à un tag (par exemple : #AMAP, #Culture, #Energie, ...). Il est bien sûr possible de définir un périmètre pour n'afficher que les points correspondant à une zone précise. Voici quelques exemples de network : [Tiers-Lieux des Hauts de France](http://hauts.tiers-lieux.org/mel/), [Assemblée des Communs de Lille](http://lille.lescommuns.org/cartographier-les-communs/), [Restaurants vegan de la Réunion](https://restovegan.re/), [Zéro Déchet Île de France](paris.zerowastefrance.org/la-carte), [Bretagne Telecom](https://www.communecter.org/?network=BretagneTelecom).
Grâce à ce tutoriel vous serez en mesure d'utiliser une carte et de créer la votre.
***
### Découverte de l’interface de navigation
*En vidéo : https://youtu.be/XcuYgWg5zj0*
Vous pouvez accéder à une carte Communecter via le site communecter.org, un site tierce intégrant la carte dans sa page ou une adresse internet dédiée. Les critères et la zone géographiques des points remontés dans la carte sont définis par l’éditeur. Sur la droite vous pouvez zoomer plus ou moins sur une zone géographique. Sur la gauche, les filtres vous permettent d’affiner votre recherche selon des critères définis par l’éditeur. Sur la droite, vous trouverez un moteur de recherche pour affiner votre recherche selon vos critères. En haut à droite, vous pouvez passer en mode liste. En cliquant sur en savoir plus, vous accéder à la fiche complète du point d’intérêt.
### Créer un compte Communecter via le module network
*En vidéo : https://youtu.be/hK5JaYYj0KA*
Comme pour wikipédia, un compte est indispensable pour modifier la fiche d’une organisation présente sur la carte. Nous pouvons s’inscrire sur Communecter en cliquant sur le bandeau en haut de la carte, puis “S’inscrire”. Entrer les informations puis cliquez sur je m’inscris.
### Ajouter une organisation
*En vidéo : https://youtu.be/DTuzy7bWo-0*
Une fois connecté vous trouverez en bas à gauche le bouton vous permettant d’ajouter un élément. Le type d’élément proposé (organisation, événement, … ) a été choisi par la personne ayant créer la carte.
Si vous souhaitez compléter la fiche créée, il faudra passer par le site communecter.org.
### Modifier une fiche Voici quelques exemples de network : [Tiers-Lieux des Hauts de France](http://hauts.tiers-lieux.org/mel/), [Assemblée des Communs de Lille](http://lille.lescommuns.org/cartographier-les-communs/), [Restaurants vegan de la Réunion](https://restovegan.re/), [Zéro Déchet Île de France](paris.zerowastefrance.org/la-carte), [Bretagne Telecom](https://www.communecter.org/?network=BretagneTelecom).
*En vidéo : https://youtu.be/fqt_fkV0Mfo*
Connectez-vous avec votre compte communecter.org. Choisissez un point d'intérêt, puis cliquez sur "en savoir +". Modifiez la fiche et n'oubliez pas de sauvegarder. ### Introduction
L'onglet "historique" vous permet de connaître la date, l'auteur et la teneur exacte de chaque modification. > Ce tuto existe aussi en vidéo : https://youtu.be/OOnEnxjhr-I
***
### Créer une carte personnalisée
*En vidéo : https://youtu.be/OOnEnxjhr-I*
L’adresse d’une carte est composée de l’adresse vers le module Communecter (`https://www.communecter.org/communecter?network=`) suivi d'un lien vers un fichier contenant les paramètres de la carte. Ce fichier doit être format JSON.
Ce JSON peut être hébergé sur votre site ou sur un site tierce. Pour ce tutoriel nous utiliserons Gist (le service de partage de code de GitHub). L’adresse d’une carte commence par `https://www.communecter.org/communecter?network=` suivi d'un lien vers un fichier JSON contenant les différents paramètres de la carte (nom, filtres, limites géographiques, etc.). Ce JSON peut être hébergé sur votre site ou sur un site tierce (pour ce tuto nous utiliserons [Gist](https://gist.github.com/)).
Exemple de lien complet : `https://www.communecter.org/communecter?network=https://gist.githubusercontent.com/Simroubriff/3e14264620d9e59e874d44d306314679/raw/f8f013ded329d9e07e3e44666a548f974a7606c0/ZD-Paris` Exemple de lien complet : `https://www.communecter.org/communecter?network=https://gist.githubusercontent.com/Simroubriff/3e14264620d9e59e874d44d306314679/raw/f8f013ded329d9e07e3e44666a548f974a7606c0/ZD-Paris`
...@@ -45,22 +13,174 @@ Exemple de lien complet : `https://www.communecter.org/communecter?network=https ...@@ -45,22 +13,174 @@ Exemple de lien complet : `https://www.communecter.org/communecter?network=https
Pour commencer, le plus simple est de copier une configuration existante puis de modifier les paramètres un à un pour éviter les erreurs. Pour commencer, le plus simple est de copier une configuration existante puis de modifier les paramètres un à un pour éviter les erreurs.
Copiez le code ci-dessous dans un nouveau Gist : http://gist.github.com/. Cliquez sur Raw (en haut à droite de votre code) puis ouvrez un nouvel onglet pour ouvrir l'URL suivante : `https://www.communecter.org/communecter?network=LienDuRAW`. ### Créer une carte personnalisée
1. Copiez le code ci-dessous dans un nouveau Gist : http://gist.github.com/
1. Cliquez sur Raw (en haut à droite de votre code)
1. Ouvrez un nouvel onglet pour ouvrir l'URL suivante : `https://www.communecter.org/communecter?network=LienDuRAW.
Fichier type
Ajouter le code complet ici. ***
Détail des paramètres
En-tête ### Exemple de code
"name" : "BretagneTelecomIlletVilaine", ```
{
"name" : "Communs",
"mode" : "server", "mode" : "server",
"logo" : "http://monsite.ext/mel.png", "skin" : {
"logo" : false,
"title" : "Communs dans la région Hauts de France",
"shortDescription" : "false",
"displayScope" : false,
"docs":true,
"displayCommunexion" : true,
"displayNotifications" : true,
"profilBar" : false,
"breadcrum" : true,
"displayButtonGridList" : false,
"class" : {
"mainContainer" : false
},
"iconeAdd" : false,
"iconeSearchPlus" : false,
"loginTitle":"",
"front" : {
"organization" : false,
"project" : true,
"event" : true,
"community" : true,
"dda" : false,
"live" : false,
"search" : false,
"need" : true,
"poi" : true
},
"menu" : {
"aroundMe":false,
"connectLink":false,
"add":true,
"detail":true,
"news":true,
"directory":true,
"gallery":true
}
},
"filter" : {
"types" : false,
"linksTag" : {
"Type de tiers-lieu" : {
"tagParent" : "Type",
"background-color" : "#f5f5f5",
"image" : "Travail.png",
"tags" : {
"Télétravail" : "Télétravail",
"Coworking" : "Coworking",
"Médiation Numérique" : "Médiation numérique",
"FabLab" : "Fablab",
"Accompagnement de projets" : "Accompagnement de projets",
"Atelier" : "Atelier",
"Salle de réunion" : "Salle de réunion",
"Communauté Catalyst" : "Catalyst",
"Espace à louer" : "Espace à louer"
}
},
"Services complémentaires" : {
"tagParent" : "Service",
"background-color" : "#f5f5f5",
"image" : "Service.png",
"tags" : {
"Espace détente" : "Espace détente",
"Cuisine" : "Cuisine",
"Achat groupé" : "Achat groupé",
"Bar participatif" : "Bar participatif",
"Cuisine participative" : "Cuisine participative",
"Epicerie participative" : "Epicerie participative",
"Jardiné" : "Jardin",
"Domiciliation" : "Domiciliation",
"Atelier participatif" : "Atelier participatif",
"Restaurant" : "Restaurant",
"Bar":"Bar"
}
},
"Modèle de gestion" : {
"tagParent" : "Modele",
"background-color" : "#f5f5f5",
"image" : "Loisir.png",
"tags" : {
"Commun" : "Commun",
"Association" : "Association",
"Business" : "Business",
"Public" : "Public"
}
},
"État du projet" : {
"tagParent" : "Etat",
"background-color" : "#f5f5f5",
"image" : "Reparation.png",
"tags" : {
"En projet" : "En projet",
"En démarrage" : "En démarrage",
"En fonctionnement" : "En fonctionnement"
}
},
"Taille de l'espace" : {
"tagParent" : "Surface",
"background-color" : "#f5f5f5",
"image" : "Information.png",
"tags" : {
"Moins de 60m2" : "Moins de 60m2",
"Entre 60 et 200m2" : "Entre 60 et 200m2",
"Plus de 200m2" : "Plus de 200m2"
}
}
}
},
"add" : {
"organization" : true,
"person" : true
},
"result" : {
"displayImage" : true,
"displayType" : false,
"fullLocality" : true,
"datesEvent" : false,
"displayShortDescription" : true
},
"request" : {
"pagination" : 1000,
"searchType" : [
"organizations",
"person",
"poi"
],
"searchTag" : [
"communs",
"commun",
"Commun",
"Communs"
],
"searchLocalityREGION": [
"Nord-Pas-de-Calais-Picardie"
],
"mainTag" : ["commun"]
}
}
```
***
Fonctionnalités
#### Header
`"name" : "BretagneTelecomIlletVilaine",` : Nom de la carte afficher dans la bannière du haut
`"mode" : "server",` : ?
`"logo" : "http://monsite.ext/mel.png",` : Pour ajouter son logo
####Paramètres pour afficher des fonctionnalités sur la carte.
```
"skin" : { "skin" : {
"logo" : false, "logo" : false,
"title" : false, "title" : false,
...@@ -75,9 +195,9 @@ Fonctionnalités ...@@ -75,9 +195,9 @@ Fonctionnalités
"iconeSearchPlus" : false, "iconeSearchPlus" : false,
"loginTitle":"" "loginTitle":""
}, },
```
### Filtrage dans la carte Filtrage dans la carte
``` ```
"filter" : { "filter" : {
//Filtrer par type (organizations, events, ) //Filtrer par type (organizations, events, )
...@@ -86,14 +206,14 @@ Fonctionnalités ...@@ -86,14 +206,14 @@ Fonctionnalités
"tags" : true, "tags" : true,
//Parametre de filtrage //Parametre de filtrage
paramsFiltre : { conditionBlock : "and" | "or" , conditionTagsInBlock : "and" | "or" }, paramsFiltre : { conditionBlock : "and" | "or" , conditionTagsInBlock : "and" | "or" },
//Par defaut si on ne met pas de paramsFiltres , les filtres agiront ainsi : //Par défaut si on ne met pas de paramsFiltres , les filtres agiront ainsi :
//- les tags dans un même block agissent comme des "OU" //- les tags dans un même block agissent comme des "OU"
//- entre les blocks comme des "ET" //- entre les blocks comme des "ET"
//l'option "conditionBlock" permet de définir comment agissent les tags entre les blocks //l'option "conditionBlock" permet de définir comment agissent les tags entre les blocks
//l'option "conditionTagsInBlock" permet de définir comment agissent les tags dans un block //l'option "conditionTagsInBlock" permet de définir comment agissent les tags dans un block
//Liste des section de filtre //Liste des sections de filtre
"linksTag" : { "linksTag" : {
//Nom de la section //Nom de la section
"Se nourrir" : { "Se nourrir" : {
...@@ -107,63 +227,34 @@ paramsFiltre : { conditionBlock : "and" | "or" , conditionTagsInBlock : "and" | ...@@ -107,63 +227,34 @@ paramsFiltre : { conditionBlock : "and" | "or" , conditionTagsInBlock : "and" |
"magasin de producteurs" : "MagasinDeProducteurs", "magasin de producteurs" : "MagasinDeProducteurs",
"Groupement d'achat" : "GroupementDAchat", "Groupement d'achat" : "GroupementDAchat",
``` ```
### Assigner plusieurs tags pour un filtre
```
"Nord" : ["Nord","MEL"],
```
### Requete transmise à Communecter pour afficher des resultats lors de l'ouverture de la carte
``` `"Nord" : ["Nord","MEL"],` : Assigner plusieurs tags pour un filtre
"request" : {
```
//Clé fournit par Communecter pour accéder aux données (MANDATORY) `"request" : {` : Requête transmise à Communecter pour afficher des résultats lors de l'ouverture de la carte
``` `"sourcekey" : "BretagneTelecom",` : Clé fournit par Communecter pour accéder aux données (MANDATORY)
"sourcekey" : "BretagneTelecom",
```
//Nombre de points remonté par requête `"pagination" : 1000,` : Nombre de points remonté par requête
```
"pagination" : 1000,
```
//Type de recherche dans la DB communecter (MANDATORY) `"searchType" : ["organizations", "projects", "events"],` : Type de recherche dans la DB communecter (MANDATORY)
```
"searchType" : ["organizations", "projects", "events"],
```
//Le tag principal des points remontés ou créés via la carte auront le tag mentionné. `"mainTag" : ["TiersLieux" ]` : Le tag principal des points remontés ou créés via la carte auront le tag mentionné
```
"mainTag" : ["TiersLieux" ]
```
//Filtrer par tags
```
"searchTag" : ["Nord","MEL"],
```
//Filtrer par Région `"searchTag" : ["Nord","MEL"],` : Filtrer par tags
```
"searchLocalityREGION" : ["POLYNESIE"],
```
La liste des régions à utiliser est ci dessous. C'est à suivre à la lettre pour que cela fonctionne. `"searchLocalityREGION" : ["POLYNESIE"],` : Filtrer par Région
Filtrer par département
```
"searchLocalityDEPARTEMENT" : ["ISERE"],
```
Filtrer par Ville : #### La liste des régions à utiliser est ci dessous.
... C'est à suivre à la lettre pour que cela fonctionne.
"searchLocalityNAME" : ["LYON"],
``` `"searchLocalityDEPARTEMENT" : ["ISERE"],` : Filtrer par département
La liste des Département à utiliser est ci dessous. `searchLocalityNAME" : ["LYON"],` : Filtrer par Ville
## LISTES
### Liste Régions #### La liste des Département à utiliser est ci dessous.
**Liste Régions**
- "Île-de-France" - "Île-de-France"
- "NOUVELLE-CALEDONIE" - "NOUVELLE-CALEDONIE"
- "POLYNESIE" - "POLYNESIE"
...@@ -185,7 +276,7 @@ La liste des Département à utiliser est ci dessous. ...@@ -185,7 +276,7 @@ La liste des Département à utiliser est ci dessous.
- "Guyane" - "Guyane"
- "La Réunion" - "La Réunion"
### Liste Départements **Liste Départements**
- "ESSONNE" - "ESSONNE"
- "YONNE" - "YONNE"
- "TERRITOIRE DE BELFORT" - "TERRITOIRE DE BELFORT"
... ...
......