Дополнительный модуль для RS-BLOG v2.8.0. Модуль Виджет

Но время пришло, и я решил все же дописать начатую заметку.

Сегодня на повестке дня, беглый разбор работы дополнительного модуля для системы RS-BLOG. Как понятно из названия поста, модуль называется "Виджет". Результат его работы Вы можете лицезреть на моем блоге. Видите с права картинку:

Данный блок был вставлен как раз с помощью данного дополнительного модуля. Модуль позволяет вставлять блоки с html кодом в сайтбар блога. Этот блок может быть списком, или, в моем случае, ссылкой на статью, или на чужой ресурс. В общем довольно простая и нужная штука.

Из чего состоит модуль?

Модуль можно поделить на две части.

1. Пользовательская часть
2. Админ часть

Пользовательская часть вытаскивает блоки из базы данных, вставляет их в шаблон и выводит на экран.

Админ часть добавляет список блоков, форму добавления и редактирования.

Технически все реализовано точно так же как и сама система. Есть папка moduls есть папка templates и есть файл index.php в котором прописаны условия вызовов нужных функций. По сути эта такая мини системка встроенная в основную систему.

Я думаю если у Вас будет желание разобраться как сие чудо работает, то Вам будет достаточно прогуляться по файлам которые Вы можете скачать в конце данной заметки.

А теперь давайте попробуем его поставить.

Ставим модуль виджета на систему RS-BLOG

Для начала спускаемся в низ заметки и качаем модуль. Теперь распаковываем его в папку /moduls/moremoduls/

Обратите внимание на пути, и на то, что в папке rs_widget находится не еще одна папка rs_widget, а именно файлы модуля.

После распаковки проходим в админ панель, в раздел настроек блога

Щелкаем по ссылке "Еще модули...".

Если Вы распаковали модуль правильно, то должны увидеть вот такое окошко

В общем то тут все ясно. Это табличка с описанием дополнительных модулей. Обратите внимание на колонку "Описание". В ней описано как вывести данные модуля в публичную часть блога. (кстати, данная информация берется из файла config.xml)

Для активации модуля нажмите на пустой кружочек

Если кружочек потемнел, значит модуль установился.

Для того что бы закончить установку, необходимо выполнить инструкцию описанную в описание модуля, а именно, зайти в пользовательский шаблон /templates/имя_шаблона/main.tpl.php, и прописать переменную вызова $rs_widget.

Я вставил данную переменную в сайтбар (правый блок) блога.

Одно маленькое предостережение. При активации модуля в БД создается таблица (код установщика можно поглядеть в файле installer.php), а при дезактивации модуля таблица будет удалена, стало быть все блоки, что Вы на создаете будут удалены.

Управление модулем

После установки, модуль должен появится в главной панели админки (при условии что данным модулем можно управлять. В config.xml есть параметр control, если у параметра стоит 1, значит у модуля есть панель управления. Если же там стоит 0, то панель не предусмотрена. Кстати обратите внимание, что у параметра installer, после установки модуля, стоит единица. Это означает что модуль активен. Если же стоит ноль - значит модуль не установлен)

В управление данным модулем не должно быть затруднений, но есть один момент, о котором Вы должны знать. У модуля есть два режима публикации блоков.

1. С шаблоном
2. Без шаблона

На моем блоге, блок информации опубликован без шаблона. Вот пример видов блока с шаблоном и без:

Так вот, в режиме публикации с шаблоном, модуль использует шаблон widget_y.tpl.php, который лежит вот в этой папке: /moduls/moremoduls/rs_widget/templates/. Данный шаблон необходимо подстраивать для каждой темы блога в ручную. То же в принципе касается и шаблона widget_n.tpl.php который используется в режиме "Без шаблона". По мне там геморроя совсем ничего, но может поставить в ступор человека который не понимает html

Заключение

В общем то на этом все.. Извиняюсь за долгий отклик на вопрос о модулях, и за то, что данный обзор из категории "Галопом по Европам", уж очень хочется после рабочего дня прилечь...

Ах, да.. Если будут какие то вопросы, оставляйте комментарии, будем думать

Прошу меня извинить, на этом все. Удачи Вам!

Модуль rs_widget