- Neues Setting show_acoustic (Standard: sichtbar) mit Checkbox unter Texte > Kuenstlerprofil - Akustik-Box wird nur noch bei aktivem Haken gerendert, Texte bleiben gespeichert - README und Anleitung ergaenzt Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> |
||
|---|---|---|
| config | ||
| scripts | ||
| wp-content | ||
| .dockerignore | ||
| .env.example | ||
| .gitattributes | ||
| .gitignore | ||
| docker-compose.yml | ||
| Dockerfile | ||
| README.md | ||
Hypnotizement – WordPress-Paket
Self-hosted WordPress für hypnotizement.com – Rock, Grunge, Metal und Akustik. Das Paket enthält Docker Compose, eine angepasste Purple/Black-Theme und zweisprachige Inhalte (Deutsch/Englisch) mit Polylang.
Wichtig: Texte, weitere Musiker, Releases und Rechtstexte werden komplett im WordPress-Admin gepflegt. Für normale Änderungen musst du keine PHP-, CSS- oder TypeScript-Dateien anfassen.
Was ist enthalten?
| Baustein | Zweck |
|---|---|
docker-compose.yml + Dockerfile |
WordPress 7.1 mit PHP 8.4 und MariaDB 11.4 |
wp-content/themes/hypnotizement |
Custom Theme im bestehenden Purple/Black-Look |
wp-content/mu-plugins/hypnotizement-core.php |
Weitere Musiker und Releases als eigene Inhalte |
scripts/setup.* |
Erstinstallation, Sprache, Polylang, Beispielinhalte |
scripts/backup.* |
Datenbank- und Datei-Backup |
.env.example |
Vorlage für Passwörter und URLs |
1. Lokal starten (Windows)
Voraussetzungen: Docker Desktop mit Docker Compose.
cd C:\Projekte\HypnotizementWordPress
Copy-Item .env.example .env
notepad .env
.\scripts\setup.ps1
Danach:
- Website: http://localhost:8091
- Admin: http://localhost:8091/wp-admin/
- Benutzer: der Wert aus
WP_ADMIN_USER(Standard:admin) - Passwort: der Wert aus
WP_ADMIN_PASSWORD
1. Lokal starten (Linux/Debian)
cd /pfad/zu/HypnotizementWordPress
cp .env.example .env
nano .env
chmod +x scripts/*.sh
./scripts/setup.sh
2. Die wichtigsten .env-Werte
WEB_BIND=127.0.0.1
WEB_PORT=8091
WP_URL=http://localhost:8091
DB_NAME=wordpress
DB_USER=wordpress
DB_PASSWORD=ein-langes-zufaelliges-passwort
DB_ROOT_PASSWORD=noch-ein-langes-zufaelliges-passwort
WP_ADMIN_USER=admin
WP_ADMIN_PASSWORD=ein-starkes-admin-passwort
WP_ADMIN_EMAIL=admin@hypnotizement.com
WEB_BIND=127.0.0.1ist für einen Server hinter Caddy/nginx gedacht. Lokal kann0.0.0.0verwendet werden.WP_URLmuss die spätere öffentliche URL sein, auf dem Server alsohttps://hypnotizement.com..envniemals committen. Sie steht bereits in.gitignore.- Passwörter nach der Installation nicht einfach in
.envändern. Das WordPress-Passwort wird nur beim erstenwp core installgesetzt. Spätere Änderungen erfolgen im WordPress-Profil bzw. per WP-CLI.
3. Inhalte bearbeiten
Im Admin unter Hypnotizement:
| Bereich | Inhalt |
|---|---|
| Hypnotizement → Texte | Startseiten-Texte, Hero, Musik, Künstlerprofil, Kontakt, Footer, Social-/Streaming-Links |
| Bandmitglieder | Weitere Musiker mit Name, Instrument/Rolle (DE/EN), Foto, Sortierung |
| Releases | Singles/EPs mit Jahr, Typ, Cover, Beschreibung (DE/EN), „Upcoming“-Status und Streaming-Links |
Der obere Eintrag Hypnotizement öffnet ebenfalls die Textseite. Musiker und Releases haben eigene Menüpunkte, damit sie auch bei einem temporären Theme-Wechsel erreichbar bleiben.
Im Kontaktbereich lässt sich der komplette Kontaktinhalt (Überschrift, Einleitung, Presse, Booking und Hinweis) per Haken „Kontaktbereich anzeigen (außer Social Media)“ ausblenden. Der Social-Media-Block bleibt sichtbar. Zusätzlich lässt sich die Booking-Karte separat ausblenden.
Unter Links stehen Felder für Instagram, YouTube, Bandcamp, Facebook, X/Twitter, TikTok und Discord bereit. Weitere Netzwerke können als eigene Zeilen im Format Name|https://… ergänzt werden. Leere Social-Media-Felder werden nicht angezeigt.
Das Profil ist standardmäßig für einen Solo-Künstler formuliert. Überschrift, Bio und weitere Texte sind unter Künstlerprofil anpassbar; bei Bedarf kann dort auch eine Band-Bio stehen. Die Live-Besetzung ist standardmäßig ausgeblendet und kann dort optional aktiviert werden. Die Musikerprofile bleiben gespeichert. Auch die Akustik-Box unter der Bio lässt sich dort per Haken ausblenden; Titel und Text bleiben erhalten.
Sprache
Oben im Admin und im Frontend gibt es den Sprachwechsel:
- Deutsch:
/ - Englisch:
/en/
Polylang verwaltet die Seiten. Beim Bearbeiten einer Seite siehst du die Sprachzuordnung; die englische Version ist die Übersetzung der deutschen Seite. Musiker und Releases werden nicht doppelt angelegt: Sie haben jeweils deutsche und englische Felder in einem Beitrag.
Startseite
Die Startseite ist eine normale Seite (Startseite / Home) und wird über Einstellungen → Lesen als statische Startseite verwendet. Die meisten Texte kommen aus Hypnotizement → Texte, damit du sie an einer Stelle ändern kannst.
Releases / Streaming-Links
Unter Hypnotizement → Releases legst du beliebig viele Releases an. Die Startseite zeigt den nächsten Release groß und alle weiteren in den Listen „In Vorbereitung“ und „Veröffentlicht“.
- Upcoming aktiv: Der Release erscheint unter „In Vorbereitung“.
- Upcoming deaktiviert: Der Release erscheint unter „Veröffentlicht“.
- Reihenfolge (Seiten-Attribute) legt die Sortierung innerhalb der Listen fest.
- Streaming-Links: Spotify, Apple Music, Bandcamp, YouTube und weitere Links (
Name|https://…) können direkt pro Release hinterlegt werden. - Sind bei einem veröffentlichten Release keine eigenen Links hinterlegt, werden automatisch die globalen Links aus Hypnotizement → Texte → Links verwendet.
Wenn noch kein Release existiert, zeigt das Theme automatisch einen Platzhalter. Sobald Releases existieren, werden sie verwendet.
Rechtstexte
- Seiten → Impressum / Datenschutz (DE)
- Seiten → Imprint / Privacy (EN)
Die Texte sind Platzhalter und müssen vor dem Livegang durch echte Angaben ersetzt werden. Das gilt besonders für Impressum und Datenschutzerklärung.
Bilder und Cover
- Bandfotos und Release-Cover über die Medienbibliothek hochladen.
- Beim Release kann ein Cover-Bild ausgewählt werden; ohne Bild wird ein passendes SVG-Cover generiert.
- Uploads landen in
wp-content/uploads/und bleiben beim Neuaufbau des Containers erhalten.
4. Auf dem Docker-Server installieren
Empfohlener Pfad: /docker/hypnotizement-wordpress (nicht den alten Astro-Ordner überschreiben).
cd /docker
git clone https://forgejo.chris-m.de/admincm/hypnotizement-wordpress.git hypnotizement-wordpress
cd hypnotizement-wordpress
cp .env.example .env
nano .env
Für den Server mindestens anpassen:
WEB_BIND=127.0.0.1
WEB_PORT=8091
WP_URL=https://hypnotizement.com
DB_PASSWORD=...
DB_ROOT_PASSWORD=...
WP_ADMIN_USER=...
WP_ADMIN_PASSWORD=...
WP_ADMIN_EMAIL=...
Dann:
docker compose up -d --build
./scripts/setup.sh
Der Setup-Befehl ist idempotent: Er installiert WordPress nur beim ersten Mal und legt Inhalte nur an, wenn sie noch fehlen.
Reverse Proxy / HTTPS
Die WordPress-Container sollten nicht direkt aus dem Internet erreichbar sein. Beispiel für Caddy:
hypnotizement.com {
encode zstd gzip
reverse_proxy 127.0.0.1:8091
}
Danach Caddy neu laden:
sudo systemctl reload caddy
Bei nginx/Apache analog auf 127.0.0.1:8091 weiterleiten und TLS terminieren. WP_URL muss https://hypnotizement.com sein, sonst erzeugt WordPress falsche Links.
DNS
hypnotizement.com und www.hypnotizement.com auf den Server zeigen lassen. Wenn www verwendet wird, in Caddy einen Redirect auf die Hauptdomain einrichten und WP_URL entsprechend setzen.
5. Updates einspielen
Theme- oder Code-Änderungen
cd /docker/hypnotizement-wordpress
git pull
docker compose up -d --build
Das Theme liegt per Bind-Mount in ./wp-content; Änderungen sind nach dem Pull sofort aktiv. Ein erneutes setup.sh ist normalerweise nicht nötig, schadet aber nicht.
WordPress-Core / Image aktualisieren
docker compose build --pull
docker compose up -d
Die Datenbank und wp-content bleiben erhalten. WordPress-Core-Updates, die direkt im Container gemacht werden, gehen beim Neuerstellen des Containers verloren; deshalb regelmäßig das Image aktualisieren.
Nach einem Update prüfen
docker compose ps
docker compose logs --tail=80 wordpress
curl -I https://hypnotizement.com/
curl -I https://hypnotizement.com/en/
6. Backup und Wiederherstellung
Backup erstellen
Linux:
./scripts/backup.sh
Windows:
.\scripts\backup.ps1
Die Dateien landen in backups/:
db-YYYY-MM-DD_HH-MM-SS.sqlwp-content-YYYY-MM-DD_HH-MM-SS.tar.gz
Backups werden nach 14 Tagen automatisch gelöscht. Für ein echtes Backup zusätzlich eine Kopie außerhalb des Servers ablegen.
Wiederherstellen
Achtung: Das überschreibt die aktuelle Datenbank und wp-content.
# 0. Variablen aus .env laden
set -a
source .env
set +a
# 1. Container starten
docker compose up -d
# 2. Datenbank neu aufbauen und importieren
docker compose exec -T db mariadb -u root -p"$DB_ROOT_PASSWORD" \
-e "DROP DATABASE IF EXISTS \`$DB_NAME\`; CREATE DATABASE \`$DB_NAME\` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
docker compose exec -T db mariadb -u root -p"$DB_ROOT_PASSWORD" "$DB_NAME" \
< backups/db-DEIN-DATUM.sql
# 3. Dateien zurückspielen
docker compose exec -T wordpress tar -xzf - -C /var/www/html \
< backups/wp-content-DEIN-DATUM.tar.gz
# 4. Rechte setzen und Cache leeren
docker compose exec -T wordpress chown -R www-data:www-data /var/www/html/wp-content
docker compose exec -T wordpress wp --allow-root cache flush
Vorher unbedingt ein aktuelles Backup erstellen.
7. Sicherheit und Livegang-Checkliste
.envmit starken, einzigartigen Passwörtern befüllen; nicht committen.WP_ADMIN_USERnichtadminnennen (auf dem Server).- WordPress-Admin-Passwort nach dem ersten Login ggf. im Profil ändern.
WP_URLaufhttps://hypnotizement.comsetzen.- HTTPS über Caddy/nginx aktivieren; Container nur auf
127.0.0.1binden. - Impressum und Datenschutz durch echte Texte ersetzen.
- Backup einrichten und Wiederherstellung einmal testen.
- Keine Debug-Ausgaben aktivieren;
WP_DEBUGbleibt im Image aus. - Updates regelmäßig einspielen (
docker compose build --pull).
Das Theme deaktiviert den Datei-Editor (DISALLOW_FILE_EDIT), XML-RPC und PHP-Ausführung in wp-content/uploads/.
8. Projektstruktur
HypnotizementWordPress/
├── docker-compose.yml
├── Dockerfile
├── .env.example
├── scripts/
│ ├── setup.sh / setup.ps1
│ ├── seed.php
│ └── backup.sh / backup.ps1
├── config/
│ ├── php.ini
│ └── uploads.ini
└── wp-content/
├── themes/hypnotizement/
├── mu-plugins/hypnotizement-core.php
├── plugins/ (Polylang wird installiert)
└── uploads/ (Medien, nicht im Git)
9. Häufige Probleme
Port 8091 ist belegt
WEB_PORT in .env ändern und docker compose up -d erneut ausführen.
Datenbank startet nicht
docker compose logs db prüfen. Meist stimmen DB_PASSWORD und DB_ROOT_PASSWORD nicht mit dem bestehenden Volume überein. Bei einer komplett neuen Installation (Datenverlust!) hilft docker compose down -v.
Seiten liefern 404
Einmal docker compose exec -T wordpress wp --allow-root rewrite structure '/%postname%/' --hard ausführen. Bei Apache muss AllowOverride für .htaccess aktiv sein; das mitgelieferte Image unterstützt die WordPress-Permalinks.
Englische Startseite zeigt /en/home/
Polylang-Option redirect_lang muss aktiv sein. Das erledigt scripts/seed.php; nach einem manuellen Eingriff die Polylang-Spracheinstellungen prüfen und den Cache leeren.
Admin-Passwort vergessen
docker compose exec -T wordpress wp --allow-root user update admin --user_pass='NEUES-PASSWORT'
10. Rechtliches
Dieses Paket enthält nur Platzhalter für Impressum und Datenschutz. Die Texte müssen an die tatsächlichen Gegebenheiten angepasst werden. Für die rechtliche Sicherheit ist der Betreiber verantwortlich.