Criar template joomla do zero - IV

Olá, WEBloucos.

Introdução aos parâmetros do template Joomla!

Obs.: Tag muito importante de conhecer para aqueles que desejam criar seu template Joomla.

Para ver um exemplo dos parâmetros em ação, vá em Extensões >> Template Manager e clique no template rhuk_milkyway. Em Template: [Editar] há parâmetros de Variação de Cores e Variação de Background. Os parâmetros permitem que você escolha a variação de cores que você quer, assim como o background.

Em seu template Joomla!, para adicionar parâmetros à sua criação siga os seguintes passos:

1. Adicione <param>elemento</params> no arquivo templateDetails.xml, logo abaixo de <install> (A partir da versão Joomla 1.6 a tag <install> será substituída por <extension>).
2. Adicione uma linha ao arquivo param.ini que irá armazenar o valor atual do parâmetro.
3. Adicione o código no arquivo modelo em PHP, para recuperar o valor atual do parâmetro e agir sobre ela.

Não entendeu nada? Calma, continue lendo.

Definindo um parâmetro no templateDetails.xml

Para cada parâmetro que quiser definir, terá que criar uma nova linha contendo <param>elemento</param>

Esse elemento tem um número de argumentos obrigatórios e opcionais que dependem do tipo de argumento. Os argumentos obrigatórios são os seguintes:

type: especifica o tipo de controle que será usado no modelo.
name: é o nome único do parâmetro. Você irá referir-se a este nome ao recuperar o valor do parâmetro no código do modelo.

Os seguintes argumentos são opcionais, comuns a quase todos os tipos de parâmetro:

default: é o valor padrão do parâmetro.
description: texto que será exibido para explicar a escolha ao administrador.
label: título do campo que será mostrado ao administrador na tela de Parâmetros do Modelo. Se o argumento for omitido label será padrão para o valor determinado pelo argumento.

Os argumentos opcionais dependem do tipo de parâmetro. Cada um dos tipos de parâmetro é descrito em detalhes na Standard parameter types (Norma de tipos de parâmetros. Se você for um programador, também é possível criar o seu próprio tipo de parâmetro personalizado; consulte Criar XML personalizados com tipos de parâmetros para mais informações.

Abaixo, por exemplo, mostra uma seção com dois parâmetros: um com menu drop-drow, com opções de cores para o modelo e outra para um botão que permitirá ao usuário mostrar ou ocultar a mensagem de direitos autorais.

<params>
<param name="templateColour" type="list" default="blue"
label="Template Colour" description="Choose the template colour.">
<option value="blue">Blue</option>
<option value="red">Red</option>
<option value="green">Green</option>
<option value="black">Black</option>
</param>
<param name="authorCopyright" type="radio" default="1"
label="Author Copyright" description="Show/Hide author copyright.">
<option value="0">hide</option>
<option value="1">show</option>
</param>
</params>

São 21 tipos de parâmetros diferentes, suportados no Joomla Framework em todos os tipos de extensão (templates, components, modules and plugins).

Não vou descrever cada um porque mesmo para quem não sabe inglês, poderá ter uma noção da utilidade e função de cada uma, acessando a página de tutorial do próprio Joomla! aqui: http://docs.joomla.org/Tutorial:Template_parameters. É só dar uma boa olhada no que tem na parte "Standard parameter types in detail" (onde tem a imagem de um calendário).

Verão que as opções que o Joomla! nos apresenta, na área do administrador, são formadas pelo <param>. Por isso eu disse lá em cima que esta é uma tag muito importante de conhecer para aqueles que desejam criar seu template Joomla!.

Em params.ini

Este arquivo deve conter os tipos de parâmetos do template padrão.

No rhuk_milkyway, que citamos como exemplo, o conteúdo de params.ini é:

• colorVariation=blue
• backgroundVariation=blue
• widthStyle=fmax

No ja_purity, o conteúdo é:

• logoType=image
• logoText=Joomla!
• sloganText=...because open source matters
• ja_font=3
• ja_screen=fluid
• ja_screen_width=97
• theme_header=
• theme_background=lighter
• theme_elements=black
• horNav=1
• horNavType=css
• rightCollapsible=1
• rightCollapseDefault=show
• excludeModules=38
• showComponent=1

De férias e cheia de trabalho acumulado. Oh, céus...
Enquanto não puder contar com um clone próprio terei que me virar com o pouco tempo que tenho. Tenham paciência.
Da próxima vez, vamos conhecer os módulos.

Dá uma olhadinha aqui também: http://docs.joomla.org/Creating_custom_template_parameter_types

Suporte Joomla pt-br:
http://forum.joomla.org/viewforum.php?f=23&sid=86563b1071727b50cf252c757a6e353c
Ou no grupo Joomla Brasil, do google: http://groups.google.com/group/brasjoomla (adoro a turminha desse grupo, são ótimos!)

WEBbeijos

Criar template joomla do zero - IV

Criar template joomla do zero - III

Criar template joomla do zero - II

Criar template joomla do zero

Os 10 Mais: Erros mais estúpidos do administrador Joomla!

Como implantar PagSeguro no Joomla! (Grátis)

Gmail no Joomla 1.5