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

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

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

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


manual:install

Установка InstantCMS 2

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

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

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


Видео инструкция по установке

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

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

На 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 {} \;

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

файл: 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 для загрузок так же указываем от первого сайта.

База данных

На данном шаге требуется указать реквизиты для подключения к созданной вами заранее базе данных 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 · Последние изменения: 24.02.2020 16:01 — fuze