Документация для разработчиков
Недоступно в редакциях: Старт

Комментарии к сообщению

Компонент выводит комментарии к сообщению блога с возможностью добавления. Компонент стандартный и входит в дистрибутив модуля.

В структуре визуального редактора компонент расположен по пути Общение > Блоги > Комментарии к сообщению.

Компонент относится к модулю Блоги.

Пример вызова компонента blog.post.comment

Секции настроек компонента:

  • Источник данных
  • Внешний вид
  • Шаблоны ссылок
  • Настройки кеширования
  • Дополнительные настройки
  • Имена переменных
  • Описание параметров

    ПолеПараметрОписание
    Источник данных
    Идентификатор сообщенияIDУказывается код, в котором передается идентификатор сообщения блога.
    Адрес блогаBLOG_URLУказывается код, в котором передается идентификатор блога.
    Внешний вид
    Количество комментариев на страницеCOMMENTS_COUNTУказывается число комментариев, отображаемых на одной странице. Все комментарии будут выведены с помощью постраничной навигации.
    Формат показа даты и времениDATE_TIME_FORMATУказывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
    Количество постоянно отображаемых смайловSMILES_COUNTУказывается количество постоянно отображаемых смайлов в форме добавления комментария. Значение по умолчанию равно 4.
    Максимальная ширина изображенияIMAGE_MAX_WIDTH Максимально допустимая ширина добавляемого в комментарий изображения (в пикселях).
    Максимальная высота изображенияIMAGE_MAX_HEIGHT Максимально допустимая высота добавляемого в комментарий изображения (в пикселях). 
    Разрешить изменять размер визуального редактораEDITOR_RESIZABLE[Y|N] При отмеченной опции будет возможность менять размеры окна визуального редактора.
    Высота визуального редактора по умолчанию (в пикселях)EDITOR_DEFAULT_HEIGHTЗначение высоты визуального редактора при загрузке (в пикселях).
    По умолчанию показывать невизуальный режим редактораEDITOR_CODE_DEFAULT[Y|N] При отмеченной опции визуальный режим редактора не будет использоваться по умолчанию при создании сообщений.
    Шаблоны ссылок
    Шаблон пути к странице блогаPATH_TO_BLOGУказывается путь к главной странице блога. Например: blog_blog.php?page=blog&blog=#blog#.
    Шаблон пути к странице пользователя блогаPATH_TO_USERУказывается путь к странице профиля пользователя блога. Например: blog_user.php?page=user&user_id=#user_id#.
    Согласие пользователя
    Запрашивать согласие USER_CONSENT [Y|N] Установленный флажок включает механизм согласия пользователя.
    Соглашение USER_CONSENT_ID Задается текст соглашения, которое отображается пользователю при заказе.
    Галка по умолчанию проставлена USER_CONSENT_IS_CHECKED Установка галочки автомаитчески устанавливает галочку в чекбоксе согласия пользователя. То есть согласие применяется одновременно с нажатием кнопки Оформить заказ.
    Загружать текст сразу USER_CONSENT_IS_LOADED Текст соглашения будет выводиться сразу. Если флажок не установлен, для просмотра текст нужно будет кликнуть по кнопке согласия.
    Настройки кеширования
    Тип кешированияCACHE_TYPEТип кеширования:
    • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
    • Y - Кешировать: для кеширования необходимо определить время кеширования;
    • N - Не кешировать: кеширования нет в любом случае.
    Время кеширования (сек.)CACHE_TIMEВремя кеширования, указанное в секундах.
    Дополнительные настройки
    Путь к папке со смайликами относительно корня сайтаPATH_TO_SMILEУказывается путь к папке со смайликами относительно корня сайта.
    Использовать AJAX для комментариевAJAX_POST[Y|N] При отмеченной опции технология AJAX будет применяться при отправке комментариев.
    Упрощенный режим (без предварительного создания сообщения)SIMPLE_COMMENT[Y|N] При отмеченной опции будет использоваться упрощенный режим создания комментариев: комментарии можно создавать без сообщения (также используется в модуле Фотогалерея 2.0).
    Использовать прямую постраничную навигациюUSE_ASC_PAGING[Y|N] При отмеченной опции список комментариев будет выводиться постранично с прямой навигацией.
    Включить рейтинг SHOW_RATING Указывается, будет ли будет использован функционал рейтингов:
    • да;
    • нет;
    • по умолчанию - значение берется из настроек рейтингов.




    Примечание:

    С версии 17.6.0 добавлена поддержка рейтингов с реакциями.

    Вид кнопок рейтингаRATING_TYPEУказывается тип кнопок рейтинга:
    • по умолчанию;
    • Мне нравится (текстовый);
    • Мне нравится (графический);
    • Нравится / Не нравится (текстовый);
    • Нравится / Не нравится (графический).
    • Значение По умолчанию берется из настроек рейтингов.

    Разрешить вставку видеоALLOW_VIDEO[Y|N] При отмеченной опции добавится возможность вставки видороликов в комментарии.
    Показывать администраторам ссылку на все комментарии пользователяSHOW_SPAM[Y|N] При отмеченной опции администраторам будет доступна ссылка, по которой можно просмотреть все комментраии данного пользователя.
    Запретить вставку ссылокNO_URL_IN_COMMENTS

    Указывается, кому нельзя вставлять ссылки в комментарии (по умолчанию - Никому)

    • Никому;
    • Анонимным пользователям;
    • Всем.
    Минимальный авторитет, с которым пользователи могут вставлять ссылкиNO_URL_IN_COMMENTS_AUTHORITYМинимальное значение авторитета, при котором появляется возможность вставки ссылок в комментарии.
    Запретить индексацию ссылки на профиль пользователя поисковыми ботамиSEO_USER[Y|N] При отмеченной опции поисковые боты не смогут индексировать ссылки на профиль пользователя.
    Имена переменных
    Имя переменной для идентификатора блогаBLOG_VARУказывается имя переменной, которой передается идентификатор блога.
    Имя переменной для идентификатора сообщения блогаPOST_VARУказывается имя переменной, которой передается идентификатор сообщения блога.
    Имя переменной для идентификатора пользователя блогаUSER_VARУказывается имя переменной, которой передается идентификатор пользователя блога.
    Имя переменной для страницыPAGE_VARУказывается имя переменной, которой передается страница блога.
    Имя переменной для идентификатора комментарияCOMMENT_ID_VARУказывается имя переменной, которой передается идентификатор комментария блога.


    Пользовательские комментарии

    Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

    Для этого нужно всего лишь авторизоваться на сайте

    Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

    Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
    © «Битрикс», 2001-2019, «1С-Битрикс», 2019
    Наверх