[phpBB 3.2.x] Créer un fichier config.html pour son style

Toutes les documentations phpBB seront ici.
Verrouillé
Avatar du membre
Dakin Quelia
Webmaster
Webmaster
Messages : 563
Enregistré le : ven. 27 nov. 2009 05:47
Localisation : Belgique
Contact :

[phpBB 3.2.x] Créer un fichier config.html pour son style

Message par Dakin Quelia »

» Créer un fichier config.html pour son style
Pour diverses raisons, vous pourriez avoir besoin de créer un fichier « config.html » pour votre style afin de définir des paramètres que l'utilisateur pourra choisir d'activer ou non. A l'aide de cette documentation, vous allez pouvoir obtenir le résultat que vous désirez.

/!\ Tout notre code utilisera le système template Twig.

Je vous invite d'ailleurs à lire ce sujet (en anglais) concernant la syntaxe Twig.

» 1. Créer et inclure le fichier config.html

Avant toute chose, il faut que nous créons un fichier que nous appellerons « config.html » et qui sera placé dans le dossier « template » de votre style. Une fois fait, nous allons modifier le fichier template « /styles/{VOTRE_THEME}/template/overall_header.html » et faire appel à notre nouveau fichier.

Cherchez :

Code : Tout sélectionner

<head>
Après, ajoutez :

Code : Tout sélectionner

{% include 'config.html' %}
Maintenant, il ne reste plus qu'à vous donner un exemple.

» 2. Exemple

Imaginons que je veuille n'afficher que l'image du rang (et non son texte) via une option du style. Pour ce faire, nous allons définir la variable conditionnelle et nous allons lui donner comme valeur par défaut : 1 (true).

Ouvrez le fichier « config.html » et ajoutez ce code :

Code : Tout sélectionner

{% DEFINE S_RANK_IMG_DISPLAY  = '1' %}
Et pour utiliser la variable que nous venons de définir, vous placerez le code ci-dessous dans le fichier template adéquat (ici en l'occurrence viewtopic_body.html) :

Code : Tout sélectionner

{% if postrow.RANK_TITLE or postrow.RANK_IMG %}<dd class="profile-rank">{% if postrow.RANK_IMG and definition.S_RANK_IMG_DISPLAY %}{postrow.RANK_IMG}{% else %}{postrow.RANK_TITLE}{% endif %}</dd>{% endif %}
Notez bien « definition.S_RANK_IMG_DISPLAY » car la mention « definition » est très importante puisque sans cela le code ne fonctionnera pas.

» 3. Mot de la fin

Une fois que vous avez bien compris le principe, vous pouvez ainsi créer diverses variables/conditions pour vos styles. Comme vous l'avez remarqué, ce n'est pas très compliqué.

Vous pourriez même définir un texte via ce procédé (uniquement si on n'a pas le choix).

Si vous avez des questions et/ou des soucis, n'hésitez pas à demander.

Verrouillé

Qui est en ligne

Utilisateurs parcourant ce forum : Aucun utilisateur enregistré et 1 invité