Sistemas de Gerenciamento de Conteúdo

Use esta habilidade quando o usuário estiver trabalhando em um sistema de gerenciamento de conteúdo ou em um software que se comporta como um.

Esta habilidade foca nas junções que importam no trabalho com CMS:

• Temas e templates
• Plugins, aplicativos, módulos e extensões
• Interfaces de administração e editor
• Gerenciamento de mídia e uploads
• Modelos de conteúdo, taxonomia e metadados
• Pipelines de renderização e fluxos de exportação estática

Quando Usar Esta Habilidade

• O usuário menciona uma plataforma de CMS como WordPress, Shopify, Drupal, Joomla, Webflow, Squarespace, Wix, WooCommerce, HubSpot CMS Hub ou Adobe Experience Manager.
• A tarefa é sobre desenvolvimento de temas, alterações de templates ou trabalho de sistema de design dentro de um CMS.
• A tarefa é sobre plugins, módulos, aplicativos ou pontos de extensão.
• A tarefa aborda UX do editor, pré-visualizações, taxonomia, slugs, campos de SEO ou comportamento de publicação.
• A tarefa envolve uploads, bibliotecas de mídia, ativos criados, renderização de markdown ou exportação estática.

Primeira Passagem

1. Identifique a categoria da plataforma: CMS auto-hospedado, construtor de sites SaaS, plataforma de comércio ou sistema híbrido/headless.
2. Encontre a junção de implementação proprietária antes de editar:
   • Camada de tema ou template
   • Camada de plugin, aplicativo, módulo ou extensão
   • Superfície de administração ou editor
   • Camada de modelo de conteúdo ou armazenamento
   • Pipeline de mídia
   • Pipeline de exportação, implantação ou renderização
3. Verifique as restrições da plataforma antes de escolher uma abordagem:
   • o que é editável localmente
   • o que é conteúdo criado versus código
   • onde a mídia pertence
   • se o site final é renderizado no servidor, exportado estaticamente ou hospedado remotamente

Regras de CMS

• Siga as convenções de nomenclatura e pastas da plataforma para temas, módulos, partes de template ou seções.
• Mantenha os ativos do tema separados da mídia enviada pelo usuário, a menos que a plataforma os combine explicitamente.
• Prefira campos de conteúdo estruturados em vez de armazenar metadados importantes dentro da marcação de apresentação.
• Trate pré-visualizações, slugs, taxonomia, resumos, campos meta e estados de publicação como preocupações de primeira classe do CMS.
• Prefira padrões seguros e comportamento de fallback gracioso quando a configuração, a seleção de tema ou a entrada de conteúdo forem inválidas.
• Ao alterar o comportamento do editor ou do administrador, rastreie o campo armazenado, as regras de validação, o caminho de pré-visualização e o caminho de renderização final juntos.

Fluxos de Trabalho Comuns

Temas e Templates

• Comece no carregador de templates ou no tempo de execução do tema, não em um include downstream.
• Preserve a hierarquia de templates da plataforma e as convenções de nomenclatura de partes.
• Mantenha as alterações de apresentação próximas aos templates e aos helpers de tema compartilhados.

Plugins, Aplicativos e Módulos

• Adicione comportamento na junção de extensão da plataforma em vez de espalhar a lógica em templates.
• Mantenha migrações, dados de seed e atualizações de configuração explícitos e versionados.
• Documente as suposições de configuração da extensão quando a plataforma exigir ativação ou registro.

UX de Administração e Editor

• Mantenha os formulários alinhados com o modelo de conteúdo armazenado.
• Prefira pré-visualizações voltadas para o autor quando as transformações de conteúdo não forem triviais.
• Mantenha a validação, salvaguardas CSRF ou equivalentes e permissões consistentes com o código de administração circundante.

Mídia e Uploads

• Use um caminho de upload dedicado para mídia criada.
• Mantenha imagens decorativas ou de propriedade do tema na pasta do tema ativo.
• Use por padrão locais convencionais como uploads/ para mídia criada e img/ para ativos de tema, a menos que a plataforma dite uma convenção mais forte.
• Quando um CMS suporta diretórios de mídia configuráveis, exponha a configuração com um fallback seguro.

Modelos de Conteúdo e Migrações

• Distinga claramente as entidades de conteúdo: páginas, posts, produtos, entradas, coleções, taxonomias e configurações.
• Prefira arquivos de migração ou definições de esquema exportáveis em vez de mutações ad hoc em tempo de execução.
• Mantenha slugs, datas de publicação, resumos, metadados canônicos e relações de taxonomia estruturados.

Markdown, HTML e Exportação Estática

• Decida se o markdown é entrada criada, conteúdo intermediário ou saída de build antes de alterar o renderizador.
• Emparelhe as alterações do renderizador com pré-visualização ou validação quando viável.
• Para sistemas de CMS com exportação estática, valide permalinks reescritos e caminhos de ativos após alterações de build.

Identificando a Junção Proprietária

Independentemente da plataforma, localize a junção proprietária antes de editar, mapeando a base de código para estas funções de CMS:

• Inicialização do tempo de execução e roteamento de requisições
• Controladores de administração ou editor e seus templates de visualização
• Carregamento de tema, hierarquia de templates e helpers de template compartilhados

…