Pro installieren

rankbeam/laravel-seo-pro ergänzt den Core um Queue-basierte Website-Scans mit Befundverwaltung, Weiterleitungsverwaltung und einen 404-Monitor. Die Engine läuft in jeder Laravel-11–13-App, mit Blade, Inertia oder als reine API. Filament ist eine optionale Oberfläche: Mit Filament erhältst du SEO-Dashboard, Weiterleitungen und 404-Monitor als Panel-Seiten. Ohne Filament verwaltest du sie über Artisan-Befehle.

Voraussetzungen

PHP	8.2–8.4 (Laravel 11); 8.2–8.5 (Laravel 12); 8.3–8.5 (Laravel 13)
Laravel	11, 12 oder 13
rankbeam/laravel-seo	^3.20, von Pro 2.40+ automatisch installiert
filament/filament	Optional, 4.x oder 5.x, nur für die Admin-Oberfläche
rankbeam/laravel-seo-filament	Optional, ^1.11 bei Verwendung des SEO-Editors mit Pro 2.36+

Beginne mit einer vorhandenen Laravel-App und eingerichteter Datenbank. Schließe zuerst den Core-Schnellstart ab, damit ein Modell Metadaten rendert und die Core-Tabellen existieren. Die Pro-Lizenz liefert die unten verwendeten Composer-Zugangsdaten.

Ein visuelles Beispiel des Ergebnisses zeigt die Anleitung Scan → Korrektur → Bericht.

Paket installieren

Pro wird über ein privates, an deine Lizenz gebundenes Composer-Repository verteilt. Füge das Repository einmal hinzu und installiere das Paket. Composer fragt nach der Lizenz-E-Mail als Benutzername und dem Lizenzschlüssel als Passwort:

Lemon Squeezy wickelt die Zahlung als Merchant of Record ab. Nach der Zahlung zeigt die private Belegseite deinen Download-Schlüssel und die Composer-Anleitung. Verwende die E-Mail-Adresse des Kaufs als Benutzernamen. Rankbeam betreibt das Paket-Repository; ein Anystack-Konto ist nicht erforderlich. Halte den Beleglink und auth.json geheim. Eine vollständige Erstattung sperrt künftige Downloads und Updates, ohne eine installierte Anwendung zu unterbrechen.

composer config repositories.rankbeam-pro composer https://blog.rankbeam.dev/composer
composer require rankbeam/laravel-seo-pro

Composer-Authentifizierung ohne interaktive Eingabe

Hinterlege in CI oder anderen nicht interaktiven Umgebungen die Zugangsdaten vorab:

composer config http-basic.blog.rankbeam.dev you@example.com YOUR-LICENSE-KEY

Führe anschließend den Installer aus:

php artisan seo-pro:install

Der Installer veröffentlicht config/seo-pro.php und die Pro-Migrationen, führt migrate aus und zeigt die nächsten Schritte. Die Datenbank deiner App sollte nun die Core- und Pro-Tabellen enthalten.

Manuelle Installation und Installer-Optionen

Pro-Migrationen werden in deine App veröffentlicht und nicht automatisch aus dem Paket geladen. Die entsprechenden manuellen Schritte sind:

php artisan vendor:publish --tag=seo-pro-config
php artisan vendor:publish --tag=seo-pro-migrations
php artisan migrate

Der Installer lässt sich erneut ausführen. --no-migrate veröffentlicht Dateien, ohne zu migrieren. Verwende --force nur, wenn du veröffentlichte Dateien einschließlich deiner Konfiguration überschreiben möchtest.

Scan-Ziele registrieren

Lege in einem Service Provider fest, was der Scanner prüfen soll: Modellklassen, benannte Routen oder alle Einträge deiner Sitemap-Registry.

use App\Models\Post;
use Rankbeam\Seo\Pro\Facades\SeoPro;

public function boot(): void
{
    SeoPro::targets()->register('posts', Post::class);
    // Optional: register named routes that exist in your app.
    // SeoPro::targets()->registerRoutes('static', ['home', 'pricing']);
    // Or discover targets from your registered sitemaps:
    // SeoPro::targets()->fromSitemaps();
}

Ersetze Post durch dein eigenes Modell mit HasSEO. Für ein Modell-Scan-Ergebnis muss mindestens ein Datensatz vorhanden sein. Routenziele müssen existierende Routen benennen. Lass diese Registrierung weg, wenn du nur Modelle prüfen möchtest.

Installation prüfen

Führe die Konfigurationsprüfung aus:

php artisan seo:doctor

Prüfe, ob Core- und Pro-Tabellen vorhanden sind, die Anwendungs-URL stimmt und deine Scan-Ziele aufgeführt sind. Befolge die gemeldeten Korrekturen. Beim Test der folgenden Inline-Befehle ist eine Warnung zur sync-Queue erwartbar. Richte einen Worker ein, bevor du Scans in Produktion planst.

Beispielausgabe der Zustandsprüfung

  Rankbeam SEO — health check

  Application
    ✓ app.url is https://shop.example.com
  Database (core)
    ✓ Core tables present (seo_meta, seo_defaults)
  Database (Pro)
    ✓ Pro tables present (redirects, 404 logs, scan runs/issues/results)
  Scanning
    ✓ Scan targets registered: posts, static
    ✓ Scan delta snapshot store present (seo_scan_run_issues)
  Queue
    ! Queue connection is 'sync'
      ↳ Scans run inline on the dispatching request/CLI. Use a real queue …
    ✓ Scan queue: default (seo-pro.scan.queue unset)
  Broken links
    ✓ Broken-link crawler is off (optional)
  AI assist
    ✓ AI assist is off (optional)
  AI bots
    ✓ AI-bot logging is off (optional)
  Search Console
    ✓ Search Console is off (optional)
  Reports
    ✓ Reports on (snapshot store present: seo_report_runs)

  ! Healthy with warnings — 1 warning(s), 11 passed.

seo:doctor prüft Konfiguration und letzte Laufhistorie, ohne Netzwerkaufrufe oder Ausgabe geheimer Werte. Ob ein externer Cronjob oder Worker tatsächlich läuft, kann der Befehl nicht beweisen. Kritische Fehler ergeben einen Exit-Code ungleich null, Warnungen nicht. --json liefert ein maschinenlesbares Ergebnis.

Den ersten Scan ausführen

php artisan seo-pro:scan --sync
php artisan seo-pro:scan-status

Der erste Befehl führt den Scan direkt aus; dieser erste Test benötigt deshalb keinen Queue-Worker. Der zweite zeigt den letzten Lauf und seine Ergebnisse. Erwartet wird ein abgeschlossener Lauf mit verarbeiteten registrierten Zielen. Untersuche fehlgeschlagene Ziele, bevor du den Scan als vollständig wertest.

Korrigiere ein gemeldetes Feld, speichere es und scanne erneut. Die Schritt-für-Schritt-Anleitung zeigt dies an einer fehlenden Beschreibung mit anschließendem Änderungsbericht. Eine technische Bewertung ist ein Diagnoseergebnis und keine Ranking-Prognose.

Verwendung ohne Oberfläche

Die Engine lässt sich ohne Panel verwenden. Mit Artisan-Befehlen kannst du scannen, Befunde ansehen, Weiterleitungen erstellen und Berichte erzeugen. Die Middlewares für Weiterleitungen und 404-Monitor registrieren sich standardmäßig automatisch. Ihre Einstellungen stehen in config/seo-pro.php.

Für geplante Aufgaben beschreibt Produktion einrichten Queues, Worker, Scheduler und Aufbewahrung.

Optional ein Filament-Panel ergänzen

Registriere in einem vorhandenen Filament-4/5-Panel das folgende Pro-Plugin. Hat deine App noch kein Panel, installiere zuerst die UI-Pakete und lege eines an:

composer require filament/filament rankbeam/laravel-seo-filament
php artisan filament:install --panels
php artisan make:filament-user

use Rankbeam\Seo\Pro\Filament\SeoProPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(SeoProPlugin::make());
}

Damit erhältst du das SEO-Dashboard mit vollständigem Scan, Live-Fortschritt und Befundliste samt erneutem Scan einzelner Seiten, die Weiterleitungsverwaltung und den 404-Monitor mit der Aktion Create redirect. rankbeam/laravel-seo-filament ergänzt außerdem den SEO-Feldbereich in deinen Ressourcenformularen.

Fehlerbehebung

Ergebnis	Nächster Schritt
Composer lehnt Zugangsdaten ab	Prüfe Lizenz-E-Mail und Schlüssel für blog.rankbeam.dev. Zugangsdaten gehören nicht in die Versionsverwaltung.
Doctor meldet fehlende Tabellen	Schließe den Core-Schnellstart ab und führe seo-pro:install sowie migrate gegen dieselbe Datenbank wie die App aus.
Ein Scan verarbeitet keine Ziele	Prüfe die Provider-Registrierung und vorhandene Datensätze des Modells.
Ein Queue-Scan bleibt ausstehend	Starte den konfigurierten Worker oder prüfe mit --sync direkt im Prozess.
Ein Ziel schlägt fehl	Prüfe Laufdetails, Routennamen und Anwendungs-URL vor dem erneuten Scan.
Das Dashboard fehlt	Registriere SeoProPlugin im tatsächlich verwendeten Panel und prüfe die Zugriffsregeln.

Worker-Wiederherstellung und laufenden Betrieb beschreibt Produktion einrichten.

Lizenz und Erstattungen

Die Gründungslizenz kostet einmalig 179 € und gilt für bis zu fünf produktive Projekte, einschließlich Kundenprojekten, mit lebenslangen Updates. Entwicklungs- und Staging-Kopien dieser Projekte zählen nicht zusätzlich. Hilfe bei Installation und Migration, ein 60-minütiger Installationstermin und das angekündigte Launch-Kit sind enthalten. Innerhalb von 30 Tagen kannst du über den Beleg oder per E-Mail an valentinogoxhaj@gmail.com ohne Angabe von Gründen eine vollständige Erstattung verlangen. Danach musst du die Nutzung von Pro beenden. Änderungen für lizenzierte Projekte sind erlaubt; die Veröffentlichung des Quellcodes oder der Weiterverkauf als eigenständiges Paket oder Starter-Kit ist untersagt. Die vollständigen Lizenzbedingungen liegen dem Paket bei.

Du darfst Pro in bis zu fünf Produktionsprojekten einsetzen, einschließlich Kundenprojekten. Entwicklungs-, Staging- und Testkopien dieser Projekte zählen nicht zusätzlich. Lebenslange Updates umfassen künftige Pro-Versionen, jedoch keine fortlaufenden persönlichen Implementierungsarbeiten.

Enthalten sind ein 60-minütiges Gespräch zur Installation und Konfiguration sowie die Metadaten-Migration für ein erstes Projekt. Die Migration gilt für unterstützte Quellen; den Umfang stimmen wir vor Beginn ab. Individuelle Anwendungsänderungen werden separat angeboten. Für dasselbe Projekt prüfen und konfigurieren wir llms.txt, die Regeln für KI-Crawler in robots.txt und Markdown-Antworten für Bots mit Funktionen des kostenlosen Core. Schreibe an hello@rankbeam.dev, um die enthaltene Hilfe zu vereinbaren.

Für deine Bestellung gilt das beim Kauf angezeigte Angebot.