Read Me

Utopia - Lisez-moi
==================

Version 1.007 - mars 2008
https://sourceforge.net/projects/utopiacms/


Requis :
--------

	- PHP 5.0.2 ou plus (les versions précédentes de PHP 5 sont boguées).
	- Extensions PHP requises : pcre, session, SPL, PDO.
	- Autres extensions PHP recommandées (mais pas indispensables) : dom, 
	mbstring, curl (toutes les 3 fortements recommandées), gd, xsl, zlib.
	- Une base de donnée supportée par PDO (MySQL ou SQLite conseillée).
	- 10 Mo de disque dur (5 Mo pour les fichiers et 5 Mo pour la base de 
	donnée) - 20 Mo recommandés.
	- Un navigateur récent supportant le DOM et le CSS, tel que Firefox 
	(recommandé), Opera 9, Internet Explorer 6.

	Par ailleurs, de bonnes connaissances sur PHP, SQL, XHTML, CSS et 
	Javascript sont recommandées.

	Pour les meilleures performances, je recommande l'extension PHP 
	eaccelerator (qui permet de diviser jusqu'à 4 le temps d'exécution !) ou 
	tout autre système de mise en cache du code PHP.


Résumé :
--------

* Le Kernel supporte en natif :
	- Support multilingue.
	- Charger / Sauvegarder des données de configuration dans des fichiers 
	PHP (ou XML au besoin).
	- Initialisation automatique des données de configuration après 
	chargement.
	- Charger / Sauvegarder des fichiers de langue dans des fichiers PHP (ou 
	XML au besoin).
	- Gestion avancée des erreurs avec contexte de debuggage.
	- Gestion des journaux d'erreurs.
	- Gestion du chargement de librairies.
	- Gestion de l'écriture locale des dates et des nombres.

* Interopérabilité et internationalisation :
	- Négociation du format : recherche du format préféré de l'utilisateur 
	et conversion au bon format via une transformation XSL à la volée, 
	utilisation du format par défaut le cas échéant. Formats disponibles par 
	défaut : XHTML 1.1, HTML 4.01 Strict, WML 1.1 et Texte.
	- Négociation de la langue : recherche de la langue préférée de 
	l'utilisateur, utilisation de la langue par défaut le cas échéant.
	- Négociation du charset : recherche du charset préféré de l'utilisateur 
	et conversion à la volée des données au bon charset, utilisation du 
	charset par défaut le cas échéant. Les charsets supportés par Utopia 
	sont les mêmes que ceux supportés par PHP (l'UTF-8 est toujours 
	supporté, c'est le charset interne d'Utopia et de PHP).
	- Négociation de l'encodage : recherche de l'encodage préféré de 
	l'utilisateur et compression des données à la volée, pas d'encodage le 
	cas échéant. Encodages supportés par défaut : gzip et deflate.
	- Affichage adapté aux périphériques de sortie de l'utilisateur, grâce 
	aux feuilles de style (pour l'impression).
	- La librairie webform assure un traitement irréprochable des données 
	utilisateur, avec contrôle des données et validation.
	- Conversion des données entrées par l'utilisation par la méthode POST 
	du charset utilisateur au charset interne (UTF-8) pour traitement et 
	stockage dans la base de donnée.
	- Support de la configuration locale de l'utilisateur : affichage des 
	heures avec le bon fuseau horaire, les dates et les nombres au format 
	local.
	- Support des politiques de confidentialité P3P définies par le W3C et 
	supporté en standard par Internet Explorer 6.

* Les librairies de base sont :
	- cache : permet la mise en cache de parties de page.
	- database : gestion des bases de données.
	- diff : permet mettre en évidence les différences entre deux textes.
	- email : création et envoi d'E-mails.
	- file : quelques fonctions générique pour le système de fichier.
	- interface : gestion des interfaces [dépendance : user].
	  + interface/blank : interface Blank.
	  + interface/classic : interface Classic.
	  + interface/functional : interface Functional.
	  + interface/sober : interface Sober.
	  + interface/sun : interface Sun.
	- password : test de la robustesse des mots de passe.
	- rtt : tests permettant de distinguer un humain d'un robot.
	- user : gestion des utilisateurs [dépendance : usergroup].
	- usergroup : gestion des groupes d'utilisateurs [dépendance : user].
	- webform : gestion de formulaires web et de l'upload [dépendance : 
	interface, user].
	- xhtml_to_pdf : conversion à la volée de documents XHTML en PDF. En 
	pratique, permet également de convertir des documents HTML grâce à la 
	fonction PHP DOMDocument::loadHTMLFile().

* Les modules de base sont :
	- article : gestion d'articles ou de news.
	  + Gestion de l'état des articles pour le suivit (en cours de 
	    rédaction, proposé, validé...).
	  + Possibilité de définir une période de diffusion (article accessible 
	    uniquement durant une période pré-enregistrée).
	  + Synchronisation des articles entre les différentes langues du site.
	  + Gestion avancée des catégories, gérant l'ordre entre les catégories, 
	    les catégories virtuelles (liens vers d'autres catégories) et la 
	    synchronisation entre toutes les langues du site pour que votre site 
	    ressemble vraiment à un site multilingue...
	  + Gestion des commentaires pour chaque articles avec modération à 
	    priori ou à postiori.
	  + Gestion de la notation des articles (appréciations des lecteurs).
	  + Gestion de backends complets au format RSS et au format texte.
	  + Gestion des révisions pour les articles : l'historique permet de 
	revenir facilement à une version antérieure d'un article.
	- forum : gestion complet de forums de discussion.
	  + Gestion du code XHTML contrôlé.
	  + Gestion des smileys.
	- mailinglist : gestion de listes de diffusion.
	- statistic : statistiques de fréquentation détaillés.


Téléchargement :
----------------

	Vous trouverez la dernière version de ce portail sur 
	https://sourceforge.net/projects/utopiacms/.


Crédits :
---------

	Olivier BICHLER <olivier.bichler@laposte.net>

	Et également les personnes suivantes, qui ont contribué à la mise au 
	point de ce projet :
	Fabien BICHLER, Matthieu SARTER, Fabrice LUCHIER.


Support :
---------

	En cas de problème, n'hésitez pas à me contacter par E-mail à l'adresse 
	olivier.bichler@laposte.net.