Предпосылки

Прежде чем начать, убедитесь, что у вас установлено следующее:

Также понадобится терминал (bash, zsh, PowerShell) и редактор кода по вашему выбору.

Пошаговая установка

1. Создание проекта Laravel

composer create-project laravel/laravel my-blog
cd my-blog

Или с помощью установщика Laravel:

laravel new my-blog
cd my-blog

2. Установка FilamentPHP

composer require filament/filament
php artisan filament:install --panels

Затем создайте первого администратора:

php artisan make:filament-user

Сохраните email и пароль — они понадобятся для входа.

3. Установка Blogr

composer require happytodev/blogr
php artisan blogr:install

Установщик интерактивный. Он проведет вас через:

• CMS — Включить статические страницы (О нас, Контакты и др.)
• Тип главной — Лента блога или пользовательская страница CMS
• Alpine.js — Требуется для переключателя тем
• Tailwind CSS v4 — Настройка тёмной темы
• Учебники — Примеры контента для начала
• NPM зависимости — Автоматическая установка
• Сборка ассетов — Компиляция frontend файлов

Совет: Отвечайте "Да" на все запросы для полной настройки.

После установки

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

Откройте http://my-blog.test/admin и войдите с учётными данными из шага 2. Вы увидите панель управления Blogr со статистикой и виджетами.

Создание первой записи в блоге

1. Перейдите в Blog Posts → Новая запись в боковой панели админки
2. Напишите заголовок и содержание (Markdown поддерживается)
3. Добавьте категорию и теги
4. Задайте изображение (перетащите и бросьте)
5. Настройте поля SEO (опционально)
6. Нажмите Опубликовать

Посетите свой блог по адресу /blog (или /, если блог настроен как главная страница).

Настройка параметров

Перейдите в Blogr Settings в панели администратора для настройки:

• Основное — Название блога, описание, записей на страницу
• SEO — Название сайта, meta по умолчанию, Open Graph изображение
• Навигация — Ссылки меню, липкая навигация, логотип
• Внешний вид — Цвета, стили карточек, тёмная тема
• Подвал — Ссылки на соцсети, текст авторских прав
• Резервное копирование — Экспорт/импорт данных

Дополнительные возможности

Включение страниц CMS

Если вы пропустили CMS во время установки, включите его в config/blogr.php:

'cms' => [
    'enabled' => true,
    'prefix' => '',
],

Затем создавайте страницы в CMS → Pages CMS в панели администратора.

Включение многоязычности

Отредактируйте config/blogr.php:

'locales' => [
    'enabled' => true,
    'default' => 'en',
    'available' => ['en', 'fr', 'es', 'de', 'pl'],
],

С включёнными языками ваш контент получает URL-адреса на каждом языке:

• /en/blog/my-post
• /ru/blog/moya-zapis

Установка демо-контента

php artisan blogr:publish-demo-pages
php artisan blogr:install-tutorials