FrankizII
Présentation
Frankiz est le portail des élèves hébergé par Frankiz.
Il a été recodé entièrement par les BR2002 et BR2003.
Le site a été conçu pour être:
- modulaire
- La majorité des informations sont présentées sous forme de modules que l'utilisateur pour choisir d'afficher ou d'effacer.
- skinnable
- La page est générée en XML avant d'être transformée au niveau du serveur par une feuille de style XSLT afin d'obtenir le format voulu ( HTML, WAP...) Puis le html est retravaillé au niveau du client par l'intermédiaire d'une feuille de style CSS.
- extensible
- Il est facile de rajouter un module.
De plus, il contient une interface de gestion du site, des utilisateurs et d'administration du réseau.
Réalisation de skins
Frankiz a été conçu pour pouvoir être entièrement skinné. Ainsi toutes les pages php génèrent un code XML.
Il existe alors 2 catégories de skins:
- les skins XSL, qui vont convertir le XML dans un autre langage: XHTML, WML, RSS, DocBook...
- les skins CSS, qui vont mettre en forme le XHTML dans le navigateur.
Note: Initialement il était prévu de n'avoir qu'une seule XSLT par langage de sortie, mais pendant le développement, plusieurs XSLT générant du XHTML sont apparues, nous sommmes en train d'essayer de les fusionner. (05/2005)
Réalisation de skin XSLT
Attention à ne pas multiplier les skins XSL, une par langage de sortie suffit.
Les templates XSLT se trouvent dans
htdocs/skins/nom_du_format_de_sortie/xsl
La template racine doit se nommer
skin.xsl
Structure de base d'un template xslt:
<?xml version="1.0" encoding="UTF-8" ?> <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> <xsl:output method="xml" indent="yes" encoding="utf-8" doctype-public="-//W3C//DTD XHTML 1.1//EN" doctype-system="http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"/> ... mon contenu ... </xsl:stylesheet>
TODO La DTD du XML Frankiz est à compléter :-(
Réalisation de skin CSS
Le répertoire où on place les fichiers est:
htdocs/skins/xhtml/nom_de_la_css
Note: Actuellement les fichiers se trouvent dans htdocs/skins/pico/nom_de_la_css
Pour commencer la création d'une nouvelle css, vous pouvez utiliser vous baser sur la CSS par défaut qui se trouve dans:
htdocs/skins/xhtml/default
Une CSS doit contenir:
- un fichier style.css qui contient la feuille de style proprement dite.
- un fichier description.txt qui contient la description de la skin, qui apparaitra sur le site.
Pages d'administration
Structure du site: Arborescence des fichiers
/bin Scripts qui génèrent du code pour le site (Cron)
/binets Répertoire contenant les sites des binets
/cache Fichiers temporaires
/data /data/affiches Images des activités /data/annonces Images des annonces /data/binets Logos des binets en attente de validation /data/faq Fichiers de la FAQ /data/mailpromo Logs d'envoi de mails promo /data/photos Photos du trombi /data/trombino Photos trombi en attente de validation /data/xshare Fichiers du XShare
/doc Documentation
/etc Fichiers de configuration
/htdocs /htdocs/admin Pages d'administration /htdocs/binets Répertoire contenant des liens symboliques vers les sites des binets visibles depuis l'extérieur /htdocs/gestion Pages de gestion pour les utilisateurs (kès, bob, binets) /htdocs/include Fichiers contenant des fonctions ou des entètes utilisées dans plusieurs pages /htdocs/migration Fichiers de migration du site (Pour convertir les bases de données de Frankiz vers Frankiz2, inutile à ce jour) /htdocs/modules Répertoire contenant tous les modules du site. /htdocs/profil Préférences de l'utilisateur /htdocs/proposition Fichiers pour proposer des annonces, activités, mails promo... /htdocs/skins Répertoire contenant les différentes skins (voir la section skins) /htdocs/stats Génération de graphiques statistiques /htdocs/webperso Répertoire contenant des liens symboliques vers les sites perso visibles depuis l'extérieur
/webperso Répertoire contenant les sites perso
Ajouter des modules
Retour : Accueil
