Download - Tuto Automne

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 librairies avec //> En production, pensez utiliser ces deux outils qui vous permettent de gagner en rapidit daffichage en compressant les fichiers et en limitant le nombre de requtes HTTP. Penser respecter un ordre dappel cohrent pour vous viter des surprises ;) Afin de conserver les crdits des librairies tierces, veuillez utiliser //> cela peut aussi permettre dviter les problmes de compression dans le cas ou le code de la librairie est dj minifi.

atm-meta-tagsPlacer l juste avant la fin de votre head. Ce doit tre la dernire balise avant votre . A partir de la version 4.2, vous pouvez passer en attribut les meta que vous souhaitez grer vous mme dans le modle. Exemple si je veux dfinir moi mme la description en rcuprant la valeur d'un module, je peux crire :

CodenameUtiliser des noms de code la place des identifiants de page Lors de la conception des appels aux noeuds darborescence dans les modles, il faut prfrer lusage des noms de code (codename) celui des identifiants de page. Cette solution est plus souple, car facilement grable dans linterface dAutomne en cas de changement et ce sans intervenir dans les modles de page. {{title}} Si vous voulez faire un lien vers la page d'accueil en faisant rfrence au nom de code de la page, on crira plutt : {{title}} De plus en cas dinternationalisation, le site sera facilement duplicable en ltat.

Page 6/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

Attention, les codenames ne sont pas utilisable dans tous les cas, il faut quils se trouvent dans larborescence dAutomne pour pouvoir tre employs. Par exemple les flux RSS ne les supportent pas.

Google AnalyticsPlacer le code Google Analytics entre ... Placer le code Google Analytics entre les balises atm-noadmin afin de ne pas fausser les statistiques de visites du site lors de lintervention dans ladministration. var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-xxxxxxxx-x']); _gaq.push(['_trackPageview']); (function() { var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true; ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })();

Range par dfautPlacer les ranges par dfaut Vous avez la possibilit de placer des ranges par dfaut dans les proprits de votre modle de page. Cela peut acclrer la cration de page et facilite grandement la prise en main pour les nouveaux utilisateurs.

Activation/DsactivationDsactiver le modle de page dAccueil Pensez dsactiver les modles de page nayant plus de raison d'apparatre dans la cration des nouvelles pages comme le modle de page d'accueil s'il est uniquement prvu pour.

Aide lditionNhsitez pas placer des textes daide dans des tags pour aider les personnes qui ditent les contenus de pages. Exemple d'aide l'utilisateur pour l'utilisation d'une range formulaire : Aide : cliquez sur le crayon et slectionner un formulaire afficher {{data}}

Page 7/67Cr le 11/04/2012 14:54:49

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

Page 8/67Cr le 11/04/2012 14:54:49

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 ranges

Pour chaque modles de range, pensez a mettre un titre explicite pouvant tre lisible depuis la modification des pages, une description comprhensible. Nhsitez pas a personnaliser l'icne de votre range pour permettre une meilleur identification. Utilisez des ranges simples, viter de faire tous les traitements possibles dans une seule et mme range, cela facilitera la maintenance applicative. Utilisez au maximum le meta-langage dAutomne, nayez recours au PHP que si vous navez pas dautre choix, cela assurera la compatibilit ascendante de vos dveloppements et favorisera la reprise de code par dautres dveloppeurs. Nhsitez pas placer des textes daide dans des tags pour aider les personnes qui ditent les contenus de pages.

NomenclatureNumroter les ranges pour les ordonner Les ranges sont affiches par ordre alphabtique. Pensez numroter vos nouvelles ranges et les ordonner afin doffrir dans la liste les ranges les plus usuelles. Nommer vos ranges en pensant avant tout aux utilisateurs. Nul besoin de vous sentir oblig dajouter le nom du module dans le nom de la range. Exemple : Derniers billets du blog ou Dernires actualits sont plus parlants pour un utilisateur que [Actualits] Recherche ou [Actualits] Dtail Vous disposez d'un filtre pour afficher les ranges relatives un module.

GestionDsactiver les ranges inutiles : pensez dsactiver les ranges nayant plus de raison d'apparatre dans ldition des pages. Crer des groupes de ranges, si vous souhaitez interdire laccs certaines ranges aux utilisateurs.

Page 9/67Cr le 11/04/2012 14:54:49

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

Crer un modle de page

Ce tutoriel, conu avant tout pour les dveloppeurs web, prsente une mthode de conception de modle de page pour Automne. C'est une tape incontournable, puisque l'heure actuelle aucun thme n'est encore disponible en tlchargement. La dmarche sera familire pour ceux qui travaillent selon les recommandations du W3C : elle consiste transformer un modle de page XHTML en modle Automne laide de balises XML. Nous verrons donc dans cette premire partie comment convertir un modle de page XHTML en modle Automne. Les balises XML dAutomne vont permettre notamment de : grer les diffrents balises prsentes dans lentte de page (mta-donnes, appels des diffrents fichiers CSS, JS et RSS) ; dfinir les diffrentes zones de contenus modifiables, galement appels espaces clients ; grer les lments de navigations (menus, plan de site, fil dariane) ; On peut donc au choix partir de rien et concevoir sa page laide des langages XHTML, CSS et JS ou bien adapter un thme existant - sous peine de disposer de fonctionnalits quivalentes dans Automne. Dans ce tutoriel, nous prendrons un exemple qui se limite aux modules polymod livrs par dfaut avec Automne, savoir le module Actualits et le module Mdiathque.

Modle Automne = XHTML + XMLPartons dun code XHTML tout ce quil y a de plus classique : Titre de page - Site Web

Page 10/67Cr le 11/04/2012 14:54:50

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

  • Accueil

Produits Services

  • Support

Tlchargements Espace Client Vous tes ici : Accueil > Actualits .....mon contenu.... .....mon contenu....

  • Plan du site

Mentions lgales Accessibilit

Contact Nous avons ici plusieurs lments statiques, que nous allons devoir rendre dynamique comme le titre de la page, la description et les mots-clefs associs. Nous avons aussi des listes de liens de navigations qui devront pouvoir se mettre jour en cas de changement de libell ou de structure de larborescence. Enfin nous avons des zones dans lesquelles du contenu devra pouvoir tre insr par les rdacteurs du site. A laide de balises XML, nous allons pouvoir transformer ce fichier XHTML en modle de page pour Automne.

SommaireL'entte de page Les liens de navigation Les espaces client

Page 11/67Cr le 11/04/2012 14:54:50

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

L'entte de page

Dclaration du type de documentLa premire chose faire c'est d'indiquer le DTD que vous allez utiliser pour votre modle de page. Par dfaut, Automne utilise le type XHTML Transitionnel, mais rien ne nous empche de dclarer un type de document HTML5 par exemple : Pour forcer l'utilisation d'un doctype diffrent il faut ajouter dans le fichier config.php : define("APPLICATION_XHTML_DTD", "");

Langue de la pagePour chaque site dclar dans Automne, une langue par dfaut est dfinie. Pour accder la valeur de la langue dfinie, on fera appel la variable {page:sef:language}

Titre de page et nom du siteDans cet exemple le titre de page est compos du titre de la page et du nom du site web, une pratique courante en rfrencement. Titre de page : Site Web La balise ou son quivalent qui va afficher automatiquement le titre de la page en cours. Cest le champ Titre affich dans l'onglet des proprits de page qui est ici rcupr par Automne.

Pour afficher le nom du site web nous allons utiliser la balise . La constante qui contient le nom de l'instance d'Automne est APPLICATION_LABEL, elle correspond au libell du site que vous pouvez dfinir en tant quadministrateur dans longlet Administration, paramtres.

Page 12/67Cr le 11/04/2012 14:54:50

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

Il est galement possible d'afficher cette valeur dans vos modles de page avec la balise suivante :

Nous crirons donc le code suivant pour afficher ces deux informations : : A noter qu' partir de la version 4.1 d'Automne vous pouvez utiliser les balises pour les modules polymod et la balise dans les modles. Il est donc possible de spcifier un titre de page dynamique qui changera en fonction des paramtres passs dans l'URL de page. Exemple si je veux afficher le titre de l'actualit je peux crire dans mon modle de page : {Actualites:Titre:value} - Dans cet exemple, il faut attribuer le nom de code news la page qui affiche les actualits. Il faut galement qu'on se trouve dans le cas o on ait un paramtre news dans l'URL pour tre sur qu'on est bien sur l'affichage d'une actualit. A adapter selon le nom de code et le paramtre pass dans l'URL donc.

Balises pour les mta-donnes de la pageLes balises mta peuvent contenir de nombreuses informations comme la description de la page, les mots-clefs, la langue utilise dans la page, lauteur, son adresse mail, les liens vers les flux RSS, etc. Toutes ces informations sont ditables soit dans la fentre des proprits de page, soit dans la gestion des sites qui permet de renseigner des mta-donnes par dfaut pour un site, qui seront appliques automatiquement sur toutes les pages qui nauraient pas de mta-donnes spcifiques renseignes.

Page 13/67Cr le 11/04/2012 14:54:51

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

Automne offre la possibilit de crer vos propres flux RSS personnaliss, une fois le flux cre vous devez lajouter dans les mta-donnes libres du site ou de la page si vous souhaitez permettre lauto-dtection de vos flux par le navigateur. Pour rcuprer lensemble de ces informations il suffit juste de faire appel la balise Dans notre exemple on va donc remplacer les lignes suivantes : par : Cette balise est obligatoire dans chaque modle de page. Elle permet de grer certaines fonctionnalits propres Automne. Cest par exemple cette balise qui permet dactiver les fonctions ddition des pages. Il permet aussi dajouter les fichiers Javascript et les feuilles de styles fournies par les diffrents modules qui seront employs dans les pages.

Appel des feuilles de styles et des fichiers JavascriptAutomne respecte les standards du W3C et le concept de sparation entre la structure (XHTML), la prsentation (CSS) et le comportement (JS). Pour appeler les feuilles de styles et les fichiers Javascript, on peut au choix soit utiliser la syntaxe par dfaut du W3C, soit passer par les balises XML dAutomne qui en plus dappeler les fichiers, soccupera doptimiser la performance de votre site en minifiant, en concatnant et en compressant tous les fichiers CSS et tous les fichiers JS. Cette option est surtout destine tre utiliser en production, nous vous recommandons de ne pas lutiliser en cours de dveloppement, ne serait-ce que pour dbugguer plus facilement vos pages avec Firebug par exemple. Il arrive souvent quon fasse appel plusieurs feuilles de styles comme dans notre exemple. Une fois en production on pourra alors remplacer :

Page 14/67Cr le 11/04/2012 14:54:51

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

par : Si comme dans mon exemple jai des feuilles de style spcifiques pour dautres type de mdia comme pour limpression ou le mobile, il me faut alors faire un appel par type de mdia : On crira alors : Si vous utilisez les commentaires conditionnels pour corriger les bugs CSS sur IE7 par exemple, vu le peu de code CSS et lappel supplmentaire ncessaire, il n'y a aucun intrt utiliser dans ce cas. Mme principe pour les fichiers javascript, on peut tous les regrouper en un seul appel et conomiser ainsi de prcieuses requtes HTTP. Dans notre cas, nous pouvons donc remplacer les 2 appels suivants : par : Voil donc pour le code de lentte de page, si on rsume on avait : Titre de page - Site web Transform en modle Automne, voici ce que a donne : - Maintenant que nous avons termin avec lentte de page, passons au contenu.

Page 16/67Cr le 11/04/2012 14:54:52

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

Les liens de navigation

Les outils de gestion de contenu sont l pour vous faciliter la vie, Automne ne droge pas la rgle et vous propose de grer les liens de navigations dans vos pages l'aide de plusieurs balises XML. Ces balises vont vous permettre de grer diffrents types de liens : les liens directs vers d'autres pages, les liens vers les sous-pages d'une page de manire rcursive - ou pas - mais galement les liens descendants pour grer un fil d'Ariane. Dans notre exemple, nous affichons deux listes de liens : une liste de navigation principale plusieurs niveaux ; un fil d'Ariane ; un groupe de liens dans le bas de page.

Les liens rcursifsVoici le code XHTML de notre menu de navigation principale :

  • Accueil

Produits Services

  • Support

Tlchargements

Espace client

Ce menu correspond des pages de l'arborescence du site organises en rubriques et sous-rubriques. Nous devrons donc construire dans Automne l'arborescence correspondante :

Chaque page a un identifiant unique (inscrit entre parenthses dans l'onglet arborescence), nous allons nous servir de cet identifiant pour construire le menu de navigation qui affichera toutes les sous-pages sur 2 niveaux partir

Page 17/67Cr le 11/04/2012 14:54:52

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

de de la page racine de notre site. Pour ces premiers liens de navigations, nous allons utiliser les de type rcursif, qui vont permettre d'afficher plusieurs niveaux de notre arborescence : .... La balise permet de faire beaucoup de choses. Outre le fait de gnrer plusieurs types de liens, elle vous permet de slectionner prcisment quelle pages de l'arborescence afficher, o dmarrer et combien de niveaux afficher. Faisons donc notre et prcisons l'identifiant de page du noeud () de dpart () ainsi que la remplir. Une fois notre slection faite nous obtenons donc le code XML suivant : 2 Cette syntaxe XML est certes un peu verbeuse mais elle vous permet d'afficher prcisment n'importe quel liste de liens partir de votre arborescence. Il nous reste encore traiter l'affichage () de notre liste de liens, dfinir le modle HTML () et le modle de rcursivit (). 2

{{title}} {{sublevel}}

  • {{sublevel}}

Ce code XML une fois interprt s'affichera ainsi :

Page 18/67Cr le 11/04/2012 14:54:52

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

Accueil Produits Services Support Tlchargements Espace Client Consultez la documentation complte de la balise pour connatre tous les attributs qu'on peut ajouter sur les liens rcursifs. Cela vous sera trs utile pour vous aider styler l'aide de CSS vos menus de navigation selon le niveau ou la page slectionne.

Et voil pour notre menu principal de navigation, il sera automatiquement mis jour en cas de cration de nouvelles pages au premier ou au second niveau, ainsi qu'en cas de changement de titre de page ou d'URL.

Fil d'ArianePour construire notre fil d'Ariane, nous allons utiliser le type de liens descendants (desclinks). Ce type de lien permet de tracer le parcours entre un point A et un point B de l'arborescence, je dois donc spcifier le point de dpart et le point d'arrive. En gnral on va utiliser les types de noeud relatifs pour cela, ce qui nous permettra par exemple de construire une suite de liens allant de la racine de notre site la page en cours. Nous crirons donc le code XML suivant : {{title}} Ce qui produira par exemple le rendu HTML suivant : Accueil Services Espace Client

Les liens des pages filles (ou sous-pages)Passons maintenant au menu de bas de page. Contrairement au menu de navigation principale, ici je n'ai besoin d'afficher qu'un seul niveau de profondeur. Vous pouvez utiliser une page dpublie comme un dossier pour regrouper des liens de mme nature et utiliser ensuite les de type sublinks dans vos modles.

Page 19/67Cr le 11/04/2012 14:54:53

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

{{title}}

  • {{sublevel}}

Ce qui nous produira l'affichage la liste de liens suivante : Plan du site Mentions lgales Accessibilit Contact En continuant avec notre exemple, je remplace le code XHTML des liens par le code XML d'Automne dans notre modle : - 2 {{title}}{{sublevel}}

  • {{sublevel}}

Page 20/67Cr le 11/04/2012 14:54:53

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

Vous tes ici : {{title}} .....mon contenu..... .....mon contenu.....

{{title}}

  • {{sublevel}}

Vu que nous utilisons un doctype HTML5 dans cet exemple, j'aurais pu aussi en profiter pour utiliser les balises header, aside, nav ou footer, il aurait alors fallu ajouter un peu de javascript pour qu'Internet Explorer puisse styler correctement ces lments.

Page 21/67Cr le 11/04/2012 14:54:54

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

Notre modle de page est maintenant presque termin, il nous reste encore ajouter les zones de contenus modifiables.

Page 22/67Cr le 11/04/2012 14:54:54

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

Les espaces client

Ce sont dans les espaces client que le rdacteur pourra insrer les ranges de contenus de son choix. Dans les proprits du modle de page, l'administrateur du site pourra ensuite proposer des ranges par dfaut. On peut galement crer des groupes de ranges et ne les autoriser que dans certains modles, mais en ce qui concerne le dveloppement du modle de page, le travail se limite dfinir les zones qui afficheront les diffrentes ranges de contenus. Pour cela rien de plus simple, il suffit de faire appel l'lment . Cet lment a deux attributs obligatoires : module et id. Le premier va indiquer quel module est reli cette zone et le second va permettre d'identifier chaque espace client, ce qui sera utile aussi pour la compatibilit entre modles. Le module le plus utilis dans Automne est le module de gestion de pages, aussi appel module standard. On crira donc par exemple pour la zone de contenu principal : Nous vous recommandons de choisir des identifiants avec une bonne smantique afin de savoir quelle type d'information ils contiennent. Ce sera utile pour la compatibilit entre modles.

Dans notre exemple il y a deux endroits o j'ai prvu d'avoir du contenu, une zone qui contiendra le contenu principal et une autre qui contiendra du contenu annexe que je vais dfinir ainsi : Il ne nous reste plus qu' insrer nos deux espaces client dans notre modle : -

Page 23/67Cr le 11/04/2012 14:54:54

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

2

{{title}}{{sublevel}}

  • {{sublevel}}

Vous tes ici : {{title}}

{{title}}

Page 24/67Cr le 11/04/2012 14:54:55

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

  • {{sublevel}}

Dernire mise jour : {{date}} par {{firstname}} {{lastname}} Il existe d'autres balises XML comme insr dans le bas de page qui vous permettent d'aller plus loin dans les fonctionnalits que peut offrir un modle de page. Nous obtenons ainsi un modle de page trs gnrique que je vais pouvoir dcliner facilement soit en modifiant la langue utilise dans le modle, les feuilles de styles, les identifiants de page appels ou les espace clients prsents. La prochaine tape consiste dvelopper ses propres ranges de contenu ou adapter les ranges existantes pour personnaliser vos pages. J'espre que ce tutoriel vous aura aid mieux comprendre comment dvelopper vos propres modles de page avec Automne. Et si vous avez des questions, n'oubliez pas que le forum est l pour vous aider :)

Page 25/67Cr le 11/04/2012 14:54:55

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

Crer un module POLYMOD.

Il serait trs long et peu explicite de dcrire la totalit des fonctionnalits offertes, nous allons pour le moment prendre un exemple concret de module pour expliquer le fonctionnement. Il est ensuite possible de ladapter vos besoins rels pour raliser votre propre application. Pour cet exemple, nous allons crer un module de gestion documentaire un peu plus simple que la Mdiathque prsente dans la dmo d'Automne. ATTENTION : Certaines oprations ne peuvent tre modifies une fois effectue. De mme, un module ne peut tre supprim une fois cr. Il est donc prfrable dutiliser une version dmo dAutomne pour faire des essais plutt que de commencer directement crer votre module sur un site en ligne. Le module de gestion documentaire permet de grer des fichiers de type Word, PDF, etc. au travers de votre site. Il permet de catgoriser ces fichiers comme vous le souhaitez, dy associer des droits (de visibilit ou de modification) et davoir un point central de contrle de tous les fichiers mis disposition sur votre site quelque soit lendroit ou vous les emploierez ensuite.

Cration du module :Dans la section "Administration > Gestion des modules" cliquez sur Nouveau .

Vous pourrez ainsi ajouter une nouvelle application. Donnez un nom cette application ainsi quun identifiant (codename). Cet identifiant sera employ par Automne pour dsigner de faon unique votre module. Il ne doit donc pas avoir dj t utilis. Veillez le choisir de faon adquate car il ne pourra pas tre modifi ensuite. Nous allons donc crer un module ayant comme identifiant pdocs (par convention, p pour Polymod, puis docs pour documents ) et comme nom Gestion documentaire .

Cration de la structure des objets :Une fois cr, le module attend la cration des objets le composant. Un objet servant de rceptacle aux champs lmentaires dont nous avons parl plus haut. Chaque objet possde un nom, une description un statut de

Page 26/67Cr le 11/04/2012 14:54:56

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

ressource (voir lexplication sur la page adquate dAutomne). Dautres options sont disponibles pour ces objets mais nous en verrons le dtail plus tard.

ATTENTION : Tous les paramtres dun objet sont modifiable ultrieurement lexception du statut de ressource, veillez donc bien le choisir ds la cration de lobjet.

Pour notre exemple nous navons besoin que dun seul type dobjet : lobjet Document qui stockera le fichier ainsi quun ensemble de mta donnes relatives ce fichier. Cet objet sera de type ressource primaire car nous souhaitons que son contenu ne soit visible en ligne que suite sa validation par un utilisateur possdant les privilges adquat (bien entendu ce point est dfinir en fonction de votre besoin). De plus le fait dtre une ressource primaire permet lobjet davoir automatiquement des dates de publications ce qui peut-tre utile pour publier ou dpublier des documents des dates donnes. Il est donc maintenant ncessaire de dfinir prcisment quels seront les champs lmentaires composant notre objet Document Commenons par son titre. Nous allons crer un nouveau champ et choisir dans la liste droulante quel type dlment sera utilis pour ce champ. Ici, un champ de type chane de caractre semble convenir car nous souhaitons navoir quune simple labellisation du document sans mise en forme. Suite ce choix, un formulaire apparat permettant de dfinir prcisment le champ : Titre, description (facultatif) suivit de paramtres propres au champ dfinit (longueur maximum : 255 caractres et la vrification sur lemail qui permet dans dautres cas de vrifier que la valeur saisie est bien un email valide). Pour finir, 3 cases cocher permettent de spcifier des options particulires pour le champ :

Est il obligatoire. Dans le cas dun titre, on peut estimer que oui, sa saisie est ncessaire. Ajouter au formulaire de recherche. Dans ladministration du module, permet dutiliser ce champ lors des

Page 27/67Cr le 11/04/2012 14:54:56

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

recherches par mot cl ou de proposer une liste droulante pour les objets composs. Dans le cas prsent, cette case est cocher car le titre est un lment prendre en compte dans les recherches. Visible dans les rsultats dune recherche. Ce paramtre permet de dfinir les champs importants que vous souhaitez voir apparatre dans les rsultats des recherches que vous effectuerez sur vos documents dans ladministration du module. Le titre en tant que 1er champ de lobjet est obligatoirement visible, inutile donc de cocher cette case ici.

Une fois ces diffrents paramtres slectionns, validez la cration de votre champ pour passer au suivant. ATTENTION : Tous les paramtres dun champ sont modifiable ultrieurement lexception de son type, veillez donc bien le choisir ds la cration de lobjet. Suite au titre, nous crerons 4 champs supplmentaires :

Un champ catgorie, permettant de catgoriser les diffrents fichiers grs par le module. Deux options importantes pour ce type de champ : les catgories multiple (permet dassocier une seule catgorie ou plusieurs pour notre fichier), ici plusieurs catgories pour un mme document semble justifi. La catgorie de plus haut niveau parmet de spcifier (une fois des catgories cres dans ladministration du module) den choisir une comme racine pour ce champ. Ce peut-tre trs utile dans le cas ou plusieurs champs sont de type catgorie pour un mme objet donn. Un champ langue (peut-tre omis dans le cas ou le multilinguisme ne fait pas parti de votre besoin. Un champ description au format texte (avec mise en forme HTML) permettra de dcrire plus prcisment le document. Enfin le champ fichier proprement parler qui permettra dimporter le fichier Word, PDF, etc. qui sera associ lobjet document que nous avons cr.

Page 28/67Cr le 11/04/2012 14:54:56

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

Gestion des documents, administration du module :Une fois la cration de la structure des diffrents objets termins, vous pouvez commencer la saisie du contenu du module via la liste des applications au mme titre que tout module existant. Ladministration du module est construite automatiquement en fonction de la structure des diffrents objets que vous aurez cr. Saisissez si besoin un ensemble de catgories (pensez suite la cration de la premire catgorie vous donner les droits daccs cette catgorie dans votre profil) puis vous pouvez crer / rechercher / modifier / supprimer / valider vos objets cot administration du site. Au besoin vous pouvez diter les proprits de vos objets si certains dtails sont peaufiner. Il est aussi possible dajouter des champs si certains se rvlent manquant. Vous pouvez aussi supprimer des champs. ATTENTION : En supprimant un champ, vous perdrez toutes les donnes dj saisies pour ce champ. Lorsque vous jugez que le cot administratif du module convient votre besoin, vous pouvez penser la manire dont vous souhaitez afficher les informations fournies par le module cot publique du site.

Affichage du module cot public :3 possibilits soffrent vous pour afficher vos donnes provenant du module sur le site publique gr par Automne :

Cration de range de contenu : Une range de contenu est la mthode la plus souple et la plus complte pour insrer le contenu du module dans votre site. En effet, vous pouvez de cette manire spcifier compltement laffichage du contenu ainsi que le moteur de recherche le cas chant.

Page 29/67Cr le 11/04/2012 14:54:56

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

Cration dun plug-in pour lditeur visuel (WYSIWYG) : Un plug-in pour lditeur visuel (WYSIWYG) vous permet dinsrer dans vos textes mis en forme un ou plusieurs lments provenant du module tout en gardant une liaison entre llment du module et son affichage : la suppression, la premption des dates de publication ou labsence de droits sur lobjet le feront automatiquement disparatre de lendroit ou vous lavez insr pour tre remplac par ce que vous souhaitez (texte explicatif ou mme un simple vide.

Cration de fils RSS : Un fils RSS est gnralement complmentaire de lune des deux autres mthodes daffichage cit plus haut. Cela permet vos internautes de pouvoir suivre simplement lajout de nouveaux contenus pour un module donn (par exemple un module dactualit ou un module de blog). Bien entendu ces 3 mthodes daffichages sont complmentaires les unes des autres et il est tout fait possible de les combiner les unes aux autres pour un module donn. Nous nous contenterons dans cet exemple de crer une range de contenu pour le module documents. En effet les deux autres mthodes daffichages (plug-in pour lditeur visuel et fils RSS) respectent les mmes principes et de plus, la dmo dAutomne 3.3.0 prsente deux exemples de plug-in pour lditeur visuel pour le module Gestion documentaire et un exemple de fil RSS pour le module Actualits . Nhsitez pas vous y rfrer en cas de besoin ou bien de poser vos questions ce sujet sur le forum.

Cration dune range de contenu :Pour crer une range de contenu, allez dans la section Modles dAutomne puis sur longlet Bibliothque de ranges . Crez une nouvelle range vous ouvrira un zone de texte dans laquelle vous pourrez crer ici le code XHTML / XML ncessaire. ATTENTION : Il est ncessaire de parfaitement matriser XHTML et CSS pour pouvoir crer correctement une range de contenu pour votre site. Saisissez un nom pour votre range refltant son utilit. Par exemple nous allons crer ici un moteur de recherche pour afficher les divers documents du module, ce nom pourrait donc tre Gestion documentaire : Recherche . Il est important ici de comprendre les diffrents concepts ncessaires la cration dune range. Un certain nombre dtapes sont raliser au fur et mesure. Pour commencer, lensemble des tags XML disponibles pour un module sont dtaills en dessous de la zone de saisie de la range.

Cette aide dynamique vous listera tous les diffrents lments que vous pouvez employer en fonction de la structure que vous avez donn au module.

Page 30/67Cr le 11/04/2012 14:54:57

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

Slectionnez dans laide du module la syntaxe des Blocs de donnes , vous obtiendrez le dtail concernant le tag qui doit contenir lensemble des tags relatif votre module (une range pouvant accueillir des blocs de plusieurs modules diffrents). Cest donc par ce tag que vous devez commencer votre range avant toute chose. Dans ce tag, nous allons ensuite coder un formulaire qui servira lancer une recherche sur les documents du module. A ce niveau, vous pouvez saisir un simple formulaire en XHTML contenant un champ texte (pour la recherche par mots cl) suivi par exemple dune liste droulante pour pouvoir slectionner les documents par catgorie pour conclure notre formulaire nous allons bien sur ajouter un bouton de validation. Le code ressemble maintenant quelque chose comme cela : Rechercher des documents : Mots Cls :

Catgorie :


Maintenant il nous faut prciser sur quelle adresse doit se soumettre le formulaire, dans notre cas nous souhaitons quil affiche la mme page. Dans laide, consultez la partie Variables gnrales vous y trouverez la syntaxe des variables relative aux pages. Toutes les variables, relatives lenvironnement ou bien aux objets que vous allez manipuler sont entoures par deux accolades. Dans notre cas nous souhaitons avoir ladresse de la page en cours dans lattribut action du tag ce qui se traduit par {page:self:url}. Nous souhaitons aussi que le formulaire conserve les donnes qui y ont t saisies pour la recherche lorsquil se raffiche. Dans le champ texte nous allons donc remplir lattribut value avec la variable {request:string:keyword}. Enfin, nous souhaitons que le tag affiche lensemble des catgories relatives aux documents. Pour se faire, dans laide, nous allons slectionner le champ Catgories appartenant lobjet Document . Nous obtenons ici lensemble des variables et fonctions disponibles pour ce champ particulier. Lune des fonctions disponible est spcifiquement prvue pour rpondre ce besoin : la fonction selectOptions . Le formulaire a maintenant cette forme : Rechercher des documents : Mots Cls :

Catgorie :

Page 31/67Cr le 11/04/2012 14:54:57

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



Une fois le formulaire de recherche prpar, il faut maintenant rcuprer et interprter les valeurs quil envoie, lancer une recherche sur ces donnes et afficher les rsultats correspondants. Pour se faire, nous allons crer un moteur de recherche. La notion de recherche est trs importante dans la cration dune range. En effet, la plus grande partie des oprations daffichage des lments des modules consiste les rechercher avec un certain nombre de critres puis les afficher dune certaine manire. Comment apprhender correctement cette recherche ? Prenons un exemple simple : Imaginez un champ patates. Ce champ est compos de centaines de patates de diffrentes formes, catgorie, poids, taille, forme, etc. Vous souhaitez rechercher dans ce champ des patates rpondant un certain nombre de critres. Notre recherche va donc seffectuer de la manire suivante :

1. Nous cherchons des patates 2. Nous voulons que ces patates rpondent aux critres suivants (par exemple) : Une taille donne Une forme donne 3. Sur lensemble de patates rpondant aux critres ci-dessus, nous souhaitons trier les rsultats par taille de patate croissante. 4. Enfin, nous souhaitons avoir les 30 premires patates rpondant cet ensemble de critres. Donc pour rsumer, une recherche se compose de 3 grandes tapes :

Dfinir ce qui est recherch, Dfinir un ensemble de critres respecter pour les rsultats, Dfinir comment prsenter ces rsultats (tri et nombre de rsultats renvoyer). Revenons maintenant notre exemple initial : la recherche de documents. Dans cet exemple, nous allons donc rechercher des documents et les filtrer par mot-cl et / ou par catgorie. Pour ce faire, dans laide, consultez la partie Effectuer une recherche vous y trouverez la syntaxe des diffrents tags relatif cette tache. Nous commencerons par dfinir la cration dune nouvelle recherche et y spcifier les deux critres limitant pouvant provenir du formulaire cr plus haut. Cela nous donne un code de ce type : ... ...

Page 32/67Cr le 11/04/2012 14:54:57

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

Le tag dfini la recherche, les tags dfinissent les filtres (optionnels) appliquer sur cette recherche et les tags et dfinissent respectivement laffichage des rsultats et laffichage dans le cas ou il ny a aucun rsultat. Concernant laffichage des rsultats maintenant. Le tag sera lu pour chaque rsultat trouv par la recherche. Il faut donc dans ce tag dtailler laspect de laffichage dun document en se servant de tags XHTML classqiues pour la mise en forme, de tags de Travail pour spcifier des rgles propres au rsultat afficher ainsi que des variables des champs des documents. Ceci peut donc nous donner le code suivant : {Document:formatedDateStart|d/m/Y} - {Document:label} {Document:Categories:values:label} , {Document:Description:value} {Document:Fichier:fileHTML} - {Document:Fichier:fileSize}Mo Notez le tag permettant dafficher les diffrentes catgories du document ainsi quun lien permettant de relancer une recherche sur cette catgorie de documents. De mme, notez la vrification laide du tag sur la prsence dune icne associe au type de fichier avant dafficher cette icne (dans le cas o elle existe). Idem pour laffichage de la description du document. La range est pratiquement termine, il reste ajouter :

Un message dans le tag pour spcifier quaucun rsultat na t trouv : Aucun rsultat trouv pour votre recherche ...

Laffichage du nombre de rsultats trouvs avant laffichage du premier rsultat : {maxresults} rsultat(s) pour votre recherche

Un systme de pagination des rsultats afficher aprs le dernier rsultat de la page : {n} {n} < >

Page 33/67Cr le 11/04/2012 14:54:58

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

Et pour que cette pagination soit correctement prise en compte par le moteur de recherche, il faut lui ajouter juste avant le tag deux tags permettant de spcifier la page afficher et le nombre de rsultats par page : Une fois tout ceci agglomr, nous obtenons le code suivant pour la range documents : Rechercher des documents : Mots Cls :

Catgorie :


{maxresults} rsultat(s) pour votre recherche {Document:formatedDateStart|d/m/Y} - {Document:label} {Document:Categories:values:label} ,

Page 34/67Cr le 11/04/2012 14:54:58

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

{Document:Description:value} {Document:Fichier:fileHTML} - {Document:Fichier:fileSize}Mo {n} {n} < > Aucun rsultat trouv pour votre recherche ... Et vous pouvez faire voluer cette range de la manire qui rpond le mieux votre besoin. Vous pouvez aussi comme dans la dmo - scinder cette range en deux ranges distinctes (une partie formulaire de recherche , lautre partie affichage des rsultats ) pour rpondre un besoin particulier de mise en page.

Conclusion :Cet exemple pourrait tre bien plus dtaill mais lessentiel des concepts du systme sont dcrit ci-dessus. Vous trouverez dans la section suivante de cette documentation un ensemble dexemples dutilisation que nos avons mis en place sur dautres site. Ceci pour vous permettre davoir une meilleure vision densemble des capacits de cet outil. Le forum tant votre disposition pour toute demande daide, de conseils ou si vous constatez la moindre erreur.

Page 35/67Cr le 11/04/2012 14:54:59

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

Exemples de modules Polymod

Vous trouverez sur cette page quelques exemples simples de modules Polymod. Descriptif du fonctionnement, structure des objets et code XML des ranges de contenu. Tout le ncessaire pour pouvoir vous inspirer de ces modules pour crer vos propres modules simplement.

Modules disponiblesModule Commentaires

Page 36/67Cr le 11/04/2012 14:54:59

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

Module Commentaires

Module Commentaires :Le module Commentaires est celui qui est employ dans les pages de ce site pour crer les contributions visibles en bas de page. Vous trouverez ci-dessous la structure de l'objet Commentaire reproduire ainsi que la range de contenu permettant de crer la logique d'affichage sur le site. Bien entendu ce code est fourni titre d'exemple et peut tre modifi en fonction de vos besoins.

Structure de l'objet 'Commentaire' :Voici les diffrents champs (et leur type) qui composent un object "Commentaire" : Auteur (Chane de caractres) Email (Chane de caractres) Site web (Chane de caractres) Commentaire (Champ texte) Date de cration (Date) Page (Page) Notification par email (Notification par email)

Range de contenu :Voici le code XML qui permet de crer la range permettant d'afficher et de saisir les commentaires dans une page. Ici il s'agit du code employ pour la fonction "Ajouter une contribution" que l'on retrouve en bas de toutes les pages de documentation du ce site ainsi qu'en bas de cette page. Cette range effectue d'abord la recherche des commentaires pour la page en cours, puis elle affiche les rsultats ventuels. Elle permet en plus de saisir un commentaire en affichant un formulaire de saisie. Voir les {maxresults} contributions(s) Ajouter une contribution

Page 37/67Cr le 11/04/2012 14:54:59

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

Vos contributions : Par {Commentaire:Auteur:value} {Commentaire:Auteur:value} le {Commentaire:Date_de_creation:formatedValue|d/m/Y H:i:s} : {Commentaire:Commentaire:htmlvalue}
Ajouter une contribution : Les contributions servent complter la documentation en dtaillant des points prcis ou pour donner des exemples. Elles sont modres et peuvent tre supprimes sans pravis.
Pour poser des questions ou rapporter un bug, merci d'employer le forum. Votre contribution t ajoute !

  • Le champ {requiredname} est requis ...

Page 38/67Cr le 11/04/2012 14:55:00

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

  • Le champ {malformedname} est incorrect...

* Nom :

* Email (Invisible sur le site) :

Site :

* Texte (HTML non autoris) :

Date de votre contribution :

Page 39/67Cr le 11/04/2012 14:55:00

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

Automne pour les nuls

Ce tutoriel de dcouverte et de prise en main d'Automne est crit pour les dbutants par Jack Paloque-Berges (alias Jack81 sur le forum) un utilisateur d'automne. Dbutant sous ce systme lui-mme. :-) Il s'adresse ceux qui ont dj quelques notions de PHP/MSQL/CSS/XHTML et savent (ou pas) ce qu'est un CMS (Content Management Systme ou Gestion de contenu) mais peuvent tres surpris par les nouveauts qu'apporte Automne en terme de modularit et son exceptionnelle potentialit. Bien, que respectant les standard communs la plupart des outils de gestion de contenu proposs en Open Source, ce logiciel innove et il n'est pas vident au premier abord d'apprhender la richesse de son ergonomie. D'o la rdaction de cet tutoriel crit au jour le jour par un utilisateur chevronn des CMS qui nous explique en franais courant comment dcouvrir cette petite merveille. Pas pas, quand il a compris "comment a marche". :-) La suite :

Prliminaire Etat des lieux Cest quoi un CMS ? Tour du propritaire Automne pour les nuls (2) Ranges de contenu Travaux pratiques

Page 40/67Cr le 11/04/2012 14:55:01

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

Prliminaire

Ce prliminaire s'adresse ceux d'entre nous qui ne sont vraiment pas familiaris avec les CMS ou qui ont de la difficult comprendre le fonctionnement d'Automne tant soit peu que ce dernier sort de l'ordinaire. Les initis peuvent sauter ce chapitre bien que ce dernier soit conus pour emmener la comprhension en douceur des particularits de cet outil de travail trs diffrent de ce que nous connaissons dj. Je dcouvre Automne et, comme dit par ailleurs, suis trs favorablement sduit par ce CMS qui rpond n'en pas douter au besoin de pas mal d'entre nous. Dans ce fil, je vous propose de partager mon exprience de tests chez mon hbergeur et de la prise en main de ce programme totalement nouveau pour moi. Il y a tout apprendre mais quelques notions de HTML, XHTLL et PHP me paraissent suffisante pour dvelopper un (des) site(s) de qualit tant l'ergonomie de cet outil a t bien pense et professionnelle. Reste savoir si la configuration de notre serveur (mutualis dans mon cas) est compatible avec Automne qui, selon mon exprience, est un CMS en open source la pointe du progrs. Outre les tests chez non hbergeur (Nuxit) et la "compatibilit" , je voudrais ici faire remonter les bugs, les difficults comprendre, les victoires, les suggestions, et enfin, les plus et moins par rapport aux systmes de ce type dj existants. Tout d'abord, disons que trois lments ont retenu mon attention quand j'ai rencontr Automne. L'aspect multisite Le module POLYMOD. La qualit de l'ensemble.

L'aspect multi-site.Le rve qui devient ralit. Bien sr d'autres CMS font cela mais la pratique me montre que ce sont de vritables "usines gaz" pas la porte du premier venu et que la rigidit de ces systmes limite la crativit sauf tre dou de tous les talents (Codage, scurit, graphisme, inventivit). Bien videmment, je n'ai pas encore t au bout de mes tests et ne connais pas (encore) les limitations d'Automne dans ce domaine et je pressent que rien n'est gagn d'avance surtout pour l'utilisation que je prvois d'en faire, mais la ractivit du support dj fait ses preuves et je ne vous cache pas que c'est la premire chose que je teste quand je prvois d'adopter un CMS . Installer oui, mais aprs ?Le module POLYMOD

me parait rsoudre bien des questions par rapport aux autres CMS car, chacun le sait, nous devons habituellement intgrer les modules un un et, quand suite l'volution des versions toujours plus volues de ce genre d'outil, nous nous trouvons confronts des histoires de comptabilit (entre les versions et modules plus anciens) et surtout des failles de scurit. N''importe quel geek bidouilleur (plonasme) peut proposer en tlchargement une extension qui fonctionnera ou pas selon la version du noyau ou les caprices de paramtrage php de l'hbergeur qui souvent d'un jour l'autre

Page 41/67Cr le 11/04/2012 14:55:01

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

nous sucre une fonction absolument ncessaire laissant nos sites en carafe et nos yeux pour pleurer. Lol !!! D'aprs ce que j'ai compris, avec POLYMOD nous crons nos modules toujours compatibles avec le noyau. En plus, cela se fait facilement et notre pointure. Autrement dit, crer des applications comme des pro sans avoir besoin de chercher ailleurs la quintessence de la programmation d'autrui. A mon stade (quelques jours d'tude d'Automne), je n'ai pas encore fait le tour des bugs et des limitations mais commence avoir ma petite ide. J'ai compris que la volont des programmeurs de ce logiciel est d'aller de l'avant et apprcie au plus haut point la transparence comme la mise en place par exemple du Bug Tracker. Un peu d'humilit ne fait pas de mal. ;) Le POLYMOD donc, devrait rsoudre les problmes de recherche d'applications compatibles avec notre systme (ou celui que nous voulons crer) et nous inciter les dvelopper nous-mme avec un outil la porte d'un webmaster en herbe quelque peu inventif et observateur.

La qualit de l'ensemble.Loin de moi l'ide de cirer des chaussures, mais il semble qu'un soin tout particulier soit apport au dveloppement de ce logiciel. Il est certain que nous ne sommes pas arriv au bout (il est en constante volution) et que nous ressentons comme un relent d'inachev, mais, comme disait l'autre, Google ne s'est pas implment en un mois et personne n'a jusqu'ici de raison de s'en plaindre. Dans mon valuation des CMS existants, je privilgie la simplicit et fuis habituellement comme la peste les programmes trop jeunes, trop modernes et surtout gourmands en ressources. Pourquoi ? Parce que ma manie est de faire des sites internet pour moi-mme et les autres et de leur apprendre s'en servir (aux autres), et je sais pertinemment que mes aficionados n'ont pas toujours la comptence (et la patience) requise pour mettre en place et grer des systmes volus. Dans ce domaine, tout est volatile, et ce qui fonctionne aujourd'hui ici nous donnera une excellente erreur 403 demain et qui saura, sinon les dveloppeurs de la chose, remettre le train en marche si nous nous ne savons pas ? En proposant Automne, WS Interactive joue gagnant, et ceux d'entre nous qui sauront collationner avec cette structure en les aidant dvelopper leur produit gagneront avec elle. D'o ce sujet que je viens d'ouvrir mon bnfice perso d'abord et celui de la communaut (les dveloppeurs y compris off course) ensuite ou en mme temps. Question d'apprciation. :-))) Je dbute sous Automne mais connais ce logiciel depuis pas mal de temps dj. En fait, mes premires visites sur ce site m'avaient laiss circonspect et j'avoue ne pas avoir suivi l'volution comme je le fais avec d'autres "marques". Cette fois-ci, j'ai t arrt et comme vous le voyez je suis encore l quelques semaines aprs. C'est que cette fois-ci, j'ai vraiment ressenti le potentiel de cette initiative qui semble tenir la route et est porteuse d'avenir car nous en somme aujourd'hui au Web 2.0.0 (+). Ma crainte est de ne pas moi-mme techniquement "tenir la route" tant cette dernire mouture (V4.0.1) est volue, et, si je prends le temps d'crire ceci aujourd'hui, c'est que j'ai une absolu confiance en l'avenir de cette contribution car, de tous les CMS existants, j'ai rarement vu une facture si labore mme si elle pche par sa "jeunesse" et ne prends pas (encore) en compte certains paramtres pourtant vidents dans le monde du framework communautaire. Les dveloppeurs d'Automne n'ont rien attendre de moi si ce n'est l'avis (clair) d'un simple utilisateur qui cherche des rponses sa propre incomptence.

Page 42/67Cr le 11/04/2012 14:55:01

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

J'value cette contribution car elle me semble correspondre ce que beaucoup d'entre nous (les geeks bidouilleurs incomptents) recherchent. Mettre la disposition de nos clients et amis des solutions adaptes leurs propres besoins en jouant l'interface entre les dveloppeurs patents et ceux qui en savent moins que nous.

Page 43/67Cr le 11/04/2012 14:55:02

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

Etat des lieux

J''ai fais le choix d'installer automne V4.0.1 sur un host virtuel de mon serveur accdant la page d'accueil principale par un sous domaine. Mon serveur est est multidomaine bien que mutualis.

Premiers essais et problmes rencontrsLes fichiers d'installation posent quelques problmes (Au jour d'aujourd'hui 29/03/10) mais cela doit tre rgl et cela permet au profane de tester en live le support qui rpond au quart de tour (+1). L'accs l'administration du systme nous donne une excellente impression mais laisse apparaitre quelques lourdeurs. Cette dlicate motion s'estompe quand on dcouvre les subtilits du-dit systme et le passage la version 4.0.1 semble rsoudre ces problmes. Il est regrettable qu'il faille se reloguer frquemment mais ceci doit pouvoir se rgler quelque part, et le dbutant se demande pourquoi il est prfrable de se dloguer pour voir ses modifications tres prises en compte moins qu'il n'ait rien compris la fonction "rgnration des pages" ce qui est mon cas pour le moment. ;-) L'ensemble tant nouveau pour le dbutant, il patauge et essaye d'apprendre par coeur l'abondante documentation mise sa disposition par les promoteurs mais, le concept tant novateur, il n'y comprends rien et se demande si les promesses en front page du site sont bien applicables par les apprentis sorciers. Se dcidant finalement visionner les vidos et lire les tutoriels et documentations (et ne pas les parcourir en diagonale), il fini par comprendre mais trouve les docs parfois incompltes biens que de trs comprhensibles si du moins nous avons le niveau requis. Cela dit, avec un peu de patience... ;) Par exemple, il apprendra fabriquer son premier module (en dcouvrrant avec ravissement le potentiel du merveilleux dnomm POLYMOD) mais schera au moment d'intgrer son oeuvre dans "une range de contenu" car, si il n'est pas trop idiot et a examin les modules dj en place, il constatera que rien n'est gagn d'avance. Surtout si il a pris la peine de lire des docs et contributions du forum (jusqu' la lie) et constat que la V4.0.1 est nouvelle et que la plupart des tutoriels sont consacrs la V3+. Bon ! se dit-il.Ce truc n'est vraiment pas mal et il faut laisser le temps aux initiateurs de parfaire leur systme. Ceci est autant valable pour le systme d'aide que pour le systme tout court en juger par les contributions au sein du Bug Tracker qui a le mrite d'exister et je tire personnellement mon chapeau ceux qui ont eu le courage de le mettre en place. J'avoue que si j'avais vu cela en premier, je serais revenu chez Joomla, Xoop et consort. Le dbutant va continuer son valuation et aura tt fait de planter son systme en essayant d'implmenter un module surtout si ce dernier se proccupe d'identification des utilisateurs. Pour ce qui est de la lecture, relecture et comprhension du systme d'aide, le nophyte clair (habitu instruire lui-mme les autres), se dira qu'il en est crit bien ou pas assez. Il trouve excellent l'apprentissage par images, vido et par l'exemple mais aussi faut-il que ces exemples fonctionnent ce qui n'est pas toujours le cas. Est-il sens savoir les interactions entre les diffrents modules (voire les confits) et le nom qu'on leur donne (histoire "d'identifiant" ? C'est un peu quand on veut passer de Windows Linux. Il faut tout rapprendre et, sur les abondants forums consacrs au systme pingouin, on trouve souvent des rponses (aux dbutants) formules en ce sens: "Allez d'abord lire la doc."

Page 44/67Cr le 11/04/2012 14:55:02

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

Oui, mais pour faire ceci, il faut savoir dj cela et la documentation Linux fait peu prs 4000 pages. Haut les coeurs !!! :-) Essayons de penser cela et offrons nos newsbees un prliminaire qui les formera aux bases du "concept Automne" encore plus clair qui ne les dcouragera pas. Je remarque toutefois en crivant ces lignes que, au fur et mesure que je travaille, je suis de plus en plus l'aise car et c'est un sentiment bien agrable. ;-)

Les premiers constats.Mon temps dvaluation a t consacr lexamen de larchitecture, des outils et possibilits ddition, de la ractivit du support et surtout du ncessaire niveau technique pour construire et grer un site avec un logiciel de cette facture. Cela ma permis de faire les constations suivantes.

Lexamen de larchitecture :Au premier abord cest droutant mais les webmasters (ou apprentis webmasters) comprendront trs vite linterface surtout si ils ont test dautres CMS car Automne reprends les grands principes en amliorant lensemble sur bien des points.Nous verrons plus loin les dtails.

Les outils et possibilits ddition :Outre les grands classiques (rien ne manque), ce logiciel se dote nous l'avons vu dun outil absolument puissant nomm POLYMOD qui permet de construire volont des applications comme par exemple un (ou des) blog(s), un systme de commentaire, un moteur de recherche, une base de donnes clients, petites annonces, gestion de nimporte quoi et plein dautres choses pour adapter notre site nos besoins. Japprcie particulirement cette possibilit car, habitu utiliser des CMS pour mes productions, je suis souvent limit par le nombre (et la qualit) des modules additionnels et je ne suis pas assez cal en PHP pour les dvelopper moi-mme. Avec POLYMOD, termin les recherches, les problmes de scurit et de mise jour, les multiples versions instables mal documentes (voire abandonnes par les concepteurs), la compatibilit avec la version des CMS quon utilise et autres soubresauts dhumeur que lon rencontre dans la quasi-totalit des systmes existants. Si vous saviez le temps que jai consacr ces dernires annes chercher des CMS correspondant mes besoins et des modules correspondants ces systmes ! Ici, nous aurons juste passer un peu (beaucoup peut-tre) de temps comprendre comment cela fonctionne mais cela fait, comme je le prtends dans un autre post, le monde va changer et un simple amateur dans mon genre va tre capable de coder ses propres sites avec les applications dont il a besoin. Deux trs bel exemple de sites construits sous Automne: http://www.cnes-jeunes.fr/ http://www.papierpeint-deco.com/

Le ncessaire niveau technique :Larchitecte de ce logiciel, Sbastien Pauchet, prtends quil faut avoir de solides connaissances en PHP, XHTML, CSS et autres pour se lancer avec Automne. Il na pas tord mais je temprerais un peu ses

Page 45/67Cr le 11/04/2012 14:55:02

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

propos. Il est certain quil faut des bases et celui qui as dj fabriqu un site Internet en a quelques unes surtout si il a tt aux CMS dans le genre de NDDS, XOOP, JOOMLA ou autre TYPO. Avec cela, il lui faudra apprendre le jargon des initiateurs dAutomne pas toujours explicite mais l aussi cest une question de patience et de rflexion.

La suite: Cest quoi un CMS et Tour du propritaire.

Page 46/67Cr le 11/04/2012 14:55:03

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

Cest quoi un CMS ?

1/ Cest quoi un CMS. Pour ceux qui ne le savent pas. (les autres peuvent sauter cette introduction.) 2/ Pourquoi choisir Automne. 3/ Tour dhorizon des fonctionnalits 4/ Capacit exercer. 5/ Pr requis serveur hbergement et installation 6/ Tour du propritaire Bonus: Questions lquipe des dveloppeurs la fin de ce post. D'autres rubriques off course venir.

1/ Cest quoi un CMS.Un CMS est un Content Management Systme (systme de gestion de contenu en bon franais) cest--dire, pour faire bref, un site tout prt lemploi quil suffit dinstaller sur notre serveur (hbergement du site), de personnaliser nos couleurs, et de remplir avec les informations que nous voulons faire apparaitre au public. Pas besoin de savoir coder et dtre un Pro du dveloppement (en gnral quelques notions suffisent), et seule limagination et votre inventivit sont sollicites pour faire de votre site une oeuvre dart unique alors quil en existe des milliers construit avec loutil que vous allez employer. Il existe des centaines de CMS dans le monde de lOpen Source proposs gratuitement par des passionns qui rivalisent dingniosit pour offrir aux apprentis webmasters les outils qui les aideront raliser leurs sites. Chacun choisira le plus proche de son besoin immdiat. Un CMS est en gnral compos dun noyau (architecture du logiciel) avec les fonctionnalits de base (faire des pages, grer les utilisateurs, etc) sur lequel se greffent des modules (ou extensions) spcifiques comme par exemple un forum, une newsletter, annuaire, glossaire, actualit, et bien dautres choses. Besoin dune boutique sur votre site ? Cherchez chez lditeur du CMS que vous utilisez si un module boutique existe et si oui, installez-le en trois clics de souris et commencez vendre vos bretelles. Enfin, en principe. ;) Dous de qualits absolument remarquables, les CMS ne souffrent pas moins de certains problmes quil faut absolument connaitre avant de se lancer dans la production dun site avec un outil de travail (logiciel) de ce type et surtout de le mettre en production (en ligne utilisable par le public). Fonctionnera-il chez mon hbergeur ? Quen est-il de la scurit ? Existe-il les modules correspondant mes besoins ? La prise en main et son dveloppement sont-ils la porte de mes connaissances techniques ? Un support est-il disponible et rellement ractif ? Ses utilisateurs en sont-ils satisfaits ou ont-ils beaucoup de problmes ? Autres questions La meilleure faon de savoir tout cela est de rechercher sur le site de lditeur (celui qui dveloppe le logiciel) la prsence dun forum o sexprime la communaut des utilisateurs de tel ou tel systme. Si il ny a pas de forum (support), laissez tomber !

Page 47/67Cr le 11/04/2012 14:55:03

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

Visiter les sites raliss avec le CMS sur lequel vous avez jet votre dvolu est une bonne manire de tester les capacits, loriginalit et lergonomie de la chose. Vous verrez tout de suite qui lutilise et ce qu'il en fait. Testez-en plusieurs et prenez le temps dvaluer de font en comble. Vous regagnerez les heures perdues plus tard et considrez votre tude comme un investissement

2/ Pourquoi jai choisi Automne.Cela a t dit par ailleurs, je suis comme qui dirait un spcialiste des CMS car, ntant pas motiv pour me lancer dans la programmation (cela volue trop vite et mon besoin ne va pas jusque l), je bricole mes sites avec des CMS existants et ceux qui auront eu la curiosit de cliquer sur les liens dans ma signature constateront que depuis trs longtemps, jutilise pour tous mes sites un CMS et un seul. Cest parce que de tous les outils existants cest celui qui rpond le plus mes besoins. Puis, en cherchant un outil qui me permettrait de faire du multi-site, je suis tomb sur Automne qui est un des rares compter cela parmi ses fonctionnalits. Le rflexe a t de venir sur les forums voir ce que les utilisateurs en disent, essayer la dmo en ligne pour voir de lintrieur quoi cela ressemble, et installer la choses sur mon serveur pour vrifier si ce script (assez pointu et cest tout son honneur) fonctionnait bien chez mon hbergeur.

Dmo en ligne:http://demov4.automne-cms.org/automne/admin/ Identifiant: redacteur Mot de passe: automne Les test prliminaires mont convaincu daller plus loin dautant plus que le support est trs prsent et que jai dcouvert le module POLYPOD qui permet de fabriquer soi-mme facilement ses propres modules sans avoir besoin dadapter des bidouillages maison en utilisant des scripts externes qui ne sont pas toujours fiables ni souvent au top question scurit (Voir plus loin dans ce mmento). Le tout a t fort bien pens et lensemble regroupe dans son noyau la quasi-totalit des moyens qui font de ses congnres (autres CMS) de vritables usines a gaz. De plus, techniquement, le systme est moderne (Technologie AJAX et autres) et orient avenir et parfaitement scuris. Je ne peux dvelopper cet aspect mais les diteurs lont fait sur les pages du site et les initis comprendront. ;) Je nai donc pas les comptences techniques pour faire voluer vers le Web 2.0.0 (+) le CMS de prdilection que jutilise (cest beaucoup trop de travail), alors, Automne moffrant dun seul coup la modernit et la capacit de dvelopper moi-mme mes modules et de fabriquer des sites ma faon , je prends le temps dtudier comment a marche et je suis trs heureux davoir dj des premiers rsultats. Do ce mmento que vous tes en train de lire. De plus, Automne est dvelopp par une quipe de professionnels tourns vers lavenir et il ny a pas besoin dtre un grand spcialiste pour constater la qualit de lensemble.

3/ Tour dhorizon des fonctionnalitsUne page spcifique a t dite et vous y dcouvrirez lextraordinaire potentialit du CMS Automne. Rien rajouter ce qui a t dit et le reste, vous le dcouvrirez tout seul. Dj, dans ltat, vous pouvez faire deux sites et les utiliser (aprs avoir relook le Template vos couleurs bien sr), mais je vous conseille dattendre de bien maitriser lensemble avant de le mettre en production. Apprivoisez

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

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

Automne qui se laissera bien vite amadouer. Cela nous emmne la

4/ La capacit exercer.Quon se le dise, Automne est un CMS mais, quoi que le travail soit bien avanc, il y a encore un peu de boulot si lon veut personnaliser et tirer le meilleur profit de ce genre doutil. Avec un CMS normal , il faut tout de mme quelques bases html/php/MySQL, vite apprises sur le tas, mais avec Automne, on va dvelopper des templates (les ntres) et des applications avec Polymod qui est le fer de lance de ce logiciel. Du html, il faudra passer au XHTML et XML mais vous navez pas le choix si vous voulez continuer rester visibles sur le Net car les technologies voluent et vous devez voluer avec elles. Cest aussi une des raisons pour lesquelles jenvisage de migrer mes sites construits avec mon CMS de prdilection sous Automne car mes productions commencent faire un peu vieillottes et risquent de ne plus fonctionner dans quelques annes. Si mon incomptence est grande dans ce domaine, mon sens de lobservation est lui trs aiguis. Je dveloppe du coup la patience et rien ne mempche de poser des questions ou (et) daller minstruire sur des sites spcialiss quand il y a lacune. Automne est un excellent travail pratique (pdagogique) et, si je ne mabuse, l'Acadmie lutilise pour initier ses lves en guise de TP. Attention: La version dAutomne utilise pour ces travaux est ancienne et ces tutoriels ne sont plus dactualit. Cela ne nous empche pas daller un peu nous instruire. Pour utiliser Automne au maximum de ses capacits, il vous faudra donc quelques notions mais ceux qui dbutent vraiment pourront tout de mme utiliser ce CMS avec les lments de base fournis avec larchive. Pour ceux qui veulent aller encore plus loin, le team de dveloppement vous renseignera sur les sessions de formation mises en place destination des professionnels patents.

5/ Pr requis serveur hbergement et installationL, il ny a pas photo et tout est trs bien expliqu ici La Suite: Tour du propritaire

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

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

Tour du propritaire

En visitant la dmo ou en entrant dans ladministration de votre site quand vous laurez install, ne vous laissez pas impressionner par le nombre doutils dj en place dont certains dont vous navez sans doute jamais entendu parl. La grande tentation quand nous dcouvrons un nouveau CMS est de vouloir un rsultat tout de suite en nous basant sur ce que nous savons dj faire parce que nous lavons vu ailleurs. Mais l, il va vous falloir un peu de patience et regarder sans toucher du moins lors de votre premire visite. Ce truc, cest comme une tagre Ikea. Vous lemmenez la maison, mprisez la notice (en gnral crite en chinois), et tentez dassembler la dizaine de bouts de bois. Deux heures aprs, rouge de colre, vert de rage et noir dhumeur, vous revenez un peu plus dhumilit et reprenez le bout de papier qui en gnral est la premire chose que vous trouvez louverture du carton. Certes, vous ne savez toujours pas lire le chinois (ou le XHTML) mais vous savez interprter un dessin et, 10 minutes aprs, ltagre est monte et prte recevoir les objets que vous voulez y caser. Satisfaction ! :-) H ben l, vous allez faire pareil. :) Au fur et mesure de lavancement de ldition de ce tutoriel, nous vous donnerons la marche suivre pour comprendre et faire fonctionner votre systme. Marche suivre, explications, copies dcran, vidos, tout est mis votre disposition pour avancer pas pas et, si il y a quelque chose qui vous chappe encore (cela arrivera bien sr), les utilisateurs enthousiastes frquentant ce lieu bni que sont les forums o les membres de lquipe de dveloppement dAutomne se feront un plaisir que de vous assister sur les forums. Les amis sont l (les Grands dAutomne Community) pour expliquer linexplicable de ma part. Vous verrez dailleurs souvent entre les lignes de ma production des interventions de Fred, Sbastien (ou dautres) qui viendront appuyer, prciser ou corriger les points qui mritent quelques prcisions. Bref, vous ne serez jamais seuls, et cest entre autres pour cela que jai personnellement dcid de construite mon prochain site avec le CMS Automne. Lol !!! Bon, vous avez tlcharg vos fichiers et install Automne. Vous tes entr dans ladministration par le lien http://www.votresite.com/automne/admin/ et, comme conseill dans la rubrique dinstallation, la premire chose que vous avez faite est de changer le mot de passe de ladministration de votre site. Nous allons le faire ensemble. Login par dfaut root et mot de passe automne Vous tes dans ladministration du systme (Admin pour les intimes) et vous ne voyez pas grand chose sauf un menu latral en haut avec divers outils. Pour le moment, ce n'est pas ce qui nous intresse.Vous voyez aussi (c'est un miracle) l'ensemble de votre site et en particulier la page en cours. Nous verrons plus loin comment en visualiser une autre.Regardez

Page 50/67Cr le 11/04/2012 14:55:05

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

Regardez maintenant dans le menu de droite. Pour le voir, positionnez le curseur de votre souris sur la partie droite de votre cran et il apparaitra par magie (sans doute).

A ce stade, vous commencez avoir un aperu des outils qui vont vous aider grer le CMS Automne et, dans notre exemple, apparaissent des liens que vous ne voyez pas sur votre propre installation. Apprentissage Blog Commentaire Gestion documentaire Ils correspondent des modules qui ont t fabriqus peu aprs l'installation par le webmaster du site sur lequel nous avons fait ces copies d'cran. Vous en trouvez certains qui sont d'origine (fournis l'install pour vous aider dmarrer) et comme tous les autres ont t en fait fabriqus avec le fameux module POLYMOD qui, rappelons-le, a t conus pour que vous puissiez fabriquer vous mmes des applications personnalises votre site et vos besoins. Assez regard. Commenons donc travailler. :-) Nous allons donc aller changer les identifiants d'usine (si j'ose dire) et renseigner les ntres. Pour ce faire, cliquons sur le lien Gestion des utilisateurs qui ouvre un module (comme les autres) et qui sert comme son nom l'indique grer les utilisateurs inscrits sur le site. Cela vous ouvre un sous/menu et tant qu faire, cliquez sur: Votre profil

Une fentre souvre. Voyez plutt.

Le nom et lmail sont dj renseigns ainsi que lidentifiant de ladministrateur qui est root et qui ne peut pas tre chang. Notons que si il ne vous plait pas, vous pourrez crer un autre compte (avec lidentifiant qui vous plait) et lui donner des droits dadministrateur mais pour le moment, part changer votre mot de passe, ne touchez rien.

Page 51/67Cr le 11/04/2012 14:55:05

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

Les deux utilisateurs dj en place "root" et "anonymous" ne peuvent pas tres supprims sous peine de se retrouver avec un Automne sans administrateur.

Vous allez tout de suite changer le mot de passe du super administrateur (vous) car cela serait vraiment dommage si un zonzon entrait dans votre administration et construisait le site votre place. Cest secret ces endroits l non ? Bien qAutomne soit particulirement scuris (les dveloppeurs sont dans une autre vie spcialistes de la question), il est plus mieux de compliquer votre mot de passe au maximum. Exit le nom de votre chat, de votre petite amie ou celui de votre grand-mre.. Cela ne mange pas de pain et dcourage les petits malins. Tous les caractres sont autoriss sans exception. Tant que nous y sommes, question scurit, nous allons dtruire via FTP le fichier install.php qui se trouve la racine de votre site automne. Pourquoi ? Parce que si vous ne le faites pas, il me suffit de taper http://www.votresite.com/install.php pour recommencer linstallation dans votre dos et prendre la barre de votre bateau et vous aurez travaill pour rien. Lol ! Bon, on a fini avec la scurit et nous pouvons commencer la visite. Nous avons dj remarqu que le menu dAdmin (panneau latral) se dveloppe ou se rtracte ds que vous passez le curseur sur sa poigne que vous voyez droite de votre cran. Si vous voulez le garder ouvert, vous pouvez lpingler grce la punaise en haut gauche du lien de dconnexion. Cela vous permet davoir une vue totale sur ce que nous pourrions appeler votre bureau puisque cest l que vous allez travailler pour grer votre site. Remarquons tout de suite que, mme le panneau latral doutils dadministration ouvert, vous avez une vue densemble du site positionn sur la page en cours et nous comprendront par la suite lutilit de cette ergonomie bien particulire et sans doute une exclusivit Automne. Mais avant de crer (ou modifier) notre premire page, nous allons procder quelques petits rglages qui vont bien nous faciliter la tache par la suite, tester en temps rel le comportement dAutomne selon les actions effectues et la spcificit technique de votre serveur et surtout contrler si tout va bien. Nous allons donc visiter le module dadministration et paramtrer le logiciel notre convenance. Dans notre menu rtractable, cliquons sur Administration .

Page 52/67Cr le 11/04/2012 14:55:05

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

Un sous menu nous propose diverses actions et choisissons pour commencer Paramtres serveur .

Automne teste le serveur et coche en vert ou en rouge votre configuration serveur. Soit tout est vert, tout va bien dans le meilleur des mondes et, pour ce qui est coch rouge, cela ne veut pas dire que rien ne va plus mais que certaines fonctions ne sont pas actives sur votre serveur. Les dveloppeurs vont nous dire ce qui est indispensable ou non. Si vous avez un doute sur votre propre configuration, posez la question dans le forum demande daide . Passons maintenant aux Paramtres Automne .

Page 53/67Cr le 11/04/2012 14:55:05

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

Renseignez tout de suite lEmail de ladministrateur o seront envoys les messages systme qui vous prviendront que quelque chose ne va pas, des modifications, crations, dplacements de pages et encore plein de choses que je ne sais encore mme pas. Activez ou non les cases proposes selon votre besoin et en particulier le dbuggage qui vous renseignera sur le comportement dautomne durant vos test et aidera les dveloppeurs quand vous les solliciterez. Quand vous aurez termin vos tests, vous pourrez dsactiver cette fonction pour conomiser de la ressource. Pour chaque item, une aide est visible en ligne en cliquant sur le petit ?Vert. Voil. Votre installation est maintenant prte fonctionner en toute scurit et je vous laisse aller visiter. Regardons donc notre bureau (cest moi qui nomme lespace dadministration comme cela car on a tout sous la main pour travailler) et examinons les outils que nous avons sous les yeux.

Nous voyons notre site un exactement comme les visiteurs mais avec les outils dadmin en plus si du moins vous avez cliqu sur un lien dans le menu de navigation ( gauche) ce qui affichera une page que je nommerais "page en cours". Je vous propose de vous positionner sur la page Prsentation afin de vous aider comprendre et que nous travaillons ensembles. Un passage du curseur de votre souris sur chaque item du menu d'outils d'dition (en haut) vous renseignera sur sa fonction et nous allons commencer nous en servir. Remarquons tout de suite que le menu de navigation propose les pages selon une hirarchie. Dans notre cas, nous avons trois catgories contenant


Top Related