Joomla! pour les Nuls

Sans entrer dans les détails, cette partie du fichier index.php va entre autres choses permettre de:

• Déclarer le type du doctype (Document Type Declaration) pour indiquer au navigateur dans quel type de HTML la page a été écrite (HTML 4 ou XHTML 1, transitional ou strict)
• Déclarer l'encodage de la page (ISO, UTF8...)
• Spécifier l'emplacement de la feuille de style CSS (template_css.css)
• De définir au moyen de styles CSS l'apparence des différents éléments de la page chargés par les instruction PHP (voir plus bas)

Vous verrez évidemment aussi des balises <DIV> ou <TABLE>, parfois même les deux! Il n'est pas question ici de réouvrir le débat design par tableau contre design par CSS mais sachez toutefois qu'en principe les balises <TABLE> sont faites pour présenter des données tabulaires (comme la quadricule d'un tableur par exemple), pas pour mettre en forme du contenu! Outre le fait qu'elles surcharge le code lorsqu'elles sont utilisées pour « designer » une page, ce sont de toutes façons les balise <DIV> qui sont recommandées par les standards du Web.

Ceci étant dit, même si vous vous êtes plié en quatre pour coder votre template sans une seule balise <TABLE>, Joomla! en produira quand même car le noyau est ainsi fait. Les développeurs de composants tiers ne s'embarrassent pas non plus de standards Web et ont souvent tendance à abuser des <TABLE>.

Tout est affaire de compromis donc; un débutant se sentira plus à l'aise avec des tableaux là où un puriste criera au scandale. Entre les inconditionnels du tableau et les intégristes du DIV vous devrez trouver votre chemin :-). Voir cet article pour plus d'informations: http://pompage.net/pompe/tablevscss/ .

<?php mosShowHead(); ?>

Permet de générer les balises meta saisis dans le backend pour le site et chacun des articles.

<?php echo $mosConfig_sitename;?>

Permet d'afficher le titre que vous avez donné à votre site; cette valeur est récupérée dans le fichier configuration.php à la racine de votre site Joomla!

<?php echo $mosConfig_live_site;?>

Permet d'afficher l'URL de votre site; cette valeur est aussi récupérée dans le fichier configuration.php.

<?php mospathway()?>

Permet d'afficher la barre de navigation du site:

<?php mosLoadModules('banner');?>

Permet d'afficher tous les modules du site publiés en position Banner; par exemple les bannières que vous aurez publiées via le composant Bannières.

<?php mosLoadModules('top');?>

Permet d'afficher tous les modules du site publiés en position Top.

<?php mosLoadModules('left');?>

Permet d'afficher tous les modules du site publiés en position Left.

<?php mosLoadModules('right');?>

Permet d'afficher tous les modules du site publiés en position Right.

<?php mosMainBody();?>

Permet d'afficher le corps de la page (articles et composants)

<?php include_once( $mosConfig_absolute_path .'/includes/footer.php' );?>

Permet d'afficher un pied de page dynamique à partir des fichiers /includes/footer.php et /includes/version.php

• La syntaxe de mosLoadModules (chargeurs de modules) est:
  mosLoadModules ( [ string $position [, int $style ]] )

• string $position pourra prendre pour valeur une chaîne de caractères correspondant aux positions de modules prises en charge par votre site (Left, Right, Top, Banner, User1, User2...). La liste de ces positions est consultable dans le backend en passant par le menu Site / Gestion des Templates / Positions des modules.
• int $style pourra prendre pour valeur 5 entiers, chacun correspondant à un style d'affichage du module:
• 1 = horizontal (affichage sous forme de ligne)
• 0 = normal (affichage par défaut, en colonne)
• -1 = raw (affichage brut, sans titre)
• -2 = XHTML (affichage entre des tags div et headers)
• -3 = extra divs (affichage avec d'autres tags div autour du module, utilisé pour les coins arrondis par exemple)

Exemple:

<?php mosLoadModules( 'banner', -1 ); ?>

mosLoadModules ( 'left',-3);

mosLoadModules ( 'user1',-2);

Vous trouverez également des instructions de type mosCountModules, qui vous permettront d'escamoter une colonne ou une ligne qui ne contient aucun module publié dans la position de menu spécifiée en paramètre.

Exemple tiré du template madeyourweb :

if ((mosCountModules( "right" )) || (mosCountModules( "top" ))) {
      ?>
      <div id="rightcol-broad">
              <?php mosLoadModules ( 'top',-3); ?>
              <?php mosLoadModules ( 'right',-3); ?>
      </div>
      <?php
}
?>
<div class="clr"></div>