Solução de problemas no WordPress Playground

Esta página cobre erros do próprio site do Playground, Playgrounds salvos, armazenamento do navegador e inicialização do WordPress. Para erros específicos de Blueprint, consulte Solução de problemas e depuração de Blueprints.

O Playground parece quebrado

Tente isto primeiro:

• Use o botão de recarregar dentro da barra de ferramentas do Playground em vez de atualizar a aba do navegador. A atualização do navegador inicia todo o app do Playground novamente.
• Abra a mesma URL em uma janela privativa para descartar problemas de estado de site salvo ou armazenamento do navegador.
• Desative extensões do navegador que bloqueiam JavaScript, WebAssembly, armazenamento, workers ou requisições de rede.
• Verifique as ferramentas de desenvolvedor do navegador para erros nas abas Console e Network.
• Se a URL incluir ?site-slug=..., tente remover esse parâmetro de consulta para iniciar um Playground novo e não salvo.

Um site limpo diz que a extensão MySQL está ausente

Você pode ver uma página de erro do WordPress como esta:

Your PHP installation appears to be missing the MySQL extension which is required by WordPress.

No Playground, isso geralmente significa que o WordPress não carregou a integração SQLite que permite executar o WordPress sem MySQL. O Playground executa o WordPress em WebAssembly e usa SQLite em vez de um servidor MySQL.

Tente estes passos:

• Inicie um Playground novo e não salvo em https://playground.wordpress.net/ para confirmar que o site público consegue inicializar.
• Se a URL incluir um site salvo, remova ?site-slug=... e carregue um novo site temporário.
• Se isso aconteceu depois de importar um ZIP, confirme que a importação não incluiu um wp-content/db.php personalizado que substitui a configuração SQLite do Playground.
• Se isso aconteceu na CLI, não use --skip-sqlite-setup, a menos que você forneça sua própria integração de banco de dados.
• Se isso aconteceu com um Blueprint, consulte a página de solução de problemas de Blueprint.

Se você estiver escrevendo um Blueprint e precisar adicionar o plugin de integração SQLite, plugins fica no nível superior:

{
	"preferredVersions": {
		"php": "8.3",
		"wp": "latest"
	},
	"plugins": ["sqlite-database-integration"],
	"steps": [
		{
			"step": "login",
			"username": "admin"
		}
	]
}

Error connecting to the SQLite database

Isso significa que o Playground carregou a integração SQLite, mas o WordPress ainda não conseguiu se conectar ao banco de dados.

Causas comuns:

• O armazenamento do navegador de um Playground salvo está desatualizado ou incompleto.
• Um ZIP de site importado contém um arquivo de banco de dados ou drop-in de banco de dados incompatível.
• Um diretório local montado não tem arquivos de que o WordPress precisa.
• O armazenamento do navegador foi limpo, removido ou bloqueado.

Recuperação recomendada:

1. Inicie um Playground novo e não salvo sem site-slug.
2. Se o site novo funcionar, o problema está ligado ao site salvo ou ao arquivo importado.
3. Exporte quaisquer arquivos acessíveis do site salvo quebrado usando o Navegador de arquivos ou uma cópia do diretório local, se disponível.
4. Reimporte o site para um novo Playground ou reconstrua-o a partir do Blueprint.

NotAllowedError

NotAllowedError geralmente significa que o navegador bloqueou uma operação que exige permissão do usuário ou um contexto de navegador compatível. No Playground, isso costuma estar relacionado a sites salvos ou acesso a diretórios locais.

Você pode ver esta mensagem exata:

The request is not allowed by the user agent or the platform in the current context.

Tente:

• Abrir o Playground em uma aba normal de nível superior do navegador, não dentro de um iframe restrito.
• Reabrir o site pelo painel Saved Playgrounds do Playground.
• Se o site foi salvo em um diretório local, importar ou salvar o diretório novamente.
• Confirmar que o navegador oferece suporte à API de arquivos ou armazenamento em uso. Chrome e Edge geralmente têm o suporte mais amplo a diretórios locais.
• Verificar se o modo de navegação privativa, uma política empresarial ou as configurações do navegador bloqueiam acesso ao armazenamento.

NoModificationAllowedError

NoModificationAllowedError significa que o navegador ou sistema de arquivos recusou uma gravação. Isso pode acontecer quando um diretório local salvo se tornou somente leitura, a permissão foi perdida ou o armazenamento do navegador está indisponível.

Você pode ver esta mensagem exata:

An attempt was made to write to a file or directory which could not be modified due to the state of the underlying filesystem.

Tente:

• Salvar uma cópia em outro diretório local.
• Verificar se a pasta de destino ainda existe e é gravável.
• Evitar pastas protegidas pelo sistema ou pastas sincronizadas que bloqueiam arquivos temporariamente.
• Iniciar um Playground novo e não salvo se você só precisa de um site temporário de teste.
• Usar a Playground CLI para desenvolvimento local que precisa de persistência confiável do sistema de arquivos.

Playground salvo não recarrega

Playgrounds salvos são armazenados no armazenamento do navegador ou em um diretório local que você selecionou. Eles não são hospedados em um servidor remoto.

Se um Playground salvo não recarregar:

• Confirme que você está usando o mesmo navegador e perfil de navegador em que ele foi salvo.
• Verifique se os dados do navegador foram limpos ou se o armazenamento foi desativado.
• Se o site foi salvo em um diretório local, confirme que o diretório ainda existe e não foi movido.
• Se a URL incluir ?site-slug=..., remova-o para iniciar um site novo e não salvo.
• Recrie o site salvo a partir do Blueprint original ou do ZIP de importação se o armazenamento foi perdido.

Armazenamento do navegador e persistência

Um Playground não salvo é temporário. Uma atualização do navegador, fechamento da aba, limpeza de armazenamento ou troca de perfil do navegador pode remover o estado dele.

Use o botão Save antes de fazer trabalhos importantes. Para desenvolvimento local de longa duração, prefira a Playground CLI, que persiste os arquivos do site em disco.

O botão de atualizar dentro da barra de ferramentas do Playground recarrega o WordPress mantendo o runtime atual do Playground. O botão de atualizar do navegador recarrega o app inteiro e pode descartar alterações não salvas.

Quando começar do zero

Inicie um Playground novo e não salvo quando:

• Você só precisa testar se o site público do Playground está funcionando.
• A URL aponta para um site-slug salvo que não carrega mais.
• Você está depurando se um erro vem do próprio Playground ou de um plugin, tema, Blueprint ou site importado.
• Há suspeita de problema no armazenamento do navegador ou no acesso a diretório local.

Use esta URL para um site limpo:

https://playground.wordpress.net/

Relatar um problema do Playground

Se o problema for reproduzido em um Playground novo e não salvo, abra uma issue e inclua:

• A URL completa do Playground.
• O navegador e o sistema operacional.
• Se você usou um site salvo, ZIP importado, Blueprint, diretório local ou CLI.
• O nome e a mensagem exatos do erro.
• Detalhes das abas Console e Network das ferramentas de desenvolvedor do navegador.