Стандартная инструкция по установке мода представляет собой файл с расширением XML, который необходимо открыть при помощи браузера и который содержит различные секции, несущие информацию о том или ином этапе установки или настройки мода. По стандарту этот файл называется install.xml или install_mod.xml, однако в старых модах допускались иные, произвольные наименования файла. Многие секции не являются обязательными, их наличие или отсутствие в инструкции определяется только конкретным модом, поэтому если вы не нашли какой-либо из описываемых далее секций - не пугайтесь, значит для установки этого мода она просто не нужна.
Теперь перейдём к описанию всех возможных секций, которые могут встретиться вам при установке. Для облегчения понимания в тексте даны скриншоты на примере различных модов.
1. Секция информации.
Первым, что вы увидите, открыв файл XML, будет информация о самом моде: версия, сложность и приблизительное время, необходимое для его установки. В большинстве случаев эти данные идут на английском языке, но если автор мода из России, то могут быть и на русском. Русский язык можно выбрать в правом верхнем углу инструкции, в меню "Select language":
2. Редактируемые файлы (Files to edit).
После заметок идёт информация об авторе и затем перечислены файлы движка, которые вам будет необходимо отредактировать, если мод включает в себя эту необходимость:
Внимание: обычно файлы phpBB3 можно редактировать с помощью любого текстового редактора, но если в файле содержатся кириллические символы (например, слова на русском языке) и особенно если это языковой файл, то его необходимо сохранять исключительно в кодировке UTF-8 Without BOM (UTF-8 без BOM). Для этого подойдёт, например, редактор Notepad++
Теперь перейдём непосредственно к редактированию файлов. Редактирование производится при помощи стандартных типов команд, после каждой из которых идёт кусок кода, который необходимо скопировать в буфер обмена и произвести с ним действие согласно команде для этого куска. Команды бывают следующих типов:
Find (Найти). Выполнить обычный поиск по файлу, предварительно скопировав указанный фрагмент кода. Например:
Add before (Добавить перед). Вставить кусок кода ДО найденного фрагмента. Это значит, что нужно вставить предлагаемый кусок кода на одну линию выше, чем искомый кусок.
In-line Add before (Добавить в строку перед найденным следующий код). То же самое, что и предыдущее, но добавлять нужно не на линию выше, а на той же самой линии, что и найденный кусок.
Add after (Добавить после). Вставить кусок кода после найденного фрагмента. Это значит, что нужно вставить предлагаемый кусок кода на одну линию ниже, чем искомый кусок.
In-line Add after (Добавить в строку после найденного следующий код). Вставить предлагаемый кусок кода на той же самой линии сразу после найденного куска.
Replace with (Заменить на). Заменить найденный кусок кода на предлагаемый.
In-line Replace with (Заменить код в строке на следующий). То же, что и предыдущее, просто в той же самой строке.
Find and delete (Найти и удалить). Думаю, что тут объяснять ничего не нужно. Просто удалите найденный кусок кода.
In-line Find and Delete (В строке найти и удалить). Удалить кусок кода в той же самой строке, что и искомый фрагмент.
Comment (Комментарий). Обычный комментарий, пояснение к той или иной правке. Не является командой для выполнения.
После того, как файл будет отредактирован, закачайте его обратно, заменив им оригинальный файл. Проделайте все требуемые операции и с остальными файлами секции "Files to edit", не забыв также о дополнительных инструкциях, если такие окажутся в моде (см. пункт 8).
ВАЖНО: Если на вашем форуме установлен какой-нибудь нестандартный стиль, название которого отличается от стандартных стилей phpBB (prosilver и subsilver2) , то вы должны выполнить правки файлов для этого стиля отдельно. Делается это так: смотрите, на каком из стандартных стилей основан ваш стиль, и по установочной инструкции, предназначенной для этого стандартного стиля, делаете те же самые правки и для вашего стиля. То же самое и с языками форума: если в инструкции мода нет перевода на ваш язык, то перед установкой этого мода вы должны позаботиться о том, чтобы найти перевод в интернете, либо сделать его самостоятельно, если такого перевода нигде нет.
3. SQL-команды (изменения базы данных).
Иногда в инструкции может встретиться набор SQL-команд для ручного выполнения, который выглядит примерно так:
4. Копирование файлов (File copy).
Если в папке или архиве мода присутствует папка root, то всё её содержимое необходимо скопировать в корневую папку вашего форума (туда, где находится файл config.php), соблюдая вложенность папок.
5. PHP install file (Инсталляционный файл PHP).
В некоторых модах присутствует инсталляционный (установочный) файл. Это скрипт, который имеет расширение .php и вносит изменения в базу данных (БД), добавляя туда данные мода. Его нужно скопировать в корневую папку и запустить, набрав в браузере адрес_форума/название_скрипта. До этого желательно сделать все необходимые изменения в файлах согласно инструкции мода. Например, если скрипт называется install.php, то путь для запуска будет таким: адрес_форума/install.php
В более новых версиях модов информация об установочном файле выносится в отдельную секцию - "PHP install file":
6. DIY Instructions (инструкции для ручного выполнения) - самая последняя секция, находящаяся в самом низу XML-инструкции, и содержащая сведения по завершению установки и окончательной настройке мода, которые могут быть выполнены только вручную. Никакой Автомод за вас это не сделает.
7. Очистка кеша.
После установки некоторых модов нужно очищать (обновлять) кеш, и это отдельная тема, на которой я остановлюсь более подробно в статье: Очистка кеша в phpBB3
8. Дополнительные инструкции по установке.
Иногда в основной инструкции присутствуют ссылки на дополнительные инструкции по установке (Additional file(s)). Это могут быть:
- Правки для различных языков (в том числе для русского)
- Правки для стилей. Чаще всего, в отдельный файл выносятся изменения для стиля subsilver2
- Инструкции по обновлению с предыдущих версий
- Аддоны (дополнения) к моду.
ВАЖНО (вместо заключения):
Перед установкой любых модов делайте резервные копии подвергающихся изменению файлов, а также бекап базы данных, если мод затрагивает БД. Особенно, если вы новичок. В этом случае, если что-то пойдёт не так, вы всегда сможете восстановить оригинальные файлы и данные из бекапа. Если ваша база данных слишком большая и из-за этого не получается сделать бекап стандартными средствами phpBB, воспользуйтесь специальными программами для создания резервных копий БД, такими как Sypex Dumper или MySQL Dumper.
