Como exemplo, vejamos o primeiro tema listado acima, "User Actions Log: Notification Mail". Para este sítio de exemplo, o formato do editor foi definido como HTML nas Opções de modelos de email. Como pode ver, o título, o ID e a descrição do tema não podem ser modificados. As tags de marcador de posição reconhecidas no tema selecionado estão listadas à direita da janela do editor. Estas são as únicas tags que podem ser utilizadas neste tema em particular; estas variam de tema para tema. Clicar numa das hiperligações de tags à direita insere essa tag no editor na posição atual do cursor. Neste exemplo, todas as tags disponíveis, exceto {IP_ADDRESS}, já aparecem no tema.

Não existe documentação sobre como utilizar estas tags, para além dos exemplos fornecidos pelo respetivo código do tema predefinido, e mesmo aí a sua utilização é apenas implícita. Como pode ver neste caso, a maioria das tags é de instância única. Apenas a tag {MESSAGES} é uma tag iterativa, o que significa que faz com que as tags de instância única utilizadas entre as tags {MESSAGES} e {/MESSAGES} sejam repetidas ao longo do intervalo fornecido pela extensão que utiliza este tema.

Mail Templates Editor

Este tema predefinido foi concebido para utilizar uma tabela HTML para formatar o resultado numa disposição tabular, o que faz muito sentido. O aspeto iterativo da tag {MESSAGES} fará com que uma linha seja criada dinamicamente para cada {MESSAGE} incluída no âmbito das ações do utilizador às quais a mensagem de email gerada se aplica. Quando o formato Texto simples é selecionado nas Opções globais de modelos de email, o mesmo tema aparece um pouco como marcação.

Plaintext Mail Template Editor

O separador Opções do editor de modelos de email fornece opções específicas do tema que sobrepõem-se às opções globais de modelos de email. Na maioria dos casos, não deverá ser necessário modificar estas configurações.

Options tab of the Mail Template Editor

  • Configurações de email: Se definido como Sim, permite-lhe sobrepor a configuração predefinida da conta do servidor de email do sítio. Na maioria dos casos, provavelmente não precisará de alterar isto.
  • Disposição do tema de email: Autoriza ou desativa a utilização da disposição selecionada abaixo.
  • Disposição: Selecione a disposição global ou outra disposição, se disponível.
  • Ficheiro do logótipo: Autoriza ou desativa a utilização do ficheiro do logótipo definido nas Opções globais de modelos de email.