User Documentation Como exemplo, vamos observar o primeiro tema listado acima, "Log de Ações do Usuário: E-mail de Notificação". Para este site de exemplo, o formato do editor foi definido como HTML nas opções de temas de e-mail. Como você pode ver, o título do tema, o ID e a descrição não podem ser modificados. Os marcadores de espaço reservado reconhecidos no tema selecionado são listados à direita da janela do editor. Estes são os únicos marcadores que podem ser usados dentro deste tema em particular; eles variam de tema para tema. Clicar em um dos links de marcador à direita irá inserir aquele marcador no editor na posição atual do cursor. Neste exemplo, todos os marcadores disponíveis já aparecem no tema.
Não há documentação sobre como usar esses marcadores além dos exemplos fornecidos pelo respectivo código do tema padrão, e mesmo ali seu uso é apenas implícito. Como você pode ver neste caso, a maioria dos marcadores é de instância única. Somente o marcador {MESSAGES} é um marcador iterativo, o que significa que ele faz com que os marcadores de instância única usados entre os marcadores {MESSAGES} e {/MESSAGES} sejam iterados pelo intervalo fornecido pela extensão que usa este tema.
Este tema padrão foi criado para usar uma tabela HTML para formatar a saída em uma disposição tabular, o que faz muito sentido. O aspecto iterativo do marcador {MESSAGES} fará com que uma linha seja criada dinamicamente para cada {MESSAGE} incluída no escopo das ações do usuário às quais a mensagem de e-mail gerada se aplica. Quando o formato de texto simples é selecionado nas opções globais de temas de e-mail, o mesmo tema parece um pouco com marcação.
A aba de opções do editor de temas de e-mail fornece opções específicas do tema que substituem as opções globais de temas de e-mail. Na maioria dos casos, você não deve precisar modificar essas configurações.
- Configurações de e-mail: Se definido como Sim, permite substituir a configuração padrão da conta do servidor de e-mail do site. Na maioria dos casos, você provavelmente não precisará alterar isso.
- Disposição (layout) do tema de e-mail: Ativa ou desativa o uso da disposição selecionada abaixo.
- Disposição (layout): Selecionar a disposição global ou outra disposição, se disponível.
- Arquivo de logotipo: Ativa ou desativa o uso do arquivo de logotipo definido nas opções globais de temas de e-mail.