Блоги (комплексный компонент)
Описание blog
Комплексный компонент создает полноценный публичный интерфейс блогов и осуществляет импорт сообщений из 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.
Компонент является стандартным и входит в дистрибутив модуля.
В структуре визуального редактора компонент расположен по пути Общение > Блоги > Блоги.
Компонент относится к модулю Блоги.
Параметры
Поле | Параметр | Описание | ||||||||||||||||||||
Внешний вид | ||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Количество сообщений, выводимых на страницу | 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] При отмеченной опции будет включена поддержка ЧПУ.
Если режим ЧПУ включен, то необходимо настроить следующие параметры
Если режим ЧПУ выключен, то необходимо настроить параметр VARIABLE_ALIASES
| ||||||||||||||||||||
Настройки кеширования | ||||||||||||||||||||||
Тип кеширования | CACHE_TYPE | Тип кеширования:
| ||||||||||||||||||||
Время кеширования (сек.) | CACHE_TIME | Время кеширования, указанное в секундах. | ||||||||||||||||||||
Время кеширования остальных страниц | CACHE_TIME_LONG | Указывается время кеширования страниц, начиная со второй. | ||||||||||||||||||||
Дополнительные настройки | ||||||||||||||||||||||
Путь к папке со смайликами относительно корня сайта | PATH_TO_SMILE | Указывается путь к папке со смайликами относительно корня сайта. По умолчанию задано /bitrix/images/blog/smile/. | ||||||||||||||||||||
Устанавливать заголовок страницы | SET_TITLE | [Y|N] При отмеченной опции в качестве заголовка страницы будет установлено Блоги. | ||||||||||||||||||||
Добавлять блог в цепочку навигации | SET_NAV_CHAIN | [Y|N] При отмеченной опции в цепочку навигации будет добавлен пункт с названием блога. | ||||||||||||||||||||
Использование SEO | SEO_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] При отмеченной опции транслитерация заголовка сообщения будет использоваться как его идентификатор; станет доступно
дополнительное поле
| ||||||||||||||||||||
Дополнительно | Для шаблона 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. При выборе данной опции станут доступны
дополнительные поля
| ||||||||||||||||||||
Шаблон пути к странице пользователя соцсети | 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 | Минимальное значение авторитета, при котором появляется возможность вставки ссылок в комментарии. |
Пример вызова
<?$APPLICATION->IncludeComponent( "bitrix:blog", "", Array( "THEME" => "blue", "GROUP_ID" => array("1"), "SHOW_NAVIGATION" => "Y", "USER_PROPERTY_NAME" => "", "PERIOD_NEW_TAGS" => "", "PERIOD" => "", "COLOR_TYPE" => "Y", "WIDTH" => "100%", "SEO_USER" => "Y", "NAME_TEMPLATE" => "#NOBR##LAST_NAME# #NAME##/NOBR#", "SHOW_LOGIN" => "Y", "USE_SHARE" => "Y", "SHARE_HIDE" => "Y", "SHARE_TEMPLATE" => "", "SHARE_HANDLERS" => array("delicious", "lj", "twitter"), "SHARE_SHORTEN_URL_LOGIN" => "", "SHARE_SHORTEN_URL_KEY" => "", "PATH_TO_SONET_USER_PROFILE" => "/club/user/#user_id#/", "PATH_TO_MESSAGES_CHAT" => "/club/messages/chat/#user_id#/", "ALLOW_POST_MOVE" => "Y", "PATH_TO_USER_POST" => "", "PATH_TO_USER_POST_EDIT" => "", "PATH_TO_USER_DRAFT" => "", "PATH_TO_USER_BLOG" => "", "PATH_TO_GROUP_POST" => "", "PATH_TO_GROUP_POST_EDIT" => "", "PATH_TO_GROUP_DRAFT" => "", "PATH_TO_GROUP_BLOG" => "", "SEF_MODE" => "Y", "PATH_TO_SMILE" => "/bitrix/images/blog/smile/", "CACHE_TYPE" => "A", "CACHE_TIME" => "3600", "SET_TITLE" => "Y", "CACHE_TIME_LONG" => "604800", "SET_NAV_CHAIN" => "Y", "SEO_USE" => "N", "MESSAGE_COUNT" => "25", "PERIOD_DAYS" => "30", "MESSAGE_COUNT_MAIN" => "6", "BLOG_COUNT_MAIN" => "6", "COMMENTS_COUNT" => "25", "MESSAGE_LENGTH" => "100", "BLOG_COUNT" => "20", "DATE_TIME_FORMAT" => "d.m.Y H:i:s", "NAV_TEMPLATE" => "", "USER_PROPERTY" => array(), "BLOG_PROPERTY" => array(), "BLOG_PROPERTY_LIST" => array(), "POST_PROPERTY" => array(), "POST_PROPERTY_LIST" => array(), "COMMENT_PROPERTY" => array(), "USE_ASC_PAGING" => "N", "NOT_USE_COMMENT_TITLE" => "Y", "SMILES_COUNT" => "4", "IMAGE_MAX_WIDTH" => "800", "IMAGE_MAX_HEIGHT" => "800", "EDITOR_RESIZABLE" => "Y", "EDITOR_DEFAULT_HEIGHT" => "300", "EDITOR_CODE_DEFAULT" => "N", "AJAX_POST" => "Y", "COMMENT_EDITOR_RESIZABLE" => "Y", "COMMENT_EDITOR_DEFAULT_HEIGHT" => "200", "COMMENT_EDITOR_CODE_DEFAULT" => "Y", "COMMENT_ALLOW_VIDEO" => "Y", "COMMENT_ALLOW_IMAGE_UPLOAD" => "A", "SHOW_SPAM" => "Y", "NO_URL_IN_COMMENTS_AUTHORITY" => "", "ALLOW_POST_CODE" => "Y", "USE_GOOGLE_CODE" => "Y", "SEF_FOLDER" => "/e-store/xml_catalog/", "SEF_URL_TEMPLATES" => Array( "index" => "index.php", "group" => "group/#group_id#/", "blog" => "#blog#/", "user" => "user/#user_id#/", "user_friends" => "friends/#user_id#/", "search" => "search.php", "user_settings" => "#blog#/user_settings.php", "user_settings_edit" => "#blog#/user_settings_edit.php?id=#user_id#", "group_edit" => "#blog#/group_edit.php", "blog_edit" => "#blog#/blog_edit.php", "category_edit" => "#blog#/category_edit.php", "post_edit" => "#blog#/post_edit.php?id=#post_id#", "draft" => "#blog#/draft.php", "moderation" => "#blog#/moderation.php", "trackback" => POST_FORM_ACTION_URI.'&blog=#blog#&id=#post_id#&page=trackback', "post" => "#blog#/#post_id#/", "post_rss" => "#blog#/rss/#type#/#post_id#", "rss" => "#blog#/rss/#type#", "rss_all" => "rss/#type#/#group_id#" ), "VARIABLE_ALIASES" => Array( "index" => Array(), "group" => Array(), "blog" => Array(), "user" => Array(), "user_friends" => Array(), "search" => Array(), "user_settings" => Array(), "user_settings_edit" => Array( "user_id" => "id" ), "group_edit" => Array(), "blog_edit" => Array(), "category_edit" => Array(), "post_edit" => Array( "post_id" => "id" ), "draft" => Array(), "moderation" => Array(), "trackback" => Array( "blog" => "blog", "post_id" => "id" ), "post" => Array(), "post_rss" => Array(), "rss" => Array(), "rss_all" => Array(), ) ) );?>