PluxThèmes

un vieux thème compatible

et qui ressemble à ça

En cherchant un vieux thème qui servirait d'exemple dans le github de pluxml , je suis retombé sur un thème que j'avais totalement oublié (et c'est compréhensif) . Je vais donc prendre ce thème situé à https://github.com/pluxml/PluXml-Themes/tree/master/theme-perruche. Ce n'est pas tant par sa qualité graphique qu'il est choisi, mais par ces éléments qu'il contient et de ce que l'on s'attend à trouver dans tout CMS pouvant servir de blog.

On y retrouve l'essentiel classique d'un blog :

• un entête avec un titre et une navigation
• l'article et une zone de commentaires
• une colonne listant les catégories, les derniers articles, les fil d’abonnement
• et un pied de page

Téléchargeons cette archive datant de 2009, ... ou une autre si vraiment celui-ci vous déplait , et commençons

Prérequis: Inventaire et mise en place des outils pour notre mise à jour.

Pour démarrer confortablement et ne plus avoir à se soucier d'autre chose que de notre adaptation, préparons le terrain de manœuvres.

1. Installons et lançons un PluXml tout neuf Ils pourra resservir pour des tas d'autres test ou être effacer.
2. Ouvrez la page d’accueil qu'il suffira de rafraichir plus tard
3. Dans un second onglet, la page d'administration dans l'onglet "paramètres" puis "thèmes".
4. Ouvrez votre explorateur au dossier "thèmes" de votre PluXml de test
5. Ouvrez votre éditeur de code préféré. lorsque j'ai créer ce thème, j'utilisais un editeur de texte basique, mais un notepad++ est au moins un minimum pour coloriser la syntaxe.
6. Notez: Un prérequis qui vous servira de référence, est bon à se garder ouvert dans un autre onglet, voir la page de documentation de PluXml : Créer un Thème..

comme nous allons remettre à jour un thème devenu obsolète, le prérequis de la documentation va nous aider à faire un premier inventaire de ce qu'il contient et est manquant

ouvrons l'archive du thème.

Voici ce que contient l'archive:



A priori , le thème ressemble aux contenus des thèmes actuels, il manque quelques templates, le fichier infos.xml et le preview.
Comme il proviens d'une source officiel de PluXml et que vous avez un PluXml de test, dézippez le sans prendre de risques dans le dossier thèmes de votre PluXml de test.

Retournez dans l'administration de votre site de test et vérifiez si il apparait dans le listing des thèmes. ... Ce ne sera pas le cas.

Un fichier est nécessaire pour qu'un thème puisse apparaitre dans la liste de vos thème. C'est le fichier infos.xml et il est manquant.

Activer le thème avec un infos.xml

Créez un fichier infos.xml vide dans le répertoire de ce thème et rafraichissez la page des thèmes de l'administration.

Un nouveau thème non identifiable apparait dans la liste et il peut-être activable.



Activez le et rafraichissez la page d'accueil pour le tester. ça marche ! , il ne faut pas grand chose pour adapter un thème pensez vous .

Mise à jour du fichier infos.xml

Est-il vraiment nécessaire de mettre ce fichier en conformités ? — Oui.

1. Cela permet de l'identifier clairement dans l'administration ainsi que l'auteur du thème(même gratuite à l'usage, une œuvre reste la propriété de son auteur et il est , au minimum, nécessaire de le citer), la version peut aussi avoir son importance
2. Certains scripts ou plugins peuvent extraire les données d'un thème. Vide, ce fichier ne sera pas un XML valide et n'aura bien sur aucunes données à transmettre. Cela aura pour effet de casser ou d’empêcher l'affichage, avec des messages d'erreurs incompréhensibles pour le visiteur. Exemple : un sélecteur de thème recherche ses infos.

Contenu du fichier infos.xml

C'est un fichier XML, il faut donc respecter ce format en le déclarant sur la première ligne, puis en utilisant une balise principale , ici elle est appelé document, cela fait sens.

Cette balise contient l’ensemble des données décrivant le thème, chacune stockée dans une balise enfant au nom explicite:

title

stocke le nom du thème.

author

le nom ou pseudo de l'auteur.

version

la version du thème. (des mises à jours peuvent être faites pour améliorer le thème ou y injecter des fonctionnalités)

date

date de création ou de modification si importante

site

site de l'auteur ou de sa page officielle (adaptation de ... , repo github, ...)

description

Description sommaire du thème, ses fonctionnalité, licence si restrictive,

Voici ce que cela donnerait pour ce thème

<?xml version="1.0" encoding="UTF-8"?>
<document>
	<title>
		<![CDATA[perruche]]>
	</title>
	<author>
		<![CDATA[GC-nomade aka Gcyrillus]]>
	</author>
	<version>2</version>
	<date>12/12/2009</date>
	<site>https://pluxthemes.com</site>
	<description>
		<![CDATA[maj Theme coloré pour version 5.8.9]]>
	</description>
</document>

Remarquez les textes entourés d'un <![CDATA[ et ]]> qui doivent être conservés. Ils permettent d’insérer du texte et des balises HTML sans interférer avec la structure et validité du fichier XML.

Ce qui donne maintenant :

La partie adaptation coté administration est quasi finie, ils nous manque l'aperçu.

Vous avez cette image sur son lien d'origine, il suffit de la copier dans le répertoire du thème et de la renommer en preview sans modifier son extension:



Le répertoire du thème contient maintenant deux nouveaux fichiers:

La mise à jour est-elle finie?

réponse courte: Non

Ce thème n'affichera pas:

1. les images d'accroches de vos articles
2. les tags et leur liens
3. les liens vers les archives
4. le fil d'Ariane
5. etc.

Ces fonctions n'existaient pas encore en 2009.

Si ce fonctionnement vous convient, l'adaptation peut s’arrêter là.

---

Cependant les url des pages de tags et d'archives existeront encore et pourrons être appelées par vos visiteurs ou moteurs de recherche.Il faut donc au minimum ajouter ces templates manquants pour ne pas avoir de pages ou de liens cassés. Le fil d'Ariane est lui aussi manquant.

Nous allons voir dans un prochain article comment créer nos templates manquants, insérer le fil d'Ariane et découvrir ce que cela implique à faire de plus.

Lire l'article suivant de la série.

"Si vous trouvez dans ce texte des fautes ou des erreurs, merci de me le signaler."GC-nomade

♥ ♥ ♥ ♥ ♥

^{2 notes / moyenne 10}