MODxBB - Школа MODX

32516
Июль 2014

MODxBB интегрирует MODX и PhpBB друг в друга при сохранении масштабируемости.

Руководство по установке и настройке конфигурации MODxBB

Добро пожаловать в документацию MODxBB. Эта документация включена в пакет MODxBB, также вы можете ознакомиться с ней в Интернете на сайте modxbb.net/documentation.
Данное руководство связано с оглавлением на правой стороне, так же там есть информация о дате создания и последней модификации для каждой страницы. Эта информация позволяет быстро проверить, когда страница была обновлена. Кроме того, я создал файл CSS для вывода на печать, который должен пригодиться тем, кто предпочитает читать документацию на бумаге.

1. Документация MODxBB

1.1 MODxBB

MODxBB интегрирует MODX и PhpBB друг в друга при сохранении масштабируемости.
MODX является высоко настраиваемой системой управления контентом, которая также может быть использована в качестве основы для управления контентом.
PhpBB это очень мощная система управления веб-форумами, которая широко используется в качестве коммуникационной платформы, однако, она имеет значительный потенциал.
Администраторы, которые хотели бы использовать MODX PhpBB сталкиваются с проблемой, что пользователям придется дважды регистрироваться и поддерживать два аккаунта для одного сайта. Одна из главных целей MODxBB заключается в решении этой проблемы путем интеграции обеих систем друг в друга.
Это гораздо больше, чем просто мост для учетных записей пользователей. Используя MODxBB, разработчик может получить доступ к обоим интерфейсам на любой PhpBB странице, а также на любой странице MODX
Подробнее о MODxBB и его особенности можно прочитать в статье Добро пожаловать в MODxBB на modxbb.net.

1.2 Об этой документации

Этот документ получился гораздо подробнее, чем первоначально планировалось. Он предназначен для ознакомления даже неопытными пользователями, однако, необходимо отметить, что чем глубже ваши знания о (X) HTML, CSS и PHP, тем больше вы можете получить от использования MODxBB.
В этом руководстве рассматриваются все возможные типы установки, следовательно, вам не потребуется все это изучать. Дополнительные разделы начинаются с уведомления о том, когда они необходимы для чтения.
Несмотря на не слишком простую установку и настройку, после установки у вас не должно возникнуть проблем в использовании MODxBB. В будущих версиях планируется сделать интерфейс для упрощения установки и настройки.

1.3 Дополнительные учебники

Более подробные руководства, советы и примеры по различным темам, будут добавляться на блог modxbb.net позже.

2. Установка

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

- MODX Evolution 1.0.0 - 1.0.7 • рекомендуется: 1.0.7
- phpBB 3.0.4 - 3.0.11 • рекомендуется: 3.0.11
- MODxBB 0.9.5 (входит в комплект поставки)
- Веб-сервер для работы phpBB и MODX.

2.2 Установка MODX

Установите MODX Evolution. Если такая установка уже существует, настоятельно рекомендуется обновить до последней версии, если вы еще не сделали этого. На странице загрузки MODX вы можете узнать, какая версия является последней и загрузить ее при необходимости.
В процессе установки, вы должны поставить сайт в "Оффлайн" режим: Инструменты -> Конфигурация -> Статус сайта, выберите 'Оффлайн'.

2.3 Установка phpBB

Создайте в корне вашего сайта папку 'forum' (форум может быть установлен в любую папку, но папка 'forum' рекомендуется). Если у вас уже установлен phpBB, посетите страницу загрузки PhpBB, чтобы убедиться, что у вас последняя версия.

Настоятельно рекомендуется расположить папку 'forum' в корне сайта. Установка форума в другую папку должна выполняться только опытными пользователями. Если вы хотите, чтобы ваш форум был интегрирован в шаблон сайта, как это сделано на MODxBB.net, вам необходимо настроить основные шаблоны phpBB (overall_header и overall_footer). О том, как это делается, подробно описано в соответствующей ветке форума phpBB.com.

СОВЕТ: Некоторые браузеры имеют полезные инструменты (Firebug в Firefox или DragonFly в Opera), что может вам пригодиться при оформлении стиля вашего форума, потому что они облегчают работу с CSS. Я также рекомендую бесплатную утилиту Colour To HTML , так как она экономит массу времени при подборе необходимого цвета, которую требуется изменить в другой. (Color-picker -> find in CSS)

Еще один совет, который может сэкономить вам много времени: overall_header.html и overall_footer.html вместе взятые являются полной HTML-страницей. Вы можете их объединить (например в редакторе) для редактирования, и разделить снова, после того, как закончите редактирование.

Вставка PhpBB шаблона как часть шаблона или документа MODX, кстати, теоретически возможна, но не разумна.

2.4 Установка MODxBB

ПРИМЕЧАНИЕ: function_user.php входящий в пакет MODxBB содержит исправление ошибки в строке 2186 которое решает вопрос об аватарах галереи, не сортируемых должным образом. Я добавил это наряду с возможностью MODxBB использовать аватары галереи.

2.4.1 Резервное копирование

ВАЖНО: Сделайте резервное копирование всех файлов, которые будут заменены или отредактированы. Чтобы узнать, какие файлы были изменены при полной установке MODxBB, читайте страницу Список файлов или просмотрите папку "Documents" включая подпапки.

При желании вы можете сделать копию всего сайта, но это не обязательно. Файлы, которые будут перезаписаны (быстрая установка) или отредактированы (выборочная установка) можно найти в папке Documents в архиве MODxBB.

2.4.2 Минимальная установка

Если все, что вы хотите, это вывести чанки и сниппеты на вашем форуме, просто скопируйте файл modxapi.php (входящий в комплект MODxBB) в корень вашего сайта, и переходите к главе 2.4.6.

2.4.3 Быстрая установка

Есть три требования к быстрой установки:
1. PhpBB 3.0.11
2. MODX 1.0.7 Evo
3. Ни один из файлов, которые будут заменены не были изменены пользователем до этой установки (если вы не хотите потери внесенных изменений).

НЕ ЗАБУДЬТЕ ПРО РЕЗЕРВНОЕ КОПИРОВАНИЕ!

Просто скопируйте файлы из папки MODxBB\Documents в корень вашего сайта, сохранив структуру папок.

ПРИМЕЧАНИЕ: Это предполагает, что ваша папка форум называется "forum". Кроме того, если вы не хотите настроить стиль JOT в стиле MODxBB пропустите папку JOT.

2.4.4 Выборочная установка

Выборочная установка необходима, если вы используете устаревшую версию PhpBB или MODX, либо модифицированную версию, которую вы хотите сохранить или просто хотите знать, что было отредактировано при установке.
Я отказался от моего первоначального плана показать все вносимые изменения, назвав номера строк, потому что есть риск вас запутать. В зависимости от версии и количества модификаций добавленных пользователями, отличия в изменениях могут быть слишком велики.
Вместо этого мы будем использовать более безопасный и понятный способ: Посетим домашнюю страницу WinMerge и скачаем последнюю версию WinMerge. Это отличная бесплатная программа, которая может сравнивать файлы и показывать их различия. Linux и Mac пользователи могут найти альтернативы в этой статье .
Все, что нужно сделать сейчас, это сравнить файлы в папке "Original" с файлами в папке "Documents". Обратите внимание на различия и их расположение в файле. Не полагайтесь на номер строки! Вместо этого проверьте строки до и после изменений и включите их в то же место файла на вашем веб-сервере.

Пример:

После установки, запустите WinMerge и выберите в меню Файл -> Открыть, чтобы добавить файл index.php находится в папке "Documents", а также файл, который расположен в папке "Original", которые вы можете найти в архиве MODxBB. Теперь скачайте index.php вашего сайта и включите в него различия двух других файлов, которые показал WinMerge (не забудьте про резервные копии ваших файлов!). Когда закончите, загрузите отредактированный и сохраненный файл index.php в корень вашего сайта. Сделайте то же самое с другими файлами.

2.4.5 Установка элементов [сниппеты, плагин]

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

Название	Тип	Описание
LatestTopicsBB	сниппет	Отображает последние активные темы форума
LoginBB	сниппет	Регистрация в MODxBB и профиль авторизованного пользователя
OnlineListBB	сниппет	Показывает кто находится на сайте
PrevPollsBB	сниппет	Отображает историю опросов
SitePollBB	сниппет	Выводит PhpBB опросы на любой странице сайта
PluginBB	плагин	Связывает профили пользователей PhpBB с профилями веб-пользователей MODX

Более подробное описание, включая скриншоты можно найти на MODxBB.net.
Для установки любоuj из приведенных выше cybggtnjd, войдите в ваш менеджер MODX, перейдите по ссылке: Элементы -> Управление Элементами -> Сниппеты и нажмите кнопку "Новый сниппет". Название такое же, как имя файла или как в приведенном выше списке. Для описания введите <strong> 0.9.5 </ STRONG> , а затем введите описание из таблицы выше. Описание поможет распознать фрагмент, номера версии нужны для отличия от возможных будущих версий.
Теперь вставьте содержание соответствующего файла в код сниппета, файлы находятся в папке "Elements" в пакете MODxBB. Не забудьте сохранить сниппет!
Для установки плагина PluginBB перейдите в Элементы -> Управление Элементами -> Плагины и нажмите кнопку "Новый плагин"
Задайте название, описание и код как в примере выше.
Теперь нажмите на "Системные события" и активируйте флажки "OnUserFormRenter" и "OnWUsrFormRender". Сохраните плагин.

2.4.6 Настройка шаблонов phpBB

Тот, кто хочет разработать свой стиль форума настроив дизайн в соответствии с дизайном сайта, должен пройти шаги, описанные в разделе 2.3.
Следующий шаг необходим только тем, кто хочет разместить MODX элементы (сниппеты, чанки) или сообщения об ошибках MODX на форуме. Если вам это не нужно, вы можете перейти в раздел 3. Конфигурация.
Во-первых, откройте файл overall_header.html. Это может быть сделано в PhpBB администраторской панели управления (Общие -> Стили -> Шаблоны), либо путем поиска файлов в папке forum\styles\ВашаТема\template (при условии, что форум находится в папке "forum" и у вас установлена нужная тема). Затем добавьте следующие строки в начале этого файла:

<!-- PHP -->
if (!defined('ADMIN_START'))
{
	require_once($phpbb_root_path . '../modxapi.php');
}
else {
	require_once($phpbb_root_path . '../../modxapi.php');
}

global $modx;
$modx = new MODxAPI();
$modx->connect();
$modx->getSettings();
<!-- ENDPHP -->

Следующий шаг необходим только если вы хотите отображать сообщения об ошибке MODX на вашем форуме PhpBB.
Добавьте следующие строки в нижней части шаблона:

<!-- PHP -->
$MODx_output = '';
global $MODx_output;
if ($MODx_output) {
 echo $MODx_output;
}
<!-- ENDPHP -->

Теперь найдите файл overall_footer.html (находится в той же папке) и добавьте следующие строки в верхней части:

<!-- PHP -->
global $modx;
<!-- ENDPHP -->

3. Конфигурация

3.1 Настройка MODX

Если вы сделали минимальную установку, вы можете перейти к разделу 3.1.4.

3.1.1 Отключите WebLogin

Вы должны избавиться от регистрационной формы WebLogin если она у вас используется, потому что PhpBB заботится о регистрации пользователей и передает пользовательские данные в MODX. Для обеспечения авторизации и регистрации на ваших страницах MODX используйте сниппет LoginBB, который включен в пакет MODxBB.

3.1.2 Добавьте новое поле для Jot в таблицу MODX

Это необходимо, если вы хотите настроить JOT в стиле MODxBB, как показано на главной странице и на форуме MODX.
Войдите в свой PhpMyAdmin, выберите базу данных MODX и нажмите на modx_web_user_attributes (у вас может быть другой префикс, не modx_). Теперь нажмите на "Структура" (верхняя строка), перейдите к строке "Добавить" (в зависимости от темы PhpMyAdmin она может также быть в верхней части). Добавьте 1 поле, щелкните переключатель "В конец таблицы" нажмите ОК.
Теперь введите следующие значения:

Поле: postcount

Тип: Int (11)

По умолчанию: 0 [выбрать "Как определено:" из выпадающего списка]

Комментарии: jot comments

Нажмите кнопку Сохранить.

3.1.3 Выберите аватар по умолчанию для гостя в Jot

То же самое применимо и здесь: Это только необходимо если вы хотите использовать Jot в стиле MODxBB.
Откройте chunk.comment.inc.html в папке jot\templates (тот, который вы загрузили ранее) и заменить assets/images/YourDefaultAvatar.png в строке 8 на URL к аватару по умолчанию, и assets/images/YourGuestAvatar.png в строке 10 на URL к аватару по умолчанию для гостей.
Вы можете загружать аватары в папку assets или хранить их в другом месте, однако, чтобы сохранить согласованность, я рекомендую добавить аватар группе для гостей (анонимных пользователей) и для группы зарегистрированных пользователей в PhpBB и использовать их.
Вы можете сделать это в администраторской панели PhpBB (ACP) -> Пользователи и группы -> Управление группами - -> Настройки.

3.1.4 Добавьте ссылку на форум

Чтобы показать ссылку на Ваш форум в списках, созданных сниппетом Wayfinder и т.д. (например в карте сайта), Вы должны создать веб-ссылку на ваш форум. Это может быть сделано в менеджере MODX. Для получения дополнительной информации о том, как создать веб-ссылку, читайте документацию MODX или спрашивайте на форуме.

3.2 Конфигурация phpBB

3.2.1 Включите PHP в шаблонах

Это необходимо только, если вы хотите показать элементы MODX или сообщения об ошибках на вашем форуме, в противном случае переходите к главе 3.2.2 .

Войдите в администраторскую панель (АСР) PhpBB и нажмите на кнопку "Безопасность" в "Конфигурация сервера" на вкладке Общие. Выделите "Разрешить PHP в шаблонах:" и выберите "Да". Нажмите кнопку Отправить. Этот шаг необходим для обработки команд MODX, которые были ранее добавлены в шаблон PhpBB.

ВНИМАНИЕ: Не загружайте и не запускайте ненадежные PhpBB темы в то время, когда этот параметр включен! Вы должны загрузить темы только из phpBB.com или других надежных источников.

3.2.2 Убрать привязку форм к гостевым сессиям

Этот шаг необходим только если вы хотите, чтобы гости имели возможность проголосовать на ваших страницах MODX при использовании сниппета SitePollBB.
Идите на ту же страницу, как в 3.2.1 (ACP -> Общие -> Конфигурация сервера -> Безопасность) и найдите пункт "Привязать формы к гостевым сессиям:" (должен быть внизу). Измените значение на "Нет" и нажмите кнопку Отправить.

3.2.3 Перекомпилировать старые шаблоны

Этот шаг необходим, если вы планируете добавить чанки или сниппеты к PhpBB. Это гарантирует, что ваш форум распознает и отобразит визуальные изменения, сделанные вашими элементами MODX на форуме.
Войдите в свой PhpBB АСР. На вкладке Общие выделите вкладку "Конфигурация сервера" и нажмите "Нагрузка на сервер". Теперь нужно найти "Перекомпилировать старые шаблоны:" измените на "Да" и нажмите кнопку Отправить.

3.2.4 Добавление элементов MODX в шаблон PhpBB

Теперь вы можете добавлять команды для запуска MODX элементов (чанки, сниппеты) на форуме. Они могут быть добавлены в любой из шаблонов, которые мы редактировали в разделе 2.4.6 или любой другой шаблон, который принадлежит этой же теме, тем не менее, я рекомендую добавить их в нижней части overall_header.html.
Это эффективный способ показа объявлений на вашем форуме (но лично я не люблю объявления на форумах), как на MODxBB.net или чего-нибудь еще, что Вы хотите, чтобы ваши читатели форума увидели. Примеры: Чтобы запустить чанк MODX, который отображает объявления на вашем форуме, откройте overall_header.html расположенный в папке forum\styles\ВашаТема\template и добавьте следующие строки в нижней части шаблона, между тегами PHP, которые мы добавляли в разделе 2.4.6 :

echo $modx->getChunk('Announcement');

Где 'Announcement' имя вашего чанка.

Если вы добавляли в шаблон строки для вывода ошибок MODX, это будет выглядеть так:

<!-- PHP -->
echo $modx->getChunk('Announcement');
$MODx_output = '';
global $MODx_output;
if ($MODx_output) {
 echo $MODx_output;
}
<!-- ENDPHP -->

или так:

<!-- PHP -->
echo $modx->getChunk('Announcement');
<!-- ENDPHP -->

Вы можете также добавить это где-либо еще в пределах шаблона или в любом другом шаблоне.

Чтобы вставить сниппет, используйте:

echo $modx->runSnippet('SomeSnippet');

Если сниппет имеет параметры, мы поступим следующим образом:

echo $modx->runSnippet("MySnippet", array('column'=>'3', 'tpl'=>'MyTemplate')

Где 'column' и 'tpl' - параметры, а '3' и 'MyTemplate' - значения.

Для наглядности, вы можете создать массив:

$parameters['column']=3;
$parameters['tpl']=MyTemplate;

echo $modx->runSnippet('snippet_name', $parameters);

При размещении в шаблоне, не забывайте PHP теги:

<!-- PHP -->
$parameters['column']=3;
$parameters['tpl']=MyTemplate;

echo $modx->runSnippet('snippet_name', $parameters);
<!-- ENDPHP -->

3.3 Конфигурация элементов MODxBB

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

3.3.1 LatestTopicsBB

Есть три переменные, которые можно настроить в конфигурации этого сниппета. Первая $num_post определяет количество отображаемых статей, которые отображает этот сниппет. Во-вторых, $num_chars определяет количество символов, которые отображаются в каждой статье и, наконец, $DefaultAvatar позволяет установить аватар по умолчанию для пользователей, которые не установили аватар.

3.3.2 LoginBB

Есть два параметра, которые вы можете изменить. В качестве значения переменной $phpBB_folder в первом разделе содержатся имя главной папки форума. Если это, в соответствии с рекомендациями, папка «forum», оставьте значение переменной как есть.
Для настройки рангов пользователей прокрутите вниз до switch ($phpBB_rank). Здесь перечисленны визуальные отображения рангов, а цифры используются для идентифицирования рангов в PhpBB. Большая часть из этого очевидна, однако, будет статья о MODxBB.net, которая объяснит подробно работу системы рангов и групп в phpBB и MODxBB.

3.3.3 OnlineListBB

Этот сниппет также имеет параметр $phpBB_folder в первом абзаце, который должен быть изменен в случае, если папка вашего форума не называется «forum».
Если вы НЕ используете сниппет SitePollBB на той же странице, раскомментируйте, пожалуйста, второй абзац (удалив / * и * / ).

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

<script type="text/javascript" src="js/jquery-1.5.min.js"></script>

Это предполагает, что вы загрузили JQuery сценарий и скопировали его в папку "js". Имейте в виду, что вам, возможно, не нужно этого делать, если у вас уже есть подключенная библиотека JQuery. Вам также, возможно, придется установить режим совместимости, если вы используете библиотеку MooTools, например.

3.3.4 PrevPollsBB

Этот сниппет отображает историю опросов. Он может быть использован в качестве истории для опросов, которые были показаны SitePollBB или отдельно.
Если папка вашего форума отличается от папки по умолчанию, вы должны настроить ее и здесь. В первом абзаце найдите $phpbb_root_path и замените «forum» на имя папки вашего форума. Например, если ваша папка называется 'board', замените './forum/' на './board/' .
Существуют пять переменных, которые устанавливаются в разделе конфигурации (второй абзац). $forum_ids идентификаторы форумов, из которых необходимо брать опросы, указываются через запятую.

$ num_posts определяет максимальное количество отображаемых опросов.

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

$page_start стартовая страница при пагинации. Где request_var функция PhpBB, которая позволяет безопасно перейти к значению запроса. Рекомендуется оставить этот параметр без изменений.

3.3.5 SitePollBB

Конфигурация этого сниппета находится в файле poll.php , расположенном в папке modxbb, поставляется с пакетом MODxBB.

3.4 Настройка документов MODxBB

3.4.1 poll.php

Это основной двигатель для сниппета SitePollBB. Он содержит две переменных для его настройки.
Измените значение $prevpollID в строке 20, указав ID вашей MODX страницы, которая содержит сниппет PrevPollsBB подключенный к сниппету SitePollBB. Объяснение: Eсть ссылка "Предыдущие опросы" в сниппете SitePollBB, которая определяется здесь.
В строке 54 устанавливаются форум (ы), откуда берутся опросы для размещения на странице MODX, которая содержит SitePollBB. Вы можете выбрать один или несколько.
Например, если вы хотите отобразить последние опросы форумов с ID 12 и 13, необходимо изменить строку следующим образом: $CFG['poll_forum'] = array(12,13);
В строках 57-59 настраивается отображение BBCode, смайликов и URL-адресов.

3.4.2 edit.php

MODxBB поддерживает дополнительные поля PhpBB. Вы можете сделать так (но не обязательно), чтобы они отображались в профиле веб-пользователей MODX.
Для этого вам нужно настроить edit.php и signup.php оба расположены в папке modxbb. Пример с "fullname" уже включен туда. Если вы создаете пользовательский профиль в PhpBB с идентификацией по "fullname", вы автоматически получите значение для этого поля из профиля веб-пользователей MODX "Full name". Чтобы создать дополнительное поле, зайдите в АСР, на закладке "Пользователи и группы" нажмите "Дополнительные поля в профиле" в разделе Пользователи.
Этот файл управляет изменениями, которые сделаны в PhpBB и передает их в MODX, следовательно, дополнительные поля необходимо ввести отдельно, если вы хотите, чтобы они отобразились в профиле MODX. В строках 38-47 показано как это работает. Префикс pf_ всегда добавляется, остальное (здесь «fullname») поле идентификации пользовательского профиля.
Подробное руководство о том, как создавать и управлять дополнительными полями, в том числе, как изменить профили веб-пользователей в MODX будет позже опубликовано в блоге MODxBB.net.

3.4.3 signup.php

Второй файл, который необходимо изменить, если вы хотите добавить дополнительные поля в MODX и PhpBB является signup.php.
Строка 26 содержит пример для «fullname»:

$fields["fullname"] = $cp_data['pf_fullname'];

в этой строке параметру pf_fullname присваивается значение параметра fullname из таблицы MODX. Вы так же можете присвоить это значение любому другому параметру.

В строке 28 значение поля fone таблицы site_web_user_attributes присваивается значению поля user_id таблицы phpbb_users. Я выбрал этот путь для простоты. Можно, конечно, создать поле phpBB_ID в базе данных MODX или использовать любую другую область. Это используется для связи профилей PhpBB и MODX, таким образом, если вы используете другое поле, отличное от поля по умолчанию, нужно настроить плагин PluginBB (просто найти "phone" и заменить на нужное поле).

В строке 29 замените forum/download/file.php?avatar=g2_1266363854.png на URL для аватара по умолчанию (для пользователей, у которых нет аватара).

Если вы не хотите, чтобы новым пользователям отправлялось сообщение с приветствием, поставьте в начале строки 33 две черты //

3.4.4 welcome.php

Этот файл содержит текст сообщения, которое отправляется пользователям сразу после регистрации.
Как показано в строке 25, вы можете использовать $BridgeUser в качестве шаблона для ника получателя. Теоретически, можно использовать любые другие параметры, принадлежащие пользователю, значение которых хранится в MODX или PhpBB. Смайлики и BBcode также поддерживаются.
В строке 45 $fields["phone"] указывается идентификатор пользователя PhpBB. Если, как это описано в предыдущей главе, вы выбрали другое поле, укажите его вместо "phone".
Остальное должно быть понятным.

3.4.5 login.php

Убедитесь в том, что используете одинаковые параметры кодировки для поля username обеих систем (MODX и PhpBB). Рекомендуется кодировка utf8_unicode_ci, однако, если вы решите использовать другую кодировку, ее необходимо изменить в строке 88. Просто замените "utf8_unicode_ci" в этой строке названием вашей кодировки.

4. Общие советы и примечания

4.1 Использование CSS для настройки вывода сниппетов

Все элементы MODxBB поддерживают CSS и, таким образом, позволяют настраивать вывод. Рекомендуется использовать CSS-сброс, чтобы настроить одинаковое отображение во всех браузерах (это также общие рекомендации CSS, а не только MODxBB).

На странице CSS селекторы перечислены все селекторы, которые находятся в css файле. Эти значения идентичны тем, которые используются на MODxBB.net.

4.2 Вполне возможно иметь отдельный аватар для блога

Возможно использовать отдельные аватары для блогов (отличных от аватаров на форуме). То же самое касается любых других данных профиля. Поскольку изменения, которые вносятся в PhpBB в "Панели управления" будут отправлены в MODX, но не наоборот.

ВАЖНО: Если вручную внести изменения в административной панели управления АСР (например, имя пользователя), это должно быть сделано вручную и в MODX, так как это еще не автоматизировано в этой версии.

4.3 MODxBB позволяет настраивать содержание

Вы можете настроить индивидуальное содержание для каждого пользователя в соответствии с его уровнем или званием, или по другим критериям. Это относится и к свойствам в профиле.

Примеры:

- Можно создавать контент, который виден только зарегистрированным пользователям.

- Вы можете написать объявление, которое будет показано только пользователям с 1000 или более сообщениями или со специальным званием "Premium User" (специальные звания могут быть созданы в PhpBB ACP).

- Сообщение пользователям, которые празднуют свой день рождения с особым содержанием (например, баннер с поздравлением).

Подробное описание и примеры на эту тему будут размещены в блоге MODxBB.net позже.

4.4 Система аутентификации

Некоторые читатели могут спросить, почему бы просто не использовать только систему аутентификации PhpBB, раз PhpBB интегрировано таким образом на страницы MODX. Это действительно возможно, но если вы опустите аутентификацию в MODX, учетные записи пользователей на сайте MODX будет полностью непригодны для некоторых дополнений MODX. Это также включает в себя роли и права созданные в менеджере MODX.
Если для вас это не проблема, и вы знакомы с PHP, вам ни что не мешает это использовать. Все что вам нужно это отключение обновления параметров MODX.
Я напишу учебник по этой теме, если на него будет спрос.

4.5 PluginBB

Это всего лишь полезный инструмент, который может пригодиться в некоторых случаях. Вы можете открыть в окне административной панели MODX профиль phpBB. Если вы предпочитаете открытие в полном окне, просто откройте его в новой вкладке.

4.6 Журналы MODxBB

MODxBB генерирует журналы, которые можно прочитать в административной панели MODX (Отчеты -> Просмотр событий). Они окажут, как предполагается, помощь в поиске потенциальных проблем и попыток взлома. Наиболее важная информация показывается, без детального просмотра. Это экономит время и повышает читабельность. Ошибки входа в систему отображаются как «Тип ошибки - IP - Имя пользователя", где P - был введен неправильный пароль, а U - неверное имя пользователя.

4.7 Защита от спама

Эта тема непосредственно не связаны с MODxBB и PhpBB. Любой работающий форум, скорее всего, столкнется с проблемой спама. В частности, с начала этого года наблюдается увеличение спам-атак.
Существуют различные способы защитить форума от спама. Я первоначально планировал рассказать о некоторых из них здесь, но на phpBB.com уже есть полезные статьи об этом. Таким образом, я просто добавлю ссылки на эти статьи:

Preventing Spam in phpBB3 - Большинство из этих методов также применимы и для других платформ.

Spam Discussion - Дополнительные советы.

4.8 Использование Web2Manager при регистрации веб-пользователей

Когда пользователь регистрируется, MODxBB создает соответствующую учетную запись веб-пользователя в MODX. Web2Manager очень полезный плагин для управления веб-пользователями. Он также позволяет, создать учетную запись веб-пользователя из существующей учетной записи пользователя MODX. Существующие учетные записи будут обновлены.
Последнюю версию можно скачать здесь: Web2Manager-0.3.3.zip

5. Известные проблемы

5.1. Двойное голосование

В очень редких случаях обновление страницы с опросом может дать возможность проголосовать 2 раза. Это происходит только тогда, когда гости имеют право голоса и гости могут изменить свой выбор и может быть выбрано несколько вариантов ответа. Это очень маловероятно, но не невозможно.
Обходной путь: Просто удалите дополнительные опции.

5.2 Выход из LoginBB

Выход из системы в сниппете LoginBB перенаправляет на индексную страницу форума вместо возврата на ту же страницу, в отличии от входа в учетную запись, когда пользователь возвращается на ту же страницу.

Примечание: Это не ошибка. Чтобы вернуть пользователя на ту же страницу, которую он посетил, прежде чем выйти из системы, пришлось бы изменить файл ядра, в то время как пользователю в большинстве случаев все равно, куда он будет перенаправлен.

Решение: чтобы вернуть пользователя туда, где он находился при выходе из системы, вы должны внести изменения в функцию PhpBB meta_refresh.

5.3 Теги MODX

Специальные теги MODX ( [~ID~] ) не работают на страницах PhpBB. Это может быть исправлено в одной из будущих версий

MODxBB сниппеты: CSS селекторы

На этой странице представлены CSS-селекторы для настройки отображения сниппетов MODxBB.
Большинство из них говорят сами за себя. Я добавил комментарии, чтобы объяснить некоторые моменты. Значения и примеры идентичны тем, которые используются в файле CSS на сайте MODxBB.
По возможности, HTML теги используются вместо создания новых классов или идентификаторов, чтобы свести их число к минимуму .
Названия разделов описывают сниппеты, к которым они принадлежат. Они сортируются по порядку, в котором они появляются на сайте.

=============[ ПАНЕЛЬ ПОЛЬЗОВАТЕЛЯ ]=============

.loginbb {
    position:relative; 
    float:left;
    margin:0;
    padding:0 0 33px 0; 
}

.loginbb table {
    float:left;
    margin:0 0 0 21px;
    padding:0px;
}

.loginbb tr {
    float:left;
    width:243px;
    padding:3px;
}

.loginbb button {
    width:59px;
    height:23px;
    margin:3px 0 0 -3px;
    vertical-align:bottom !important;
}

.loginbb input:focus {
    outline:#7F91A1 dotted 2px;
}

.loginbb .leftbb {
    float:left;
    padding-top:5px;
}

.loginbb .buttonpanel {
    height:27px;
    margin-left:21px;
    padding-right:9px;
}

.buttonpanel .leftbb {
    padding:5px 18px 0px 0px;
}

.leftbb label {
    vertical-align:1px;
}

.loginbb .rightbb {
    float:right;
}

.loginbb .inputbb {
    border-right:2px white solid;
    border-bottom:2px white solid;
    border-left:1px Gray solid;
    border-top:1px Gray solid;
}

/* Класс privmsg используется для отображения в профиле пользователя информации о непрочитанных сообщениях в их почтовом ящике */

.privmsg {
    margin:3px 0;
    padding:2px 0 3px 0;
    border-top:2px #E6DBD8 solid;
    border-bottom:2px #E6DBD8 solid;
    background:#AF2525;
    font:normal small-caps 900 12px Arial, sans-serif;
}

.privmsg a:link, .privmsg a:visited {
    color:white;
    text-decoration:underline;
}

.privmsg a:hover {
    color:white;
    text-decoration:none;
}

.privmsg a:active {
    color:white;
    text-decoration:overline underline;
}

.privmsg span {
    font-variant:normal;
    letter-spacing:normal;
}

.userpanel {
    position:relative;
    float:left;
    margin:0;
    padding:0 0 33px 0; 
}

.userpanel table {
    float:left;
    margin-left:15px;
    padding:0px;
}

.userpanel tr {
    float:left;
    width:270px;
    padding:3px;
    vertical-align:middle;
}

.userpanel td {
    float:left;
    width:270px;
    border:1px #D3D3D3 solid;
    letter-spacing:normal;
}

.userpanel img {
    float:left;
    width:90px;
    height:90px;
}

.userpanel .userstats {
    position:relative;
    float:left;
    margin:0;
    padding:15px 0 0 3px;
    text-align:left;
    font:12px/110% Arial, sans-serif;
    letter-spacing:normal;
}

.userpanel .userstats .userlinks {
    line-height:15px;
}

.userpanel .username {
    color:#63463A;
    font:bold 16px/120% Arial, sans-serif;
}

============[ ИСТОРИЯ ОПРОСОВ ]============

/ * Они используются для нумерации страниц PrevPollsBB. Все остальные объекты этого сниппета используют селекторы Опроса Сайта * /

 .pagination {
    text-align:center;
}

.pagination a, .pagination strong {
    margin:0 3px;
}

==============[ ОПРОС САЙТА ]==============

.sitepoll {
    display:block;
    position:relative;
    float:left;
    width:100%;
    margin:0;
    padding:33px 0 83px;
}

.sitepoll h2 {
    margin-bottom:-9px;
}

.sitepoll table {
    width:100%;
}

.polloptions {
    letter-spacing:normal;
    width:auto;
    padding-right:0;
    padding-left:1px;
    margin-right:0;
    text-align:center;
}

/*. polloptions0 и.pollcount0 используются прежде, чем голосование сделано,
.polloptions и.pollcount после того, как голосование было сделано */

.polloptions0 {
    letter-spacing:1px;
    padding-left:9px;
    text-align:center;
}

.pollrow:hover {
    background:#A9CBD6;
}

.pollshare {
    margin:0;
    padding-right:0;
    width:auto;
    min-width:120px;
    letter-spacing:normal;
}

.pollshare div {
    margin:2px 0;
    padding:0;
    background:#A52A2A;
    text-align:center;
}

.pollcount {
    position:relative;
    float:right;
    margin-right:0;
    margin-left:-3px;
    width:21px;
}

.pollcount0 {
    position:relative;
    float:right;
    margin-right:5px;
    margin-left:-3px;
    width:21px;
}

.voted {
    position:relative;
    float:right;
    width:5px;
    color:#696969;
}

.maxvotes {
    line-height:21px;
    letter-spacing:normal;
    color:#696969;
}

.maxvotes strong {
    color:#635757;
    letter-spacing:1px;
}

.pollmsg {
    position:relative;
    float:left;
    width:210px;
    margin:7px 0 3px 9px;
    letter-spacing:normal;
}

.pollmsg0 {
    position:relative;
    float:none;
    width:210px;
    padding:3px 0 9px;
    letter-spacing:normal;
}

.errormsg {
    position:relative;
    float:left;
    width:210px;
    margin:7px 0 3px 9px;
    color:red;
    text-align:center;
    letter-spacing:normal;
    font-size:18px;
    font-weight:bold;
}

.submitvote {
    position:relative;
    float:right;
    width:auto;
    height:auto;
    margin:-1px 9px 3px 3px;
}

.submitvote button {
    width:59px;
    height:23px;
    margin-top:9px;
    vertical-align:bottom !important;
}

============[ ПОСЛЕДНИЕ ТЕМЫ ]============

/* Есть только один класс для этого сниппета. Для дальнейшей настройки
используйте html селекторы, как сделано ниже. */

.latestposts {
    width:295px;
    margin:0 0 0 7px;
    padding:33px 0 0px;
    text-align:left;
}

.latestposts h4 {
    text-align:center;
    padding-bottom:3px;
}

.latestposts div {
    margin-bottom:12px;
    padding:3px 0 3px 2px;
    border:1px #A1A1A1 dashed;
    overflow:hidden;
}

.latestposts p {
    display:block;
    position:relative;
    min-height:54px;
    margin:0;
    padding:0 1px 0 43px;
    color:#696969;
    font:italic normal normal 12px/normal Arial, sans-serif; 
    letter-spacing:normal;
}

.latestposts img {
    display:block;
    position:relative;
    float:left;
    height:33px;
    width:33px;
    border:1px #939393 solid;
    border-right:1px #4B4B4B solid;
    border-bottom:1px #4B4B4B solid;
}

============[ КТО СЕЙЧАС НА САЙТЕ ]============

#onlinebox {
    margin:-7px 0 0;
    padding:0 0 39px;
}

.onlineheader {
    font:12px/normal Calibri, Arial, sans-serif;
}

#onlinelist {
    position:relative;
    width:100%;
    height:0px;
    margin:0;
    padding:0;
    background:#CFBFB1;
    color:#fff;
    text-align:left;
    font-size:14px;
    overflow:hidden;
}

#onlinelist p {
    padding:5px;
}

/* span используется для легенды */

#onlinelist p span {
    font:italic normal normal 12px/normal Arial, sans-serif;
}

#onlinelist a:link, #onlinelist a:visited {
    color:#63463A;
    text-decoration:none;
}

#onlinelist a:hover {
    color:#7B91A5;
    text-decoration:underline;
}

#onlinelist a:active {
    color:#FFFFED;
    text-decoration:none;
}

Полный список файлов MODxBB

Ниже приведен список всех файлов, которые изменяются при установке MODxBB (первая таблица) или создаются (вторая таблица).
Список является полным, т.е. он справедлив для неограниченной полной установки.

Файлы, которые были изменены во время полной установки MODxBB

ИМЯ ФАЙЛА	ПУТЬ	ЧАСТЬ
index.php	./	MODx
actionlist.inc.php	./manager/includes	MODx
jot.class.inc.php	./assets/snippets/jot	JOT
jot.db.class.inc.php	./assets/snippets/jot/includes	JOT
chunk.comment.inc.html	./assets/snippets/jot/templates	JOT
chunk.form.inc.html	./assets/snippets/jot/templates	JOT
chunk.moderate.inc.html	./assets/snippets/jot/templates	JOT
chunk.subscribe.inc.html	./assets/snippets/jot/templates	JOT
jot.css	./assets/snippets/jot/templates	JOT
common.php	./forum	phpBB
ucp.php	./forum	phpBB
ucp_activate.php	./forum/includes/ucp	phpBB
ucp_remind.php	./forum/includes/ucp	phpBB
ucp_profile.php	./forum/includes/ucp	phpBB
functions_user.php	./forum/includes	phpBB
overall_header	./forum/styles/proglass/template	phpBB
overall_footer	./forum/styles/proglass/template	phpBB

Файлы и элементы, относящиеся к MODxBB

ИМЯ ФАЙЛА	ПУТЬ	ТИП
login.php	./modxbb	php file
signup.php	./modxbb	php file
edit.php	./modxbb	php file
delete.	./modxbb	php file
poll.php	./modxbb	php file
vote.php	./modxbb	php file
onlinelist.php	./modxbb	php file
LoginBB		snippet
PrevPollsBB		snippet
SitePollBB		snippet
LatestTopicsBB		snippet
OnlineListBB		snippet
PluginBB		plug-in
MODxBB		module

Copyright & Отказ от ответственности

Оба MODx и PhpBB это приложения с собственными и товарными знаками соответствующих владельцев.
MODx является зарегистрированной торговой маркой MODX Technologies, LLC .
PhpBB является продуктом PhpBB группы и выпущен под лицензией GPL .

MODxBB выпущен под лицензией MIT . Это означает, что вы можете делать практически все, что угодно с этим программным обеспечением, однако, все на свой страх и риск. Нет каких-либо гарантий и авторы MODxBB не несут ответственности за любой ущерб, убытки и т.д. Для более подробной информации прочитайте полную версию данной лицензии.

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

Ни одно животное не пострадало во время разработки, тестирования и выпуска этого продукта.

Развитие и история версий

Идея создания моста, который соединяет MODx и PhpBB появились в конце 2009 года.
MODx и PhpBB были основной проекта, однако, не было никакого программного обеспечения, которое бы их объединяло.
Мостом, сформированным еще в период развития их взаимной интеграции, и стал MODxBB, о чем было публично объявлено (предварительный просмотр) 9.9.2010 в первый раз. Первый публичный релиз был размещен 19.05.2011 года.

История версий

0.9.5 третья публичная версия
- обновление для PhpBB 3.0.11
- обновление для MODx Evo 1.0.7
- исправлено: 3 версии ошибки "log-out bug", при которых пользователь выходил из системы сразу после авторизации.
- исправлено: обратный порядок вариантов ответа в опросах на сайте и в истории опросов в сравнении с форумом.
- добавлено: отображение общего количества голосов в истории опросов.
- добавлено: новые зарегистрированные пользователи могут автоматически добавляться в группу "Registered Users" (по умолчанию отключено).
- улучшено: заменены все "echo" в сниппетах на "return".
- улучшено: уменьшение количества встроенных стилей в сниппетах.
- улучшено: несколько мелких исправлений и улучшений.

Релиз: 17 Декабря 2012

0.9.4 вторая публичная версия
- обновление для PhpBB 3.0.9
- LoginBB теперь работает на страницах PhpBB
- Неправомочные пользователи переадресовываются на 'несанкционированную страницу'
Релиз: 12 Июль 2011

0.9.3 первая публичная версия
Релиз: 19 Май 2011

Запланированные изменения

- Удобная инсталяция и настройка
- Поддержка [~ID~] на страницах PhpBB
- Исправление ошибок

MODxBB 0.9.5 Интеграция форума phpBB в MODX Evolution

Инструкция