Índice

Objetivo

O objetivo deste guia é apresentar as ações necessárias para a criação de uma biblioteca personalizada.

Conceito

Uma biblioteca personalizada é um arquivo com snippets de códigos que podem ser reaproveitados na criação de layouts. A Biblioteca WCM é parte integrante da plataforma, porém, existe a possibilidade do usuário desenvolvedor criar a sua própria biblioteca.

Como criar a biblioteca?

Para criar a sua própria biblioteca, é necessário efetuar os seguintes passos:

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 personalizada segue o mesmo exemplo da importação 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, acesse a documentação do freemarker e/ou utilizar o código abaixo como exemplo:

...