Vamos aos módulos Joomla!

Olá, WEBloucos.

Eu e minha língua comprida. Encontrei "só" nove páginas tratando de módulos Joomla!
São elas:

1. Applying custom module chrome - Personalizando módulo
   
2. Core module chrome CSS - Explicando sobre o CSS
3. Core module-generated CSS - Explicando sobre o CSS
   
4. Counting modules in a given module position - Contando módulos em determinada posição
   
5. Counting modules in multiple module positions - Contando módulos em múltiplas posições
   
6. Declaring module positions - Declarando posição do módulo
   
7. Finding module positions on any given page -Encontrando a posição do módulo em qualquer página
   
8. Module positions - Posição do módulo
   
9. Tutorial: More on Joomla! modules - Mais sobre módulos Joomla!

E tem vários outros tutoriais em Módulos. Promessa é dívida e prometi falar dos módulos. Tenho que aprender também. :)
Vou começar pelos itens 6, 7 e 8. São os mais simples e atuarão como uma excelente introdução aos módulos. Depois sigo a ordem conforme a listinha dos itens acima.

I - Declarando posição do módulo

As posições de módulo disponíveis devem ser declaradas no templateDetails.xml do seu modelo de template. O elemento no arquivo deve trazer sub-elementos para cada posição do módulo que será suportado pelo seu template. Exemplo:

<positions>

<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
</positions>

Você pode adicionar e definir novas posições para Módulo e dar-lhes qualquer nome que desejar, mas é recomendável que você declare, pelo menos, as mostradas no exemplo acima. Numa mudança de modelo de template a coerência será mantida.

Utilização e aplicação

Um template Joomla! mostra um conjunto de módulos adicionados a uma posição específica utilizando <jdoc: include />, como no exemplo abaixo:

<jdoc:include type="modules" name="nome da posição do módulo" style="xhtml" />

Na index do template ja_purity, por exemplo, a pesquisa vem assim:

<?php if($this->countModules('user4')) : ?>
<div id="ja-search">
<jdoc:include type="modules" name="user4" />
</div>
<?php endif; ?>

É possível visualizar todos os módulos definidos em um modelo, chamando o "tp = 1", no front-end:

http://www.seudominio.com/index.php?tp=1

II - Encontrando posição do módulo em qualquer página

Para obter uma indicação visual de todas as posições módulo usado em uma página, você pode seguir este procedimento:

• Navegar até a página em seu navegador.
• Clique no campo URL no seu navegador.
• Olhar para qualquer "parâmetros", na parte final do URL. Esses são separados da parte principal da URL por um ponto de interrogação. Por exemplo, na URL http://seudominio.com/index.php?id=17, o "id = 17" é um parâmetro.
• Se não existem parâmetros, acrescente "?tp=1" à URL (seudominio.com/index.php?tp=1) e atualize a página.
• Se já existem parâmetros do URL, adicione "?tp=1" à URL (seudominio.com/index.php?id=17&tp=1) e atualize a página.
• As posições dos módulos serão delineadas em vermelho.

Note que em algumas circunstâncias, pode haver posições dos módulos disponíveis que não estão descritos em vermelho. Isto pode acontecer quando um modelo define as posições dos módulos como subordinada à existência de módulos ativado nessa posição. Se não houver módulos ativado nessa posição, então a posição não será visível.

III - Posição do Módulo

Posições do Módulo (module positions) são espaços em um modelo. Eles identificam posições dentro do modelo e dizem ao Joomla! o lugar que foi atribuído à posição de um determinado módulo. O Joomla! oferece completo controle sobre as posições do módulo, criando variações entre os modelos e os respectivos padrões Joomla! atribuídas aos módulos na instalação amostra de dados.

Por exemplo, o módulo posição "left" poderá ser utilizado no lado esquerdo do modelo para exibir um menu navegação no site. Portanto, se a um módulo é atribuída à posição "left", ele será exibido sempre que o criador optar por "left" para a posição do módulo - não necessariamente do lado esquerdo da página.

Linguagem técnica é terrível de entender, né? Mas tem que ser assim mesmo, para evitar dúvidas. Traduzindo para linguagem comum, os dois parágrafos acima nos dizem que:

É preciso que você diga ao Joomla onde ele deve colocar as posições. Por exemplo, você quer que "left" apareça à esquerda, como vem nos templates padrão. Se te der uma louca e cismar de colocar a posição "left" no topo, o Joomla te oferece essa liberdade. Ou seja, você não precisa seguir as posições porém é aconselhável que você não faça um samba do crioulo doido com seu template. Isso porque, seguindo a padronização, numa futura atualização de layout será muito mais fácil saber o-que-está-aonde, mantendo a coerência.
Depois de definir o posicionamento de "left", "right", "user1" e etecéteras, poderá escolher que módulos serão mostrados em cada uma dessas posições.

Depois disso tudo, com certeza terá outro maluco que nem eu perguntando:
- "Mas ô tia! Como é que vou saber definir as posições dos módulos?"
- Calma! Também não cheguei lá... Ainda. :)

WEBbeijos