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

  1. Przejdź do Blog Posts → Nowy Wpis na pasku bocznym
  2. Wpisz tytuł i treść (Markdown jest obsługiwany)
  3. Dodaj kategorię i tagi
  4. Ustaw wyróżniony obraz (przeciągnij i upuść)
  5. Skonfiguruj pola SEO (opcjonalnie)
  6. 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