Модули в составе TextCMS
В TextCMS версии 0.97b включены следующие модули, которые могут использоваться в шаблонах сайта или в его страницах.
Модуль статей
Использование:
##block[articles,URL,Количество]#
Выводит список статей, в качестве которых рассматриваются страницы, вложенные в раздел, адрес которого передан в параметре URL. Статьи сортируются в соответствии с порядком, заданным в Центре Администрирования сайта. Если требуется вывести список статей текущего раздела, URL должен быть равен "./".
Количество — необязательный параметр, если он задан и не равен нулю, выводится только указанное количество статей из всех доступных.
Ссылка на каждую статью выводится в микроформате hAtom, где указывается название статьи, дата ее публикации, а также описание и автор, взятые из META-конструкций ##meta[description,описание]# и ##meta[author,автор]#, если таковые имеются в тексте статьи.
Модуль новостей
Использование:
##block[news,URL,количество]#
Выводит список новостей, в качестве которых рассматриваются страницы, вложенные в раздел, адрес которого передан в параметре URL. Новости сортируются по дате их создания по убыванию. Если требуется вывести список новостей текущего раздела, URL должен быть равен "./".
Количество — необязательный параметр, если он задан и не равен нулю, выводится только указанное количество статей из всех доступных.
Ссылка на каждую новость выводится в микроформате hAtom, где указывается название статьи и дата новости, а также описание, взятое из META-конструкции:
##meta[description,описание]#.
Модуль обратной связи
Использование:
##block[feedback,EMail,Шаблон,Сообщение]#
Выводит форму обратной связи (при наличии модуля captcha — с CAPTCHA-подтверждением).
EMail — адрес, на который будет отправлена форма (не обязательный параметр, если он не указан, форма отправляется на адрес, указанный как адрес администратора в «Настройках сайта»)
Шаблон — необязательный параметр, содержит имя файла шаблона, который используется для вывода формы. Если шаблон не указан явно, в качестве него используется feedback.htm. Файл с шаблоном должен находиться в templates/текущий_стиль_страницы/modules/feedback или в templates/default/modules/feedback. Внимание: неправильно указанный файл шаблона будет приводить к ошибке "Невозможно найти модуль" и неработоспособности формы обратной связи.
Сообщение — необязательный параметр, текст сообщения, которое выдается пользователю в случае успешной отправки формы.
Модуль меню
Использование:
##block[menu,URL,Глубина]#
Выводит меню в виде ненумерованного списка ссылок (конструкции вида <ul><li><a href="">..</a></li>...</ul>). Оформление этого списка (например, для приведения в горизонтальный вид) следует делать средствами CSS. Рекомендуется помещать меню в элемент с идентификатором (например, <div id="menu"><ul><li>...</li></ul></div>) и задавать правила для его отображения через этот идентификатор: #menu ul { ... }, #menu li { ... }, #menu a { .... }.
URL — раздел, подразделы которого следует выводить в меню. Для текущего раздела слеудет указыать "./", для корневого — "/".
Глубина — количество уровней, которые следует выводить в меню. Т.е. при глубине 1 выводятся только подразделы текущего раздела, при 2 — подразделы и их подразделы и т.д.
Модуль социальных сетей
Обеспечивает возможность добавления ссылки на текущую страницу в социальных сетях МойМир.Mail.Ru, Twitter, ВКонтакте, Facebook, а для двух последних -- вывода комментариев и списка участников указанной группы. Для возможности вывода комментариев требуется получить специальный идентфикатор на соответствующем сайте и ввести его в настройках TextCMS (на странице настроек есть ссылки на страницы в соц. сетях для получения этих идентификаторов).
Использование:
##block[social_vk_like,Тип_Кнопки]# ##block[social_vk_group,Группа,Ширина,Высота]# ##block[social_mail_like,Ширина,Список_аватаров, Текст]# ##block[social_twitter,Тип_кнопки]# ##block[social_fb_comments,Количество,Ширина]# ##block[social_fb_like,Ширина,Тип_кнопки,Список_аватаров]#
Блоки с like -- это вывод кнопок "Нравится" для соответствующей соцсети, блоки с comments -- вывод формы комментариев, блок social_vk_group -- вывод списка участников группы ВКонтакте. Параметры (все являются необязательными):
Ширина, Высота -- размеры блока в пикселях.
Количество -- количество комментариев, которое требуется выводить в блоке. По умолчанию равно 10.
Тип_Кнопки -- определяет способ отображения. Для ВКонтакте возможны варианты: full, button, mini, vertical. Для Twitter: horizontal, vertical, none. Для Facebook: standart, button_count, box_count.
Список_Аватаров -- нужно ли показывать аватары пользователей, которым понравился сайт. Логическое значение, может принимать 0 (нет) или 1 (да).