Piste :
Différences ¶
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédenteDernière révisionLes deux révisions suivantes | ||
tutoriels:tutors:accueil [2008/04/29 09:33] – manoo | fr:tutoriels:tutors:accueil [2009/05/18 11:36] – zip tutors sur serveur linux & tutors sur jelix1.1 kimaidou | ||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
+ | ====== Accueil des tutors : Le template de base ====== | ||
+ | Les tutors regroupent un ensemble d' | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Préalable ===== | ||
+ | Les applications tutors tournent sous la version stable de [[fr: | ||
+ | |||
+ | ** CE TUTORIEL EST INCOMPATIBLE AVEC Jelix 1.1 ET SUIVANT**. | ||
+ | |||
+ | Vous devriez avoir lu, et réalisé en exercice, le [[fr: | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Présentation ===== | ||
+ | |||
+ | Vous pouvez télécharger de la [[http:// | ||
+ | |||
+ | Ces tutoriels vous proposent, une démarche à suivre pour réaliser une application Jelix. Je vous recommande de suivre la démarche présentée ici, en consultant les différents fichiers contenus dans le téléchargement. Nous reviendrons plus loin à l' | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Ce que nous voulons faire ===== | ||
+ | Nous voulons réaliser une application qui servira de modèle à toutes les applications tutors. Dans les faits, il s'agit d'un simple menu et d'un template pour tutors. | ||
+ | |||
+ | Pour réaliser cela, nous devons faire: | ||
+ | * une application qui aura une page d' | ||
+ | * une application simple; | ||
+ | * une application avec un layer servant à plusieurs applications; | ||
+ | \\ | ||
+ | Nous allons diviser notre travail en quatre parties: | ||
+ | |||
+ | **Partie 1**\\ | ||
+ | \\ | ||
+ | Nous devons faire une mise en place ou créer l' | ||
+ | |||
+ | **Partie 2**\\ | ||
+ | Nous devons : | ||
+ | * utiliser un [[fr: | ||
+ | * le fichier // | ||
+ | * créer une " | ||
+ | * il s'agit du fichier // | ||
+ | |||
+ | A cette liste de fichiers, nous devons en ajouter deux autres : | ||
+ | * le logo de Jelix : // | ||
+ | * il s'agit du **logo jelix moyen** de cette [[http:// | ||
+ | * l' | ||
+ | * pris directement du site officiel de Jelix. | ||
+ | |||
+ | **Partie 3**\\ | ||
+ | Nous devons : | ||
+ | * utiliser une adaptation du template de l' | ||
+ | * il s'agit des fichiers // | ||
+ | * utiliser un [[fr: | ||
+ | * nous allons nommer ce fichier // | ||
+ | |||
+ | **Partie 4**\\ | ||
+ | Nous devons : | ||
+ | * utiliser une [[fr: | ||
+ | * ici il s'agit des fichiers : // | ||
+ | * utiliser une autre [[fr: | ||
+ | * ici il s'agit des fichiers : // | ||
+ | |||
+ | |||
+ | |||
+ | ===== Partie 1 ===== | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== La mise en place ou la création de l' | ||
+ | Comme vous l'avez peut-être compris, nous pouvons soit utiliser cet article pour créer tutors ou le télécharger de la forge de Jelix. | ||
+ | |||
+ | **Pour ceux qui crée, à partir de zéro, l' | ||
+ | Si vous avez fait le premier choix, vous devez utiliser le script // | ||
+ | |||
+ | Nom de l' | ||
+ | Nom du module : tutors.\\ | ||
+ | |||
+ | basePath = //"/ | ||
+ | |||
+ | Vous devez créer 2 zones: | ||
+ | * Le menu; | ||
+ | * Nom de la zone : sommaire.zone.php; | ||
+ | * Nom du template : sommaire.tpl; | ||
+ | * Le contenu; | ||
+ | * Nom de la zone : contenu.zone.php; | ||
+ | * Nom du template : content.tpl. | ||
+ | |||
+ | Aucune table, aucun dao et aucun formulaire ne sont utilisés pour ce tutors. | ||
+ | |||
+ | Également, vous devez télécharger le fichier suivant: [[http:// | ||
+ | |||
+ | Faites un test\\ | ||
+ | Si vous tapez dans votre fureteur http:// | ||
+ | |||
+ | <code php> | ||
+ | |||
+ | public function index(){ | ||
+ | $rep = $this-> | ||
+ | |||
+ | $rep-> | ||
+ | | ||
+ | return $rep; | ||
+ | } | ||
+ | |||
+ | </ | ||
+ | |||
+ | **Pour ceux qui téléchargent l' | ||
+ | Si vous avez choisi de télécharger [[http:// | ||
+ | N' | ||
+ | * de créer son répertoire temporaire | ||
+ | * de modifier la configuration | ||
+ | * et changer les droits d' | ||
+ | |||
+ | Remarques : | ||
+ | * Si votre serveur tourne sous Linux, il faut modifier le fichiers .php pour remplacer les doubles antislash par un simple slash dans les appels de fichier. Deux fichiers doivent être modifiés : **tutors/ | ||
+ | * Tutors fonctionne sur Jelix 1.0, mais on peut le faire fonctionner sur jelix 1.1 en modifiant le fichier / | ||
+ | |||
+ | Faites un test\\ | ||
+ | Tapez dans votre fureteur http:// | ||
+ | |||
+ | **Pour tous**\\ | ||
+ | Bien sûr, si malgré tous vos efforts vous avez une page vide dans votre fureteur, alors demandez de l'aide dans le **forum [[http:// | ||
+ | |||
+ | |||
+ | |||
+ | === Note : Le répertoire www === | ||
+ | Le répertoire /// | ||
+ | |||
+ | <code php> | ||
+ | |||
+ | // Au début du fichier | ||
+ | $__time_start = microtime(true); | ||
+ | |||
+ | ... | ||
+ | |||
+ | // A la fin du fichier | ||
+ | $__time_stop = microtime(true); | ||
+ | echo " | ||
+ | |||
+ | </ | ||
+ | |||
+ | Également le répertoire /// | ||
+ | |||
+ | **Notions avancées**\\ | ||
+ | Pour ceux qui sont habiles avec Jelix, sachez que vous pouvez partager un répertoire. Cela est utile pour y entreposer des css, javascripts et images communs à différentes applications. | ||
+ | |||
+ | Si vous pouvez créer un alias dans la configuration de votre serveur apache: | ||
+ | * lisez : [[fr: | ||
+ | |||
+ | Sinon vous pouvez modifier la structure hiéarchique de Jelix framework: | ||
+ | * lisez : [[fr: | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Partie 2 ===== | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== L' | ||
+ | Nous sommes rendus à modifier le fichier contrôleur. Vu la simplicité de cette application, | ||
+ | |||
+ | |||
+ | L' | ||
+ | * appel une réponse html personnalisée; | ||
+ | * affecte une chaîne de caractères à la variable de template " | ||
+ | * insère un template dans le template /// | ||
+ | |||
+ | Les deux autres actions: | ||
+ | * appel une réponse html personnalisée; | ||
+ | * affecte une chaîne de caractères à la variable de template " | ||
+ | * insère une zone dans le template principal; | ||
+ | * initialise une variable qui identifie le menu à afficher.. | ||
+ | |||
+ | **Emplacements dans tutors**\\ | ||
+ | /// | ||
+ | **Le contrôleur**\\ | ||
+ | Fichier à copier : // | ||
+ | **Guide du développeur**\\ | ||
+ | // | ||
+ | **Consulter les fichiers de Jelix framework**\\ | ||
+ | Pour le contrôleur : /// | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Une réponse personnalisée ==== | ||
+ | Nous en sommes à poser une autre brique à notre application. Cette brique se nomme une réponse personnalisée. | ||
+ | |||
+ | |||
+ | Une réponse personnalisée nous permet: | ||
+ | * d' | ||
+ | * de créer un lien vers un css, un fichier javascipt ou une image; | ||
+ | * de créer un lien vers le template principal; | ||
+ | * de créer des variables avec des valeurs par défaut; | ||
+ | * d' | ||
+ | * d' | ||
+ | |||
+ | |||
+ | **Emplacements dans tutors**\\ | ||
+ | /// | ||
+ | **Reponse html d'une page**\\ | ||
+ | Fichier à copier : [[tutoriels: | ||
+ | **Guide du développeur**\\ | ||
+ | [[fr: | ||
+ | **Consulter les fichiers de Jelix framework**\\ | ||
+ | Pour une réponse html : /// | ||
+ | Pour le templare : /// | ||
+ | **Important**\\ | ||
+ | Pour indiquer à Jelix que vous avez créé une réponse personnalisée, | ||
+ | |||
+ | <code ini> | ||
+ | [responses] | ||
+ | html = myhtmlResponse | ||
+ | </ | ||
+ | |||
+ | Dans cette [[fr: | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Partie 3 ===== | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Le layer main.tpl ==== | ||
+ | L' | ||
+ | |||
+ | |||
+ | Le rôle de ce template est d' | ||
+ | * le sommaire ou menu sous la forme d'une zone; | ||
+ | * un texte sous la forme d'un template ou d'une zone; | ||
+ | * un header et un footer. | ||
+ | |||
+ | |||
+ | Il faut préciser certaines particularités: | ||
+ | * la variable de template $j_basepath du chemin vers le logo Jelix; | ||
+ | * c'est une variable de template définie par Jelix. Vous pouvez définir vos variables de template. | ||
+ | * la balise <div id=" | ||
+ | * le sélecteur css id.link-extern est défini dans la réponse personnalisée. | ||
+ | * la variable de Jelix : @jelix~jelix.framework.name@. | ||
+ | * ce sélecteur de locale est définie dans la bibliothèque de Jelix. Il s'agit du nom de Jelix dans la langue et le charset que vous avec initialisé dans le fichier de configuration // | ||
+ | |||
+ | |||
+ | **Emplacement dans tutors**\\ | ||
+ | /// | ||
+ | **Le template principal**\\ | ||
+ | Fichier sources à copier : // | ||
+ | **Guide du développeur**\\ | ||
+ | [[fr: | ||
+ | [[fr: | ||
+ | [[fr: | ||
+ | [[fr: | ||
+ | **Consulter les fichiers de Jelix framework**\\ | ||
+ | Pour la localisation : /// | ||
+ | Aussi : /// | ||
+ | Pour les variables de template : /// | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== Le contenu dans un template ==== | ||
+ | L' | ||
+ | |||
+ | |||
+ | **Emplacement dans tutors**\\ | ||
+ | /// | ||
+ | **Le template inséré dans un autre template**\\ | ||
+ | Fichiers sources à copier : // | ||
+ | **Guide du développeur**\\ | ||
+ | [[fr: | ||
+ | **Consulter les fichiers de Jelix framework**\\ | ||
+ | Pour les propriétés et méthodes du template : /// | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== Partie 4 ===== | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ==== La zone sommaire notre menu ==== | ||
+ | Ce tutoriel se termine par deux exemples simples d' | ||
+ | * la zone sommaire gère le choix d' | ||
+ | * la zone contenu affiche un template selon un de ses paramètres. | ||
+ | |||
+ | **Emplacements dans tutors**\\ | ||
+ | /// | ||
+ | **Le menu géré par une zone**\\ | ||
+ | Fichiers sources à copier : // | ||
+ | **Le contenu géré par une zone**\\ | ||
+ | Fichiers sources à copier : // | ||
+ | |||
+ | |||
+ | **Guide du développeur**\\ | ||
+ | [[fr: | ||
+ | |||
+ | |||
+ | **Consulter les fichiers de Jelix framework**\\ | ||
+ | Pour les propriétés et méthodes du template : / | ||
+ | Pour la classe de base d'une zone : / | ||
+ | Pour un appel direct d'un plugin : / | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | ===== En terminant ===== | ||
+ | Pour exécuter ce tutoriel sur votre serveur local, vous devez taper : **http:// | ||
+ | \\ | ||
+ | \\ | ||
+ | ---- | ||
+ | Les tutors ont été créés par turowbye.\\ | ||
+ | Mais il faut mentionner particulièrement la participation de laurentj, bballizlife et doms.\\ | ||