Skip to content

Network Create a Map

Stephan Schildberg edited this page Jan 18, 2018 · 2 revisions

French translation: Network Créer une carte

Presentation

A network is a map exploiting the database of Communecter. It allows to display all the points corresponding to a tag (for example : #CSA, #Culture, #Energy, ...) on a defined perimeter (for example : several regions or a single city).

Here are some examples of 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 and a article explaining the approach

You can find a list of sample files : https://github.com/pixelhumain/pixelhumain/tree/master/ph/themes/network/views/layouts/params

See the page : use of cards for user tutorials.

View the discussion channel : #marqueblanche if you need a helping hand.

Introduction

This tutorial also exists in video : https://youtu.be/OOnEnxjhr-I

The address of a map starts with https://www.communecter.org/network/default/index?src= followed by a link to a JSON file containing the various parameters of the card (name, filters, geographic boundaries, etc.). This file can be hosted on your site or on a third-party site (for this tutorial we will use Gist).

Example of complete link : https://www.communecter.org/network/default/index?src=https://gist.githubusercontent.com/Simroubriff/3e14264620d9e59e874d44d306314679/raw/f8f013ded329d9e07e3e44666a548f974a7606c0/ZD-Paris

⚠️ JSON does not allow adding comment in code. The name of your file must not contain spaces.

To start, the easiest way is to copy an existing configuration and then modify the parameters one by one to avoid errors.

Create a custom map

  1. Copy the sample configuration below into a new Gist : http://gist.github.com/
  2. Click Raw (top right of your code)
  3. Open a new tab to open the following URL : https://www.communecter.org/network/default/index?src=LienDuRAW

Embed the map

By adding the following code to a page of your pages, your users will be able to use the map without leaving your site.

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

Example 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"]
	}
}

Setting

Ctrl + F to use your browser's search engine.

name

Title displayed in the top banner.

mode

?

skin

Settings to view features on the map.

logo

Displays a logo displayed in the banner. Possible values : false or link to a file jpeg or png.

title

Title displayed in the banner.

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

Creates filters. Filter example :

"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

Filter by type. Possible values : false, organizations or events.

tags

paramsFiltre

By default if you do not set paramsFilters , the tags in the same block act as "OR" and those between blocks as "AND".

  • conditionBlock : allows you to define how tags interact between blocks
  • conditionTagsInBlock : allows you to define how tags behave in a block

linksTag

  • tagParent : ...
  • background-color : background color of ...
  • image : filter logo
  • tags : ...

add

organization

person

result

displayImage

displayType

fullLocality

datesEvent

displayShortDescription

request

sourcekey

Key provided by Communecter to access data (MANDATORY). Query passed to Communecter to display results when opening the map.

pagination

Number of points raised per request.

searchType

Type of search in the database of Communecter (MANDATORY). List of possible values : 'organizations', 'person', 'poi', 'projects', 'events'.

searchTag

Allows to filter the list of points according to one or more tags. Example values :

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

mainTag

Main tag of the remounted points. Points created via the card will have the mentioned tag.

searchLocalityREGION

Limit the list of points to one or more regions. List of accepted values :

"Î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

Limits the list of points returned to one or more departments. List of accepted values :

"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

Limit the list of points to one or more cities. The list of authorized values is available here : https://www.data.gouv.fr/fr/datasets/base-officielle-des-codes-postaux/

Clone this wiki locally