Cotonti - Доска объявлений

Модуль доски объявлений для CMF Cotonti.

Тип: Модуль
Версия: 3.0.3
Совместимость: Siena

GitHub: https://github.com/Alex300/advboard

 

Это расширение позволяет организовать доску объявлений на Вашем сайте под управлением Cotonti. Оно является полноценным модулем со своей таблицей объявлений в БД с поддержкой экстраполей и своей структурой категорий.

 

Системные требования и ограничения:

• Наличие на Вашем сайте установленной библиотеки Cotonti Lib версии 2.0.1 - 2.0.3
• В качестве шаблонизатора используется View

 

Установка:
- Скопировать модуль на сервер или склонировать репозиторий в папку modules/advboard
- Установить модуль из панели администратора
- В папке inc установить права на запись на файл 'send.txt'

 

Возможности:
   - подача объявлений на сайт
   - опциональное автоутверждение объявлений или премодерация для каждой категории
   - уведомление пользователя о новых комментариях к своему объявлению на e-email
   - уведомление пользователя об истечении срока публикации объявления на свой e-email
   - редактирование пользователем своих объявлений
   - незарегистрированные пользователи могут редактировать объявление в пределах сессии
   - "Мои объявления" в профиле пользователя
   - Список объявлений пользователя на странице его профиля
   - "Прилепленные" объявления выводятся сверху списка
   - Вывод списка последних объявлений
   - Виджет объявлений
   - Сравнение объявлений

 

Права пользователей:
Права пользователей зависят от прав на категории доски объявлений.
Дополнительные права:
1 - загрузка файлов
2 - автоутверждение объявлений.

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

Если пользователь не обладает правом 2 (Автоутверждение объявлений), то его объявления попадают на модерацию и без подверждения администратора не будут показаны другим пользователям.

 

Виджет объявлений:
Для вывода списка в произвольное место используется виджет advboard_controller_Widget::widget(). Объявлен в файле: modules/advboard/controller/Widget.php

Сам виджет имеет вид:

public static function widget($condition = array(), $tpl = 'advboard.widget.list', $items = 0, $order = '', $onlyActive = true, $pagination = 'pld', $params = array())

где:

$condition - SQL запрос для запроса объявлений
$tpl - файл шаблона для вывода
$items  - количество элементов для вывода
$order - порядок сортировки по правилам SQL
$onlyActive - Выводить только активные объявления
$pagination - параметр для постраничной навигации, если будет использоваться

Обратите внимание на то что в качестве шаблонизатора виджет использует View из Cotonti Lib а не coTemplate.

Подробнее понять его работу можно посмотрев код виджета.

 

Если Вы хотите вывести список в tpl-файле, то CoTemplate, в отличии от View не умеет работать с класами. В этом случае используйте виджет-обертку для этого метода advboard_widget(). см. modules/advboard/inc/advboard.functions.php

 

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

Вы можете создавать шаблоны уведомлений именуя файлы следующим образом: advboard.notify_admin_new.<lang>.<category>.php

 

Разное:

http://<ваш_домен>/advboard/unvalidated - объявления на модерации
http://<ваш_домен>/advboard/saved-drafts - неопубликованные (черновики)

Мои объявления: cot_url('advboard', array('m' => 'user'))
Объявления пользователя: cot_url('advboard', array('m' => 'user', 'uid' => $user_id))
Количество объявлений пользователя: cot_user_ads_count($user_id)

RSS лента: cot_url('advboard', 'm=rss&c=<код_категории>')

Если пользователю создать екстраполя phone и city (city_name), то он может использовать их, чтобы не заполнять в объявлениях одну и ту же информацию.

 

История изменений:

Версия v.3.0.3

• Исправление ошибок в работе виджета объявлений

Версия v.3.0.2

• Настраиваемый заголовок для главной страницы доски объявлений и первого элемента хлебных крошек.
• Улучшен виджет сравнения
• Совместимость с Cotonti Lib v2.0.1

Версия v.3.0.1

• Совместимость с Cotonti Lib v2.0.0

Версия v.3.0.0

• Расширение теперь полноценный модуль. Раньше оно было плагином.
• Добавлен функционал сравнения объявлений.
• Добавлен виджет для вывода обяъвлений в любых шаблонах сайта.

     Обратите внимание! Автоматическое обновление плагина (версии 2) до модуля (версии 3) невозможно.

Версия v.2.0.0

• Совместимость с Cotoni Siena.

 

GitHub: https://github.com/Alex300/advboard

 

Плагин версии 2