Dans ce tutoriel, nous allons voir ensemble comment convertir votre ancien template Joomla 1.5 en template compatible avec Joomla 2.5. Nous allons prendre comme exemple, le template par défaut "rhuk_milkyway" de Joomla 1.5 et le convertir en tamplate natif compatible avec Joomla 2.5.

Note :

Ce tutoriel ne traite que de la conversion du template ce qui implique que vous devez déjà avoir un site Joomla 2.5 installé ou converti depuis Joomla 1.5. Notez que vous pouvez également convertir vos plugins Joomla 1.5 en Joomla 2.5

Le tutoriel va se dérouler en 5 étapes :

  • Faire une copie complète des fichiers du template Joomla 1.5
  • Éditer la structure des fichiers
  • Éditer le fichier "templateDetails.xml"
  • Éditer le fichier "index.php"
  • Installer et tester le template Joomla 2.5 converti

logo-designÉtape 1 - Faire une copie complète des fichiers du template Joomla 1.5

La première chose à faire est de copier le dossier entier du template Joomla 1.5 et de le coller dans les fichiers de votre site Joomla 2.5

folder-copyCopiez le dossier complet du template

  1. Rendez vous dans le dossier templates de votre site Joomla 2.5
  2. Créer un dossier nommé "rhuk_milkyway25"
  3. Copier/coller tous les fichiers du dossier "rhuk_milkyway" vers le dossier créé précédemment.

logo-designÉtape 2 - Éditer la structure des fichiers

Maintenant, vous devez éditer certains fichiers afin que le template devienne compatible avec Joomla 2.5

folder-comparisionÉditez la structure des dossiers pour le rendre compatible

  1. Effacez le fichier "params.ini"

    Dans la version 1.5, ce fichier contient les différents paramètres du template. Mais dans la version 2.5, tous les paramètres du template sont stockés dans la base de données. Ce fichier "params.ini" n'est donc pas utile.

  2. Copiez le fichier "error.php" du template Joomla 2.5 par défaut "atomic"

    Joomla 2.5 introduit un nouveau fichier, "error.php", qui contient l'agencement des pages d'erreur. Ce fichier est simple et nous pouvons réutiliser celui présent dans le dossier du template par défaut "atomic".

  3. Créez un nouveau fichier "template_preview.png"

    Dans Joomla 2.5, un nouveau fichier nommé "template_preview.png" permet d'avoir un aperçu du template. Vous devez donc faire une capture d'écran de 640x480 de votre template et de la nommer "template_preview.png".

logo-designÉtape 3 - Éditer le fichier "templateDetails.xml"

Maintenant, vous devez éditer le fichier "templateDetails.xml" pour le rendre compatible avec Joomla 2.5

  1. Renommez la balise <install> en <extension>

template-details-xml

Ancienne valeur Nouvelle valeur
<install version="1.5"... <extension version="2.5"...
</install> </extension>
  1. Changez le nom du template dans le balise <name>

template-details-xml-02

  1. Remplacez les multiples balises <filename> par une simple balise <folder>

Ceci est l'une des nouvelles fonctionnalités de Joomla 2.5, désormais il n'est plus nécessaire de déclarer tous les fichiers d'un dossier, vous pouvez déclarer le dossier lui-même.

template-details-xml1

  1. Effacez la déclaration pour le fichier "params.ini"

del-params-xml

  1. Ajoutez des déclarations pour les deux fichiers créés durant l'étape 2

    Ajoutez les deux balises suivantes :

    1. <filename>error.php</filename>
    2. <filename>template_preview.png</filename>

template-details-xml-add

  1. Renommez les balises dans la section <params>

template-details-xml-params

Ancienne valeur Nouvelle valeur
<params>

<config>
<fields name="params">
<fieldset name="advanced">

<param... < field...
</param> </ field>
</params>

</fieldset>
</fields>
</config>

logo-designÉtape 4 - Éditer le fichier "index.php"

Après avoir édité le fichier "templateDetails.xml", vous devez éditer le fichier "index.php"

  1. Ajoutez le code PHP permettant de charger la librairie Mootool

    Ajoutez le code suivant "JHtml::_('behavior.framework', true);" à l'endroit désigné sur la capture d'écran ci-dessous.

mootools-index

  1. Remplacez le nom du template "rhuk_milkyway" par du PHP

    Joomla 2.5 permet de récupérer le nom du template directement dans le fichier "templateDetails.xml", il n'est donc pas nécessaire d'écrire textuellement le nom du template.

rename-link-index

Ancienne valeur Nouvelle valeur
rhuk_milkyway

<?php echo $this->template ?>

logo-designÉtape 5 - Installer et tester le template Joomla 2.5 converti

A présent, le template Joomla 2.5 converti se trouve dans le dossier templates mais il n'apparaît pas dans le gestionnaire de templates car il n'est pas encore installé. Suivez les étapes suivantes :

  1. Aller dans votre administration puis Extensions > Gestion des extensions > Découvrir.

discover-admin

  1. Cliquez sur le bouton "Découvrir"

discover-icon-admin

Sélectionnez l'élément "rhuk_milkyway25" dans la liste et cliquez sur le bouton "Installer"

install-template

  1. Maintenant le template est installé, vous pouvez vous rendre le gestionnaire de templates et le définir par défaut.

make-default

Le processus de migration du template Joomla "rhuk_milkyway" est terminé. Si vous connaissez d'autres moyens de convertir un template Joomla 1.5 vers Joomla 2.5, laissez un commentaire ci-dessous. Et n'hésitez pas à poser des questions si vous rencontrez un problème.

Si vous rencontrez des difficultés, n'hésitez pas à nous solliciter via le forum et si vous souhaitez correctement installer votre template Joomla 2.5, consulter notre tutoriel : Comment installer un template joomla 2.5

Cet article est une traduction de l'article écrit par Tuan Bui pour le magazine de Joomla.org
 
L'auteur : un expert à votre service
Geoffrey LEOST
Nom : Geoffrey LEOST

Commentaires (19)

This comment was minimized by the moderator on the site

Un grand bravo à cette doc. Malgré pas mal de lectures sur la migration de template de joomla 1.5 en 2.5, je restais bloquée. Là, j'ai enfin réussi la migration de mon template. C'est le genre de doc que j'apprécie: claire et explicite. Qui ne...

Un grand bravo à cette doc. Malgré pas mal de lectures sur la migration de template de joomla 1.5 en 2.5, je restais bloquée. Là, j'ai enfin réussi la migration de mon template. C'est le genre de doc que j'apprécie: claire et explicite. Qui ne se contente pas de dire "faut cliquer là et cliquer ici" mais qui explique aussi pourquoi. Un grand merci

Lire la suite
This comment was minimized by the moderator on the site

bravo C'est beau, clairet explicite. Je ne pouvais espérer mieux. J'ai réussi à convertir mon template sans soucis! un grand merci

This comment was minimized by the moderator on the site

merci. n°1 sur Google sur "structure template joomla 2.5" et c'est exactement ce que je cherchais. côôl. ;-)

This comment was minimized by the moderator on the site

Bonjour! Génial comme tutoriel et très clair!! J'aimerais pousser un peu plus loin ton expertise ... :-) En fait lorsque je veux visualiser le site internet , une erreur apparait : Fatal error: Call to a member function getCfg() on a...

Bonjour! Génial comme tutoriel et très clair!! J'aimerais pousser un peu plus loin ton expertise ... :-) En fait lorsque je veux visualiser le site internet , une erreur apparait : Fatal error: Call to a member function getCfg() on a non-object in /homepages/17/d430064869/htdocs/cvemlynbricejoomla/templates/classicoblue/index.php on line 49 Or la ligne 49 est celle ci : $seitentitel = $mainframe->getCfg('sitename'); de la programmation suivante : if ($this->params->get('ueberschrift') == false) { $seitentitel = $mainframe->getCfg('sitename'); } else { $seitentitel = $this->params->get('ueberschrift'); } Y a t il une erreur? merci beaucoup!!! et encore féliciation pour ton tutoriel!!!

Lire la suite
This comment was minimized by the moderator on the site

Bonjour Emylin, Ce problème semble malheureusement propre au template que tu es en train de migrer. P.S. : Le tutoriel est une traduction d'un article du magasine officiel Joomla :-).

This comment was minimized by the moderator on the site

Super tutorial et magnifiquement clair. Manque juste la modification suivant pour les utilisateurs Artisteer 1) dans le fichier functions.php, remplacer : $mainframe->getMessageQueue(); par JFactory::getApplication()->getMessageQueue(); Un...

Super tutorial et magnifiquement clair. Manque juste la modification suivant pour les utilisateurs Artisteer 1) dans le fichier functions.php, remplacer : $mainframe->getMessageQueue(); par JFactory::getApplication()->getMessageQueue(); Un grand merci

Lire la suite
This comment was minimized by the moderator on the site

Bonjour HFT, Merci pour ta participation :-)

This comment was minimized by the moderator on the site

en 3 c'est marqué "Remplacez les multiples balises par une simple balise " et parès on voit que vous avez gardé certaines balises files names , comment on devine lesquels faut garder et supprimer?

This comment was minimized by the moderator on the site

Bonjour yoyo, En fait,

désormais il n'est plus nécessaire de déclarer tous les fichiers d'un dossier
, la balise permet de déclarer tous les fichiers présents dans le répertoire. Les autres balises concernent les fichiers orphelins ou à la racine.

This comment was minimized by the moderator on the site

Je rencontre des problèmes avec des templates Plazza en 1.5 J'arrive à installer, je positionne les modules des menus etc... mais je n'arrive pas à afficher les articles, seuls ou en blog !? Merci de m'aider Pascal

Il n'y a pas encore de commentaire pour cet article.
Charger plus

Ajouter vos commentaires

  1. Insérer un commentaire en tant qu'invité.
Pièces jointes (0 / 3)
Share Your Location
Contact

Scoop.It de NosyWeb

Twitter de NosyWeb

YouTube de NosyWeb

Facebook de NosyWeb

Google+ de NosyWeb

Flux RSS de NosyWeb

Inscription newsletter de NosyWeb