[Astuce] Créer un fichier config.html pour son style

Pour les recherches et les demandes de modifications de styles concernant votre forum phpBB 3.2

Modérateur: Equipe

Règles du forum
A lire impérativement : Règlement de phpBB-fr.com - Conditions générales de support graphique

Attention : pour éviter les bogues, votre style doit être mis à jour en même temps que votre forum, et ce, dans la dernière version disponible de phpBB !

[Astuce] Créer un fichier config.html pour son style

Messagepar Dakin Quelia » 28 Juin 2018 à 03:43

» 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.

______________________________________________________
Ceci est une simple astuce et non une documentation complète.
Aucun support par mail, MP ou msn.
Mes MODs: ici | Mon blogue: Mon blogue | DeviantArt: cliquez ici
Dakin Quelia
Floodeur universel
Floodeur universel
 
Messages: 21390
Enregistré le: 31 Oct 2006 à 18:33
Localisation: Belgique

Re: [Astuce] Créer un fichier config.html pour son style

Messagepar Mazeltof » 30 Juin 2018 à 14:35

'jour ici,

Merci pour le partage :wink:
Image Image Image
Avatar de l’utilisateur
Mazeltof
Resp. des graphistes
Resp. des graphistes
 
Messages: 2909
Enregistré le: 09 Mar 2009 à 22:02
Localisation: Arras


Retourner vers [3.2.x] Modifications et recherche de styles

 


  • Articles en relation
    Réponses
    Vues
    Dernier message

Qui est en ligne

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