Détail du système de fichiers d'Automne
Automne est composé d'un ensemble important de répertoires et de fichiers.
Voici la liste des fichiers et répertoires importants. Passez votre souris sur les différents fichiers ou répertoires pour afficher la description de leur usage.
Vous trouverez en bas de cette liste un certain nombre de fichiers spécifiques dont il est impératif de connaître le fonctionnement.
/
|-- .htaccess
|-- 403.php
|-- 404.php
|-- automne
| |-- CHANGELOG
| |-- LICENSE-GPL
| |-- UPDATE.DENY
| |-- VERSION
| |-- cms_error_log
| |-- Zend
| | `-- ...
| |-- admin
| | |-- css
| | | `-- ...
| | |-- img
| | | `-- ...
| | |-- index.php
| | |-- js
| | | |-- edit
| | | | `-- ...
| | | |-- ext
| | | | `-- ...
| | | `-- ...
| | |-- modules
| | | |-- cms_aliases
| | | | `-- ...
| | | |-- cms_forms
| | | | `-- ...
| | | `-- polymod
| | | `-- ...
| | |-- v3
| | | `-- ...
| | `-- ...
| |-- admin-v3
| | `-- ...
| |-- bin
| | |-- atm_lib.sh
| | `-- bgrun.exe
| |-- linx
| | `-- ...
| |-- blackbirdjs
| | `-- ...
| |-- cache
| | `-- ...
| |-- classes
| | |-- common
| | | |-- contactdata.php
| | | |-- contactdataldap.php
| | | |-- contactdatascatalog.php
| | | |-- date.php
| | | |-- email.php
| | | |-- emailscatalog.php
| | | |-- grandfather.php
| | | |-- href.php
| | | |-- language.php
| | | |-- languagescatalog.php
| | | |-- ldapauth.php
| | | |-- ldapconnexion.php
| | | |-- ldapquery.php
| | | |-- ldapset.php
| | | |-- log.php
| | | |-- logcatalog.php
| | | |-- query.php
| | | |-- search.php
| | | |-- sensitiveio.php
| | | `-- stack.php
| | |-- dialogs
| | | |-- context.php
| | | |-- dialog.php
| | | |-- dialoghref.php
| | | |-- dialoglistboxes.php
| | | |-- fileupload.php
| | | |-- jsdialog.php
| | | |-- loadingDialog.php
| | | |-- submenu.php
| | | |-- submenus.php
| | | |-- texteditor.php
| | | |-- toolbar.php
| | | `-- view.php
| | |-- files
| | | |-- archive-bzip.php
| | | |-- archive-gzip.php
| | | |-- archive-tar.php
| | | |-- archive-zip.php
| | | |-- archive.php
| | | |-- filesManagement.php
| | | |-- fileupload.php
| | | |-- htaccess.txt
| | | |-- mime.types
| | | |-- patch.php
| | | |-- sqlDump.php
| | | `-- xhtml.ent
| | |-- modules
| | | |-- cms_aliases
| | | | |-- CHANGELOG
| | | | |-- VERSION
| | | | `-- resource.php
| | | |-- cms_aliases.php
| | | |-- cms_forms
| | | | |-- CHANGELOG
| | | | |-- VERSION
| | | | |-- action.php
| | | | |-- block.php
| | | | |-- field.php
| | | | |-- form.php
| | | | |-- formcategories.php
| | | | |-- formssearch.php
| | | | |-- record.php
| | | | |-- sender.php
| | | | `-- sendingssearch.php
| | | |-- cms_forms.php
| | | |-- cms_forms_rc.xml
| | | |-- module.php
| | | |-- modulePolymodValidation.php
| | | |-- moduleValidation.php
| | | |-- modulecategoriescatalog.php
| | | |-- modulecategory.php
| | | |-- moduleclientspace.php
| | | |-- modulesCodes.php
| | | |-- modulesTags.php
| | | |-- modulescatalog.php
| | | |-- polymod
| | | | |-- CHANGELOG
| | | | |-- VERSION
| | | | |-- block.php
| | | | |-- object_i18nm.php
| | | | |-- object_search.php
| | | | |-- objects
| | | | | |-- object_boolean.php
| | | | | |-- object_catalog.php
| | | | | |-- object_categories.php
| | | | | |-- object_common.php
| | | | | |-- object_date.php
| | | | | |-- object_email.php
| | | | | |-- object_file.php
| | | | | |-- object_float.php
| | | | | |-- object_href.php
| | | | | |-- object_image.php
| | | | | |-- object_integer.php
| | | | | |-- object_language.php
| | | | | |-- object_page.php
| | | | | |-- object_string.php
| | | | | |-- object_text.php
| | | | | `-- object_usergroup.php
| | | | |-- poly_definition_funtions.php
| | | | |-- poly_definition_parsing.php
| | | | |-- poly_module_structure.php
| | | | |-- poly_plugin_definition.php
| | | | |-- poly_rss_definition.php
| | | | |-- polyobjects
| | | | | |-- multi_poly_object.php
| | | | | |-- poly_object.php
| | | | | |-- poly_object_catalog.php
| | | | | |-- poly_object_definition.php
| | | | | `-- poly_object_field.php
| | | | `-- subobjects
| | | | |-- subobject_common.php
| | | | |-- subobject_date.php
| | | | |-- subobject_integer.php
| | | | |-- subobject_string.php
| | | | `-- subobject_text.php
| | | |-- polymod.php
| | | |-- readStandardParam.php
| | | |-- standard
| | | | |-- block.php
| | | | |-- blockfile.php
| | | | |-- blockflash.php
| | | | |-- blockimage.php
| | | | |-- blockscatalog.php
| | | | |-- blocktext.php
| | | | |-- blockvarchar.php
| | | | |-- clientspace.php
| | | | |-- clientspacescatalog.php
| | | | |-- row.php
| | | | `-- rowscatalog.php
| | | |-- standard.php
| | | |-- standard_rc.xml
| | | |-- superResourceExample.php
| | | `-- super_resource.php
| | |-- pageContent
| | | |-- linx.php
| | | |-- linxcondition.php
| | | |-- linxdisplay.php
| | | |-- linxescatalog.php
| | | |-- linxnodespec.php
| | | |-- xml2Array.php
| | | |-- xmldomdocument.php
| | | |-- xmlparser.php
| | | `-- xmltag.php
| | |-- scripts
| | | |-- backgroundScript
| | | | |-- backgroundscript.php
| | | | `-- processmanager.php
| | | |-- daily_routine.php
| | | |-- regenerateall.php
| | | |-- script.php
| | | `-- scriptsmanager.php
| | |-- tree
| | | |-- page.php
| | | |-- pagetemplate.php
| | | |-- pagetemplatescatalog.php
| | | |-- tree.php
| | | |-- website.php
| | | `-- websitescatalog.php
| | |-- user
| | | |-- profile.php
| | | |-- profilemodulecategoriesclearances.php
| | | |-- profileuser.php
| | | |-- profileuserscatalog.php
| | | |-- profileusersgroup.php
| | | `-- profileusersgroupscatalog.php
| | `-- workflow
| | | |-- resource.php
| | | |-- resourcestatus.php
| | | |-- resourcevalidation.php
| | | |-- resourcevalidationinfo.php
| | | `-- resourcevalidationscatalog.php
| |-- codemirror
| | `-- ...
| |-- cssmin
| | `-- ...
| |-- ext
| | `-- ...
| |-- fckeditor
| | |-- automnePlugin
| | | |-- automneLinks
| | | | `-- ...
| | | |-- cms_forms
| | | | `-- ...
| | | |-- fck_cleanword.js
| | | `-- polymod
| | | `-- ...
| | |-- editor
| | | `-- ...
| | |-- fckconfig.php
| | |-- fckeditor.js
| | |-- fckeditor.php
| | `-- license.txt
| |-- jsmin
| | `-- ...
| |-- phpMyAdmin
| | `-- ...
| |-- playerflv
| | `-- ...
| |-- playermp3
| | `-- ...
| |-- prettyprint
| | `-- ...
| |-- sql
| | |-- automne4-I18NM_messages.sql
| | |-- automne4-scratch.sql
| | |-- automne4.sql
| | | `-- updates
| | | `-- ...
| |-- swfobject
| | `-- ...
| |-- templates
| | |-- example.xml
| | |-- htaccess
| | | |-- htaccess_file
| | | |-- htaccess_no
| | | `-- htaccess_yes
| | |-- images
| | | `-- ...
| | |-- mail
| | | |-- images
| | | | `-- ...
| | | `-- mail.xml
| | |-- print.xml
| | |-- rows
| | | |-- images
| | | | `-- ...
| | | `-- ...
| | `-- splash.xml
| |-- tmp
| | `-- ...
| |-- upload
| | `-- ...
| `-- xhtmlValidator
| |-- taglist.php
| `-- ...
|-- files
| |-- cms_forms
| | `-- ...
| |-- pmedia
| | |-- deleted
| | | `-- ...
| | |-- edited
| | | `-- ...
| | `-- public
| | `-- ...
| |-- pnews
| | |-- deleted
| | | `-- ...
| | |-- edited
| | | `-- ...
| | `-- public
| | `-- ...
| `-- standard
| |-- deleted
| | `-- ...
| |-- edited
| | `-- ...
| |-- edition
| | `-- ...
| |-- fckeditor
| | `-- ...
| |-- icons
| | `-- ...
| `-- public
| `-- ...
|-- cms_rc.php
|-- cms_rc_admin.php
|-- cms_rc_frontend.php
|-- config.php
|-- css
| |-- cssmanager.php
| |-- editor.css
| |-- editorstyles.xml
| |-- editortemplates.xml
| |-- modules
| | `-- ...
| |-- print.css
| `-- ...
|-- favicon.ico
|-- file.php
|-- html
| `-- ...
|-- imagezoom.php
|-- img
| `-- ...
|-- index.php
|-- is_alive.php
|-- js
| |-- CMS_functions.js
| |-- jsmanager.php
| `-- modules
| |-- pmedia
| | `-- ...
| `-- pnews
| `-- ...
|-- robots.txt
|-- rss
| `-- rss.php
|-- swf
| `-- ...
`-- web
`-- ...
Quelques fichiers et répertoires particuliers à connaître :
/config.php
Ce fichier est un des plus important. C'est dans ce fichier que sont stockés les paramètres de configuration propres à votre installation d'Automne. Par exemple les informations nécessaires à la connection à la base de données.
/cms_rc.php
Ce fichier contient tous les paramètres de configuration par défaut d'Automne. Si l'un de ces paramètre ne vous convient pas, vous pouvez le modifier en définissant la constante correspondante dans le fichier /config.php.
Attention, vous ne devez en aucun cas modifier ce fichier directement.
/404.php
Ce fichier gère les erreurs de pages introuvable. Il affiche un message d'erreur "404 page non trouvée" si un lien pointe vers un fichier qui n'existe plus.
Dans le cas ou ce lien comporte un identifiant, le fichier recherche si une page correspond à cet identifiant et le cas échéant, il renvoie vers cette page silencieusement (via une redirection "301 Moved Permanently"). Cela permet d'éviter autant que possible les liens cassés dans le cas ou l'adresse d'une page est modifiée.
Dans le cas où aucun identifiant n'existe dans l'adresse demandée ou si la page correspondant à cet identifiant n'existe pas, le message d'erreur est affiché.
Pour afficher un autre message d'erreur spécifique pour votre site, vous pouvez créer un fichier /404.html. Si un tel fichier existe, il sera affiché à la place du message par défaut d'Automne.
Dans le cas où le lien demandé correspond à une image (extension png, jpg ou gif), la page renverra l'image /img/404.png si elle existe.
/.htaccess
Ce fichier permet de spécifier au serveur Apache les points suivants :
- Utiliser le fichier /404.php en cas d'erreur 404.
- Utiliser le fichier /403.php en cas d'erreur 403.
- Désactiver le listing du contenu des répertoires.
- Spécifie le fichier index.php comme fichier par défaut.
- Spécifie certaines configurations pour PHP.
Pour la sécurité de votre installation d'Automne, il est important que ce fichier existe et que votre serveur Apache accepte l'utilisation de fichiers .htaccess (voir directive AllowOverride d'Apache).
/js/modules/
Ce répertoire permet de stocker des fichiers Javascript spécifiques aux modules Automne.
Il peut contenir des répertoires, nommés du nom du codename d'un module.
Dans ce cas, dans ce répertoire, l'ensemble des fichiers javascript (extension js) seront automatiquement ajoutés dans toute page employant une rangée <block module="codename" ...></block> ou un espace client <clientspace module="codename" .../> du module concerné.
Dans le cas où plusieurs fichiers javascript sont à inclure, ils seront inclus par ordre alphabétique. Vous pouvez préfixer le nom avec un numéro pour gérer l'ordre d'inclusion.
Exemple :
Pour le module "pnews", si les fichiers suivants sont présents sur le serveur , et qu'une page "Actualités" possède une rangée qui utilise un tag <block module="pnews" ...></block>, alors ces fichiers seront automatiquement inclus lors de la régénération de la page :
- /js/modules/pnews/1common.js
- /js/modules/pnews/2specific.js
/css/modules/
Ce répertoire permet de stocker des fichiers de feuilles de styles CSS spécifiques aux modules Automne.
Il doit comporter un ou plusieurs fichiers CSS nommés avec le codename du module concerné au format suivant : codename[-media].css
Avec codename étant le codename du module concerné et media (facultatif), le média de destination parmis : 'all' (défaut), 'aural', 'braille', 'embossed', 'handheld', 'print', 'projection', 'screen', 'tty', 'tv'.
Exemple : pmedia.css pour le module médiathèque. Ou pmedia-print.css pour le module médiathèque spécifiquement pour les feuilles de style d'impression.
Ces fichiers seront automatiquement ajoutés dans toute page employant une rangée <block module="codename" ...></block> ou un espace client <clientspace module="codename" .../> du module concerné
/automne/bin/atm_lib.sh
Ce script permet de sauvegarder ou de restaurer une sauvegarde d'Automne en ligne de commande sur les systèmes unix.
Pour cela, dans une comande shell, à la racine du site automne concerné, saisissez la commande suivante : $ source automne/bin/atm_lib.sh Un message d'aide vous fournira les commandes possible.
Vous pouvez éditer ce fichier pour obtenir la liste de ces commandes.
/automne/UPDATE.DENY
Ce fichier permet de contrôler la mise à jour de certains fichiers lors des mises à jour d'Automne.
Il est utile lorsque vous modifiez un fichier d'Automne et que vous ne souhaitez pas que cette modification soit écrasée par une mise à jour éventuelle.
Tout fichier PHP d'Automne est susceptible de faire l'objet d'une mise à jour. Pensez donc à systématiquement faire figurer dans ce fichier UPDATE.DENY le nom des fichiers que vous modifiez, et en commentaire, la nature de la modification.
Si lors d'une mise à jour, un fichier à mettre à jour se trouve noté dans ce fichier, la mise à jour s'arrêtera et on vous demandera de mettre à jour manuellement le fichier en y reportant les modifications manuelles que vous avez fait dans le fichier original.
/automne/cms_error_log
Ce fichier loggue toutes les erreurs qui survienne dans Automne.
Lorsque vous désactivez le mode debug d'Automne (ce qui devrait toujours être le cas sur un site en production), vous pourrez toujours trouver dans ce fichier le détail des erreurs qui surviennent ou sont survenues.
Il est possible de supprimer ce fichier s'il devient trop volumineux. Automne le recrééra si besoin.
Attention toutefois, en cas de cms_error_log volumineux il est toujours préférable de corriger les erreurs indiquées pour qu'elle ne surviennent plus.
/automne/templates/
Ce répertoire stocke les fichiers XML servant pour les modèles de page d'Automne.
Vous pouvez apporter des modifications manuelles aux fichiers XML employés par Automne.
Attention à régénérer manuellement les pages concernées par ces modifications si vous souhaiter appliquer les modifications que vous avez réalisées.
/automne/templates/rows/
Ce répertoire stocke les fichiers XML servant pour les rangées de contenu d'Automne.
Vous pouvez y apporter des modifications manuelles aux fichiers XML employés par Automne.
Attention à régénérer manuellement les pages concernées par ces modifications si vous souhaiter appliquer les modifications que vous avez réalisé.
/automne/xhtmlValidator/taglist.php
Ce fichier stocke la liste des règles de tags et d'attribus utilisés par le validateur XHTML.
Vous pouvez étendre ces règles ou les restreindre en recopiant les configurations que vous souhaitez dans le fichier /config.php.
Editez ce fichier pour plus d'informations.
/automne/classes/modules/standard_rc.xml
Ce fichier stocke l'ensemble des paramètres Automne et notamment permet d'activer ou de désactiver le debuggage système.
Dans le cas ou vous ne pourriez plus du tout accéder à l'interface d'administration d'Automne en raison d'une erreur et que vous souhaitiez activer le débuggage système, vous pouvez éditer ce fichier et modifier la valeur de la ligne SYSTEM_DEBUG (passer la valeur à 1).
/automne/classes/scripts/daily_routine.php
Ce fichier permet d'activer les tâches quotidiennes sur votre instance d'Automne.
Vous devez le faire figurer dans les tâches planifiées de votre serveur (crontab) si vous souhaitez que les publications et dépuplications automatiques fonctionnent.
Exemple de code à mettre dans votre crontab pour une éxécution quotidienne :
0 0 * * * www-data php /chemin/du/docroot/automne/classes/scripts/daily_routine.php Ici www-data est l'utilisateur employé pour exécuter Apache. Adaptez cet exemple à votre propre configuration.
Télécharger la Documentation Automne
English
2 contribution(s)
Par yann le 24/03/2010 13:37:53 :
Le config.php étant chargé sur toutes les pages du site il est pratique de stocker dans celui ci des données à utiliser un peu partout, typiquement des id de pages ou de champs que l'on définira en tant que constante.Exemple:
define("CHAMP_DATE_UTILISATEUR", 2608);
On pourra ensuite utiliser dans une rangée ou dans un template la constante CHAMP_DATE_UTILISATEUR.
Il faut cependant faire attention à ne pas utiliser de variable dans le config.php, car celles-ci ne sont plus accessibles en édition de page provoquant ainsi des erreurs.
Il est possible de contourner la limitation en employant des fonctions.
Exemple:
function getArrayOfDatas(){
return array(1,2,3,4,5,6,7,8,9,10);
}
Par Frank Taillandier le 24/03/2010 14:19:13 :
Le fichier /automne/cms_error_log est affiché dans l'onglet des paramètres serveurs depuis la version 4.01 d'Automne.Une rotation de ce fichier d'erreur a été mise en place depuis la version 4. Le fichier /automne/cms_error_log est maintenant compressé quotidiennement dans le dossier /automne/logs.