joomla! - fnac-static.com...joomla! - conception et personnalisation des templates conception et...

14
Conception et personnalisation des templates Joomla! Christophe AUBRY 2 e édition

Upload: others

Post on 10-Feb-2021

1 views

Category:

Documents


0 download

TRANSCRIPT

  • Joom

    la! -

    Conc

    eptio

    n et

    per

    sonn

    alis

    atio

    n de

    s te

    mpl

    ates

    Conception et personnalisation des templates

    Joomla!

    Christophe AUBRY 2e édition

    Nouvelle édition

    ISBN

    : 97

    8-2-

    409-

    0112

    8-3

    26,5

    0 €

    Pour plus d’informations :

    Responsable pédagogique dans un centre de formation et formateur sur les technologies Web et les Arts graphiques pendant plus de quinze ans, Christophe Aubry est aujourd’hui dirigeant de la société netPlume spécialisée dans la rédaction pédago-gique et la création de sites internet. Auteur de nombreux livres aux Editions ENI notamment sur Dreamweaver, WordPress, HTML et CSS, ce livre lui permet aujourd’hui de vous trans-mettre toute son expérience pédago-gique et pratique sur le CMS Joomla!.

    Joomla! est l’un des CMS les plus utilisés actuellement. Sa base solide lui permet de s’adapter à tout type de projet : site institutionnel, site e-commerce, portail d’entreprise... Le design, l’ergonomie, la navigation et l’apparence de tous les contenus du site sont déterminés par les templates.

    Ce livre s’adresse à toute personne connaissant déjà Joomla! et souhai-tant débuter dans la création de nouveaux templates ou dans la per-sonnalisation de templates existants. Les templates créés sont valables pour les versions 3.0 et supérieures de Joomla!.

    La connaissance de l’HTML et des CSS est recommandée ; nous étudie-rons les notions simples de PHP requises lors de la mise en pratique des templates.

    Nous commencerons par étudier la structure des templates de Joomla!. Nous créerons alors un premier template simple pour mettre en pratique ces premières notions.

    Dans un deuxième temps nous vous proposons de créer un template complet proposant à l’utilisateur plusieurs possibilités pour placer des modules dans des emplacements variés.

    Le troisième template que nous allons créer nécessitera d’utiliser les options et les styles ; ces fonctions permettent aux utilisateurs de per-sonnaliser le template dans l’administration du site, sans avoir à modifier le code source.

    Nous terminerons en analysant dans le détail Protostart, le template proposé par défaut dans Joomla!. Vous pourrez ainsi vous en inspirer pour créer vos propres templates.

    Christophe AUBRY

    Téléchargementwww.editions-eni.fr.fr

    sur www.editions-eni.fr : b templates créés dans le livre

    Joomla!Conception et personnalisation des templates

  • Table des matières 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .©

    Edi

    tions

    EN

    I - A

    ll rig

    hts r

    eser

    ved

    Introduction

    Chapitre 1 : La gestion des templatesA. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13B. Exploiter les templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13C. Le template par défaut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13D. Gérer les templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

    1. Installer un template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142. Lister les templates et les styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153. Filtrer les templates et les styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174. Désactiver un template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185. Désinstaller un template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206. Gérer les styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

    E. L’aperçu des templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221. Activer l’aperçu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222. Aperçu des autres templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

    F. Les paramètres des templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261. Les fichiers constitutifs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262. Les options de style des templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303. L’affectation des menus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

    Chapitre 2 : La structure des templatesA. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37B. Le dossier du template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

    1. Les templates pour Joomla! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372. Les fichiers d’un template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

    C. Le fichier de description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382. L’en-tête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383. Le concepteur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394. Les fichiers d’installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395. La liste des positions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406. Les langues disponibles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417. Les options du template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

    D. Les inclusions JDOC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 442. L’en-tête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443. Les composants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444. Les messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445. Le débogage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

    lcroiseTampon

  • Joomla! - Conception et personnalisation des templates2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6. Le chargement des modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457. L’affichage des modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

    E. La position des modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46F. Les classes CSS de Joomla! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

    1. Les classes par défaut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472. Connaître les classes par défaut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

    Chapitre 3 : Un template simpleA. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55B. La structure du template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

    1. Le dossier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562. Le fichier index.html . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563. Les styles CSS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564. Les images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565. Le fichier de description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566. Le fichier maître . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577. Les vignettes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578. Le dossier du template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

    C. Le fichier de description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582. L’en-tête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583. La déclaration d’extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584. Les informations du template et du concepteur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585. Les fichiers du template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596. Les positions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607. Les autres paramètres . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618. Le code complet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

    D. Les conteneurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62E. Le début du fichier index.php . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

    1. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632. Restreindre l’accès direct. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633. Les déclarations HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634. L’élément . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645. Les métadonnées. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646. Les feuilles de style par défaut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647. Notre feuille de style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648. La fin de l’en-tête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659. Le code complet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

    F. Le corps du fichier index.php . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651. Le corps de la page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652. Les conteneurs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

  • Table des matières 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .©

    Edi

    tions

    EN

    I - A

    ll rig

    hts r

    eser

    ved

    G. La mise en forme CSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67H. Le conteneur principal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67I. L’en-tête de la page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

    1. Les boîtes d’affichage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682. L’image de fond de l’en-tête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683. Le logo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694. Le module de recherche . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

    J. La barre des menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701. La mise en forme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702. Insérer la barre des menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71

    K. La zone centrale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721. Les boîtes d’affichage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722. Les conditions d’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723. La mise en page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734. Les règles CSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

    L. Le pied de page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77M. Le code complet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

    1. Pour le fichier index.php . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772. Pour le fichier template.css. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

    N. L’affichage du site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 811. Le template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 812. Les modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 813. L’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

    Chapitre 4 : Un template completA. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91B. La structure du template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

    1. Le dossier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 922. Le fichier index.html . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 923. Les styles CSS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 924. Les images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 925. Le fichier de description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 936. Le fichier maître . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 937. Les vignettes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 938. Le dossier du template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

    C. Le fichier de description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 941. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942. L’en-tête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 943. La déclaration d’extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 944. Les informations du template et du concepteur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 945. Les fichiers du template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

  • Joomla! - Conception et personnalisation des templates4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6. Les positions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957. Le code complet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

    D. La structure du template complet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99E. Le début du fichier index.php . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100

    1. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1002. Le code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100

    F. Le corps du fichier index.php . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100G. Les conteneurs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101

    1. La mise en page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1012. Les styles CSS des tableaux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103

    H. Le bandeau supérieur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1041. L’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1042. Les styles CSS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1043. Le contenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1054. Le code généré . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106

    I. La barre des menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1071. L’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1072. Les styles CSS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1073. Le code généré . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108

    J. Les zones des nouvelles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1081. L’affichage des nouvelles dans les positions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1082. Les styles CSS et l’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1093. L’affichage conditionnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1104. Les styles CSS pour les nouvelles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1125. L’affichage des nouvelles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1136. Les styles CSS des modules inclus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114

    K. La zone centrale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1161. L’affichage dans les positions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1162. Les conditions d’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1173. Adapter les largeurs des colonnes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1184. Les styles CSS pour les colonnes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1215. L’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1226. Les styles CSS des modules inclus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125

    L. Le fil d’Ariane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1271. L’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1272. Les styles CSS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1283. Les styles du module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128

    M. La zone des informations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1291. L’affichage dans les positions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1292. Les conditions d’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1293. Les styles CSS pour les informations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131

  • Table des matières 5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .©

    Edi

    tions

    EN

    I - A

    ll rig

    hts r

    eser

    ved

    4. L’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1325. Les styles des modules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134

    N. Le pied de page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1341. L’affichage dans les positions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1342. Les conditions d’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1353. Les styles CSS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1354. L’affichage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1355. Le code généré . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135

    O. Le code du template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1361. Le code complet du fichier index.php . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1362. Le code complet du fichier template.css . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139

    P. Le site avec le template complet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1421. Installer le template complet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1422. Les modules du site Joomla! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1423. L’en-tête du site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1424. La zone centrale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1425. La zone des informations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1426. Le pied de page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1427. L’affichage du site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143

    Chapitre 5 : Les options et styles des templatesA. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147B. Le fichier de description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148C. Les options de template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148

    1. La description XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1482. Les options disponibles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149

    D. Un sélecteur de couleur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1501. La création de l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1502. L’affichage de l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1513. Modifier les styles CSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1524. Utiliser l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152

    E. Ajouter une image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1531. La création de l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1532. L’affichage de l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1543. Modifier le code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1544. Utiliser l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156

    F. Un champ de saisie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1571. La création de l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1572. L’affichage de l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1583. Modifier le code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1584. Utiliser l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159

  • Joomla! - Conception et personnalisation des templates6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . G. Insérer un choix unique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160

    1. La création de l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1602. L’affichage de l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1613. Modifier le code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1614. Utiliser l’option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162

    H. Le code complet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1631. Le fichier templateDetails.xml. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1632. Le fichier index.php. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165

    I. Les styles des templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1701. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1702. Renommer un style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1703. Créer un nouveau style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1714. Utiliser le nouveau style. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172

    J. Les substitutions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1731. Les objectifs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1732. Créer une substitution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1733. Modifier le fichier du module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175

    Chapitre 6 : Le template ProtostarA. L’objectif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .181B. La structure du dossier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182C. Le fichier templateDetails.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187

    1. L’en-tête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1872. La déclaration d’extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1873. Les informations du template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1874. La liste des fichiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1885. Les positions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1886. Les fichiers de traduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1907. Les options du template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1908. L’option de couleur globale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1919. L’option de couleur d’arrière-plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19210. L’option de sélecteur de fichier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19311. L’option pour le titre du site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19412. L’option de description du site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19413. L’option des polices Google. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19514. L’option du choix de la police . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19715. L’option de l’affichage fluide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .198

    D. Le fichier index.php . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2001. Le commentaire initial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2002. Les paramètres du template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2003. L’édition des articles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201

  • Table des matières 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .©

    Edi

    tions

    EN

    I - A

    ll rig

    hts r

    eser

    ved

    4. Le chargement des librairies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2025. La police Google. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2026. La couleur globale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2037. Les fichiers optionnels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2048. L’ajustement de la largeur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2049. L’affichage du logo ou du titre . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20510. La fin du PHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20611. L’en-tête HTML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20612. La taille des écrans. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20613. L’inclusion de l’en-tête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20614. Le corps de la page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20615. La structure des boîtes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20716. Les structures principales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20817. L’élément de l’en-tête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20918. L’élément pour la navigation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20919. La zone centrale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21020. La boîte du pied de page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211

    E. Les mises en page spécifiques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2111. La mise en page fluide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2112. La mise en forme de l’en-tête . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2113. La mise en forme du pied de page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212

    Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213

  • Chapitre 4 : Un template complet©

    Edi

    tions

    EN

    I - A

    ll rig

    hts r

    eser

    ved

    91. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .Chapi tre 4 : Un tem pl at e com pl et

    Joom l a! - Con cept i on et pers onn al i s at i on d es t em pl atesA. L’objectifDans ce chapitre nous allons créer un template complet pour Joomla!. Nous allons proposer plusde positions pour afficher les modules et gérer les styles CSS de manière plus précise.

    Voilà la maquette du template que nous allons créer :

    Nous avons :- Un en-tête qui contiendra un titre sur la gauche et la zone de recherche à droite.- Une barre des menus, pour y afficher un module d’un menu.- Une zone comportant deux emplacements pour afficher des modules. Nous y afficherons deux

    modules Articles - Catégorie pour afficher les articles de deux catégories d’articles nomméesNouveautés et Promotions.

    lcroiseTampon

  • Joomla! - Conception et personnalisation des templates92 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . - Une zone centrale découpée en trois colonnes : une colonne à gauche et à droite pour y afficher

    des modules et la colonne centrale pour y afficher le contenu du site. Nous aurons un fil d’Arianeau-dessus de la zone du contenu.

    - Une zone inférieure avec trois emplacements pour y afficher des modules (Derniers articles,Articles - Archivés et Connexion).

    - Un pied de page, dans lequel nous placerons un module de type Contenu personnalisé.

    B. La structure du template

    1. Le dossierNous vous proposons de le nommer templatecomplet. Souvenez-vous des règles de nommageque nous avons vues dans le chapitre Un template simple.

    2. Le fichier index.html

    v Dans notre dossier du template templatecomplet, créez un fichier index.html. Ce fichier estsimplement fait pour sécuriser le template.

    v Saisissez le code suivant :

    3. Les styles CSS

    v Dans le dossier templatecomplet, créez un dossier nommé css. Dans ce dossier, créez lefichier de feuille de style que vous nommez template.css.

    v Dans ce dossier, et pour les mêmes raisons que précédemment, créez un fichier index.php.Ce dernier contiendra le même code que précédemment.

    4. Les imagesLes images éventuellement nécessaires à notre template seront placées dans un dossier nomméimages. Mais dans notre exemple, il n’y a pas d’image pour ce template, nous ne créons donc pasde dossier images.

    xNotez que vous pouvez télécharger le template complet depuis le site des Éditions ENI.

  • Chapitre 4 : Un template complet©

    Edi

    tions

    EN

    I - A

    ll rig

    hts r

    eser

    ved

    93. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5. Le fichier de description

    v Toujours dans notre dossier templatecomplet, créez un fichier nommé templateDetails.xml.Ce fichier indispensable contiendra la description de notre template.

    6. Le fichier maître

    v Enfin créez un fichier nommé index.php. Ce fichier est le fichier « maître » de notre template.C’est lui qui contiendra toute la description des éléments à afficher dans notre template.

    7. Les vignettes

    v Créez un fichier nommé template_thumbnail.png pour l’affichage de la vignette du tem-plate dans l’administration. La taille est généralement de 206x150 pixels.

    v Créez un fichier nommé template_preview.png pour l’affichage en plus grande taille. Lataille est généralement de 640x388 pixels.

    8. Le dossier du templateVoici le contenu du dossier du template templatecomplet :- Dossier css, avec les fichiers template.css et index.html.- index.html.- index.php.- template_preview.png.- template_thumbnail.png.- templateDetails.xml.

  • Joomla! - Conception et personnalisation des templates94 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C. Le fichier de description

    1. L’objectifLe fichier templateDetails.xml va contenir toute la description de notre template, aussi bienpour l’installation, que pour les éléments à charger et à afficher dans l’administration.

    Nous retrouvons les mêmes informations que dans l’exemple précédent.

    2. L’en-têteLe fichier commence par la déclaration XML et par le doctype de Joomla!.

    3. La déclaration d’extensionLa ligne suivante indique que nous créons une extension pour Joomla!.

    - version="3.1" : indique pour quelle version minimale de Joomla! cette extension est faite.- type="template" : indique que cette extension est un template.- client="site" : indique que c’est un template pour un site.

    Tout à la fin du fichier nous aurons la fermeture de cet élément : .

    4. Les informations du template et du concepteurEnsuite nous saisissons quelques informations concernant le template et le concepteur.templatecomplet

    0.1

    24/09/2017

    Christophe AUBRY

    [email protected]

    Copyright ©. All rights reserved.

    La description de ce template complet

    - : nom du template. Attention il doit être strictement équivalent à celui du dossier.- : numéro de version du template.- : date de création du template.- : nom de l’auteur du template.- : mail du concepteur.

  • Chapitre 4 : Un template complet©

    Edi

    tions

    EN

    I - A

    ll rig

    hts r

    eser

    ved

    95. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .- : indication d’un éventuel copyright.- : description du template.

    Ces informations pourront être affichées dans les détails du template.

    5. Les fichiers du templateEnsuite, nous devons indiquer tous les fichiers constitutifs de notre template dans l’élément.

    index.html

    index.php

    templateDetails.xml

    template_preview.png

    template_thumbnail.png

    css

    6. Les positionsPuis dans l’élément nous indiquons les positions disponibles dans notre tem-plate.

    recherche

    menus

    nouvelles-1

    nouvelles-2

    colonne-g

    colonne-d

    ariane

    info-1

    info-2

    info-3

    pied-de-page

    Nous indiquons onze positions :- pour la zone de recherche : recherche,- pour la barre des menus : menus,- pour les zones des nouvelles : nouvelles-1 et nouvelles-2,- pour la colonne de gauche : colonne-g,- pour la colonne de droite : colonne-d,

  • Joomla! - Conception et personnalisation des templates96 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . - pour le fil d’Ariane : ariane,- pour les zones des informations : info-1, info-2 et info-3,- pour le pied de page : pied-de-page.

    Copyright - Editions ENI - Décembre 2017ISBN : 978-2-409-01128-3IntroductionChapitre 1 : La gestion des templatesA. L’objectif 13B. Exploiter les templates 13C. Le template par défaut 13D. Gérer les templates 14

    1. Installer un template 142. Lister les templates et les styles 153. Filtrer les templates et les styles 174. Désactiver un template 185. Désinstaller un template 206. Gérer les styles 21E. L’aperçu des templates 22

    1. Activer l’aperçu 222. Aperçu des autres templates 24F. Les paramètres des templates 26

    1. Les fichiers constitutifs 262. Les options de style des templates 303. L’affectation des menus 31Chapitre 2 : La structure des templatesA. L’objectif 37B. Le dossier du template 37

    1. Les templates pour Joomla! 372. Les fichiers d’un template 37C. Le fichier de description 38

    1. L’objectif 382. L’en-tête 383. Le concepteur 394. Les fichiers d’installation 395. La liste des positions 406. Les langues disponibles 417. Les options du template 41D. Les inclusions JDOC 44

    1. L’objectif 442. L’en-tête 443. Les composants 444. Les messages 445. Le débogage 446. Le chargement des modules 457. L’affichage des modules 45E. La position des modules 46F. Les classes CSS de Joomla! 47

    1. Les classes par défaut 472. Connaître les classes par défaut 49Chapitre 3 : Un template simpleA. L’objectif 55B. La structure du template 56

    1. Le dossier 562. Le fichier index.html 563. Les styles CSS 564. Les images 565. Le fichier de description 566. Le fichier maître 577. Les vignettes 578. Le dossier du template 57C. Le fichier de description 58

    1. L’objectif 582. L’en-tête 583. La déclaration d’extension 584. Les informations du template et du concepteur 585. Les fichiers du template 596. Les positions 607. Les autres paramètres 618. Le code complet 61D. Les conteneurs 62E. Le début du fichier index.php 63

    1. L’objectif 632. Restreindre l’accès direct 633. Les déclarations HTML 634. L’élément 645. Les métadonnées 646. Les feuilles de style par défaut 647. Notre feuille de style 648. La fin de l’en-tête 659. Le code complet 65F. Le corps du fichier index.php 65

    1. Le corps de la page 652. Les conteneurs 66G. La mise en forme CSS 67H. Le conteneur principal 67I. L’en-tête de la page 68

    1. Les boîtes d’affichage 682. L’image de fond de l’en-tête 683. Le logo 694. Le module de recherche 70J. La barre des menus 70

    1. La mise en forme 702. Insérer la barre des menus 71K. La zone centrale 72

    1. Les boîtes d’affichage 722. Les conditions d’affichage 723. La mise en page 734. Les règles CSS 76L. Le pied de page 77M. Le code complet 77

    1. Pour le fichier index.php 772. Pour le fichier template.css 79N. L’affichage du site 81

    1. Le template 812. Les modules 813. L’affichage 85Chapitre 4 : Un template completA. L’objectif 91B. La structure du template 92

    1. Le dossier 922. Le fichier index.html 923. Les styles CSS 924. Les images 925. Le fichier de description 936. Le fichier maître 937. Les vignettes 938. Le dossier du template 93C. Le fichier de description 94

    1. L’objectif 942. L’en-tête 943. La déclaration d’extension 944. Les informations du template et du concepteur 945. Les fichiers du template 956. Les positions 957. Le code complet 97D. La structure du template complet 99E. Le début du fichier index.php 100

    1. L’objectif 1002. Le code 100F. Le corps du fichier index.php 100G. Les conteneurs 101

    1. La mise en page 1012. Les styles CSS des tableaux 103H. Le bandeau supérieur 104

    1. L’affichage 1042. Les styles CSS 1043. Le contenu 1054. Le code généré 106I. La barre des menus 107

    1. L’affichage 1072. Les styles CSS 1073. Le code généré 108J. Les zones des nouvelles 108

    1. L’affichage des nouvelles dans les positions 1082. Les styles CSS et l’affichage 1093. L’affichage conditionnel 1104. Les styles CSS pour les nouvelles 1125. L’affichage des nouvelles 1136. Les styles CSS des modules inclus 114K. La zone centrale 116

    1. L’affichage dans les positions 1162. Les conditions d’affichage 1173. Adapter les largeurs des colonnes 1184. Les styles CSS pour les colonnes 1215. L’affichage 1226. Les styles CSS des modules inclus 125L. Le fil d’Ariane 127

    1. L’affichage 1272. Les styles CSS 1283. Les styles du module 128M. La zone des informations 129

    1. L’affichage dans les positions 1292. Les conditions d’affichage 1293. Les styles CSS pour les informations 1314. L’affichage 1325. Les styles des modules 134N. Le pied de page 134

    1. L’affichage dans les positions 1342. Les conditions d’affichage 1353. Les styles CSS 1354. L’affichage 1355. Le code généré 135O. Le code du template 136

    1. Le code complet du fichier index.php 1362. Le code complet du fichier template.css 139P. Le site avec le template complet 142

    1. Installer le template complet 1422. Les modules du site Joomla! 1423. L’en-tête du site 1424. La zone centrale 1425. La zone des informations 1426. Le pied de page 1427. L’affichage du site 143Chapitre 5 : Les options et styles des templatesA. L’objectif 147B. Le fichier de description 148C. Les options de template 148

    1. La description XML 1482. Les options disponibles 149D. Un sélecteur de couleur 150

    1. La création de l’option 1502. L’affichage de l’option 1513. Modifier les styles CSS 1524. Utiliser l’option 152E. Ajouter une image 153

    1. La création de l’option 1532. L’affichage de l’option 1543. Modifier le code 1544. Utiliser l’option 156F. Un champ de saisie 157

    1. La création de l’option 1572. L’affichage de l’option 1583. Modifier le code 1584. Utiliser l’option 159G. Insérer un choix unique 160

    1. La création de l’option 1602. L’affichage de l’option 1613. Modifier le code 1614. Utiliser l’option 162H. Le code complet 163

    1. Le fichier templateDetails.xml 1632. Le fichier index.php 165I. Les styles des templates 170

    1. L’objectif 1702. Renommer un style 1703. Créer un nouveau style 1714. Utiliser le nouveau style 172J. Les substitutions 173

    1. Les objectifs 1732. Créer une substitution 1733. Modifier le fichier du module 175Chapitre 6 : Le template ProtostarA. L’objectif 181B. La structure du dossier 182C. Le fichier templateDetails.xml 187

    1. L’en-tête 1872. La déclaration d’extension 1873. Les informations du template 1874. La liste des fichiers 1885. Les positions 1886. Les fichiers de traduction 1907. Les options du template 1908. L’option de couleur globale 1919. L’option de couleur d’arrière-plan 19210. L’option de sélecteur de fichier 19311. L’option pour le titre du site 19412. L’option de description du site 19413. L’option des polices Google 19514. L’option du choix de la police 19715. L’option de l’affichage fluide 198D. Le fichier index.php 200

    1. Le commentaire initial 2002. Les paramètres du template 2003. L’édition des articles 2014. Le chargement des librairies 2025. La police Google 2026. La couleur globale 2037. Les fichiers optionnels 2048. L’ajustement de la largeur 2049. L’affichage du logo ou du titre 20510. La fin du PHP 20611. L’en-tête HTML 20612. La taille des écrans 20613. L’inclusion de l’en-tête 20614. Le corps de la page 20615. La structure des boîtes 20716. Les structures principales 20817. L’élément de l’en-tête 20918. L’élément pour la navigation 20919. La zone centrale 21020. La boîte du pied de page 211E. Les mises en page spécifiques 211

    1. La mise en page fluide 2112. La mise en forme de l’en-tête 2113. La mise en forme du pied de page 212Index 213Chapitre 1 : La gestion des templatesA. L’objectif 13B. Exploiter les templates 13C. Le template par défaut 13D. Gérer les templates 14E. L’aperçu des templates 22F. Les paramètres des templates 26

    Chapitre 2 : La structure des templatesA. L’objectif 37B. Le dossier du template 37C. Le fichier de description 38D. Les inclusions JDOC 44E. La position des modules 46F. Les classes CSS de Joomla! 47

    Chapitre 3 : Un template simpleA. L’objectif 55B. La structure du template 56C. Le fichier de description 58D. Les conteneurs 62E. Le début du fichier index.php 63F. Le corps du fichier index.php 65G. La mise en forme CSS 67H. Le conteneur principal 67I. L’en-tête de la page 68J. La barre des menus 70K. La zone centrale 72L. Le pied de page 77M. Le code complet 77N. L’affichage du site 81

    Chapitre 4 : Un template completA. L’objectif 91B. La structure du template 92C. Le fichier de description 94D. La structure du template complet 99E. Le début du fichier index.php 100F. Le corps du fichier index.php 100G. Les conteneurs 101H. Le bandeau supérieur 104I. La barre des menus 107J. Les zones des nouvelles 108K. La zone centrale 116L. Le fil d’Ariane 127M. La zone des informations 129N. Le pied de page 134O. Le code du template 136P. Le site avec le template complet 142

    Chapitre 5 : Les options et styles des templatesA. L’objectif 147B. Le fichier de description 148C. Les options de template 148D. Un sélecteur de couleur 150E. Ajouter une image 153F. Un champ de saisie 157G. Insérer un choix unique 160H. Le code complet 163I. Les styles des templates 170J. Les substitutions 173

    Chapitre 6 : Le template ProtostarA. L’objectif 181B. La structure du dossier 182C. Le fichier templateDetails.xml 187D. Le fichier index.php 200E. Les mises en page spécifiques 211

    BCDEFIJMNOPSTVZJoomla!Conception et personnalisation des templatesCopyright - Editions ENI - Décembre 2017ISBN : 978-2-409-01129-0