Cartoweb Community

fr:menu

yves — Thu, 05 Aug 2010 18:58:56 +0100

1280054222		current
Line 2:		Line 2:
	* [[fr:articles:start\|Articles]]		* [[fr:articles:start\|Articles]]
	* [[fr:documentation:start\|Documentation]]		* [[fr:documentation:start\|Documentation]]
-	* [[http://www.portailsig.org/faq/cartoweb_3/\|FAQ]]	+	* [[http://www.portailsig.org/content/faq-cartoweb\|FAQ]]
	* [[fr:modules:start\|Modules]]		* [[fr:modules:start\|Modules]]
	* [[fr:templates:start\|Modèles]]		* [[fr:templates:start\|Modèles]]

id:plugins:start - new version : 0.93

loicdevaux — Sat, 16 May 2009 19:17:30 +0100

1242492451		current
Line 12:		Line 12:
	* menampilkan titik, garis dan poligon sebagai placemark Google Earth including metadata.		* menampilkan titik, garis dan poligon sebagai placemark Google Earth including metadata.
	* menampilkan layer mapserver kedalam Google Earth sebagai layer WMS. Layer WMS akan terbarui sesuai dengan navigasi yang terdapat didalam Google Earth.		* menampilkan layer mapserver kedalam Google Earth sebagai layer WMS. Layer WMS akan terbarui sesuai dengan navigasi yang terdapat didalam Google Earth.
-	* menampilkan data kedalam OpenLayers/Google Maps/Google Earth Plug-in/Yahoo Maps/Virtual Earth.	+	* menampilkan data kedalam OpenLayers/Google Maps/Google Earth Plug-in/Yahoo Maps/Virtual Earth ( + geoRSS , + geoJSON )
	* data yang diekspor kedalam KML dapat ditampilkan secara penuh atau sebagian dengan menggunakan fungsi query CartoWeb.		* data yang diekspor kedalam KML dapat ditampilkan secara penuh atau sebagian dengan menggunakan fungsi query CartoWeb.

en:plugins:start - version 0.93 released

loicdevaux — Sat, 16 May 2009 19:16:52 +0100

1242489666		current
Line 13:		Line 13:
	* view each point , line, polygon as a placemark in Google Earth including metadata		* view each point , line, polygon as a placemark in Google Earth including metadata
	* view each mapserver layer inside Google Earth as a WMS layer. The WMS layer gets refreshed according to navigation inside Google Earth (Network links)		* view each mapserver layer inside Google Earth as a WMS layer. The WMS layer gets refreshed according to navigation inside Google Earth (Network links)
-	* view all the above listed data inside OpenLayers, Google Maps/Google Earth Plug-in, Virtual Earth, Yahoo Maps	+	* view all the above listed data inside OpenLayers, Google Maps/Google Earth Plug-in, Virtual Earth, Yahoo Maps and export to geoRSS and geoJSON format
	* the data exported to KML can be the full extent or a selection using cartoweb's querying features.		* the data exported to KML can be the full extent or a selection using cartoweb's querying features.
	\\		\\

fr:modules:start - sortie de la version 0.93

loicdevaux — Sat, 16 May 2009 19:16:19 +0100

1242488714		current
Line 16:		Line 16:
	* visualiser chaque couche MapServer dans Google Earth en tant que couche WMS. La couche WMS est rafraichie en fonction de la navigation dans Google Earth (Network links)		* visualiser chaque couche MapServer dans Google Earth en tant que couche WMS. La couche WMS est rafraichie en fonction de la navigation dans Google Earth (Network links)

-	* visualiser toutes les données mentionnées précédemment dans OpenLayers, Google Maps, Virtual Earth, Yahoo Maps et Google Earth Plug-in	+	* visualiser toutes les données mentionnées précédemment dans OpenLayers, Google Maps, Virtual Earth, Yahoo Maps et Google Earth Plug-in ainsi qu'en geoRSS et geoJSON

	\\		\\

fr:documentation:doc_officiel:version3.5:requetes

simon — Wed, 11 Feb 2009 12:28:32 +0100

1234351712		current
Line 76:		Line 76:
	* "query_returned_attributes" "attribute1 attribute2" : les noms (séparés par des espaces) des champs renvoyés par une requête. Si non définis, tous les champs sont renvoyés. Attention : ils sont sensibles à la case.		* "query_returned_attributes" "attribute1 attribute2" : les noms (séparés par des espaces) des champs renvoyés par une requête. Si non définis, tous les champs sont renvoyés. Attention : ils sont sensibles à la case.
	* "hilight_use_logical_expressions" "true"/"false" : définissez la à true si vous utilisez une couche pour la mise en valeur (en utilisant la convention //votrecouche_hilight//) et que vous voulez préserver votre expression dans la couche de mise en valeur pour mettre en valeur les objets. IMPORTANT : vous devez définir cette métadonnées dans la couche de mise en valeur, pas dans la couche originelle.		* "hilight_use_logical_expressions" "true"/"false" : définissez la à true si vous utilisez une couche pour la mise en valeur (en utilisant la convention //votrecouche_hilight//) et que vous voulez préserver votre expression dans la couche de mise en valeur pour mettre en valeur les objets. IMPORTANT : vous devez définir cette métadonnées dans la couche de mise en valeur, pas dans la couche originelle.
-	* "data_encoding" tout EncoderClass definis dans client.ini: voir Section 17.3, "Configuration de l'encodage des caractères". Vous devez également spécifier que le paramètre dans la Méta-donnée "exported_values" ! Voir Section 6.3, “Méta-données dans les fichiers Mapfile et layers.ini” pour les détails.	+	* "data_encoding" tout EncoderClass definis dans client.ini: voir Section 17.3, "Configuration de l'encodage des caractères". Vous devez également spécifier ce paramètre dans la Méta-donnée "exported_values" ! Voir Section 6.3, “Méta-données dans les fichiers Mapfile et layers.ini” pour les détails.

	Exemple :		Exemple :

fr:documentation:doc_officiel:version3.5:manuel_de_l_utilisateur - external edit

Mon, 02 Feb 2009 22:02:26 +0100

1234343673		current
Line 15:		Line 15:
	- [[Fichiers de configuration]]		- [[Fichiers de configuration]]
	- [[Configuration du cache]]		- [[Configuration du cache]]
-	- [[Couches]] <sub>[coreplugin]</sub>	+	- [[Couches]] <sub>[coreplugin] (layers)</sub>
	- [[Navigation]] <sub>[coreplugin] (location)</sub>		- [[Navigation]] <sub>[coreplugin] (location)</sub>
	- [[Options des formats d'image]] <sub>[coreplugin] (images)</sub>		- [[Options des formats d'image]] <sub>[coreplugin] (images)</sub>

fr:documentation:doc_officiel:version3.5:sauver_un_projet_de_carte_dans_une_url

simon — Tue, 10 Feb 2009 16:22:29 +0100

1234278390		current
Line 27:		Line 27:
	Votre toolbar.tpl DOIT contenir le '{if !$tool->oneshot}...{/if}' condition sur l'outil d'activation action!!!		Votre toolbar.tpl DOIT contenir le '{if !$tool->oneshot}...{/if}' condition sur l'outil d'activation action!!!

-	C'est particulièrement important si vous "overrided" ce modèle dans votre projet. Comparez avec la dernière version cvs du fichier toolbar.tpl pour vous assurer d'avoir le bon code conditionnel.	+	C'est particulièrement important si vous surchargez ce modèle dans votre projet. Comparez avec la dernière version cvs du fichier toolbar.tpl pour vous assurer d'avoir le bon code conditionnel.
	</note>		</note>

fr:documentation:doc_officiel:version3.5:configuration_anti-flood

simon — Tue, 10 Feb 2009 16:09:56 +0100

1234275713		current
Line 1:		Line 1:
		+	====== Configuration anti-flood ======
		+
	===== Introduction =====		===== Introduction =====

fr:documentation:doc_officiel:version3.5:module_de_localisation

simon — Tue, 10 Feb 2009 12:32:56 +0100

1233608546		current
Line 31:		Line 31:

	<note warning>		<note warning>
-	Assurez vous que le recentrage est activé (''recenterActive = true'' dans //client_conf/location.ini) ! La balise caché inputs //id_recenter_layer// et //id_recenter_ids// sont nécessaires pour que la fonctionnalité de recentrage fonctionne correctement.	+	Assurez vous que le recentrage est activé (''recenterActive = true'' dans //client_conf/location.ini//) ! La balise caché inputs //id_recenter_layer// et //id_recenter_ids// sont nécessaires pour que la fonctionnalité de recentrage fonctionne correctement.
	</note>		</note>

fr:documentation:doc_officiel:version3.5:start

simon — Tue, 10 Feb 2009 12:32:38 +0100

1234265558		current
Line 63:		Line 63:
	- [[.:WMS_Browser_Light\|Navigateur léger WMS]]FIXME		- [[.:WMS_Browser_Light\|Navigateur léger WMS]]FIXME
	- [[.:Routing_Plugin\|Module d'itinéraire]]FIXME		- [[.:Routing_Plugin\|Module d'itinéraire]]FIXME
-	- [[.:Bbox_history_plugin\|Module Historique de la bbox]]FIXME	+	- [[.:Bbox_history_plugin\|Module Historique de la bbox]]
	- [[Sauver un projet de carte dans une url]]FIXME		- [[Sauver un projet de carte dans une url]]FIXME
	- [[CartoWeb et statistique d'usage des WMS]] FIXME		- [[CartoWeb et statistique d'usage des WMS]] FIXME

fr:documentation:doc_officiel:version3.4:module_de_localisation

simon — Tue, 10 Feb 2009 12:31:49 +0100

1234265400		current
Line 31:		Line 31:

	<note warning>		<note warning>
-	Assurez vous que le recentrage est activé (''recenterActive = true'' dans //client_conf/location.ini) ! La balise caché inputs //id_recenter_layer// et //id_recenter_ids// sont nécessaires pour que la fonctionnalité de recentrage fonctionne correctement.	+	Assurez vous que le recentrage est activé (''recenterActive = true'' dans //client_conf/location.ini//) ! La balise caché inputs //id_recenter_layer// et //id_recenter_ids// sont nécessaires pour que la fonctionnalité de recentrage fonctionne correctement.
	</note>		</note>
-

fr:documentation:doc_officiel:version3.4:infobulles

simon — Tue, 10 Feb 2009 12:20:10 +0100

1234264155		current
Line 38:		Line 38:
	* //attributes// : liste des attributs, séparés par des virgules, à afficher		* //attributes// : liste des attributs, séparés par des virgules, à afficher
	* //template// : (facultatif) modèle personnalisé, doit être dans le dossier du module surchargeant //toolTips//. Si non défini, le modèle générique //layerResult.tpl// est utilisé. Le modèle à utiliser peut aussi être défini dans la méthode renderResult() dans le PHP si QueryableLayer est surchargée (voir la section 23.3.2, "Surcharger les classes")		* //template// : (facultatif) modèle personnalisé, doit être dans le dossier du module surchargeant //toolTips//. Si non défini, le modèle générique //layerResult.tpl// est utilisé. Le modèle à utiliser peut aussi être défini dans la méthode renderResult() dans le PHP si QueryableLayer est surchargée (voir la section 23.3.2, "Surcharger les classes")
-	* //geomColName// : (facultatif) nom de la colonne geometry. Par défaut 'the_geom'.
-	* //srid// : (facultatif) numéro du système de projection utilisé. Par défaut '-1'.
-
-	tooltips.region.label = "Régions"
-	tooltips.region.dsn = "pgsql://www-data:www-data@localhost:5432/france"
-	tooltips.region.dbTableName = region
-	tooltips.region.attributes = "nom, code"
-	tooltips.region.template = "layerResult_region.tpl"
-
-	* //timeoutBeforeHide// : (facultatif) Le temps en millisecondes avant que la boîte de résultat tooltips disparaisse (si l'utilisateur n'a pas mis le curseur de la souris dessus). Set à 3000 par défaut.
-
-	timeoutBeforeHide = 7000
-

		+	timeout_async.region.label = "Régions"
		+	timeout_async.region.dsn = "pgsql://www-data:www-data@localhost:5432/france"
		+	timeout_async.region.dbTableName = region
		+	timeout_async.region.attributes = "nom, code"
		+	timeout_async.region.template = "layerResult_region.tpl"

	===== Infobulle personnalisée =====		===== Infobulle personnalisée =====

fr:documentation:doc_officiel:version3.5:infobulles - toolTips mis à jour

simon — Tue, 10 Feb 2009 12:19:56 +0100

1234279277		current
Line 158:		Line 158:
	===== Incompatibilités =====		===== Incompatibilités =====

-	S'il vous plait remarquez que certaines fonctionnalités ont été enlevé du module tooltips pour renforcer sa stabilité. Les modes ''area_async'' et ''area_direct'' ne sont plus disponible dorénavant car il complique beaucoup le code javascript et n'ont pas été utilisé du tout. Et le mode ''timeout_async'' a été remplacé par ''tooltips'' dans les fichiers de configuration.	+	Remarquez que certaines fonctionnalités ont été enlevées du module toolTips pour renforcer sa stabilité. Les modes ''area_async'' et ''area_direct'' ne sont plus disponible dorénavant car ils compliquent beaucoup le code javascript et n'ont pas été utilisé du tout. Et le mode ''timeout_async'' a été remplacé par ''tooltips'' dans les fichiers de configuration.

fr:documentation:doc_officiel:version3.5:search

yves — Fri, 05 Dec 2008 09:34:44 +0100

fr:documentation:start

yves — Tue, 28 Oct 2008 19:31:35 +0100

1225218682		current
Line 14:		Line 14:

	===== Traduction de la documentation officielle =====		===== Traduction de la documentation officielle =====
-	* [[fr:documentation:doc_officiel:version3.5:start\|Documentation version 3.5]] FIXME <--- copie de la version 3.4 de départ	+	* [[fr:documentation:doc_officiel:version3.5:start\|Documentation version 3.5]] FIXME <-- copie de la version 3.4 de départ
	* [[fr:documentation:doc_officiel:version3.4:start\|Documentation version 3.4]]		* [[fr:documentation:doc_officiel:version3.4:start\|Documentation version 3.4]]
	* [[fr:documentation:doc_officiel:version3.3:start\|Documentation version 3.3]]		* [[fr:documentation:doc_officiel:version3.3:start\|Documentation version 3.3]]

fr:documentation:doc_officiel:version3.3:start

yves — Sun, 16 Dec 2007 14:30:29 +0100

1197811191		current
Line 30:		Line 30:
	- [[Manuel du développeur]]		- [[Manuel du développeur]]
	- [[Calling Plugins]]		- [[Calling Plugins]]
-	- [[Nouveaux Plugins]]FIXME	+	- [[Nouveaux Plugins]]
	- [[Dynamic mapfile modifications]]		- [[Dynamic mapfile modifications]]
	- [[Using the Security Infrastructure]]		- [[Using the Security Infrastructure]]

fr:documentation:doc_officiel:version3.3:nouveaux_plugins

yves — Sun, 16 Dec 2007 14:30:12 +0100

1197804622		current
Line 2:		Line 2:
	=====2.1 Que sont les Plugins=====		=====2.1 Que sont les Plugins=====
	====2.1.1 Définition====		====2.1.1 Définition====
-	Les plugins de cartoweb sont des paquetages modulaires de fichiers (Classes PHP, modèle HTML, images et autres ressources) qui sont utilisés pour une action particulière : mise en forme de la carte principale, interface de navigation dans les couches, déplacement dans la carte (zoom, déplacement, etc.), requêtes, authentification des utilisateurs, interface de recherche et beaucoup d'autres.	+	Les modules de CartoWeb sont des paquetages modulaires de fichiers (Classes PHP, modèle HTML, images et autres ressources) qui sont utilisés pour une action particulière : mise en forme de la carte principale, interface de navigation dans les couches, déplacement dans la carte (zoom, déplacement, etc.), requêtes, authentification des utilisateurs, interface de recherche et beaucoup d'autres.

-	====2.1.2 Plugins et Coreplugins====	+	====2.1.2 Modules et Coreplugins====
-	Il y a deux sortes de plugins:	+	Il y a deux sortes de modules :
-	''coreplugins'' : les plugins* fondamentaux qui s'occupent des actions de bas niveau comme la manipulation de la taille des cartes, les outils de navigation, la sélection des couches. Les Plugins qui sont fréquemment utilisés dans les applications cartoweb devraient être dans cette catégorie. Ils sont toujours disponibles et activés. D'autres plugins peuvent interagir avec eux. Les fichiers des coreplugins sont groupés dans le dossier ''coreplugins/''.	+	''coreplugins'' : les modules* fondamentaux qui s'occupent des actions de bas niveau comme la manipulation de la taille des cartes, les outils de navigation, la sélection des couches. Les modules qui sont fréquemment utilisés dans les applications CartoWeb devraient être dans cette catégorie. Ils sont toujours disponibles et activés. D'autres modules peuvent interagir avec eux. Les fichiers des coreplugins sont groupés dans le dossier ''coreplugins/''.
-	''plugins'': Ce sont des plugins* ''normaux'' qui effectuent des actions plus spécifiques et ne sont pas toujours activés. L'activation de Plugin se fait par la configuration du paramètre ''loadPlugins'' dans ''client_conf/client.ini'' pour les plugins CartoClient et dans ''server_conf/<mapId>/<mapId>.ini'' pour les Plugins CartoServer. Par exemple:	+	''plugins'': Ce sont des modules* ''normaux'' qui effectuent des actions plus spécifiques et ne sont pas toujours activés. L'activation de module se fait par la configuration du paramètre ''loadPlugins'' dans //client_conf/client.ini// pour les modules CartoClient et dans //server_conf/<mapId>/<mapId>.ini// pour les Plugins CartoServer. Par exemple:
	loadPlugins = auth, outline, exportHtml		loadPlugins = auth, outline, exportHtml

-	Comme, ils ne sont pas toujours disponibles, les plugins ''simples'' ne sont généralement pas reliés aux autres. D'un autre côté, ce n'est pas un problème pour eux d'utiliser des fonctionnalités des coreplugins si ces derniers sont accessibles. Les fichiers des plugins ''simples'' sont groupés dans le dossier ''plugins/''.	+	Comme, ils ne sont pas toujours disponibles, les modules ''simples'' ne sont généralement pas reliés aux autres. D'un autre côté, ce n'est pas un problème pour eux d'utiliser des fonctionnalités des coreplugins si ces derniers sont accessibles. Les fichiers des modules ''simples'' sont groupés dans le dossier //plugins///.

-	La philosophie générale est de rassembler tous les fichiers d'un plugin donné dans le même dossier dédié, autant pour les fichiers venant du côté CartoClient que ceux provenant du côté CartoServer.	+	La philosophie générale est de rassembler tous les fichiers d'un module donné dans le même dossier dédié, autant pour les fichiers venant du côté CartoClient que ceux provenant du côté CartoServer.

-	Ainsi, il est plus facile de ''pluguer'' un nouveau module dans l'architecture de CartoWeb. Il suffit juste de le placer dans le dossier ''plugins'' ou ''coreplugins''. Remarquez toutefois, que les fichiers de configuration (appelés: <nom du plugin>.ini ) sont placés dans ''client_conf/'' et/ou ''server_conf/<mapId>/'' suivant si les plugins ont des parties CartoClient ou CartoServer.	+	Ainsi, il est plus facile de //pluguer// un nouveau module dans l'architecture de CartoWeb. Il suffit juste de le placer dans le dossier //plugins/// ou //coreplugins//. Remarquez toutefois, que les fichiers de configuration (appelés : //<nom du plugin>.ini//) sont placés dans //client_conf/// et/ou //server_conf/<mapId>/// suivant si les modules ont des parties CartoClient ou CartoServer.

-	====2.1.3 Structure des Plugins====	+	====2.1.3 Structure des modules====
-	Les plugins et coreplugins ont la structure générale suivante:	+	Les modules et coreplugins ont la structure générale suivante:
	<pluginName>/		<pluginName>/
	<pluginName>/client/		<pluginName>/client/
Line 31:		Line 31:
	*''server/'' contient tous les fichiers php spécifiques au côté CartoServer		*''server/'' contient tous les fichiers php spécifiques au côté CartoServer
	*''common/'' contient tous les fichiers php qui sont partagé par les deux côtés CartoClient et CartoServer.		*''common/'' contient tous les fichiers php qui sont partagé par les deux côtés CartoClient et CartoServer.
-	''templates/'' contient tous les modèles Smarty spécifiques au plugin*. Comme les modèles sont seulement utilisés côté CartoClient il sont appelés seulement par le code ''client/''.	+	''templates/'' contient tous les modèles Smarty spécifiques au module*. Comme les modèles sont seulement utilisés côté CartoClient il sont appelés seulement par le code ''client/''.
-	''htdocs/'' contient tous les fichiers (pages PHP, images, javaScript, fichiers CSS, etc..) qui doivent être accessible depuis le web quand le plugin* est activé. Ces fichiers sont répartis dans différents dossiers suivant leur nature. Si nécessaire, vous pouvez créer des sous-dossiers supplémentaires. Par exemple: ''java/'' si votre plugin utilise une applet java. Pour préserver l'indépendance du plugin il est fortement recommandé de ne pas ajouter vos styles CSS dans la feuille de style générale de cartoClient, mais de créer ici une feuille de style spécifique qui sera appelée séparément.	+	''htdocs/'' contient tous les fichiers (pages PHP, images, javaScript, fichiers CSS, etc..) qui doivent être accessible depuis le web quand le module* est activé. Ces fichiers sont répartis dans différents dossiers suivant leur nature. Si nécessaire, vous pouvez créer des sous-dossiers supplémentaires. Par exemple: ''java/'' si votre module utilise une applet java. Pour préserver l'indépendance du module il est fortement recommandé de ne pas ajouter vos styles CSS dans la feuille de style générale de cartoClient, mais de créer ici une feuille de style spécifique qui sera appelée séparément.

-	Remarquez qu'il n'est pas nécessaire de créer entièrement la structure décrite ci-dessus. Seulement les dossiers qui contiennent des fichiers sont nécessaires. Par exemple, si un plugin fait uniquement un appel à des actions du côté CartoServer. Il n'y a pas besoin de créer les dossiers ''client/, templates/ et htdocs/. common/'' peut être utiles si des classes pouvant être partagées avec CartoClient sont utilisées.	+	Remarquez qu'il n'est pas nécessaire de créer entièrement la structure décrite ci-dessus. Seulement les dossiers qui contiennent des fichiers sont nécessaires. Par exemple, si un module fait uniquement un appel à des actions du côté CartoServer. Il n'y a pas besoin de créer les dossiers ''client/, templates/ et htdocs/. common/'' peut être utiles si des classes pouvant être partagées avec CartoClient sont utilisées.

-	=====2.2 Ecrire un Plugin=====	+	=====2.2 Écrire un module =====
	====2.2.1 Introduction====		====2.2.1 Introduction====
-	S'il n'existe aucun plugin ou coreplugin qui satisfasse vos besoins, et si aucun n'est assez proche pour justifier de l'adapter, vous pouvez écrire un nouveau plugin.	+	S'il n'existe aucun module ou coreplugin qui satisfasse vos besoins, et si aucun n'est assez proche pour justifier de l'adapter, vous pouvez écrire un nouveau module.

-	La classe principale des plugins (client et/ou server) doit hériter des classes déjà définies ''clientPlugin'' et/ou ''serverPlugin'' qui fournissent les outils de bases d'un plugin.	+	La classe principale des modules (client et/ou serveur) doit hériter des classes déjà définies ''clientPlugin'' et/ou ''serverPlugin'' qui fournissent les outils de bases d'un module.

	Par exemple :		Par exemple :
		+	<code php>
	class ClientYourPlugin extends ClientPlugin {		class ClientYourPlugin extends ClientPlugin {
	/* here comes your plugin client class definition */		/* here comes your plugin client class definition */
	}		}
		+	</code>
		+	====2.2.2 Module ou Coreplugin ?====
		+	En premier lieu, vous avez à déterminer si vous allez concevoir un simple module ou un coreplugin. Pour être un coreplugin, votre module doit être très générique et présenter un grand intérêt pour la communauté des utilisateurs de CartoWeb, car il doit être inclus dans la distribution de base. Contactez l'équipe de développement de CartoWeb pour plus d'informations. Dans la plus part des cas, c'est mieux et suffisant de créer un simple module.

-	====2.2.2 Plugin ou Coreplugin ?====	+	Pour activer un coreplugin, mettez à jour la méthode ''Cartoclient::getCorePluginNames()'' dans /// client/ Cartoclient.php// et/ou la méthode ''ServerContext::getCorePluginNames()'' dans //server/ServerContext.php//.
-	En premier lieu, vous avez à déterminer si vous allez concevoir un simple plugin ou un coreplugin. Pour être un coreplugin, votre plugin doit être très générique et présenter un grand intérêt pour la communauté des utilisateurs de CartoWeb, car il doit être inclus dans la distribution de base. Contactez l'équipe de développement de CartoWeb pour plus d'informations. Dans la plus part des cas, c'est mieux et suffisant de créer un simple plugin.	+
-		+
-	Pour activer un coreplugin, mettez à jour la méthode Cartoclient::getCorePluginNames()	+
-	dans ''/ client/ Cartoclient.php'' et/ou la méthode ''ServerContext::getCorePluginNames()'' dans ''server/ServerContext.php''.	+

	Par exemple :		Par exemple :
Line 60:		Line 60:
	</code>		</code>

-	Pour charger un plugin ''normal'', modifiez le paramètre ''loadPlugins'' dans le fichier ''client_conf/client.ini'' et/ou ''server_conf/ <mapId>/<mapId>.ini'' Comme dans l'exemple suivant:	+	Pour charger un module ''normal'', modifiez le paramètre ''loadPlugins'' dans le fichier //client_conf/client.ini// et/ou //server_conf/ <mapId>/<mapId>.ini'// Comme dans l'exemple suivant:
	loadPlugins = auth, outline, exportHtml		loadPlugins = auth, outline, exportHtml


		+	====2.2.3 Comment les modules sont appelés====
		+	Comme expliqué dans la [[.:nouveaux_plugins#que_sont_les_plugins\|section 2.1, Que sont les modules]], les modules sont des ensembles de code PHP qui sont appelés par les classes de CartoWeb (core classes) pour effectuer des actions particulières. Les modules sont appelés plusieurs fois durant l'exécution du programme (points d'entrée). Ainsi, ils peuvent interagir à plusieurs niveaux de l'application.

-	====2.2.3 Comment les plugins sont appelés====	+	Pour déterminer quel module doit être appelé à quel moment et pour faire quoi, les modules doivent implémenter une ou plusieurs des interfaces de module de CartoWeb (interface selon le sens des interfaces de la programmation orientée objet).
-	Comme expliqué dans la section 2.1, //Que sont les Plugins//, les plugins sont des ensembles de code PHP qui sont appelés par les classes de cartoweb (core classes) pour effectuer des actions particulières. Les Plugins sont appelés plusieurs fois durant l'exécution du programme (points d'entrée). Ainsi, ils peuvent interagir à plusieurs niveaux de l'application.	+

-	Pour déterminer quel plugin doit être appelé à quel moment et pour faire quoi, les plugins doivent implémenter une ou plusieurs des interfaces de plugin de CartoWeb (interface selon le sens des interfaces de la programmation orientée objet).	+	L'interface défini les méthodes qui seront appelées par le programme principal durant l'exécution. Par exemple, vous pouvez jeter un oeil à la version simplifiée de la fonction ''cartoclient::doMain()'' suivante (main program), qui est définie dans le fichier ///client/Cartoclient.php// :
-		+
-	L'interface défini les méthodes qui seront appelées par le programme principal durant l'exécution. Par exemple, vous pouvez jeter un oeil à la version simplifiée de la fonction ''cartoclient::doMain()'' suivante (main program), qui est définie dans le fichier ''/client/Cartoclient.php'' :	+

	<code php>		<code php>
Line 99:		Line 98:
	</code>		</code>

-	''callPluginsImplementing($interfaceName, $methodName, $argument)'' est exécutée à plusieurs endroits du programme et permet aux plugins d'implémenter l'interface <nomDeLInterface> et exécuter la méthode <nomDeLaMethode> avec l'argument <argument>.	+	''callPluginsImplementing($interfaceName, $methodName, $argument)'' est exécutée à plusieurs endroits du programme et permet aux modules d'implémenter l'interface <nomDeLInterface> et exécuter la méthode <nomDeLaMethode> avec l'argument <argument>.

-	Bien entendu, les méthodes définies dans une interface, doivent être implémentées dans le plugin en question. Les Plugins peuvent implémenter une ou plusieurs interfaces CartoWeb.	+	Bien entendu, les méthodes définies dans une interface, doivent être implémentées dans le module en question. Les modules peuvent implémenter une ou plusieurs interfaces CartoWeb.

-	Implémenter les interfaces n'est pas obligatoire lors de l'écriture d'un plugin, mais ne pas le faire ne préservera pas la volonté d'avoir un plugin potentiellement appelé de manière implicite par le programme principal.	+	Implémenter les interfaces n'est pas obligatoire lors de l'écriture d'un module, mais ne pas le faire ne préservera pas la volonté d'avoir un module potentiellement appelé de manière implicite par le programme principal.
-	En conséquence, les méthodes des plugins qui n'implémentent pas d'interfaces - appelés //services plugins// - doivent être explicitement appelés par une autre partie de code (en général un autre plugin).	+	En conséquence, les méthodes des modules qui n'implémentent pas d'interfaces - appelés //services modules// - doivent être explicitement appelés par une autre partie de code (en général un autre module).

	<code php>		<code php>
Line 112:		Line 111:
	</code>		</code>

-	Pour une liste compréhensive des interfaces client et serveur disponibles, regardez les fichiers : ''/client/ClientPlugin.php'' et ''/server(ServerPlugin.php'' ou jetez un oeil à la documentation de l'API PHP de cartoweb.	+	Pour une liste compréhensive des interfaces client et serveur disponibles, regardez les fichiers : ///client/ClientPlugin.php// et ///server(ServerPlugin.php// ou jetez un œil à la documentation de l'API PHP de CartoWeb.

	{{:fr:documentation:doc_officiel:version3.3:plugins_diagram.pdf\|:fr:documentation:doc_officiel:version3.3:plugins_diagram.pdf}}		{{:fr:documentation:doc_officiel:version3.3:plugins_diagram.pdf\|:fr:documentation:doc_officiel:version3.3:plugins_diagram.pdf}}


-	====2.2.4 Check-List de la création d'un Plugin====	+	====2.2.4 Check-List de la création d'un module ====

-	Déterminez s'il faut créer un plugin* ou un coreplugin	+	* Déterminez s'il faut créer un module ou un coreplugin
-	Créez un dossier <monplugin>/ dans /projects/<monprojet>/plugins/ si vous avez besoin d'un simple plugin. Le nom du dossier est le nom du plugin. Vous pouvez choisir le nom que vous voulez, sauf, ceux qui sont déjà pris par d'autres plugins* ou coreplugins. Il est recommandé d'utiliser un nom en minuscule et de mettre en majuscule seulement la première lettre de chaque mot qui compose le nom. (ex: monNomDePlugin). Dans le cas d'un coreplugin, il n'y a pas la possibilité de créer un coreplugin dans le contexte d'un projet. Les coreplugins ne peuvent être placés que dans la base de l'application. Il n'est pas recommandé de réaliser une telle chose sans l'avis des développeur de CartoWeb à cause des problèmes de compatibilité que ça pourrait engendrer lors d'une mise à jour.	+	* Créez un dossier //<monplugin>/// dans ///projects/<monprojet>/plugins/// si vous avez besoin d'un simple module. Le nom du dossier est le nom du module. Vous pouvez choisir le nom que vous voulez, sauf, ceux qui sont déjà pris par d'autres modules ou coreplugins. Il est recommandé d'utiliser un nom en minuscule et de mettre en majuscule seulement la première lettre de chaque mot qui compose le nom. (ex : ''monNomDePlugin''). Dans le cas d'un coreplugin, il n'y a pas la possibilité de créer un coreplugin dans le contexte d'un projet. Les coreplugins ne peuvent être placés que dans la base de l'application. Il n'est pas recommandé de réaliser une telle chose sans l'avis des développeur de CartoWeb à cause des problèmes de compatibilité que ça pourrait engendrer lors d'une mise à jour.
		+	* Créez un sous-dossier pour placer tous les fichiers ressources et modèle.
		+	* Créez ''client/, server/, common/'' des parties CartoClient et CartoServer
		+	* Créez le fichier de votre classe PHP principale. Ce fichier doit être nommé en utilisant la convention de la mise en majuscule de la première lettre du nom du module, ceci préfixé avec ''Client'' ou ''Server'' pour les parties clientes ou serveurs. (ex : //ClientMonPlugin.php//, //ServerMonPlugin.php//, //MonPlugin.php//)
		+	* Dans les fichiers ci-dessus, créer des classes php héritant de ''clientPlugin'' et/ou ''ServerPlugin''. Ces classes doivent se nommer avec le même nom que celui du fichier, mais sans le ''.php''.

-		+	Par exemple :
-	*Créez un sous-dossier pour placer tous les fichiers ressources et modèle.	+	<code php>
-	*Créez ''client/, server/, common/'' des parties CartoClient et CartoServer	+
-	Créez le fichier de votre classe PHP principale. Ce fichier doit être nommé en utilisant la convention de la mise en majuscule de la première lettre du nom du plugin, ceci préfixé avec ''Client'' ou ''Server'' pour les parties clientes ou server. (ex: ClientMonPlugin.php, ServerMonPlugin.php, MonPlugin.php)*	+
-	Dans les fichiers ci-dessus, créer des classes php héritant de ''clientPlugin'' et/ou ''ServerPlugin''. Ces classes doivent se nommer avec le même nom que celui du fichier, mais sans le ''.php''.*	+
-		+
-	Par exemple:	+
	/**		/**
	* 'version $Id: ServerYourPlugin.php,v 1.8 2005/02/23 11:52:43 johndoe Exp $		* 'version $Id: ServerYourPlugin.php,v 1.8 2005/02/23 11:52:43 johndoe Exp $
	*/		*/
	class ServerYourPlugin extends ServerPlugin {		class ServerYourPlugin extends ServerPlugin {
-		+	</code>
-	Faites que vos classes implémentent les interfaces demandées et redéfinissez les méthodes correspondantes. Remarquez que la partie ''common/'' de la classe: ''MonPlugin'' n'a besoin d'hériter aucune des classes ou interfaces de cartoweb. Ce dossier est juste utilisé comme conteneur pour les données communes entre le client et le server*.	+	* Faites que vos classes implémentent les interfaces demandées et redéfinissez les méthodes correspondantes. Remarquez que la partie ''common/'' de la classe: ''MonPlugin'' n'a besoin d'hériter aucune des classes ou interfaces de CartoWeb. Ce dossier est juste utilisé comme conteneur pour les données communes entre le client et le serveur.
-	Activez votre plugin* en ajoutant son nom dans la ''loadplugin'' du fichier de configuration du projet.	+	* Activez votre module en ajoutant son nom dans la ''loadplugin'' du fichier de configuration du projet.

	====2.2.5 Inclusion automatique de fichiers====		====2.2.5 Inclusion automatique de fichiers====

-	Les fichiers PHP principaux de votre plugin (ex: ''ClientMonPlugin.php'', ''ServerMonPlugin.php'', ''MonPlugin.php'') sont automatiquement inclus et leurs classes et objets sont directement accessibles. Les autres fichiers dans ''client/, server/'' ou '' common/'' ne le sont pas. Ils doivent être inclus explicitement dans les fichiers php principaux.	+	Les fichiers PHP principaux de votre module (ex : ''ClientMonPlugin.php'', ''ServerMonPlugin.php'', ''MonPlugin.php'') sont automatiquement inclus et leurs classes et objets sont directement accessibles. Les autres fichiers dans ''client/, server/'' ou '' common/'' ne le sont pas. Ils doivent être inclus explicitement dans les fichiers php principaux.

-	Les modèles placés dans le dossier ''templates/'' du plugin sont accessibles directement avec un code PHP identique à celui ci-dessous:	+	Les modèles placés dans le dossier ''templates/'' du module sont accessibles directement avec un code PHP identique à celui ci-dessous:

	<code php>		<code php>
Line 149:		Line 147:
	</code>		</code>

-	=====2.3 Adapter un Plugin=====	+	=====2.3 Adapter un module =====
	====2.3.1 Approche====		====2.3.1 Approche====
-	Si un plugin ou coreplugin existant.....	+	Si un module ou coreplugin existant.....

	A compléter...		A compléter...

fr:documentation:doc_officiel:version3.3:configuration_de_la_securite

yves — Sun, 16 Dec 2007 14:21:11 +0100

1197811176		current
Line 22:		Line 22:

	La section suivante décrit le fichier de configuration du module ''Auth''. Il gère les noms d'utilisateurs, les mots de passe et les rôles.		La section suivante décrit le fichier de configuration du module ''Auth''. Il gère les noms d'utilisateurs, les mots de passe et les rôles.
		+

	==== fichier auth.ini (côté client) ====		==== fichier auth.ini (côté client) ====
Line 44:		Line 45:

	* securityContainer : peut être un fichier pour le stockage des identifiants et des mots de passes dans un fichier, ou une base de données pour le stockage dans une base de données.		* securityContainer : peut être un fichier pour le stockage des identifiants et des mots de passes dans un fichier, ou une base de données pour le stockage dans une base de données.
-	* dbSecurityDsn : la chaîne de connection à la base de données à utiliser. Par exemple : ''pgsql://user:password@localhost/test''.	+	* dbSecurityDsn : la chaîne de connection à la base de données à utiliser. Par exemple : <html>pgsql://user:password@localhost/test</html>.
	* dbSecurityQueryUser : la requête SQL à lancer pour vérifier la validité de la paire identifiant/mot de passe. Il doit retourner une ligne si la paire est correcte. Par exemple : ''SELECT * FROM users WHERE username='%s' AND password='%s'''.		* dbSecurityQueryUser : la requête SQL à lancer pour vérifier la validité de la paire identifiant/mot de passe. Il doit retourner une ligne si la paire est correcte. Par exemple : ''SELECT * FROM users WHERE username='%s' AND password='%s'''.
	* dbSecurityQueryRoles : la requête SQL pour récupérer les rôles pour un utilisateur donné. Elle doit retourner une colonne avec les rôles pour chaque ligne d'utilisateur. Par exemple : ''SELECT roles FROM users WHERE username='%s'''		* dbSecurityQueryRoles : la requête SQL pour récupérer les rôles pour un utilisateur donné. Elle doit retourner une colonne avec les rôles pour chaque ligne d'utilisateur. Par exemple : ''SELECT roles FROM users WHERE username='%s'''

fr:documentation:doc_officiel:version3.3:internationalisation

yves — Sun, 16 Dec 2007 14:06:10 +0100

1183929143		current
Line 6:		Line 6:
	La prise en charge de la traduction dans CartoWeb utilise gettext [[http://www.gnu.org/software/gettext/manual]]. Cependant l'architecture d'internationalisation est prête pour d'autres systèmes de traduction.		La prise en charge de la traduction dans CartoWeb utilise gettext [[http://www.gnu.org/software/gettext/manual]]. Cependant l'architecture d'internationalisation est prête pour d'autres systèmes de traduction.

-	<box 80% round orange \| Note>	+	<note>
	Les scripts détaillés ci-dessous sont seulement disponibles en ligne de commande (console “DOS”). Ils ne peuvent pas être lancés à partir d’un navigateur.		Les scripts détaillés ci-dessous sont seulement disponibles en ligne de commande (console “DOS”). Ils ne peuvent pas être lancés à partir d’un navigateur.
-	</box>	+	</note>

	==== Configuration ====		==== Configuration ====

	Pour l'instant seul le système gettext est utilisé. S'il n'est pas installé, vous pouvez utilisez un système factice qui ne traduira rien du tout. Pour utilisez gettext vous devez installer le module PHP de gettext.		Pour l'instant seul le système gettext est utilisé. S'il n'est pas installé, vous pouvez utilisez un système factice qui ne traduira rien du tout. Pour utilisez gettext vous devez installer le module PHP de gettext.
-	Le système de traduction est maintenant automatiquement défini à gettext s'il est installé sinon il est désactivé. Le paramètre //I18nclass// n’est maintenant plus utilisé.	+
		+	Le système de traduction est maintenant automatiquement défini à gettext s'il est installé sinon il est désactivé. Le paramètre ''I18nclass'' n’est maintenant plus utilisé.

	=== Dérivé d'Unix ===		=== Dérivé d'Unix ===

-	Dans les environnements dérivés d'Unix, le fichier <html>/etc/locale.alias/</html> contient les alias pour les locales installées. Pour chaque langage utilisé, une ligne doit être présente dans ce fichier. L'alias ('fr' dans l'exemple ci-dessous) doit pointé vers une locale installée sur le système.	+	Dans les environnements dérivés d'Unix, le fichier ///etc/locale.alias/// contient les alias pour les locales installées. Pour chaque langage utilisé, une ligne doit être présente dans ce fichier. L'alias ('fr' dans l'exemple ci-dessous) doit pointé vers une locale installée sur le système.
	...		...
	fr fr_CH.ISO-8859-1		fr fr_CH.ISO-8859-1
	...		...

-	Il est nécessaire de lancer locale-gen après avoir édité le fichier <html>/etc/locale.alias/</html> pour regénérer le système de langues.	+	Il est nécessaire de lancer locale-gen après avoir édité le fichier ///etc/locale.alias/// pour régénérer le système de langues.

	Pour installer une langue sous debian, utilisez la commande suivante avec des droits d'administration (root) :		Pour installer une langue sous debian, utilisez la commande suivante avec des droits d'administration (root) :
Line 34:		Line 35:
	Deux scripts ont été préparés pour vérifier si gettext a été correctement installé sur le système :		Deux scripts ont été préparés pour vérifier si gettext a été correctement installé sur le système :

-	* <html>/scripts/testgettetxt.sh/</html> : cela compilera et lancera un petit programme en C qui testera xgettext	+	* ///scripts/testgettetxt.sh/// : cela compilera et lancera un petit programme en C qui testera xgettext

	et msgfmt.		et msgfmt.

-	* <html>/scripts/testgettext.php/</html> : si gettext est correctement installé sur votre système, cela testera le	+	* ///scripts/testgettext.php/// : si gettext est correctement installé sur votre système, cela testera le

	fonctionnement correct de gettext avec PHP.		fonctionnement correct de gettext avec PHP.

-	<box 80% round orange \| Remarque>	+	<note tips>
	Ces scripts nécessitent que les langues ait été correctement configurées. Ils ont été testés sous GNU/Linux avec une installation sous Debian.		Ces scripts nécessitent que les langues ait été correctement configurées. Ils ont été testés sous GNU/Linux avec une installation sous Debian.
-	</box>	+	</note>

	=== win 32 ===		=== win 32 ===
Line 69:		Line 70:
	Pour chaque mapfile, deux modèles seront générés : //server.po// et //server.<nom_mapfile>.po//		Pour chaque mapfile, deux modèles seront générés : //server.po// et //server.<nom_mapfile>.po//

-	* générez les modèles du project côté client :	+	* générez les modèles du projet côté client :

	cd <cartoweb_home>/scripts		cd <cartoweb_home>/scripts
Line 101:		Line 102:
	==== Exemple ====		==== Exemple ====

-	Pour traduire un texte en français pour le projet test_project et le fichier map projectmap, suivez ces étapes :	+	Pour traduire un texte en français pour le projet ''test_project'' et le fichier map //projectmap//, suivez ces étapes :
	* côté serveur :		* côté serveur :

Line 134:		Line 135:
	Cela testera si Gettext est installé correctement sur votre système.		Cela testera si Gettext est installé correctement sur votre système.

-	<box 80% round orange \| Remarque>	+	<note>
	Ce script n’est pas utilisable sous windows, seulement pour les systèmes compatible Unix.		Ce script n’est pas utilisable sous windows, seulement pour les systèmes compatible Unix.
-	</box>	+	</note>

	* cd <cartoweb_home>/scripts		* cd <cartoweb_home>/scripts
Line 160:		Line 161:
	* Vérifier si vous avez plusieurs entrées //fuzzy// dans vos fichiers po fusionés (le fichier qui est automatiquement créé par Gettext, lors de la fusion des fichiers po du client et du serveur.). Cela arrive quand vous avez utilisé le même //msgid// dans différents fichiers po.		* Vérifier si vous avez plusieurs entrées //fuzzy// dans vos fichiers po fusionés (le fichier qui est automatiquement créé par Gettext, lors de la fusion des fichiers po du client et du serveur.). Cela arrive quand vous avez utilisé le même //msgid// dans différents fichiers po.

-	<box 80% round orange \| Remarque>	+	<note>
	Chaque fichier po contient une seule entrée //fuzzy// au début, cela ne doit pas être enlevé.		Chaque fichier po contient une seule entrée //fuzzy// au début, cela ne doit pas être enlevé.
	...		...
Line 168:		Line 169:
	"POT-Creation-Date: 2005-09-13 09:36+0200\n"		"POT-Creation-Date: 2005-09-13 09:36+0200\n"
	...		...
-	</box>	+	</note>

	* Gettext commente automatiquement //msgid// et //msgstr// qui ne sont pas trouvés dans vos modèles. Les lignes commentées débutent par un dièse (#). Parfois cela est malvenu, décommentez simplement les lignes.		* Gettext commente automatiquement //msgid// et //msgstr// qui ne sont pas trouvés dans vos modèles. Les lignes commentées débutent par un dièse (#). Parfois cela est malvenu, décommentez simplement les lignes.
Line 177:		Line 178:
	Lisez la section 1.1.3.2.4, "Nettoyer les fichiers temporaire (Carte, PDF, fichiers temporaires et le cache Smarty)" pour plus de détails.		Lisez la section 1.1.3.2.4, "Nettoyer les fichiers temporaire (Carte, PDF, fichiers temporaires et le cache Smarty)" pour plus de détails.

-	<box 80% round orange \| Remarque>	+	<note>
	Cela peut être utile parfois en mode //development//.		Cela peut être utile parfois en mode //development//.
-	</box>	+	</note>

	===== Configuration de l'encodage des caractères =====		===== Configuration de l'encodage des caractères =====

fr:documentation:doc_officiel:version3.3:edition

yves — Sun, 16 Dec 2007 14:02:56 +0100

1183929140		current
Line 1:		Line 1:
	====== Édition ======		====== Édition ======

-	Le module //edit// autorise les utilisateurs à éditer les données géographiques depuis leur navigateur internet.	+	Le module ''edit'' autorise les utilisateurs à éditer les données géographiques depuis leur navigateur internet.

	===== Configuration côté client =====		===== Configuration côté client =====
Line 9:		Line 9:
	Voici les options qui peuvent être définies côté client :		Voici les options qui peuvent être définies côté client :

-	* general.allowedRoles : liste de rôles séparés par des virgules qui sont autorisés à utiliser le module edit	+	* general.allowedRoles : liste de rôles séparés par des virgules qui sont autorisés à utiliser le module ''edit''
-	* insertedFeaturesMaxNumber : entier, nombre de nouveaux objets géographiques qu'un utilisateur est autorisé à dessiner pour insertion dans la base de données. Définissez le à 0 si l'utilisateur est seulement autorisé à mettre à jour ou effacer des objets géographiques.	+	* insertedFeaturesMaxNumber : entier, nombre de nouveaux objets géographiques qu'un utilisateur est autorisé à dessiner pour insertion dans la base de données. Définissez le à 0 si l'utilisateur est seulement autorisé à mettre à jour ou effacer des objets géographiques.
-	* editLayers : liste des couches, séparées par des virgules, qui sont éditables	+	* editLayers : liste des couches, séparées par des virgules, qui sont éditables
-	* editResultNbCol : nombre de colonnes à utiliser pour la table d'attributs.	+	* editResultNbCol : nombre de colonnes à utiliser pour la table d'attributs.
-	* editDisplayAction : ce paramètre chaîne de caractère est utilisé pour indiquer si les boutons "valider" et "annuler" doivent être également affichés sous la table d'attributs. Si il est vide ou vaut //both//, les boutons seront affichés à la fois dans le dossier et sous le tableau des attributs. Si sa valeur est //folder//, les boutons seront uniquement affichés dans le dossier.	+	* editDisplayAction : ce paramètre chaîne de caractère est utilisé pour indiquer si les boutons "valider" et "annuler" doivent être également affichés sous la table d'attributs. Si il est vide ou vaut ''both'', les boutons seront affichés à la fois dans le dossier et sous le tableau des attributs. Si sa valeur est ''folder'', les boutons seront uniquement affichés dans le dossier.

	===== Éléments en rapport avec le Mapfile =====		===== Éléments en rapport avec le Mapfile =====
Line 19:		Line 19:
	==== Méta-données ====		==== Méta-données ====

-	Des méta-données spécifiques doivent être définies dans le mapfile pour les couhes éditables.	+	Des méta-données spécifiques doivent être définies dans le mapfile pour les couches éditables.
		+	<code mapserver>
	METADATAs		METADATAs
	...		...
Line 27:		Line 27:
	'edit_geometry_type' 'polygon' # PostGIS geometry type		'edit_geometry_type' 'polygon' # PostGIS geometry type
	'edit_srid' '-1'		'edit_srid' '-1'
-	'edit_attributes' 'parc_id,name\|string,culture\|string,surf,parc_type\|integer' # list of the editable fields	+	'edit_attributes' 'parc_id,name\|string,culture\|string,surf,parc_type\|integer' # liste des champs éditable
	END		END
-		+	</code>
-	* edit_table : chaîne de caractères, nom de la table postGIS à éditer	+	* edit_table : chaîne de caractères, nom de la table postGIS à éditer
-	* edit_geometry_column : chaîne de caractères, nom du champ géométrique dans la table	+	* edit_geometry_column : chaîne de caractères, nom du champ géométrique dans la table
-	* edit_geometry_type : chaîne de caractères, type de la géométrie de l'objet géographique pour la couche. Les valeurs possibles sont point, line et polygon. Elles peuvent être différentes du type msLayer (rendu)	+	* edit_geometry_type : chaîne de caractères, type de la géométrie de l'objet géographique pour la couche. Les valeurs possibles sont ''point'', ''line'' et ''polygon''. Elles peuvent être différentes du type msLayer (rendu)
-	* edit_srid : entier (optionnel), identifiant du SRID	+	* edit_srid : entier (optionnel), identifiant du SRID
-	* edit_attributes : liste d'attributs séparés par des virgules utilisés pour l'édition. Chaque valeur représente le nom et le type d'attribut séparé par le symbol pipe '\|'. Seuls les attributs avec un type défini sont éditables. Les types d'attributs disponibles sont string et integer.	+	* edit_attributes : liste d'attributs séparés par des virgules utilisés pour l'édition. Chaque valeur représente le nom et le type d'attribut séparé par le symbole pipe '\|'. Seuls les attributs avec un type défini sont éditables. Les types d'attributs disponibles sont ''string'' et ''integer''.

	===== Comment faire =====		===== Comment faire =====
Line 41:		Line 41:

	* D'abord, vous avez besoin d'une base de données PostgreSQL avec postGIS activée. Disons qu'elle est nommée "edit_db" pour les explications suivantes.		* D'abord, vous avez besoin d'une base de données PostgreSQL avec postGIS activée. Disons qu'elle est nommée "edit_db" pour les explications suivantes.
-	* À ce point, vous pouvez lancer les requêtes //demoEdit_schema.sql// et //demoEdit_data.sql//. localisé dans le répertoire <CARTOWEB_HOME>/projects/demoEdit/. Cela créera trois tables géomtriques, une pour chaque géométrie.	+	* À ce point, vous pouvez lancer les requêtes //demoEdit_schema.sql// et //demoEdit_data.sql//. localisé dans le répertoire //<CARTOWEB_HOME>/projects/demoEdit///. Cela créera trois tables géométriques, une pour chaque géométrie.
-	* Dans CartoWeb, vous devez charger le module edit dans votre projet à la fois côté client et serveur.	+	* Dans CartoWeb, vous devez charger le module ''edit'' dans votre projet à la fois côté client et serveur.

	loadPlugins = [...], edit		loadPlugins = [...], edit

-	* Puis, vous devrez configurer le module en définissant les layer_ids dans le paramètre editLayers dans le fichier edit.ini.	+	* Puis, vous devrez configurer le module en définissant les layer_ids dans le paramètre ''editLayers'' dans le fichier //edit.ini//.

	editLayers = edit_poly, edit_line, edit_point		editLayers = edit_poly, edit_line, edit_point

	* Dans votre mapfile, dans l'objet LAYER correspondant, vous devez définir les méta-données spécifiques suivantes :		* Dans votre mapfile, dans l'objet LAYER correspondant, vous devez définir les méta-données spécifiques suivantes :
		+	<code mapserver>
	LAYER		LAYER
	NAME "edit_poly"		NAME "edit_poly"
Line 79:		Line 79:
	'edit_geometry_type' 'polygon' # PostGIS geometry type		'edit_geometry_type' 'polygon' # PostGIS geometry type
	'edit_srid' '-1'		'edit_srid' '-1'
-	'edit_attributes' 'parc_id,name\|string,culture\|string,surf,parc_type\|integer' # list of the editable fields	+	'edit_attributes' 'parc_id,name\|string,culture\|string,surf,parc_type\|integer' # liste des champs éditable
	'edit_filter' // # mapserver filter		'edit_filter' // # mapserver filter
	END		END
	END		END
-		+	</code>
-	<box 80% round orange \| warning>	+	<note warning>
-	Assurez-vous que votre liste //edit_attributes// ne possède pas d’espaces entre les attributs	+	Assurez-vous que votre liste ''edit_attributes'' ne possède pas d’espaces entre les attributs.
-	</box>	+	</note>

1280054222		current
Line 2:		Line 2:
	* [[fr:articles:start\|Articles]]		* [[fr:articles:start\|Articles]]
	* [[fr:documentation:start\|Documentation]]		* [[fr:documentation:start\|Documentation]]
-	* [[http://www.portailsig.org/faq/cartoweb_3/\|FAQ]]	+	* [[http://www.portailsig.org/content/faq-cartoweb\|FAQ]]
	* [[fr:modules:start\|Modules]]		* [[fr:modules:start\|Modules]]
	* [[fr:templates:start\|Modèles]]		* [[fr:templates:start\|Modèles]]

1228466084		current
Line 31:		Line 31:

	==== 23.3.1. Mécanisme basic et configuration ====		==== 23.3.1. Mécanisme basic et configuration ====
-	Le jeu de données et la définition de la requête sont définie dans le fichier //search.ini//. Le design et les champs du formulaire de recherche est définie le fichier //search.tpl//. Le comportement de la recherche reside principalement dans le fichier //Search.ajax.js//.	+	Le jeu de données et la définition de la requête sont définie dans le fichier //search.ini//. Le design et les champs du formulaire de recherche est définie le fichier //search.tpl//. Le comportement de la recherche réside principalement dans le fichier //Search.ajax.js//.

	Imaginons que nous voulons faire une recherche avec un recentrage sur les données qui sont présentées sur une couche //Addresses//. La source des données est une table dans une base de données PostGIS.		Imaginons que nous voulons faire une recherche avec un recentrage sur les données qui sont présentées sur une couche //Addresses//. La source des données est une table dans une base de données PostGIS.
Line 57:		Line 57:
	config.Adresses.formatter.template = search_results		config.Adresses.formatter.template = search_results

-	* le paramètre ''dsn'' correspond à la chaine dsn de la connection à la base de données. Pour plus d'information voyez s'il vous plait la page PEAR correspondante.	+	* le paramètre ''dsn'' correspond à la chaine dsn de la connexion à la base de données. Pour plus d'information voyez s'il vous plait la page PEAR correspondante.
	* le paramètre ''encodingContext'' correspond au contexte dans votre fichier //client_conf/client.ini// voir le code ci-dessous.		* le paramètre ''encodingContext'' correspond au contexte dans votre fichier //client_conf/client.ini// voir le code ci-dessous.
	* le paramètre ''config.XXXX'' est utilisé pour faire la différence entre les tables.		* le paramètre ''config.XXXX'' est utilisé pour faire la différence entre les tables.
-	* le paramètre ''config.Adresses.provider.type'' définie le type de la requête qui doit êter réalisé sur la table. Ses valeurs peuvent être :	+	* le paramètre ''config.Adresses.provider.type'' définie le type de la requête qui doit être réalisé sur la table. Ses valeurs peuvent être :
	* ''fulltextTable'' : cela signifie que la recherche est une recherche textuelle (clause //ilike//) qui sera réalisé sur les champs listés dans le paramètre ''config.Adresses.provider.fulltextColumns''.		* ''fulltextTable'' : cela signifie que la recherche est une recherche textuelle (clause //ilike//) qui sera réalisé sur les champs listés dans le paramètre ''config.Adresses.provider.fulltextColumns''.
	* ''table'' : dans ce cas un clause WHERE doit être définie. (voir section 23.3.1.1, “Recherche guidé”)		* ''table'' : dans ce cas un clause WHERE doit être définie. (voir section 23.3.1.1, “Recherche guidé”)
	* ''user-defined'' (voir section 23.3.1.4, “Écrire un //Formatter//”).		* ''user-defined'' (voir section 23.3.1.4, “Écrire un //Formatter//”).
	* le paramètre ''config.Adresses.provider.table'' définie le nom de la table pour la requête.		* le paramètre ''config.Adresses.provider.table'' définie le nom de la table pour la requête.
-	* le paramètre ''config.Adresses.provider.aliases'' déinie les alias des noms des colonnes. Cela peut être utile s'il y a deux tables avec le mêm enom de colonne, ou si vous voulez migrer d'un ensemble de table vers une autre avec des noms de colonnes différentes.	+	* le paramètre ''config.Adresses.provider.aliases'' définie les alias des noms des colonnes. Cela peut être utile s'il y a deux tables avec le même nom de colonne, ou si vous voulez migrer d'un ensemble de table vers une autre avec des noms de colonnes différentes.
-	* le paramètre ''config.Adresses.provider.id'' désigne la valeur unique utilisé pour recentrer. Par exemple, su vous voulez recentrer par id (gid dans notre cas) la valeur id doit être définie à gid. N'oubliez pas id-attribute-srting dans le mapFile, voyez les références du Map file	+	* le paramètre ''config.Adresses.provider.id'' désigne la valeur unique utilisé pour recentrer. Par exemple, si vous voulez recentrer par id (gid dans notre cas) la valeur id doit être définie à gid. N'oubliez pas id-attribute-srting dans le mapFile, voyez les références du Map file
	* le paramètre ''config.Adresses.provider.columns'' définie les colonnes à retournées par la requête. Il contient les noms des colonnes séparés par des virgules.		* le paramètre ''config.Adresses.provider.columns'' définie les colonnes à retournées par la requête. Il contient les noms des colonnes séparés par des virgules.
	* le paramètre ''config.Adresses.provider.fulltextColumns'' définie les colonnes à utilisé dans la clause //ilike// lorsque le paramètre ''config.Adresses.provider.type'' est //fulltextColumns//. Il contient les noms des colonnes séparés par des virgules.		* le paramètre ''config.Adresses.provider.fulltextColumns'' définie les colonnes à utilisé dans la clause //ilike// lorsque le paramètre ''config.Adresses.provider.type'' est //fulltextColumns//. Il contient les noms des colonnes séparés par des virgules.
Line 74:		Line 74:
	Ce paramètre ne doit pas être utilisé si le type est //table//.		Ce paramètre ne doit pas être utilisé si le type est //table//.
	</note>		</note>
-	* le paramèter ''config.Adresses.provider.sortColumn'' définie les colonnes à utiliser pour ordonner les lignes.	+	* le paramètre ''config.Adresses.provider.sortColumn'' définie les colonnes à utiliser pour ordonner les lignes.
	* le paramètre ''config.Adresses.provider.sortDirection'' dont le type de l'ordre. Sa valeur peut être //asc// ou //desc// pour ascendant et descendant.		* le paramètre ''config.Adresses.provider.sortDirection'' dont le type de l'ordre. Sa valeur peut être //asc// ou //desc// pour ascendant et descendant.
	* le paramètre ''config.Adresses.formatter.type'' définie la méthode pour la présentation du(es) résultat(s). Pour l'instant seul smarty est implémenté. Mais il est possible d'écrire votre propre //Formatter// (voir le chapitre écrire un //Formatter//).		* le paramètre ''config.Adresses.formatter.type'' définie la méthode pour la présentation du(es) résultat(s). Pour l'instant seul smarty est implémenté. Mais il est possible d'écrire votre propre //Formatter// (voir le chapitre écrire un //Formatter//).
Line 132:		Line 132:

	* La balise input ''search_config'' détermine la table à interroger. Sa valeur doit correspondre au nom de la table définie dans le fichier //search.ini// (config.ici_mettre_la_valeur). Cette valeur permet de définir différente table dans le fichier de configuration et de choisir dynamiquement quelle table à interroger ! Cette balise input n'est pas optionnelle et le module recherche génèrera une erreur !		* La balise input ''search_config'' détermine la table à interroger. Sa valeur doit correspondre au nom de la table définie dans le fichier //search.ini// (config.ici_mettre_la_valeur). Cette valeur permet de définir différente table dans le fichier de configuration et de choisir dynamiquement quelle table à interroger ! Cette balise input n'est pas optionnelle et le module recherche génèrera une erreur !
-	* La balise input ''search_sort_column'' définie la colone à utiliser par la clause sort. Si la balise input n'est pas définie ou n'a pas de valeur, elle sera écrasée par le paramètre //sortColumn// définie dans le fichier //search.ini//. Si ce paramètre n'est pas définie également dans le fichier de configuration il sera ignoré.	+	* La balise input ''search_sort_column'' définie la colonne à utiliser par la clause sort. Si la balise input n'est pas définie ou n'a pas de valeur, elle sera écrasée par le paramètre //sortColumn// définie dans le fichier //search.ini//. Si ce paramètre n'est pas définie également dans le fichier de configuration il sera ignoré.
	* La balise input ''search_sort_direction'' définie l'ordre de rangement. Il doit être définie à //asc// ou //desc//. Si cette balise input n'est pas définie ou n'a pas de valeur, elle sera écrasée par le paramètre //sortColumnDirection// définie dans le fichier //search.ini//. Si ce paramètre n'est pas définie également dans le fichier de configuration il sera ignoré.		* La balise input ''search_sort_direction'' définie l'ordre de rangement. Il doit être définie à //asc// ou //desc//. Si cette balise input n'est pas définie ou n'a pas de valeur, elle sera écrasée par le paramètre //sortColumnDirection// définie dans le fichier //search.ini//. Si ce paramètre n'est pas définie également dans le fichier de configuration il sera ignoré.
	* La balise input ''search_number'' définie le nombre maximal de ligne qui doivent être renvoyée par la requête. Si cette balise input n'est pas définie ou n'a pas de valeur, elle sera ignorée.		* La balise input ''search_number'' définie le nombre maximal de ligne qui doivent être renvoyée par la requête. Si cette balise input n'est pas définie ou n'a pas de valeur, elle sera ignorée.
Line 240:		Line 240:
	/* si le nom de la table de la base de données est le même que la couche concernée		/* si le nom de la table de la base de données est le même que la couche concernée
	au recentrage, vous pouvez le définir comme ci-dessous		au recentrage, vous pouvez le définir comme ci-dessous
-	assurez vous qu'il il y a un input caché avec ce nom et cet id dans votre ficher modèle !	+	assurez vous qu'il y a un input caché avec ce nom et cet id dans votre ficher modèle !
	si non, ajoutez le */		si non, ajoutez le */
	$('id_recenter_layer').value = $('search_config').value;		$('id_recenter_layer').value = $('search_config').value;