đź“• Node [[network]]
📄 network.md by @flancian ️🔗 ✍️

Network

đź“„ network.md by @communecter

Créer un network

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.

Tous les networks sont liĂ©es par la base de donnĂ©es mutualisĂ©e, qui est commune. Par contre chaque carte ne montre que l’information relative Ă  un contexte. Dans le schĂ©ma ci-dessous on constate que certaines cartes affichent tout ou partie des donnĂ©es dĂ©jĂ  visibles sur d’autres cartes (ex : une carte zĂ©ro dĂ©chet locale permet de visualiser qu’une partie des donnĂ©es de la carte nationale). Si on ajoute un commerce zĂ©ro dĂ©chet via communecter.org, la carte nationale ou la carte locale, toutes ces cartes le verront apparaĂ®tre automatiquement.

Voici quelques exemples de network : Tiers-Lieux des Hauts de France, AssemblĂ©e des Communs de Lille, ZĂ©ro DĂ©chet ĂŽle de France ainsi qu’un article expliquant la dĂ©marche, Bretagne Telecom, l’ESS Ă  la RĂ©union, Protection animale Ă  La RĂ©union et une cartographie de compĂ©tences.

Voir la page : [utilisation des cartes](/2 - Utiliser l’outil/FonctionnalitĂ©s/cartes.md) pour des tutoriels utilisateurs. Voir le canal de discussion #co_network si vous avez besoin d’un coup de main.

Introduction

L’adresse d’une carte commence par https://www.communecter.org/network/default/index?src= suivi d’un lien vers un fichier contenant les diffĂ©rents paramètres de la carte (nom, filtres, limites gĂ©ographiques, etc.). Ce fichier peut ĂŞtre hĂ©bergĂ© sur votre site ou sur un site tierce (pour ce tuto nous utiliserons Gist).

Exemple de lien complet : https://www.communecter.org/network/default/index?src=https://gist.github.com/Drakone/c9b890500107f9703fb3a6a8eae0d164/raw/essreunion.json

Le format JSON n’autorise pas l’ajout de commentaire dans le code. Le nom de votre fichier ne doit pas contenir d’espaces.

Pour commencer, le plus simple est de copier une configuration existante puis de modifier les paramètres un à un pour éviter les erreurs.

Créer une carte personnalisée

Nouveau : il sera bientĂ´t possible de gĂ©nĂ©rer une carte via un simple formulaire directement depuis l’interface de Communecter.

  1. Copiez l’exemple de configuration ci-dessous dans un nouveau gist.github.com. Inscription obligatoire mais gratuite.
  2. Cliquez sur Raw (en haut Ă  droite de votre code)
  3. Ouvrez un nouvel onglet pour ouvrir l’URL suivante : https://www.communecter.org/network/default/index?src=LienDuRAW

Astuces

  • Si vous ne souhaitez pas que l’URL change Ă  chaque modification des paramètres, utilisez ce format d’URL : https://gist.github.com/[votre_pseudo_gist]/[id_du_gist]/raw/[nom_du_fichier]
  • Utilisez frama.link pour raccourcir vos URL

Intégrer la carte

En ajoutant le code suivant dans une page, vos utilisateurs pourront utiliser la carte sans quitter votre site.

<iframe src="https://www.communecter.org/network/default/index?src=LienDuRAW" width="100%" height="700px" frameborder="0"></iframe>

Paramétrage

Ctrl + F pour utilisez le moteur de recherche de votre navigateur.

name

Titre affiché dans la bannière du haut.

mode

?

skin

Paramètres pour afficher des fonctionnalités sur la carte.

logo

Affiche un logo affiché dans la bannière. Valeurs possibles : false ou lien vers un fichier jpeg ou png.

title

Titre affiché dans la bannière.

shortDescription

Description.

displayScope

docs

displayCommunexion

displayNotifications

profilBar

breadcrum

displayButtonGridList

class

mainContainer : …

iconeAdd

iconeSearchPlus

loginTitle

front

  • organization : …
  • project : …
  • event : …
  • community : …
  • dda : …
  • live : …
  • search : …
  • need : …
  • poi : …

menu

  • aroundMe" : …
  • connectLink : …
  • add : …
  • detail : …
  • filter : …
  • news : …
  • directory : …
  • gallery : …

open

filter : ouvre la barre latéral de filtre au chargement

filter

Permet de créer des filtres. Exemple de filtre :

"filter" : {
    "types" : false,
    "tags" : true, 
    "paramsFiltre" : {
        "conditionBlock" : "or",
        "conditionTagsInBlock" : "and"
    },
    "linksTag" : {
        "Se nourrir" : {
            "tagParent" : "Alimentation",
            "background-color" : "#f5f5f5",
           	"open" : true,
            "image" : "Alimentation.png",
            "tags" : {
                "Amap" : "Amap",
                "magasin de producteurs" : "MagasinDeProducteurs",
                "Groupement d'achat" : "GroupementDAchat",
            }
        }
    }
}

types

Filtre par type. Valeurs possibles : false, organizations ou events.

tags

paramsFiltre

Par défaut si on ne met pas de paramsFiltres , les tags dans un même block agissent comme des "OU" et ceux entre les blocks comme des "ET".

  • conditionBlock : permet de dĂ©finir comment agissent les tags entre les blocks
  • conditionTagsInBlock : permet de dĂ©finir comment agissent les tags dans un block

linksTag

  • tagParent : …
  • background-color : couleur de fond de …
  • open : dĂ©plie automatiquement Ă  l’ouverture de la barre latĂ©rale de filtre
  • image : logo du filtre (liste des images disponibles)
  • tags : …

add

Permet aux utilisateur·ice·s d’ajouter des Ă©lĂ©ments directement par la carte (bouton + en bas Ă  gauche). Valeurs possibles : event et/ou organization.

result

displayImage

displayType

fullLocality

datesEvent

displayShortDescription

request

sourcekey

ClĂ© fournit par Communecter pour accĂ©der aux donnĂ©es (MANDATORY). RequĂŞte transmise Ă  Communecter pour afficher des rĂ©sultats lors de l’ouverture de la carte.

pagination

Nombre de points remonté par requête.

searchType

Type de recherche dans la base de donnĂ©e communecter (MANDATORY). Liste des valeurs possibles : ‘organizations’, ‘person’, ‘poi’, ‘projects’, ‘events’.

searchTag

Optionnel Permet de filtrer la liste des points selon un ou plusieurs tags. Exemple de valeurs :

"searchTag" : [ "communs", "commun", "Commun", "Communs" ]

mainTag

Optionnel Tag principal des points remontés. Les points créés via la carte auront le tag mentionné.

searchLocalityREGION

Limite la liste des points remontés à une ou plusieurs régions. Liste des valeurs acceptées :

"ĂŽle-de-France",
"NOUVELLE-CALEDONIE",
"POLYNESIE",
"Bourgogne-Franche-Comté",
"Aquitaine-Limousin-Poitou-Charentes",
"Alsace-Champagne-Ardenne-Lorraine",
"Normandie",
"Mayotte",
"Nord-Pas-de-Calais-Picardie",
"Languedoc-Roussillon-Midi-Pyrénées",
"Provence-Alpes-CĂ´te d'Azur",
"Pays de la Loire",
"Auvergne-RhĂ´ne-Alpes",
"Guadeloupe",
"Martinique",
"Bretagne",
"Centre-Val de Loire",
"Corse",
"Guyane",
"La RĂ©union"

searchLocalityDEPARTEMENT

Limite la liste des points remontés à un ou plusieurs département. Liste des valeurs acceptées :

"ESSONNE"
"YONNE"
"TERRITOIRE DE BELFORT"
"HAUTE-VIENNE"
"VOSGES"
"VAL-D'OISE"
"SEINE-MARITIME"
"MAYOTTE"
"SEINE-ET-MARNE"
"YVELINES"
"DEUX-SEVRES"
"SOMME"
"TARN"
"TARN-ET-GARONNE"
"VAR"
"VAUCLUSE"
"VENDEE"
"VIENNE"
"PAS-DE-CALAIS"
"PUY-DE-DOME"
"PYRENEES-ATLANTIQUES"
"HAUTES-PYRENEES"
"PYRENEES-ORIENTALES"
"BAS-RHIN"
"HAUT-RHIN"
"RHONE"
"HAUTE-SAONE"
"SAONE-ET-LOIRE"
"SARTHE"
"SAVOIE"
"ISERE"
"HAUTE-SAVOIE"
"PARIS"
"GUADELOUPE"
"MARTINIQUE"
"LOT-ET-GARONNE"
"LOZERE"
"ARDECHE"
"MAINE-ET-LOIRE"
"LOIRE-ATLANTIQUE"
"MANCHE"
"MARNE"
"HAUTE-MARNE"
"MAYENNE"
"MEURTHE-ET-MOSELLE"
"MEUSE"
"MORBIHAN"
"MOSELLE"
"NIEVRE"
"NORD"
"OISE"
"ORNE"
"COTES-D'ARMOR"
"CREUSE"
"DORDOGNE"
"DOUBS"
"DROME"
"EURE"
"EURE-ET-LOIR"
"FINISTERE"
"GARD"
"HAUTE-GARONNE"
"GERS"
"GIRONDE"
"HERAULT"
"ILLE-ET-VILAINE"
"INDRE"
"INDRE-ET-LOIRE"
"JURA"
"LANDES"
"LOIR-ET-CHER"
"LOIRE"
"ALLIER"
"HAUTE-LOIRE"
"CANTAL"
"LOIRET"
"LOT"
"AIN"
"AISNE"
"ALPES-DE-HAUTE-PROVENCE"
"HAUTES-ALPES"
"ALPES-MARITIMES"
"ARDENNES"
"ARIEGE"
"AUBE"
"AUDE"
"AVEYRON"
"BOUCHES-DU-RHONE"
"CALVADOS"
"CHARENTE"
"CHARENTE-MARITIME"
"CHER"
"CORREZE"
"CORSE-DU-SUD"
"HAUTE-CORSE"
"COTE-D'OR"
"HAUTS-DE-SEINE"
"SEINE-SAINT-DENIS"
"VAL-DE-MARNE"
"GUYANE"
"REUNION"

searchLocalityNAME

Ce sont les noms des villes et non les codes postaux qu’il faut mettre.

Limite la liste des points remontés à une ou plusieurs villes. La liste des valeurs autorisée est disponible sur data.gouv.

đź“„ Network.md by @communecter

Présentation

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

Voici quelques exemples de network : Tiers-Lieux des Hauts de France, Assemblée des Communs de Lille, Restaurants vegan de la Réunion, Zéro Déchet Île de France, Bretagne Telecom.

Voir la page : utilisation des cartes pour des tutoriels utilisateurs.

Voir le canal de discussion : marque blanche si vous avez besoin d’un coup de main.

Introduction

Ce tuto existe aussi en vidéo : https://youtu.be/OOnEnxjhr-I

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

Exemple de lien complet : https://www.communecter.org/communecter?network=https://gist.githubusercontent.com/Simroubriff/3e14264620d9e59e874d44d306314679/raw/f8f013ded329d9e07e3e44666a548f974a7606c0/ZD-Paris

⚠️ Le format JSON n’autorise pas l’ajout de commentaire dans le code. Le nom de votre fichier ne doit pas contenir d’espaces.

Pour commencer, le plus simple est de copier une configuration existante puis de modifier les paramètres un à un pour éviter les erreurs.

Créer une carte personnalisée

  1. Copiez l’exemple de configuration ci-dessous dans un nouveau Gist : http://gist.github.com/
  2. Cliquez sur Raw (en haut Ă  droite de votre code)
  3. Ouvrez un nouvel onglet pour ouvrir l’URL suivante : https://www.communecter.org/communecter?network=LienDuRAW

Intégrer la carte

En ajoutant le code suivant dans une page de vos pages, vos utilisateurs pourront utiliser la carte sans quitter votre site.

<iframe src="https://www.communecter.org/communecter?network=LienDuRAW" width="100%" height="700px" frameborder="0"></iframe>

Exemple de configuration

{
    "name" : "Communs",
    "mode" : "server",
    "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"]
	}
}

Paramétrage

Vous cherchez une info sur un tag ? Utilisez le moteur de recherche de votre navigateur : Ctrl + F.

name

Titre affiché dans la bannière du haut.

mode

?

skin

Paramètres pour afficher des fonctionnalités sur la carte.

logo

Affiche un logo affiché dans la bannière. Valeurs possibles : false ou lien vers un fichier jpeg ou png.

title

Titre affiché dans la bannière.

shortDescription

Description.

displayScope

docs

displayCommunexion

displayNotifications

profilBar

breadcrum

displayButtonGridList

class

mainContainer : …

iconeAdd

iconeSearchPlus

loginTitle

front

  • organization : …
  • project : …
  • event : …
  • community : …
  • dda : …
  • live : …
  • search : …
  • need : …
  • poi : …

menu

  • aroundMe" : …
  • connectLink : …
  • add : …
  • detail : …
  • filter : …
  • news : …
  • directory : …
  • gallery : …

filter

Permet de créer des filtres. Exemple de filtre :

"filter" : {
    "types" : false,
    "tags" : true, 
    "paramsFiltre" : {
        "conditionBlock" : "or",
        "conditionTagsInBlock" : "and"
    },
    "linksTag" : {
        "Se nourrir" : {
            "tagParent" : "Alimentation",
            "background-color" : "#f5f5f5",
            "image" : "Alimentation.png",
            "tags" : {
                "Amap" : "Amap",
                "magasin de producteurs" : "MagasinDeProducteurs",
                "Groupement d'achat" : "GroupementDAchat",
            }
        }
    }
}

types

Filtre par type. Valeurs possibles : false, organizations ou events.

tags

paramsFiltre

Par défaut si on ne met pas de paramsFiltres , les tags dans un même block agissent comme des "OU" et ceux entre les blocks comme des "ET".

  • conditionBlock : permet de dĂ©finir comment agissent les tags entre les blocks
  • conditionTagsInBlock : permet de dĂ©finir comment agissent les tags dans un block

linksTag

  • tagParent : …
  • background-color : couleur de fond de …
  • image : logo du filtre
  • tags : …

add

organization

person

result

displayImage

displayType

fullLocality

datesEvent

displayShortDescription

request

sourcekey

ClĂ© fournit par Communecter pour accĂ©der aux donnĂ©es (MANDATORY). RequĂŞte transmise Ă  Communecter pour afficher des rĂ©sultats lors de l’ouverture de la carte.

pagination

Nombre de points remonté par requête.

searchType

Type de recherche dans la base de donnĂ©e communecter (MANDATORY). Liste des valeurs possibles : ‘organizations’, ‘person’, ‘poi’, ‘projects’, ‘events’.

searchTag

Permet de filtrer la liste des points selon un ou plusieurs tags. Exemple de valeurs :

"searchTag" : [ "communs", "commun", "Commun", "Communs" ]

mainTag

Tag principal des points remontés. Les points créés via la carte auront le tag mentionné.

searchLocalityREGION

Limite la liste des points remontés à une ou plusieurs régions. Liste des valeurs acceptées :

"ĂŽle-de-France"
"NOUVELLE-CALEDONIE"
"POLYNESIE"
"Bourgogne-Franche-Comté"
"Aquitaine-Limousin-Poitou-Charentes"
"Alsace-Champagne-Ardenne-Lorraine"
"Normandie"
"Mayotte"
"Nord-Pas-de-Calais-Picardie"
"Languedoc-Roussillon-Midi-Pyrénées"
"Provence-Alpes-CĂ´te d'Azur"
"Pays de la Loire"
"Auvergne-RhĂ´ne-Alpes"
"Guadeloupe"
"Martinique"
"Bretagne"
"Centre-Val de Loire"
"Corse"
"Guyane"
"La RĂ©union"

searchLocalityDEPARTEMENT

Limite la liste des points remontés à un ou plusieurs département. Liste des valeurs acceptées :

"ESSONNE"
"YONNE"
"TERRITOIRE DE BELFORT"
"HAUTE-VIENNE"
"VOSGES"
"VAL-D'OISE"
"SEINE-MARITIME"
"MAYOTTE"
"SEINE-ET-MARNE"
"YVELINES"
"DEUX-SEVRES"
"SOMME"
"TARN"
"TARN-ET-GARONNE"
"VAR"
"VAUCLUSE"
"VENDEE"
"VIENNE"
"PAS-DE-CALAIS"
"PUY-DE-DOME"
"PYRENEES-ATLANTIQUES"
"HAUTES-PYRENEES"
"PYRENEES-ORIENTALES"
"BAS-RHIN"
"HAUT-RHIN"
"RHONE"
"HAUTE-SAONE"
"SAONE-ET-LOIRE"
"SARTHE"
"SAVOIE"
"ISERE"
"HAUTE-SAVOIE"
"PARIS"
"GUADELOUPE"
"MARTINIQUE"
"LOT-ET-GARONNE"
"LOZERE"
"ARDECHE"
"MAINE-ET-LOIRE"
"LOIRE-ATLANTIQUE"
"MANCHE"
"MARNE"
"HAUTE-MARNE"
"MAYENNE"
"MEURTHE-ET-MOSELLE"
"MEUSE"
"MORBIHAN"
"MOSELLE"
"NIEVRE"
"NORD"
"OISE"
"ORNE"
"COTES-D'ARMOR"
"CREUSE"
"DORDOGNE"
"DOUBS"
"DROME"
"EURE"
"EURE-ET-LOIR"
"FINISTERE"
"GARD"
"HAUTE-GARONNE"
"GERS"
"GIRONDE"
"HERAULT"
"ILLE-ET-VILAINE"
"INDRE"
"INDRE-ET-LOIRE"
"JURA"
"LANDES"
"LOIR-ET-CHER"
"LOIRE"
"ALLIER"
"HAUTE-LOIRE"
"CANTAL"
"LOIRET"
"LOT"
"AIN"
"AISNE"
"ALPES-DE-HAUTE-PROVENCE"
"HAUTES-ALPES"
"ALPES-MARITIMES"
"ARDENNES"
"ARIEGE"
"AUBE"
"AUDE"
"AVEYRON"
"BOUCHES-DU-RHONE"
"CALVADOS"
"CHARENTE"
"CHARENTE-MARITIME"
"CHER"
"CORREZE"
"CORSE-DU-SUD"
"HAUTE-CORSE"
"COTE-D'OR"
"HAUTS-DE-SEINE"
"SEINE-SAINT-DENIS"
"VAL-DE-MARNE"
"GUYANE"
"REUNION"

searchLocalityNAME

Limite la liste des points remontés à une ou plusieurs villes. La liste des valeurs autorisée est disponible ici : https://www.data.gouv.fr/fr/datasets/base-officielle-des-codes-postaux/

đź“„ network.md by @communecter

Créer un network

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.

Tous les networks sont liĂ©es par la base de donnĂ©es mutualisĂ©e, qui est commune. Par contre chaque carte ne montre que l’information relative Ă  un contexte. Dans le schĂ©ma ci-dessous on constate que certaines cartes affichent tout ou partie des donnĂ©es dĂ©jĂ  visibles sur d’autres cartes (ex : une carte zĂ©ro dĂ©chet locale permet de visualiser qu’une partie des donnĂ©es de la carte nationale). Si on ajoute un commerce zĂ©ro dĂ©chet via communecter.org, la carte nationale ou la carte locale, toutes ces cartes le verront apparaĂ®tre automatiquement.

Voici quelques exemples de network : Tiers-Lieux des Hauts de France, AssemblĂ©e des Communs de Lille, ZĂ©ro DĂ©chet ĂŽle de France ainsi qu’un article expliquant la dĂ©marche, Bretagne Telecom, l&#8217;ESS Ă  la RĂ©union, Protection animale Ă  La RĂ©union et une cartographie de compĂ©tences.

Voir la page : [utilisation des cartes](/2 - Utiliser l’outil/FonctionnalitĂ©s/cartes.md) pour des tutoriels utilisateurs. Voir le canal de discussion #co_network si vous avez besoin d’un coup de main.

Introduction

L’adresse d’une carte commence par https://www.communecter.org/network/default/index?src= suivi d’un lien vers un fichier contenant les diffĂ©rents paramètres de la carte (nom, filtres, limites gĂ©ographiques, etc.). Ce fichier peut ĂŞtre hĂ©bergĂ© sur votre site ou sur un site tierce (pour ce tuto nous utiliserons Gist).

Exemple de lien complet : https://www.communecter.org/network/default/index?src=https://gist.github.com/Drakone/c9b890500107f9703fb3a6a8eae0d164/raw/essreunion.json

Le format JSON n’autorise pas l’ajout de commentaire dans le code. Le nom de votre fichier ne doit pas contenir d’espaces.

Pour commencer, le plus simple est de copier une configuration existante puis de modifier les paramètres un à un pour éviter les erreurs.

Créer une carte personnalisée

Nouveau : il sera bientĂ´t possible de gĂ©nĂ©rer une carte via un simple formulaire directement depuis l’interface de Communecter.

  1. Copiez l’exemple de configuration ci-dessous dans un nouveau gist.github.com. Inscription obligatoire mais gratuite.
  2. Cliquez sur Raw (en haut Ă  droite de votre code)
  3. Ouvrez un nouvel onglet pour ouvrir l’URL suivante : https://www.communecter.org/network/default/index?src=LienDuRAW

Astuces

  • Si vous ne souhaitez pas que l’URL change Ă  chaque modification des paramètres, utilisez ce format d’URL : https://gist.github.com/[votre_pseudo_gist]/[id_du_gist]/raw/[nom_du_fichier]
  • Utilisez frama.link pour raccourcir vos URL

Intégrer la carte

En ajoutant le code suivant dans une page, vos utilisateurs pourront utiliser la carte sans quitter votre site.

<iframe src="https://www.communecter.org/network/default/index?src=LienDuRAW" width="100%" height="700px" frameborder="0"></iframe>

Paramétrage

Ctrl + F pour utilisez le moteur de recherche de votre navigateur.

name

Titre affiché dans la bannière du haut.

mode

?

skin

Paramètres pour afficher des fonctionnalités sur la carte.

logo

Affiche un logo affiché dans la bannière. Valeurs possibles : false ou lien vers un fichier jpeg ou png.

title

Titre affiché dans la bannière.

shortDescription

Description.

displayScope

docs

displayCommunexion

displayNotifications

profilBar

breadcrum

displayButtonGridList

class

mainContainer : …

iconeAdd

iconeSearchPlus

loginTitle

front

  • organization : …
  • project : …
  • event : …
  • community : …
  • dda : …
  • live : …
  • search : …
  • need : …
  • poi : …

menu

  • aroundMe" : …
  • connectLink : …
  • add : …
  • detail : …
  • filter : …
  • news : …
  • directory : …
  • gallery : …

open

filter : ouvre la barre latéral de filtre au chargement

filter

Permet de créer des filtres. Exemple de filtre :

"filter" : {
    "types" : false,
    "tags" : true, 
    "paramsFiltre" : {
        "conditionBlock" : "or",
        "conditionTagsInBlock" : "and"
    },
    "linksTag" : {
        "Se nourrir" : {
            "tagParent" : "Alimentation",
            "background-color" : "#f5f5f5",
           	"open" : true,
            "image" : "Alimentation.png",
            "tags" : {
                "Amap" : "Amap",
                "magasin de producteurs" : "MagasinDeProducteurs",
                "Groupement d'achat" : "GroupementDAchat",
            }
        }
    }
}

types

Filtre par type. Valeurs possibles : false, organizations ou events.

tags

paramsFiltre

Par défaut si on ne met pas de paramsFiltres , les tags dans un même block agissent comme des "OU" et ceux entre les blocks comme des "ET".

  • conditionBlock : permet de dĂ©finir comment agissent les tags entre les blocks
  • conditionTagsInBlock : permet de dĂ©finir comment agissent les tags dans un block

linksTag

  • tagParent : …
  • background-color : couleur de fond de …
  • open : dĂ©plie automatiquement Ă  l’ouverture de la barre latĂ©rale de filtre
  • image : logo du filtre (liste des images disponibles)
  • tags : …

add

Permet aux utilisateur·ice·s d’ajouter des Ă©lĂ©ments directement par la carte (bouton + en bas Ă  gauche). Valeurs possibles : event et/ou organization.

result

displayImage

displayType

fullLocality

datesEvent

displayShortDescription

request

sourcekey

ClĂ© fournit par Communecter pour accĂ©der aux donnĂ©es (MANDATORY). RequĂŞte transmise Ă  Communecter pour afficher des rĂ©sultats lors de l’ouverture de la carte.

pagination

Nombre de points remonté par requête.

searchType

Type de recherche dans la base de donnĂ©e communecter (MANDATORY). Liste des valeurs possibles : ‘organizations’, ‘person’, ‘poi’, ‘projects’, ‘events’.

searchTag

Optionnel Permet de filtrer la liste des points selon un ou plusieurs tags. Exemple de valeurs :

"searchTag" : [ "communs", "commun", "Commun", "Communs" ]

mainTag

Optionnel Tag principal des points remontés. Les points créés via la carte auront le tag mentionné.

searchLocalityREGION

Limite la liste des points remontés à une ou plusieurs régions. Liste des valeurs acceptées :

"ĂŽle-de-France",
"NOUVELLE-CALEDONIE",
"POLYNESIE",
"Bourgogne-Franche-Comté",
"Aquitaine-Limousin-Poitou-Charentes",
"Alsace-Champagne-Ardenne-Lorraine",
"Normandie",
"Mayotte",
"Nord-Pas-de-Calais-Picardie",
"Languedoc-Roussillon-Midi-Pyrénées",
"Provence-Alpes-CĂ´te d'Azur",
"Pays de la Loire",
"Auvergne-RhĂ´ne-Alpes",
"Guadeloupe",
"Martinique",
"Bretagne",
"Centre-Val de Loire",
"Corse",
"Guyane",
"La RĂ©union"

searchLocalityDEPARTEMENT

Limite la liste des points remontés à un ou plusieurs département. Liste des valeurs acceptées :

"ESSONNE"
"YONNE"
"TERRITOIRE DE BELFORT"
"HAUTE-VIENNE"
"VOSGES"
"VAL-D'OISE"
"SEINE-MARITIME"
"MAYOTTE"
"SEINE-ET-MARNE"
"YVELINES"
"DEUX-SEVRES"
"SOMME"
"TARN"
"TARN-ET-GARONNE"
"VAR"
"VAUCLUSE"
"VENDEE"
"VIENNE"
"PAS-DE-CALAIS"
"PUY-DE-DOME"
"PYRENEES-ATLANTIQUES"
"HAUTES-PYRENEES"
"PYRENEES-ORIENTALES"
"BAS-RHIN"
"HAUT-RHIN"
"RHONE"
"HAUTE-SAONE"
"SAONE-ET-LOIRE"
"SARTHE"
"SAVOIE"
"ISERE"
"HAUTE-SAVOIE"
"PARIS"
"GUADELOUPE"
"MARTINIQUE"
"LOT-ET-GARONNE"
"LOZERE"
"ARDECHE"
"MAINE-ET-LOIRE"
"LOIRE-ATLANTIQUE"
"MANCHE"
"MARNE"
"HAUTE-MARNE"
"MAYENNE"
"MEURTHE-ET-MOSELLE"
"MEUSE"
"MORBIHAN"
"MOSELLE"
"NIEVRE"
"NORD"
"OISE"
"ORNE"
"COTES-D'ARMOR"
"CREUSE"
"DORDOGNE"
"DOUBS"
"DROME"
"EURE"
"EURE-ET-LOIR"
"FINISTERE"
"GARD"
"HAUTE-GARONNE"
"GERS"
"GIRONDE"
"HERAULT"
"ILLE-ET-VILAINE"
"INDRE"
"INDRE-ET-LOIRE"
"JURA"
"LANDES"
"LOIR-ET-CHER"
"LOIRE"
"ALLIER"
"HAUTE-LOIRE"
"CANTAL"
"LOIRET"
"LOT"
"AIN"
"AISNE"
"ALPES-DE-HAUTE-PROVENCE"
"HAUTES-ALPES"
"ALPES-MARITIMES"
"ARDENNES"
"ARIEGE"
"AUBE"
"AUDE"
"AVEYRON"
"BOUCHES-DU-RHONE"
"CALVADOS"
"CHARENTE"
"CHARENTE-MARITIME"
"CHER"
"CORREZE"
"CORSE-DU-SUD"
"HAUTE-CORSE"
"COTE-D'OR"
"HAUTS-DE-SEINE"
"SEINE-SAINT-DENIS"
"VAL-DE-MARNE"
"GUYANE"
"REUNION"

searchLocalityNAME

Ce sont les noms des villes et non les codes postaux qu’il faut mettre.

Limite la liste des points remontés à une ou plusieurs villes. La liste des valeurs autorisée est disponible sur data.gouv.

đź“„ Network.md by @communecter

Présentation

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

Voici quelques exemples de network : Tiers-Lieux des Hauts de France, Assemblée des Communs de Lille, Restaurants vegan de la Réunion, Zéro Déchet Île de France, Bretagne Telecom.

Voir la page : utilisation des cartes pour des tutoriels utilisateurs.

Voir le canal de discussion : marque blanche si vous avez besoin d’un coup de main.

Introduction

Ce tuto existe aussi en vidéo : https://youtu.be/OOnEnxjhr-I

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

Exemple de lien complet : https://www.communecter.org/communecter?network=https://gist.githubusercontent.com/Simroubriff/3e14264620d9e59e874d44d306314679/raw/f8f013ded329d9e07e3e44666a548f974a7606c0/ZD-Paris

⚠️ Le format JSON n’autorise pas l’ajout de commentaire dans le code. Le nom de votre fichier ne doit pas contenir d’espaces.

Pour commencer, le plus simple est de copier une configuration existante puis de modifier les paramètres un à un pour éviter les erreurs.

Créer une carte personnalisée

  1. Copiez l’exemple de configuration ci-dessous dans un nouveau Gist : http://gist.github.com/
  2. Cliquez sur Raw (en haut Ă  droite de votre code)
  3. Ouvrez un nouvel onglet pour ouvrir l’URL suivante : https://www.communecter.org/communecter?network=LienDuRAW

Intégrer la carte

En ajoutant le code suivant dans une page de vos pages, vos utilisateurs pourront utiliser la carte sans quitter votre site.

<iframe src="https://www.communecter.org/communecter?network=LienDuRAW" width="100%" height="700px" frameborder="0"></iframe>

Exemple de configuration

{
    "name" : "Communs",
    "mode" : "server",
    "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"]
	}
}

Paramétrage

Vous cherchez une info sur un tag ? Utilisez le moteur de recherche de votre navigateur : Ctrl + F.

name

Titre affiché dans la bannière du haut.

mode

?

skin

Paramètres pour afficher des fonctionnalités sur la carte.

logo

Affiche un logo affiché dans la bannière. Valeurs possibles : false ou lien vers un fichier jpeg ou png.

title

Titre affiché dans la bannière.

shortDescription

Description.

displayScope

docs

displayCommunexion

displayNotifications

profilBar

breadcrum

displayButtonGridList

class

mainContainer : …

iconeAdd

iconeSearchPlus

loginTitle

front

  • organization : …
  • project : …
  • event : …
  • community : …
  • dda : …
  • live : …
  • search : …
  • need : …
  • poi : …

menu

  • aroundMe" : …
  • connectLink : …
  • add : …
  • detail : …
  • filter : …
  • news : …
  • directory : …
  • gallery : …

filter

Permet de créer des filtres. Exemple de filtre :

"filter" : {
    "types" : false,
    "tags" : true, 
    "paramsFiltre" : {
        "conditionBlock" : "or",
        "conditionTagsInBlock" : "and"
    },
    "linksTag" : {
        "Se nourrir" : {
            "tagParent" : "Alimentation",
            "background-color" : "#f5f5f5",
            "image" : "Alimentation.png",
            "tags" : {
                "Amap" : "Amap",
                "magasin de producteurs" : "MagasinDeProducteurs",
                "Groupement d'achat" : "GroupementDAchat",
            }
        }
    }
}

types

Filtre par type. Valeurs possibles : false, organizations ou events.

tags

paramsFiltre

Par défaut si on ne met pas de paramsFiltres , les tags dans un même block agissent comme des "OU" et ceux entre les blocks comme des "ET".

  • conditionBlock : permet de dĂ©finir comment agissent les tags entre les blocks
  • conditionTagsInBlock : permet de dĂ©finir comment agissent les tags dans un block

linksTag

  • tagParent : …
  • background-color : couleur de fond de …
  • image : logo du filtre
  • tags : …

add

organization

person

result

displayImage

displayType

fullLocality

datesEvent

displayShortDescription

request

sourcekey

ClĂ© fournit par Communecter pour accĂ©der aux donnĂ©es (MANDATORY). RequĂŞte transmise Ă  Communecter pour afficher des rĂ©sultats lors de l’ouverture de la carte.

pagination

Nombre de points remonté par requête.

searchType

Type de recherche dans la base de donnĂ©e communecter (MANDATORY). Liste des valeurs possibles : ‘organizations’, ‘person’, ‘poi’, ‘projects’, ‘events’.

searchTag

Permet de filtrer la liste des points selon un ou plusieurs tags. Exemple de valeurs :

"searchTag" : [ "communs", "commun", "Commun", "Communs" ]

mainTag

Tag principal des points remontés. Les points créés via la carte auront le tag mentionné.

searchLocalityREGION

Limite la liste des points remontés à une ou plusieurs régions. Liste des valeurs acceptées :

"ĂŽle-de-France"
"NOUVELLE-CALEDONIE"
"POLYNESIE"
"Bourgogne-Franche-Comté"
"Aquitaine-Limousin-Poitou-Charentes"
"Alsace-Champagne-Ardenne-Lorraine"
"Normandie"
"Mayotte"
"Nord-Pas-de-Calais-Picardie"
"Languedoc-Roussillon-Midi-Pyrénées"
"Provence-Alpes-CĂ´te d'Azur"
"Pays de la Loire"
"Auvergne-RhĂ´ne-Alpes"
"Guadeloupe"
"Martinique"
"Bretagne"
"Centre-Val de Loire"
"Corse"
"Guyane"
"La RĂ©union"

searchLocalityDEPARTEMENT

Limite la liste des points remontés à un ou plusieurs département. Liste des valeurs acceptées :

"ESSONNE"
"YONNE"
"TERRITOIRE DE BELFORT"
"HAUTE-VIENNE"
"VOSGES"
"VAL-D'OISE"
"SEINE-MARITIME"
"MAYOTTE"
"SEINE-ET-MARNE"
"YVELINES"
"DEUX-SEVRES"
"SOMME"
"TARN"
"TARN-ET-GARONNE"
"VAR"
"VAUCLUSE"
"VENDEE"
"VIENNE"
"PAS-DE-CALAIS"
"PUY-DE-DOME"
"PYRENEES-ATLANTIQUES"
"HAUTES-PYRENEES"
"PYRENEES-ORIENTALES"
"BAS-RHIN"
"HAUT-RHIN"
"RHONE"
"HAUTE-SAONE"
"SAONE-ET-LOIRE"
"SARTHE"
"SAVOIE"
"ISERE"
"HAUTE-SAVOIE"
"PARIS"
"GUADELOUPE"
"MARTINIQUE"
"LOT-ET-GARONNE"
"LOZERE"
"ARDECHE"
"MAINE-ET-LOIRE"
"LOIRE-ATLANTIQUE"
"MANCHE"
"MARNE"
"HAUTE-MARNE"
"MAYENNE"
"MEURTHE-ET-MOSELLE"
"MEUSE"
"MORBIHAN"
"MOSELLE"
"NIEVRE"
"NORD"
"OISE"
"ORNE"
"COTES-D'ARMOR"
"CREUSE"
"DORDOGNE"
"DOUBS"
"DROME"
"EURE"
"EURE-ET-LOIR"
"FINISTERE"
"GARD"
"HAUTE-GARONNE"
"GERS"
"GIRONDE"
"HERAULT"
"ILLE-ET-VILAINE"
"INDRE"
"INDRE-ET-LOIRE"
"JURA"
"LANDES"
"LOIR-ET-CHER"
"LOIRE"
"ALLIER"
"HAUTE-LOIRE"
"CANTAL"
"LOIRET"
"LOT"
"AIN"
"AISNE"
"ALPES-DE-HAUTE-PROVENCE"
"HAUTES-ALPES"
"ALPES-MARITIMES"
"ARDENNES"
"ARIEGE"
"AUBE"
"AUDE"
"AVEYRON"
"BOUCHES-DU-RHONE"
"CALVADOS"
"CHARENTE"
"CHARENTE-MARITIME"
"CHER"
"CORREZE"
"CORSE-DU-SUD"
"HAUTE-CORSE"
"COTE-D'OR"
"HAUTS-DE-SEINE"
"SEINE-SAINT-DENIS"
"VAL-DE-MARNE"
"GUYANE"
"REUNION"

searchLocalityNAME

Limite la liste des points remontés à une ou plusieurs villes. La liste des valeurs autorisée est disponible ici : https://www.data.gouv.fr/fr/datasets/base-officielle-des-codes-postaux/

Loading pushes...

Rendering context...