Développer une nouvelle application pour eGroupWare - Historique des versions

41.229.76.239 : /* Le fichier de configuration */

2010-01-30T09:13:52Z

Le fichier de configuration

193.251.53.202 le 4 juillet 2007 à 08:25

2007-07-04T08:25:03Z

193.251.53.202 le 3 juillet 2007 à 14:15

2007-07-03T14:15:46Z

193.251.53.202 le 3 juillet 2007 à 13:55

2007-07-03T13:55:39Z

193.251.53.202 le 3 juillet 2007 à 13:51

2007-07-03T13:51:10Z

193.251.53.202 le 3 juillet 2007 à 10:54

2007-07-03T10:54:32Z

193.251.53.202 le 3 juillet 2007 à 09:46

2007-07-03T09:46:29Z

193.251.53.202 le 3 juillet 2007 à 09:32

2007-07-03T09:32:11Z

193.251.53.202 le 3 juillet 2007 à 09:10

2007-07-03T09:10:02Z

193.251.53.202 le 3 juillet 2007 à 08:58

2007-07-03T08:58:59Z

@@ Ligne 38 : / Ligne 38 : @@
 La création d'une application commence par la définition du fichier de configuration. Ce fichier doit s'appeler '''setup.inc.php''' et doit se trouver dans le répertoire '''setup''' de l'application. Il s'agit alors de compléter les champs du tableau setup définissant les paramètres de l'application.
-*setup['NomApplication']['name'] : nom de l'application.
+*setup_info['NomApplication']['name'] : nom de l'application.
-*setup['NomApplication']['title'] : titre de l'application.
+*setup_info['NomApplication']['title'] : titre de l'application.
-*setup['NomApplication']['version'] : version de l'application.
+*setup_info['NomApplication']['version'] : version de l'application.
-*setup['NomApplication']['app_order'] : position de l'application dans la barre de menu.
+*setup_info['NomApplication']['app_order'] : position de l'application dans la barre de menu.
-*setup['NomApplication']['enable'] : '1' permet de spécifier que l'application doit être active, '0' permet de spécifier que l'application ne doit pas être active.
+*setup_info['NomApplication']['enable'] : '1' permet de spécifier que l'application doit être active, '0' permet de spécifier que l'application ne doit pas être active.
-*setup['NomApplication']['author'] : nom de l'auteur de l'application.
+*setup_info['NomApplication']['author'] : nom de l'auteur de l'application.
-*setup['NomApplication']['licence'] : la licence sous laquelle est l'application (par exemple GPL).
+*setup_info['NomApplication']['licence'] : la licence sous laquelle est l'application (par exemple GPL).
-*setup['NomApplication']['description'] : description de l'application.
+*setup_info['NomApplication']['description'] : description de l'application.
-*setup['NomApplication']['maintener'] : nom du développeur qui maintient l'application.
+*setup_info['NomApplication']['maintener'] : nom du développeur qui maintient l'application.
-*setup['NomApplication']['maintener_email'] : adresse mail du développeur qui maintient l'application.
+*setup_info['NomApplication']['maintener_email'] : adresse mail du développeur qui maintient l'application.
-*setup['NomApplication']['tables'] : tabeau contenant les noms des tables devant être créées dans la base de données (par exemple : array(egw_table1,egw_tables2)).
+*setup_info['NomApplication']['tables'] : tabeau contenant les noms des tables devant être créées dans la base de données (par exemple : array(egw_table1,egw_tables2)).
-*setup['NomApplication']['hooks'][] : nom de la classe définissant les menu (par exemple pour hook.nomMenu.inc.php mettre nomMenu).
+*setup_info['NomApplication']['hooks'][] : nom de la classe définissant les menu (par exemple pour hook.nomMenu.inc.php mettre nomMenu).
-*setup['NomApplication']['hooks']['settings'] : chemin vers la définition des préférences NomApplication.NomClassePreference.fonctionPreference (Voir le chapitre concerné pour plus de détails)
+*setup_info['NomApplication']['hooks']['settings'] : chemin vers la définition des préférences NomApplication.NomClassePreference.fonctionPreference (Voir le chapitre concerné pour plus de détails)
 == Définir les tables devant être intégrées à la base de données ==

@@ Ligne 57 : / Ligne 57 : @@
 La création des tables de la base de données se fait automatiquement lors de l'installation de l'application dans eGroupWare. Pour cela, il faut définir les tables dans le fichier '''tables_current.inc.php''' qui doit se trouver dans le répertoire '''setup'''. Ce fichier contient un tableau '''phpgw_baseline''' qui contient la définition des différentes tables. Par principe, les tables doivent être définies de la manière suivante : egw_NomTable.
-Les paramètres sont disposés dans un tableau contenant les champs suivant :
+Les paramètres sont disposés dans un tableau contenant les champs suivants :
 *'''fd''' : (field definition) tableau contenant la définition des champs de la table.
   'fd' => array(

← Version précédente		Version du 3 juillet 2007 à 14:15
Ligne 116 :		Ligne 116 :
	?>		?>

		+	== Le fichier index.php ==
		+
		+	Le fichier index.php est important car c'est lui qui est appelé en premier lors du lancement de l'application. Ce fichier doit se trouver à la racine de l'application.
		+	index.php sert en fait à rediriger vers une fonction d'une classe du répertoire inc/.
		+	Ce fichier doit contenir le code suivant :
		+	<?php
		+	header('Location: ../index.php?menuaction=NomApplication.Classe.Fonction');
		+
		+	NomApplication est le nom de l'application, Classe.Fonction est la première fonction à appeler (Classe est le nom de la classe sans 'class.' et sans '.inc.php').
		+
		+
	== Construire la colonne des menus ==		== Construire la colonne des menus ==

@@ Ligne 215 : / Ligne 215 : @@
       $GLOBALS['egw']->common->egw_footer();
+  }
 == Utiliser des templates simples ==

@@ Ligne 199 : / Ligne 199 : @@
+    }
   ?>
 == Utiliser des templates simples ==

@@ Ligne 218 : / Ligne 218 : @@
 On utilise l'objet "phpgwapi.Template" que l'on crée dans le constructeur de la classe. Cet objet propose les fonctions suivantes :
 (a utiliser dans l'ordre)
-*set_file(param) : param est un tableau un fichier template à une clé (on l'appelera cle_page) (ex: array("body"=>'exemple.tpl'))
+*set_file(param) : param est un tableau un fichier template à une clé (on l'appellera cle_page) (ex: array("body"=>'exemple.tpl'))
 *set_block('clé_page','nom_bloc') : associe 'nom_bloc' à la clé 'clé_page'
 *set_var('clé','valeur') : associe la valeur 'valeur' à la clé 'clé'

← Version précédente		Version du 3 juillet 2007 à 09:46
Ligne 235 :		Ligne 235 :
	$this->t->parse('out','bloc_exemple');		$this->t->parse('out','bloc_exemple');
	print $this->t->get('out','bloc_exemple');		print $this->t->get('out','bloc_exemple');
		+
		+	*Cas où une clé doit prendre plusieurs valeurs (exemple: pour créer un tableau)
		+	Dans ce cas, on définit la partie devant être répétée dans un bloc à part et on place une clé à l'endroit où doit se trouver ce bloc. La fonction parse devient parse('cle_ou_doit_se_trouver_bloc','nom_bloc_a_répété',True).
		+
		+	Exemple :
		+	page.tpl
		+	<pre>
		+	<!-- BEGIN tableau-->
		+	<h3>{titre_tableau}</h3>
		+	<table>
		+	{les_lignes}
		+	</table>
		+	<!-- END tableau-->
		+	<!-- BEGIN ligne -->
		+	<tr><td>{valeur1}</td><td>{valeur2}</td></tr>
		+	<!-- END ligne -->
		+	</pre>
		+
		+	dans le code
		+	......
		+	$this->t->set_file(array("body","page.tpl"));
		+	$this->t->set_block('body','tableau');
		+	$this->t->set_block('body','ligne');
		+	$this->t->set_var('titre_tableau','Un joli tableau');
		+	for( ...... )
		+	{
		+	$this->t->set_var('valeur1',1234);
		+	$this->t->set_var('valeur2',4321);
		+	$this->t->parse('les_lignes','ligne',True);
		+	}
		+	$this->t->parse("out","tableau");
		+	print $this->t->get('out','tableau');
		+	......

@@ Ligne 207 : / Ligne 207 : @@
 Les templates sont des fichiers contenant du code HTML. Ces fichiers se terminent par '.tpl' et sont placés dans un des répertoires de 'MonApplication/templates/' (par exemple dans 'MonApplication/templates/default/'). Ces templates contiennent en plus du code HTML des 'clés' qui seront remplacées par leur valeur par le code de l'application (Une 'clé' est en fait un mot contenu entre deux accolades) et des délimiteurs de blocs <!-- BEGIN nom_bloc --> et <!-- END nom_bloc -->.
-Exemple de template 'exemple.tld':
+Exemple de template 'exemple.tpl':
   <pre>
   <!-- BEGIN bloc_exemple -->
   </pre>
 == Communiquer simplement avec la base de données ==

@@ Ligne 245 : / Ligne 245 : @@
+  }
+*Effectuer une suppression
-*Sauvegarde
+Il suffit d'utiliser la fonction delete() de la classe parente qui prend en paramètre un tableau contenant les conditions devant apparaitre dans le "WHERE".
-*Suppression
+Par exemple : pour supprimer l'enregistrement où id_personne vaut 12 :
-*Modification
+  $this->delete(array('id_personne'=>12));
 == Internationaliser l'application ==