264 lines
6.9 KiB
Markdown
264 lines
6.9 KiB
Markdown
# Flux CMS — Migration in ein neues Projekt
|
|
|
|
Diese Checkliste führt dich durch alle Schritte, um Flux CMS aus einem bestehenden Projekt in ein neues Laravel-Projekt zu migrieren.
|
|
|
|
> **Voraussetzungen:** Das neue Projekt benötigt Laravel 11+, Livewire 3, Volt, Flux UI (Free oder Pro) und Tailwind CSS v4.
|
|
|
|
---
|
|
|
|
## Schritt 1 — Package-Verzeichnis kopieren
|
|
|
|
```bash
|
|
# Das gesamte Package-Verzeichnis ins neue Projekt kopieren
|
|
cp -r altes-projekt/package/ neues-projekt/package/
|
|
```
|
|
|
|
---
|
|
|
|
## Schritt 2 — composer.json anpassen
|
|
|
|
```json
|
|
{
|
|
"repositories": [
|
|
{ "type": "path", "url": "package/flux-cms/core" }
|
|
],
|
|
"require": {
|
|
"flux-cms/core": "@dev",
|
|
"intervention/image": "^3.0",
|
|
"blade-ui-kit/blade-heroicons": "^2.0"
|
|
},
|
|
"autoload": {
|
|
"files": ["app/helpers.php"]
|
|
}
|
|
}
|
|
```
|
|
|
|
```bash
|
|
composer update
|
|
```
|
|
|
|
---
|
|
|
|
## Schritt 3 — Konfiguration und Migrations
|
|
|
|
```bash
|
|
# Config publizieren
|
|
php artisan vendor:publish --tag=flux-cms-config
|
|
|
|
# Migrations ausführen (erstellt alle flux_cms_* Tabellen)
|
|
php artisan migrate
|
|
```
|
|
|
|
**Hinweis:** Falls das Quell-Projekt zusätzliche Migrations enthält (z.B. `add_detail_columns_to_flux_cms_downloads_table`), diese ebenfalls kopieren:
|
|
|
|
```bash
|
|
cp altes-projekt/database/migrations/*flux_cms*.php neues-projekt/database/migrations/
|
|
php artisan migrate
|
|
```
|
|
|
|
---
|
|
|
|
## Schritt 4 — Helper-Funktionen einrichten
|
|
|
|
Datei `app/helpers.php` erstellen (vollständiger Inhalt in [SETUP.md](SETUP.md#21-datei-erstellen)).
|
|
|
|
```bash
|
|
composer dump-autoload
|
|
```
|
|
|
|
---
|
|
|
|
## Schritt 5 — Livewire-Komponenten kopieren
|
|
|
|
```bash
|
|
mkdir -p app/Livewire/Admin/Cms
|
|
|
|
# Aus Package-Referenz kopieren
|
|
cp package/flux-cms/core/src/Helpers/MediaLibraryUploader.php app/Livewire/Admin/Cms/
|
|
cp package/flux-cms/core/src/Helpers/MediaPicker.php app/Livewire/Admin/Cms/
|
|
cp package/flux-cms/core/src/Helpers/MediaUploader.php app/Livewire/Admin/Cms/
|
|
```
|
|
|
|
Namespace in allen drei Dateien anpassen:
|
|
```php
|
|
namespace App\Livewire\Admin\Cms;
|
|
```
|
|
|
|
---
|
|
|
|
## Schritt 6 — Admin-Views einrichten
|
|
|
|
```bash
|
|
mkdir -p resources/views/livewire/admin/cms
|
|
mkdir -p resources/views/components/layouts
|
|
|
|
# Alle Admin-Views kopieren
|
|
cp package/flux-cms/core/resources/views/admin-reference/cms/*.blade.php \
|
|
resources/views/livewire/admin/cms/
|
|
|
|
# Admin-Layout kopieren
|
|
cp package/flux-cms/core/resources/views/admin-reference/layout-cms.blade.php \
|
|
resources/views/components/layouts/cms.blade.php
|
|
```
|
|
|
|
**Anpassen:**
|
|
- `resources/views/components/layouts/cms.blade.php`: Branding/Logo anpassen
|
|
- `route('dashboard')` im Layout ggf. anpassen (Redirect nach Login)
|
|
|
|
---
|
|
|
|
## Schritt 7 — Routes registrieren
|
|
|
|
In `routes/web.php`:
|
|
|
|
```php
|
|
use Livewire\Volt\Volt;
|
|
|
|
Route::middleware(['auth'])->group(function () {
|
|
Volt::route('admin/cms', 'admin.cms.dashboard')->name('cms.dashboard');
|
|
Volt::route('admin/cms/content', 'admin.cms.content-index')->name('cms.content.index');
|
|
Volt::route('admin/cms/media', 'admin.cms.media-index')->name('cms.media.index');
|
|
Volt::route('admin/cms/news', 'admin.cms.news-index')->name('cms.news.index');
|
|
Volt::route('admin/cms/industries', 'admin.cms.industries-index')->name('cms.industries.index');
|
|
Volt::route('admin/cms/faqs', 'admin.cms.faqs-index')->name('cms.faqs.index');
|
|
Volt::route('admin/cms/linkedin', 'admin.cms.linkedin-index')->name('cms.linkedin.index');
|
|
Volt::route('admin/cms/downloads', 'admin.cms.downloads-index')->name('cms.downloads.index');
|
|
Volt::route('admin/cms/team', 'admin.cms.team-index')->name('cms.team.index');
|
|
Volt::route('admin/cms/search-index', 'admin.cms.search-index')->name('cms.search-index');
|
|
});
|
|
```
|
|
|
|
---
|
|
|
|
## Schritt 8 — Storage-Link erstellen
|
|
|
|
```bash
|
|
php artisan storage:link
|
|
```
|
|
|
|
---
|
|
|
|
## Schritt 9 — Seeders kopieren (optional)
|
|
|
|
Falls Inhalte aus dem alten Projekt übernommen werden sollen:
|
|
|
|
```bash
|
|
# Referenz-Seeders als Ausgangspunkt
|
|
cp package/flux-cms/core/database/seeders-reference/*.php database/seeders/
|
|
```
|
|
|
|
Die Seeders müssen für das neue Projekt angepasst werden (andere Inhalte, andere Bilder).
|
|
Ausführungsreihenfolge in `DatabaseSeeder`:
|
|
|
|
```php
|
|
$this->call([
|
|
CmsContentSeeder::class,
|
|
CmsMediaSeeder::class,
|
|
CmsNewsItemSeeder::class,
|
|
CmsIndustrySeeder::class,
|
|
CmsFaqSeeder::class,
|
|
CmsLinkedinPostSeeder::class,
|
|
CmsDownloadSeeder::class,
|
|
CmsSearchIndexSeeder::class,
|
|
]);
|
|
```
|
|
|
|
---
|
|
|
|
## Schritt 10 — Medien migrieren (optional)
|
|
|
|
Falls Medien aus dem alten Projekt übernommen werden sollen:
|
|
|
|
```bash
|
|
# Storage-Verzeichnis kopieren
|
|
cp -r altes-projekt/storage/app/public/cms/ neues-projekt/storage/app/public/cms/
|
|
```
|
|
|
|
Dann den `CmsMediaSeeder` ausführen, um die DB-Einträge wiederherzustellen:
|
|
|
|
```bash
|
|
php artisan db:seed --class=CmsMediaSeeder
|
|
```
|
|
|
|
---
|
|
|
|
## Schritt 11 — Vite Build
|
|
|
|
```bash
|
|
npm install
|
|
npm run build
|
|
# oder für Entwicklung:
|
|
npm run dev
|
|
```
|
|
|
|
---
|
|
|
|
## Schritt 12 — Tests einrichten (optional)
|
|
|
|
```bash
|
|
# Referenz-Tests kopieren
|
|
cp -r package/flux-cms/core/tests-reference/Feature/Cms tests/Feature/Cms
|
|
|
|
# Tests ausführen
|
|
php artisan test --filter=Cms
|
|
```
|
|
|
|
---
|
|
|
|
## Checkliste
|
|
|
|
- [ ] Package-Verzeichnis kopiert (`package/flux-cms/`)
|
|
- [ ] `composer.json` angepasst (Repository, Require, Autoload)
|
|
- [ ] `composer update` ausgeführt
|
|
- [ ] Config publiziert (`vendor:publish --tag=flux-cms-config`)
|
|
- [ ] Migrations ausgeführt (inkl. projektspezifische)
|
|
- [ ] `app/helpers.php` erstellt
|
|
- [ ] `composer dump-autoload` ausgeführt
|
|
- [ ] Livewire-Komponenten kopiert + Namespace angepasst
|
|
- [ ] Admin-Views kopiert
|
|
- [ ] Layout angepasst (Branding, Route-Namen)
|
|
- [ ] Routes registriert
|
|
- [ ] `storage:link` ausgeführt
|
|
- [ ] Seeders angepasst und ausgeführt (optional)
|
|
- [ ] Medien migriert (optional)
|
|
- [ ] Vite Build ausgeführt
|
|
- [ ] Admin-Login testen: `/admin/cms`
|
|
|
|
---
|
|
|
|
## Häufige Probleme
|
|
|
|
### "View not found" für `livewire.admin.cms.*`
|
|
→ Prüfen ob Volt-Mount-Path `resources/views/livewire/` in `VoltServiceProvider` registriert ist.
|
|
|
|
### Bilder werden nicht angezeigt
|
|
→ `php artisan storage:link` ausführen. Prüfen ob `APP_URL` in `.env` korrekt gesetzt ist.
|
|
|
|
### "Route [cms.dashboard] not defined"
|
|
→ Sicherstellen dass alle CMS-Routes in `routes/web.php` registriert sind.
|
|
|
|
### Bilder hinter HTTPS-Proxy haben falsche URLs
|
|
→ In `bootstrap/app.php`:
|
|
```php
|
|
->withMiddleware(function (Middleware $middleware) {
|
|
$middleware->trustProxies(at: '*');
|
|
})
|
|
```
|
|
Und in `AppServiceProvider::boot()`:
|
|
```php
|
|
if (request()->header('X-Forwarded-Proto') === 'https') {
|
|
URL::forceScheme('https');
|
|
}
|
|
```
|
|
|
|
### Flux UI `<flux:toast />` fehlt
|
|
→ Das Layout `resources/views/components/layouts/cms.blade.php` muss `<flux:toast />` enthalten (bereits im Referenz-Layout vorhanden).
|
|
|
|
---
|
|
|
|
## Weiterführende Dokumentation
|
|
|
|
- [README.md](README.md) — Überblick, alle Features, Helper-Funktionen
|
|
- [SETUP.md](SETUP.md) — Detaillierte Schritt-für-Schritt-Anleitung
|
|
- [ARCHITECTURE.md](ARCHITECTURE.md) — Datenbankschema, Datenfluss, Komponenten-Architektur
|
|
- [README-FILE-UPLOAD.md](README-FILE-UPLOAD.md) — Medienbibliothek im Detail
|