tuto automne

Download Tuto Automne

Post on 18-Jul-2015

80 views

Category:

Documents

0 download

Embed Size (px)

TRANSCRIPT

Guide des bonnes pratiques - Bonnes pratiques de gestion des modles de pages - Bonnes pratiqueshttp://doc.automne-cms.org/web/Documentation/42-tutoriels-automne.php

Table Des MatiresTutoriels Automne ................................................. 2 Guide des bonnes pratiques ........................................... 3 Bonnes pratiques de gestion des modles de pages ........................... 5 Bonnes pratiques de gestion des modles de ranges ......................... 9 Crer un modle de page ............................................ 10 L'entte de page .................................................. 12 Les liens de navigation .............................................. 17 Les espaces client ................................................. 23 Crer un module POLYMOD. .......................................... 26 Exemples de modules Polymod ........................................ 36 Module Commentaires .............................................. 37 Automne pour les nuls ............................................... 40 Prliminaire ..................................................... 41 Etat des lieux .................................................... 44 Cest quoi un CMS ? ................................................ 47 Tour du propritaire ................................................ 50 Automne pour les nuls - deuxime partie ................................. 58 Utilit des ranges de contenu ........................................ 60 Travaux pratiques ................................................ 64

Page 1/67Cr le 11/04/2012 14:55:11

Guide des bonnes pratiques - Bonnes pratiques de gestion des modles de pages - Bonnes pratiqueshttp://doc.automne-cms.org/web/Documentation/42-tutoriels-automne.php

Tutoriels Automne

Ces tutoriels sont destins vous aider la prise en main du CMS Automne. Nous vous invitons consulter galement les tutoriels vidos ainsi que la rubrique consacre tutoriels sur le forum. Cette section est amene s'toffer, en attendant n'hsitez pas poser vos questions sur le forum.

TutorielsBonnes pratiques Modles de pages Modles de ranges Crer un modle de page L'entte de page Les liens de navigation Les espaces client Crer un module POLYMOD. Exemples de modules Polymod Module Commentaires Automne pour les nuls Initiation l'utilisation du logiciel CMS Automne pour les dbutants Prliminaire Etat des lieux Cest quoi un CMS ? Tour du propritaire Automne pour les nuls (2) Ranges de contenu Travaux pratiques

Page 2/67Cr le 11/04/2012 14:54:46

Guide des bonnes pratiques - Bonnes pratiques de gestion des modles de pages - Bonnes pratiqueshttp://doc.automne-cms.org/web/Documentation/42-tutoriels-automne.php

Guide des bonnes pratiques

Voici quelques recommandations de bonnes pratiques pour tout projet ralis avec Automne. Ces dernires permettent le plus souvent de conserver suffisamment de souplesse pour lvolution dun projet sans avoir forcement de caractre fonctionnel obligatoire.

Voir aussi les bonnes pratiques concernant :

Modles de pages Modles de ranges

Aprs linstallationSupprimer les fichiers dinstallation Modifier le mot de passe root Directement aprs linstallation il faut penser supprimer le fichier install.php et les archives la racine. Il est galement important de se connecter et de modifier le mot de passe et ladresse email de lutilisateur root.

Dmarrage du dveloppementDans les paramtres Automne cochez les options suivantes : Activer le dbuggage systme, Activer le dbuggage du Polymod, Activer les alertes emails des pages 404. Ces options sont seront utiles pendant vos dveloppements et vous indiqueront l'origine des erreurs. Pensez dsactiver les options de debug lorsque vous tes en production. Attention, lorsque le site est en production, lactivation du dbug peut perturber laffichage ct client et prsenter des problmes de scurit. En phase dvolution, modification, ou correction, il faut faire attention, les messages deviennent alors visible ct client mais pour tout le monde. Pensez galement personnaliser les adresses email de ladministrateur et de lapplication.

Racine de larborescenceCrer une premire page sous la page 1 Crer un nouveau site et pointer la racine sur la nouvelle page La cration dun site ne devrait pas se faire directement sur la page 1, qui est la page racine dAutomne. Il vaut mieux crer une premire sous-page - la 2 si on prend le cas dun Automne vierge - et la designer comme racine de votre site dans la gestion des sites. Cette bonne pratique vous permettra de crer plusieurs sites au mme niveau directement sous la page 1. Dans la plus part des cas, les sites en langues trangres sont traites avec des pages racines diffrentes, toutes des

Page 3/67Cr le 11/04/2012 14:54:47

Guide des bonnes pratiques - Bonnes pratiques de gestion des modles de pages - Bonnes pratiqueshttp://doc.automne-cms.org/web/Documentation/42-tutoriels-automne.php

enfants de la page 1. Un projet peut s'internationaliser au cours de son existence, le dplacement de larborescence tout en restant faisable devient alors une vraie problmatique (structurelle, SEO etc..)

InternationalisationSi vous devez dvelopper des sites en plusieurs langues, nous vous conseillons d'installer le module Traductions pour la gestion des libells de vos modles.

Gestion des droitsCrer un groupe administrateurs Crer votre compte utilisateur Pour dfinir les droits du groupe administrateurs, il vous suffit de cocher l'option "Administrateur" dans l'onglet Administration du groupe. Il est souhaitable daborder la dfinition des droits par groupe et non pas par profil utilisateur. Au dmarrage, il existe toujours un petit nombre d'utilisateurs, mais trs vite ce nombre peut grandir et poser un problme de gestion. Dautant plus quune approche par utilisateur est souvent source derreurs lors de modification densemble. Si vous avez besoin dactiver les droits ct client, faites le, dans la mesure du possible, ds le dbut du projet. Cela vous vitera de refaire lensemble de vos tests. Si ces droits sont activs, pensez vrifier le site sans tre connect depuis ladministration (en anonyme), sans quoi le rsultat serait fauss. Crez vous un profil utilisateur, ajouter le au groupe d'administrateurs Ne travaillez pas avec le compte root.

Gestion des fichiersCrer un dossier dans /css pour y ranger vos feuilles de styles Crer un dossier dans /js pour y ranger vos fichiers javascripts Crer un dossier dans /img pour y ranger vos images Le nom du dossier est laiss votre apprciation, faites en sorte quil puisse tre identifier rapidement. Un second site pourrait voir le jour, un dossier spcifique pour chaque permet de mieux identifier a qui appartient les fichiers. A partir de la version 4.2, si vous nommez votre dossier comme le nom du code d'un site, alors Automne chargera automatiquement vos fichiers JS ou CSS. Par exemple si le nom de code de votre site est 'fr' vous pouvez dcider d'organiser vos fichiers ainsi : /css/fr/styles.css /css/fr/print.css /js/fr/jquery-latest.js /js/fr/plugin.jquery.js

Voir aussi les bonnes pratiques suivantes :Modles de pages Modles de ranges

Page 4/67Cr le 11/04/2012 14:54:47

Guide des bonnes pratiques - Bonnes pratiques de gestion des modles de pages - Bonnes pratiqueshttp://doc.automne-cms.org/web/Documentation/42-tutoriels-automne.php

Bonnes pratiques de gestion des modles de pages

Pour chaque modle de page, pensez mettre un titre explicite pouvant tre lisible depuis les proprits de page, une description comprhensible et utile et une vignette illustrative.

Langue de la pageGrer dynamiquement la langue dans le modle de page Plutt que de fixer la langue en dur dans le modle, vous pouvez utiliser la variable {page:self:language}, ainsi la langue sera dfinie en fonction des proprits de la page.

Titre de la pageCrer un titre de page optimis pour le rfrencement naturel La construction dun titre dune page dans un modle doit tre pense en accord avec loptimisation du rfrencement. la balise est placer en premier. Il est grable depuis les proprits de page et permet aux rdacteurs dintervenir facilement. Ce title peut tre complt voire remplac dans le cas de page dynamique. Exemple : sur une page actualits, la liste des actualits aura pour titre de page, la valeur fournie par par contre, sur le dtail dune actualit, le titre de la page doit tre le titre de lactualit pour conserver une pertinence en matire de rfrencement. N.B : Depuis la 4.1, on peut faire des recherches polymod dans les modles de page. Voir lexemple pour les actualits. Pour complter le title de la page, on prfrera , qui peut tre gr et personnalis de faon plus spcifique que la constante APPLICATION_LABEL qui est commune a tous les sites se dfinies dans une instance dAutomne. - Si le titre des pages (attention pas le lien) est trop long et peu explicite dans larborescence des pages dAutomne, car optimis pour le rfrencement, vous pouvez faire apparatre les liens la place depuis les paramtres Automne.

Jeux de caractresDfinir le jeu de caractres Il est trs important de dfinir le bon jeu de caractre sans quoi des navigateurs comme IE feront leur propre interprtation, souvent errone, de la page. Toute nouvelle installation dAutomne (4.x) se fait en utf-8, si vous avez mis jour depuis Automne 3.x, le jeu de caractre sera gnralement en ISO par dfaut.

Page 5/67Cr le 11/04/2012 14:54:48

Guide des bonnes pratiques - Bonnes pratiques de gestion des modles de pages - Bonnes pratiqueshttp://doc.automne-cms.org/web/Documentation/42-tutoriels-automne.php

Pour dclare le jeu de caractre dans votre modle de page, il suffit d'crire dans votre entte (head) : HTML 4.01/XHTML 1.0 HTML5/XHTML5

Compression des fichierUtiliser atm-css-tags Utiliser atm-js-tags Protger les commentaires de copyright des librairie