Dokumentation

Votepit läuft auf klassischem PHP/MySQL-Shared-Hosting — kein Docker, keine Fremd-Runtime. So bekommst du es installiert und konfiguriert.

Voraussetzungen

PHP 8.2 oder neuer mit pdo_mysql, mbstring und openssl. Eine MySQL- oder MariaDB-Datenbank. FTPES-Zugang (SSH optional). Idealerweise zeigt dein Webroot auf den Ordner public/; bei Hostern, wo das nicht einstellbar ist, schützt die mitgelieferte .htaccess alles außerhalb von public/ — es funktioniert also so oder so.

Installation — FTP + Web-Installer

Lade das neueste Release-ZIP von GitHub, entpacke es und lade alles per FTP hoch. Setze den Webroot auf public/, falls dein Hoster das erlaubt (sonst schützt die mitgelieferte .htaccess den Rest), und rufe https://deine-domain/install auf: Der Wizard prüft dein System, fragt die Datenbankdaten ab, importiert das Schema und legt den ersten Admin an. Danach sperrt sich der Installer selbst.

Installation — Composer (SSH)

Wenn dein Hoster SSH und Composer bietet: composer create-project silvio-l/votepit voting-board ausführen, Webroot auf public/ setzen (oder die mitgelieferte .htaccess nutzen) und /install zum Abschließen aufrufen.

Konfiguration

Secrets liegen in config/config.php (Datenbank, SMTP für Magic-Link-Mails, app_key) und werden nie eingecheckt. Der Installer schreibt die Datei für dich; du kannst sie später von Hand anpassen.

Boards & Branding

Eine Installation bedient mehrere Boards, adressiert über einen Slug im Pfad (/{board}/…). Jedes Board hat eigenen Namen, Akzentfarbe und Intro, verwaltet im Admin-Bereich.

Aktualisieren

Sichere Datenbank und config/config.php, lade das neue Release über die alten Dateien (config/ behalten), und rufe /install auf, falls eine Migration nötig ist.

Quellcode auf GitHub