DCE para TYPO3

DCE foi por anos a primeira escolha para Custom Content Elements - agora a migração é necessária

Entre 2013 e 2020, DCE (Dynamic Content Elements) era junto com Mask o método mais popular para construir elementos de conteúdo próprios no TYPO3. Editores recebiam formulários de backend com exatamente os campos necessários, desenvolvedores definiam tudo via GUI, sem escrever uma linha de PHP ou TCA. Milhares de sites TYPO3 ainda rodam com DCE. O problema: o desenvolvimento desacelerou significativamente. Mask ultrapassou DCE em uso, e a partir do TYPO3 v13, com a API nativa Content Block, existe uma terceira alternativa que não requer overhead de extensão.

Quem tem DCE em uso não precisa migrar imediatamente. Mas quem planeja um upgrade TYPO3 para v12 ou v13 deve planejar a substituição, pois o suporte de longo prazo é incerto.

Cenários típicos de uso

Projetos existentes com 10 a 50 elementos DCE. Sites corporativos de médio porte construídos entre 2014 e 2020 com TYPO3 v7 a v10 usam DCE para tudo: caixas de teaser, abas, acordeões, galerias de imagens, blocos de citação, cartões de equipe. Os elementos funcionam, mas estão vinculados ao DCE. Em um upgrade TYPO3, é necessário verificar se o DCE roda na versão alvo.

Agências com múltiplos projetos TYPO3. Agências que usaram DCE como padrão em seus projetos enfrentam a questão: migramos todos os projetos de uma vez (grande esforço, corte limpo) ou projeto por projeto no próximo upgrade (passos menores, período mais longo)? A resposta depende do número de projetos afetados e da versão TYPO3 alvo planejada.

Prototipagem rápida para elementos de conteúdo. DCE é adequado para protótipos rápidos: um novo elemento de conteúdo é configurado em 15 minutos, incluindo formulário de backend e template Fluid. Para provas de conceito ou apresentações a clientes, isso pode ser suficiente. Para projetos produtivos, a Gosign recomenda Mask, pois o workflow de exportação (mask_export) e a manutenção ativa oferecem vantagens de longo prazo.

Arquitetura técnica

DCE armazena definições de elementos de conteúdo no banco de dados (tabela tx_dce_domain_model_dce), não em arquivos. Cada elemento DCE consiste em uma configuração (campos, tipos, validação), um template Fluid (diretamente no backend ou como referência de arquivo) e layouts de backend opcionais. Os campos são definidos na GUI do DCE: Text, RichText, Integer, Float, Date, File (FAL), Select, Checkbox, Group (IRRE), Section (fieldsets repetíveis).

Ao salvar, DCE gera a configuração TCA necessária e registra o elemento no Content Element Wizard. Os dados dos elementos de conteúdo ficam na tabela tt_content, estendida por campos FlexForm específicos do DCE. Essa arquitetura FlexForm é uma das principais diferenças para o Mask, que cria colunas de banco de dados próprias no tt_content.

Problemas frequentes e soluções

Dados FlexForm são difíceis de migrar. Como DCE armazena dados como XML FlexForm no tt_content, uma migração para Mask (que usa colunas próprias) não é trivial. O XML FlexForm deve ser parseado e os valores transferidos para os novos campos Mask. Solução: um script de migração que, por elemento DCE, lê os campos FlexForm e os escreve nos campos Mask correspondentes. A Gosign possui um comando CLI reutilizável que automatiza esse processo por elemento.

Containers DCE e elementos aninhados. DCE oferece uma lógica de container própria que aninha elementos de conteúdo uns dentro dos outros. Essa lógica é proprietária e não é compreendida por nenhum outro sistema. Solução na migração: converter estruturas de container para b13/container e reconstruir os elementos filhos como elementos Mask.

Performance com muitas definições DCE. Sites com mais de 40 elementos DCE têm tempos de carregamento perceptíveis no backend, porque todas as configurações FlexForm são lidas e parseadas do banco de dados a cada chamada. Solução: ativar cache DCE ou migrar para configuração baseada em arquivos.

Migração e compatibilidade de versões

DCE suporta TYPO3 v11 e v12. A compatibilidade com TYPO3 v13 é limitada: existe um branch de desenvolvimento, mas nenhum release oficialmente marcado como estável (status abril 2026).

Para a migração de DCE para Mask, a Gosign tem um processo padronizado: inventariar elementos DCE (campos, tipos, templates), reconstruir elementos Mask 1:1, migrar dados via script SQL (FlexForm XML para colunas Mask), adaptar templates Fluid, testar e desinstalar DCE. O esforço fica entre 0,5 e 2 horas por elemento, dependendo da complexidade. Um projeto com 25 elementos DCE é migrado em 3 a 5 dias.

A Gosign recomenda na decisão de migração uma análise pragmática de custo-benefício. Se o próximo upgrade TYPO3 está previsto para dentro de 12 meses e o DCE não roda de forma estável na versão alvo, a migração é inevitável. Se o projeto permanecerá mais 2 a 3 anos no TYPO3 v11 ou v12 e o DCE funciona de forma estável ali, a migração pode ser adiada para o próximo relançamento. Em todo caso, deve-se definir já agora se o alvo é Mask ou Content Block API, para que novos elementos de conteúdo sejam criados diretamente no sistema alvo.

Os custos totais de uma migração DCE dependem da quantidade e complexidade dos elementos. Um projeto com 15 elementos DCE simples (texto, imagem, link) é migrado em 2 dias. Um projeto com 40 elementos, dos quais 10 com aninhamento IRRE e 5 com lógica de container, precisa de 8 a 12 dias.