OVERRIDE NO JOOMLA 3.5
Introdução É incorreto afirmar que projetos desenvolvidos com CMS, seja ele qual for, possui páginas. O motivo é simples: Todo Gerenciador de Conteúdo tem a camada de visão (apresentação) e o conteúdo que fica gravado no banco de dados. Para explicar melhor o override diria que é a sobreposição(substituição), ou seja: a capacidade de controlar e sobrepor a camada de visão (Template) do conteúdo do Joomla. Os overrides podem ser utilizados em componentes, módulos e layouts. Nas versões anteriores o CMS Joomla! foi muito criticado por não permitir ao usuário o controle da apresentação de seus conteúdos. Nesta apostila abordarei o conceito e farei na prática um Override de Template no componente com_content, visão article. Tipos de saída de componentes e substituição de layout No back-end do seu site navegue pelo menu superior Extensões - Temas e na aba Temas selecione o template padrão do seu site clicando no hiperlink Arquivos e Detalhes. Observe a figura seguinte:
Essa ação irá listar a estrutura do template. Observe na figura seguinte a estrutura do template Protostar que escolhi anteriormente. Editor Nessa aba temos os diretórios e arquivos que fazem parte do template. O diretório /html é responsável por receber todos os overrides de nosso projeto no template escolhido. Isso mesmo, para cada template você pode criar n overrides. Na figura seguinte observe a Aba Criar Substituição Nessa aba escolhemos o template que desejamos para criar o override. É preciso ter o conceito mais amplo de template e não simplesmente a camada de visão que representa o layout gráfico do site e sim a camada de visão responsável por printar a saída de qualquer componente, módulo ou layout. Na Aba Descrição do Tema é apresentada a tag description do manifesto templatedetails.xml do template.
Criando um override de artigo Para criarmos o override de apresentação de artigo, devemos seguir os seguintes passos: 1. Selecionar o template; 2. Criar o arquivo de override; 3. Codificar o arquivo de override; 4. Criar novo arquivo no diretório /html; 5. Criar o artigo; e 6. Alterar o layout padrão do artigo. 1) Selecionando o template Na aba Criar Substituição clique na opção article do componente com_content. Observe a figura seguinte: 2) Clique no diretório /html da aba Editor e perceba que o override foi criado com sucesso. Observe a figura seguinte: 3) O arquivo padrão utilizado pelo componente é o default.php. Nossa missão é criar outro artigo inserindo as mudanças que desejamos. Minha ideia para esse override é apresentar frases de pensadores que passam de forma randômica e complementam o sentido do artigo.
Será preciso uma função Javascript para o efeito de transição randômica e algumas classes css para a estilização. O código pronto randômico.php pode ser baixado na área reservada ao aluno do curso de joomla 3.5 avançado ao infinito e além. Na figura seguinte temos o trecho do código com as frases e autores. Essa é a única parte que pode ser alterada pelo usuário. Caso deseje inserir nova(s) frase(s) e autor(a) basta copiar (ctrl+c) e colar (ctrl+v) o trecho que começa com <li> e termina com </li>. As tags devem estar antes da tag de fechamento </ul>. 4) Para criar o novo arquivo no diretório /html/com_content/article selecione o diretório e clique no botão Novo arquivo. Observe a figura seguinte: No modal que será aberto marque o diretório article, escolha php para o tipo de arquivo e nomeie o arquivo. No caso abordado usei o nome de randômico. Observe a figura seguinte:
Clique no botão criar e o arquivo será criado em branco. Você pode usar a opção de Enviar para selecionar o arquivo em sua máquina e fazer o upload para o servidor. Para criar o arquivo de override copie (ctrl+c) todo o código do arquivo randomico.php abordado anteriormente e cole (ctrl+v) no editor de texto do Joomla no arquivo em branco que você acabou de criar e clique no botão Salvar e Fechar.. Observe a figura seguinte: Abra o arquivo default.php copie (ctrl+c) o código relacionado à apresentação do conteúdo no template do site. Observe a figura seguinte: Abra o arquivo randômico.php e cole (ctrl+v) após a última tag </div>. Clique no botão Salvar e Fechar. 5) Crie um novo artigo no Joomla! Observe a figura seguinte. 6) Na aba Opções Layout Alternativo da edição do Artigo, selecione randômico e clique no botão Salvar e Fechar. Observe a figura seguinte:
Acesse o front-end do site, clique no Leia Mais e visualize o resultado. Observe a figura seguinte: Antes do artigo temos frases de pensadores que se apresentam de forma randômica. Esta é apenas uma forma de utilização do script no Joomla. Poderíamos utilizar em um módulo html personalizado a ser publicado em determinada posição ou inserido no contexto de um artigo.