Блоги (комплексный компонент)
Описание 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(), ) ) );?>
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.