📖 Wiki & Dokumentation

Alles was du brauchst — Installation, Einstellungen, Tipps

🚀 Installation

Die Installation dauert ca. 5 Minuten und erfordert nur einen FTP-Zugang und eine MySQL-Datenbank.

Voraussetzungen

  • PHP 8.0+
  • MySQL 5.7+ oder MariaDB
  • FTP-Zugang zum Webserver
  • Eine leere Datenbank mit Zugangsdaten

Schritt-für-Schritt

1
ZIP entpacken und hochladen

Entpacke cleveo-link-v1.0.zip und lade den Inhalt per FTP in das Stammverzeichnis deiner Domain (/web/ oder /public_html/).

zip entpacken und upload
Screenshot: FileZilla Upload
2
install.php aufrufen

Öffne im Browser: https://deine-domain.de/install

3
Formular ausfüllen

Gib Datenbank-Zugangsdaten, Website-URL, SMTP-Daten und (optional) Stripe-Keys ein.

Install formular
Screenshot: install.php Formular
4
Installation abschließen

Nach erfolgreichem Abschluss wird install.php automatisch gelöscht. Du wirst zum Admin-Login weitergeleitet.

Install formular fertig
Screenshot: Erfolgreiche Installation
💡 Tipp: Notiere dir die Admin-Zugangsdaten, die du beim Install vergibst — du kannst sie später nur über die Datenbank zurücksetzen.

🌐 Server & URL-Rewrite

Cleveo verwendet schöne URLs ohne .php-Endung (z. B. /kategorie-rechnung statt /kategorie-rechnung.php). Damit das funktioniert, muss dein Webserver Anfragen umschreiben. Je nach Server:

🅰️ Apache (die meisten Shared-Hoster: IONOS, Strato, all-inkl …)

Nichts zu tun! Die mitgelieferte .htaccess-Datei im Stammverzeichnis erledigt das automatisch. Achte nur darauf, dass sie beim FTP-Upload mit übertragen wurde (versteckte Datei — in FileZilla: Server → Auflistung versteckter Dateien erzwingen).

Falls deine URLs trotzdem 404 liefern, muss bei deinem Hoster mod_rewrite und AllowOverride All aktiv sein — bei Shared-Hosting ist das fast immer der Fall.

🅽 Nginx (VPS / eigener Server / ISPConfig)

Nginx liest keine .htaccess. Füge stattdessen folgende Regel in deine Server-Konfiguration ein (bei ISPConfig: Websites → deine Domain → Optionen → Nginx Direktiven):

location / {
    try_files $uri $uri/ @extensionless;
}
location @extensionless {
    rewrite ^(.*)$ $1.php last;
}

Danach Nginx neu laden: systemctl reload nginx (ISPConfig macht das automatisch beim Speichern).

💡 Schnelltest: Öffne deine-domain.de/kontakt — lädt die Seite, funktioniert das Rewrite. Kommt ein 404, prüfe die Regeln oben.

⚙️ Admin Panel

Das Admin Panel erreichst du unter /admin/. Melde dich mit den Zugangsdaten an, die du bei der Installation vergeben hast.

Admin Panel
Screenshot: Admin Dashboard

Übersicht der Bereiche

  • Live/Test Schalter — Stripe und KI zwischen Live- und Testmodus umschalten
  • Blog Editor — SEO-Blogartikel erstellen und verwalten
  • Newsletter — Abonnenten anzeigen und exportieren
  • Download Manager — eBay-Bestellnummern freischalten
  • Lizenz-Tracker — Aktivierte Lizenzen überwachen
  • Einstellungen — Alle API-Keys und SMTP zentral verwalten
⚠️ Wichtig: Schalte Stripe erst auf LIVE, wenn du alles getestet hast. Im TEST-Modus werden keine echten Zahlungen verarbeitet.

🔑 Einstellungen

Alle API-Keys und Zugangsdaten werden zentral unter /admin/settings.php gespeichert — kein FTP-Zugang nötig.

Admin Panel Einstellungen
Screenshot: Einstellungen-Seite

Verfügbare Einstellungen

  • Stripe Live-Keys — Secret Key, Public Key, Webhook Secret, Price ID
  • Stripe Test-Keys — Zum Testen ohne echte Zahlungen
  • Claude KI API-Key — Für KI-gestützte Dokumenten-Analyse
  • SMTP E-Mail — Host, Port, Benutzer, Passwort, Absendername
  • Website-URL — Wird für Stripe-Weiterleitungen verwendet
💡 Alle Einstellungen werden in der Datenbank gespeichert und sofort aktiv — kein Serverneustart nötig.

📧 SMTP / E-Mail Einrichtung

Das Script versendet E-Mails für Bestellbestätigungen, Newsletter und Kontaktformular. Du benötigst ein SMTP-Konto.

Empfohlene Anbieter

  • Titan Email (titan.email) — günstig, zuverlässig
  • Gmail SMTP — Port 587, TLS
  • Eigener Mailserver — falls vorhanden

Titan Email Einstellungen (Beispiel)

SMTP Host:     smtp.titan.email
SMTP Port:     465 (SSL) oder 587 (TLS)
Benutzer:      info@deine-domain.de
Passwort:      dein-passwort
Absendername:  Mein Shop
Admin Panel Email Einstellungen
Screenshot: SMTP Einstellungen im Admin
💡 Nach dem Speichern werden alle E-Mails automatisch über diesen Account versendet — in allen Generatoren gleichzeitig.

💳 Stripe Einrichtung

Für Zahlungen benötigst du einen kostenlosen Stripe-Account.

Keys holen

  1. Stripe Dashboard öffnen → Developers → API Keys
  2. Secret Key (sk_live_...) und Publishable Key (pk_live_...) kopieren
  3. Im Admin unter Einstellungen → Stripe Live einfügen
Admin Panel Stripe Einstellungen
Screenshot: Stripe Dashboard API Keys

Webhook einrichten

  1. Stripe Dashboard → Developers → Webhooks → Add endpoint
  2. URL: https://deine-domain.de/webhook
  3. Events: checkout.session.completed, customer.subscription.deleted
  4. Webhook Secret (whsec_...) kopieren und im Admin eintragen
⚠️ Teste immer zuerst mit Test-Keys und Stripe CLI bevor du auf LIVE schaltest.
Admin Panel Stripe Webhook Einstellungen
Screenshot: Stripe Dashboard API Keys

📦 Download Manager eBay

Käufer können das Script nach dem eBay-Kauf unter /download/ herunterladen — indem sie ihre eBay-Bestellnummer eingeben.

Bestellnummer freischalten

1
Admin Panel öffnen

Gehe zu /admin/ → Download Manager

2
Bestellnummer eingeben

eBay-Bestellnummer im Format 12-34567-89012 eingeben und auf Hinzufügen klicken.

3
Käufer informieren

Teile dem Käufer per eBay-Nachricht mit, dass er unter deine-domain.de/download/ seinen Download abrufen kann.

Admin Panel Download Manager
Screenshot: Download Manager
💡 Standard: 3 Download-Versuche pro Bestellnummer. Du kannst das Limit im Download Manager anpassen oder einen Zugang sperren.

📄 Impressum, AGB & Datenschutz

Die Seiten impressum.php, agb.php und datenschutz.php enthalten Platzhalter, die du einmalig per FTP oder direkt auf dem Server anpassen musst.

Platzhalter ersetzen

  • IHR_NAME → Dein vollständiger Name oder Firmenname
  • IHRE_ADRESSE → Straße, PLZ, Stadt
  • IHRE_TELEFONNUMMER → Telefonnummer
  • IHRE_EMAIL@DOMAIN.DE → Deine Kontakt-E-Mail
⚠️ Pflicht: Impressum und Datenschutzerklärung sind in Deutschland gesetzlich vorgeschrieben. Passe sie vor dem Live-Gang unbedingt an.
💡 Du kannst die Dateien direkt per FTP-Editor (FileZilla → Rechtsklick → Bearbeiten) öffnen und anpassen — kein Download/Upload nötig.

❓ Häufige Fragen (FAQ)

Nach der Installation kommt ein 500-Fehler — was tun? ▼
Prüfe den Error-Log deines Servers. Häufigste Ursachen: falsche Datenbankdaten, fehlende PHP-Extension (mysqli), oder Dateirechte. Die Datei includes/db.php muss vom Webserver lesbar sein (644).
E-Mails werden nicht gesendet ▼
Überprüfe im Admin unter Einstellungen → SMTP alle Zugangsdaten. Port 465 erfordert SSL, Port 587 erfordert TLS/STARTTLS. Viele Provider blockieren Port 25.
Stripe-Zahlung funktioniert nicht im Live-Modus ▼
Stelle sicher, dass du Live-Keys (nicht Test-Keys) eingetragen hast, der Live/Test-Schalter auf LIVE steht, und der Webhook korrekt eingerichtet ist. Prüfe das Stripe Dashboard unter Developers → Webhooks → Events.
Wie ändere ich das Admin-Passwort? ▼
Direkt in der Datenbank — Tabelle admins, Spalte passwort_hash. Neuen Hash mit PHP generieren: password_hash('neues-passwort', PASSWORD_DEFAULT)
Kann ich mehrere Domains mit einer Lizenz betreiben? ▼
Nein — eine Lizenz gilt für eine Domain. Für weitere Domains ist eine separate Lizenz erforderlich. Der Lizenz-Tracker erkennt automatisch wenn eine Lizenz auf mehreren Domains aktiv ist.
Wie schalte ich einen eBay-Käufer für den Download frei? ▼
Admin Panel → Download Manager → eBay-Bestellnummer (Format: 12-34567-89012) eingeben → Hinzufügen. Der Käufer kann dann unter /download/ seine Bestellnummer eingeben und das Script herunterladen.