Рассмотрим установку стандарного модуля в портал E-Xoops. Дается описание установки с наглядными примерами на уже установленный и работающий портал и с описанием всех необходимых действий для полной установки требуемого модуля.
Для начала необходимо выбрать модуль для установки это могут быть модули как уже входящие в комплект стандартной установки E-Xoops(глава 2), так и внешние модули созданные сторонними разработчиками. Если расматривать второй вариант установки то для начала нам требуется добавить требуемый модуль на сервер для дальнейшей установки.
Глава 1. Установка модуля на сервер.
Перед установкой модуля на сервер нам требуется архив с самим устанавливаемым модулем и конечно же уже работающая версия портала. Любые необходимые модули для вашего портала можно найти на этом сайте в архиве файлов или на соответствующих сайтах в интернет.
После того как вы скачали и разархивировали архив с требуемым модулем мы должны получить директорию с нашим модулем со структурой аналогичной структуре показанной справа или похожей на неё.
Рассмотрим структуру устанавливаемого модуля взяв в качестве примера модуль Архив файлов или Downloads:
mydownloads - Корневая директория модуля в которой содержаться все файлы и директории модуля. Название модуля всегда разное, mydownloads в статье для примера.
admin - Файлы которые требуются для управления работы модуля, в основном файлы для администрации.
blocks - Файлы которые необходимы для работы блоков которые могут быть подключены к порталу и работать для отображения контента устанавливаемого модуля.
cache - Файлы кеша в которые заносится необходимая для работы модуля информация или контент который используется в работе модуля (например для архива файлов это сами файлы архива)
images - Файлы изображений которые используются в данном модуле.
include - Выполняемые файлы скрипта данного модуля.
language - Языковые файлы при помощи которые ведется отображение текстовой информации в модуле.
sql - Данные для базы данных MySql которые требуются для дальнейшей установки модуля на портал.
Также существуют файлы в корневой директории модуля, при помощи которых отображаются данные работы модуля.
В зависимости от устанавливаемого модуля структура модуля может различаться от приведенной выше
Дальнешие наши действия для установки модуля это копирование каталога с нашим устанавливаемым модулем на ваш сервер в папку с модулями портала modules/ при помощи любого менеджера для работы по ftp. Например при помощи программы SmartFtp нужно выполнить следующие действия:
Открыть директорию с модулями в которой содержаться все модули системы.
Нам необходима директория modules/ в которой и храняться все установленные модули системы как активные так и не активные. Путь к папке modules/ может быть различным в зависимости от вашей установки портала E-Xoops например вашсайт/modules или вашсайт/e-xoops/modules если вы устанавливали портал в конкретную папку.
Перенести/скопировать нашу папку с устанавливаемым модулем в папку модулей modules/ как это сделанно на рисунке справа. При переносе файлов модуля нам необходимо сохранить структуру файлов модуля, а также не допустить битых файлов в директории модуля которые могут появиться по нескольким причинам, например: если при загрузке файлов модуля был обрыв связи.
Эти два условия - сохранение структуры модуля и проверка на наличие битых файлов после переноса модуля на ваш сервер являются одними из основных требований для правильной и устойчивой работы как модуля так и портала в целом, поэтому стоит относится к этому со всем возможным вниманием.
Последняя и заключительная часть это установка прав на доступ к файлам для папки cache в директории модуля.
Для этого на директорию cache устанавливаются права 0777 на поддериктории cache также устанавливаются права 0777, на все файлы в директории cache и поддерикториях cache необходимо выставлять права 0666 кроме файлов index.html их трогать не следует для общей безопасности системы.
Теперь установка модуля на сервер закончена и можно переходить к активации модуля через System Admin, но перед этим хочу выделить несколько важных аспектов установки модуля на сервер для его стабильной работы:
!
Обязательно сохранить структуру модуля!
Проверить и еще раз проверить модуль на предмет битых файлов которые могли появиться при переносе модуля на сервер. Во многих случаях причиной нестабильной работы модуля являются именно битые файлы.
Установить права на доступ к папке cache. При неправильных установках на доступ к папке cache в основном и возникают ошибки подобные: нет возможности загрузить скриншот, сохранить файл(данные) или просто сохранить конфигурацию модуля.
Глава 2. Активация модуля на сервере.
Теперь можно перейти к активации нашего устанавливаемого модуля через раздел системного администрирования портала E-Xoops. Для этого нам необходимо зайти на наш сайт используя обозреватель и авторизоваться под учетной записью администратора портала.
Затем пройти в раздел системного администрирования который доступен по ссылке Меню администрирования в блоке пользователя или по ссылке http://www.вашсайт.ru/admin.php или http://www.вашсайт.ru/e-xoops/admin.php в зависимости от типа установки который вы выбрали для вашего портала. Затем пройти в раздел управления модулями системы System Admin -> Модули. Итак мы видим список всех модулей которые находтся в папке modules/ портала. Сверху у нас активированные модули системы, ниже модули которые являются неактивными на данный момент и не используются. Они то нам и нужны.
Дальнейшие наши действия это активация необходимого нам модуля. Для этого напротив модуля который требуется установить следует выбрать в поле Действие -> Установка.
Также не следует забывать про поле Порядок при помощи него можно указывать положение модуля в нашем динмаическом меню портала. Например модуль с порядком 1 будет показан выше чем модуль с порядком 2, а соответственно модуль с порядком 3 будет показан ниже мудуля с порядком 2. Данный порядок возможно настроить конкретно для вашего для сайта. Также необходимо настроить порядок отображения для всех активных модулей для того чтобы динамическое меню вашего портала не перемешивалось случайным образом при открытии разных страниц портала. Порядок 0 существует для скрытия ссылок на модули в динамическом меню если это требуется.
Далее. Мы закончили с установкой порядка для отображения модулей в динамическом меню и выбрали модули которые необходимо установить из списка неактивных модулей. Можно нажать на кнопку "Отослать". Система запросит подтверждение на производимые действия и покажет список производимых изменений. Если все устраивает то подтверждаем наш запрос. Теперь необходимые выбранные модули из списка неактивных стали активными и устновлены в системе. Они появились слева в разделе администрирования и готовы к работе.
!
Но теперь мы подходим к разделу установка распределения прав на доступ к модулям сайта о котором многие пользователи просто забывают и как следствие неактивность установленного модуля для групп пользователей отличных от администрации. В результате получается портал настроенный под одного пользователя - администратора, и мы наблюдаем что-то похожее на разговор с самим собой :)
?
Почему это происходит? - все предельно просто, администратор портала как глава сайта при установке любого модуля сразу имеет права на доступ к только что установленному модулю и работу с ним, другие же группы пользователей такой возможности не имеют и для них доступ нужно выставлять вручную через раздел Группы пользователей.
Глава 3. Установка распределения прав на доступ к блокам и модулям сайта.
Для того чтобы утсановить права на доступ к модулю для различных групп пользователей в категории System Admin раздела администрации выбрать пункт Группы пользователей. Для сведения - пройти в данный раздел можно сразу после активации модуля или изменения установок уже установленных модулей кликнув на ссылке Изменить права доступа к модулю. В разделе Группы пользователей виден список имеющихся на портале групп пользователей, если вы не производили никаких изменений то он будет точно таким как на картинке справа. Рассмотрим стандартные группы пользователей которые существуют сразу после установки портала и с которыми мы будем работать.
webmaster - Администратор портала, это ваша группа и если портал только недавно установлен то скорее всего пользователем этой группы являетесь только вы хотя есть возможность добавить дополнительных администраторов по желанию, помните только что у них будут те же права что и у вас.
Registered Users - Пользователи которые прошли регистрацию на портале. Если на портале установлена опция подтверждения учетной записи по e-mail то это пользователи которые уже подтвердили свою учетную запись.
Anonymous Users - Группа анонимных пользователей. Тоесть пользователи не имеющие регистрации на портале(гости), или неавторизованные пользователи.
!
Возможно на вашем портале существуют другие группы пользователей которые не перечисленны выше. Тогда это группы которые создали вы или другой администратор портала и необходимо для активации только что установленного модуля как и всех имеющихся на портале модулей указать права на доступ и в этих созданных вами группах.
!
Также существует группа пользователей которые не принадлежат ни к одной из вышеперечисленных групп, это пользователи с неактивированной регистрацией(когда на портале активированна функция подтверждения регистрации через e-mail или ручное подтверждение администратором), возможные действия с этой группой пользователей можно узнать в статье "Чистим базы пользователей".
Вернемся к распределению прав на наш только что установленный модуль. При переходе в настройки любой из уже существующих групп нас интересуют разделы которые показанны на рисунке справа. Это Права админа и Права доступа, за что отвечают эти разделы:
Права админа При помощи этого раздела мы можем дать определенной группе пользователей все права администратора для конкретного модуля. У пользователя этих групп появится раздел портала подобный администраторской, но в состав которого входят только модули на которые у данной группы включены права на администрирование. Хочу заметить что у данных пользователей будут все права на удаление, исправление и любые действия с контентом который содержится в данном модуле, поэтому не следует использовать данную возможность необдуманно.
Права доступа Это собственно раздел который отвечает за отображение модулей для конкретных групп пользователей. И наш только что установленный модуль необходимо отметить галочкой для того чтобы пользователи определенной группы имели доступ к нему и он не являлся модулем "только для администрации".
В данном случае существует множество возможностей каким группам давать доступ к каким модулям. Это каждый должен решать для себя сам в зависимости от своего сайта и тематики портала. Приведу один пример как можно разграничить права на доступ к модулю для групп пользователей на основе того же модуля Downloads.
Права доступа на данный модуль стоят только для групп Registered Users и webmasters, для группы Anonymous Users галочка снята и у пользователей этой группы доступа к данному модулю нет. В итоге Гости или пользователи группы Anonymous Users не имеют доступа в раздел файлов и им приходится регистрироваться для получения доступа к этому разделу. Для пользователей групп Registered Users и webmasters раздел активен и для этих групп пользователей к нему существует полный доступ.
Глава 4. Заключительная.
Итак мы рассмотрели весь путь от работы с архивом модуля до его полной установки на портал E-Xoops. Основными пунктами на которые стоит обратить внимание помечены красным восклицательным знаком.
Также хочется еще раз отметить все что описанно в третьей главе как настройки которые многие начинающие пользователи E-Xoops забывают и из-за этого возникает большое колличество вопросов по неправильной работе модулей системы.
Все примеры и скриншоты были сделаны с локального сайта E-Xoops и могут отличаться от вашего сайта в плане колличества пунктов и установленных модулей, но отличаться не принципиально.