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

Блоги (комплексный компонент)

Комплексный компонент создает полноценный публичный интерфейс блогов и осуществляет импорт сообщений из Microsoft Word и Microsoft Live Writer и других редакторов в формате MetaWeblog.

В поставку продукта входят шесть шаблонов компонента: .default, general_page, general_page_old_version, old_version, one_blog, one_blog_old_version и one_blog_with_main_page.

Для режима ЧПУ страница импорта - /blog/metaweblog.php, а если режим ЧПУ отключен, то - /blog/index.php?page=metaweblog.

Компонент является стандартным и входит в дистрибутив модуля.

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

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

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

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

  • Внешний вид
  • Согласие пользователя
  • Управление адресами страниц
  • Настройки кеширования
  • Дополнительные настройки
  • Настройки комментариев
  • Описание параметров

    ПолеПараметрОписание
    Внешний вид
    Количество сообщений, выводимых на страницуMESSAGE_COUNTУказывается количество сообщений на странице. Остальные сообщения будут выведены с помощью постраничной навигации.
    Количество дней для выбора популярных сообщений и блоговPERIOD_DAYSУказывается количество дней для выбора популярных сообщений и блогов, которые будут отображены в разделе Популярные.
    Количество сообщений, выводимых на главной странице блоговMESSAGE_COUNT_MAINУказывается количество сообщений, отображаемых на главной странице блогов.
    Количество блогов, выводимых на главной странице блоговBLOG_COUNT_MAINУказывается количество блогов, отображаемых на главной странице блогов.
    Длина выводимых сообщений на главной странице блогов (символов)MESSAGE_LENGTHЗадается длина выводимых сообщений на главной странице блогов в символах.
    Количество блогов, выводимых на страницуBLOG_COUNTУказывается число блогов, отображаемых на одной странице. Остальные блоги будут выведены с помощью постраничной навигации.
    Формат показа даты и времениDATE_TIME_FORMATУказывается формат показа даты и времени. В выпадающем списке перечислены все возможные варианты показа даты, формируемые внутри компонента. Выбрав пункт (другое)->, можно сформировать свой вариант на основании php-функции date.
    Имя шаблона для постраничной навигацииNAV_TEMPLATEУказывается имя шаблона для постраничной навигации.
    Количество постоянно отображаемых смайловSMILES_COUNTУказывается количество постоянно отображаемых смайлов на странице. По умолчанию значение равно 4.
    Максимальная ширина изображенияIMAGE_MAX_WIDTHМаксимально допустимая ширина добавляемого в сообщение изображения (в пикселях).
    Максимальная высота изображенияIMAGE_MAX_HEIGHT Максимально допустимая высота добавляемого в сообщение изображения (в пикселях). 
    Разрешить изменять размер визуального редактораEDITOR_RESIZABLE[Y|N] При отмеченной опции будет возможность менять размеры окна визуального редактора.
    Высота визуального редактора по умолчанию (пикселей)EDITOR_DEFAULT_HEIGHTЗначение высоты визуального редактора при загрузке (в пикселях).
    По умолчанию показывать невизуальный режим редактораEDITOR_CODE_DEFAULT[Y|N] При отмеченной опции визуальный режим редактора не будет использоваться по умолчанию при создании сообщений.
    Согласие пользователя
    Запрашивать согласие USER_CONSENT [Y|N] Установленный флажок включает механизм согласия пользователя.
    Соглашение USER_CONSENT_ID Задается текст соглашения, которое отображается пользователю при заказе.
    Галка по умолчанию проставлена USER_CONSENT_IS_CHECKED Установка галочки автомаитчески устанавливает галочку в чекбоксе согласия пользователя. То есть согласие применяется одновременно с нажатием кнопки Оформить заказ.
    Загружать текст сразу USER_CONSENT_IS_LOADED Текст соглашения будет выводиться сразу. Если флажок не установлен, для просмотра текст нужно будет кликнуть по кнопке согласия.
    Управление адресами страниц
    Включить поддержку ЧПУSEF_MODE[Y|N] При отмеченной опции будет включена поддержка ЧПУ.
    Если режим ЧПУ включен, то необходимо настроить следующие параметры
    Каталог ЧПУ (относительно корня сайта)SEF_FOLDERУказывается путь к каталогу ЧПУ.
    Адреса страницSEF_URL_TEMPLATESУказываются адреса следующих страниц:
    • index - главная страница блогов
    • group - страница блогов группы
    • blog - страница блога
    • user - страница профайла пользователя
    • user_friends - страница ленты друзей пользователя
    • search - страница поиска по блогам
    • user_settings - страница настройки пользователей
    • user_settings_edit - страница настройки прав доступа пользователей
    • group_edit - страница настройки групп пользователей блога
    • blog_edit - страница редактирования блога
    • category_edit - страница настройки тегов блога
    • post_edit - страница редактирования сообщения
    • draft - страница недописанных сообщений
    • moderation - страница премодерируемых сообщений
    • trackback - Trackback адрес сообщения
    • post - страница с сообщением, показанным детально
    • post_rss - адрес комментариев к сообщению в RSS формате
    • rss - адрес блога в RSS формате
    • rss_all - сообщения всех блогов в RSS формате
    : SEF_FOLDER и SEF_URL_TEMPLATES.
    Если режим ЧПУ выключен, то необходимо настроить параметр VARIABLE_ALIASES
    Имена переменныхVARIABLE_ALIASESИмена переменных для управления страницами.
    .
    Настройки кеширования
    Тип кешированияCACHE_TYPEТип кеширования:
    • A - Авто + Управляемое: автоматически обновляет кеш компонентов в течение заданного времени или при изменении данных;
    • Y - Кешировать: для кеширования необходимо определить время кеширования;
    • N - Не кешировать: кеширования нет в любом случае.
    Время кеширования (сек.)CACHE_TIMEВремя кеширования, указанное в секундах.
    Время кеширования остальных страницCACHE_TIME_LONGУказывается время кеширования страниц, начиная со второй.
    Дополнительные настройки
    Путь к папке со смайликами относительно корня сайтаPATH_TO_SMILEУказывается путь к папке со смайликами относительно корня сайта. По умолчанию задано /bitrix/images/blog/smile/.
    Устанавливать заголовок страницыSET_TITLE[Y|N] При отмеченной опции в качестве заголовка страницы будет установлено Блоги.
    Добавлять блог в цепочку навигацииSET_NAV_CHAIN[Y|N] При отмеченной опции в цепочку навигации будет добавлен пункт с названием блога.
    Использование SEOSEO_USEВыбирается метод использования SEO:
    • не использовать;
    • отдельные поля для описания;
    • поля по умолчанию.
    Показывать доп. свойства в профилеUSER_PROPERTYУказываются дополнительные свойства, которые будут отображены в профиле пользователя блога.
    Показывать свойства в блогеBLOG_PROPERTYУказываются пользовательские свойства блога, которые необходимо дополнительно отобразить.
    Показывать пользовательские свойства блога в информации о блогеBLOG_PROPERTY_LISTУказываются дополнительные пользовательские свойства блога, которые необходимо отобразить в информации о блоге.
    Показывать пользовательские свойства сообщенияPOST_PROPERTYУказываются пользовательские свойства сообщения, которые будут отображены при детальном просмотре сообщения.
    Показывать пользовательские свойства сообщения в блогеPOST_PROPERTY_LISTУказываются дополнительные пользовательские свойства сообщения в блоге, которые необходимо отобразить в блоге.
    Показывать пользовательские свойства комментарияCOMMENT_PROPERTYУказываются пользовательские свойства комментария, которые необходимо отобразить в блоге.
    Использовать прямую постраничную навигацию для комментариевUSE_ASC_PAGING[Y|N] При отмеченной опции список комментариев будет выводиться постранично с прямой навигацией.
    Включить рейтинг SHOW_RATING Указывается, будет ли будет использован функционал рейтингов:
    • да;
    • нет;
    • по умолчанию - значение берется из настроек рейтингов.




    Примечание:

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

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

    Использовать символьный код сообщений как идентификаторALLOW_POST_CODE

    [Y|N] При отмеченной опции транслитерация заголовка сообщения будет использоваться как его идентификатор; станет доступно дополнительное поле
    Использовать внешний сервис для перевода кода сообщенийUSE_GOOGLE_CODE[Y|N] При отмеченной опции для перевода символьного кода сообщений будет использоваться сервис Google-переводчик.
    .
    ДополнительноДля шаблона old_version данная группа параметров не отображается.
    Тема шаблонаTHEMEУказывается цветовая тема, которая будет использоваться для интерфейса блогов. Данное поле доступно для шаблонов .default, general_page и one_blog.
    Группа блогов для отображенияGROUP_IDУказывается группа блогов, блоги которой будут отображены. Если не указано, то выборка производится по всем группам блогов. Данное поле доступно для шаблонов .default и general_page.
    Показывать строку навигации по блогамSHOW_NAVIGATION[Y|N] При отмеченной опции будет отображаться навигация по блогам. Данное поле доступно для шаблона .default.
    Название закладки с доп. свойствамиUSER_PROPERTY_NAMEУказывается название закладки с дополнительными свойствами. Данное поле доступно для шаблонов .default, one_blog, one_blog_old_version и one_blog_with_main_page.
    Период, в течение которого считать тег новым для облака тегов (дней)PERIOD_NEW_TAGSУказывается период (количество дней), в течение которого тег считается новым. Данное поле доступно для шаблона .default.
    Период выборки тегов (дней)PERIODУказывается период (количество дней), в течение которого осуществляется выборка тегов. Данное поле дотсупно для шаблона .default.
    Плавное изменение цвета для облака теговCOLOR_TYPE[Y|N] При отмеченной опции переход между цветами тегов будет плавным. Данное поле доступно для шаблона .default.
    Ширина облака тегов (пример: "100%" или "100px", "100pt", "100in")WIDTHУказывается ширина облака тегов (пример: "100%" или "100px", "100pt", "100in"). Данное поле доступно для шаблона .default.
    Запретить индексацию ссылки на профиль пользователя поисковыми ботамиSEO_USER[Y|N] При отмеченной опции поисковые боты не смогут индексировать ссылки на профиль пользователя. Данное поле доступно для шаблонов .default и general_page.
    Отображение имениNAME_TEMPLATEУказывается шаблон для отображения ФИО пользователя социальной сети. По умолчанию - значение Формат сайта (т.е используются значение Формат имени, указанное в закладке Параметры страницы Редактирование сайта). Указав пункт другое->, можно задать свой шаблон. Допустимы шаблоны: #NAME# - имя, #LAST_NAME# - фамилия, #SECOND_NAME# - отчество, #NAME_SHORT#, #LAST_NAME_SHORT#, #SECOND_NAME_SHORT# - сокращенные до одной буквы имя, фамилия и отчество. Данное поле доступно для шаблонов .default, general_page, one_blog и one_blog_with_main_page.
    Показывать логин, если не задано имяSHOW_LOGIN[Y|N] При отмеченной опции будет отображен логин пользователя, если не задано имя. Данное поле доступно для шаблонов .default, general_page, one_blog и one_blog_with_main_page.
    Отображать панель соц. закладокUSE_SHARE[Y|N] При отмеченной опции будет выведена панель соц. закладок на страницах со списком и на странице поста. Поле доступно в шаблонах: .default, general_page, one_blog, one_blog_with_main_page. При выборе данной опции станут доступны дополнительные поля
    Не раскрывать панель соц. закладок по умолчаниюSHARE_HIDE[Y|N] При отмеченной опции панель со значками соц. сетей будет скрыта по умолчанию. При работе с сайтом пользователь сможет развернуть ее.
    Шаблон компонента панели соц. закладок

    SHARE_TEMPLATE

    Если пусто, то будет использован шаблон по умолчанию. Можно создать свой шаблон.
    Используемые соц. закладки и сетиSHARE_HANDLERS[Y|N] В виде массива перечисляются соц.закладки и сети, которые требуется отобразить в выводимой панели. В виде кода пишется array("delicious","facebook","twitter","vk").
    Логин для bit.lySHARE_SHORTEN_URL_LOGINЗарегистрируйтесь на ресурсе http://bit.ly/ и введите ваш логин оттуда.
    Ключ для для bit.lySHARE_SHORTEN_URL_KEYПосле регистрации на ресурсе http://bit.ly/ вы получите API Key. Его необходимо ввести в данном поле. После проведенных настроек ссылка на ваш сайт будет автоматически укорачиваться средствами bit.ly и примет такой вид http://bit.ly/aLj59v. Данная технология применена к twitter, где критична длина сообщения.
    .
    Шаблон пути к странице пользователя соцсетиPATH_TO_SONET_USER_PROFILEУказывается путь к странице пользователя соцсети. По умолчанию задано /club/user/#user_id#/. Данное поле доступно для шаблона .default, general_page и one_blog_with_main_page.
    Шаблон пути к чату с пользователемPATH_TO_MESSAGES_CHATУказывается путь к странице чата с пользователем. По умолчанию задано /club/messages/chat/#user_id#/. Данное поле доступно для шаблона .default, general_page и one_blog_with_main_page.
    Разрешить перенос сообщений между блогамиALLOW_POST_MOVE[Y|N] При отмеченной опции будет разрешен перенос сообщений между блогами. Со включенной опцией вы сможете в режиме редактирования своего сообщения выбрать другой/другие блоги, где ваше сообщение будет также показано. Например, страница блога какой-либо группы или другого пользователя. Данное поле доступно для шаблона .default. При отмеченной опции необходимо определить значение шаблонов путей к различным страницам блога соц. сети. Поля описаны ниже.
    Шаблон пути к странице сообщения блога пользователя в соц. сетиPATH_TO_USER_POSTУказывается шаблон пути к странице сообщения блога. Например, /company/personal/user/#user_id#/blog/#post_id#/, где /company/personal/ - берется из настроек компонента Социальная сеть - пользователь (bitrix:socialnetwork_user), поле Каталог ЧПУ (относительно корня сайта), user/#user_id#/blog/#post_id#/ - там же, поле Страница сообщения блога пользователя.
    Шаблон пути к редактированию сообщения блога пользователя в соц. сетиPATH_TO_USER_POST_EDITУказывается шаблон пути к редактированию сообщения блога пользователя в соц. сети. Например, /company/personal/user/#user_id#/blog/edit/#post_id#/, где /company/personal/ - берется из настроек компонента Социальная сеть - пользователь (bitrix:socialnetwork_user), поле Каталог ЧПУ (относительно корня сайта), user/#user_id#/blog/edit/#post_id#/ - там же, поле Страница редактирования сообщения блога пользователя.
    Шаблон пути к черновикам блога пользователя в соц. сетиPATH_TO_USER_DRAFTУказывается шаблон пути к черновикам блога пользователя в соц. сети. Например, /company/personal/user/#user_id#/blog/draft/, где /company/personal/ - берется из настроек компонента Социальная сеть - пользователь (bitrix:socialnetwork_user), поле Каталог ЧПУ (относительно корня сайта), user/#user_id#/blog/draft/ - там же, поле Страница черновиков блога пользователя.
    Шаблон пути к блогу пользователя в соц. сетиPATH_TO_USER_BLOGУказывается шаблон пути к блогу пользователя в соц. сети. Например, /company/personal/user/#user_id#/blog/, где /company/personal/ - берется из настроек компонента Социальная сеть - пользователь (bitrix:socialnetwork_user), поле Каталог ЧПУ (относительно корня сайта), user/#user_id#/blog/ - там же, поле Страница блога пользователя.
    Шаблон пути к странице сообщения блога группы в соц. сетиPATH_TO_GROUP_POSTУказывается шаблон пути к странице сообщения блога группы в соц. сети. Например, /workgroups/group/#group_id#/blog/#post_id#/, где /workgroups/ - берется из настроек компонента Социальная сеть - группы (bitrix:socialnetwork_group), поле Каталог ЧПУ (относительно корня сайта), group/#group_id#/blog/#post_id#/ - там же, поле Страница сообщения блога группы.
    Шаблон пути к редактированию сообщения блога группы в соц. сетиPATH_TO_GROUP_POST_EDITУказывается шаблон пути к редактированию сообщения блога группы в соц. сети. Например, /workgroups/group/#group_id#/blog/edit/#post_id#/, где /workgroups/ - берется из настроек компонента Социальная сеть - группы (bitrix:socialnetwork_group), поле Каталог ЧПУ (относительно корня сайта), group/#group_id#/blog/edit/#post_id#/ - там же, поле Страница редактирования сообщения блога группы.
    Шаблон пути к черновикам блога группы в соц. сетиPATH_TO_GROUP_DRAFTУказывается шаблон пути к черновикам блога группы в соц. сети. Например, /workgroups/group/#group_id#/blog/draft/, где /workgroups/ - берется из настроек компонента Социальная сеть - группы (bitrix:socialnetwork_group), поле Каталог ЧПУ (относительно корня сайта), group/#group_id#/blog/draft/ - там же, поле Страница черновиков блога группы.
    Шаблон пути к блогу группы в соц. сетиPATH_TO_GROUP_BLOGУказывается шаблон пути к блогу группы в соц. сети. Например, /workgroups/group/#group_id#/blog/, где /workgroups/ - берется из настроек компонента Социальная сеть - группы (bitrix:socialnetwork_group), поле Каталог ЧПУ (относительно корня сайта), group/#group_id#/blog/ - там же, поле Страница блога группы.
    Настройки комментариев
    Количество комментариев к сообщению на страницеCOMMENTS_COUNTУказывается число комментариев к сообщению, выводимых на одной странице. Остальные комментарии будут выведены с помощью постраничной навигации.
    Выводить комментарии плоским спискомCOMMENTS_LIST_VIEWПри установке опции для вывода комментариев используется простой компонент blog.post.comment.list.
    Не использовать тему для комментариевNOT_USE_COMMENT_TITLE[Y|N] При отмеченной опции не будет использоваться Тема для комментариев сообщения блога.
    Использовать AJAX для постраничной навигации в комментарияхAJAX_PAGINATION[Y|N] При отмеченной опции будут обработаны и возвращены в массиве arResult только комментарии для текущей страницы.

    Внимание! при включении параметра может потребоваться внесение изменений в кастомный (не системый) шаблон.

    Разрешить изменять размер визуального редактора в комментарияхCOMMENT_EDITOR_RESIZABLE[Y|N] При отмеченной опции будет доступна возможность регулировать размер визуального редактора при создании комментариев.
    Высота визуального редактора по умолчанию (пикселей) в комментарияхCOMMENT_EDITOR_DEFAULT_HEIGHTНачальное значение высоты визуального редактора при написании комментария (пикселей).
    По умолчанию показывать невизуальный режим редактора в комментарияхCOMMENT_EDITOR_CODE_DEFAULT[Y|N] При отмеченной опции визуальный режим редактора не будет использоваться по умолчанию при создании комментариев.
    Разрешить вставку видео в комментарииCOMMENT_ALLOW_VIDEO [Y|N] При отмеченной опции появится возможность вставки видеороликов в комментарий.
    Разрешить загрузку изображений в комментарияхCOMMENT_ALLOW_IMAGE_UPLOAD Указывается, кому разрешено использовать в комментариях изображения (по умолчанию - Никому)
    • Всем;
    • Зарегистрированным пользователям;
    • Никому.
    Показывать администраторам ссылку на все комментарии пользователя

    SHOW_SPAM

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

    NO_URL_IN_COMMENTS

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

    • Никому;
    • Анонимным пользователям;
    • Всем.
    Минимальный авторитет, с которым пользователи могут вставлять ссылки в комментарииNO_URL_IN_COMMENTS_AUTHORITYМинимальное значение авторитета, при котором появляется возможность вставки ссылок в комментарии.


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

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

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

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

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