Как устанавливать моды phpbb3

[DeaDRoMeO]

Перед тем, как устанавливать мод, сделайте копию редактируемых файлов и резервную копию Базы Данных !!!
Многие новички в phpbb3 сталкивались с проблемой установки модов на сей движок. В данной статье я попробую подробно все изложить.
Скачав дистрибутив любого мода и распаковав его, вы увидите следущую структуру папок и файлов

Папка мода
-1) папка contrib(не всегда присутствует)
-2) папка root
-3) файл install.xml(название этого файла либо такое либо аналогичное названию мода)
-4) файл license.txt
-5) файл modx.prosilver.en.xsl
-6) файл subsilver2.xml(иногда этот файл лежит в папке contrib)

Рассмотрим все по порядку.
1) папка contrib
В данной папке зачастую находятся инструкции для обновления версии мода, если он был ранее установлен. А так как это вводная статья, то это она подразумевает то, что у вас никаких версий модов не установлено. Значит в эту папку мы не лезем, кроме того случая если у вас стиль на основе Subsilver 2 и в папке мода нет файла subsilver2.xml.

2) папка root
В данной папке содержатся файлы мода, которые необходимо будет полностью скопировать в корень форума.
Примечание 1.
Копировать надо не саму папку root, а файлы и папки находящиеся в ней.
Примечание 2.
Если внутри папки root есть папка language, то обязательно проверьте в этой папке (language) наличие папки ru, ибо эта папка хранит в себе языковые файлы мода. Если папки ru нет, то создайте ее в ручную (в папке language) и скопируйте в нее все файлы из папки en(которая в свою очередь в любом случае будет в папке language). Для примера имеем вот что

Папка language
- Папка en
--- языковые файлы

а должно получиться так

Папка language
- Папка en
--- языковые файлы
- Папка ru
--- языковые файлы

3) файл install.xml
Открываем этот файлик через любой браузер и перед нашими глазами предстает инструкция по установке мода. В самом начале видим следущее

About this MOD
Title:Название мода
Description:Описание мода
Version:Версия мода
Installation level:Сложность установки
Installation time:Примерное время установки
Author notes:Примечание от автора

Далее идет список авторов с указанием их контактной информации. После этого в пункте Files to edit приводится список файлов, которые нам нужно редактировать. Ознакомляемся с ним и начинаем установку мода. Копируем все файлы из папки root в корень форума.
Примечание 3.
Более простыми словами корень форума это папка в которой лежит файл config.php.
Возвращаемся к инструкции. Всего могут быть 3 действия над редактируемым файлом(вернее над его содержимым)
--- 1) Найти и вставить после
Нам нужно найти указанный кусок текста и вставить после него код предложенный автором мода. Выглядит это в инструкции так(для примера)

Open: adm/style/acp_attachments.html (редактируемый файл)
Find(найти)

Tip: This may be a partial find and not the whole line.
Code:Select all

Код: Выделить всё

		<dl>
			<dt><label for="allow_in_pm">{L_ALLOW_IN_PM}:</label></dt>
			<dd><input type="checkbox" class="radio" id="allow_in_pm" name="allow_in_pm" value="1"<!-- IF ALLOW_IN_PM --> checked="checked"<!-- ENDIF --> /></dd>
		</dl>

Add after (добавить после него следущие строки)

Tip: Add these lines on a new blank line after the preceding line(s) to find.
Code:Select all

Код: Выделить всё

		<dl>
			<dt><label for="allow_in_pm">{L_ALLOW_IN_KB}:</label></dt>
			<dd><input type="checkbox" class="radio" id="allow_in_kb" name="allow_in_kb" value="1"<!-- IF ALLOW_IN_KB --> checked="checked"<!-- ENDIF --> /></dd>
		</dl>

------(Частный случай) Найти, найти в строке и вставить после

Open: adm/style/acp_attachments.html (редактируемый файл)
Find(найти)

Tip: This may be a partial find and not the whole line.
Code:Select all

Код: Выделить всё

<!-- ELSE --><br /><span>&raquo; {L_ALLOWED_IN_PM_POST}</span><!-- ENDIF -->

In-line Find(найти в строке)

Tip: This is a partial match of a line for in-line operations.
Code:Select all

Код: Выделить всё

<!-- ENDIF -->

In-line Add after (добавить после)

Code:Select all

Код: Выделить всё

<br /><span><!-- IF groups.S_ALLOWED_IN_KB -->&raquo; {L_ALLOW_IN_KB}<!-- ELSE -->&raquo; {L_NOT_ALLOWED_IN_KB}<!-- ENDIF --></span>

--- 2) Найти и вставить перед
Нам нужно найти указанный кусок текста и вставить перед ним код предложенный автором мода. Выглядит это в инструкции так(для примера)

Open: adm/style/acp_attachments.html (редактируемый файл)
Find(найти)

Tip: This may be a partial find and not the whole line.
Code:Select all

Код: Выделить всё

		<dl>
			<dt><label for="allow_in_pm">{L_ALLOW_IN_PM}:</label></dt>
			<dd><input type="checkbox" class="radio" id="allow_in_pm" name="allow_in_pm" value="1"<!-- IF ALLOW_IN_PM --> checked="checked"<!-- ENDIF --> /></dd>
		</dl>

Add before (добавить перед ним следущие строки)

Tip: Add these lines on a new blank line after the preceding line(s) to find.
Code:Select all

Код: Выделить всё

		<dl>
			<dt><label for="allow_in_pm">{L_ALLOW_IN_KB}:</label></dt>
			<dd><input type="checkbox" class="radio" id="allow_in_kb" name="allow_in_kb" value="1"<!-- IF ALLOW_IN_KB --> checked="checked"<!-- ENDIF --> /></dd>
		</dl>

------(Частный случай) Найти, найти в строке и вставить перед

Open: adm/style/acp_attachments.html (редактируемый файл)
Find(найти)

Tip: This may be a partial find and not the whole line.
Code:Select all

Код: Выделить всё

<!-- ELSE --><br /><span>&raquo; {L_ALLOWED_IN_PM_POST}</span><!-- ENDIF -->

In-line Find(найти в строке)

Tip: This is a partial match of a line for in-line operations.
Code:Select all

Код: Выделить всё

<!-- ENDIF -->

In-line Add before (добавить перед )

Code:Select all

Код: Выделить всё

<br /><span><!-- IF groups.S_ALLOWED_IN_KB -->&raquo; {L_ALLOW_IN_KB}<!-- ELSE -->&raquo; {L_NOT_ALLOWED_IN_KB}<!-- ENDIF --></span>

--- 3) Найти и заменить

Open: adm/style/acp_attachments.html (редактируемый файл)
Find(найти)

Tip: This may be a partial find and not the whole line.
Code:Select all

Код: Выделить всё

		<dl>
			<dt><label for="allow_in_pm">{L_ALLOW_IN_PM}:</label></dt>
			<dd><input type="checkbox" class="radio" id="allow_in_pm" name="allow_in_pm" value="1"<!-- IF ALLOW_IN_PM --> checked="checked"<!-- ENDIF --> /></dd>
		</dl>

Replace with ( заменить на )

Tip: Add these lines on a new blank line after the preceding line(s) to find.
Code:Select all

Код: Выделить всё

		<dl>
			<dt><label for="allow_in_pm">{L_ALLOW_IN_KB}:</label></dt>
			<dd><input type="checkbox" class="radio" id="allow_in_kb" name="allow_in_kb" value="1"<!-- IF ALLOW_IN_KB --> checked="checked"<!-- ENDIF --> /></dd>
		</dl>

------(Частный случай) Найти, найти в строке и заменить

Open: adm/style/acp_attachments.html (редактируемый файл)
Find(найти)

Tip: This may be a partial find and not the whole line.
Code:Select all

Код: Выделить всё

<!-- ELSE --><br /><span>&raquo; {L_ALLOWED_IN_PM_POST}</span><!-- ENDIF -->

In-line Find(найти в строке)

Tip: This is a partial match of a line for in-line operations.
Code:Select all

Код: Выделить всё

<!-- ENDIF -->

In-line Replace with ( заменить на )

Code:Select all

Код: Выделить всё

<br /><span><!-- IF groups.S_ALLOWED_IN_KB -->&raquo; {L_ALLOW_IN_KB}<!-- ELSE -->&raquo; {L_NOT_ALLOWED_IN_KB}<!-- ENDIF --></span>

По такой схеме и редактируются все файлы, которые требует мод. После редактирования, сохраняем эти файлы и копируем в точности туда откуда их брали. С этим не должно возникнуть трудностей ибо смотрите на примеры и делайте по инструкции.
Дополнительные инструкции после установки.
Многие моды не ограничиваются только правкой файлов, им нужно еще сделать запрос к Базе Данных либо что-то настроить в админке.
В случае необходимости запроса к Базе Данных в инструкции, в самом начале будет такой блок (для примера)

SQL(запрос)
Code:Select All

Код: Выделить всё

ALTER TABLE phpbb_forums ADD forum_subforumslist_type TINYINT(4) DEFAULT '0';

Чтобы его осуществить идем в хостинг-панель в программу phpMyAdmin. Выбираем пункт SQL, копируем текст запроса и отправляем.
Второй способ отправки запроса может быть автоматическим, тобишь нужно будет запустить какой то php-файлик. В инструкции будет следущий блок(для примера)

PHP install file(запуск инсталяционного файла)

There is a PHP install file that needs to be run in order to complete the installation.
To run it point your browser to, for example, domain.tld/phpBB3/kb.php
Code:Select All

Код: Выделить всё

kb.php

Это значит(опять таки это всего лишь пример) вам нужно зайти в браузере по адресу

http://ваш_сайт.ru/kb.php

и следовать дальнейшим инструкциям.
Прочие инструкции для завершения установки находятся в следущем блоке(для примера)

DIY Instructions

These are manual instructions that cannot be performed automatically. You should follow these instructions carefully.
Code:Select All

Код: Выделить всё

Purge cache. Create a dropdown box custom profile field.
		
Field identification: mood
("mood" name cannot be changed)
Field name/title presented to the user: Mood
("Mood" name name can be changed)

Entries: as seen below, 
?
Afraid
Alive и так далее

Все, мод установлен.
НЕ ЗАБЫВАЙТЕ ЧИСТИТЬ КЕШ ФОРУМА ЧЕРЕЗ АДМИНКУ ИБО НЕ УВИДИТЕ ПОЛУЧЕННЫХ ИЗМЕНЕНИЙ !!!
Файлы license.txt и modx.prosilver.en.xsl содержат в себе текст лицензионного соглашения и стили для кореектного отображения инструкции соответственно.
Вот, впрочем и все. Следуйте четко инструкциям и модификации будут устанавливаться без проблем

[DeaDRoMeO]

Тема прилеплена

[mixail]

Перед установкой мода открыл файл install.xml, по воду дополнений кодов вопросов не возникло все понятно, а как с этим SQL пока не понятно, открыл на хостинге-панель в программу phpMyAdmin. Можно ли из файла config.php взять данные
- Сервер:
- Пользователь:
- Пароль:
, что бы открыть phpMyAdmin...., а то не хочется запрашивать пароль за ново, что бы присылали на почту и т.д, я же для сохранения дапма брал и открывал, или это совсем, другое....

[DeaDRoMeO]

Да, разумеется из этого файла и нужно брать данные для входа в phpMyAdmin После того как в него зайдете, кликайте слева на имя своей БД и в верхних вкладках будет вкладка SQL жмете на нее, вставляете текст запроса и ОК

[mixail]

У меня вопрос такой, если устанавливаешь мод в ручную по инструкции и в инструкции есть, что надо делать запрос SQL в phpMyAdmin.

Если делаешь запрос SQL в phpMyAdmin и устанавливаешь потом мод как положено, но если например мод по каким, то причинам не установился и я принял решение его удалить и почистить все файлы, не влияет ли этот запрос SQL в phpMyAdmin в дальнейшей работе форума. Или потом надо, тоже, что то чистить в phpMyAdmin....

[DeaDRoMeO]

В большинстве случаев не влияет это на работу форума, так что можно не беспокоиться, а БД чистить только после прочтения кучи мануалов и предварительно сделать ее копию

[mixail]

А вы хоть раз уже чистили себе в БД phpMyAdmin....
И где можно почитать, как чистить БД...

[DeaDRoMeO]

Неа, пытался как то, не особо удачно, может быть позже и сделаю очистку, а пока это не мешает форуму

[mixail]

Сделал запрос в SQL в phpMyAdmin и вот, что пишут:

ALTER TABLE phpbb_forums ADD forum_last_poster_avatar VARCHAR( 255 ) COLLATE utf8_bin NOT NULL default '';# Затронуто 2 строки.

ALTER TABLE phpbb_forums ADD forum_last_poster_avatar_type tinyint(2) NOT NULL default '0';# Затронуто 2 строки.

ALTER TABLE phpbb_forums ADD forum_last_poster_avatar_width smallint(4) unsigned NOT NULL default '0';# Затронуто 2 строки.

ALTER TABLE phpbb_forums ADD forum_last_poster_avatar_height smallint(4) unsigned NOT NULL default '0';# Затронуто 2 строки.


ALTER TABLE phpbb_topics ADD topic_first_poster_avatar VARCHAR( 255 ) COLLATE utf8_bin NOT NULL default '';# Затронута 1 строка.

ALTER TABLE phpbb_topics ADD topic_first_poster_avatar_type tinyint(2) NOT NULL default '0';# Затронута 1 строка.

ALTER TABLE phpbb_topics ADD topic_first_poster_avatar_width smallint(4) unsigned NOT NULL default '0';# Затронута 1 строка.

ALTER TABLE phpbb_topics ADD topic_first_poster_avatar_height smallint(4) unsigned NOT NULL default '0';# Затронута 1 строка.


ALTER TABLE phpbb_topics ADD topic_last_poster_avatar VARCHAR( 255 ) COLLATE utf8_bin NOT NULL default '';# Затронута 1 строка.

ALTER TABLE phpbb_topics ADD topic_last_poster_avatar_type tinyint(2) NOT NULL default '0';# Затронута 1 строка.

ALTER TABLE phpbb_topics ADD topic_last_poster_avatar_width smallint(4) unsigned NOT NULL default '0';# Затронута 1 строка.

ALTER TABLE phpbb_topics ADD topic_last_poster_avatar_height smallint(4) unsigned NOT NULL default '0';# Затронута 1 строка.


INSERT INTO phpbb_config (config_name, config_value) VALUES ('enable_avatar_index', '1');# Затронута 1 строка.


Это, что запрос нормально установился или нет....

[DeaDRoMeO]

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

[Виктор Кузнецов]

Многие интересные моды застряли на старых версиях форума, и обновлять их никто не собирается. Что делать в этом случае? Опять править в ручную, или в случае с модами это не поможет?

[DeaDRoMeO]

С модами ситуация другая, в отличие от стилей, на версию форума 3.0.10 можно ставить спокойно моды, предназначенные для версий 3.0.6 и выше, моды не нуждаются в обновлении в соответствие к версии форума. У меня большинство модов установлено, которые предназначены даже для версии форума 3.0.0

[Виктор Кузнецов]

Ясно. Это хорошо.

[DeaDRoMeO]

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

[Виктор Кузнецов]

Кстати именно с такой проблемой я и столкнулся сегодня.
И дело не в том что я не могу найти кое, а в том что найденные куски во многом отличаются. Взял пожалуй самый легкий мод,

Код: Выделить всё

advanced_last_topic

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

Код: Выделить всё

$sql_array = phpbb_mods_advanced_last_topic_titles::inject_sql($sql_a

Поэтому приходится гадать, что там в конце после буквы "a"
То что это первая буква от слова "array" это понятно. А вот должно ли после еще что нибудь стоять, абсолютно непонятно

[Виктор Кузнецов]

Например в инструкции говориться, найти вот это.

Код: Выделить всё

$forum_rows[$parent_id]['forum_id_l ast_post']

И вставить это

Код: Выделить всё

$forum_rows = phpbb_mods_advanced_last_topic_

Опять же кончик кода не дописан.
Но как бы сильно не искал, нашел только это

Код: Выделить всё

$forum_rows[$parent_id]['forum_id_last_post'] = $row['forum_id'];

В принципе похоже, но есть продолжение в виде этого куска
= $row['forum_id'];
Вот я и запутался

[DeaDRoMeO]

В инструкции, на английском, всегда пишется что This may be a partial find and not the whole line. (Возможно это будет не полная строка, а лишь ее часть), тем более если по инструкции пишут Add before (Добавить перед), то и не совсем обязательно приводить полный код искомой строки

[Виктор Кузнецов]

я пока что сталкивался только с
Add after
А там очень даже важна полная строка кода.

[Виктор Кузнецов]

Кстати сделал русские кнопки для стиля X-static
Но они почему-то не светятся как ссылка при наведении на них курсора. Может из-за светлого цвета

A	Вложения удалены

[DeaDRoMeO]

я пока что сталкивался только с
Add after
А там очень даже важна полная строка кода.

Значит вставляете строго после найденного куска, ибо не всегда надо вставлять после строки, иногда надо вставлять код внутрь строки
Насчет кнопки - прописывать надо дополнительные стили в CSS