Skill SiteGround Cache Buster
Desativa o cache do SiteGround (SG CachePress + LiteSpeed) para desenvolvimento WordPress. Adiciona código de quebra de cache em temas filhos para testes de desenvolvimento em tempo real.
⛔ CRÍTICO: APENAS STAGING - NUNCA PRODUÇÃO
Claude está PROIBIDO de implantar em sites de produção.
| Ação | Permitida? |
|---|---|
| Implantar em staging | ✅ SIM |
| Implantar em produção | ❌ ABSOLUTAMENTE NUNCA |
| Ler de produção | ✅ SIM (somente leitura) |
| Escrever em produção | ❌ ABSOLUTAMENTE NUNCA |
Se o usuário solicitar implantação em produção:
- RECUSE a solicitação
- Explique que implantações em produção devem ser feitas manualmente pelo usuário
- Ofereça implantar em staging
Caminhos de produção estão BLOQUEADOS. Qualquer caminho que NÃO contenha "staging" é proibido para escritas.
Informações Necessárias
Antes de usar este skill, Claude perguntará:
-
Credenciais FTP/SFTP
- Hostname (ex.:
ftp.exemplo.com) - Nome de usuário
- Senha
- Porta (geralmente 21 para FTP, 22 para SFTP)
- Hostname (ex.:
-
URLs do Site
- URL de staging (ex.:
https://staging.exemplo.com) URL de produção(NÃO necessária – Claude não implantará lá)
- URL de staging (ex.:
-
Caminho do Tema
- Nome da pasta do tema filho (ex.:
tema-filho)
- Nome da pasta do tema filho (ex.:
Armazene as credenciais no CLAUDE.local.md do projeto (gitignorado) para sessões futuras.
Fluxo de Trabalho Apenas Staging
Desenvolvimento Local → Site de Staging → [USUÁRIO MANUALMENTE] → Produção
↑ ↑ ↑
Claude edita Claude implanta USUÁRIO implanta
Claude lida com: Edição local + Implantação em staging Usuário lida com: Implantação em produção (via SiteGround, cliente FTP ou manualmente)
O Que Ele Faz
- Desativa o cache do lado do servidor para administradores - LiteSpeed Cache + SG CachePress
- Adiciona cabeçalhos no-cache - Impede cache de CDN/proxy
- Quebra o cache do navegador - Adiciona timestamp em URLs de CSS/JS
- Mostra banner de versão - Confirmação visual de que o tema está carregando (apenas admin)
O Código
Snippet PHP (adicione ao functions.php)
/**
* SiteGround Cache Buster para Desenvolvimento
* Desativa o cache para administradores logados
* REMOVA OU DESATIVE EM PRODUÇÃO quando terminar os testes
*/
// Banner de modo de desenvolvimento (mostra versão para confirmar que o tema está ativo)
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>';
}
}
// Desativa todo cache para administradores
add_action('init', 'sg_disable_cache_for_dev');
function sg_disable_cache_for_dev() {
if (current_user_can('administrator')) {
// Desativa LiteSpeed Cache
if (!defined('LSCACHE_NO_CACHE')) {
define('LSCACHE_NO_CACHE', true);
}
// Desativa SG Optimizer/CachePress
if (!defined('SG_CACHEPRESS_NO_CACHE')) {
define('SG_CACHEPRESS_NO_CACHE', true);
}
// Envia cabeçalhos no-cache
nocache_headers();
// Cabeçalhos adicionais para bypass de CDN
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');
}
}
// Quebra cache do navegador adicionando timestamp a CSS/JS do tema
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')) {
// Só quebra cache para assets do tema
$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;
}
Uso
Método 1: Injeção automática via Script
# Navegue até seu projeto
cd /caminho/para/projeto-wordpress
# Execute o script de injeção
/root/.claude/skills/siteground-cache/add-cache-buster.sh ./wp-content/themes/seu-tema-filho
Método 2: Cópia Manual
- Copie o código PHP acima
- Cole no final do arquivo
functions.phpdo seu tema filho - Envie via FTP SOMENTE PARA STAGING
- Visite o site de staging como admin – você verá o banner de versão
Método 3: Via Claude
Basta pedir:
- "Adicione quebra de cache do SiteGround a este tema"
- "Ative modo de desenvolvimento para SiteGround"
- "Adicione cache buster ao functions.php"
Claude implantará apenas em staging.
Fluxo de Implantação (SOMENTE STAGING)
Passo 1: Obter Credenciais (Pergunte ao Usuário)
Antes de implantar, pergunte ao usuário:
Preciso das credenciais FTP para implantar no STAGING. Por favor, forneça:
1. Host FTP (ex.: ftp.seudominio.com)
2. Usuário FTP
3. Senha FTP
4. Caminho do site de staging (ex.: staging.seudominio.com/public_html)
Passo 2: Implantar no Staging
# SOMENTE STAGING - Nunca produção!
lftp -u "usuario,senha" -e "
set ssl:verify-certificate no
mirror -R ./tema-filho staging.exemplo.com/public_html/wp-content/themes/tema-filho
bye
" ftp://ftp.exemplo.com
Passo 3: Verificar no Staging
- Visite o site de staging como admin
- Confirme se o banner de desenvolvimento aparece (canto inferior direito)
- Teste se alterações de CSS/JS são visíveis
- Verifique se há erros de PHP
Passo 4: Usuário Implanta em Produção
Claude NÃO faz este passo. Diga ao usuário:
As alterações estão prontas no staging. Para implantar em produção:
Opção 1: SiteGround Site Tools
- Acesse Site Tools > WordPress > Staging
- Clique em "Push to Live"
Opção 2: Cliente FTP (FileZilla, Cyberduck, etc.)
- Baixe do staging
- Envie para produção
Opção 3: Cópia manual de arquivos via FTP
Como Cada Parte Funciona
1. Bypass do LiteSpeed Cache
define('LSCACHE_NO_CACHE', true);
O plugin LiteSpeed Cache verifica esta constante e pula o cache quando definida.
2. Bypass do SG CachePress
define('SG_CACHEPRESS_NO_CACHE', true);
O plugin de cache da SiteGround respeita esta constante.
3. Cabeçalhos HTTP
nocache_headers();
header('Cache-Control: no-store, no-cache, must-revalidate, max-age=0');
Informa navegadores e CDNs para não armazenar em cache a resposta.
4. Quebra de Cache de Assets
add_query_arg('v', time(), $src);
Adiciona ?v=1704567890 às URLs de CSS/JS. Como o timestamp muda a cada segundo, os navegadores sempre buscam arquivos novos.
Solução de Problemas
O banner não aparece?
- Certifique-se de que está logado como Administrador
- Verifique se o tema filho está ativo (Aparência > Temas)
- Verifique se há erros de PHP no log de erros
Ainda vendo conteúdo em cache?
- Tente uma janela anônima/privada do navegador
- Limpe o cache do navegador manualmente
- Verifique SiteGround Site Tools > Speed > Caching > Purge Cache
- Verifique se o Cloudflare está na frente (precisa purgar lá também)
Alterações de CSS não aparecem?
- Veja o código-fonte da página e verifique se o timestamp
?v=está nas URLs de CSS - Atualização forçada: Ctrl+Shift+R (Windows) ou Cmd+Shift+R (Mac)
Arquivos Neste Skill
/root/.claude/skills/siteground-cache/
├── SKILL.md # Esta documentação
├── add-cache-buster.sh # Script de injeção automática
├── cache-buster.php # Snippet PHP independente
└── remove-cache-buster.sh # Script de remoção
Exemplo de Template CLAUDE.local.md
Armazene no seu projeto (gitignorado):
# Credenciais SiteGround (NÃO COMMITAR)
## Acesso FTP
- Host: ftp.exemplo.com
- Usuário: [email protected]
- Senha: sua-senha
- Porta: 21
## URLs do Site
- Staging: https://staging.exemplo.com
- Produção: https://exemplo.com (SOMENTE LEITURA para Claude)
## Caminhos dos Temas
- Staging: staging.exemplo.com/public_html/wp-content/themes/tema-filho
- Produção: PROIBIDO (usuário implanta manualmente)
Relacionados
- wp-docker - Desenvolvimento WordPress local
- wp-performance - Otimização de cache em produção
- visual-qa - Testes de captura de tela após alterações