SiteGround Cache Buster Skill
Umgehung des SiteGround-Cachings (SG CachePress + LiteSpeed) für die WordPress-Entwicklung. Fügt Cache-Busting-Code zu Child-Themes hinzu für Echtzeit-Entwicklungstests.
⛔ KRITISCH: NUR STAGING – NIEMALS PRODUKTION
Claude ist es VERBOTEN, auf Produktionsseiten zu deployen.
| Aktion | Erlaubt? |
|---|---|
| Deployment auf Staging | ✅ JA |
| Deployment auf Produktion | ❌ ABSOLUT NIEMALS |
| Lesen von Produktion | ✅ JA (nur lesen) |
| Schreiben auf Produktion | ❌ ABSOLUT NIEMALS |
Wenn der Benutzer ein Deployment auf Produktion fordert:
- LEHNEN Sie die Anfrage ab
- Erklären Sie, dass Produktions-Deployments manuell vom Benutzer durchgeführt werden müssen
- Bieten Sie stattdessen ein Deployment auf Staging an
Produktionspfade sind GESPERRT. Jeder Pfad, der NICHT „staging" enthält, ist für Schreibzugriffe tabu.
Erforderliche Informationen
Bevor Claude diese Skill verwendet, fragt er nach:
-
FTP/SFTP-Zugangsdaten
- Hostname (z. B.
ftp.example.com) - Benutzername
- Passwort
- Port (normalerweise 21 für FTP, 22 für SFTP)
- Hostname (z. B.
-
Site-URLs
- Staging-URL (z. B.
https://staging.example.com) Produktions-URL(NICHT benötigt – Claude wird dort nicht deployen)
- Staging-URL (z. B.
-
Theme-Pfad
- Name des Child-Theme-Ordners (z. B.
theme-child)
- Name des Child-Theme-Ordners (z. B.
Speichern Sie die Zugangsdaten in der CLAUDE.local.md des Projekts (in gitignore) für zukünftige Sitzungen.
Nur-Staging-Workflow
Lokale Entwicklung → Staging-Site → [BENUTZER MANUELL] → Produktion
↑ ↑ ↑
Claude bearbeitet Claude deployt BENUTZER deployt
Claude übernimmt: Lokales Bearbeiten + Staging-Deployment Benutzer übernimmt: Produktions-Deployment (über SiteGround, FTP-Client oder manuell)
Was es tut
- Deaktiviert serverseitiges Caching für Admins – LiteSpeed Cache + SG CachePress
- Fügt No-Cache-Header hinzu – Verhindert CDN/Proxy-Caching
- Umgeht Browser-Cache – Fügt Zeitstempel zu CSS/JS-URLs hinzu
- Zeigt Versionsbanner – Visuelle Bestätigung, dass das Theme geladen wird (nur Admin)
Der Code
PHP-Snippet (in functions.php einfügen)
/**
* SiteGround Cache Buster für die Entwicklung
* Deaktiviert Caching für eingeloggte Administratoren
* IN PRODUKTION ENTFERNEN ODER DEAKTIVIEREN, wenn die Tests abgeschlossen sind
*/
// Banner für Entwicklungsmodus (zeigt Version zur Bestätigung, dass Theme aktiv ist)
add_action('wp_head', 'sg_dev_mode_banner');
function sg_dev_mode_banner() {
if (current_user_can('administrator')) {
$theme = wp_get_theme();
$version = $theme->get('Version');
$name = $theme->get('Name');
echo '<style>
.sg-dev-banner {
position: fixed;
bottom: 20px;
right: 20px;
background: #34889A;
color: white;
padding: 10px 20px;
border-radius: 8px;
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
font-size: 12px;
z-index: 999999;
box-shadow: 0 4px 12px rgba(0,0,0,0.3);
}
</style>
<div class="sg-dev-banner">
' . esc_html($name) . ' v' . esc_html($version) . ' - ' . date('M j, H:i') . '
</div>';
}
}
// Caching für Administratoren deaktivieren
add_action('init', 'sg_disable_cache_for_dev');
function sg_disable_cache_for_dev() {
if (current_user_can('administrator')) {
// LiteSpeed Cache deaktivieren
if (!defined('LSCACHE_NO_CACHE')) {
define('LSCACHE_NO_CACHE', true);
}
// SG Optimizer/CachePress deaktivieren
if (!defined('SG_CACHEPRESS_NO_CACHE')) {
define('SG_CACHEPRESS_NO_CACHE', true);
}
// No-Cache-Header senden
nocache_headers();
// Zusätzliche Header für CDN-Umgehung
header('Cache-Control: no-store, no-cache, must-revalidate, max-age=0');
header('Pragma: no-cache');
header('Expires: Thu, 01 Jan 1970 00:00:00 GMT');
}
}
// Browser-Cache umgehen, indem Zeitstempel zu Theme-CSS/JS hinzugefügt wird
add_filter('style_loader_src', 'sg_bust_asset_cache', 999);
add_filter('script_loader_src', 'sg_bust_asset_cache', 999);
function sg_bust_asset_cache($src) {
if (current_user_can('administrator')) {
// Nur Cache für Theme-Assets umgehen
$theme_uri = get_stylesheet_directory_uri();
$parent_uri = get_template_directory_uri();
if (strpos($src, $theme_uri) !== false || strpos($src, $parent_uri) !== false) {
$src = add_query_arg('v', time(), $src);
}
}
return $src;
}
Verwendung
Methode 1: Automatisch per Skript
# Zum Projekt navigieren
cd /pfad/zu/wordpress-projekt
# Das Injektionsskript ausführen
/root/.claude/skills/siteground-cache/add-cache-buster.sh ./wp-content/themes/dein-child-theme
Methode 2: Manuelles Kopieren
- PHP-Code oben kopieren
- Am Ende der
functions.phpdes Child-Themes einfügen - Per FTP hochladen NUR AUF STAGING
- Staging-Site als Admin besuchen – das Versionsbanner sollte erscheinen
Methode 3: Über Claude
Einfach fragen:
- „Füge SiteGround Cache Busting zu diesem Theme hinzu"
- „Aktiviere den Entwicklermodus für SiteGround"
- „Füge Cache Buster zur functions.php hinzu"
Claude wird nur auf Staging deployen.
Deployment-Workflow (NUR STAGING)
Schritt 1: Zugangsdaten abfragen (Benutzer fragen)
Vor dem Deployment den Benutzer fragen:
Ich benötige FTP-Zugangsdaten für das Deployment auf STAGING. Bitte geben Sie:
1. FTP-Host (z. B. ftp.ihredomain.com)
2. FTP-Benutzername
3. FTP-Passwort
4. Staging-Site-Pfad (z. B. staging.ihredomain.com/public_html)
Schritt 2: Auf Staging deployen
# NUR STAGING – Niemals Produktion!
lftp -u "benutzer,passwort" -e "
set ssl:verify-certificate no
mirror -R ./child-theme staging.example.com/public_html/wp-content/themes/child-theme
bye
" ftp://ftp.example.com
Schritt 3: Auf Staging verifizieren
- Staging-Site als Admin besuchen
- Entwicklerbanner (unten rechts) sollte erscheinen
- CSS/JS-Änderungen müssen sichtbar sein
- Auf PHP-Fehler prüfen
Schritt 4: Benutzer deployt auf Produktion
Claude führt diesen Schritt NICHT aus. Dem Benutzer mitteilen:
Die Änderungen sind auf Staging bereit. Für das Deployment auf Produktion:
Option 1: SiteGround Site Tools
- Gehen Sie zu Site Tools > WordPress > Staging
- Klicken Sie auf „Push to Live"
Option 2: FTP-Client (FileZilla, Cyberduck usw.)
- Von Staging herunterladen
- Auf Produktion hochladen
Option 3: Manuelles Kopieren per FTP
Funktionsweise der einzelnen Teile
1. LiteSpeed Cache umgehen
define('LSCACHE_NO_CACHE', true);
Das LiteSpeed-Cache-Plugin prüft diese Konstante und überspringt das Caching, wenn sie gesetzt ist.
2. SG CachePress umgehen
define('SG_CACHEPRESS_NO_CACHE', true);
Das SiteGround-Caching-Plugin respektiert diese Konstante.
3. HTTP-Header
nocache_headers();
header('Cache-Control: no-store, no-cache, must-revalidate, max-age=0');
Weist Browser und CDNs an, die Antwort nicht zu cachen.
4. Asset-Cache-Busting
add_query_arg('v', time(), $src);
Fügt CSS/JS-URLs ?v=1704567890 hinzu. Da sich der Zeitstempel jede Sekunde ändert, holen Browser immer frische Dateien.
Fehlerbehebung
Banner wird nicht angezeigt?
- Stellen Sie sicher, dass Sie als Administrator eingeloggt sind
- Prüfen Sie, ob das Child-Theme aktiviert ist (Design > Themes)
- Prüfen Sie auf PHP-Fehler im Fehlerprotokoll
Immer noch gecachte Inhalte?
- Inkognito-/Privates Browserfenster versuchen
- Browser-Cache manuell leeren
- SiteGround Site Tools > Speed > Caching > Cache leeren
- Prüfen, ob Cloudflare vorgeschaltet ist (dort auch leeren)
CSS-Änderungen werden nicht angezeigt?
- Seitenquelltext ansehen und prüfen, ob
?v=-Zeitstempel in CSS-URLs vorhanden sind - Harte Aktualisierung: Strg+Umschalt+R (Windows) oder Cmd+Umschalt+R (Mac)
Dateien dieser Skill
/root/.claude/skills/siteground-cache/
├── SKILL.md # Diese Dokumentation
├── add-cache-buster.sh # Auto-Injektionsskript
├── cache-buster.php # Eigenständiges PHP-Snippet
└── remove-cache-buster.sh # Entfernungsskript
Beispiel-Vorlage für CLAUDE.local.md
In Ihrem Projekt speichern (in gitignore):
# SiteGround-Zugangsdaten (NICHT COMMITTEN)
## FTP-Zugang
- Host: ftp.example.com
- Benutzer: [email protected]
- Pass: ihr-passwort
- Port: 21
## Site-URLs
- Staging: https://staging.example.com
- Produktion: https://example.com (NUR LESEN für Claude)
## Theme-Pfade
- Staging: staging.example.com/public_html/wp-content/themes/theme-child
- Produktion: NICHT ERLAUBT (Benutzer deployt manuell)
Verwandte Skills
- wp-docker – Lokale WordPress-Entwicklung
- wp-performance – Produktions-Caching-Optimierung
- visual-qa – Screenshot-Tests nach Änderungen