--- title: "Depurando problemas de espaço reservado" description: "Entendendo os espaços reservados no PageForge O PageForge depende muito de marcadores de posição para gerar conteúdo dinamicamente. Esses marcadores de posição são essencialmente tokens dentro..." url: https://pageforge.pro/pt/knowledgebase/depurando-problemas-de-espaco-reservado/ date: 2026-01-17 modified: 2026-03-28 author: "PageForge" type: knowledge_base lang: en --- # Depurando problemas de espaço reservado ## Entendendo os espaços reservados no PageForge O PageForge depende muito de marcadores de posição para gerar conteúdo dinamicamente. Esses marcadores de posição são essencialmente tokens dentro do seu modelo que são substituídos por dados reais dos seus arquivos CSV quando as páginas são geradas. Entender como os marcadores de posição funcionam é crucial para solucionar quaisquer problemas relacionados a eles. ### O que são marcadores de posição? Os marcadores de posição são sequências de texto delimitadas por chaves, como por exemplo: `{Cidade}` ou `{Serviço}`, usado em modelos para representar dados variáveis. Ao carregar um arquivo CSV, o PageForge lê os cabeçalhos da primeira linha e os trata como chaves para marcadores de posição. Cada linha subsequente de dados fornece os valores que substituirão esses marcadores de posição. **Casos de uso comuns:** - **SEO local:** Criar páginas para vários locais usando marcadores como `{Cidade}`, `{Estado}`. - **Variações de serviço:** Oferecer serviços diferentes em locais diferentes usando marcadores como `{Serviço}`. - **SEO programático:** Geração de páginas para tipos de postagem personalizados com layout consistente, mas conteúdo variável. ### Etapas básicas de resolução de problemas Quando os marcadores de posição não funcionam como esperado, muitas vezes acabam aparecendo como texto simples nas páginas geradas. Aqui estão alguns passos para solucionar esses problemas: ### Etapa 1: Verificar os cabeçalhos do arquivo CSV Certifique-se de que os cabeçalhos do seu arquivo CSV correspondam aos espaços reservados nos seus modelos. Os cabeçalhos funcionam como chaves, portanto, qualquer discrepância, como erros de ortografia ou capitalização incorreta, pode resultar na não substituição dos espaços reservados. **Exemplo:** Se o cabeçalho do seu CSV for `Cidade`, seu marcador de posição deve ser `{Cidade}`, não `{cidade}` ou `{CIDADE}`. Embora o PageForge não diferencie maiúsculas de minúsculas, é essencial que a grafia seja exata. ### Etapa 2: Verificar a configuração do modelo Revise as configurações do seu modelo para garantir que os espaços reservados estejam definidos corretamente nos padrões de conteúdo, título e slug. Modelos mal configurados podem causar problemas em que os espaços reservados não são reconhecidos. **Padrões de título e lousa:** - Certifique-se de que seus padrões de título e slug estejam configurados corretamente para usar marcadores de posição. - Exemplo: `Melhor {Serviço} em {Cidade}, {Estado}` para títulos. ### Etapa 3: Inspecionar os metadados da página gerados Cada página gerada deve conter metadados que incluam os pares chave-valor da linha do arquivo CSV. Verifique os metadados da postagem para ver se variáveis ​​como `_pageforge_city`, `_pageforge_state`, e `_pageforge_service` estão presentes. **Como verificar:** - Acesse a página gerada no painel de administração do WordPress. - Inspecione a seção de metadados da postagem para verificar a presença de `_pageforge_vars` metadados. ### Etapa 4: Avaliar o uso do token de IA Se o seu modelo usa tokens de IA como `{AI:Artigo}` ou `{AI:Imagem}`Certifique-se de que suas chaves de API estejam configuradas corretamente nas Configurações. Chaves de API ausentes ou incorretas podem impedir o funcionamento desses tokens. **Etapas de configuração:** - Acesse a página de configurações do PageForge. - Certifique-se de que as chaves da API de IA sejam inseridas e salvas. - Teste a conexão para confirmar o acesso à API. ### Etapa 5: Verificação de conteúdo duplicado O PageForge verifica se já existe um slug antes de gerar uma nova postagem. Se já existir uma postagem com o mesmo slug, o processo de geração falhará para essa linha, deixando os espaços reservados sem resolução. **Solução:** - Altere o padrão de slug no seu modelo. - Elimine as postagens duplicadas, se necessário. ## Técnicas avançadas de resolução de problemas Se a resolução de problemas básicos não solucionar os problemas, talvez seja necessário explorar técnicas mais avançadas. ### Depurando problemas com arquivos CSV Problemas de formatação em arquivos CSV também podem causar falhas nos marcadores de posição. Certifique-se de que seu arquivo CSV esteja em conformidade com as seguintes diretrizes: - A primeira linha deve conter os cabeçalhos. - Cada linha subsequente deve conter dados correspondentes a esses cabeçalhos. - Evite linhas em branco e certifique-se de usar o delimitador correto (vírgula, ponto e vírgula, tabulação ou barra vertical). ### Inspecionando a fila e o agendador Se estiver usando o modo de fila, verifique se o agendador está processando os itens corretamente. Um agendador mal configurado pode fazer com que algumas linhas não sejam processadas, deixando espaços reservados sem resolução. **Passos para verificar:** - Verifique o status da fila no painel do PageForge. - Certifique-se de que o agendador esteja habilitado e configurado para processar um número razoável de páginas diariamente. - Confirme se as tarefas agendadas do WordPress estão sendo executadas corretamente no servidor. ### Analisando os códigos curtos e a substituição em tempo de execução. Os marcadores de posição também podem ser usados ​​em shortcodes para substituição em tempo de execução em construtores e widgets. Se os marcadores de posição não forem substituídos corretamente, certifique-se de que os shortcodes sejam usados ​​em contextos compatíveis, como blocos do Gutenberg ou widgets do Elementor. **Exemplos de códigos curtos:** `` ou `` ### Segurança e Permissões Certifique-se de que as permissões necessárias do WordPress sejam concedidas aos usuários que trabalham com o PageForge. A falta de permissões pode impedir o funcionamento correto dos espaços reservados. **Habilidades necessárias:** - `gerenciar_opções` para acessar as configurações do PageForge. - `editar_postagens` para criar e editar modelos e páginas. - `enviar_arquivos` para carregar arquivos CSV. ## Casos de uso e melhores práticas para agências Para agências que gerenciam vários sites de clientes, garantir a configuração correta de espaços reservados é vital para a geração de conteúdo escalável. Aqui estão algumas práticas recomendadas: ### Convenções de nomenclatura consistentes Utilize convenções de nomenclatura consistentes para cabeçalhos e espaços reservados em arquivos CSV em diferentes projetos. Isso garante que os modelos possam ser reutilizados com ajustes mínimos. ### Gerenciamento de modelos e arquivos CSV Mantenha uma biblioteca de modelos testados e arquivos CSV de exemplo. Isso ajuda a configurar novos projetos rapidamente e reduz a probabilidade de erros. ### Auditorias e backups regulares Audite regularmente as páginas geradas para garantir que os espaços reservados estejam funcionando conforme o esperado. Mantenha backups dos arquivos CSV e dos modelos para facilitar a recuperação em caso de problemas. ## Conclusão O uso eficaz de marcadores de posição no PageForge é essencial para a geração de conteúdo dinâmico. Seguindo os passos de resolução de problemas descritos acima, você pode solucionar problemas comuns e garantir que seus modelos funcionem conforme o esperado. Seja para gerar páginas de SEO local, variações de serviços ou conteúdo de SEO programático, compreender a função dos marcadores de posição ajudará você a aproveitar todo o potencial do PageForge. Solucione problemas de espaços reservados no PageForge com nosso guia detalhado. Aprenda sobre configuração, erros comuns e boas práticas para agências.