[phpBB 3.0.x] Créer un fichier config pour son style
Posté : lun. 24 oct. 2011 13:50
» Créer un fichier config pour son style
Pour diverses raisons, vous souhaitez pouvoir laisser le choix à l'utilisateur de personnaliser son style sans devoir modifier moultes fichiers. Nous allons donc définir des variables qui pourront être facilement modifiables dans un seul fichier.
Avant toute modification, il est important de faire une sauvegarde de ses fichiers.
» Création du fichier de configuration
Dans un premier temps, nous allons créer le fichier template approprié et le nommer « prosilver_config.html ». Pour notre exemple, il va contenir quelques données comme: Ce fichier exemple est à mettre dans le dossier « styles/{VOTRE_THEME}/template/ ».
Veuillez noter que si vous souhaitez définir un texte particulier avec les accents, il faudra encoder la page en « UTF8 sans bom ».
» Appel du fichier de configuration
Pour faire appel à ce fichier et pouvoir utiliser toutes les variables partout, il suffira de faire ce qui suit:
Ouvrez le fichier « styles/{VOTRE_THEME}/template/overall_header.html ».
Cherchez:
Avant, ajoutez:
» Utilisation des variables
Pour utiliser une variable, c'est très simple en fait: Notez bien le $ devant car il est très important. Il ne faut donc pas omettre de l'ajouter.
Ceci est un exemple et ça affichera tout simplement le texte qui aura été défini.
Vous pouvez également faire des conditions comme suit:
Un autre exemple concret: Cela signifie que si « $POSTING_RULES » est défini à « true » dans le fichier « prosilver_config.html » alors le texte sera affiché. Dans le cas contraire, il ne s'affichera pas.
» Exemple concret
Dans cette partie, nous allons vous donner un exemple concret de ce que cela peut donner.
Tout d'abord, nous allons éditer le fichier que nous avons créé précédemment, à savoir « prosilver_config.html ». Donc nous l'ouvrons et dans le code, nous ajoutons simplement ce qui suit: A noter que 1 est l'id du message (Post ID) qui est stocké dans la base de données.
Ensuite, ouvrez le fichier « styles/{VOTRE_THEME}/template/viewtopic_body.html ».
Cherchez:
Avant, ajoutez:
Ce qui donnerait:
Sujet qui contient l'id du message (1) de notre exemple:
Sujet qui ne contient pas l'id défini:
» Rafraîchissement et vidage du cache
N'oubliez pas de rafraîchir le template (onglet Styles) et de vider le cache (onglet Général).
Pour diverses raisons, vous souhaitez pouvoir laisser le choix à l'utilisateur de personnaliser son style sans devoir modifier moultes fichiers. Nous allons donc définir des variables qui pourront être facilement modifiables dans un seul fichier.
Avant toute modification, il est important de faire une sauvegarde de ses fichiers.
» Création du fichier de configuration
Dans un premier temps, nous allons créer le fichier template approprié et le nommer « prosilver_config.html ». Pour notre exemple, il va contenir quelques données comme:
Code : Tout sélectionner
<!-- DEFINE $FORUM_WIDTH = '100%' -->
<!-- DEFINE $FORUM_HEIGHT = '100%' -->
<!-- DEFINE $WHOIS_ONLINE = 'true' -->
<!-- DEFINE $WHOIS_LEGEND = 'true' -->
<!-- DEFINE $POSTING_RULES = 'false' -->
<!-- DEFINE $POSTING_RULES_TEXT = '<strong>Attention</strong>: <br /> vous ne pouvez pas publier de liens!' -->
Veuillez noter que si vous souhaitez définir un texte particulier avec les accents, il faudra encoder la page en « UTF8 sans bom ».
» Appel du fichier de configuration
Pour faire appel à ce fichier et pouvoir utiliser toutes les variables partout, il suffira de faire ce qui suit:
Ouvrez le fichier « styles/{VOTRE_THEME}/template/overall_header.html ».
Cherchez:
Code : Tout sélectionner
<meta http-equiv="content-type" content="text/html; charset={S_CONTENT_ENCODING}" />
Code : Tout sélectionner
<!-- INCLUDE prosilver_config.html -->
Pour utiliser une variable, c'est très simple en fait:
Code : Tout sélectionner
{$POSTING_RULES_TEXT}
Ceci est un exemple et ça affichera tout simplement le texte qui aura été défini.
Vous pouvez également faire des conditions comme suit:
Code : Tout sélectionner
<!-- IF $MA_VAR --> votre texte par exemple <!-- ENDIF -->
Un autre exemple concret:
Code : Tout sélectionner
<!-- IF $POSTING_RULES == 'true' -->{$POSTING_RULES_TEXT}<!-- ENDIF-->
» Exemple concret
Dans cette partie, nous allons vous donner un exemple concret de ce que cela peut donner.
Tout d'abord, nous allons éditer le fichier que nous avons créé précédemment, à savoir « prosilver_config.html ». Donc nous l'ouvrons et dans le code, nous ajoutons simplement ce qui suit:
Code : Tout sélectionner
<!-- DEFINE $TOPIC_SPACE = 1 -->
Ensuite, ouvrez le fichier « styles/{VOTRE_THEME}/template/viewtopic_body.html ».
Cherchez:
Code : Tout sélectionner
<!-- IF postrow.S_FIRST_UNREAD --><a id="unread"></a><!-- ENDIF -->
Code : Tout sélectionner
<!-- IF postrow.POST_ID eq $TOPIC_SPACE --><img src="http://www.phpbb.com/community/styles/prosilver/theme/ads/upper_get_involved.png" style="margin-bottom: 5px;" alt="Get Involved" /><!-- ENDIF -->
Sujet qui contient l'id du message (1) de notre exemple:
Sujet qui ne contient pas l'id défini:
» Rafraîchissement et vidage du cache
N'oubliez pas de rafraîchir le template (onglet Styles) et de vider le cache (onglet Général).