Initiation à Textpattern, tutoriels textpattern · 16 février, 18:03
Rentrons dans le vif du sujet, pourquoi et quand choisir Textpattern par rapport à une autre plateforme de gestion de contenu ?
Les avantages majeurs de Textpattern sont :
- Génération d’urls type “sef” (Search Engine Friendly => des adresses que les moteurs de recherche préfèrent) dès la première installation, à condition d’avoir mod_rewrite activé dans Apache
- Propreté du code généré
- Interface d’administration puissante :
- Plusieurs types de modules (article, commentaire) modifiables facilement
- Syntaxe Textpattern facile à apprendre
Alors Textpattern, Wordpress ou Dotclear ? J’opte personnellement pour Textpattern, si vous êtes dans le milieu de la programmation web il vous satisfera bien plus qu’un Wordpress plutôt orienté utilisateurs lambda et ou la modification de l’interface est souvent plus limitée.
Ok, vous êtes décidé à tester Textpattern ? Prenez la boisson de votre choix et respirez profondément, ce tutoriel est long, très long mais vous permettra d’en apprendre beaucoup sur ce fabuleux logiciel.
Installation de Textpattern
L’installation se déroule sans accrocs et est un modèle du genre, il suffit de télécharger la dernière version de textpattern (actuellement 4.0.4 du 18 Octobre 2006).
Je vous laisse le soin de paramètrer votre serveur web comme vous le souhaitez etc…
Note importante, la version actuelle comporte un léger bug qui vous empêchera de modifier les options concernant les commentaires, vous trouverez une réponse dans la faq qui vous permettra de corriger le bug.
L’installation est terminée, vous avez accès à l’interface d’administration (http://basedelinstallation/textpattern) ? Je vous laisse régler les paramètres concernant les urls, les commentaires, tout est expliqué très clairement.
On continue !
Créer un thème textpattern
L‘édition des thèmes dans textpattern est assez différente des autres plateformes : il n’existe pas de répertoire template/ ou themes/, les fichiers qui définissent les thèmes sont stockés dans votre base de données.
Pour créer un thème, allez dans “Présentation” puis “Gabarits”, copiez ensuite le thème par défaut vers un nom de votre choix.
Vous pouvez maintenant le modifier librement, voici quelques astuces :
- Utilisez des morceaux de html réutilisables car vous aurez à créer plusieurs gabarits par la suite. Pour cela allez dans la rubrique “module” puis cliquez sur “créer un nouveau module”, sélectionnez “misc” comme type de module.
Insérez ceci dans l‘édition du module :
<div id="header">
<h1><txp:link_to_home><txp:sitename /></txp:link_to_home></h1>
<!-- <h2><txp:site_slogan /></h2> -->
<img src="http://wandb.org/site/images/layout/homer.gif" alt="image homer simpson" id="homer" />
</div>
C’est le header du site wandb, modifiez le pour qu’il ressemble à votre design
Sauvegardez votre module puis retournez dans l‘édition de votre gabarit et pour afficher votre header à l’emplacement voulu, écrivez : <txp:output_form form="header" />
Vous avez capté le truc non ? C’est très puissant et vous vous en rendrez encore mieux compte plus tard.
Le gabarit de ce blog est par exemple :
<!-- accessibility -->
<txp:output_form form="accessibility" />
<!-- container -->
<div id="container">
<!-- header -->
<txp:output_form form="header" />
<!-- menu top -->
<txp:output_form form="top_menu" />
<!-- wrapper -->
<div id="wrapper">
<!-- content -->
<div id="content">
Contenu
</div>
</txp:if_article_list>
</div>
</div>
<!-- navigation droite -->
<txp:output_form form="nav_droite_normal" />
<!-- footer -->
<txp:output_form form="footer" />
</div>
Le contenu de <div id="content"></div> est différent si vous voulez une page statique ou une partie “blog” avec des articles & commentaires.
Si vous voulez réutiliser ce code, vous devrez d’abord créer les modules énoncés.
Après avoir créé le gabarit, il faut y associer une feuille de style, créez donc en une dans la partie “styles” de “présentation”.
Pour activer votre thème, allez dans la partie “sections” de “présentation”, le style et gabarit par défaut définissent comment se comporte la page d’accueil de votre site.
Créer une partie blog
Le thème par défaut de Textpattern présente simplement une partie blog, notre nouveau thème créé n’affichera rien, seulement le mot “Contenu”, changeons cela !
La méthode décrite vous permettra d’afficher une liste d’article en fonction de leurs attributs :
- Si il existe un résumé, l’afficher et insérer un lien vers l’article complet
- Ne pas ré-afficher le résumé sur la page de l’article complet
- Si pas de résumé, afficher l’article complet sur la liste des articles
- Si une image associée à l’article est fournie, l’afficher en haut de l’article complet et en dessous du résumé
Afin d’afficher une liste d’articles, insérez à la place de “Contenu” : <txp:article limit="10" form="default2" />
Il faut ensuite créer le module “default2”, c’est un module de type “article”, voici son contenu :
<txp:if_article_list>
<!-- list page: display the short version -->
<h3><txp:permlink><txp:title /></txp:permlink> · <span class="date"><txp:posted /></span></h3>
<txp:if_excerpt>
<!-- the article has an excerpt -->
<txp:excerpt />
<p><txp:permlink class="opaque" title="Cliquez sur cette image pour lire la suite">
<txp:article_image class="article-image" />
</txp:permlink>
<br/><txp:permlink>Lire la suite ...</txp:permlink></p>
<txp:else />
<!-- there is no excerpt -->
<txp:body />
</txp:if_excerpt>
<div><img src="<txp:site_url />images/1.gif" width="400" height="1" class="divider" alt="---" title="" /></div>
<txp:else />
<!-- article page: display the complete article -->
<h3><txp:title /> · <span class="date"><txp:posted /></span></h3>
<txp:article_image wraptag="p" />
<txp:body />
<p>— <txp:author /></p>
<txp:comments_invite wraptag="p" />
<p>
<txp:link_to_prev><<</txp:link_to_prev> - <txp:link_to_next>>></txp:link_to_next>
</p>
</txp:if_article_list>
Voilà désormais la section utilisant votre gabarit avec ce module d’article sera une partie blog. Si ne voulez pas que votre page d’accueil soit la partie blog, créez une nouvelle section (de nom “blog” par exemple) ayant pour gabarit celui que nous venons de créer.
Créer des pages statiques
La plupart des tutoriels traitant la création des pages statiques vous permettent effectivement de créer des pages statiques mais rien de plus.
Je vous propose de créer des pages statiques (accessibles avec l’adresse http://votresite/page-statique) puis d’y écrire des articles accessibles sous la même arborescence (http://votresite/page-statique/page-article) mais sans possibilité de commenter (bref réaliser ce qui existe dans ma partie création site internet).
Très simple :
- Copiez le gabarit actuel vers un autre nommé “static_page”
- Changez la partie centrale (le contenu) avec ce code :
<txp:if_article_list>
<txp:article limit=1 form="static_article" status="sticky" />
</txp:if_article_list>
<txp:if_individual_article>
<txp:article form="default2" />
</txp:if_individual_article>
Puis pour chaque “partie” ou page statique, créez une nouvelle section utilisant le gabarit “static_page”, le style que vous voulez, “sélectionnée par défaut” > non, “sur la page d’accueil” > non, syndiquer > à votre envie.
Créez ensuite un article avec le statut “persistant” dans cette section, c’est l’article par défaut qui sera affiché lors de la consultation de la page http://votresite/votre-section, puis pour inclure des articles dans l’arborescence, créez les avec le statut normal sous la section créée, vous devrez ensuite créer les liens à la main sur votre page statique.
Vous avez compris le système nan !? (je savais bien que vous étiez des petits malins)
Si vous voulez une page d’accueil statique et non un blog, définissez le gabarit par défaut sur “static_page” et créez un article dans la section par défaut du site (normalement “article”) ayant pour statut “persistant”, voilà c’est l’article de votre page d’accueil !
Vous pouvez donc faire un site entièrement avec des pages statiques, ou bien tout de même avoir un blog par dessus, il faudra créer une section type “blog” ayant pour gabarit celui qui affiche une liste d’articles, et surtout écrire vos articles pour le blog dans la section “blog” (logique hein !).
Je suis sûr que vous comprenez aussi pourquoi je vous ai fait utiliser les morceaux de html réutilisables maintenant que vous avez toutes ces sections !
Vous pouvez aussi créer un autre blog en créant une nouvelle section qui utilise un design différent, bref Textpattern est puissant non ?!
Voilà il reste encore tellement de chose à vous montrer, la navigation dans les différentes pages d’articles sur les sections type “blog”, de la création d’une page d’archives, d’un formulaire de contact, de l’installation de plugins, ce sera l’occasion d’un autre article dans peu de temps !
— Vincent Voyer
Commentaire
Commentaires fermés pour cet article
