Инструкция для чайников по Community Builder

Возникает много вопросов по этому продукту. Здесь некоторые ответы на вопросы.


Установка:

Обычно Community Builder поставляется в zip-архиве, в котором лежат еще 4 zip-архива (с самим компонентом и тремя модулями), поэтому перед установкой не забудьте распаковать главный zip-архив.

Описание содержимого:
1. comprofiler.zip - архив самого компонента Community Builder
2. cblogin.zip - архив модуля авторизации. Стандартный джумловский модуль авторизации следует отключить.
3. mod_comprofileronline.zip - архив модуля "кто онлайн?" Он отобразит список зарегистрированных юзеров, находящихся в онлайне в виде ссылок на их анкеты.
4. mod_comprofilermoderator.zip - архив модуля для администратора. (напишу позже о нем)

Права на папки и файлы после установки на сервер:

1. administrator/components/com_comprofiler/ue_config.php - 777 Иначе Вы не сможете вносить изменения в настройки компонента.
2. images/comprofiler - 777 В эту папку будут грузиться фотографии юзеров.

Русификация:

Файлы с русским языком для версии CB 1.0.1 приаттачены внизу. Сожержимое архива нужно залить в components/com_comprofiler/plugin/language/default_language/

Ссылки вида "Link-Url", которые нужно будет создать в меню после установки компонента:

1. index.php?option=com_comprofiler&task=usersList - этот линк будет вести к юзер-листу (список всех зарегистрированных пользователей)
Здесь можно увидеть наглядно - http://www.serdcadetey.ru/component/option,com_comprofiler/task,usersList/Itemid,17/
2. index.php?option=com_comprofiler&task=userslist или index.php?option=com_comprofiler - приведет в собственную анкету.
Здесь можно увидеть наглядно - http://www.serdcadetey.ru/component/option,com_comprofiler/Itemid,57/

Примечание! Обратите внимание, что две выше приведенные ссылки почти одинаковы, но это не так. В первой  - usersList, а во второй - userslist. Разный регистр буквы L и это важно!

3. index.php?option=com_comprofiler&task=registers - приведет к форме регистрации.
Здесь можно увидеть наглядно - http://www.serdcadetey.ru/component/option,com_comprofiler/task,registers/Itemid,58

Административная панель, описание разделов компонента Community Builder:

1. User Management - раздел управления зарегистрированными пользователями.
Здесь Вы можете добавить, удалить, заблокировать юзера, одобрить его регистрацию, изменить его данные - в общем, аналог стандартного джумловского User Management'а.

2. Tab Management - раздел управления визуальным отображением информационных блоков в анкете юзера.
Все, что Вы видите в собственной и пользовательских анкетах выводится при помощи так называемых Tab. В настройках каждого из них можно указать каким образом он будет выводиться, в какой области экрана.
Плюс ко всему, зачастую параметры плагинов CB изменяются тоже в табах, которые создаются этими плагинами во время их установки.

Настройки таба:
Title: - заголовок таба, который будет отображаться и во фронтэнде. Если вы не хотите брать заголовок таба из языкового файла, то замените текст в этом поле на свой.
Description: - описание таба.
Publish: - опубликован или нет.
Position: - позиция таба во фронтэнде (если этот таб вообще должен там выводиться). К примеру, у нас есть четыре таба. Первый должен выводиться вверху на всю ширину экрана, два последующих таба - один слева (50%), второй справа (50%), четвертый таб - внизу, на всю ширину экрана. Тогда для первого таба выбираем позицию "Заголовок", для второго - "Левая сторона", для третьего - "Правая сторона", для четвертого - "Главная область" или "Нижняя область". Если вы хотите, чтобы левый таб был в ширину 30%, а правый - 70%, тогда зайдите в configuration CB, выберите закладку "Профиль пользователя" и в строке "2 columns layout: widths:" укажите нужный параметр для левого таба (правый сам растянется).
Display type: - внешний вид таба во фронтэнде. Здесь рекомендую самим поэксперементировать, выбирая различные параметры. 
Parameters - область, где обычно выставляются дополнительные параметры для табов.

3. Field Management - раздел управления полями для ввода информации, которые будут показаны во время регистрации, а также в анкете юзера.
Здесь у Вас появляется возможность редактировать как уже существующие поля для ввода информации (textarea, radio button и т.п.), так и создавать свои, а также указывать для них параметры их показа юзерам.
Параметры:
Required? - если "да", то поле становится обязательным для заполнения.
Show on Profile? - если "да", то поле будет отображаться в анкете юзера.
User Read Only? - если "да", то поле можно будет заполнить только один раз во время регистрации.
Show at Registration? - если "да", то поле будет видно во время регистрации.
Published - включает или выключает поле.

Внимание! Если вы создаете новое поле типа Drop Down (Single select) и хотите, чтобы оно выглядело, как выпадающее окошко, то не задавайте параметр Size.
В поле Description вводится текст, который будет отображаться в подсказке для поля (синенький кружочек с восклицательным знаком).

4. List Management - раздел настройки юзер-листов (списков пользователей).
Здесь Вы можете создать свой собственный юзер-лист.
Параметры:
Title - название юзер-листа.
Description - то, что будет отображаться в выпадающем списке выбора юзер-листов во фронтэнде (только в том случае, если опубликованных юзер-листов больше одного).
User Group to allow access to - группы пользователей, которым будет доступен для просмотра этот юзер-лист. Удерживая ctrl, можно выбрать несколько групп.
User Groups to Include in List - группы пользователей, которые будут отображаться в юзер-листе. Предположим Вам нужно, чтобы отображались только зарегистрированные и администраторы, тогда удерживая ctrl выбираем соответствующие группы в списке.
Published - опубликован лист или нет.
Default - сделать ли лист по умолчанию?
Sort By - сортировка в юзер-листе. Выберите нужный тип и нажмите add.
Filter - для тонкой настройки отображения списка пользователей - проще говоря, для выборки по определенному признаку или признакам. Например нам нужно вывести пользователей за последние 30 дней, тогда устанавливаем следующие парметры: DATE_SUB(CURDATE(), INTERVAL 30 DAY) <= `registerDate`


Далее вы видите три колонки с полями: слева, одно большое по центру и справа. Те, что слева и справа соответствуют одной из 4 колонок юзер-листа во фронтэнде, а та, что посередине - уже имеющимся полям в Field Managered. Думаю, дальше все понятно, как с этим управляться.

Вы можете создать несколько юзер-листов, с разными параметрами. Лист с параметром default станет главным. Дополнительные, опубликованные листы будут отображаться во фронтэнде в виде выпадающего списка (справа, вверху). К примеру можно сделать в добавок к основному листу еще два: в первом отобразятся женщины, во втором - мужчины.

5. Plugin Management - раздел дополнительных плагинов для CB. В этом же разделе происходит установка этих плагинов.

Внимание! Имейте ввиду, некоторые плагины после удаления оставляют след в базе данных (например, плагин ICQ статус) - это может быть причиной недоступности их повторной установки. Чистите базу данных.

6. Tools - дополнительные инструменты CB. После установки компонента следует сразу же выполнить Synchronize Users, тогда информация об уже зарегистрированных пользователях состыкуется с комунити билдером.
Если Вы хотите, чтобы в Field Managered добавились поля из стандартного компонента "Контакты", то нажмите на ссылку Load Sample Data.

7. Configuration - конфигурация компонента.

Настройка внешнего оформления:

Для начала уберем кнопочку community из личной анкеты. Для этого заходим в Tab Management и ищем tab с названием menu (меню). Справа, в "First Menu Name:", убираем все, что там есть и сохраняем. Все, кнопочка пропала.

Далее, все настройки стилей, производяться в файле components/com_comprofiler/plugin/templates/default/template.css (при условии, что именно эта тема оформления выбрана в настройках CB). Чтобы узнать, какой именно стиль нам нужно отредактировать, открываем интернет страничку в виде html-кода (меню браузера: вид->просмотр html кода) и ищем там текст (например пункты с данными в вашей анкете), смотрим на параметр class, а потом ищем этот class в нешем файле CB.

index.php?option=com_comprofiler&task=userslist не приводит в собственную анкету, а приводит в общую

Тогда оставь просто index.php?option=com_comprofiler

Workflow - это модуль администратора, позволяет черз него видеть, что надо одобрить (автар там и т.д.) так называемый рабочий модуль.