[[extend-manual-install]]

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

[role="summary"]
Как вручную загрузить и закачать модуль или тему.

(((Модуль,загрузка)))
(((Дополнителный модуль,загрузка)))
(((Тема,загрузка)))
(((Дополнительная тема,загрузка)))
(((Загрузка,файлы модуля или темы вручную)))
(((Ручная загрузка модулей и тем оформления,обзор)))

==== Цель

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

==== Необходимые знания

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

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

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

* Проблемы с правами доступа к файлам

* Проблемы с разрешением FTP

* Вы создали собственный модуль / тему или получили эти файлы от кого-то

* Вы не могли успешно выполнить инструкции в
<<extend-module-install>>, <<extend-theme-install>>,
<<security-update-module>>, или <<security-update-theme>>

Пропустите этот раздел, если все вышесказанное не относится к вам. Если вы используете Composer
для управления файлами на вашем сайте, следуйте инструкциям по обновлению файлов в
<<install-composer>> вместо этой темы.

==== Шаги

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

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

. Откройте страницу проекта модуля или темы на drupal.org; например, страница _Admin
toolbar_ (https://www.drupal.org/project/admin_toolbar).

. Скрольте к разделу _Downloads_ внизу страницы.
+
--
// Downloads section of the Admin Toolbar project page on drupal.org.
image:images/extend-manual-install-download.png["Загрузка файлов модулей"]
--

. Нажмите _tar.gz_ чтобы загрузить файл на компьютер. Другим способом, если у вас
есть доступ к командной строке на вашем сервере (работающим на Linux), вы можете скопировать
адрес ссылки для _tar.gz_ файла из вашего браузера и использовать эту комануд
для скачивания файла (с заменой нужного URL):

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


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

. При добавлении нового модуля или темы, создайте подкаталог в вашей
верхней _modules_ и _themes_ директории (если они уже не
существуют). Как правило, люди делают _contrib_ подкаталог для дополнительных модулей
и тем, которые загружаются с _Drupal.org_, и _custom_ подкаталог для
модулей и тем, которые они создали. Ваша директория _модули_ может выглядеть как
это:
+
--
// Make custom and contrib directories under modules, and take a screenshot
// showing the directory structure.
image:images/extend-manual-install-directories.png["Предлагаемая структура каталогов для модулей",width="174px"]

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

. Если вы заменяете существующий модуль или тему на обновленную версию, переключите
сайт в режим обслуживания. Смотрите <<extend-maintenance>>.

. Если вы заменяете существующий модуль или тему на обновленную версию, найдите
и удалите все существующие файлы и каталоги для существующего модуля
или темы. Модули обычно расположены под директориями верхнего уровня
_modules_, и темы обычно расположены под директориями верхнего уровня
_themes_.

. Загрузите _.tar.gz_ файл (или любой другой архив, который вы создали) на ваш сайт.
Поместите его в то же место, из которого вы удалили директорию
(при замене существующего модуля или темы) или соответствующий подкаталог
из _modules_ или _themes_ (если добавляется новый модуль или тема).

. Извлеките файлы из _.tar.gz_ архива (или любой другой
созданный архив), создайте подкаталог в том же месте, что и файл архива.
Если у вас нет доступа к терминалу, или ваш хостинг сервер не работает на
Linux, ваш файловый менеджер панели управления хостингом должен давать возможность
извлечь файлы. Если у вас есть доступ к терминалу для вашего хостинг сервера
(работает на Linux) и вы используете tar.gz файл, вы можете использовать такую команду как:
+
----
tar -xzf admin_toolbar-8.x-1.17.tar.gz
----

. Удалите сжатый файл с сервера, если ваш метод распаковки
уже не удалил его.

. Ссылайтесь на <<extend-module-install>>, <<extend-theme-install>>,
<<security-update-module>>, или <<security-update-theme>> для завершения
установки или обновления модуля или темы. Начните  с шага после того, как
автоматическая загрузка будет совершена.

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

* Если вы работаете с несколькими окружениями (например, сайт локальной разработки
и рабочий сайт) вам придется повторить шаги в каждом окружении, или
склонировать окружение. Смотрите <<install-dev-making>>.

* Если вы добавили новую тему, перейдите в _Управлении_ административного меню в
_Оформление_ (_admin/appearance_) и удалите старую тему.

// ==== Related concepts

==== Видео

// Video from Drupalize.Me.
video::https://www.youtube-nocookie.com/embed/kOzQz9q3Kf8[title="Manually Downloading Module or Theme Files"]

==== Дополнительные материалы

* https://www.drupal.org/node/250790[_Drupal.org_ страница документации сообщества "Updating modules"]
* https://www.drupal.org/docs/8/extending-drupal-8/installing-drupal-8-modules[_Drupal.org_ страница документации сообщества "Installing contributed modules (Drupal 8)"]
* https://www.drupal.org/docs/8/extending-drupal-8/installing-themes[_Drupal.org_ страница документации сообщества "Installing themes"]


*Авторы*

Написано и отредактировано https://www.drupal.org/u/batigolix[Boris Doesborg],
https://www.drupal.org/u/jhodgdon[Jennifer Hodgdon], и
https://www.drupal.org/u/vegantriathlete[Marc Isaacson].

Переведено https://www.drupal.org/u/MishaIsmajlov[Михаил Исмайлов].
