Mise en page de la page principale ("Category" ou "Index")
Activez vos liens

Niveau de difficulté: Débutant.

Ce que vous allez apprendre sur les variables $conf dans cette astuce devrait être utilisé comme principe à chaque fois que vous aurez une $conf à modifier. Vous pouvez vous inspirer du contenu de /include/config_default.inc.php mais ne modifiez jamais directement ce fichier.

Vous allez créer ou modifier le fichier /include/config_local.inc.php.

Intérêt: Depuis la version 1.5.0 de PWG, vos changements ne seront plus perdus à chaque changement de version.

Principe: Le default contient toutes les variables. Le local ne contient que celles que vous avez voulu modifier. Le default est sollicité en premier, et s’il existe, le local applique les changements spécifiques à votre site.

Prenons le cas de nos liens, par default aucun lien n’existe.
En modifiant la variable (de type tableau) $conf[’links’] et ceci au niveau du local, vous allez une fois pour toutes définir les liens spécifiques à votre site.

A quoi va ressembler le fichier /include/config_local.inc.php: tout simplement à n’importe quel module php, c’est à dire qu’il commence par «<?php » et se termine par « ?>». Entre ces deux marqueurs, et en respectant la même syntaxe que dans le default, c’est à dire la syntaxe du langage php, vous altèrerez les différentes valeurs du tableau $conf quelles qu’elles soient. Vous éviterez de reporter toutes les définitions de default ceci afin de faciliter le repérage des éventuelles différences.

Prenons donc exemple sur nos liens:
(Notez au passage) : un exemple du fichier local est fourni dans le répertoire /tools/ mais attention les paramètres proposés peuvent ne pas convenir à votre site, ce qui est en général le cas.

Donc pour nos liens, vous allez créer ou compléter le fichier /include/config_local.inc.php afin qu’il ressemble à ceci:

// links : liste des liens externes
$conf['links'] = array(
   'http://phpwebgallery.net' => 'L\'homepage PWG',
   'http://forum.phpwebgallery.net' => 'Son forum',
   'http://phpwebgallery.net/doc' => 'Sa documentation'
   );

Explications: $conf est un tableau indicé par des noms de paramètres prédéfinis connus de PWG et dans le cas présent, il s’agit de ‘links’.
Pour notre exemple, vous ajouterez autant de lignes que de liens souhaités, en précisant: à gauche l’URL et à droite le nom du lien.
Si vous avez besoin d’une apostrophe simple (quote en programmation), pensez à la faire précéder d’une barre oblique inversée “\??? (anti-slash en programmation).

Vous venez de mettre en place :

    * un lien vers “L’homepage PWG???,
    * un autre vers “Son forum???,
    * et enfin, un vers “Sa documentation???.

Rappel: ne jamais effectuer de modification dans config_default.inc.php mais uniquement en local.

Toutes les cellules du tableau $conf peuvent contenir des valeurs selon les principes du langage PhP. C’est à dire:

   1. des valeurs ( de type booléen, numérique, chaîne de caractère, etc.),
   2. des tableaux de valeurs,
   3. des tableaux de tableaux de valeurs, ...

Toute cellule de $conf référencée dans config_default.inc.php peut être ajustée au besoin de votre site dans config_local.inc.php.

Si vous ajustez plusieurs fois un des paramètres de $conf, seule la dernière valeur attribuée comptera.

Et pour finir, un exemple à ne pas suivre:

$conf['links'] = array(
   'http://phpwebgallery.net' => 'PWG website',
   'http://forum.phpwebgallery.net' => 'PWG forum',
   'http://phpwebgallery.net/doc' => 'PWG wiki'
   );
$conf['links'] = array(); // Annule la mise à jour précédente

Eh bien.... un grand merci à toi, pour tous ces renseignements! En espérant que je n'aurai pas fait d'erreurs.
Je rajouterai toutes mes félicitations pour ton site et tes photos. En parlant de "rajouter des phrases", je parlais d'une "case" un peu comme ta "présentation" sur ton site. Si tu avais un lien qui explique cela, je serais volontiers preneur, sans vouloir abuser.
  Encore merci.