11.6. Ручная загрузка модулей и тем оформления

Last updated on
14 April 2025

Цель

Ручная загрузка файлов модуля или темы и их закачка на ваш сайт, если сайт или Drush методы для установки или обновления модуля или темы не работают, или если вы размещаете пользовательский модуль или тему.

Требования к сайту

Для выполнения загрузки вручную должно быть выполнено одно из следующих условий, описанных в этом разделе:

Пропустите этот раздел, если все вышесказанное не относится к вам. Если вы используете Composer для управления файлами на вашем сайте, следуйте инструкциям по обновлению файлов в Раздел 3.5, «Использование Composer и Git для загрузки файлов» вместо этой темы.

Шаги

Если вы устанавливаете модуль или тему с Drupal.org, следуйте инструкциям по установке, а затем инструкциям по загрузке / распаковке. Если вы создали модуль или тему, пропустите шаг загрузки. Вместо этого создайте архивный файл (который вы знаете, как извлечь на сервере) и продолжайте шаги по загрузке / распаковке, используйте любой метод, подходящий для создания архивного файла.

Загрузка файлов

  1. Откройте страницу проекта модуля или темы на drupal.org; например, страница Admin toolbar (https://www.drupal.org/project/admin_toolbar).
  2. Скрольте к разделу Downloads внизу страницы.

    Загрузка файлов модулей

  3. Нажмите tar.gz чтобы загрузить файл на компьютер. Другим способом, если у вас есть доступ к командной строке на вашем сервере (работающим на Linux), вы можете скопировать адрес ссылки для tar.gz файла из вашего браузера и использовать эту комануд для скачивания файла (с заменой нужного URL):
wget https://ftp.drupal.org/files/projects/admin_toolbar-8.x-2.4.tar.gz

Загрузка файлов на ваш сайт и их распаковка

  1. При добавлении нового модуля или темы, создайте подкаталог в вашей верхней modules и themes директории (если они уже не существуют). Как правило, люди делают contrib подкаталог для дополнительных модулей и тем, которые загружаются с Drupal.org, и custom подкаталог для модулей и тем, которые они создали. Ваша директория модули может выглядеть как это:

    Предлагаемая структура каталогов для модулей

  2. Если вы заменяете существующий модуль или тему на обновленную версию, переключите сайт в режим обслуживания. Смотрите Раздел 11.2, «Включение и выключение Режима обслуживания».
  3. Если вы заменяете существующий модуль или тему на обновленную версию, найдите и удалите все существующие файлы и каталоги для существующего модуля или темы. Модули обычно расположены под директориями верхнего уровня modules, и темы обычно расположены под директориями верхнего уровня themes.
  4. Загрузите .tar.gz файл (или любой другой архив, который вы создали) на ваш сайт. Поместите его в то же место, из которого вы удалили директорию (при замене существующего модуля или темы) или соответствующий подкаталог из modules или themes (если добавляется новый модуль или тема).
  5. Извлеките файлы из .tar.gz архива (или любой другой созданный архив), создайте подкаталог в том же месте, что и файл архива. Если у вас нет доступа к терминалу, или ваш хостинг сервер не работает на Linux, ваш файловый менеджер панели управления хостингом должен давать возможность извлечь файлы. Если у вас есть доступ к терминалу для вашего хостинг сервера (работает на Linux) и вы используете tar.gz файл, вы можете использовать такую команду как:

    tar -xzf admin_toolbar-8.x-2.4.tar.gz
  6. Удалите сжатый файл с сервера, если ваш метод распаковки уже не удалил его.
  7. Ссылайтесь на Раздел 11.3, «Загрузка функционала и установка модуля с Drupal.org», Раздел 11.5, «Загрузка и установка темы оформления с Drupal.org», Раздел 13.6, «Обновление модуля Drupal», или Раздел 13.7, «Обновление темы оформления Drupal» для завершения установки или обновления модуля или темы. Начните с шага после того, как автоматическая загрузка будет совершена.

Расширьте своё понимание

  • Если вы работаете с несколькими окружениями (например, сайт локальной разработки и рабочий сайт) вам придется повторить шаги в каждом окружении, или склонировать окружение. Смотрите Раздел 11.8, «Создание сайта для разработки».
  • Если вы добавили новую тему, перейдите в Управлении административного меню в Оформление (admin/appearance) и удалите старую тему.

 

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: