Vue d'ensemble des fichiers de thèmes

Traduction de la page http://drupal.org/node/171194
publiée / actualisée le 2 Avril 2011 sur drupal.org

Un thème est un ensemble de fichiers qui définit la mise en page du site. Vous pouvez également créer un ou plusieurs « sous-thèmes », ou variations à partir d'un thème. Le seul fichier obligatoire est le fichier .info, mais beaucoup de thèmes et sous-thèmes utiliseront d'autres fichiers.

Le schéma qui suit illustre les fichiers présents dans un thème ou sous-thème type :

.info (obligatoire)

Tout ce qui nécessaire à Drupal pour voir votre thème doit être référencé dans le fichier .info.

Si le thème en a besoin, les meta data, les feuilles de styles, le code Javascript, les régions, etc, doivent être spécifiés dans ce fichier. Tout le reste est facultatif.

Le nom « interne » du thème découle également de ce fichier. Par exemple, si le fichier est nommé « drop.info » alors, pour Drupal, le nom du thème sera « Drop ».

Drupal 5 et antérieurs utilisaient comme nom de thème, le nom du dossier où est enregistré le thème.

Les fichiers .info pour les thèmes est une nouveauté de Drupal 6. Dans la version 5, les fichiers .info étaient seulement utilisés par les modules.

Fichiers gabarits (template files) (.tpl.php)

Ces gabarits sont utilisés pour le balisage xHTML et pour les variables PHP. Dans certains cas ils peuvent fournir d'autres types de données, comme du rss xml par exemple. Chaque fichier .tpl.php gère l'affichage des données qui peuvent être spécifiquement mises en page ou stylisées et dans certains cas, plusieurs fichiers .tpl.php peuvent être gérés par le biais de suggestions (http://drupal.org/node/223440 (anglais), traduction en français ici).

Ces fichiers sont facultatifs, si votre thème n'en possède pas c'est l'affichage par défaut qui sera utilisé. Évitez toute structure complexe ou programmatique dans ces fichiers, ils ne devraient contenir que du balisage xHTML et des variables PHP.

Vous trouverez des exemples de ces fichiers .tpl.php dans les dossiers des modules installés.

Les copier dans votre dossier de thèmes forcera Drupal à utiliser votre version.

Remarque : le registre des thèmes place les informations sur les thèmes disponibles en cache. Vous devez vider ce cache chaque fois que vous modifiez votre fichiers de thèmes.

template.php

Pour tout ce qui concerne les tests et le traitement des données, vous utiliserez le fichier template.php. Il n'est pas indispensable mais afin de ne pas alourdir les fichiers.tpl.php on l'utilise pour les fonctions de pré-traitement , la génération des variables avant qu'elles ne soient fusionnées dans les fichiers tpl.php.

Les fonctions personnalisées, la surcharge des fonctions de thèmes, ou toute autre personnalisation de l'affichage doit être faite dans ce fichier.

Il débute par la balise d'ouverture PHP <?php, la balise de fermeture n'est pas nécessaire et il est même recommandé de ne pas la mettre.

sous-thèmes

A première vue, les sous-thèmes se comportent comme n'importe quel autre thème. La seule différence est qu'ils héritent des ressources de leurs thèmes-parent.

Pour créer un sous-thème, un paramètre « base theme » doit être spécifié dans le fichier .info. A ce moment, ils héritent des ressources de leur thème-parent.

Il peut y avoir plusieurs niveaux d'héritage. Un sous-thème peut, par exemple, déclarer un autre sous-thème comme base de départ. Il n'y a pas de limite matérielle à ces enchainements.

Drupal 5 et antérieurs nécessitaient que les sous-thèmes soient enregistrés dans un sous-dossier du thème-parent. Ce n'est désormais plus nécessaire.

Autres

• Le logo et la copie d'écran de votre thème ne sont pas obligatoires pour que le thème fonctionne. Mais ils sont recommandés, surtout si vous distribuez votre thème dans un dépôt Drupal

  La copie d'écran est affichée dans la page d'administration des thèmes et dans la page « Paramètres du compte utilisateur » pour que ce dernier puisse choisir un thème (s'il dispose des permissions requises). Reportez-vous à Screenshot guidelines pour plus d'information.

• Un fichier « theme-settings.php » peut être utilisé pour fournir des paramètres d'administration autres que ceux concernant le logo, la recherche, la mission, etc.

  Il s'agit d'une fonctionnalité avancée. Reportez-vous à la page Advanced settings du manuel pour plus d'informations.

• Pour l'utilisation du module « Color », un dossier « color » contenant un fichier « color.inc » est requis, ainsi que plusieurs fichiers de paramètres.

• Si vous voulez baser votre travail sur un thème du core, utilisez des sous-thèmes ou faites une copie du thème principal et renommez-le. La modification des thèmes Garland ou Minnelli est fortement déconseillée car ils sont utilisés pour les procédures d'installation ou de mise à jour.

• Tous les modifications des thèmes doivent être installés dans le dossier sites/all/themes, afin de les séparer des fichiers du core. Si vous prévoyez de faire tourner plusieurs sites à partir d'une seule installation de Drupal, vous pouvez rendre un thème disponible pour un seul site plutôt que pour l'ensemble des sites.

  Reportez-vous à Multi-site installation pour plus d'informations.

Sous-thèmes, leur structure et l'héritage

Traduction de la page http://drupal.org/node/225125
publiée / actualisée le 11 Mars 2011 sur Drupal.org

Les sous-thèmes sont identiques aux autres thèmes, à une différence près : ils héritent des ressources de leurs thèmes parents. Il n'y a pas de limite au nombre de sous-thèmes qui peuvent dériver les uns des autres à partir du thème-parent.

Un sous-thème peut être l'enfant d'un autre sous-thème, et il peut être ramifié ou organisé comme bon vous semble. Ce qui offre de grandes possibilités :

Supposons que vous démarriez en créant un thème global qui servira de maquette de base, les détails pourront ensuite être affinés dans un sous-thème. Ainsi, à partir d'une même base de départ, vous pouvez essayer différents designs en dérivant un ou plusieurs sous-thèmes à partir de ce thème de base.

Vous travaillez sur une installation multi-site mais avez besoin d'un "look and feel" cohérent ? Avec des sous-thèmes beaucoup de ressources graphiques peuvent être partagées. Les particularités d'un site peuvent être paramétrées dans un sous-thème spécifique, et si les ressources partagées doivent être modifiées, elles ne le sont qu'une seule fois et s'appliquent à toutes les installations. Avec une organisation soignée, les possibilités sont infinies.

La création d'un sous-thème

Le sous-thème doit se trouver dans son propre dossier sur le disque. Avant Drupal 6, le dossier devait être un sous-dossier du thème parent. Dans Drupal 6 et 7 il peut être situé à l'extérieur du dossier du thème parent.

Pour que votre thème soit considéré comme le thème enfant d'un thème parent, vous devez modifier le fichier .info. Ajoutez les lignes suivantes au fichier .info du sous-thème pour déclarer son thème parent. Remplacez themeName par le nom interne du thème parent (c'est à dire le nom qui se trouve dans le fichier .info du thème parent).

Héritage des feuilles de style

Toutes les feuilles de style déclarées dans le thème parent seront héritées, tant que vous déclarez au moins une feuille de style dans le fichier .info de votre sous-thème. Vous devez déclarer au moins une feuille de style dans votre sous-thème pour hériter des feuilles de style du thème parent.

Surcharger les feuilles de style héritées: déclarez une feuille de style dans le sous-thème avec le même nom. Par exemple, pour surcharger style.css héritée d'un thème parent, ajoutez la ligne suivante dans le fichier .info du sous-thème :

Vous devrez aussi créer le fichier pour style.css; si vous voulez seulement désactiver les styles importés, créez un fichier vide.

Héritage de JavaScript

Tous les fichiers JavaScripts déclarés dans le thème parent seront hérités.

Surcharger le JavaScript hérité : déclarez un fichier JavaScript avec le même nom dans le fichier .info. Par exemple, pour surcharger script.js hérité du thème parent, ajoutez la ligne suivante au fichier .info du sous-thème :

Vous devrez aussi créer le fichier script.js; si vous voulez simplement désactiver le script hérité, créez un fichier vide.

Héritage des fonctions Template.php

Tout ce qui a été déclaré dans le fichier template.php du thème parent sera hérité. Cela concerne la surcharge des fonctions, les fonctions de pré-traitement et tout le reste dans ce fichier. Chaque sous-thème doit aussi avoir son propre fichier template.php, dans lequel vous pouvez ajouter d'autres fonctions ou surcharger des fonctions du thème parent.

Surcharger les fonctions héritées de template.php: dans le fichier template.php du sous-thème, vous pouvez redéclarer des fonctions du fichier template.php parent (en utilisant le nom de votre sous-thème comme préfixe de fonction) pour surcharger des fonctions en particulier. On ne peut pas éviter l'héritage global de toutes les fonctions du thème parent.

Héritage des fichiers page, node, block et autres fichiers gabarits (.tpl.php)

Drupal 7 : tout fichier .tpl.php du thème parent sera hérité. Vous pouvez ajoutez des fichiers gabarits plus spécifiques - comme node--blog.tpl.php construit sur la base d'un node.tpl.php hérité.

Un trait d'union simple est toujours utilisé pour séparer les mots: par exemple, user-picture.tpl.php ou node--long--content-type-name.tpl.php, les doubles traits d'union signalent toujours une surcharge plus ciblée de ce qui précède le --. Consultez Conversion de thèmes Drupal 6.x en thèmes Drupal 7.x pour d'autres infos.

Drupal 6 : tout fichier .tpl.php du thème parent sera hérité. Cependant, pour ajouter des maquettes de mise en page plus ciblées, vous devez aussi copier manuellement le fichier de mise en page général du thème parent. Par exemple, pour ajouter un fichier gabarit node-blog.tpl.php dans un sous-thème, vous devez aussi copier le node.tpl.php du thème parent. Ce bug a été corrigé dans Drupal 7 mais ne sera pas corrigé dans Drupal 6.

Surcharger les fichiers .tpl.php hérités : pour surcharger le fichier gabarit du thème parent, ajoutez dans votre sous-thème un fichier gabarit portant le même nom.

Héritage de la copie d'écran et du logo

La copie d'écran du thème parent sera héritée. Le logo du thème parent (logo.png/logo.jpg) ne sera pas héritée.

Surcharger la copie d'écran héritée: déclarez une nouvelle image dans le fichier .info de votre sous-thème.

Héritage des regions

Les sous-thèmes n'héritent pas des regions personnalisées du thème parent. Si vous utilisez des régions personnalisées, vous devrez copier la déclaration des régions du fichier .info parent. Assurez-vous que le fichier page.tpl.php correspond bien au paramétrage des régions du sous-thème.

Héritage des couleurs et des paramètres de thème

Le support du module Color du dossier color n'est pas hérité.

Les paramètres de thème configurés via les paramètres avancés de thème de theme-setting.php ne sont pas hérités.

Structure du fichier .info

Traduction de la page http://drupal.org/node/171205
publiée / actualisé le 11 Mars 2011 sur drupal.org

La syntaxe du fichier .info est similaire à celle des fichiers INI (http://fr.wikipedia.org/wiki/Fichier_INI).

Le fichier .info est en fait un simple fichier texte qui décrit la configuration de chaque thème. Chacune de ses lignes est constituée par un couple clé+valeur dans laquelle la clé se trouve à gauche et la valeur à droite, avec un signe égal entre les deux (exemple : key = value).

Les points-virgules sont utilisés pour signaler les lignes de commentaires. Certaines clés utilisent une syntaxe particulière avec des crochets ouvrants et fermants pour la déclaration de listes de valeurs associées, également appelées « tableaux » (arrays). Si vous n'êtes pas familiarisés avec les tableaux, les exemples contenus dans le fichier .info et les explications qui suivent vous éclaireront.

Normes pour le nom du thème

Le nom du thème doit débuter par un caractère alphabétique, il peut contenir des chiffres et des signes souligné, mais pas de tirets, d'espaces ou de la ponctuation. Le nom sera utilisé par Drupal pour la formation de différentes fonctions PHP et aura par conséquent les mêmes restrictions. Attention ! Ne choisissez pas le même nom qu'un module, puisque les noms des modules installés doivent être uniques. Utiliser un préfixe qui sera unique pour les thèmes créés localement est une bonne idée. Un site exemple.com pourrait appeler ses thèmes ex_themename.

Comme le fichier .info est mis en cache, vous devez vider le cache pour que les modifications soient visibles dans votre site.

Le fichier .info peut également déclarer les paramètres de thème qui seront accessibles via l'interface d'administration, comme vous le verrez bientôt.

Drupal comprend les clés énumérées ci-dessous. Il utilisera des valeurs par défaut (http://drupal.org/node/171206, traduction en français : http://www.kolossaldrupal.org/docs/valeurs-info-par-defaut) pour les clés facultatives qui ne sont pas mentionnées dans le fichier .info. Reportez-vous aux exemples pour les thèmes principaux (http://drupal.org/node/171205#example, en français : http://www.kolossaldrupal.org/docs/structure-fichier-info)

• name obligatoire
• description conseillé
• screenshot
• version déconseillé
• core obligatoire
• engine souvent obligatoire
• base theme
• regions
• features
• stylesheets
• scripts
• php

name (obligatoire)

Un nom en clair, compréhensible pour tout un chacun. Il peut désormais être différent du nom « interne ». Ce qui allège les restrictions concernant les caractères autorisés.

description (recommandé)

Une courte description du thème. Elle apparaît dans la page de sélection de thèmes, dans Administrer » Construction du site » Themes.

screenshot

La clé screenshot (facultative) indique à Drupal où trouver la miniature du thème, cette miniature utilisée dans la page de sélection du thème (Administrer » Construction du site » Thèmes).

Si la clé est omise, Drupal utilise le fichier « screenshot.png » du dossier du thème.

N'utilisez cette clé que si votre miniature n'est pas nommée « screenshot.png », ou si vous l'avez placée dans un dossier externe à votre dossier du thème (par exemple : screenshot = images/screenshot.png)

version (déconseillé)

La chaîne version sera automatiquement ajoutée par Drupal.org quand une release est créée et un tarball empaqueté. Vous pouvez donc omettre cette valeur pour les thèmes mis à disposition de la communauté.

Mais si votre thème n'est pas hébergé par Drupal.org, vous pouvez donner n'importe quelle valeur à cette clé, du moment qu'elle vous semble parlante.

core (obligatoire)

A partir de la version 6,x, tous les fichiers .info des modules et des thèmes doivent mentionner avec quelle version majeure de Drupal ils sont compatibles. La valeur indiquée est comparée avec la constante DRUPAL_CORE_COMPATIBILITY. Si elles ne correspondent pas, le thème sera désactivé.

Le script d'empaquetage renseigne automatiquement cette valeur basée sur le paramètre de compatibilté du core Drupal. Ainsi, les personnes qui téléchargent des thèmes depuis drupal.org obtiendront toujours la bonne version.

Cependant, pour les sites qui déploient Drupal directement à partir du CVS, il est utile d'indiquer cette modification dans le fichier .info de votre thème. C'est également une bonne chose de signaler aux utilisateurs de chaque thème quelle version du core de HEAD (http://drupal.org/handbook/cvs/introduction#HEAD) du CVS est compatible.

The drupal.org packaging script automatically sets this value based on the Drupal core compatibility setting on each release node. So people downloading packaged themes from drupal.org will always get the right thing. However, for sites that deploy Drupal directly from CVS, it helps if you commit this change to the .info file for your theme. This is also a good way to indicate to users of each theme what version of core the HEAD of CVS is compatible with at any given time.

engine (souvent obligatoire)

Le moteur de template utilisé par le thème. Si rien n'est précisé, le thème est censé être autonome, c'est à dire mis en œuvre avec un fichier .theme. De nombreux thèmes utilisent  PHPtemplate comme moteur par défaut.

Le travail de PHPTemplate consiste à déterminer les fonctions du thème, ses gabarits, pour son comportement. Omettez cette entrée si vous savez ce que vous faites.

base theme

Les sous-thèmes peuvent déclarer leur thème parent. Cette déclaration permet l'héritage des ressources du thème parent et leur réutilisation dans le sous-thème. Les sous-thèmes peuvent déclarer d'autres sous-thèmes comme thème parent, permettant ainsi plusieurs niveaux d'héritage. Utilisez le nom « machine » interne du thème de base.

L'exemple qui suit est utilisé pour Minnelli, un sous-thème de Garland :

D'autres détails sont disponibles dans les pages Sous-thèmes, leur structure et l'héritage.

regions

Les blocs regions disponibles pour un thème sont définis en spécifiant la clé regions suivie du nom « machine » interne entouré de crochets, et en spécifiant le nom convivial comme valeur.

Par exemple : regions[theRegion] = The region name

Régions par défaut pour Drupal 6 :

Régions par défaut pour Drupal 7 :

Vous pouvez surcharger ces valeurs pour vos propres besoins.

Plus de détails sont disponibles sur la page Attribution de contenu aux régions.

features

Sur la page de configuration du thème, l'affichage des différents éléments gérés peut être activé ou désactivé. La clé features indique les cases à cocher qui seront utilisées à cette fin dans la page de configuration. C'est utile pour supprimer les cases à cocher des éléments non définis ou inutilisés par le thème .

Pour supprimer une case à cocher, omettez sa valeur. Mais, si aucune valeur n'est spécifiée, toutes les cases à cocher seront affichées, puisque c'est le comportement du paramétrage par défaut.

L'exemple qui suit énumère tous les éléments disponibles contrôlés par la clé features.

Features Drupal 6

Features Drupal 7

Plus de détails sont disponibles sur la page Custom theme settings .

stylesheets

Traditionnellement, les thèmes utilisent par défaut une feuille de style nommée style.css. Des feuilles de style supplémentaires peuvent être ajoutées en appelant la fonction drupal_add_css() dans le fichier template.php. Depuis la version 6, on peut aussi ajouter des feuilles de styles via le fichier .info.

A partir de Drupal 7, les thèmes n'utilisent plus par défaut le fichier style.css s'il n'est pas déclaré dans le fichier .info.

Plus de détails sont disponibles dans la section style sheets (http://www.kolossaldrupal.org/docs/ajouter-feuilles-de-style).

scripts

Traditionnellement, les thèmes utilisant du code JavaScript ajoutait ce code en appelant la fonction drupal.add_js() dans le fichier template.php.

Depuis la version 6, s'il existe un fichier nommé script.js dans le dossier du thème il est automatiquement inclus.

Cependant, dans Drupal 7, ce comportement a été modifié et script.js n'est inclus que s'il a été déclaré dans le fichier .info.

Les thèmes peuvent également ajouter du code JavaScript spécifique en ajoutant ces lignes dans le fichier .info :

Plus de détails sont disponibles dans la section JavaScript & jQuery (http://drupal.org/node/171213).

php

Cette clé définit la version minimale de PHP supportée par le thème. La valeur par défaut dépend de la constante DRUPAL_MINIMUM_PHP, qui est la version minimum requise pour le reste du core. Elle peut être redéfinie si une nouvelle version est nécessaire. Pour beaucoup de thèmes cette clé ne devrait pas être ajoutée.

Exemples de fichiers .info pour les thèmes du core.

Garland :

Minnelli, sous-thème de Garland :

Notez que chaque élément des lignes « ; Information added by drupal.org packaging script on 2008-02-13 » et suivantes est ajouté par le script d'empaquetage de Drupal.org. Vous ne devez pas ajouter manuellement les clés project et datestamp. La clé version ajoutée manuellement (dans la première section) autorise les sites à utiliser votre thème lorsqu'il est pris directement depuis le CVS.

Valeurs .info par défaut

Traduction de la page http://drupal.org/node/171206
publiée / actualisée le 11 Mars 2011 sur Drupal.org

Les valeurs qui suivent sont des valeurs implicites, utilisées par défaut. Si elles ne sont pas déclarées, le thème les utilisera automatiquement.

Remarque : ces valeurs par défaut s'appliquent par groupes. C'est à dire que, si vous surchargez regions[sub_header] = Sub-header cela désactivera les autres valeurs par défaut du groupe régions. Pour les récupérer, vous devrez les redéclarer.

Cela concerne également les feuilles de style. Bien qu'une feuille de style ne soit pas, techniquement parlant, dans un groupe, si vous déclarez une feuille de style, la feuille de style par défaut (« style.css ») ne sera pas utilisée, à moins que vous ne la spécifiez explicitement.

regions

Drupal 6

Drupal 7

features

Drupal 6

Drupal 7

screenshot

Stylesheets et JavaScript

Les fichiers style.css et script.js sont déclarés par défaut dans Drupal 6. Dans Drupal 7, vous devez déclarer tous les fichiers CSS et JavaScript que le thème utilisera.

scripts

php (minimum support)
DRUPAL_MINIMUM_PHP est une constante. Elle indique la version minimum de PHP requise pour le fonctionnement du core de Drupal.

Attribution de contenu aux régions

Traduction de la page http://drupal.org/node/171224
publiée/actualisée le 25 Mars 2011 sur Drupal.org.

Les regions sont des zones de votre thème qui recoivent des blocs et du contenu.

Les regions disponibles pour un thème sont indiquées dans le fichier .info. Elles doivent être spécifiées avec la clé regions suivie du nom machine de la région entre crochets et du nom compréhensible comme valeur. Par exemple : regions[theRegion] = Le nom de ma région .

Si aucune region n'est déclarée, ce sont les valeurs par défaut qui sont utilisées.

regions[left] = Left sidebar
regions[right] = Right sidebar
regions[content] = Content
regions[header] = Header
regions[footer] = Footer

Drupal 7 amène avec lui deux régions par défaut : Highlighted et Help. Par défaut, le contenu texte de cette région est le même que celui de la variable $help dans page.tpl.php de Drupal 6.

Le thème Drupal 7 Bartik dispose des régions par défaut suivantes :

Ayez à l'esprit que le nom interne est automatiquement converti en variable region dans le fichier gabarit page.tpl.php. Dans l'exemple précédent, la region [left] affichera tous les blocs qui lui sont affectés par le biais de la variable $left. Il y a quelques contraintes pour le nommage des variables PHP, assurez-vous que les noms internes les respectent. Ils doivent seulement contenir des caractères alphanumériques ou le signe souligné et doivent débuter par une lettre.

Le nom compréhensible mentionné comme valeur, à l'extérieur des crochets, est utilisé pour l'intitulé de la région dans la page d'administration des blocs située dans Administrer » Construction du site »Blocs. Dans Drupal 7, la paghe d'administration des blocs est située dans Administer > Structure > Blocks.

Voici la page d'administration des blocs pour Garland :

Drupal 7 - Tableau d'administration de blocs pour Bartik :

Quelques remarques :

• Des fichiers template (.tpl.php) sont disponibles pour la mise en page individuelle de blocs.
• Ajouter une région personnalisée désactive les régions par défaut. Si vous voulez conserver les régions par défaut en plus des régions personnalisées, ajoutez-les manuellement.
• L'ordre dans lequel les régions sont ajoutées est pris en compte dans la page d'administration des blocs. Garland utilise les régions par défaut. Remarquez l'ordre d'affichage des régions dans la page d'administration.
• Le contenu du fichier .info est mis en cache dans la base de données, sa modification ne sera donc pas remarquée par Drupal (ne pas confondre le cache avec le registre des thèmes http://www.kolossaldrupal.org/docs/la-surcharge-themes#theme-registry).

Pour vider le cache, faites l'une des opérations suivantes :

• Clic sur le bouton Supprimer les données du cache dans la page Administrer » Configuration du site » Performance
• Si le bloc Devel est actif (livré avec le module Devel), cliquez sur le lien Vider le cache.
• Ou affichez simplement la page de sélection de thèmes dans Administrer » Construction du site » Thèmes.

Informations de mises à jour :

• Dans Drupal 7, ces variables sont nommées $sidebar_first et $sidebar_second.
• La variable région $footer_message a été supprimée dans Drupal 7

La région $content

Dans Drupal 6 et avant, la variable $content de page.tpl.php contenait le contenu principal de la page avec les blocs positionnés dans la region contenu (si cette region était déclarée).

Dans Drupal 7, $content est devenu une région à part entière et est désormais obligatoire dans tous les thèmes. Cette nouvelle exigence a été mise en place pour que lorsqu'on active des nouveaux thèmes, Drupal sache où mettre le contenu principal de la page.

Dans Drupal 6, il n'était possible que de mettre les blocs après le contenu principal de la page dans cette région. La seule façon de mettre les blocs avant le contenu principal de la page était de déclarer une région spécifique à cette fin. Drupal 7 crée maintenant son propre bloc pour le contenu principal de la page. Il est ainsi possible de mettre des blocs avant ou après le contenu principal de la page dans la region sans avoir à hacker une nouvelle région.

Attribuer manuellement un contenu aux régions

Un contenu peut être manuellement placé dans une région avec drupal_set_content (http://api.drupal.org/api/function/drupal_set_content). Par exemple : drupal_set_content('header', 'Bienvenue !') affectera le texte « Bienvenue ! » à la région Header.

Voici un exemple plus utile pour la construction d'un résumé de tous les commentaires dans la région Right. Renommez le préfixe « drop » avec le nom de votre thème. Plus d'informations disponibles sur la page consacrée aux pré-traitements (http://www.kolossaldrupal.org/docs/initialisation-variables-pour-leur-utilisation-dans-gabarit-fonctions-de-pre-traitement)

Notez que la création de contenu par le biais de cette fonction doit se faire avant que les blocs des regions ne soient récupérés, et cela se fait par un appel à template_preprocess_page > theme_blocks > drupal_get_content.

Rendre les paramétrages disponibles dans la page d'administration

Traduction de la page http://drupal.org/node/221905
publiée / actualisée le 17 Mars 2011 sur drupal.org

Un certain nombre d'éléments affichés par le thème peuvent être activés ou désactivés dans la page de configuration de thème.

Drupal 7

Vous trouverez ces paramètres dans Administer > Appearance > Settings > themeName. Par exemple, le slogan du site peut être supprimé en décochant la case Site slogan de cette page.

L'affichage de ces cases à cocher dépend des paramètres du fichier .info. Ils sont déclarés avec la clé features suivie de double crochets vides et du paramètre proprement dit, par exemple, features[] = le paramètre. Si aucun paramètre n'est déclaré, les valeurs suivantes sont utilisées par défaut :

Drupal 7 enlève mission et recherche comme paramètres de thèmes (ils peuvent désormais être créés et contrôlés en tant que blocs) et ajoute un bouton radio pour User verification status in comments.

Pour ne désactiver que quelques paramètres, il suffit d'ajouter ceux que vous souhaitez dans le fichier .info. Ne déclarer que les paramètres nécessaires pour votre thème désactivera les autres. Certains paramètres activeront également des champs de formulaires associés. Par exemple, logo activera un champ d'upload pour l'image.

Quelques remarques :

• Le contenu du fichier .info est mis en cache dans la base de données, sa modification ne sera pas remarquée par Drupal (ne pas confondre le cache avec le registre des thèmes http://www.kolossaldrupal.org/docs/la-surcharge-themes#theme-registry).

Pour vider le cache, faites l'une des opérations suivantes :

• Clic sur le bouton Supprimer les données du cache dans la page Administrer » Configuration du site » Performance

• Ou affichez simplement la page de sélection de thèmes dans Administrer » Construction du site » Thèmes.

• hook_features() n'est plus pris en charge.

Drupal 6

Dans Drupal 6, les paramètres sont situés dans Administrer » Construction du site » Thèmes » Nom du thème

Voici les valeurs par défaut dans Drupal 6 :

Vider le cache du thème

Traduction de la page http://drupal.org/node/337176
publiée / actualisée le 11 Mars 2011 sur drupal.org

Le contenu du fichier .info étant mis en cache dans la base de données, sa modification ne sera pas détectée par Drupal. Ne confondez pas ce cache avec le theme registry). Pour vider le cache, faites l'une des opérations suivantes :

• cliquez sur le bouton « Supprimer les données du cache » située dans admin/config/development/performance. (Dans Drupal 6, le bouton est situé en bas de la page dans Administrer » Configuration du site » Performance)
• Modules tiers :
• Admin menu dispose de liens pour vider le cache sous son premier icône.
• Le module Devel Block du projet Devel fournit un lien "Vider le cache".
• La fonction drupal_theme_rebuild de l'API.
• Certains thèmes (Zen, Fusion,...) fournissent une case à cocher pour régénérer le le cache du thème pour chaque page, avec un message d'avertissement pour que vous n'oubliiez pas de le désactiver.
• Drush a une commande en ligne de commande : drush cache-clear theme ou un raccourci drush cc all pour vider tout le cache.

Créer un thème Drupal avec des CSS, et rien d'autre

Traduction de la page http://drupal.org/node/394612
publiée / actualisée le 11 Mars 2011 sur drupal.org

Dans Drupal 6 et Drupal 7, plusieurs améliorations du core facilitent la tâche des concepteurs de thème qui travaillent en CSS et ne touchent pas au code PHP.

Le thème Stark a été créé pour aider les concepteurs à connaître le code xhtml généré par Drupal, il fait partie du core de Drupal 7. Les concepteurs de thèmes peuvent maintenant réaliser de superbes thèmes uniquement avec des CSS.

Ce tutoriel vous montrera comment créer, en quelques étapes simples, votre propre thème Drupal 6 ou 7 à base de CSS.

Etape n° 1 : créer le dossier du thème et le fichier .info

La première étape dans la réalisation d'un thème est de créer le dossier où il sera enregistré, et créer le fichier .info pour informer Drupal de son existence.

Pour créer le dossier :

1. Créez ce dossier dans le dossier /sites/all/themes
2. Nommez-le votretheme, tout en minuscules

Pour créer le fichier .info

1. Creéz un document dans un éditeur de texte et collez-y les lignes suivantes (en les modifiant là où ce sera nécessaire*) :
name = votretheme
description = Description de votre thème
core = 6.x
engine = phptemplate
stylesheets[all][] = style.css
stylesheets[all][] = layout.css
regions[left] = Left sidebar
regions[right] = Right sidebar
regions[content] = Content
regions[header] = Header
regions[footer] = Footer


2. Sauvegardez ce fichier dans le dossier créé précédemment et nommez-le votretheme.info.

* Notes :

• vous pouvez ajouter plusieurs feuilles de styles CSS à votre thème facilement,
• vous pouvez également ajouter des régions à votre thème facilement,
• modifiez la ligne core = 6.x en core = 7.x si vous créez un thème pour Drupal 7.

Etape 2 : création des feuilles de style

Si vous regardez la feuille de style du thème Stark, layout.css, vous remarquerez qu'elle ne comporte que très peu de règles :

Ce code ne fait que mettre en forme le contenu d'une installation Drupal standard. Cela montre à quel point une thème peut être simple. A partir de là, vous pouvez construire votre propre thème de différentes façons. 

La première étape consistera à mettre en place les régions et le graphisme de votre page. Vous le ferez dans votre propre fichier layout.css.

Ensuite, vous pouvez créer un fichier style.css pour les autres styles.

Une pratique habituelle, qui facilite la maintenance du code, est de créer également d'autres fichiers CSS qui porteront notamment sur les éléments HTML, print.css et ie.css. 

Pour chaque fichier CSS supplémentaire que vous créerez, vous devrez ajouter une ligne dans le fichier votretheme.info, au format suivant, après les autres déclarations de styles CSS :

Etape 3 : prenez votre pied en di-zaïe-nant !

Si vous créez votre thème avec des CSS... il n'y a plus grand chose d'autre à faire...

Si vous le souhaitez, vous pouvez jeter un œil aux fichiers gabarits du core utilisés dans votre thème. Les principaux fichiers à examiner sont :

• page.tpl.php (pour la mise en page globale de la page)
• node.tpl.php (pour tous les nodes ou les principales sections de contenu d'une page)
• block.tpl.php (pour les blocs, qui sont placés dans des régions)
• comment.tpl.php (pour tous les commentaires de votre site).

Vous pouvez copier ces gabarits PHP dans le dossier de votre thème, puis vous les modifierez à votre convenance, si vous souhaitez modifier l'organisation du code HTML.

Paramètres globaux

Traduction de la page http://drupal.org/getting-started/6/admin/site-building/themes/settings
publiée / actualisée le 15 Février 2011 sur drupal.org

Dans la page des thèmes (admin/build/themes), à côté de l'onglet Liste, vous avez un onglet Configurer. Cliquez dessus. Drupal affichera alors les paramètres globaux des thèmes où vous pourrez sélectionner/désélectionner l'affichage des caractéristiques supportées par les thèmes. Notez que ce sont des paramètres globaux et qu'ils peuvent être surchargés dans un thème donné, en paramétrant ces thèmes individuellement.

Voici la liste des caractéristiques par défaut, avec une brève description et quelques astuces pour la mise en œuvre.

Notez que tous les thèmes ne supportent pas toutes les caractéristiques, et certaines ne seront jamais affichées (les thèmes peuvent masquer l'affichage des caractéristiques qu'ils ne prennent pas en charge).

Logo

De nombreux thèmes ont un logo cliquable, ce paramètre active ou désactive leur affichage. Vous pouvez uploader votre propre logo en utilisant le champ Envoyer le logo, plus bas dans la page des paramètres globaux, ou remplacer le fichier logo.png situé dans le dossier du thème (beaucoup de thèmes utilisent la convention logo.png) .

Nom du site, slogan du site

Activez ou désactiver l'affichage du nom du site ou de son slogan. Ces deux paramètres sont renseignés dans la page d'administration Informations (D6 : menu Administrer >> Configuration du site >> Informations ou admin/settings/site-information). De nombreux thèmes affichent le nom du site et le slogan dans l'entête.

Objectif du site

De nombreux thèmes acceptent un Objectif du site, renseigné dans la même page que le nom du site et le slogan. Cet objectif du site n'est affiché que sur la page d'accueil.

Portrait des utilisateurs dans les contributions, Portrait des utilisateurs dans les commentaires

Si un utilisateur a uploadé un portrait, ou si vous avez défini un portrait par défaut pour les utilisateurs, vous pouvez en paramétrer l'affichage tant sur les nodes que sur les commentaires. Si ces paramètres sont grisés, vous devez d'abord visiter la page d'administration des utilisateurs (D6 : menu Administrer >> Gestion des utilisateurs >> Paramètres des utilisateurs ou admin/user/settings) pour activer cette fonction.

Champ de recherche

Beaucoup de thèmes ont une boite de recherche, le plus souvent dans l'en-tête ou dans un colonne latérale. Si ce paramètre est grisé, vous devez d'abord activer le module Search (D6 : menu Administrer >> Construction du site >> Modules puis groupe Core - facultatif

Liens primaires, Liens secondaires

Ce sont des menus, auxquels vous pouvez ajouter des éléments lors de la création de contenus ou dans la section Menu du menu d'administration (menu Administrer >> Construction du site >> Menus ou admin/build/menu). De nombreux thèmes affichent les Liens primaires et les Liens secondaires comme des menus horizontaux dans l'en-tête. Tous les thèmes ne supportent pas les Liens secondaires, mais la plupart supportent les Liens primaires.

[inline:07-themes_global_sm.jpg]

Thèmes - Garland

Pour débuter, Garland vous permet de choisir plusieurs zones de sa palette de couleurs. Drupal 6 est livrée avec une quinzaine de palettes de couleurs prédéfinies et votre propre palette personnalisée. N'hésitez pas à faire des essais. Cela nécessite la présence du module Colors, qui est présent par défaut.

[inline:07-themes_global_sm.jpg]

Surcharger les feuilles de style des modules et des thèmes parents

Traduction de la page http://drupal.org/node/263967
publiée / actualisée le 11 Mars 2011 sur drupal.org;

Vous pouvez surcharger la feuille de style fournie par le noyau Drupal ou par des modules tiers.

La plupart des modules disposent d'une présentation par défaut pour l'affichage de leurs données. Cela comprend les balises HTML et la feuille de style associée (reportez-vous aux explications de overriding behavior pour le balisage). Ces styles par défaut peuvent être surchargés en réalisant des modifications dans votre thème.

Surcharger les feuilles de style du core et des modules additionnels

Pour surcharger ces feuilles de styles, vous devez les redéfinir dans le fichier .info du thème.

Prenons system-menus.css comme exemple. Il est situé dans modules/system/system-menus.css. Avec l'entrée suivante dans le fichier .info, la feuille de style originale sera ignorée et la vôtre sera chargée :

Surcharger avec une feuille de style absente de votre thème fera que celle du core ou du module additionnel sera ignorée. Ce comportement, délibéré, a été corrigé au passage de la version 6.0 à 6.3.

Quelques remarques :

• Surcharger les feuilles de style du core empêche le chargement de la feuille de style par défaut style.css. Rappelez-vous que vous devez explicitement déclarer les valeurs par défaut lorsque vous en avez besoin. Dans Drupal 7, style.css n'est pas chargée, sauf si elle est spécifiée dans le fichier .info
• Les thèmes surchargés doivent avoir les mêmes types de media que ceux du style original.
• Les URL mentionnées dans la feuille de style devront peut-être être corrigées. Vérifiez toutes les propriétés url() ou les règles @import dans la feuille de style, pour vous assurer qu'elles pointent réellement vers la bonne ressource. L'ordre des feuilles de style énumérées dans le header de la page sera modifié. Cela peut modifier l'héritage de certaines règles. The order the style sheets listed in the head of the page will change. In effect, this may cause some cascading rules to change with it.
• Certaines feuilles de style du core ou des modules ne sont chargées que dans certaines conditions. Les surcharger dans le fichier .info fera qu'elles seront toujours utilisées (et non plus chargées sous condition).
• Si les modifications du thème sont minimes, il vaut mieux utiliser les sélecteurs pour surcharger les styles plutôt que de remplacer toute la feuille de style.
• Dans Drupal 7, si vous voulez surcharger quelques fichiers css, utilisez hook_css_alter dans le fichier template.php (regardez l'exemple du thème Seven)

Rappelez-vous que vous devez vider le cache après les modifications. Allez pour cela dans Administrer » Configuration du site » Performance, déroulez jusqu'en bas de la page et cliquez sur« Supprimer les données du cache ».

Surcharger la feuille de style d'un thème parent

Ce qui suit s'applique aux sous-thèmes (sub-themes).

Pour éviter qu'une feuille de style d'un thème parent ne soit reprise dans un sous-thème, vous pouvez la redéfinir dans le fichier .info. Cela se fait de la même façon que pour la surcharge d'une feuille de style d'un module ou du core.

Le thème parent et le sous-thème doivent avoir la même entrée :

Si le fichier existe dans le sous-thème, il sera utilisé, alors qu'omettre le fichier empêchera son chargement. If the file exists inside the sub-theme, then it will be used while omitting the file will prevent it from loading.

Ajouter des feuilles de style

Traduction de la page http://drupal.org/node/171209
publiée / actualisée le 2 Mars 2011 sur drupal.org

Cette page explique comment ajouter une feuille de style via le fichier .info du thème. Pour ajouter une feuille de style par programmation, reportez-vous à la page sur les fonctions API (API functions). Personnaliser un thème via des CSS uniquement est faisable avec les informations fournies ici.

Remarques :

• Quand vous travaillez avec des feuilles de style, assurez-vous d'avoir désactivé l'optimisation CSS (menu Administrer > Configuration du site > Performance > Optimise les fichiers CSS). Si elle est activée, aucune modification ne sera répercutée sur votre site à moins que les styles ajoutés ne soient purgés.

  Vous pouvez réactiver l'optimisation à la fin de votre travail.

• Le fichier .info est mis en cache. L'ajout ou la suppression de styles ne sera pas détectée tant que le cache n'aura pas été vidé.(ne confondez pas ce cache avec le theme registry). Pour vider le cache, faites l'une des opérations suivantes :
1. cliquez sur le bouton « Supprimer les données du cache > située dans Administrer > Configuration du site > Performance
2. Si le bloc Devel est actif (livré avec le module Devel), cliquez sur le lien « Vider le cache > (« Empty cache >)
3. Ou affichez simplement la page de sélection des thèmes dans Administrer > Construction du site > Thèmes.

Ajouter des feuilles de style

Par défaut dans Drupal 6, si aucune autre feuille de style n'a été définie dans le fichier .info, c'est un fichier nommé style.css qui sera utilisé par votre thème. Dans Drupal 7, le fichier style.css ne sera pas utilisé à moins qu'il ne soit mentionné dans le fichier .info.

Ajouter d'autres feuilles de style est aussi simple que définir une clé stylesheets avec sa media property comme indice entre crochets, et le nom de la feuille de style comme valeur.

N'oubliez pas que la déclaration de styles personnalisés empêchera l'utilisation du fichier style.css. Si votre thème utilise cette feuille de style-là, vous devrez la déclarer explicitement.

Quelques remarques :

• Notez la paire de crochets vides entre [media] et = stylename.css.
• Les styles apparaissent dans le header de la page dans le même ordre que leur déclaration dans le fichier .info.
• Les feuilles de style peuvent être placées dans des sous-dossiers, par exemple stylesheets[all][] = stylesheets/styleName.css. C'est drôlement pratique d'un point de vue organisation, non ?
• Il est cependant conseillé de garder les sous-doissiers sur un seul niveau, par exemple, stylesheets[all][] = css/foo/styleName.css peut causer des problèmes avec certains gabarits de mise en page. Il vut mieux utiliser stylesheets[all][] = css/styleName.css ou stylesheets[all][] = foo/styleName.css.

.clear-block et .clearfix

Traduction de la page http://drupal.org/node/778998
publiée / actualisée le 22 Avril 2010 sur drupal.org

La classe clear-block de Drupal 6 est un drupalisme pour une fonctionnalité plus connue sous le nom de clearfix par la Communauté CSS. En outre, utiliser le terme block prêtait à confusion car il ne s'aggissait pas là du système de blocs de Drupal. Dans Drupal 7, la classe clear-block a été renommée en clearfix.

6.x

7.x

Ajouter des feuilles de style, ciblées par navigateur

Traduction de la page http://drupal.org/node/1030462
publiée le 15 février 2011 sur Drupal.org

Vous pouvez utiliser des feuilles de styles ciblées par navigateur.

Drupal 6

Un exemple d'ajout de feuille de style pour Internet Explorer 6 dans un thème pour Drupal 6 (cet exemple est issu du thème Garland, livré avec l'installation du noyau Drupal) :

page.tpl.php :

template.php :

Drupal 7

Avec Drupal 7, vous pouvez préciser une clé "navigateur" lorsque vous appelez la fonction drupal_add_css() :

template.php :

Reportez-vous à la doc de l'API pour drupal_pre_render_conditional_comments() pour connaître les détails des clés IE et !IE.

Il est conseillé de toujours utiliser drupal_add_css() pour ajouter des feuilles de style à un thème, ainsi Drupal connaîtra exactement le nombre de feuilles de style ajoutées. Cette donnée peut servir pour s'adapter à la limite d'Internet Explorer qui ne charge que les 31 premières balises LINK/STYLE.

Ajouter des feuilles de style via l'API

Traduction de la page http://drupal.org/node/225868
publiée / actualisée le 29 Janvier 2011 sur drupal.org

Pour la plupart des thèmes, ajouter des feuilles de style via le fichier .info sera suffisant. Mais comme ce fichier .info est statique, les feuilles de style ne peuvent pas être ajoutées dynamiquement. Selon la façon dont les thèmes gèrent les feuilles de style, cela peut n'avoir aucune incidence. En cas de doute, utilisez le fichier .info.

L'API comporte deux fonctions pour travailler avec les feuilles de style : drupal_add_css et  drupal_get_css.  Voici une exemple d'ajout dynamique de feuilles de style avec ces fonctions.

Remplacez le préfixe « drop » de la fonction par le nom de votre thème.

Dans cet exemple, la feuille de style front-page.css sera utilisée pour la page d'accueil, et d'autres basées sur le chemin interne. Par exemple : http://example.com/admin utilisera une feuille de style nommée path-admin.css.

Quelques remarques :

• En fonction des endroits et des moments au cours desquels ont lieu l'ajout des feuilles de style, des appels à drupal_get_css devront être faits pour les inclure. Les feuilles de style sont d'abord récupérées dans template_preprocess_page. Reportez-vous à Preprocessors and variables pour les détails sur l'ordre des pré-traitements.
• drupal_add_css comporte un paramètre pour regrouper les feuilles de style ajoutées. Pensez à le désactiver, comme ci-dessus, lors de l'ajout dynamique des feuilles de style car les fichiers ajoutés forcent la régénération d'une grande feuille de style, ce qui peut ralentir la transmission de la page et consommer de la bande passante.

Où ajouter le code ?

Ce codee peut être ajouté dans le fichier template.php du dossier de votre thème. Il peut déjà y avoir une fonction nommée phptemplate_preprocess_page. Incorporez-là simplement dans le corps de votre fonction XXX__preprocess_page.

Vous devrez peut-être également modifier variables en vars pour que cela fonctionne.

Ajouter une feuille de style pour un navigateur donné

Référence en anglais sur drupal.org : http://drupal.org/node/744328
16 Mars 2010 - 21h25

Vous pouvez ajouter une feuille de style pour un navigateur donné.

Drupal 6

Dans le fichier page.tpl.php de Garland :

Dans le fichier template.php de Garland :

Drupal 7

Drupal 7 apporte la possibilité de spécifier une clé « navigateur » quand vous appelez drupal_add_css() :

Dans le fichier template.php de Garland :

Consultez la documentation de l'API pour drupal_pre_render_conditional_comments() au sujet des détails des clés IE et !IE.

Il est conseillé que le thèmes utilisent toujours drupal_add_css() pour ajouter des feuilles de style CSS, le code Drupal connaît ainsi le nombre exact de feuilles de style ajoutées. Une donnée qui peut être nécessaire lorsqu'on approche des limites d'Internet Explorer qui ne peut charger que les 31 premières balises LINK/STYLE.

Créer et interpréter des gabarits CSS (style.css.php)

Traduction de la page http://drupal.org/node/568180
publiée / actualisée le 29 Janvier 2011 sur drupal.org

N'avez-vous jamais eu envie de créer des CSS dynamiquement ? Voici un exemple de comment interpréter un gabarit CSS qui sera renseigné avec des variables. Pour cet exemple, nous voulons générer des CSS pour modifier la taille de la police d'un titre de page.

1. Créez votre template CSS (style.css.php):

   @CHARSET "UTF-8";
   #content h1.title{ font-size: <?php print $font_size; ?>px;}

2. Écrivez le code pour interpréter le gabarit et obtenir la chaîne résultante:

   <?php
$variables = array(
  'font_size' => 20,
);

extract($variables, EXTR_SKIP);
ob_start();
include('style.css.php');
$css = ob_get_contents();
ob_end_clean();

// la variable CSS résultante peut être utilisée pour ajouter ou afficher le style de différentes façons :
print '<style type="text/css">'.$css.'</style>';
?>

Généreusement emprunté à phptemplate.

Styles standards du core Drupal

Traduction de la page http://drupal.org/node/388372
publiée / actualisée le 29 Janvier 2011 sur drupal.org   incomplet

Pour les éléments standards d'une page, le core de Drupal utilise une approche modulaire des classes CSS . Un certain nombre de classes sont utilisées dans un site Drupal. La liste qui suit se veut un rappel sur ces classes, ce qu'elles font et où on les trouve.

Vous trouverez une liste complète des classes de Drupal 6 dans le starter kit ZEN, elle devrait être fusionnée à cette page.

Notez que les thèmes que vous installez sur votre site peuvent modifier ces classes ou en ajouter d'autres.

Éléments de page

.menu

Tous les menus sont de cette classe, comme le menu de navigation

.block

Tous les blocs. Reportez-vous à http://drupal.org/node/104319 pour d'autres infos sur la stylisation des blocs.

.links

Liste de liens, y compris les liens primaires et secondaires dans le head de la page, et aussi les liens de nodes et de la taxonomie (voir ci-dessous)

Éléments de Nodes

.node

un <div> qui encadre tout node, y compris son titre.

.node-title

Le titre du node.

.content

Le corps du node. Cela comprend aussi les ajouts faits par d'autres modules, tels que les fichiers uploadés ou les champs CCK.

.links

S'applique à n'importe que <UL> qui est une liste de liens, y compris les liens primaires et secondaires dans le head de la page, et aussi les liens de nodes et de la taxonomie (voir ci-dessous). Les liens vers les nodes ont la classe .links dans le DIV qui les contiennent.

.terms

Les termes de la Taxonomy, qui sont également balisés avec .links et .inline.

.inline

Une classe-système pour styliser les items UL sur une ligne horizontale.

.feed-icon

L'icône RSS, habituellement situé en pied d'une page de contenu.

Prise en charge des langues « droite vers gauche » (RTL)

Traduction de la page http://drupal.org/node/222782
publiée / actualisée le 29 Janvier 2011 sur drupal.org

Pour prendre en charge les langues qui se lisent de droite à gauche vous devez surcharger les styles latéraux et nommer la nouvelle feuille de style d'après la feuille de style originale. L'inclusion de la feuille de style « RTLisée » se fera automatiquement et dépendra de la langue paramétrée pour le site.

Un exemple sera plus parlant : la feuille de style par défaut du thème Garland est style.css. Elle dispose également d'une feuille de style style-rtl.css pour les langues s'écrivant de droite à gauche, comme l'arabe ou l'hébreu. L'inclusion de ces deux styles commence par la feuille de style principale puis par la feuille de style RTL. Cela permet l'application des règles des deux fichiers « en cascade » sans que vous ayez à vous soucier des sélecteurs spécifiques utilisés dans le style de RTL.

Il existe une norme de codage pour l'organisation des règles. Les règles impliquées dans la position latérale ou les dimensions doivent être commentées avec /* LTR * /, ce qui indique qu'elles sont spécifiques à une mise en page de gauche à droite. Cela concerne les éléments flottants (float), les marges (margins), les rembourrages/épaulettes (padding), etc.

Le texte inline sera automatiquement placé, pour autant que le sens de l'écriture du document soit indiqué dans le gabarit page.tpl.php du thème.

Exemple de style de base :

Style RTL correspondant :

Cet ajout de /* LTR * / en commentaires dans la feuille de style principale vous permet de repérer plus facilement les les endroits du fichier RTL où sont les modification doivent être faites.

Remarque :

Si votre thème surcharge le style d'un module (overrides a module style, traduction française ici), le style RTL associé sera omis à moins que vous n'en ayez créé un dans votre thème.

Fichiers gabarits du noyau (core templates)

Traduction de la page http://drupal.org/node/190815
publiée / actualisée le 17 Mars 2011 sur drupal.org

Gabarits de mise en page par défaut:

Le noyau Drupal 7 fournit des gabarits de mise en page par défaut (fichiers .tpl.php). La documentation sur les variables et l'usage de ces gabarits se trouve à l'intérieur même des fichiers gabarits. Il existe un ensemble de variables par défaut default set of variables disponibles pour tous les gabarits.

Pour surcharger ces mises en page, il vous suffit de les copier dans votre dossier de thème et vider le registre de thèmes (traduction en français sur kolossaldrupal : http://www.kolossaldrupal.org/docs/la-surcharge-themes).

Pour surcharger ces gabarits de façon plus ciblée, consultez la section Template Suggestions (traductions à venir. NdK)

(les liens qui suivent renvoient vers des pages techniques du site api.drupal.org. Je ne les ai pas traduites)

Aggregator 

"modules/aggregator/..."

• aggregator-feed-source.tpl.php
• aggregator-item.tpl.php
• aggregator-summary-item.tpl.php
• aggregator-summary-items.tpl.php
• aggregator-wrapper.tpl.php

Block

"modules/block/..."

• block-admin-display-form.tpl.php
• block.tpl.php

Remarque : la version Drupal 6 de block.tpl.php fait partie de modules/system/...

Book

"modules/book/..."

• book-all-books-block.tpl.php
• book-export-html.tpl.php
• book-navigation.tpl.php
• book-node-export-html.tpl.php

Comment

"modules/comment/..."

• comment-wrapper.tpl.php
• comment.tpl.php

Remarque : comment-folded.tpl.php est obsolète dans Drupal 7.

Field

"modules/field/theme/..."

• field.tpl.php

Remarque : field.tpl.php est un nouveau fichier gabarit de Drupal 7.

Forum

"modules/forum/..."

• forum-icon.tpl.php
• forum-list.tpl.php
• forum-submitted.tpl.php
• forum-topic-list.tpl.php
• forums.tpl.php

Remarque : forum-topic-navigation.tpl.php est obsolète dans Drupal 7.

Node

"modules/node/..."

node.tpl.php

Overlay

"modules/overlay/..."

• overlay.tpl.php

Remarque : overlay.tpl.php est un nouveau fichier gabarit de Drupal 7.

Poll

"modules/poll/..."

• poll-bar--block.tpl.php
• poll-bar.tpl.php
• poll-results--block.tpl.php
• poll-results.tpl.php
• poll-vote.tpl.php

Remarque : Les précédents fichiers gabarits poll-results-block.tpl.php/6 et poll-bar-block.tpl.php ont été renommés avec un double tiret dans Drupal 7.

Profile

"modules/profile/..."

• profile-block.tpl.php
• profile-listing.tpl.php
• profile-wrapper.tpl.php

Search

"modules/search/..."

• search-block-form.tpl.php
• search-result.tpl.php
• search-results.tpl.php

Remarque : search-theme-form.tpl.php est obsolète dans Drupal 7.

System

"modules/system/..."

• page.tpl.php
• maintenance-page.tpl.php
• region.tpl.php
• html.tpl.php

box.tpl.php est obsolète dans Drupal 7. html.tpl.php et region.tpl.php ont été ajoutés.

Taxonomy

"modules/taxonomy/..."

• taxonomy-term.tpl.php

Remarque: taxonomy-term.tpl.php est un nouveau fichier gabarit dans Drupal 7.

Toolbar

"modules/toolbar/..."

• toolbar.tpl.php

Remarque: toolbar.tpl.php est un nouveau fichier gabarit dans Drupal 7.

User

"modules/user/..."

• user-picture.tpl.php
• user-profile-category.tpl.php
• user-profile-item.tpl.php
• user-profile.tpl.php