WordPress Studio: Perguntas frequentes

Este texto foi traduzido usando IA. Se você quiser ver o texto original em inglês, clique aqui.

Nesta página, você encontrará respostas para perguntas frequentes sobre o aplicativo WordPress Studio e alguns recursos como o Assistente e o Studio Sync.

Lembrando que o WordPress Studio é um projeto de código aberto que aceita todas as contribuições. Se você encontrar um bug ou o recurso do Studio que você precisa estiver faltando, temos algumas opções:

• Entre em contato com nossa equipe de suporte para perguntas específicas sobre o uso do Studio.
• Abra uma issue no repositório para relatar bugs, sugerir ideias ou solicitar novos recursos.

Perguntas frequentes gerais

Aqui estão algumas respostas para perguntas frequentes sobre o WordPress Studio:

Como posso exportar um tema que criei no WordPress Studio?

Os temas criados no Studio são iguais aos temas criados em sites WordPress tradicionais. Você pode exportar seu tema seguindo estas etapas:

1. Selecione o site local dentro do Studio.
2. Certifique-se de que seu site já está em execução.
3. Clique na aba Visão geral.
4. Clique no botão “Editor do site“.
5. Quando o editor do site carregar no seu navegador, expanda o editor clicando em qualquer lugar na pré-visualização do site.
6. Clique no botão do menu Opções no canto superior direito da tela, representado pelo ícone de reticências (⋮). 
7. Clique em Exportar, e seu navegador deverá começar a baixar um arquivo .zip do seu tema.

Você pode então enviar seu tema para qualquer site WordPress ativo ou de staging seguindo estas instruções.

Como posso publicar meu site do Studio para que fique disponível publicamente?

Embora os sites de prévia sejam destinados a compartilhar com clientes e coletar feedback inicial por até sete dias, é necessário um plano de hospedagem para tornar seu site permanentemente acessível.

Para publicar seu site local no WordPress.com, siga os passos descritos na documentação do Studio Sync.

Para publicar seu site local em outro host WordPress, siga o guia de Importação e Exportação para criar uma exportação do seu site de origem. Quando a exportação estiver pronta, você pode importar esse conteúdo para o site de destino, por exemplo, seguindo o guia Restaurar Manualmente Seu Site a Partir de um Arquivo de Jetpack Backup no WordPress.com.

Como posso gerenciar o banco de dados SQLite do site do Studio?

O WordPress Studio usa SQLite em vez de um servidor MySQL. O SQLite é um mecanismo de banco de dados SQL leve e independente que armazena seu banco de dados em um único arquivo. Cada um dos seus sites terá um arquivo de banco de dados disponível no seguinte caminho: wp-content/database/.ht.sqlite. Este é um arquivo oculto e pode não estar visível usando o Explorador de Arquivos. No Mac, você pode pressionar cmd + shift + . para revelar os arquivos ocultos usando o Finder.

Depois de localizar o arquivo de banco de dados SQLite, você pode gerenciar o banco de dados usando qualquer aplicativo compatível com SQLite. Se você se sente confortável usando a linha de comando, recomendamos a ferramenta de terminal SQLite3. Caso contrário, você pode usar um aplicativo gráfico como o SQLiteStudio, que oferece uma interface amigável para trabalhar com o banco de dados.

SQLite3

O SQLite vem instalado por padrão em sistemas Unix como o Mac. Para Windows, você pode baixá-lo na página oficial.

Depois de instalá-lo:

1. Selecione o site local dentro do Studio.
2. Clique na aba Visão geral.
3. Clique no botão Terminal.
4. No seu terminal, execute o seguinte comando para interagir com seu banco de dados:
   sqlite3 wp-content/database/.ht.sqlite

Saiba mais sobre como usar o SQLite3 pelo terminal na documentação do SQLite3.

SQLiteStudio

Se você prefere usar um aplicativo com interface gráfica, pode usar o SQLiteStudio.

Depois de instalá-lo:

1. Encontre a pasta wp-content/database/ no seu Explorador de Arquivos ou Finder.
2. Certifique-se de que os arquivos ocultos estejam visíveis.
3. Abra o SQLiteStudio.
4. Arraste e solte o arquivo .ht.sqlite no aplicativo.

Como posso usar o Studio com o servidor MySQL da minha escolha?

O WordPress Studio tem suporte integrado para banco de dados SQLite, mas você pode usar o servidor MySQL da sua escolha, por exemplo, Homebrew ou Docker, para testar seu site com diferentes mecanismos de banco de dados.

Se você já tem um site local configurado para funcionar com um servidor MySQL personalizado da sua escolha, pode adicioná-lo ao Studio. Se os arquivos do site incluírem um arquivo wp-config.php, o Studio ignorará a configuração do banco de dados SQLite e usará o banco de dados já configurado.

Se você já criou um site no Studio e deseja trocar o SQLite pelo servidor MySQL de sua preferência, siga os passos abaixo:

1. Pare o site.
2. Abra o diretório do seu site no Studio.
3. Navegue até o diretório wp-content e exclua o arquivo db.php e o diretório database.
4. Navegue até o diretório mu-plugins e exclua o diretório sqlite-database-integration-main.
5. Atualize o arquivo wp-config.php e preencha as credenciais do seu servidor MySQL.
6. Inicie o site.
7. Inicie o seu servidor MySQL.
8. Abra o site.

Como seleciono as versões do PHP e do WordPress para o meu site? 

Você pode selecionar a versão do PHP ou a versão do WordPress para o seu site ao criá-lo pela primeira vez. Essa opção está localizada na seção “Configurações Avançadas“. Após criar um site, as versões atuais do PHP e do WordPress são exibidas na aba de configurações do site, onde você também pode editá-las e alterá-las.

1. Selecione o site desejado na barra lateral. 
2. Clique na aba Configurações. 
3. Clique no botão Editar no canto superior direito. 
4. Na caixa de diálogo, selecione as versões desejadas do PHP e do WordPress. 
5. Clique no botão Salvar para aplicar as alterações. 

Por que o botão “Abrir em” não está disponível para o meu aplicativo preferido?

Para cada um dos seus sites locais, as seguintes opções de “Abrir em…” estão disponíveis:

Gerenciadores de Arquivos:

• Finder (para macOS)
• Explorador de Arquivos (para Windows)

Editores de Código:

• VS Code
• PhpStorm
• Windsurf
• Webstorm
• Cursor

Aplicativos de terminal:

• Terminal (para macOS)
• iTerm (para macOS)
• Warp (para macOS)
• Command Prompt (para Windows)
• Ghostty

O WordPress Studio, os editores de código e os aplicativos de terminal devem estar na pasta Aplicativos para garantir que as opções de Abrir em… estejam disponíveis.  Se você não selecionou um editor de código preferido nas Configurações do Usuário, nenhum botão de editor de código aparecerá na área Abrir em…. Da mesma forma, se nenhum aplicativo de terminal estiver selecionado, o padrão será:

• Terminal no macOS
• Command Prompt no Windows

Como posso tornar o Studio mais rápido no Windows?

Se o Serviço de Proteção em Tempo Real do Windows Defender estiver habilitado na sua máquina, ele pode tornar mais lento o processo de criação e inicialização de um site, especialmente ao executar arquivos PHP do WordPress.

Por isso, o WordPress Studio solicita que você “acelere a criação de sites” ao criar seu primeiro site, para que uma política de exclusão possa ser adicionada ao Serviço de Proteção em Tempo Real.

Você pode adicionar essa política de exclusão manualmente navegando até Ajuda -> Quer acelerar a criação de sites? no Studio.

Como posso regenerar minhas miniaturas?

Se algumas miniaturas estiverem faltando após a importação do seu site, você pode regenerá-las executando o seguinte comando WP-CLI:

wp media regenerate --yes --only-missing

Se o WP-CLI não estiver instalado localmente, você pode pedir ao Studio Assistant para executar esse comando por você. Basta solicitar: “Por favor, regenere minhas imagens usando WP-CLI.”

Como posso acessar os logs do Studio?

Ocasionalmente, ações como Enviar ou Puxar na aba Sincronização, ou Importar e Exportar, podem falhar por diferentes motivos relacionados ao PHP, ao banco de dados do site ou a problemas com código personalizado.

Se isso acontecer, o WordPress Studio permitirá que você abra os logs e poderá solicitar que você entre em contato com o suporte. Você também pode abrir os logs manualmente.

Se você usa o Studio no Mac:

1. Abra o Terminal.
2. Digite o comando:
   open ~/Library/Logs/Studio
3. Localize o arquivo de log mais recente e abra-o.

Se você usa o Studio no Windows:

1. Abra o Terminal.
2. Digite o comando:
   ii AppDataRoamingStudiologs
3. Localize o arquivo de log mais recente e abra-o.

É possível alterar a porta ou a URL do meu site Studio?

Por padrão, os sites Studio recebem uma porta única a partir de 8881. Por exemplo, seu primeiro site Studio usa a URL http://localhost:8881, e seu segundo site usa http://localhost:8882. Embora a porta das URLs localhost não possa ser modificada pelo Studio, você sempre pode usar um domínio personalizado em vez de localhost.

Como posso usar uma ferramenta de tunelamento (ngrok) com o Studio?

Você pode usar o WordPress Studio para desenvolvimento local de WordPress que exija conexões de entrada configurando uma ferramenta de tunelamento como o ngrok. O ngrok, que é gratuito, redireciona requisições externas para o seu localhost, tornando seu site acessível pela internet. Isso é especialmente útil para plugins como o Jetpack, que entra em modo offline por padrão quando executado localmente. Ao usar uma ferramenta de tunelamento, seu site local pode se reconectar ao WordPress.com, o que desbloqueia todos os recursos do Jetpack e cria um ambiente de desenvolvimento mais realista.

Siga os passos abaixo para configurar seu site para esse fluxo de trabalho. Comece iniciando seu site local no Studio e configurando a ferramenta de tunelamento.

Se o seu site usa um domínio local no formato localhost:porta:

1. Inicie seu site Studio e anote a porta (por exemplo, 8883). A porta também pode ser encontrada na aba Configurações.
2. Abra um terminal e configure o ngrok caso ainda não tenha feito isso.
3. Configure um túnel para expor seu site local usando o seguinte comando:
   ngrok http 8883

 Se o seu site usa um domínio local personalizado:

1. Inicie seu site Studio e anote o domínio (por exemplo, my-wordpress-website.wp.local). O domínio também pode ser encontrado na aba Configurações.
2. Abra um terminal e configure o ngrok caso ainda não tenha feito isso.
3. Configure um túnel para expor seu site local usando o seguinte comando:
   ngrok http --host-header=my-wordpress-website.wp.local http://my-wordpress-website.wp.local

Quando o túnel estiver ativo, anote a URL do túnel e atualize-a no arquivo de configuração do WordPress do seu site Studio.

1. Copie a URL do túnel gerada. Ela será parecida com isto:
   https://6xb2-12-13-14-15.ngrok-free.app
2. Atualize a configuração do WordPress (wp-config.php) adicionando:
   define( 'WP_SITEURL', 'https://6xb2-12-13-14-15.ngrok-free.app' );
define( 'WP_HOME', 'https://6xb2-12-13-14-15.ngrok-free.app' );
3. Atualize seu site no navegador.

Seu site local do Studio agora deve estar acessível pela URL do túnel. Se o redirecionamento não acontecer automaticamente, limpar o cache do navegador pode ajudar. Você também pode acessar o site diretamente usando a URL do túnel gerada. 

A URL local exibida na aba Configurações não será atualizada para refletir a nova URL do túnel. Como a URL do ngrok muda cada vez que você reinicia o túnel, será necessário atualizar o arquivo wp-config.php de acordo.

Para redefinir seu site local, pare o túnel no terminal e encerre o site do Studio. Em seguida, remova as alterações feitas no wp-config.php e reinicie seu site do Studio. Ele voltará a usar o localhost ou o domínio personalizado exibido na aba Configurações.

Como posso exportar meu site para uso no site do WordPress Playground?

O WordPress Studio é baseado no WordPress Playground. Se você deseja importar seu site local para o playground.wordpress.net, crie um arquivo ZIP com o conteúdo da pasta do seu site e use o Site Explorer para importar o ZIP no seu navegador.

Observação: os itens de nível superior, como wp-config.php, devem estar na raiz do arquivo compactado. Para isso, selecione todos os arquivos e diretórios dentro da pasta do site ao criar o arquivo ZIP, em vez de selecionar a própria pasta do site.

Perguntas frequentes sobre o Assistente do Studio

Aqui estão algumas respostas para perguntas comuns sobre o Assistente do Studio. Consulte a documentação do Assistente do Studio para instruções passo a passo e dicas úteis sobre como usar esse recurso.

De onde vêm as respostas do Assistente?

O Assistente utiliza a infraestrutura do WordPress.com e nossa base de conhecimento sobre WordPress para fornecer respostas úteis usando Geração Aumentada por Recuperação (Retrieval Augmented Generation). Por isso, ele precisa de conectividade com a internet e estar conectado a uma conta do WordPress.com.

Quais idiomas o Assistente do Studio suporta?

Os exemplos de prompts que você vê ao começar a usar o Assistente serão exibidos no idioma escolhido para o Studio. Dito isso, você pode conversar com o Assistente em qualquer idioma que preferir. 

Posso usar o Assistente do Studio sem uma conta do WordPress.com?

Não, você precisa fazer login no Studio com sua conta do WordPress.com para usar o Assistente do Studio. Isso porque usamos a infraestrutura do WordPress.com para gerar mensagens e gerenciar o acesso.

Existe algum custo para usar o Assistente do Studio?

É gratuito para qualquer usuário do WordPress.com, independentemente do plano que você tenha. 

Quantos prompts posso usar por mês?

Cada usuário tem direito a 200 prompts por mês em todos os seus sites do Studio. Se você atingir esse limite, será necessário aguardar até o próximo mês para que a contagem de prompts seja reiniciada.

Onde posso dar feedback sobre as respostas do Assistente do Studio?

Existem duas formas de dar feedback sobre as respostas do Assistente.

Primeiro, há um mecanismo de feedback integrado às respostas. Basta clicar em Sim ou Não no final de cada resposta para enviar feedback à equipe do WordPress Studio.

Segundo, você pode escrever para o suporte para compartilhar feedback específico sobre as respostas do Assistente. 

Perguntas frequentes sobre o Studio Sync

Aqui estão algumas respostas para perguntas comuns sobre o recurso Studio Sync. Consulte a documentação do Studio Sync para instruções passo a passo e dicas úteis sobre como usar esse recurso.

Por que meus usuários locais não aparecem no site WordPress.com após o envio?

Ao enviar, o WordPress Studio exporta todo o seu conteúdo e todo o seu banco de dados, exceto as tabelas wp_users e wp_usermeta. Isso garante que os recursos do seu site WordPress.com alimentados pelo Jetpack (como login único ou otimização de imagens) continuem funcionando após o envio.