Установка

Два способа установить Templite — через Composer в существующий Laravel-проект или с помощью инсталлятора для нового проекта.

Требования #

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

Компонент	Версия	Примечание
PHP	8.2+	С расширениями `mbstring`, `openssl`, `pdo`
Laravel	11.x	Новый или существующий проект
PostgreSQL	15+	Или MySQL 8.0+
Node.js	18+	Для сборки фронтенда
Composer	2.x

Установка через Composer #

Добавьте пакет Templite в существующий Laravel-проект:

composer require templite/cms
php artisan templite:install
php artisan migrate

Информация

Команда templite:install автоматически опубликует конфигурацию, миграции и ассеты. Вы можете повторно опубликовать их командой php artisan vendor:publish --tag=templite.

После установки выполните сборку фронтенд-ассетов:

npm install
npm run build

Установка через инсталлятор #

Для нового проекта используйте инсталлятор Templite — он создаст Laravel-приложение с предустановленной CMS:

composer global require templite/installer
templite new my-project

Совет

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

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

Основной файл конфигурации находится в config/templite.php. Ключевые параметры:

База данных #

return [
    'database' => [
        'connection' => env('TEMPLITE_DB_CONNECTION', 'pgsql'),
        'prefix' => env('TEMPLITE_DB_PREFIX', 'tpl_'),
    ],
];

Внимание

Не меняйте префикс таблиц после первой миграции — это приведёт к потере данных.

Хранилище медиа #

Templite поддерживает локальное хранилище и S3-совместимые сервисы. Настройте диск в .env:

TEMPLITE_MEDIA_DISK=public
TEMPLITE_MEDIA_PATH=templite/media

Проверка установки #

Запустите сервер разработки и откройте админ-панель:

php artisan serve

Перейдите по адресу http://localhost:8000/admin. Если вы видите страницу входа — установка прошла успешно.

Важно

В продакшене обязательно измените APP_KEY, установите APP_DEBUG=false и настройте HTTPS. Никогда не используйте стандартный ключ приложения в открытом доступе.

Следующие шаги #

После установки рекомендуем:

Создать первый тип страницы и привязать к нему шаблон
Добавить несколько блоков с полями:
- Текстовые поля (text, textarea, wysiwyg)
- Медиа (image, file)
- Связи (relation, repeater)
Настроить компоненты для переиспользуемых элементов