97987977878

  • 21 мая 2012 г.
  • 1526 Слова
Описание компонента wst:wst.comments (версия 1.0.5)

Разработка: Андрей Кондаков, http://kondakov.net, kqmyc@mail.ru

Версия документа 1.0 (27.06.2011)

1 Общие сведения

Данная компонента после установки размещается в пункте «Контент → [WST] Контент → [WST] Комментарии» меню компонент визуального редактора. Физически файлы компоненты копируются в пространство имен «wst» в папку/bitrix/components/wst/wst.comments. Размещенная на детальной странице элемента (простой, либо в составе комплексной), отображает для заданных групп пользователей форму комментирования элемента и список добавленных ранее комментариев. Id комментируемого элемента определяется автоматически и в обычном режиме и при включенном ЧПУ. Таком образом, на странице можно комментировать элемент из ЛЮБОГО инфоблока.Применена эффективная защита от автоматического спама (подробно http://www.manhunter.ru/webmaster/53_zaschita_ot_spama_na_saytah_i_forumah.html). Поддерживается редактирование комментариев в Эрмитаже. Можно включать премодерацию и уведомления на заданный е-мейл модератора. Поддерживаются глобальные аватары сервиса Gravatar и аватары из фотографий в профиле пользователей.


2Создание/редактирование инфоблока для хранения комментариев

После установки модуля содержащего компоненту, необходимо создать инфоблок со свойствами:
ARTICLE – тип «привязка к элементам» для хранения привязки к комментируемому элементу
GUESTNAME – тип «строка» для хранения имени неавторизованного посетителя
GUESTEMAIL - тип «строка» для хранения емейл неавторизованного посетителя
GUESTURL - тип «строка» для хранения адреса сайтанеавторизованного посетителя
Имена свойств могут быть другими, в этом случае укажите эти имена в соответствующих полях настроек компоненты. Можно не создавая новый инфоблок просто добавить эти свойства в уже существующий инфоблок, либо указать имена уже существующих свойств существующего инфоблока.


3 Параметры компоненты (настраиваются визуально)

USER_GROUPS – массив id групппользователей, которым разрешено добавлять комментарии.
NUM – количество комментариев на страницу для постраничной навигации (10 по умолчанию)
PUBLISH_MODE – режим добавления комментариев, возможные значения:
Y – сразу активировать (виден на сайте сразу после добавления)
N – премодерация — добавлять комментарий неактивным
MODER_MAIL – емейл для уведомлений о новых комментариях, если не задан, уведомления неотсылаются.
IBLOCK_ID — id инфоблока комментариев
COMMENTED_ELEMENT_PROP — имя свойства типа «привязка к элементам» для хранения привязки к комментируемому элементу (по-умолчанию «ARTICLE»)
GUEST_NAME_PROP — имя свойства типа тип «строка» для хранения имени неавторизованного посетителя (по-умолчанию «GUESTNAME»)
GUESTE_MAIL_PROP — имя свойства типа «строка» для хранения емейл неавторизованного посетителя(по-умолчанию «GUESTEMAIL»)
GUEST_URL_PROP — имя свойства типа «строка» для хранения адреса сайта неавторизованного посетителя (по-умолчанию «GUESTURL»)

AVATARS_TYPE — способ отображения аватаров, возможные значения:
GRAVATAR – по емейл пользователя определять и отображать глобальный аватар с сервиса Gravatar.com (по-умолчанию)
USER_PHOTO – то же самое, но сначала пробовать взять для аватараизображение из профиля пользователя (поле «PERSONAL_PHOTO»)
NONE – не использовать аватары
AVATARS_SIZE – размер аватара в пикселях. Приводится минимально к 1 пкс, максимально к 512 пкс. (ширина=высота, по-умолчанию 32 пкс)
PAGER_TITLE — заголовок для постраничной навигации (по-умолчанию «Страница»)
PAGER_TEMPLATE — тут можно задать имя шаблона для вывода постраничной навигации (по-умолчаниюпустое значение - используется системный шаблон)
CACHE_TYPE – тип кэширования компоненты: A – авто+управляемое, Y – всегда, N – не кэшировать.
CACHE_TIME – время кэширования в секундах
VARIABLE_ALIASES — имена параметров адресной строки, которые содержат id элемента и id раздела комментируемого элемента (по-умолчанию «ELEMENT_ID» и «SECTION_ID»)....
tracking img