Как установить МОД для phpBB3 ?

Подробное описание всех этапов настройки и установки модификаций для phpBB3. Если вы - начинающий в установке модов, обязательно прочтите эту тему

Материалы по настройке форума, установке модов, описание возможностей движка.
Shredder
Администратор
Сообщения: 1073
Зарегистрирован: 22.08.13 09:05
Благодарил (а): 133 раза
Поблагодарили: 264 раза
Контактная информация:

Как установить МОД для phpBB3 ?

Сообщение Shredder »

Сразу оговорюсь, что всё написанное в этой теме, кроме раздела о секции "DIY Instructions", применимо исключительно к установке модов вручную. Помимо ручной установки можно воспользоваться автоматическим установщиком модов (AutoMod), но не все моды бывают заточены под него (особенно это может касаться старых и давно не обновлявшихся модов), поэтому иногда без установки руками просто не обойтись.

Стандартная инструкция по установке мода представляет собой файл с расширением XML, который необходимо открыть при помощи браузера и который содержит различные секции, несущие информацию о том или ином этапе установки или настройки мода. По стандарту этот файл называется install.xml или install_mod.xml, однако в старых модах допускались иные, произвольные наименования файла. Многие секции не являются обязательными, их наличие или отсутствие в инструкции определяется только конкретным модом, поэтому если вы не нашли какой-либо из описываемых далее секций - не пугайтесь, значит для установки этого мода она просто не нужна.

Теперь перейдём к описанию всех возможных секций, которые могут встретиться вам при установке. Для облегчения понимания в тексте даны скриншоты на примере различных модов.

1. Секция информации.
Первым, что вы увидите, открыв файл XML, будет информация о самом моде: версия, сложность и приблизительное время, необходимое для его установки. В большинстве случаев эти данные идут на английском языке, но если автор мода из России, то могут быть и на русском. Русский язык можно выбрать в правом верхнем углу инструкции, в меню "Select language":
language.png
Далее может идти раздел Author notes (Примечания автора), где могут содержаться пояснения по работе мода и его установке, которые необходимо внимательно прочитать.
install_mods_1.png
Если эти примечания идут исключительно на английском языке и вам они не понятны, воспользуйтесь онлайн-переводчиком, например Google Translate или translate.ru. Если не понятен машинный перевод, создайте на форуме тему, где более опытные люди всё объяснят.

2. Редактируемые файлы (Files to edit).
После заметок идёт информация об авторе и затем перечислены файлы движка, которые вам будет необходимо отредактировать, если мод включает в себя эту необходимость:
install_mods_2.png
Адреса всех файлов в инструкции даны от корневой папки форума. Кликнув на адрес файла, вы можете перейти непосредственно к описанию правок, которые необходимо внести в этот файл. Чтобы открыть файл для редактирования, его для начала нужно скачать с сервера при помощи любого ftp-клиента - например, FileZilla или Ftp Commander.
Внимание: обычно файлы phpBB3 можно редактировать с помощью любого текстового редактора, но если в файле содержатся кириллические символы (например, слова на русском языке) и особенно если это языковой файл, то его необходимо сохранять исключительно в кодировке UTF-8 Without BOM (UTF-8 без BOM). Для этого подойдёт, например, редактор Notepad++

Теперь перейдём непосредственно к редактированию файлов. Редактирование производится при помощи стандартных типов команд, после каждой из которых идёт кусок кода, который необходимо скопировать в буфер обмена и произвести с ним действие согласно команде для этого куска. Команды бывают следующих типов:

Find (Найти). Выполнить обычный поиск по файлу, предварительно скопировав указанный фрагмент кода. Например:
commands.png
In-line 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-команд для ручного выполнения, который выглядит примерно так:
install_mods_3.png
Эти команды нужно скопировать в буфер обмена и выполнить через phpMyAdmin, либо через средство "Выполнение SQL-запроса" утилиты Support Toolkit.

4. Копирование файлов (File copy).
Если в папке или архиве мода присутствует папка root, то всё её содержимое необходимо скопировать в корневую папку вашего форума (туда, где находится файл config.php), соблюдая вложенность папок.

5. PHP install file (Инсталляционный файл PHP).
В некоторых модах присутствует инсталляционный (установочный) файл. Это скрипт, который имеет расширение .php и вносит изменения в базу данных (БД), добавляя туда данные мода. Его нужно скопировать в корневую папку и запустить, набрав в браузере адрес_форума/название_скрипта. До этого желательно сделать все необходимые изменения в файлах согласно инструкции мода. Например, если скрипт называется install.php, то путь для запуска будет таким: адрес_форума/install.php
В более новых версиях модов информация об установочном файле выносится в отдельную секцию - "PHP install file":
install_mods_4.png
В старых модах эта информация располагается в разделе DIY Instructions.

6. DIY Instructions (инструкции для ручного выполнения) - самая последняя секция, находящаяся в самом низу XML-инструкции, и содержащая сведения по завершению установки и окончательной настройке мода, которые могут быть выполнены только вручную. Никакой Автомод за вас это не сделает.

7. Очистка кеша.
После установки некоторых модов нужно очищать (обновлять) кеш, и это отдельная тема, на которой я остановлюсь более подробно в статье: Очистка кеша в phpBB3

8. Дополнительные инструкции по установке.
Иногда в основной инструкции присутствуют ссылки на дополнительные инструкции по установке (Additional file(s)). Это могут быть:
- Правки для различных языков (в том числе для русского)
- Правки для стилей. Чаще всего, в отдельный файл выносятся изменения для стиля subsilver2
- Инструкции по обновлению с предыдущих версий
- Аддоны (дополнения) к моду.
install_mods_5.png
Не пропустите эти вещи мимо своего внимания, когда будете устанавливать мод.


ВАЖНО (вместо заключения):
Перед установкой любых модов делайте резервные копии подвергающихся изменению файлов, а также бекап базы данных, если мод затрагивает БД. Особенно, если вы новичок. В этом случае, если что-то пойдёт не так, вы всегда сможете восстановить оригинальные файлы и данные из бекапа. Если ваша база данных слишком большая и из-за этого не получается сделать бекап стандартными средствами phpBB, воспользуйтесь специальными программами для создания резервных копий БД, такими как Sypex Dumper или MySQL Dumper.
Мои моды и расширения для phpBB
Выполняю работы по phpBB3 на заказ. Пишите в личку или на почту.
Бесплатная поддержка - только в темах.
neexforg
Сообщения: 15
Зарегистрирован: 17.01.14 23:11
Благодарил (а): 8 раз
Поблагодарили: 2 раза

Как установить МОД для phpBB3 ?

Сообщение neexforg »

Спасибо за статейку, буду изучать и пробовать :D
badbooy
Сообщения: 1
Зарегистрирован: 21.08.16 19:16

Как установить МОД для phpBB3 ?

Сообщение badbooy »

А как узнать, какие именно файлы затрагивает мод во время установки?
Shredder
Администратор
Сообщения: 1073
Зарегистрирован: 22.08.13 09:05
Благодарил (а): 133 раза
Поблагодарили: 264 раза
Контактная информация:

Как установить МОД для phpBB3 ?

Сообщение Shredder »

badbooy
Смотрите пункт №2 инструкции из первого сообщения. В секции Files to edit перечислены все оригинальные файлы движка, которые правит мод.
Мои моды и расширения для phpBB
Выполняю работы по phpBB3 на заказ. Пишите в личку или на почту.
Бесплатная поддержка - только в темах.
Alex4
Сообщения: 1
Зарегистрирован: 03.03.17 18:31

Не могу установить не один мод на phpbb3.2.

Сообщение Alex4 »

Никак не могу установить не один мод на phpbb3.2. Это мой первый форум, не ожидал, что форумы настолько сложнее сайтов!!! Три дня пытаюсь установить хоть один мод - уже мозги кипят, всё перепробовал. Скачиваю моды с https://www.phpbb.com/ и др. сайтов, стараюсь совместимые phpbb3.2. Следую инструкции в .xml файле - добавляю, меняю, делаю запросы к БД. В итоге мод в админке никогда не появляется-никакой (хотя конечно не все ещё моды испробовал). Пробовал также для каждого мода как написано в админке:

УСТАНОВКА РАСШИРЕНИЯ
Скачайте расширение из базы данных расширений phpBB
Разархивируйте расширение и закачайте файлы на сервер в папку ext/ конференции
Включите расширение здесь, в Управлении расширениями

Тоже без толку, ни один мод не появился...
Единственная надежда на то, что у меня где-то не так путь прописан - ставил форум без папки phpbb3, то есть http://site/public_html/файлы форума
В чём может быть ошибка/причина неудачи?
ghtktcnm
Сообщения: 1
Зарегистрирован: 25.05.18 21:58
Контактная информация:

Как установить МОД для phpBB3 ?

Сообщение ghtktcnm »

однако в старых модах допускались иные, произвольные наименования файла. Многие секции не являются обязательными, их наличие или отсутствие в инструкции определяется только конкретным модом, поэтому если вы не нашли какой-либо из описываемых далее секций - не пугайтесь, значит для установки этого мода она просто не нужна.
Святослав
Сообщения: 2
Зарегистрирован: 18.04.19 17:38

Как установить МОД для phpBB3 ?

Сообщение Святослав »

Спасибо, прочитал всё понял!

Удачного дня.
Ответить