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

Введение. RUNCMS относится к системам, основанным на модульной модели представления данных. В подобных системах контент разделен на отдельные модули по типам содержимого. Структура данных зависит от модуля, и вся работа с контентом сосредоточена внутри модуля. Модули независимы и полностью отвечают за работу с контентом данного типа. Контент описывается с помощью фиксированного набора характеристик — тип контента строго фиксирован. Расширять функциональность можно за счет добавления нового модуля, замены или редактирования существующего кода.

Категории модулей

Все модули в RUNCMS можно разделить на три категории:

1. Системный модуль – это встроенный системный модуль, отвечающий за администрирование сайта. Данный модуль всегда активирован (установлен) и его нельзя удалить из системы или отключить.
2. Стандартные модули – модули, входящие в официальный установочный дистрибутив портала, эти модули считаются официальными модулями RUNCMS.
3. Модули сторонних разработчиков – все остальные написанные для RUNCMS модули.

Стандартные модули и модули сторонних разработчиков, по вашему желанию можно устанавливать в системе, удалять, отключать или же полностью удалять файлы модуля с сервера.

Расположение модулей

Администрирование.

Для того чтобы приступить к управлению модулями системы, вы должны зайти в панель администрирования сайта и перейти по ссылке:

"Панель управления" -> "Системное администрирование" -> "Управление модулями"

Основные настройки

Каждая из таблиц со списком модулей имеет следующие поля:

1. "активный" - модуль установлен, т.е. данные о нем занесены в базу данных, и он показывается на страницах сайта,
2. "не установлен" - модуль соответственно не установлен, данных о нем в базе данных нет,
3. «бездействующий» - модуль установлен в системе, но отключен, т.е. он не показывается на страницах сайта.

1. Без колонок – страницы модуля будут без правых и левых блоков.
2. Только слева – на страницах модуля не будет правых блоков
3. Только справа – на страницах модуля не будет левых блоков
4. Слева и справа – на страницах модуля можно размещать как правые, так и левые блоки.

1.      Редактировать - Переход на страницу редактирования дополнительных настроек конкретного модуля (только для установленных модулей).

2.      Информация – Кнопка открывает небольшое окошко с информацией о модуле, и содержит (если имеется) следующие данные: версию модуля, автора (его контактные данные), описание модуля, лицензию, кредиты и т.д.

Редактирование модуля

После перехода по ссылке редактировать откроется страница с информацией и настройками модуля. Большая часть из них повторяет опции главной страницы менеджера модулей, однако на данной странице можно установить доступ к этому модулю для разных групп пользователей, не заходя в специальный раздел по администрированию групп.

Перечислим вкратце содержание этой страницы:

Чтобы сохранить изменения, нужно нажать на кнопку «подтвердить»

Установка и удаление модуля

Как уже говорилось, модули располагаются в корневой директории /modules вашего сайта в отдельных папках, одноименных данному модулю. Модули, находящиеся в директории /modules отображаются в списке модулей на странице администрирования модулей. Для того чтобы установить модуль из этого списка в системе вы должны выбрать действие установка и нажать кнопку «подтвердить». Аналогично для удаления модуля выберите действие удаление. При удалении модуля будут удалены ВСЕ данные этого модуля. После установки модуля вам необходимо настроить права доступа к этому модулю для разных групп пользователей. Для этого вы должны или перейти в раздел администрирования групп сайта, или же зайти в свойства конкретного модуля, нажав на кнопку редактировать, данного модуля.

Установленный с «нуля» RUNCMS имеет только набор стандартных модулей. Существует большое количество разнообразных модулей сторонних разработчиков. Для того чтобы установить подобный новый модуль, вы должны вначале добавить требуемый модуль на сервер для дальнейшей его установки. Выше упоминалось, что все файлы конкретного модуля локализованы в одной папке - одноименной данному модулю. После того как вы скачали и разархивировали архив с требуемым модулем вы должны разместить папку с файлами конкретного модуля в директорию /modules, и только после этого переходить к его администрированию. Для размещения файлов модуля на сервер вы можете воспользоваться любым специализированным менеджером для работы с FTP, например CuteFTP, SmartFtp и т.д. или же любой другой программой поддерживающей передачу по FTP протоколу: FAR, Windows Commander и т.д. При переносе файлов модуля вам необходимо в точности сохранить структуру файлов модуля. Если в папке модуля имеется директория cache - вам необходимо устанавливаются chmod (права доступа) к ней и всем ее поддиректориям, равным 0777 (drwxrwxrwx), а на все файлы (кроме файлов index.html, их трогать не нужно) в директории cache и ее поддиректориях chmod (права доступа) должен быть равен 0666 (-rw-rw-rw-).

После размещения файлов модуля на сервер, данный модуль появится в списке модулей панели администрирования, и вы сможете приступить к его установке, как было описано выше.

Изменение имени модуля

Иногда возникает необходимость изменить название модуля, которое будет выведено в меню навигации. Для переименования модуля вам необходимо изменить переменную $modversion['name'] в файле xoops_version.php. Данный файл должен находиться в корневой папке модуля: /modules/(каталог модуля)/xoops_version.php.

Если значение $modversion['name'] представляет из себя константу, например _MI_NEWS_NAME (для модуля новостей), то название нужно менять в языковом файле modinfo.php расположенном в: /modules/(каталог модуля)/language/russian/modinfo.php

После внесения изменений в модуль, его нужно обновить.

05.07.2005 v.1.0
Copyright (c) 2005, Balnov Vladislav aka LARK. All rights reserved
Copyright (c) 2005, Ruscms.RU development group (http://www.runcms.ru). All rights reserved