TYPO3 Templates e Sitepackages: Personalizado, não pronto

Templates TYPO3 prontos economizam tempo no curto prazo e custam mais no longo prazo

A tentação é grande: comprar um template TYPO3 pronto por 79 euros, instalar, trocar o logo, pronto. Na realidade, começa aí um ciclo de workarounds, overrides e conflitos de versão que dificulta cada atualização e freia a evolução. dmpr_template é exemplar para essa categoria. A Gosign recomenda em vez disso Custom Sitepackages: pacotes de template individuais, exatamente adaptados aos requisitos, mantidos e versionáveis.

Um sitepackage é uma extensão TYPO3 que contém toda a configuração de frontend: TypoScript, templates Fluid, Partials, Layouts, CSS/SCSS, JavaScript e Backend Layouts. É a melhor prática oficial do TYPO3 desde a versão 8 e substitui o método antigo de configurar templates no sistema de arquivos.

Cenários típicos de uso

Relaunch corporativo com requisitos individuais. Uma empresa inicia um relaunch do site. O design está como arquivo Figma, a arquitetura de informação como sitemap, os tipos de conteúdo estão definidos. Um sitepackage customizado traduz essas especificações 1:1 para o TYPO3: cada tipo de conteúdo é mapeado como Backend Layout ou Custom Content Element, os templates Fluid correspondem ao design com precisão de pixel. Nenhum framework de template fica no meio forçando compromissos.

Setup multi-site com componentes compartilhados. Uma corporação opera 5 sites de marcas em uma instância TYPO3. Todos compartilham um sitepackage base com sistema de grid, tipografia e componentes base. Cada marca tem um sitepackage próprio que estende a extensão base: cores, logo, layouts específicos da marca. Alterações na base se refletem em todos os 5 sites, sem precisar manter 5 codebases separados.

Migração de configurações de template antigas. Instalações TYPO3 das versões 6 ou 7 frequentemente usam TemplaVoilà, Fluid Styled Content com overrides TypoScript extensivos ou até templates baseados em marcadores. A migração para um sitepackage limpo moderniza todo o stack de frontend em um passo: longe de configurações TypoScript globais, rumo a uma extensão versionável com estrutura de diretórios clara.

Arquitetura técnica

Um sitepackage é uma extensão TYPO3 regular com uma estrutura de diretórios definida:

Configuration/TypoScript/ contém a configuração TypoScript: Constants, Setup, Page-TSconfig. Aqui é definido quais templates valem para quais tipos de página, quais elementos de conteúdo estão disponíveis e como são renderizados.

Resources/Private/Templates/ contém os templates Fluid para tipos de página (Page), elementos de conteúdo (ContentElements) e Partials (fragmentos de template reutilizáveis). A separação em Templates, Partials e Layouts segue a convenção Fluid do TYPO3.

Resources/Public/ contém CSS/SCSS, JavaScript, imagens e fontes. Tudo que o navegador entrega diretamente. Em setups modernos, SCSS é compilado por ferramentas de build (Vite, Webpack) e os arquivos gerados ficam em Resources/Public/Build/.

Configuration/TCA/ define Backend Layouts e Custom Content Elements. Backend Layouts controlam quais colunas e áreas estão disponíveis em uma página no backend. Custom Content Elements são definidos via TCA, TypoScript e templates Fluid.

O sitepackage é instalado via Composer e atribuído à respectiva TYPO3 Site pela Site Configuration (config.yaml). Vários sites podem usar o mesmo sitepackage (multi-site) ou cada um ter o próprio.

Problemas frequentes e soluções

Templates prontos colidem com atualizações do TYPO3. Templates comprados frequentemente sobrescrevem configurações do Core e definições TCA de uma forma que quebra em atualizações do TYPO3. Um template desenvolvido para TYPO3 v10 frequentemente não funciona após atualização para v12, porque TCA Wizards, registro de Backend Layout e Fluid ViewHelpers mudaram. Com um sitepackage customizado, controla-se quais funcionalidades do Core são utilizadas e atualizações podem ser feitas gradualmente.

Estrutura do sitepackage cresce descontroladamente. Ao longo dos anos, acumulam-se dezenas de Partials, templates órfãos e fragmentos TypoScript em um sitepackage. Solução: refactoring regular. Um sitepackage limpo tem no máximo 20 a 30 Partials, convenções claras de nomenclatura (PascalCase para templates, pastas por função) e nenhum arquivo não utilizado. O esforço para um refactoring é de 2 a 5 dias, dependendo do tamanho.

Conflitos de especificidade CSS com Fluid Styled Content. O Fluid Styled Content do TYPO3 traz classes CSS próprias (ce-, frame-). Se o sitepackage usa classes próprias, surgem conflitos de especificidade. Solução: substituir completamente o Fluid Styled Content por definições próprias de elementos de conteúdo (mais limpo, mas mais trabalhoso) ou sobrescrever os templates Fluid Styled Content e adaptar as classes.

Migração e compatibilidade de versões

O conceito de sitepackage é o padrão desde TYPO3 v8 e é desenvolvido em cada nova versão do TYPO3. A estrutura fundamental (extensão com TypoScript, templates Fluid, TCA) permanece estável. Ajustes em atualizações major normalmente afetam sintaxe TCA (Wizards, renderTypes), condições TypoScript (nova: Symfony Expression Language) e registro de módulos backend.

A migração de um template pronto (dmpr_template, j77_template, in2template) para um sitepackage customizado é uma reescrita, não uma portabilidade. Analisa-se os templates existentes, extrai-se a funcionalidade desejada e constrói-se em uma estrutura de sitepackage limpa. Para um projeto típico com 10 tipos de página e 15 elementos de conteúdo, o esforço é de 2 a 3 semanas.

TYPO3 v13 introduz Content Blocks como novo conceito para definições de elementos de conteúdo. Content Blocks simplificam consideravelmente a criação de Custom Content Elements e reduzem o código boilerplate. Sitepackages não são afetados, podem utilizar Content Blocks adicionalmente. A Gosign constrói exclusivamente sitepackages customizados há anos e tem experiência para migrar configurações de template existentes eficientemente para estruturas modernas.