Conceito

Uma biblioteca customizada é um arquivo com snippets de códigos que podem ser reaproveitados na criação de layouts, a Biblioteca WCM já vem disponível com o produto, porém existe a possibilidade do usuário criar a sua própria biblioteca.

Como criar a biblioteca?

Primeiro navegar até a pasta de templates que fica localizada em: Diretório de instalação do Fluig > repository > wcmdir > templates

Dentro da pasta de templates crie um arquivo .ftl, ex: custom.ftl

O arquivo da biblioteca pode conter vários snippets de código.

Como criar snippets novos?

Para criar snippets novos é necessário inserir uma macro nova no arquivo ftl da biblioteca, conforme mostrado a seguir:

<#macro NOME_DA_MACRO PARAMETRO1>
  <!-- Conteúdo da snippet -->
</#macro>
 
<#macro helloWorld>
  <h1>Hello world!</h1>
</#macro>

Snippet com parâmetros

Abaixo segue um exemplo de snippet que utiliza um parâmetro

<#macro funcao param1>
  <h1>${param1}!</h1>
</#macro>  

Como utilizar a biblioteca?

A importação da biblioteca customizada segue o mesmo exemplo da importação da Biblioteca WCM

No layout inserir o seguinte código:

<#import "/NOME_DO_ARQUIVO.ftl" as NAMESPACE/>

Após importar a utilização é similar ao da Biblioteca WCM

<#import "/custom.ftl" as custom/>
 
<@wcm.helloWorld/>
<@wcm.funcao param1="Exemplo de importação da biblioteca customizada"/>

Material para referência

Para mais informações sobre como criar snippets de código favor ler a documentação do freemarker