[[extend-manual-install]]

=== Télécharger manuellement des modules ou des thèmes

[role="summary"]
Comment télécharger manuellement un module ou un thème.

(((Module,téléchargement)))
(((Module contribué,téléchargement)))
(((Thème,téléchargement)))
(((Thème contribué,téléchargement)))
(((Téléchargement,module ou thème manuellement)))
(((Téléchargement manuel de modules ou de thèmes,survol)))

=== Objectif

Télécharger manuellement un module ou un thème et le transférer sur votre site,
lorsque les méthodes d'installation ou de mise à jour pour installer ou mettre à
jour un module ou un thème via votre site web ou avec Drush ne fonctionnent pas,
ou lors de la mise en place d'un module ou d'un thème personnalisé.

==== Prérequis

* <<understanding-modules>>
* <<extend-module-find>>
* <<understanding-themes>>
* <<extend-theme-find>>

==== Préquis du site

Pour effectuer le téléchargement manuel décrit  dans cette page, les conditions
suivantes doivent se présenter :

* Des problèmes de droits d'accès fichier

* Des problèmes de droits FTP

* Vous avez créé un module/thème personnalisé ou reçu des fichiers de quelqu'un

* Vous n'avez pas réussi à suivre les instructions dans
<<extend-module-install>>, <<extend-theme-install>>, <<security-update-module>>,
ou <<security-update-theme>>

Sauter cette page si aucun des cas susmentionnés ne s'applique à votre
situation. Si vous utilisez Composer pour gérer les fichiers de votre site,
suivre les étapes décrivant comment mettre à jour vos fichiers dans
<<install-composer>> au lieu de cette page.

==== Étapes

Lorsque vous installez un module ou thème depuis _Drupal.org_, suivre les
instructions de téléchargement, et ensuite celles pour transférer et extraire.
Si vous êtes l'auteur du module ou du thème, ignorer l'étape concernant le
téléchargement. À la place, créer une archive (que vous savez comment extraire
sur le serveur) et continuer avec les étapes concernant le transfert et
l'extraction, en utilisant n'importe quelle méthode appropriée, eu égard à la
manière dont vous avez initialement créé l'archive.

===== Téléchargement des fichiers

. Ouvrir la page de projet du thème ou du module sur drupal.org ; par exemple,
la page d'_Admin toolbar_   (https://www.drupal.org/project/admin_toolbar).

. Faire défiler la page jusqu'à la section _Téléchargements_ vers le bas de la page.
+
--
// Downloads section of the Admin Toolbar project page on drupal.org.
image:images/extend-manual-install-download.png["Téléchargement de modules"]
--

. Cliquer sur _tar.gz pour télécharger le fichier sur votre ordinateur. Sinon,
si vous avez accès au terminal sur votre serveur d'hébergement (sous Linux),
vous pouvez copier l'adresse du lien vers le fichier _tar.gz_ depuis votre
navigateur, et utiliser cette commande pour télécharger le fichier (remplacer
l'URL copiée) :
+
----
wget https://ftp.drupal.org/files/projects/admin_toolbar-8.x-1.26.tar.gz
----

===== Transférer les fichiers sur votre site et les extraire

. Pour ajouter un nouveau module ou thème,  créer des sous-dossiers dans votre
répertoire racine _modules_ et _themes (s'ils n'existent pas déjà). En général,
on crée un sous-dossier _contrib_ pour les modules et thèmes contribués qui sont
téléchargés depuis _Drupal.org_, et un sous-dossier _custom_ pour les modules et
thèmes personnalisés. Votre dossier _modules_ pourrait ressembler à ceci :
+
--
// Make custom and contrib directories under modules, and take a screenshot
// showing the directory structure.
image:images/extend-manual-install-directories.png["Arborescence dans le système
fichier conseillée pour les modules",width="174px"]

// NOTE for Translators: you don't need to localize the 'custom' and 'contrib' directory names as they are more common in English.
--

. Pour remplacer un module ou thème existant par une version actualisée, mettre
le site en mode maintenance. Consulter <<extend-maintenance>>.

. Pour remplacer un module ou thème existant par une version actualisée, repérer
et éliminer tous les fichiers et dossiers du module ou thème existant.
Normalement, les modules se trouvent dans des dossiers à l'intérieur du dossier
racine _modules_ et les thèmes à l'intérieur du dossier racine _themes_.

. Transférer le fichier _.tar.gz_ (ou l'archive que vous avez créée) sur votre
site. Le placer soit au même endroit que le dossier éliminé (en cas de
remplacement d'un module ou thème existant), soite dans le sous-dossier
approprié _modules_ ou _themes_

. Extraire les fichiers de l'archive _.tar.gz_ (ou l'archive que vous avez
créée), pour générer un sous-dossier à l'emplacement de l'archive. Si vous
n'avez pas accès au terminal, ou si votre serveur d'hébergement ne fonctionne
pas sous Linux, le gestionnaire de fichiers du panneau de contrôle de
l'hébergeur devrait fournir un moyen d'extraire les fichiers. Si vous avez accès
au terminal sur votre serveur d'hébergment (sous Linux) et il s'agit d'un
fichier tar.gz, il est possible d'utiliser une commande telle que :
+
----
tar -xzf admin_toolbar-8.x-1.17.tar.gz
----

. Supprimer le fichier compressé du serveur, à moins que le mode d'extraction
employé ne l'ait déjà supprimé.

. Se reporter à <<extend-module-install>>, <<extend-theme-install>>,
<<security-update-module>>, ou <<security-update-theme>> pour achever
l'installation ou la mise à jour du module ou thème. Commencer par l'étape
venant après la finalisation du téléchargement automatique.

==== Pour approfondir

* Si vous travaillez avec des environnements multiples (par exemple, un site de
développement local et un site de production), il faudra répéter les étapes pour
chaque environnement, ou cloner l'environnement. Consulter
<<install-dev-making>>.

* Si vous avez ajouté un nouveau thème, naviguer dans le menu _Gérer_ vers
_Apparence_ (_admin/appearance_) et désinstaller l'ancien thème.

// ==== Concepts associés

==== Vidéos (en anglais)

// Video from Drupalize.Me.
video::https://www.youtube-nocookie.com/embed/kOzQz9q3Kf8[title="Télécharger
manuellement un module ou un thème"]

==== Ressources supplémentaires

* https://www.drupal.org/node/250790[page de documentation sur _Drupal.org_  de la communauté : "Mise à jour de modules"]
* https://www.drupal.org/docs/8/extending-drupal-8/installing-drupal-8-modules[page de documentation sur _Drupal.org_ de la communauté : "Installation de modules contribués (Drupal 8)"]
* https://www.drupal.org/docs/8/extending-drupal-8/installing-themes[page de documentation sur _Drupal.org_ de la communauté : "Installation de thèmes"]


*Attributions*

Écrit et modifié par https://www.drupal.org/u/batigolix[Boris Doesborg],
https://www.drupal.org/u/jhodgdon[Jennifer Hodgdon], et
https://www.drupal.org/u/vegantriathlete[Marc Isaacson] et
Traduit par https://www.drupal.org/u/onewomanbiz[Lydie Parisot] et
https://www.drupal.org/u/fmb[Felip Manyer i Ballester].
