Общий FAQ по nCatalogues - nCatalogues

Вся система каталогов в компоненте построена на Типах объектов.

На данный момент существует два типа объекта - это группа пользователей и каталоги объектов, которые также могут иметь статус системный тип объекта. Системный тип объекта отличается от обычного в перую очередь тем, что записи в него нельзя добавить "стандартным" способом, то есть через стандартный интерфейс сайта, и они как правило являются дочерними объектами.
Соответственно имеется три типа шаблонов.

Сами файлы всех типов  шаблонов хранятся в папке  <КОРЕНЬ_САЙТА>/components/com_ncatalogues/templates/

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

Рассмотрим шаблоны для каталога объектов.
Состоит из следующих файлов:
list_objects.php - тут храниться список объектов. По умолчанию, в виде таблицы, но список можно переделать как угодно, тут в основном работа верстки.
object_form.php - тут отображается форма для добавления новых записей или редактирования текущих записей(если конечно, в настройках самого каталога стоит галочка - Можно добавлять записи через сайт)
object_view.php - тут само детальное отображение самого объекта. По умолчанию настроено так, что если в поле не забита информация, то информация об этом поле не будет показываться на сайте.
pageNavigation.php - это по сути шаблон для отображения пейджинга страниц(стандартная джумловская не всегда устраивает)
search_form.php - это форма поиска.
list_categories.php - это список категорий для данного каталога. Имейте в виду для каждого каталога используется свой список категорий.

Замечание. Как правило, pageNavigation.php и search_form.php не используются отдельно, а вызываются через list_objects.php, ist_categories.php тоже может вызываться внутри шаблонного файла list_objects.php


Шаблоны для группы пользователей.
Состоит из следующих файлов:
Внутри шаблона имеются все те же файлы, что и в шаблоне каталога объектов, кроме list_categories.php, но в придачу еще следующие файлы

list_my_objects.php - в этом файле отображается список объектов каталога, которые добавил пользователь. Вызывается этот файл шаблона непосредственно в личном кабинете.
list_my_notepad.php - в этом файле отображается список объектов каталога, которые добавил в блокнот пользователь. Вызывается этот файл шаблона непосредственно в личном кабинете.

Шаблоны для дочерних(системных) каталогов.
Состоит из следующих файлов:
list_objects.php - тут храниться список объектов. По умолчанию, в виде таблицы, но список можно переделать как угодно, тут в основном работа верстки.
object_form.php - тут отображается форма для добавления новых записей или редактирования текущих записей(если конечно, в настройках самого каталога стоит галочка - Можно добавлять записи через сайт)
object_view.php - тут само детальное отображение самого объекта. По умолчанию настроено так, что если в поле не забита информация, то информация об этом поле не будет показываться на сайте.
Замечание. Содержимое файлов шаблона для дочерних каталогов и для простых каталогов - полностью отличаются, так как выполняют разные функции и у них свои особенности при добавлении и редактировании

Итак, как было сказано в основном топике в nCatalogues имеется 45 видов полей.
Управление полями осуществляется через админку компонента, каждый тип поля предназначен для своей определенной роли.
Подробнее описание каждого типа поля будет представлено чуть позже.

Сами файлы полей находятся тут <КОРЕНЬ_САЙТА>/administrator/components/com_ncatalogues/classes/fields/

В этих папках хранится вся информация по работе с полями.

Каждое поле содержит следующий набор полей:
form.php - этот файл используется для формы редактирования и создания нового объекта каталога
get_value.php - этот файл необходим, чтобы получить POST данные значения поля при сохранении объекта
parametrs.php  - здесь хранится информация о параметрах поля
view.php - этот файл необходим для отображения значения поля при подробном просмотре объекта
view_table.php - то же самое, но только при просмотре  в таблице
view_value.php - получить значение поля
requred_condition.php - этот файл нужен для генерации скрипта для проверки правильности ввода данных
global_script.php - особый параметр, он используется для полей, которые являются глобальными, от значений которых зависит будет использоваться дочернее поле или нет.
get_search.php - получить часть SQL запроса, для осуществления поиска по БД
search.php - почти такой же как и form.php, но используется для формы поиска.

Типы объектов
Типы объекты являются основным структурным элементом компонента

Всего два вида типов объектов: это каталоги различных объектов и группы пользователей.

Перейдем к описанию свойств типов объектов
Описание вкладок
1.Общая информация

• Имя - Название каталога или группы пользователей
• Фраза: Добавить новый объект  -  тут необходимо ввести текст, который будет шаблонным для типа объекта при создании новой записи
• Фраза: Редактировать объект  -  тут необходимо ввести текст, который будет шаблонным для типа объекта при редактировании записи
• Фраза: Параметры поиска  -  тут необходимо ввести текст, который будет шаблонным для типа объекта в форме поиска
• Название объекта, которое формируется из нескольких полей  -  это поле представляющее своеобразный шаблон, который используется для формирования общего названия объекта. Рассмотрим пример: у нас каталог автомобилей и мы хотим чтобы название записи состояло из нескольких полей: Марка модель год выпуска и объем двигателя, соответственно нужно будет ввести следующий код [nc_marka], [nc_model] [nc_year] г.в. [nc_vol] л.
  Где nc_marka, nc_model, nc_year, nc_vol - это названия полей в таблице MySQL  - названия эти можно увидеть разделе Поля компонента
  
  Примечание: у всех полей, которые должны попасть в заголовок объекта, должна обязательно стоять галочка "Поле видимо на сайте"
  
• Список емейлов, на которые отправлять уведомления о создании новых записей - тут указываем через запятую емейлы, на которые будут приходить уведомления о новых записях
• Группа типа объекта - это либо каталог объектов или группа пользователей
• Какие группы пользователей могут добавлять объекты  -  эта опция доступна только каталогов объектов.
• Можно добавлять новые записи на сайте  -  эта опция означает, что каталог может быть использован как доска объявлений. А если речь идет о группе пользователей - это означает, что данную группу пользователей гость сможет выбрать при регистрации на сайте
• Шаблон  -  выбрать нужный шаблон для типа объекта
• Ширина миниатюры изображения  -  это размер миниатюры для описания типа объекта
• Изображение  -  изображение типа объекта

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

Документация по типам объектам

3. Категории
В этой вкладке осуществляется управление категориями данного типа объекта.
Дерево категорий для каждого типа объекта свой.
Как таковой бывают такие каталоги, в которых структура каталогов вообще не нужна.
Поэтому использование или неиспользование системы категорий управляется опционально.
Также в этой вкладке можно задавать ширину миниатюры категории.
Далее тут же можно управлять может ли запись одновременно принадлежать к нескольким категориям или только к одной категории.

4. Условия оплаты
В типах объектов можно предусмотреть два вида системы оплаты.

• Это либо если само размещение платное
• Или создание размещения объявления в спецразмещении

Внимание все представленные изображения оптимизированы и уменьшены в размерах(НЕ БЕЗ ПОТЕРИ КАЧЕСТВА) дабы не загружать вас лишним трафиком
 
Поля нужны для описания объектов каталога, а также для описания пользователей групп пользователей.



Одно и то же поле может одновременно принадлежать нескольким разным каталогам, а также группам пользователей.
Например, поле Тип предложения для каталога недвижимости(которое имеет два значения Аренда и Продажа) может принадлежать и каталогу квартир и к каталогу гаражей и к каталогу Коттеджей и т.д. см рис. ниже



Итак, по порядку.
1)Название - у каждого поля должно быть название.
2)Название поля в таблице(англ.) - это название поля в таблице MySQL. При создании нового поля и присваивании его какому-либо каталогу в соответствующей таблице компонента создается новое поле с определенными характеристиками.
3)Тип поля  - я думаю, тут и так все понятно.
4)Группа полей - используется для группировки полей. Если у вас больше 100 полей - то будет значительно удобнее сортировать как-то поля по группам.
5)Порядок - это сортировка, порядок поля в общем списке внутри конкретной группы
6)Обязательное поле - без комментариев
7)Использовать это поле для меню - что это значит? Рассмотрим тот же каталог недвижимости - поле Тип предложения(которое имеет два значения Аренда и Продажа) и нам нужно создать два меню, в одном только Аренда, а в другом только Продажа. И вот для этого нам и нужен этот пункт меню. Он позволяет создавать такие меню.
8 )Глобальные поля - берем тот же каталог недвижимости и то же поле. Суть в том, что некоторые поля нужны только тогда, когда выбрана Аренда, а некоторые только когда Продажа. Это позволяет нам делать более универсальной форму для ввода информации, а также поиск  см рис. ниже





Настройки отображения
9)Показывать в таблице в админской части - это значит в общем списке в админке будет отображаться колонка с этим полем
10)Показывать в таблице сайта - аналогично для сайта
11)Поле видимо на сайте - это значит в форме добавления нового объекта - это поле видно на сайте
12)Поле видимо только в личном кабинете  - пока не используется
13)Показать заголовок на Front-End - размытая формулировка - но смысл ее в том, чтобы отображать или не отображать это поле в подробном просмотре объявления на сайте. см рис. ниже



Настройки поиска
14)Поиск в админке - это значит, что  будет поиск в админке по этому полю
15)Поиск на сайте -  это  значит, что будет поиск в сайте по этому полю
16)Поиск на сайте(сокращенная форма) - это значит, что поле в форме простого поиска на сайте
17)Точный поиск - если отмечена галка, то в SQL-запросе будет стоять условие РАВНО, иначе будет использован оператор LIKE(приблизительный поиск)
18)Порядок для поиска - порядок полей в форме поиска         см рис. ниже


Объекты
Тут выбираем типы объектов, для которых это поле создается           см рис. ниже


Глобальные поля
Если в системе есть глобальные поля, а наше текущее поле является зависимым от глобального поля, то ставим галочку напротив глобального поля и выбираем значение глобального поля.                  см рис. ниже

Упрощенно структуру компонента можно представить в виде блок-схемы



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

На типах объектов строится также и система пользователей компонента.
То есть существует две группы типов объектов - это группы пользователей и каталоги объектов.
Благодаря подобной особенности компонента для пользователей можно создавать такой же набор полей как и каталогов объектов.
Любая запись в каталоге объектов имеет привязку как к пользователям Joomla, так и к пользователям самого каталога, причем привязка к пользователям компонента является обязательной, поэтому важно включить плагин синхронизации пользователей. Необходимо, чтобы он первоначально создал пользователей в компоненте и нормально заработала привязка пользователей nCatalogues к  объектам каталога.
Подробнее по типам объектов можно тут прочитать
Далее, мы настраиваем поля
Документацию по полям можно прочитать тут

Всего существует 47 типов полей на данный момент

... теперь логично написать: ...например для каталога недвижимости: Тип объекта - квартира, ... и т.д. Тогда думаю будет более наглядно.

Вопрос: Как убрать Дату в общем списке объектов на Front'е
Ответ: Для этого нужно войти в шаблон list_objects.php и убрать там след. код

Для того, чтобы с фронта можно было добавлять объявления убедитесь, что в настройках данного типа объекта стоят как минимум 2 галочки