Updated Network (markdown) authored by Tom's avatar Tom
#Tutoriels vidéo de prise en main
### 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, ...). 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).
1. Découverte de l’interface de navigation de la carte Communecter (sans compte): https://youtu.be/XcuYgWg5zj0
Grâce à ce tutoriel vous serez en mesure d'utiliser une carte et de créer la votre.
2. Créer un compte Communecter via module network: https://youtu.be/hK5JaYYj0KA
3. Ajout d'une organisation: https://youtu.be/DTuzy7bWo-0
***
4. Modifier une fiche: https://youtu.be/fqt_fkV0Mfo
### Découverte de l’interface de navigation
*En vidéo : https://youtu.be/XcuYgWg5zj0*
5. Créer une carte personnalisée: https://youtu.be/OOnEnxjhr-I
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éation d'un module Network personnalisé
### Créer un compte Communecter via le module network
*En vidéo : https://youtu.be/hK5JaYYj0KA*
Exemple d'utilisation du module network:
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.
https://github.com/pixelhumain/pixelhumain/tree/master/ph/themes/network/views/layouts/params
### Ajouter une organisation
*En vidéo : https://youtu.be/DTuzy7bWo-0*
On édite le fichier json sous gist : http://gist.github.com/
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.
On peut ensuite passer la paramètres en complétant https://www.communecter.org/?network=
### Modifier une fiche
*En vidéo : https://youtu.be/fqt_fkV0Mfo*
* soit en utilisant rawgit
* soit en utilisant directement la fonction "raw" de gist (utile pour le déboggage)
## Exemples
https://www.communecter.org/?network=https://gist.githubusercontent.com/SimonSarazin/1077a5eab3f422372f8af7815ccad56e/raw/ee1bee2dc026e362d977149560d73c40ba5f3aa7/communslille
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.
L'onglet "historique" vous permet de connaître la date, l'auteur et la teneur exacte de chaque modification.
## COMPOSITION DU JSON NETWORK
### Header
//Nom de la carte afficher dans la banniere du haut
***
```
"name" : "BretagneTelecomIlletVilaine",
```
```
"mode" : "server",
```
### Créer une carte personnalisée
*En vidéo : https://youtu.be/OOnEnxjhr-I*
// Pour ajouter son logo :
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).
Exemple de lien complet : `https://www.communecter.org/communecter?network=https://gist.githubusercontent.com/Simroubriff/3e14264620d9e59e874d44d306314679/raw/f8f013ded329d9e07e3e44666a548f974a7606c0/ZD-Paris`
> Note : Le format JSON n’autorise pas l’ajout de commentaire dans le code.
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`.
Fichier type
Ajouter le code complet ici.
Détail des paramètres
En-tête
"name" : "BretagneTelecomIlletVilaine",
"mode" : "server",
"logo" : "http://monsite.ext/mel.png",
```
//Parametres pour afficher des fonctionnalités sur la carte.
Fonctionnalités
```
"skin" : {
"logo" : false,
"title" : false,
......@@ -61,8 +75,6 @@ https://www.communecter.org/?network=https://gist.githubusercontent.com/SimonSar
"iconeSearchPlus" : false,
"loginTitle":""
},
```
### Filtrage dans la carte
......@@ -137,12 +149,12 @@ paramsFiltre : { conditionBlock : "and" | "or" , conditionTagsInBlock : "and" |
La liste des régions à utiliser est ci dessous. C'est à suivre à la lettre pour que cela fonctionne.
//Filtrer par département :
Filtrer par département
```
"searchLocalityDEPARTEMENT" : ["ISERE"],
```
//Filtrer par Ville :
Filtrer par Ville :
...
"searchLocalityNAME" : ["LYON"],
```
......@@ -275,11 +287,3 @@ La liste des Département à utiliser est ci dessous.
- "VAL-DE-MARNE"
- "GUYANE"
- "REUNION"
\ No newline at end of file
# Liste des Networks existants :
- Communs dans la région Hauts de France : https://www.communecter.org/?network=https://gist.githubusercontent.com/SimonSarazin/1077a5eab3f422372f8af7815ccad56e/raw/ee1bee2dc026e362d977149560d73c40ba5f3aa7/communslille
- Pratiques collaboratives bretonnes : https://www.communecter.org/?network=BretagneTelecom