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

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

Комплексный компонент создает полноценный публичный интерфейс блогов и осуществляет импорт сообщений из 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-2020, «1С-Битрикс», 2020
    Наверх