<?php
require_once __DIR__.'/../app/bootstrap.php';
$user=require_login($pdo);
$GLOBALS['user']=$user;
require_once __DIR__.'/_layout.php';
page_header('FAQ');
?>
<section class="card faq-page">
  <h2>Häufige Fragen zu KuhRator</h2>
  <p class="muted">Kurze Antworten zur Installation, Verwaltung und täglichen Nutzung des QR-Code-Managers.</p>

  <h3>Installation und Updates</h3>
  <details open><summary>Wie installiere ich KuhRator auf einem Webserver?</summary><p>Lade alle Dateien auf den Webserver, rufe <code>install.php</code> im Browser auf und trage Datenbank, Admin-Konto, Mailversand und SSL-Optionen ein. Nach erfolgreicher Installation wird <code>install.php</code> automatisch entfernt, sofern die Dateirechte dies erlauben.</p></details>
  <details><summary>Welche Servervoraussetzungen braucht das Tool?</summary><p>Empfohlen sind PHP 7.4 oder neuer, MySQL oder MariaDB, PDO, aktivierte Sessions und idealerweise <code>ZipArchive</code> für den Self-Updater. Für SMTP-Versand müssen ausgehende Verbindungen zum Mailserver erlaubt sein.</p></details>
  <details><summary>Wie funktionieren Updates?</summary><p>Lege ein Paket mit dem Namen <code>qr-code-manager-vXX.zip</code> in den Ordner <code>/update</code>. Superadmins sehen das Update im Backend und können es über «Updates» installieren. <code>app/config.php</code>, <code>/storage</code> und <code>/update</code> werden dabei geschützt.</p></details>
  <details><summary>Soll ich vor Updates ein Backup machen?</summary><p>Ja. Sichere vor jedem Update die Dateien und exportiere die Datenbank über phpMyAdmin. Der Updater erstellt zusätzlich ein Datei-Backup, ein Datenbank-Backup ersetzt das aber nicht.</p></details>

  <h3>QR-Codes erstellen und verwalten</h3>
  <details><summary>Warum bleiben QR-Codes nach einer URL-Änderung gültig?</summary><p>Der QR-Code verweist nicht direkt auf die Zielseite, sondern auf einen stabilen Kurzlink deiner Installation. Dieser Kurzlink leitet auf die aktuell hinterlegte Ziel-URL weiter. Die Ziel-URL kannst du jederzeit ändern, ohne den QR-Code neu zu drucken.</p></details>
  <details><summary>Kann ich den Kurzlink selbst festlegen?</summary><p>Ja. Beim Erstellen kannst du optional einen eigenen Slug vergeben. Erlaubt sind Buchstaben, Zahlen, Bindestrich und Unterstrich. Der Slug muss innerhalb der Installation eindeutig sein.</p></details>
  <details><summary>Kann ich Farben und Logo im QR-Code anpassen?</summary><p>Ja. Vordergrund- und Hintergrundfarbe lassen sich frei wählen, der Hintergrund kann transparent sein und optional kann ein Logo in der Mitte platziert werden. Prüfe QR-Codes mit Logo vor dem Druck immer mit mehreren Smartphones.</p></details>
  <details><summary>Welche Downloads sind möglich?</summary><p>QR-Codes können als PNG, JPEG und SVG heruntergeladen werden. Für Drucksachen ist SVG meist am flexibelsten, PNG eignet sich gut für Office, Web und Präsentationen.</p></details>

  <h3>Benutzer, Gruppen und Rechte</h3>
  <details><summary>Was ist der Unterschied zwischen Benutzer und Superadmin?</summary><p>Benutzer verwalten ihre eigenen QR-Codes und freigegebene Gruppen. Superadmins können zusätzlich Benutzer verwalten, Rollen ändern und Updates installieren.</p></details>
  <details><summary>Wie funktionieren Gruppen?</summary><p>Gruppen bündeln QR-Codes thematisch, zum Beispiel nach Kampagne, Kunde oder Projekt. Im Dashboard und in der Statistik kannst du QR-Codes nach Gruppen filtern.</p></details>
  <details><summary>Kann ich Gruppen teilen?</summary><p>Ja. Gruppen können anderen Benutzern mit Leserecht oder Bearbeitungsrecht freigegeben werden. Freigaben lassen sich jederzeit wieder entfernen.</p></details>
  <details><summary>Was passiert beim Löschen eines Benutzerkontos?</summary><p>Beim Löschen werden die zugehörigen QR-Codes, Logos, Statistikdaten und Freigaben dieses Kontos entfernt. Diese Aktion sollte nur nach einem Backup erfolgen.</p></details>

  <h3>Statistik und Tracking</h3>
  <details><summary>Was wird in der Statistik erfasst?</summary><p>Erfasst werden Scan-Zählungen und, falls aktiviert, zusätzliche Auswertungen wie Tageswerte und Geo-Informationen. Die Statistik dient der Auswertung von QR-Code-Nutzung.</p></details>
  <details><summary>Kann ich Statistikdaten exportieren?</summary><p>Ja. Die Statistik kann als CSV exportiert werden. Zusätzlich steht ein PDF-Report zur Verfügung.</p></details>
  <details><summary>Kann ich Statistikdaten zurücksetzen?</summary><p>Ja. Pro QR-Code gibt es einen Reset-Button, mit dem die Statistik dieses Codes auf 0 zurückgesetzt wird.</p></details>
  <details><summary>Wie nutze ich UTM-Tracking?</summary><p>Beim Erstellen oder Bearbeiten eines QR-Codes kannst du UTM-Parameter ergänzen. Diese werden an die Ziel-URL angehängt und können in Webanalyse-Tools ausgewertet werden.</p></details>

  <h3>Sicherheit und Betrieb</h3>
  <details><summary>Wie wird der Login geschützt?</summary><p>Passwörter werden gehasht gespeichert. Formulare verwenden CSRF-Token, Datenbankabfragen laufen über PDO Prepared Statements und Sessions werden serverseitig verwaltet.</p></details>
  <details><summary>Kann HTTPS erzwungen werden?</summary><p>Ja. Im Installer kann SSL/HTTPS erzwungen werden. Das ist für produktive Installationen empfohlen, insbesondere für Login, Registrierung und Passwort-Reset.</p></details>
  <details><summary>Wie funktioniert Passwort zurücksetzen?</summary><p>Benutzer fordern einen Reset-Link an. Der Versand erfolgt je nach Installation über den normalen Servermailer oder über SMTP. Bei SMTP müssen Host, Port, Verschlüsselung, Benutzer und Passwort korrekt hinterlegt sein.</p></details>
  <details><summary>Warum kommt keine Passwort-Reset-Mail an?</summary><p>Prüfe zuerst Spam-Ordner, Absenderadresse und SMTP-Daten. Bei Servermailer hängt die Zustellung stark vom Hosting ab. Für zuverlässigen Versand ist SMTP meist die bessere Wahl.</p></details>
</section>
<?php page_footer(); ?>
