SteamCal Anleitung

Dateistruktur

Installation

Voraussetzungen

• Apache Webserver mit PHP 8.x
• PHP-Erweiterungen: curl, json, fileinfo
• Schreibrechte im cache/-Verzeichnis für den Webserver
• (Optional) Bludit CMS - via .htaccess bereits konfiguriert

Schritt-für-Schritt

1. Alle Dateien in den Webserver-Ordner kopieren (z.B. /var/www/html/SteamCal/)
2. Verzeichnisrechte prüfen:
   chown www-data:www-data /var/www/html/SteamCal/cache && chmod 755 /var/www/html/SteamCal/cache
3. config.php öffnen und Steam-ID sowie GOG-Benutzernamen eintragen (siehe Konfiguration)
4. Cache initial aufbauen: https://deinedomain.de/SteamCal/refresh.php?token=DEIN_TOKEN
5. Ergebnis prüfen: https://deinedomain.de/SteamCal/

RewriteRule ^SteamCal/ - [L]

Konfiguration (config.php)

Die gesamte Konfiguration erfolgt in einer einzigen Datei:

<?php
return [
    'steam_vanity_url' => 'LAN-Taverne',
    'steam_id_64'       => '76561198006558270',
    'cache_dir'         => __DIR__ . '/cache',
    'cache_ttl'         => 1800,
    'calendar_name'     => 'LAN-Taverne Steam Wishlist',
    'refresh_interval'  => 60,
    'secret_token'      => 'DEIN_SICHERHEITSTOKEN',

    'gog_enabled'       => true,
    'gog_username'      => 'FoxLANTaverne',
    'gog_language'      => 'de',
    'gog_calendar_name' => 'LAN-Taverne GOG Wishlist',
    'calendar_name_all' => 'LAN-Taverne Wunschliste (Steam + GOG)',
];

Parameter-Erklärung

Steam-ID herausfinden

1. Gehe zu https://steamcommunity.com/id/DEIN_NAME
2. Rechtsklick → Seite Quelltext anzeigen
3. Suche nach steamid → die Nummer ist deine steam_id_64
4. Oder nutze https://steamid.io/lookup/DEIN_NAME

Sicheren Token generieren

Erzeuge einen zufälligen Token mit:

php -r "echo bin2hex(random_bytes(16));"

Das Ergebnis als Wert für secret_token eintragen.

GOG-Wunschliste

Seit der Erweiterung werden beide Wunschlisten geladen und auf der Webseite zusammengeführt. Jede Spiel-Karte zeigt über Badges, ob das Spiel auf Steam, auf GOG oder auf beiden Wunschlisten steht.

Wie die GOG-Daten geholt werden

GOG bietet keine öffentliche Wunschlisten-API an. Die App lädt daher die öffentliche Seite https://www.gog.com/de/u/DEIN_NAME/wishlist und liest das dort eingebettete JSON-Objekt gogData aus (Produkte, Release-Datum, Preis, Genres, Entwickler, Bild). Ein Login ist dafür nicht nötig – die Wunschliste muss lediglich öffentlich sein.

1. In GOG anmelden und unter Profil → Einstellungen → Datenschutz die Wunschliste auf „Öffentlich” stellen
2. gog_username in config.php auf den Namen in der URL setzen
3. Cache neu aufbauen: refresh.php?token=DEIN_TOKEN

Zuordnung Steam ↔ GOG

Damit ein Spiel nur einmal im Kalender auftaucht, werden die beiden Listen über den Titel zusammengeführt (WishlistMerge.php):

1. Normalisierter Titel (Kleinbuchstaben, ohne Sonderzeichen, Ü/ö/ü/ß umgeschrieben)
2. Zusatz wie „Game of the Year Edition”, „Complete Edition”, „Deluxe”, „Remastered” oder eine Jahreszahl wird entfernt
3. Nur wenn der so bereinigte Titel auf beiden Listen eindeutig ist, werden die Einträge zusammengeführt
4. Soundtracks, DLCs, Demos und Fortsetzungen (z.B. „Game 2”, „II”) werden bewusst nicht zusammengeführt

Filter auf der Webseite

Über die Schaltflächen Alle / Steam / GOG / Beide lässt sich die Ansicht filtern; die Zähler in den Schaltflächen passen sich dabei an. Die Zuordnung erfolgt im Browser, die Webseite funktioniert also auch ohne JavaScript vollständig (nur die Filter bleiben dann inaktiv).

Feeds und Downloads

Was passiert ohne Release-Datum?

GOG nutzt intern den Wert -7200 als Platzhalter für „Datum unbekannt”. Solche Spiele landen in der Gruppe „Kein Release-Datum bekannt”; im Kalender erscheinen sie am 31.12. des aktuellen Jahres (gleiches Verhalten wie bei Steam). Spiele mit isComingSoon werden als „bevorstehend” angezeigt, auch wenn noch kein Datum feststeht.

Cache & Aktualisierung

Die App nutzt ein Cache-System: Webseite und ICS-Feed lesen nur aus dem Cache. Der Cache wird ausschließlich durch Aufruf von refresh.php aktualisiert.

Cache manuell neu aufbauen

https://deinedomain.de/SteamCal/refresh.php?token=DEIN_TOKEN

Ruft die Steam API und die GOG-Wunschlistenseite ab und aktualisiert alle Spiel-Details. Dauer: ca. 1-2 Minuten bei ~100 Steam-Spielen. Mit &store=steam bzw. &store=gog wird nur ein Store aktualisiert.

Cache löschen

https://deinedomain.de/SteamCal/clear-cache.php

Cron-Job einrichten (empfohlen)

Für automatische stündliche Aktualisierung auf dem Server:

# Crontab öffnen
crontab -e

# Jede Stunde neu aufbauen (anpassen!):
0 * * * * curl -s "https://deinedomain.de/SteamCal/refresh.php?token=DEIN_TOKEN" > /dev/null 2>&1

Kalender abonnieren (Nextcloud)

1. Nextcloud Calendar öffnen
2. Auf + (Neuen Kalender abonnieren) klicken
3. Link-Adresse eingeben: https://deinedomain.de/SteamCal/feed.php
4. Kalender-Name vergeben (z.B. "Steam Wishlist")
5. Fertig → Nextcloud aktualisiert automatisch alle 60 Minuten

Alternativen

Bludit-Kompatibilität

Da Bludit CMS alle Anfragen über seine eigene Router-Logik verarbeitet, muss RewriteEngine Off im SteamCal-Verzeichnis deaktiviert werden.

Root-.htaccess (im Webserver-Root)

Folgende Zeile vor den Bludit-Rewrite-Regeln einfügen:

RewriteRule ^SteamCal/ - [L]

SteamCal/.htaccess

RewriteEngine Off

<IfModule mod_php.c>
    php_flag display_errors On
    php_value error_reporting E_ALL
</IfModule>

<FilesMatch "\.(php)$">
    SetHandler application/x-httpd-php
</FilesMatch>

Fehlerbehebung

Keine Spiele im Kalender

• Prüfe ob die cache/-Dateien vorhanden sind
• Cache neu aufbauen: refresh.php?token=DEIN_TOKEN aufrufen
• Schreibrechte prüfen: ls -la /var/www/html/SteamCal/cache/

GOG-Wunschliste bleibt leer

• In GOG prüfen, ob die Wunschliste öffentlich ist (sonst liefert die Seite keine Produkte)
• gog_username in config.php prüfen: darf keine Leerzeichen enthalten, muss exakt der Name hinter gog.com/u/ sein
• debug.php aufrufen – der Abschnitt „TEST WUNSCHLISTEN-SEITE (GOG)“ zeigt die HTML-Größe und ob gogData gefunden wurde
• Falls GOG den Seitenaufbau geändert hat: debug.php meldet „gogData NICHT gefunden” – dann muss GogWishlist::parseGogData() angepasst werden
• Prüfen, ob gog_enabled in config.php nicht auf false steht

Spiel wird nur auf einem Store angezeigt

• Die Zusammenführung erfolgt über den Spieltitel. Abweichende Editionen („Complete“ ↔ „Standard”) werden erkannt, aber nicht bei nahezu gleichnamigen Reihen
• Unter debug.php → MATCHING steht, welche GOG-Spiele kein Gegenstück auf Steam haben

Bludit zeigt "404 Not Found"

• Prüfe ob RewriteRule ^SteamCal/ - [L] in der Root-.htaccess steht
• Prüfe ob RewriteEngine Off in SteamCal/.htaccess gesetzt ist

Cache-Refresh schlägt fehl

• Prüfe den Token in config.php (der im Browser muss genau übereinstimmen)
• PHP max_execution_time prüfen: In refresh.php wird set_time_limit(300) gesetzt
• Server-Logs prüfen: /var/log/apache2/error.log

Nextcloud aktualisiert nicht

• Prüfe ob feed.php im Browser die ICS-Datei korrekt ausgibt
• Nextcloud-Seite neu laden (Strg+Shift+R)
• In Nextcloud Calendar: Abo-URL neu eintragen