COG : Toutes les communes, départements, régions ... françaises

Installation téléchargement et intégration des données

Installation du plugin
Pour installer le plugin COG, ce n’est pas différents des autres plugins. Pour ce qui n’ont jamais installer de plugin SPIP, référez vous à cet article https://www.spip.net/fr_article3396.html

Une fois installé, il est toujours bon d’aller jeter un coup d’œil au panneau de configuration CFG de COG.

Téléchargement des données

Le plugin ne comprenant pas les données, il faut les télécharger sur le site de l’INSEE.
Pour vous simplifier la tâche, le plugin comprends un formulaire pour charger les données nécessaires directement à la partir de l’espace privé de votre site SPIP.
Il vous faut aller sur la page importation, vous trouverez le formulaire téléchargement des données du site INSEE. Choisissez la délimitations administratives qui vous intéressent et cliquer sur « télécharger »

Attention : Au préalable au téléchargement, il vous faut vérifier que votre répertoire de stockage des données défini dans la configuration est autorisé en écriture.

Intégration des données

Une fois, le ou les fichiers, vous pouvez procéder à l’intégration des ces données dans les tables de votre base de donnée.
Un formulaire simple vous permet de faire cet opération, il se trouve en toute logique sur la page « importation des données ».
4 champs sont renseignés,
-  La liste déroulante des délimitations administratives à importer
-  La case à cocher «  » pour éventuellement effacer tout le contenu de la table à importer
-  La case à cocher «  » pour mettre à jour les informations d’un code déjà existant dans la base.
-  un champ ’Filtrer les données’ qui permet de restreindre les données importées

Filtrer les données importées

Exemple : Vous ne souhaitez importer dans votre base que les villes du département Nord
Il vous suffit de renseigner le champs filtre avec la formule
departement=59

Visualiser les données dans l’espace privé.

Vous voulez visualiser les données présentes dans votre base de données.
Si vous êtes avec une SPIP v2.1, il vous faut installer le plugin Tabledata

Une fois tabledata installé vous pourrez ajouter,modifier et supprimer et alors voir apparaite comme par enchantement des raccourcis dans la liste des tables présentes.

Des boucles et critères supplémentaires

De nombreuses boucles sont donc ajoutée

La boucle COMMUNES

Exemple pour la boucle communes
D’autres exemples sont disponible dans le

<B_c>
Nombre total de commune : #GRAND_TOTAL
<table class="spip" width="100%">
	<thead>
	<tr class="row_first">
		<th><:cog:code_insee:></th>
		<th><:cog:ville_nom_article:></th>
		<th><:cog:nom_article:></th>
		<th><:cog:nom:></th>
		<th><:cog:nom_majuscule:></th>
		<th><:cog:region:></th>
		<th><:cog:departement:></th>
		<th><:cog:arrondissement:></th>
		<th><:cog:canton:></th>
		<th><:cog:decoupage_cantons:></th>
		<th><:cog:chef_lieu:></th>
	</tr>
	</thead>
	<tbody>
	<BOUCLE_c(COG_COMMUNES){par nom}{pagination 50}>
	<tr[ class="(#COMPTEUR_BOUCLE|alterner{'row_odd','row_even'})"]>
		<td>#DEPARTEMENT#CODE</td>
		<td>La ville de #NOM</td>
		<td>#ARTICLE #NOM</td>
		<td>#NOM</td>
		<td>#ARTICLE</td>
		<td>#ARTICLE_MAJUSCULE #NOM_MAJUSCULE</td>
		<td>#REGION</td>
		<td>#DEPARTEMENT</td>
		<td>#ARRONDISSEMENT</td>
		<td>#CANTON</td>
		<td>#DECOUPAGE_CANTONS</td>
		<td>[(#CHEF_LIEU|=={1}|oui) est le chef lieu]</td>
	</tr>
	</BOUCLE_c>
	</tbody>
</table>
</B_c>
<p>Encore aucune commune n'a été importé dans la base.</p>
<//B_c>

Le coin des développeurs

Hack

Exploitation des liaisons communale dans le moteur de recherche

Vous êtes en SPIP 2.0 ou SPIP 2.1, vous avez attacher à de nombreux articles de votre site à des villes, vous souhaitez que lorsque qu’un internaute taper dans le moteur de recherche le nom d’une ville, il se retrouve avec la liste de tout les article attaché à cette ville. Ce n’est pas très compliqué, il faut jute faire un petit hack
Tout d’abord, il vous faut ajouter un pipeline au plug COG
Dans le fichier plugin.xml, ajouter :

	 <pipeline>
		<nom>rechercher_liste_des_jointures</nom>
		<inclure>cog_pipeline.php</inclure>
	</pipeline>

Ensuite dans le fichier cog_pipeline.php, ajouter la fonction :

	function cog_rechercher_liste_des_jointures($tables) {
		$tables['article']['cog_commune']['nom'] = 2;
		return $tables;
	}

Pour finir, si vous utilisez le plugins Fulltext, ajouter les deux fonctions présentent dans le fichier inc/cog_recherche_to_array.php dans le fichier cog_fonctions.php
sinon
renommer le fichier inc/cog_rechercher.php en inc/rechercher.php, vous activer de cette manière la surcharge du fichier rechercher.php présent dans ecrire/inc