WordPress-Paket für hypnotizement.com – Docker, eigenes Purple/Black-Theme, zweisprachig mit Polylang
Find a file
admincm 7d621d2a56 feat: Akustik-Box optional ausblendbar
- 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>
2026-11-10 10:47:41 +01:00
config feat: WordPress-Paket für Hypnotizement 2026-11-09 16:55:06 +01:00
scripts feat: WordPress-Paket für Hypnotizement 2026-11-09 16:55:06 +01:00
wp-content feat: Akustik-Box optional ausblendbar 2026-11-10 10:47:41 +01:00
.dockerignore feat: WordPress-Paket für Hypnotizement 2026-11-09 16:55:06 +01:00
.env.example feat: WordPress-Paket für Hypnotizement 2026-11-09 16:55:06 +01:00
.gitattributes feat: WordPress-Paket für Hypnotizement 2026-11-09 16:55:06 +01:00
.gitignore feat: WordPress-Paket für Hypnotizement 2026-11-09 16:55:06 +01:00
docker-compose.yml feat: WordPress-Paket für Hypnotizement 2026-11-09 16:55:06 +01:00
Dockerfile feat: WordPress-Paket für Hypnotizement 2026-11-09 16:55:06 +01:00
README.md feat: Akustik-Box optional ausblendbar 2026-11-10 10:47:41 +01:00

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:

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.1 ist für einen Server hinter Caddy/nginx gedacht. Lokal kann 0.0.0.0 verwendet werden.
  • WP_URL muss die spätere öffentliche URL sein, auf dem Server also https://hypnotizement.com.
  • .env niemals committen. Sie steht bereits in .gitignore.
  • Passwörter nach der Installation nicht einfach in .env ändern. Das WordPress-Passwort wird nur beim ersten wp core install gesetzt. 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.

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.sql
  • wp-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

  • .env mit starken, einzigartigen Passwörtern befüllen; nicht committen.
  • WP_ADMIN_USER nicht admin nennen (auf dem Server).
  • WordPress-Admin-Passwort nach dem ersten Login ggf. im Profil ändern.
  • WP_URL auf https://hypnotizement.com setzen.
  • HTTPS über Caddy/nginx aktivieren; Container nur auf 127.0.0.1 binden.
  • Impressum und Datenschutz durch echte Texte ersetzen.
  • Backup einrichten und Wiederherstellung einmal testen.
  • Keine Debug-Ausgaben aktivieren; WP_DEBUG bleibt 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.