Przewodnik Instalacji
Przewodnik Instalacji
Instrukcje krok po kroku jak skonfigurować Blogr od zera — bez wcześniejszego doświadczenia.
Wymagania
Przed rozpoczęciem upewnij się, że masz zainstalowane następujące elementy:
| Wymaganie | Wersja |
|---|---|
| PHP | 8.3 lub nowszy |
| Composer | Najnowsza stabilna |
| Node.js | 18 lub nowszy |
| npm | 9 lub nowszy |
| Baza danych | MySQL 8+, PostgreSQL 15+, lub SQLite |
Będziesz również potrzebować terminala (bash, zsh, PowerShell) i edytora kodu.
Instalacja Krok po Kroku
1. Utwórz projekt Laravel
composer create-project laravel/laravel moj-blog
cd moj-blog
Lub za pomocą instalatora Laravel:
laravel new moj-blog
cd moj-blog
2. Zainstaluj FilamentPHP
composer require filament/filament
php artisan filament:install --panels
Następnie utwórz pierwszego użytkownika administracyjnego:
php artisan make:filament-user
Zapisz adres email i hasło — będą potrzebne do zalogowania.
3. Zainstaluj Blogr
composer require happytodev/blogr
php artisan blogr:install
Instalator jest interaktywny. Przeprowadzi Cię przez:
- CMS — Włącz strony statyczne (O nas, Kontakt, itp.)
- Typ strony głównej — Indeks bloga lub strona CMS
- Alpine.js — Wymagany do przełącznika motywów
- Tailwind CSS v4 — Konfiguracja trybu ciemnego
- Tutoriale — Przykładowa treść na początek
- Zależności NPM — Automatyczna instalacja
- Budowanie assetów — Kompilacja plików frontendowych
Wskazówka: Odpowiadaj „Tak” na wszystkie pytania, aby uzyskać pełną konfigurację.
Po Instalacji
Sprawdź panel administracyjny
Otwórz http://moj-blog.test/admin i zaloguj się przy użyciu danych z kroku 2. Powinieneś zobaczyć pulpit Blogr ze statystykami i widżetami.
Utwórz pierwszy wpis na blogu
- Przejdź do Blog Posts → Nowy Wpis na pasku bocznym
- Wpisz tytuł i treść (Markdown jest obsługiwany)
- Dodaj kategorię i tagi
- Ustaw wyróżniony obraz (przeciągnij i upuść)
- Skonfiguruj pola SEO (opcjonalnie)
- Kliknij Publikuj
Odwiedź swojego bloga pod /blog (lub / jeśli blog jest ustawiony jako strona główna).
Skonfiguruj ustawienia
Przejdź do Blogr Settings w panelu administracyjnym, aby dostosować:
- Ogólne — Nazwa bloga, opis, wpisy na stronę
- SEO — Nazwa strony, domyślne meta, obraz Open Graph
- Nawigacja — Linki menu, przyklejona nawigacja, logo
- Wygląd — Kolory, style kart, tryb ciemny
- Stopka — Linki społecznościowe, tekst praw autorskich
- Kopia zapasowa — Eksport/import danych
Funkcje Opcjonalne
Włącz strony CMS
Jeśli pominąłeś CMS podczas instalacji, włącz go w config/blogr.php:
'cms' => [
'enabled' => true,
'prefix' => '',
],
Następnie twórz strony w CMS → Pages CMS w panelu administracyjnym.
Włącz wielojęzyczność
Edytuj config/blogr.php:
'locales' => [
'enabled' => true,
'default' => 'en',
'available' => ['en', 'fr', 'es', 'de', 'pl'],
],
Z włączonymi językami, Twoje treści będą miały adresy URL w poszczególnych językach:
/en/blog/my-post/pl/blog/moj-wpis
Zainstaluj treści demo
php artisan blogr:publish-demo-pages
php artisan blogr:install-tutorials
Rozwiązywanie Problemów
Uruchom `php artisan blogr:install --force`, aby ponownie uruchomić instalację. Opublikuje to ponownie konfigurację, uruchomi migracje i przekonfiguruje AdminPanelProvider.
Upewnij się, że `@variant dark (.dark &);` znajduje się w pliku `resources/css/app.css`. Następnie uruchom `npm run build`, aby ponownie skompilować assety.
Uruchom `npm run build`, aby skompilować assety frontendowe. Jeśli problem nadal występuje, sprawdź, czy `php artisan storage:link` został utworzony i czy APP_URL jest poprawnie skonfigurowane w `.env`.
Gotowy do budowy swojego bloga?
Blogr jest open source na licencji MIT. Bez karty kredytowej.
Odwiedź Bloga