11.6. Themes oder Module manuell herunterladen

Last updated on
14 April 2025

Zielsetzung

Laden Sie Modul- oder Theme-Dateien manuell herunter und laden Sie diese auf Ihre Website hoch, wenn das Installieren oder aktualisieren eines Moduls oder Themes mittels Drush oder über die Benutzeroberfläche der Website nicht funktioniert, oder wenn Sie ein selbst definiertes Modul oder Theme installieren möchten.

Anforderungen an die Website

Für den manuellen Download müssen Sie sich mit einem der folgenden, in diesem Kapitel, beschriebenen Probleme auseinandersetzen:

Überspringen Sie dieses Thema, wenn keiner der oben genannten Problemfälle in Ihrem Fall eingetreten ist. Wenn Sie Composer verwenden um Dateien auf Ihrer Website zu verwalten, folgen Sie den Schritten zur Dateiaktualisierung in Abschnitt 3.5, „Composer zum Herunterladen und Aktualisieren von Dateien verwenden“ an Stelle der Schritte dieses Kapitels.

Arbeitsschritte

Wenn Sie ein Modul oder Theme von Drupal.org installieren, folgen Sie den Anweisungen zum Herunterladen und anschkießend den Anweisungen zum Hochladen/Entpacken. Wenn Sie das Modul oder Theme erstellt haben, überspringen Sie die Anweisungen zum Herunterladen. Legen Sie stattdessen eine Archivdatei (von der Sie wissen, wie man sie auf dem Server extrahiert) an und fahren Sie mit den Schritten zum Hochladen und Entpacken eines Themes bzw. Moduls fort. Verwenden Sie dazu eine Methode, die mit dem von Ihnen erzeugten Archiv kompatibel ist.

Die notwendigen Dateien herunterladen

  1. Öffnen Sie die Projektseite des gewünschten Moduls oder Themes auf drupal.org. Zum Beispiel die Projektseite des Moduls, Admin Toolbar (https://www.drupal.org/project/admin_toolbar).
  2. Scrollen Sie zum Abschnitt Downloads im unteren Bereich der Seite.

    Downloading module files

  3. Klicken Sie auf tar.gz, um die Datei auf Ihren Computer herunterzuladen. Wenn Sie Terminal-Zugang zu Ihrem Hosting-Server (unter Linux) haben, können Sie alternativ die Link-Adresse für die tar.gz-Datei mit Hilfe Ihres Browsers kopieren und folgenden Befehl verwenden, um die Datei herunter zu laden (wobei sie die URL durch die von Ihnen kopierte Adresse ersetzen):

    wget https://ftp.drupal.org/files/projects/admin_toolbar-8.x-2.4.tar.gz

Die Dateien auf Ihre Website hochladen und entpacken

  1. Wenn Sie ein neues Modul oder Theme hinzufügen möchten, erstellen Sie in Ihrem Hauptverzeichnis die Unterverzeichnisse modules und themes (falls diese nicht bereits existieren). Typischerweise wird ein Unterverzeichnis contrib für von der Community bereitgestellte Zusatzmodule oder Themes, die von Drupal.org heruntergeladen werden im jeweiligen Verzeichnis erstellt. Außerdem wird normalerweise ein Unterverzeichnis mit dem Namen custom angelegt für Module und Themes, die sie selbst erstellt haben. Ihr Modul-Verzeichnis könnte dann wie folgt aussehen:

    empfohlene Verzeichnisstruktur für das verzeichnis modules

  2. Wenn Sie ein vorhandenes Modul oder Theme durch eine aktualisierte Version ersetzen wollen, versetzen Sie die Website in den Wartungsmodus. Siehe: Abschnitt 11.2, „Aktivieren und Deaktivieren des Wartungsmodus“.
  3. Wenn Sie ein vorhandenes Modul oder Theme durch eine aktualisierte Version ersetzen wollen, lokalisieren und löschen Sie alle vorhandenen Dateien und Verzeichnisse des vorhandenen Moduls oder Themes. Die Module befinden sich normalerweise in Verzeichnissen auf der obersten Ebene des Verzeichnisses modules. Themes befinden sich normalerweise auf der obersten Ebene des Verzeichnisses themes.
  4. Laden Sie die .tar.gz-Datei (oder die Archivdatei, die Sie erstellt haben) auf Ihre Website hoch. Platzieren Sie die Datei entweder am selben Ort, an dem Sie das entsprechende Verzeichnis gelöscht haben (wenn ein vorhandenes Modul oder Theme ersetzt werden soll) oder in das entsprechende Unterverzeichnis des Verzeichnisses modules oder themes (wenn ein neues Modul oder Thems hinzugefügt werden soll).
  5. Extrahieren Sie die Dateien aus dem .tar.gz-Archiv (oder dem Archiv, das Sie erstellt haben), wobei ein Unterverzeichnis am gleichen Ort erstellt wird, an dem sich auch die Archivdatei befindet. Wenn Sie keinen SSH-Zugang haben oder Ihr Hosting-Server Linux nicht verwendet, sollte der Dateimanager Ihres Hosting Control Panels eine Möglichkeit bieten die Datei zu entpacken. Wenn Sie (unter Linux) SSH-Zugriff auf Ihr Hosting-System haben und Sie eine tar.gz-Datei verwenden, können Sie etwa folgenden Befehl verwenden, um ihr Archiv zu entpacken:

    tar -xzf admin_toolbar-8.x-2.4.tar.gz
  6. Löschen Sie die komprimierte Datei vom Server, falls sie nicht nach dem Entpacken automatisch gelöscht wurde.
  7. Siehe: Abschnitt 11.3, „Herunterladen und Installieren eines Moduls von Drupal.org, Abschnitt 11.5, „Herunterladen und Installieren eines Themes von Drupal.org, Abschnitt 13.6, „Aktualisieren eines Moduls“, oder Abschnitt 13.7, „Aktualisieren eines Themes“ um die Installation oder Aktualisierung des Moduls oder Themas abzuschließen. Beginnen Sie dort mit dem Arbeitsschritt, der nach dem automatischen Download folgt.

Erweitern Sie ihre Kenntnisse

  • Wenn Sie mit mehreren Umgebungen arbeiten (z. B. einer lokalen Entwicklungsumgebung und einer Live-Website) müssen Sie diese Arbeitsschritte in jeder Umgebung gesondert ausführen oder die betroffene Umgebung neu klonen. Siehe: Abschnitt 11.8, „Eine Entwicklungs-Website erstellen“.
  • Wenn Sie ein neues Theme hinzugefügt haben, navigieren Sie im Menü Verwalten zum Menüpunkt Design (admin/appearance) und deinstallieren Sie das alte Theme.

 

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-manual-install.asciidoc

Help improve this page

Page status: No known problems

You can: