Visão Geral. Joomla! CMS Visão Geral! 1.5. Por Fabio Gameleira Joomla! Por Fabio Gameleira 1/22

Transcrição

1 Joomla! CMS Visão Geral! 1.5 Por Fabio Gameleira 1/22

2 Historico de revisões Data Versão Descrição Responsável 23/06/ Conteúdo inicial Fabio gameleira 21/03/ Revisão e correção do url do meu site 01/04/ Inclusão de requerimentos do sistema ; Conclusão 6 e pequenas inserções. 12/05/ Conversão do doc. Para BrOffice doc, correções de formato e Inclusão da indicação do Vertrigo 29/06/ Indicação do XAMPP e revisão. 26/08/ Indicação de onde instalar e do guia de instalação do XAMPP. Fabio gameleira Fabio gameleira Fabio gameleira Fabio gameleira Fabio gameleira 2/22

3 Índice 1 Introdução O que é Joomla CMS? Em que foi desenvolvido? Requerimentos do sistema Onde instalar o Joomla? No seu micro ou intranet Em um servido Internet Idioma de utilização Onde obter a instalação do Joomla? Estrutura de pastas Conceitos Áreas do Joomla Área de usuários (Frontend) Área de administradores (Backend) Nível de usuário - Papel Templates Estrutura do template Arquivos contidos na pasta do template Trabalhando no conteúdo Seções Categorias Item de conteúdo Conteúdo estático Menu Componentes Módulos Mambots Um pouco mais adentro do código Referência de Funções Um exemplo básico de arquivo index.php Conclusão /22

4 1 Introdução Criei este manual para servir de orientação inicial sobre os conceitos básicos do Joomla e dar uma luz inicial a quem pretende conhecer e utilizar o Joomla para administração de Conteúdo de Web sites. Procurando informações sobre o Joomla na Internet, um pedacinho aqui outro ali e entendendo muita coisa na tentativa e erro, pois não existia um manual sobre o Joomla, muito menos em português, que pudesse servir como referência para aprendizado, acabei escrevendo este documento, que não tem o propósito de ser um manual completo e sim uma introdução aos conceitos do Joomla visando facilitar o seu entendimento. Espero que este documento te ajude a compreender um pouco mais rápido os conceitos básicos do Joomla. 1.1O que é Joomla CMS? O Joomla é um Sistema de Administração de conteúdos (CMS Content Manager System) que permite a publicação online de informações em sites na Internet ou intranet. Atualmente existem duas versões principais, a e a 1.5. Até a presente data, a é a versão estável e a 1.5 esta na versão beta. A diferença entre estas é que a versão 1.5 utiliza o PHP 5 e é uma versão com maior uso de orientação a objetos. 1.2Em que foi desenvolvido? Foi desenvolvido utilizando a linguagem PHP e utiliza o banco de dados MySQL, ambos software livres, assim como o Joomla. 1.3Requerimentos do sistema Independente de onde você irá instalar o Joomla, os itens abaixo são pré-requisitos para que seu site Joomla funcione. PHP 4.2.x ou superior - MySQL 3.23.x ou superior - Servidor WEB (Apache ou superior - ou IIS 5 ou superior) Obs.: Recomendo que seja utilizado o servidor web Apache. 4/22

5 1.4Onde instalar o Joomla? Como o PHP e o MySQL são multiplataformas, o Joomla pode ser instalado em qualquer servidor web que suporte a instalação destes, como por exemplo o Servidor web Apache no Linux e o servidor web da Microsoft, o IIS. Para iniciantes, o ideal é instalar localmente em seu micro, utilizando o XAMPP) ou em um provedor Internet preparado para utilizar o Joomla, pois com isto você não precisará se preocupar na preparação do ambiente, instalando e configurando o servidor Web, PHP e MySQL No seu micro ou intranet O XAMPP instala e configura o servidor web Apache, o php e o Mysql automaticamente. Para detalhes da instalação, leia o tutorial que está no meu site, com o título "Joomla! XAMMP - Rode o Joomla no seu micro", em guias e tutoriais. Após a instalação, copiei e descompacte o arquivo do Joomla (Ex.: Joomla_ Stable-Full_Package.zip) dentro da pasta correspondente ao seu site <seusite>. Acesse o navegador e digite o endereço Siga as instruções apresentadas e antes de acessar o site novamente, exclua a pasta Installation e o Joomla estará instalado Em um servido Internet CPANEL com o script FANTASTICO No CPANEL, utilize o script FANTASTICO. Como padrão, o servidor já tem o pacote de instalação do Joomla, não necessitando fazer upload do Joomla nem configurar o Mysql e criar o banco de dados. É tudo instalado sem complicação, apenas com 2 ou 3 cliques. Ao término da instalação, Acesse o navegador e digite o endereço do seu site: CPANEL sem o script FANTASTICO Esta é a forma mais complexa de instalação, pois você deverá entrar no CPANEL, item MySQL, criar e configurar o banco de dados manualmente. Fazer o upload do pacote de instalação do Joomla e descompatá-lo na pasta do seu site, normalmente, em public_html. Acesse o navegador e digite o endereço Siga as instruções apresentadas e antes de acessar o site novamente, ao final, exclua a pasta Installation e o Joomla estará instalado. 1.5Idioma de utilização Você poderá instalar o Joomla na lingua que desejar (Inglês, Português, Alemão, etc), sendo a mais comum a versão em inglês. 5/22

6 Após a instalação, você poderá procurar nos sites das comunidades Joomla a tradução para lingua que você desejar, tanto para atualizar o site principal como a area de administração do Joomla. Infelizmente nem tudo terá a tradução para lingua desejada, mais com um pouquinho mais de estudo verificará que existe a possibilidade de você mesmo fazer algumas traduções. 1.6Onde obter a instalação do Joomla? Existem diversos sites que permitem baixar a última versão do Joomla, seguem alguns destes: Estrutura de pastas Após a instalação, será criada uma estrutura de pastas no seu site conforme a seguir. Figura 1 Nas pastas administrator e templates, ficam armazenados, basicamente, o site de administração e o template do seu site. A demais pastas você entenderá mais a seguir, pois tratam módulos, componentes e outros recursos para exibição de conteúdo do site. É normal, quando instalado em provedores Internet a estrutura de pastas do Joomla estar armazenada abaixo da pasta public_html. Neste exemplo de estrutura de pastas acima, o nome da pasta que criei para o meu site se chama allb. 6/22

7 3 Conceitos 3.1Áreas do Joomla Quando instalamos o Joomla em um servidor web, automaticamente são instaladas duas áreas: Área de usuários (Frontend) e Área de administração (Backend), que correspondem respectivamente ao site principal e um site de administração do site principal Área de usuários (Frontend) Esta área é o próprio site apresentado na web quando digitamos o endereço no navegador. Este, como qualquer site web, poderá ser acessado por qualquer usuário da Internet. Pode-se criar um template (Design) próprio para apresentação das informações, utilizar um template gratuito disponível pela comunidade Joomla, ou mesmo adequar um site para ter seu conteúdo mantido com os recursos do Joomla. O Frontend é um site normal na web, com a diferença que podemos alterar partes de seu conteúdo diretamente no site ou pela área de adminsitração. Figura 2 A figura acima exibe o template instalado junto com o Joomla, até a versão /22

8 3.1.2Área de administradores (Backend) Este é um site que permite a administração do site principal em relação ao seu conteúdo. É nesta área onde informamos as partes que irão aparecer no site principal (Módulos, componentes, etc.), como por exemplo, menu de opções, notícias, áreas de registros, links, download de arquivos, etc. Para acessar a área de adminsitração, devemos fazer o login na mesma, digitando no navegador o endereço do site, incluindo no final a palavra administrator. Ex.: Basicamente a área de administração abre exibindo o Painel de Controle e um menu superior. Os itens a serem exibidos no menu e no painel de controle dependerão de como está definido o seu nível de usuário para área de administração. Figura 3 Ao fazer uma instalação local (seu micro) muitas pessoas tem dificuldade em acessar a área de administração, pois esquecem que a conta de usuário criada possui o login admin. 8/22

9 3.2Nível de usuário - Papel Cada usuário que acessa o site principal ou de administração possui um papel. Dependendo deste papel, o usuário poderá fazer mais ou menos operações ou ações, tanto no site principal quanto na área de administração. Papéis no Site principal (Frontend) Anonymous Registered Autor Editor Publisher. Obs.: Os usuários do frontend não possuem acesso ao backend. Papeis na Área de administração (BackEnd) Manager Administrator Super Administrator. Obs.: Todo o usuário do BackEnd possui acesso total também ao frontend. O responsável pela instalação do Joomla automaticamente ficará com o status de Super Administrador. 9/22

10 3.3Templates Um template Joomla é uma série de arquivos que com o Joomla CMS controlam a apresentação do conteúdo. Um template não é um web site e também não deve ser considerado um design completo do web site. O template define a disposição das informações no site, podendo existir de um a diversos templates para um mesmo site. Para produzir o efeito de web site completo, o template trabalha em conjunto com o conteúdo armazenado no banco de dados Joomla. Utilizando um template seguindo os padrões do Joomla, você poderá migrar de um template para outro apenas com poucos cheques, mudando completamente a cara do seu site. A estrutura do seu template será criada na página index.php, localizado na pasta templates/<nome do template> que utilizará os arquivos de estilos template_css.css, localizado na pasta templates/<nome do template>/css e imagens localizadas na pasta templates/<nome do template>/images. Veja o exemplo na figura para o template denominado rhuk_solarflare_ii. Figura 4 No arquivo template_css.css poderá ser alterado praticamente todo tipo de formatação do seu site, cores, tipos e tamanhos, box, etc. Isto dependerá mais de como o arquivo index.php foi montado. Pode-se criar quantos arquivos de estilos (css) desejar. Procure manter no arquivo padrão template_css as informações de formatação originais do Joomla. Para ver um arquivo template_css.css com vários estilos padrões do Joomla, acesse nutes/1.html ou 10/22

11 3.3.1Estrutura do template Basicamente a estrutura do template criado no arquivo index.php, deverá estar divido em blocos onde posicionalmente exibirá as informações. Como, normalmente, não escrevemos conteúdo no template, apenas indicamos áreas de conteúdo e posicionamento, a mudança, por exemplo, de um menu do lado esquerdo para o direito do site fica bastante simples, bastando alterar pela área de administração, a posição aonde este será exibido. Veja a seguir uma estrutura de template em formato de mapa: Figura 5 Na prática, o que temos que fazer é criar um template tipo este desenho acima, ou da sua preferëncia, utilizando o arquivo index.php, seja através de tabelas (<TABLES>) ou através de CSS (Cascade Style Sheet). Nas áreas LEFT, USER 1, USER 2, RIGHT, etc, serão carregados os módulos e em MAIN CONTENT AREA serão carregados os componentes e itens de conteúdo. Por padrão o Joomla já cria uma lista destas áreas para serem utilizadas, porém, essas podem ser customizadas, bastando para isto acessar o menu SITE na área de administração e selecionar Template Manager > Module Positions. 11/22

12 3.3.2 Arquivos contidos na pasta do template. templatedetails.xml Este arquivo diz ao Joomla que outros arquivos são necessários quando estiver carregando uma página web que utilize este template. Também exibe o autor, copyright e quais arquivos participam do template (incluindo qualquer imagem utilizada). Um último uso deste arquivo é para instalação do template quando instalando-o através da área de administração. index.php Este é o arquivo mais importante. Este estrutura o layout do site e diz ao Joomla CMS onde colocar os componentes e módulos. Este arquivo é, basicamente, uma combinação de PHP com (X)HTML. template_thumbnail.png É uma pequena imagem do template (normalmente 140 pixels de largura por 90 pixels de altura). Após a instalação do template, esta pequena imagem pode ser vista na área de administração ao passar o mouse sobre o nome do template. Este é muito útil quando temos vários templates diferentes para um mesmo site. css/template_css.css Este é o arquivo de configuração de estilos padrão do Joomla. images Qualquer imagem utilizada pelo template. Esta pasta existe aqui apenas por questão de organização, pois algumas pessoas inserem as imagens diretamente na pasta images principal do site. Para adicionar um novo template você pode ir pela área de administração e instalar o template, fazendo o upload do arquivo zip. Também é possível adicionar novos templates manualmente, copiando-o para pasta /templates do seu site. Existem centenas de templates gratuitos para uso com o Joomla, bastar pesquisar na Internet. Veja alguns templates profissionais gratuitos disponíveis para Joomla em Muitos templates profissionais pagos também podem ser encontrados na web, ou podese adequar um template existente para exibição de seu conteúdo através do Joomla. 12/22

13 4 Trabalhando no conteúdo Os templates servem para estrutura e dar forma ao seu website. Além deste o Joomla possui objetos que são tratados e carregados no template que irão dispor do conteúdo armazenado dentro do banco de dados do Joomla. 4.1Seções Uma seção é uma coleção de categorias que se relacionam entre si de alguma maneira. A seção é parte da hierarquia Seção/Categoria/Conteúdo. A criação de seções pode ser feita no módulo de administração em Contents > Section Manager. 4.2Categorias Uma categoria é coleção de itens de conteúdo que se relacionam entre si. A criação de categorias pode ser feita no módulo de administração em Contents > Category Manager. 4.3Item de conteúdo Um item de conteúdo é um pedaço de conteúdo dentro da hierarquia do Joomla. Um item de conteúdo pode estar associado a uma combinação de Seção/Categoria particular ou ser um item de conteúdo estático. Normalmente os itens de conteúdo são mostrados no corpo principal da página (Main Content Area). Por exemplo, podemos criar várias notícias a serem apresentadas e cada notícia poder um item de conteúdo individual, possuindo cabeçalho, um texto de introdução e texto principal, exibido através do link Leia mais.... A criação de itens de conteúdo pode ser feita no módulo de administração em Content > All Contents Itens ou Home > Contents Itens Manager (No painel de controle). No site as informações que aparecem no centro são itens de conteúdos exibidos na frontpage (Bem vindo ao IGoia!, CMS - Sistema de Gerenciamento de Conteúdo, Webdesigner tem que dominar CSS). 13/22

14 4.4Conteúdo estático Um item de conteúdo estático também é um item de conteúdo, só que normalmente utilizamos para exibir como se fosse uma página estática, porém, este não pertence à hierarquia de Seção/Categoria/Conteúdo. Nos itens de conteúdo (4.3) organizados na hierarquia seção/categoria/conteúdo, podemos exibir uma lista de itens independentes entre si e cada item poderá ter uma imagem, um texto introdutório e um link tipo Leia mais... para exibir o conteúdo da chamada completa. No item de conteúdo estático, você terá uma única área de texto para ser exibida por completo, praticamente ocupando a área principal de conteúdo (MainBody ou Main Content Área) do site. A criação de conteúdos estáticos pode ser feita no módulo de administração em Content > Static Content Manager ou Home > Static Content Manager (No painel de controle). Depois de criado um conteúdo estático, você poderá fazer um link para este, por exemplo, do menu principal. No site ao clicar no item Segurança do menu, será exibida uma página criada como um item de conteúdo estático. 14/22

15 4.5Menu Um menu estrutura a navegabilidade do seu site. Através destes que são carregadas diversas funcionalidades, tais como conteúdos, Componentes, links, etc. Basicamente o Joomla é instalado como os menus: MainMenu, OtherMenu, TopMenu e UserMenu. Um menu é implementado como módulo no Joomla e para que o mesmo seja exibido e utilizado o módulo correspondente deverá estar publicado na área de administração em Modules > Sites Modules > Modules Manager. Ao selecionarmos no menu principal da área de administração do Joomla o item MENU e solicitarmos a criação de um novo item de menu, a página abaixo será exibida, perguntado que tipo de conteúdo este irá exibir. Figura 6 No item 4.4 que falei sobre a criação de uma página de conteúdo estático, para exibi-la e um link no menu principal do site, bastaria selecionar, na tela equivalente a exibida acima, o item Link Static Content, clicar Next e indicar qual o item de conteúdo estático deverá ser exibido. 15/22

16 4.6Componentes Os componentes são elementos de conteúdo que funcionam como pequenas aplicações no Joomla. Normalmente são mostrados no centro da página, na área de conteúdo principal do template (MainBody), porém isto vai depender de como está organizado seu template. Inicialmente o Joomla instala vários componentes como padrão, tais como: Contact, FlexContent, Login, FrontPage, Banners, Contact (Contacto), Web Links, Etc. Figura 7 Alguns destes componentes fazem parte da própria arquitetura do Joomla, tipo o componente Frontpage e não são manipuláveis através do menu. Um dos principais componentes é o frontpage, que estrutura as informações, juntamente com os estilos definidos para tal no template_css.css, a serem exibidos na primeira página. Para exibir as informações na primeira página (Mainbody), criam-se itens de conteúdo em uma seção/categoria e em cada idem deverá ser defindo que o mesmo será apresentado no frontpage. Além do componente frontpage, que no padrão do Joomla é chamado pelo primeiro item do Main menu, qualquer link inserido como primeiro item do menu principal será considerado a página de abertura do seu site, desta forma, pode-se apresentar outras estruturas na página inicial, como um conteúdo estático ou qualquer outro tipo de componente. A comunidade Joomla produz e atualiza constantemente centenas de novos componentes. Um componente muito interessante e gratuito é o FACIL FORM, que permite estender a funcionalidade do Joomla criando formulários fantásticos. Saiba mais em 16/22

17 Para usar um componente, muitas vezes temos que configurá-lo primeiro. Para configurar um componente, acesse a área de administração, menu Componente e selecione o componente desejado. Depois criamos um item de menu, menu MainMenu, que fará a chamada ao componente. Para isto, acesse a área de administração Menu > MainMenu e no Menu Manager clique em NEW e selecione Componente no quadro Componentes. Será exibida a tela New Menu Item: Componente. Nesta tela, você poderá dar um nome ao componente e selecionar que componente será utilizado. 4.7Módulos Os módulos estendem a capacidade do Joomla com novas funcionalidades e permitem mostrar seus conteúdos em qualquer posição que o template permita. Estes são mais fáceis de instalar pela área de administração. Como padrão o Joomla instala alguns módulos tais como: Main Menu (Menu Principal) Top Menu (Menu Superior) Template Chooser (Selector de templates) Polls (Enquetes) Hit Counter (Contador de Visitas), Banner; Breadcrumbs Module; Feed Display; Footer; Latest News; Login Form; Menu Module; Most Read Content; Newsflash; etc. A exibição destes módulos se dará posicionalmente, conforme definido na estrutura do template criado (left, newsflash, pathway, right, toolbar, top, etc). Ao utilizar um módulo você deveráindicar onde o mesmo deverá ser apresentado. Existem diversos novos módulos que podem ser obtidos gratuitamente, disponíveis pela comunidade Joomla, além de ser permitido o próprio usuário criar um novo módulo (Customer Module). Para acessar os módulos, entre na área de administração e acesse o menu Modules e selecione Sites Modules. 17/22

18 Figura 8 Será apresentada uma nova tela com todos os módulos instalados. Figura /22

19 4.8Mambots São funções orientadas a tarefas que interceptam um conteúdo antes que este seja mostrado e manipulado. Como exemplo de mambots sito os editores WYSIWYG que permitem a edição dos conteúdos como se estivéssemos em um processador de texto. Figura 9 Pelo menos inicialmente, você não deve se preocupar com mambots pois a necessidade de instalar um novo será raro. Concluíndo, componentes, módulos e mambots são as extensões que complementam as funcionalidades do Joomla. Você pode encontrar muito mais junto à comunidade Joomla ou acesse: 19/22

20 5 Um pouco mais adentro do código Embora não seja obrigatório o conhecimento de linguagens como PHP, HTML e folha de estilos (CSS), pois existem centenas de templates prontos, este conhecimento será interessante para quando desejar efetuar alterações no template ou mesmo em componentes, módulos etc. Como este o propósito deste manual é apenas dar uma visão geral sobre o Joomla, não entrarei em maiores detalhes, apenas mostrarei a seguir alguns conceitos interessantes para quem pretende se aprofundar mais um pouco. 5.1Referência de Funções As funções a seguir estão disponíveis para os desenvolvedores de templates e carregam os componentes, módulos etc onde os mesmos estiverem referenciados no template (veja item 3.3.1), index.php. 1. mosloadcomponent Syntax: mosloadcomponent( $name ) Objetivo: Carrega um componente. Não incluir prefixo "com_ 2. moscountmodules Syntax: moscountmodules( $position_name ) Objetivo: Conta a quantidade de módulos que serão exibidos na página corrente na posição position_name". 3. mosloadmodules Syntax: mosloadmodules( $position_name [, $style] ) Objetivo: Exibe todos os módulos que estão associados a posição "position_name" para página corrente. O argumento style" é opcional e podem ser: 0 = (default display) Modules are displayed in a column. 1 = Modules are displayed horizontally. Each module is output in the cell of a wrapper table. -1 = Modules are displayed as raw output and without titles. -2 = Modules are displayed in X-Joomla format. -3 = Modules are displayed in a format that allows, for example, stretchable rounded corners. 4. mosshowhead Syntax: <?php mosshowhead();?> Objetivo: Insere varios tags do head incluindo o tag title tag e outros meta tags. 5. mosmainbody Syntax: <?php mosmainbody();?> Objetivo: Inclui a saída do componente como determinado pelo valor de option na URL. 20/22

21 5.2Um exemplo básico de arquivo index.php Visão Geral Neste exemplo o arquivo está utilizando CSS para posicionamento do template, porém pode-se utilizar tabelas para este propósito sem nenhum problema. <?php defined( '_VALID_MOS' ) or die( 'Direct Access to this location is not allowed.' );?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" " <html xmlns=" lang="<?php echo _LANGUAGE;?>" xml:lang="<?php echo _LANGUAGE;?>" <head> <meta http-equiv="content-type" content="text/html; <?php echo _ISO;?>" /> <?php if ($my->id) { initeditor(); }?> <?php mosshowhead();?> <script type="text/javascript"> </script> <!-- <link xhref="templates/<?php echo $cur_template;?>/css/template_css.css" rel="stylesheet" type="text/css" media="screen" /> </head> <body> <div id="wrap"> <div id="header"> <?php echo $mosconfig_sitename;?> <?php mospathway();?> </div> <div id="sidebar-left"> <?php mosloadmodules('left');?> </div> <div id="content"> <?php mosloadmodules('top');?> <?php mosmainbody();?> </div> <div id="sidebar-right"> <?php mosloadmodules('right');?> </div> <div id="footer"> <?php include_once( $mosconfig_absolute_path.'/includes/footer.php');?> </div> </div> <!--end of wrap--> </body> </html> Para não se preocupar muito em criar templates, você pode utilizar o template instalado automaticamente com a instalação do Joomla ou instalar novos templates existentes na Internet. 21/22

22 6 Conclusão O Joomla é um CMS poderoso e simples que permite que pessoas mesmo sem conhecimento em programação possam fazer e manter sites com aspecto profissional. Na medida em que as necessidades aparecem e a curiosidade vai aumentando, o ideal é que se tenha algum conhecimento em HTML, PHP e CSS. Com este conhecimento, você poderá alterar e criar novos templates e efetuar alterações / adequações em componentes, módulos etc. Indo mais além, conhecendo de forma mais profunda as linguagens citadas e o banco de dados MySQL e o Guia de referência da API do Joomla, passa-se para um nível mais avançado de desenvolvimento, onde você poderá criar seus próprios componentes, módulos, funções e etc. Não deixe der verificar no meu site no link Links úteis, o item referente ao Joomla, pois você encontrará diversos links interessantes sobre Joomla e faça adesão ao Fórum, onde poderemos trocar idéias. Na primeira versão deste guia não existia um manual oficial do Joomla, agora disponível em Joomla! User Manual ( Se você gostou deste manual introdutório ou tem alguma sugestão de melhoria, envie um para fabiogameleira@gmail.com com suas sugestões e/ou comentários. ** Fim *** 22/22