11.5. Télécharger et installer un thème depuis Drupal.org

Last updated on
14 April 2025

Objectif

Télécharger et installer un thème depuis Drupal.org.

Prérequis du site

Composer doit être installé pour télécharger des thèmes. Si vous voulez utiliser Drush, procéder tout d’abord à son installation. Consulter Section 3.2, « Concept : outils supplémentaires ».

Étapes

Pour installer un thème contribué, commencer par le télécharger avec Composer. Ensuite, l’installer en utilisant soit l’interface d’administration, soit Drush. Si vous installez un thème personnalisé plutôt qu’un thème contribué, qui n’est pas disponible via Composer, passer ces étapes concernant le téléchargement du module, et se référer à Section 11.6, « Installer manuellement des modules ou des thèmes ». Revenir alors ici et suivre les étapes pour installer le module, en utilisant soit l’interface d’administration, soit Drush.

Télécharger le thème contribué avec Composer

  1. Sur la page de projet du thème sur drupal.org (par exemple https://www.drupal.org/project/honey), dérouler la page jusqu’à la section Releases (versions) en bas de page.
  2. Copier la commande Composer fournie correspondant à la version du thème que vous souhaitez installer.

    Trouver la commande d’installation d’un thème avec Composer

  3. Vous pouvez autrement taper la commande suivante (en remplaçant le nom machine du thème et la version souhaitée) :

    composer require 'drupal/honey:^1.0'
  4. En ligne de commande, se placer dans le répertoire racine du projet. Coller la commande Composer et l’exécuter.
  5. Vous devriez voir un message indiquant que le thème a été téléchargé avec succès.

Installer le thème depuis l’interface d’administration

  1. Dans le menu d’administration Gérer, naviguer vers Apparence (admin/appearance). La page Apparence apparaît.
  2. Localiser le nouveau thème sous Thèmes désinstallés et cliquer sur Installer et définir par défaut pour l’utiliser. Toutes les pages hors celles d’administration de votre site utiliseront alors ce nouveau thème.

    Thèmes désinstallés sur la page Apparence

Utiliser Drush pour installer un thème

  1. Pour installer le thème et le définir comme thème par défaut, exécuter les commandes Drush suivantes, en donnant le nom du projet en paramètre (par exemple, honey) :

    drush theme:enable honey
    drush config:set system.theme default honey
  2. Suivre les instructions à l’écran.

Pour approfondir

Vidéos (en anglais)

Downloading and Installing a Theme from Drupal.org

Attributions

Écrit et modifié par Joe Shindelar de Drupalize.Me, et Boris Doesborgh. Traduit par Felip Manyer i Ballester.

 

This page is generated from AsciiDoc source from the User Guide. To propose a change, edit the source and attach the file to a new issue in the User Guide project. PDF and e-book formats are available on the User Guide project page.

Source file: extend-theme-install.asciidoc

Help improve this page

Page status: No known problems

You can: