Документация InstantCMS

для администраторов и разработчиков

Инструменты пользователя

Инструменты сайта


manual:install

Установка InstantCMS 2

Загрузите дистрибутив InstantCMS с официального сайта.

Распакуйте загруженный архив и загрузите его содержимое на сервер, в корневую директорию вашего сайта. Также есть возможность установки в поддиректорию.

Перейдите по адресу http://your-site/install/ (где your-site - адрес вашего сайта) чтобы запустить Мастер установки.

О безопасности установки и использования InstantCMS вы можете прочитать в этом разделе.


Права доступа

Все файлы и директории CMS должны быть недоступны для записи пользователю, под которым работает web сервер (www-data обычно). Исключения составляют директории /cache/ и /upload/ и всех вложенных в них, а также файл конфигурации CMS и файл конфигурации шаблона, находящиеся в /system/config/.

Как правило, установите для всех файлов движка права (chmod) 644, а для всех директорий права (chmod) 755. После этого для директорий /cache/ и /upload/ и всех вложенных в них установите права 777. На время установки движка так же должна быть доступна для записи (права 777) директория /system/config/. После процедуры установки права доступа для нее нужно выставить в 755.

Для шаблона modern также нужно дать права на запись (666 в общем случае) для CSS файлов шаблона. Т.е. на все файлы в директории /templates/modern/css/, а также для CSS файлов контроллеров /templates/modern/controllers/название/styles.css.

Обращаем ваше внимание, что здесь даны базовые рекомендации по правам доступа, не учитывая особенности настроек безопасности вашего сервера или хостинга.

На unix-like системах вы можете использовать вот такой простой скрипт для быстрой установки правильных прав доступа:

#!/bin/bash
 
clear
 
if [ -z "$1" ]
  then
    echo "Введите абсолютный путь к корневой папке InstantCMS 2.X"
    exit
fi
 
SITE_PATH=$1
 
echo "Устанавливаем корректные права доступа для сайта с корневой категорией $SITE_PATH"
 
find $SITE_PATH/ -type f -exec chmod 644 {} \;
find $SITE_PATH/ -type d -exec chmod 755 {} \;
 
# на время установки
chmod 777 $SITE_PATH/system/config;
 
find $SITE_PATH/cache -type d -exec chmod 777 {} \;
find $SITE_PATH/upload -type d -exec chmod 777 {} \;
find $SITE_PATH/templates/modern/css/ -name "*.css" -exec chmod 666 {} \;
find $SITE_PATH/templates/modern/controllers/ -name "*.css" -exec chmod 666 {} \;

Указанный код нужно скопировать в любой файл, дать ему название, выставить права на исполнение (755) и запускать, передавая параметром полный путь к корню сайта, например:

файл: chmod_icms.sh
запускать так: chmod_icms.sh /path/to/icms_site_root

Вступление

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

Также вам необходимо либо создать заранее созданную базу данных MySQL в кодировке utf8_general_ci/utf8mb4_general_ci или указать её создание при установке.

База данных может быть пустой, но это не обязательно. Для избежания конфликтов с имеющимися таблицами можно будет изменить префикс таблиц (см. ниже).

Лицензия

InstantCMS распространяется по лицензии GNU/GPL версии 2.

Оригинальный текст лицензии расположен по адресу: http://www.gnu.org/licenses/gpl-2.0.html

Неофициальный русский перевод: http://jxself.org/translations/gpl-2.ru.shtml

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

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

Проверка PHP

Для работы InstantCMS 2 требуется PHP версии 5.5 или выше.

В секции Требуемые расширения приведен список модулей для PHP, без которых работа InstantCMS будет невозможна. Если любой из них отмечен строкой «Не найдено» то вам нужно обратиться к администратору сервера (или в поддержку хостинга) с просьбой установить требуемый модуль. После того как модуль будет предоставлен нужно перезапустить Мастер установки (обновить страницу).

В секции Рекомендуемые расширения перечислены модули для PHP без которых система будет работать, но с ограничением функционала. Например, будет недоступна автоматическая установка дополнений.

Указание путей

На данном шаге необходимо указать пути и URL для корня сайта, директорию для загрузок, директорию кэша, директорию хранения сессий PHP.

Настройки по-умолчанию подходят для большинства случаев.

Если вы планируете использовать общую базу пользователей с другим сайтом на InstantCMS2, директория хранения сессий PHP должна быть единой. Подробнее о сквозной авторизации написано в этом разделе.

Также, если вы планируете использовать общую базу пользователей с другим сайтом на InstantCMS 2, нужно изменить путь и URL папки для загрузок. Они должны указывать на папку для загрузок первого (созданного ранее) сайта. Это необходимо для того, чтобы изображения и файлы загружаемые пользователями имели одинаковые пути на обоих сайтах.

Например, первый сайт расположен по адресу http://site1 и лежит в папке /var/www/site1. Текущий устанавливаемый сайт располагается по адресу http://site2 и лежит в /var/www/site2. Тогда необходимо указать следующие пути:

Папка для загрузок: /../site1/upload/
URL для загрузок: http://site1/upload

То есть указываем путь папки для загрузок первого сайта относительно текущего пути. URL для загрузок так же указываем от первого сайта. Не забываем про директиву PHP open_basedir, директория upload должна быть в её видимости.

База данных

На данном шаге требуется указать реквизиты для подключения к созданной вами заранее базе данных MySQL или поставить над полем «База данных» чекбокс «Если не существует, будет создана», в этом случае CMS сама создаст базу данных с заданным названием (у пользователя БД должен быть доступ для создания баз данных).

Если вы не знаете какие реквизиты нужно указывать – обратитесь к администратору сервера или поддержку хостинга.

В поле Кодировка базы данных вы можете выбрать сопоставление кодировки базы данных. UTF8 или UTF8mb4. Данные в UTF8mb4 будут занимать больше места, однако станут доступны все специальные символы UTF8, например эмодзи.

В поле Движок базы данных вы можете выбрать движок базы данных. Database engine, storage engine (движок базы данных, подсистема хранения данных) — компонент СУБД, управляющий базами данных, или библиотека, подключаемая к программам и дающая им функции СУБД. Лучше всего выбирать InnoDB.

В поле Префикс таблиц указывается набор символов который будет добавлен перед названием каждой создаваемой в базе таблицы. Это нужно чтобы избежать конфликтов с уже имеющимися таблицами в указанной базе. Если установка происходит в пустую базу то префикс не имеет значения (можно оставить предлагаемый по-умолчанию).

Поле Таблица с пользователями позволяет выбрать уже существующую таблицу в которой хранятся пользователи сайта. Это необходимо в случае если в указанной базе данных уже располагаются таблицы от другого сайта на InstantCMS 2 и вы хотите иметь общих пользователей с этим сайтом. Название существующей таблицы нужно указывать в полном виде (так, как оно отображается в phpMyAdmin).

При установке чекбокса «Установить демо данные» Мастер установки так же установит демо контент для более понятного знакомства с CMS.

Администратор

На данном шаге создается профиль главного администратора сайта. Используя указанный здесь e-mail и пароль вы сможете авторизоваться на сайте после его установки.

Главный администратор имеет полный доступ ко всем функциям управления и доступ в Панель управления.

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

Конфигурация

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

После завершения установки папку в которой находится этот файл (и все файлы в этой папке) нужно сделать недоступными для записи. В целях безопасности.

Планировщик

На данном шаге приводятся подробные инструкции о том как создать задание для планировщика CRON на сервере.

Действия после установки

После завершения установки обязательно удалите папку install в корне вашего сайта! Установите права доступа 755 на директорию /system/config/. Для корректной работы авторизации и регистрации вам необходимо получить ключи reCAPTCHA для вашего домена.

Установка обновлений и дополнений

manual/install.txt · Последнее изменение: 26.08.2022 19:57 — fuze