download.
Transcrição
download.
Português do Brasil m * te e en rg m .o ta s ui op at o gr w.x xe w ai w e ar ftw re So Liv B Guia de Instalação e Uso Crie sites dinâmicos e modulares. XOOPS é um Sistema de Gerenciamento de Conteúdo (SGC), poderoso, modular e de rápida assimilação na administração de sites. Possibilita a criação de sites dinâmicos, sendo ideal para projetos em pequena e grande escala de portais, comunidades virtuais, sites de notícias, intranets ou weblogs. Possui uma biblioteca de módulos, incluindo notícias, foruns, enquetes, classificados, gerenciamento de informações e até ecommerce, dentre outros. Versão 2.3 RELEASE OUT/2008 Daniel Almeida Chagas EXtended Object Oriented Portal System GUIA DE INSTALAÇÃO E USO Versão 2.3 RELEASE OUT/2008 Daniel Almeida Chagas Notas de versão do software: Esta apostila é enfocada na versão 2.3 ptbr, lançada em Outubro de 2008. Contudo, os ensinamentos dados nesse material são em geral compatíveis com versões do Xoops diferentes, ficando a critério do usuário usar outras versões baixadas em outros sites. Para maiores informações sobre o Xoops Core original, acesse www.xoops.org. Para versões já portadas para o português do Brasil, procure em www.xoopsbr.com.br ou em outros sites de suporte xoops em português. Esta apostila usa uma metodologia passo-a-passo para ensinar a operação e instalação do sistema Xoops. Para que o acompanhamento do texto seja perfeito, é interessante que o leitor esteja seguindo as lições operando um computador com o sistema, fixando assim o conteúdo passado. Junto com esta apostila está presente um CD com todo o material abordado, incluindo o Xoops, o Xampp e outros softwares freeware ou software livre. Caso você não tenha este CD, uma imagem .ISO pode ser facilmente baixada em www.helptech.srv.br e depois gravada em um CD-R. O curso dará preferência ao uso de softwares livres, então boa parte das instruções será dada como se o usuário estivesse utilizando o Linux como sistema operacional. Porém instruções para Windows XP estarão juntas. O linux utilizado é o OpenSUSE 11. 04 Atribuição-Uso Não-Comercial 3.0 Unported Este documento é distribuido através da licença Creative Commons Atribuição (by nc). De acordo com esta licença o autor permite uma utilização ampla da sua obra, limitada, contudo, pela impossibilidade de se obter através dessa utilização uma vantagem comercial. É também essencial que seja dado o devido crédito ao autor da obra original. Você pode: copiar, distribuir, exibir e executar a obra criar obras derivadas Sob as seguintes condições: Atribuição. Você deve dar crédito ao autor original, da forma especificada pelo autor ou licenciante. Uso Não-Comercial. Você não pode utilizar esta obra com finalidades comerciais. Para cada novo uso ou distribuição, você deve deixar claro para outros os termos da licença desta obra. w Qualquer uma destas condições podem ser renunciadas, desde que Você obtenha permissão do autor. w Nada nessa licença implica ou restringe os direitos morais do autor. w Este é um sumário para leigos da Licença Jurídica, que se encontra na íntegra em: http://creativecommons.org/licenses/by-nc/3.0/legalcode 05 ÍNDICE Prefácio Introdução Porque eu preciso de um CMS Software Livre e Licença GPL Hospedagem Criando um endereço endreço internacional tecnologias de site espaço e transferência Dados de Hospedagem FTP - File Transfer Protocol Instalando o servidor e banco de dados Servidor Windwos com XAMPP Servidor Linux com OpenSUSE Servidor na Internet Instalando o Xoops Configurando o Xoops Preferências - Config. Gerais Preferências - Config. Usuários Preferências - Meta dados e Rodape Preferências - Palavras censuradas Preferências - Opções de Pesquisa Preferências - Configuração de e-mail Banners Blocos Grupos Imagens Módulos Emoticons Posições de usuários Editar usuários Procurar usuários Contactar usuários Modelos ou templates Comentários Personalizando o Xoops Conclusão Agradecimentos 06 07 08 09 12 13 14 18 19 21 23 25 30 30 33 37 39 44 45 49 50 50 50 51 52 53 61 62 63 66 66 66 66 66 67 68 69 70 71 PREFÁCIO O Xoops é um gerenciador de conteúdo dinâmico de código livre, escrito em PHP. Ele permite que administradores de sites possam facilmente criar websites dinâmicos com um bom conteúdo e muitas funcionalidades, com o mínimo de programação. O Xoops é perfeito para criar pequenos e grandes sites institucionais, sites de comunidades e intranets. Ele também tem uma comunidade entusiasmada e receptiva. CONHECIMENTOS BÁSICOS Para usar esta apostila e poder entender e desfrutar de todas as características do Xoops, o leitor precisa ter conhecimentos no mínimo básicos em: Operação de computador (Conceito e manipulação de arquivos) Internet (fundamentos, navegação) HTML (Hyper Text Makeup Language) CSS (Cascade Style Sheet) Editor de HTML (Notepad, Dreamweaver, etc.) FTP (File Transfer Protocol) Caso não seja esse o caso, o leitor pode até seguir os passo-a-passos dos textos e conseugir resultados, mas recomendamos extremamente que somente leitores com estes conhecimentos continuem. 07 INTRODUÇÃO XOOPS é um poderoso, flexível e fácil de usar Sistema de Gerenciamento de Conteúdo, mais conhecido pelo acrônimo inglês CMS - Content Management System. Quando instalado em um servidor web com PHP e o banco de dados MySQL, o sistema possibilita a criação e administração de sítios totalmente dinâmicos, revelando-se uma ferramenta excelente para a construção dos mais variados tipos de portais, e contando ainda com diversos recursos modulares, como administração de associados, troca simples de lay-out, além da inserção e administração visual de conteúdos. Todas estas ações são efetuadas através de uma interface web simples e funcional, deixando aos administradores, praticamente só a tarefa de gerenciar o conteúdo do sítio. A palavra XOOPS (pronuncia-se "zups") é um acrônimo de "eXtensible Object Oriented Portal System". O XOOPS foi concebido sob os termos da GNU - General Public License - GPL (Licensa Pública Geral), o que significa que você pode usá-lo e modificá-lo livremente, desde de que de acordo com os termos da referida licença. Depois de instalado, um website em XOOPS pode ser gerenciado sem a necessidade de ferramentas externas ou conhecimentos avançados de tecnologias da Internet, como FTP, HTML, JavaScript, CGI, etc. De acordo com o seu site oficial, o XOOPS vem deixando de ser apenas um sistema de Portal e passando a ser um Gerenciador de Conteúdo, capaz de estruturar sítios pequenos, médios ou grandes. O site oficial do projeto é www.xoops.org 08 PORQUE EU PRECISO DE UM CMS? Um CMS (ou Sistema Gerenciador de Conteúdo) é a solução ideal para alguém que precise criar ou administrar um website e seu conteúdo de forma rápida e inteligente, sem precisar entender ou programar complicadas rotinas web. É muito comum se ver sites todos feitos em HTML. Para sites pequenos e com conteúdo que não muda com tanta frequência, o HTML resolve. Vejamos como um webmaster adiministra e atualiza um site HTML: - Para alterar um texto de uma página, é necessário baixar o arquivo para o computador (geralmente via FTP), e, com a ajuda de um editor (tipo o Dreamweaver) o usuário altera o necessário. Após salvar, é necessário subir (upload) o arquivo novamente para o servidor. - Para criar-se uma nova página, o usuário usa um editor (tipo Dreamweaver) e cria a nova página. Após fazer o upload do arquivo para o servidor, será necessário alterar outras páginas do site para criar os links (ligações) para aquela nova página (senão os visitantes do site nunca acharão a nova página). - Caso se queira incluir uma página que deva aparecer em todas as páginas do site, o webmaster deve alterar todas as páginas do site uma a uma. Vimos que pequenas alterações podem ser bastante trabalhosas quando temos um site todo baseado em HTML. Ao longo da evolução do HTML, várias soluções para diminuir esse trabalho apareceram, mas nenhuma solução é mais prática do que se ter um site dinâmico, baseado em programação. Lembrando que sites em Flash sofrem do mesmo mal. O Flash tem um ambiente próprio de programação (Actionscript) mas este não trabalha com acesso a banco de dados diretamente. Isto quer dizer que o Flash é mais avançado que o HTML, proporcionando a criação de sites mais bonitos, e até a criação de jogos, mas não é fácil implementar um site dinâmico, onde se possa alterar os conteúdos rapidamente. 09 HOMEPAGE Exemplo de uma estrutura de um site em HTML. Todas as páginas tem uma ligação bem definida, mas difícil de se administrar. Se o webmaster preciar alterar um link do menu (que aparece em todas as páginas), a alteração será muito mais trabalhosa. ESTRUTURA DE SITES DINÂMICOS A forma de funcionamento de um site dinâmico é bem diferente! Basicamente podemos dizer que as páginas são construidas no momento em que são requisitadas. Vejamos o desenho antes de explicar: BASE DE DADOS MENU CABEÇALHO RODAPÉ CORES INDEX 10 FONTES IMAGENS TEXTOS Veja que na nossa ilustração de um site dinâmico, há uma página para cada elemento da nossa página: Menu, cabeçalho, rodapé, etc. As páginas visitadas em nossos websites são criadas dinamicamente, baseadas nessas outras páginas elementares. Dessa forma, quando eu preciso fazer uma alteração no meu menu principal, basta eu alterar a página que constroe meu menu e todas as outras páginas do site estarão alteradas. Outra grande diferença é que não temos páginas para falar dos textos do site. Em um site HTML, teríamos as páginas quemsomos.htm, missao.htm, produtos.htm. Em um site dinâmico, o que temos são as informações dessas páginas gravadas em um Banco de Dados. As informações no banco de dados podem ser incluidas, alteradas e excluidas muito facilmente, e as informações podem ser combinadas e reutilizadas em mais de uma página. Ex: O endereço da empresa pode aparecer na sessão A Empresa e em Contato. Se alterarmos o endereço da empresa, basta fazer uma vez para ele aparecer corretamente nas duas sessões. O último detalhe de nossa ilustração é que as páginas dos elementos do site também estão ligadas ao banco de dados, porque o banco de dados também pode gravar informações de como o menu e formado, etc. Isso também facilita a alteração de todos os elementos do site. Nossas páginas em um site dinâmico são como uma colcha de retalhos que é costurada toda vez que um visitante requisita uma página. O servidor PHP pega os textos do banco de dados, as páginas que definem os menus, cabeçalhos e rodapés, junta tudo e transforma numa página na tela do computador do visitante. Outra grande vantagem é que esse ato de juntar as informações pode ser feito de tal maneira que podemos criar funcionalidas para o site, do tipo: Agendas, Classificados, Comentários, Galerias, etc. Tudo funcionando de forma automática e de fácil configuração. Esses são os módulos de trabalho. 11 SOFTWARE LIVRE E LICENCA GPL O XOOPS foi concebido sob os termos da GNU - General Public License - GPL (Licensa Pública Geral), que é a designação da licença para software livre idealizada por Richard Stallman no final da década de 1980, no âmbito do projecto GNU da Free Software Foundation (FSF). A GPL é a licença com maior utilização por parte de projectos de software livre, em grande parte devido à sua adoção para o Linux. O software utilizado para administrar o conteúdo da Wikipédia é coberto por esta licença, na sua versão 2.0 ou superiores. Em termos gerais, a GPL baseia-se em 4 liberdades: 1. A liberdade de executar o programa, para qualquer propósito (liberdade nº 0) 2. A liberdade de estudar como o programa funciona e adaptá-lo para as suas necessidades (liberdade nº 1). O acesso ao códigofonte é um pré-requisito para esta liberdade. 3. A liberdade de redistribuir cópias de modo que você possa ajudar ao seu próximo (liberdade nº 2). 4. A liberdade de aperfeiçoar o programa, e liberar os seus aperfeiçoamentos, de modo que toda a comunidade se beneficie deles (liberdade nº 3). O acesso ao código-fonte é um pré-requisito para esta liberdade. Com a garantia destas liberdades, a GPL permite que os programas sejam distribuídos e reaproveitados, mantendo, porém, os direitos do autor por forma a não permitir que essa informação seja usada de uma maneira que limite as liberdades originais. A licença não permite, por exemplo, que o código seja apoderado por outra pessoa, ou que sejam impostos sobre ele restrições que impeçam que seja distribuído da mesma maneira que foi adquirido. Por conta da licença GPL, qualquer pessoa pode ter acesso ao Xoops e a seus códigos. Então quando se está vendendo um site em Xoops, o que está se cobrando não é o software, e sim a instalação e a configuração. 12 HOSPEDAGEM - CONCEITOS Vamos agora entender como funciona um site, sua estrutura e sua colocação no ar. Se você já domina esses conhecimentos, pode passar para o capítulo segunte, mas é sempre recomendado fazer uma pequena revisão sobre o assunto! Para ter uma página na internet, você vai precisar basicamente de 2 elementos: Um endereço e uma hospedagem. Apesar de algumas empresas fornecerem o serviço em conjunto, devemos ter noção de que são duas coisas distintas, e que têm formas de pagamento distintas também. Um endereço de internet é o nosso famoso algumacoisa.com.br ou algumacoisa.com . O endereço liga nossos visitantes à nossa hospedagem. O ENDEREÇO FAZ O LINK ENTRE O VISITANTE E A HOSPEDAGEM A HOSPEDAGEM TRANSMITE AS INFORMAÇÕES PARA O VISITANTE VISITANTE DIGITA NOSSO ENDEREÇO Hospedar uma página é basicamente deixar os arquivos de uma página da internet em um computador permanentemente ligado à Internet. Tecnicamente qualquer computador pessoal poderia fazer esse serviço, mas como não possuímos computadores potentes o suficiente e nem conexões de internet rápidas e dedicadas para aguentar todos os acessos a nossas páginas, o ideal é alugar um espaço no computador de uma empresa de hospedagem. 13 Entendendo esses conceitos, podemos ver a diferença dos serviços e entender que essa estrutura vem a facilitar a administração de sites. Por exemplo, podemos mudar de empresa de hospedagem sem precisar mudar nosso endereço .com: HOSPEDAGEM ANTIGA VISITANTE ALGUMACOISA.COM HOSPEDAGEM NOVA Entendendo a estrutura também vemos que podemos ter mais de um endereço apontando para o mesmo site. Dessa forma, podemos garantir que o cliente ache nosso site mesmo sem saber exatamente qual é nosso endereço. ALGUMACOISA.COM HOSPEDAGEM VISITANTE COISAALGUMA.COM CRIANDO UM ENDEREÇO A criação de endereços é de responsabilidade de entidades em geral ligadas ao governo do país. No Brasil, é o CGI - Comitê Gestor de Internet o responsável por coordenar e integrar todas as iniciativas de serviços Internet no país, promovendo a qualidade técnica, a inovação e a disseminação dos serviços ofertados. 14 Para a criação de um endereço .br precisamos acessar o site www.registro.br . Desde 1995, o Registro.br é o executor de algumas das atribuições do Comitê Gestor da Internet no Brasil, entre as quais as atividades de registro de nomes de domínio, a administração e a publicação do DNS para o domínio .br . O registro de um endereço é feito por pagamento anual (R$ 30 em 2007) e é tecnicamente bem fácil de ser realizado, bastando que o interessado crie um login e senha de acesso para o site www.registro.br . Lembrando que não existe somente o famoso .com.br como opção de registro. Como em geral a disputa por um endereço pode ser grande, o CGI criou várias opções para a criação de endereços, muitas delas ainda desconhecidas. Senão vejamos: Domínios para Pessoas Jurídicas (Podem necessitar CNPJ) AGR.BR AM.BR ART.BR EDU.BR COM.BR COOP.BR ESP.BR FAR.BR FM.BR G12.BR GOV.BR IMB.BR IND.BR INF.BR MIL.BR NET.BR ORG.BR PSI.BR REC.BR SRV.BR TMP.BR TUR.BR TV.BR ETC.BR Empresas agrícolas, fazendas Empresas de radiodifusão sonora Artes: música, pintura, folclore Entidades de ensino superior Comércio em geral Cooperativas Esporte em geral Farmácias e drogarias Empresas de radiodifusão sonora Entidades de ensino de primeiro e segundo grau Entidades do governo federal Imobiliárias Industrias Meios de informação (rádios, jornais, bibliotecas, etc..) Forças Armadas Brasileiras Detentores de autorização para os serviços de Comunicação Multimídia (SCM), Rede e Circuito Especializado (SLE) da Anatel e/ou detentores de Sistema Autônomo conectado a Internet conforme o RFC1930 Entidades não governamentais sem fins lucrativos Provedores de serviço Internet Atividades de entretenimento, diversão, jogos, etc... Empresas prestadoras de serviços Eventos temporários, como feiras e exposições Entidades da área de turismo Empresas de radiodifusão de sons e imagens Entidades que não se enquadram nas outras categorias 15 Domínios para Profissionais Liberais (Necessita CPF) ADM.BR ADV.BR ARQ.BR ATO.BR BIO.BR BMD.BR CIM.BR CNG.BR CNT.BR ECN.BR ENG.BR ETI.BR FND.BR FOT.BR FST.BR GGF.BR JOR.BR LEL.BR MAT.BR MED.BR MUS.BR NOT.BR NTR.BR ODO.BR PPG.BR PRO.BR PSC.BR QSL.BR SLG.BR TRD.BR VET.BR ZLG.BR Administradores Advogados Arquitetos Atores Biólogos Biomédicos Corretores Cenógrafos Contadores Economistas Engenheiros Especialista em Tecnologia da Informação Fonoaudiólogos Fotógrafos Fisioterapeutas Geógrafos Jornalistas Leiloeiros Matemáticos e Estatísticos Médicos Músicos Notários Nutricionistas Dentistas Publicitários e profissionais da área de propaganda e marketing Professores Psicólogos Rádio amadores Sociólogos Tradutores Veterinários Zoólogos Domínios para Pessoa Física (Necessita CPF) BLOG.BR FLOG.BR NOM.BR VLOG.BR WIKI.BR Web logs Foto logs Pessoas Físicas Vídeo logs Páginas do tipo 'wiki' 16 A escolha de um bom endereço é peça chave para uma boa presença na internet. Quanto mais curto e fácil de lembrar e comunicar, melhor. Obviamente a opção mais perfeita para uma emrpesa, por exemplo, seria criar algo do tipo [nomedaempresa].com.br , mas por conta da concorrência por nomes esta opção nem sempre está acessível. Quando este for o caso, algumas dicas podem ajudar: Tente procourar outra opção ao .com.br: Se o tipo de sua empresa está listado nos outros domínios disponíveis, esta é uma otima opção. Uma empresa de esportes chamada Gol de Letra pode ter um endereço www.goldeletra.esp.br . Tente incluir um outro nome ao nome da sua empresa: Se o dono da Pousada Verão não conseguiu o endereço w w w. v e r a o . c o m . b r , e l e p o d e o p t a r p e l o e n d e r e ç o www.pousadaverao.com.br . É mais longo, mas é simples de comunicar. Se o nome for composto e ainda assim estiver ocupado, tente usar hifens ou underlines: Se o endereço www.pousadaverao.com.br já estiver ocupado, outra opção seria algo como www.pousada-verao.com.br (com hífen) ou www.pousada_verao.com.br (com underline ou sublinhado). Não é possível ter espaços no endereço. Para saber se seu nome é fácil, imagine ter que soletra-lo por telefone: Nomes muito longos (oficinaeautomecanicajuarez.com.br), ou com letras que se repetem (minhaacaoobjetiva.com.br) ou siglas com letras que podem confundir (abppt.coop.br) não são boas opções. Caso não consiga endereços nacionais (.br) tente os internacionais: Ao invés de www.verao.com.br, tente www.verao.com. Essa opção as vezes é ainda mais indicada, já que o endereço .com é ainda mais curto e rápido de se pronunciar. Porém a concorrência para um endereço .com é ainda maior, então se seu nome não for bem exclusivo, poderá ser difícil achar uma boa opção. 17 CRIANDO UM ENDEREÇO INTERNACIONAL Um endereço é considerado internacional quando não tem o componente que indique o país (.br, .pt, .es, .jp, etc.). As opções são poucas, e a concorrência é grande, mas se seu nome for exclusivo (ou se você der sorte) poderá ter um endereço bem curto e fácil de ser lembrado. O registro de endereços internacionais fica a cargo da Internic (www.internic.com), entidade ligada ao departamento de comércio dos Estados Unidos. Porém o registro e pagamento diretamente a Internic pode ser complicado (por conta do idioma e da necessidade de cartão de crédito internacional), então recomendamos que se procurem empresa brasileiras que intermediem esse contato. Sugestão para registros .com: acesse www.100br.com Tecnicamente o registro de endereços .com é mais rápido e até menos burocrático que endereços brasileiros, dado a não necessidade de CPF o CNPJ. Porém as opções de endereço são poucas: .Com .Net .Org .Info .Biz .Cc .Tv .Nu .Ws Empresas Empresas de internet Organizações De informações Contração de Business (negócios) Sigla de Credit Card (Cartão de Crédito) Televisão ? ? Após a criação e o pagamento do endereço (seja nacional ou internacional), o mesmo entra em funcionamento entre 24 e 48 horas depois. Este é o tempo que leva para que a informação do novo endereço seja recebida por todos os principais servidores do mundo, fazendo com que o endereço esteja disponível para qualquer visitante de qualquer país. 18 TECNOLOGIAS DE SITE Por tecnologia de site entende-se qual a linguagem de programação que o mesmo usará. Nossa apostila aborda o Xoops em particular, que usa PHP e banco de dados MySQL, mas é importante conhecer outras tecnologias, até mesmo para ver que a tecnologia que o Xoops usa proporciona a hospedagem com melhor custo benefício. Sobre tecnologia de sites, vejamos as mais comuns: Sites HTML: É o tipo mais simples de site. Não tem programação, e basicamente o site é um conjunto de páginas simples com links entre si. Não permite edição das páginas via internet, nem criação de formulários de contato*, nem interatividade com o usuário. Para hospedagens, os planos HTML são sempre os mais baratos. Sites Flash: Os sites em flash têm programação embutida, mas esta é simples e não precisa de maiores gastos com hospedagem (uma hospedagem HTML é suficiente para um site em Flash). Não permite edição das páginas via internet, nem criação de formulários de contato*, mas permite alguma interação mais avançada com os visitantes. Sites PHP: PHP é uma linguagem de programação livre muito usada para gerar conteúdo dinâmico na Web. Apesar de ser de fácil aprendizagem, o PHP é uma linguagem poderosa orientada a objetos. As hospedagens PHP são também baratas, perdendo apenas para as hospedagens HTML. Sites ASP: (de Active Server Pages) é uma estrutura de programação em Script que se utiliza de VBScript, JScript, PerlScript ou Python processadas pelo lado servidor para geração de conteúdo dinâmico na Web. Ele roda nativamente em servidores Windows, o que encarece a hospedagem (em geral a mensalidade é o dobro da PHP). Sites JAVA (JSP): (de Java Server Pages) é uma tecnologia utilizada no desenvolvimento de aplicações para Web, similar à tecnologia Active Server Pages (ASP) da Microsoft. A hospedagem em geral é a mesma dos sites em ASP. * Algumas empresas de hospedagem fornecem funcionalidades básicas com formulários. 19 Sites AJAX: (Asynchronous Javascript And XML) é o uso sistemático de tecnologias providas por navegadores, como Javascript e XML, para tornar páginas mais interativas com o usuário. AJAX não é uma tecnologia, são realmente várias tecnologias trabalhando juntas. O valor da hospedagem vai depender de quais tecnologias serão usadas. Sites Ruby On Rails: Trata-se de um framework de código aberto para desenvolvimento de aplicações Web, escrito em Ruby, extremamente produtivo e com baixa curva de aprendizagem. Hospedagens no Brasil ainda são raras e com preços semelhantes ao ASP. Sites Coldfusion: CFML ou ColdFusion Markup Language é uma linguagem baseada em tags que, por ser similar à linguagem HTML (também baseada em tags), apresenta uma boa curva de aprendizagem em comparação com outras linguagens tais como ASP e PHP. Porém o pouco uso no Brasil torna a hospedagem uma das mais caras e até raras no mercado. Sites Flash Communication Server: Páginas desse tipo oferecem uma interface excelente com interatividade grande, incluindo stream de vídeo e áudio, videoconferência nas páginas da internet, e até possibilidade de comandos de voz. Porém o preço de uma hospedagem com essa tecnologia é proibitivo e depende de muitos detalhes, até do número de conexões (visitantes simultâneos) ao site. Para Banco de Dados voltados para sites, os mais comuns são: MySQL: É atualmente um dos bancos de dados mais populares, e seu sucesso deve-se em grande medida à fácil integração com o PHP. É livre. PostgreSQL: Outro sistema também livre de banco de dados, porém mais discreto no mercado. Firebird: Baseado no código do InterBase da Borland, se tornou um banco com características próprias. Também livre. 20 SQL Server: Feito pela Microsof, é um Banco de dados robusto e usado por sistemas corporativos dos mais diversos portes, com integração com o Framework .Net. É um software caro. Microsoft Access: Vem incluído no pacote do Microsoft Office Professional. Usuários inexperientes podem usá-lo para construir aplicações simples, mas se recomenda algo mais poderoso para a Web. ESPAÇO E TRANSFERÊNCIA Espaço do site é quanto o serviço de hospedagem libera de espaço para os arquivos do seu site, isto é, a soma dos tamanhos de todos os arquivos que compôem seu site. É medido em Megabytes. Uma instalação básica do Xoops toma, pelo menos, 7 megabytes e esse valor vai crescendo com o uso do site. Lembrando que o uso de muitos fotografias, vídeos, arquivos de download e Flash aumenta o tamanho do site. Taxa de Transferência mensal é a soma de todos os downloads do seu site no mês. Toda vez que um visitante entra no site, ele está fazendo um download das suas páginas (e imagens) para visualizar no seu computador. Quanto mais visitantes você tiver, maior será sua transferência mensal. Outros fatores influenciam também, como tamanho de imagens, uso de vídeos e música, uso de flashs, etc. Caso um site ultrapasse o valor máximo de transferência estipulado pela empresa de hospedagem, o dono do site terá que pagar uma taxa adicional. É por isso que é importante manter sempre o site otimizado ao máximo, sem imagens muito grandes e sem abuso de flash ou vídeos. 21 Para um site básico em Xoops: A configuração de hospedagem ideal para um site em Xoops é: - Suporte a PHP. - Pelo menos 1 base de dados MySQL. - Pelo menos 50 Megabytes de espaço em disco para sites pequenos. Para sites com muitas figuras recomenda-se de 100 a 200 Megabytes. - Pelo menos 1 Gigabyte de taxa de transferência para sites pequenos. Sites com altos acessos ou com muitas imagens podem precisar de mais. - Pelo menos 5 contas de e-mail. 22 DADOS DA HOSPEDAGEM Após você fechar o contrato com a empresa de hospedagem, provavelmente a empresa lhe enviará vários dados sobre seu contrato. Senão vejamos um exemplo: Obrigado por efetuar sua hospedagem conosco! Abaixo estão os dados de sua hospedagem: Cliente: Login: Senha: FTP: Cpanel: CD Power Comércio cdpower t5y7u8 ftp.cdpower.com www.cdpower.com/cpanel DNS ns1.hospedaqui.com Vamos analisar esses dados enviados um a um: Cpanel: Trata-se do Painel de Controle do site. É nesse endereço que o usuário altera sua senha, cria novos e-mails, vê estatísticas de acesso, cria os banco de dados, etc. Login: Usuário ou Login identifica o cliente na hora de entrar no painel de controle. Senha: A senha dá acesso ao painel de controle, e em geral é a mesma senha do FTP. FTP: É o endereço que será usado para transferir arquivos para seu site na internet. É necessário um programa especial para usar esse endereço. Será abordado mais adiante. DNS: São endereços que terão que ser preenchidos no site em que você criou o seu domínio (ou no www.registro.br ou no www.100br.com). Ao criar seu endereço .com.br será pedido os servidores DNS. Basta colar essas informações lá. 23 Este é um fluxograma de sugestão de todo o processo de criação inicial de um site. É interessante estudar ele para ter noção que passos são realizados primeiro e que passos precisam seguir uma ordem para que tudo saia o mais rápido possível. Início Pesquisa do endereço .com Registro e criação do endereço Escolha das tecnologias do site Na hora de criação do endereço pode-se deixar em branco as informações do DNS por enquanto A escolha da tecnologia do site irá influenciar na escolha da hospedagem: Tecnologias diferentes têm preços diferentes. Pesquisa de Hospedagem Fechar contrato de hospedagem Voltar ao site de registro do endereço e digitar o DNS Acesar via FTP e começar a enviar os arquivos Após a entrada do endereço DNS, é normal uma demora de 24 a 48 horas para que o site esteja pronto para ser acessado e para se copiar os arquivos. Acesar o painel de controle e criar os e-mails 24 Acesar o painel de controle e criar as bases de dados (Dbs) FTP - FileTransfer Protocol Com o seu endereço registrado e com a hospedagem já contratada, você já pode inicar o envio das páginas para seu site. Para isso você utilizará um programa de FTP e o endereço de FTP enviado pela empresa de hospedagem. Existem vários programas de FTP, muitos inclusive gratuitos. Em nossos exercícios estaremos utilizando o LeechFTP* versão 1.3 em inglês, porém os princípios de uso do FTP são os mesmos para a grande maioria dos programas. Vejamos então a tela inical do programa: Botões de funções Status do FTP Painel de transferências Arquivos no site Arquivos no seu computador Botões de funções (principais) Upload (enviar para o site) Download (baixar do site) Desconectar Bookmark Lista de Endereços Baixar compactado Resuming (recomenda-se manter ligado) Modo de transferência (não mudar) Atualizar Sair * O LeechFTP encontra-se na pasta /FREEWARE do seu CD. 25 Primeiramente vamos cadastrar nosso endereço de FTP (que foi dado pela empresa de hospedagem) em nosso programa. Vamos clicar no botão Bookmarks e abrir a janela a seguir: Bookmarks Meus sites Vá em Edit > Add Bookmark e na janela seguinte preencha apenas os campos Host (o endereço de FTP), Username (o seu nome de usuário) e Password (senha). Não é preciso mudar nenhuma outra configuração. Dê OK. 26 Com este procedimento, você terá cadastrado o seu site na janela Bookmarks. Para acessar ele, bastará clicar sempre em Bookmarks e depois dar dois cliques no ícone do seu site. Se os dados tiverem sido corretamente digitados, o programa irá se conectar aos arquivos do seu site e irá exibí-los no painel da direita (arquivos do site). Atenção às pastas: Em geral, o endereço FTP assim que é acessado mostra algumas pastas. Apenas uma delas lhe leva aos arquivos do seu site. Em geral os nomes das pastas onde estarão seus arquivos são htdocs, public_html ou www. Não é recomendado vasculhar ou alterar as outras pastas. 27 Para trasnferir arquivos entre seu site e seu computador, basta usar os botões upload e downlaod. Para fazer um upload, selecione os arquivos que você quer enviar no painel do centro e clique no botão upload. Uploads Durante o processo de upload, você pode acompanhar os envios e a lista de arquivos a serem enviados, bem como as falhas pelas orelhas do painel mais a esquerda (painel de transferências): Transferências Fila de downloads Fila de uploads Falhas nos processos 28 Observações sobre as transferências: Ao selecionar arquivos para o upload, os arquivos são listados na fila de upload para as devidas transferências. O processo demora de acordo com sua conexão e com o tamanho dos arquivos. Arquivos de texto são rápidos, arquivos multimídia (fotos, vídeos e textos) são mais lentos. Na orelha Threads (transferências) há uma opção do número máximo de transferências simultâneas. Este recurso pode acelerar o processo de envio de arquivos desde que seja bem utilizado. O ideal é: Para arquivos pequenos ( menos de 10Kb) 3 a 7 conexões. Para arquivos grandes (imagens e vídeos) máx. 3 conexões. Muita atenção na guia Failures (falhas), pois ela indica os arquivos que não puderam ser enviados por algum motivo desconhecido. É bastante comum que no envio de vários arquivos, algumas dezenas de arquivos falhem. Se um arquivo tiver sido esquecido de ser enviado, o site pode ficar instável e será muito difícil achar o arquivo que falta no meio dos outros milhares. Para garantir que todos os arquivos foram transferidos, é preciso selecionar os arquivos falhados e reenviar (botão resubmit job). Mensagens vermelhas acusam a falha na transferência de arquivos. Botão Reenviar (resubmit job) Seta verde Os arquivos falhados devem ser selecionados na orelha Failures e reenviados 29 INSTALANDO O SERVIDOR E O BANCO DE DADOS Para instalar e testar o Xoops, precisamos de um servidor de Internet. Um servidor é nada mais que um computador preparado para receber requisições de páginas de internet. Em geral, contratamos o serviço de uma empresa de hospedagem que nos oferece um servidor deles, mas felizmente podemos transformar nosso computador caseiro em um servidor para testes. SERVIDOR WINDWOS COM XAMPP Para instalar o Xoops em um computador com Windows, o melhor caminho é utilizar o pacote XAMPP, um software livre que já vem com Apache, MySQL, PHP e Perl. O pacote Xampp é completo e não faz nenhuma alteração no seu Windows. Se quiser desinstalar, basta apagara pasta. A versão que iremos utilizar aqui é a XAMPP Lite para Windows. Passo 1: Descompacte o arquivo ZIP em um diretório a sua escolha. Procure o ícone setup_XAMPPlite.bat e inicie a instalação. 30 Passo 2: Se a instalação for bem sucedida, inicie os serviços pelo ícone xampp-control. Clique em Start nos botões ao lado de Apache e MySQL para iniciar estes serviços. O aviso Running (em fundo verde) informa que o serviço foi iniciado corretamente. Atenção ao seu Firewall. Ao ligar os serviços do XAMPP, o Firewall do Windows poderá perguntar se quer mesmo desbloquear os serviços. Clique em desbloquear. Passo 3: Inicie seu browser de internet e digit http://localhost . Você deverá ver a tela inicial do XAMPP. Caso não apareça nada, verifique se o endereço digitado está correto e cheque no painel de controle do XAMPP se os dois serviços (Apache e MySQL) estao rodando (palavra running ao lado). Nos links a esquerda na página do XAMPP será possível encontrar o phpMyAdmin que é o programa que lhe dará acesso ao Banco de Dados MySQL.Neste endereço é possível criar o banco de dados a ser usado com o Xoops. Lembrando que os arquivos do Xoops devem ser copiados para dentro da pasta HTDOCS, de preferência em uma pasta só para o Xoops (tipo C:/xamplite/htdocs/xoops) para não misturar com os arquivos do XAMPP. 31 Copiando o Xoops dentro do XAMPP wBaixe a versão mais atual do Xoops e descompacte em uma pasta qualquer. Dentro do pacote Xoops padrão você verá as seguintes pastas: wdocs: Contem informações sobre o pacote do Xoops e instalação. wextras: arquivos extras necessários caso o usuário precise instalar funcionalidades especiais, como o módulo Protector. whtdocs: Local onde estão os arquivos do Xoops em sí. wupgrade: arquivos necessários para fazer upgrade de versões antigas do Xoops (leia manuais das atualizações). wchecksum.php e checksum.md5: Arquivos necessários para verificar se todo o Xoops foi enviado corretamente para a hospedagem. wrelease_notes.txt: texto com as notas de lançamento da versão. Os arquivos a serem copiados para o servidor são somente o da pasta HTDOCS. Selecione os arquivos contidos dentro dessa pasta e os copie para uma pasta criada dentro da pasta HTDOCS do XAMPP. Copiar/Colar Diretório do XAMPP C:/xampp/htdocs/meuxoops Pasta criada para o Xoops Arquivos da pasta htdocs do pacote Xoops Caso necessite de mais de uma instalação do Xoops no mesmo servidor (para testes de versões, ou para criar vários sites diferentes ao mesmo tempo), crie uma pasta para cada instalação do Xoops. No Xoopos é necessário ainda alterar as permissões de acesso de algumas pastas e arquivos. As pastas a serem alteradas são cache, templates_c, uploads e xoops_data, além do arquivo mainfile.php. Porém no windows esse procedimento é desnecessário, haja visto que as propriedades dos arquivos no windwos já são por padrão liberados. 32 SERVIDOR LINUX COM OPENSUSE O sistema operacional Linux é muito usado como servidor de internet por ser um sistema seguro e a prova de falhas. Para que nosso servidor funcione, precisamos ter instalado e funcionando os serviços PHP, MySQL e Apache. A maneira mais fácil de baixar tudo da internet é acessando o ícone YaST, que é um programa baixador de repositórios (programas) para o Linux. Clique no menu inicial (camaleão), depois em Aplicativos > Sistema > Configuração > Instale Software. Será pedido a senha de administrador; digite-a. Na opção Filtro, mude para Padrões. Na listagem que aparece abaixo, procure pelas Funções de Servidor Servidor de Internet e LAMP. Marque a opção e clique em Aceitar (canto inferior direito) para baixar os pacotes correspondentes. Tenha em mãos o DVD de instalação do seu openSUSE; ele será pedido. Lembre-se também que parte dos pacotes pode precisar ser baixado da Internet. Certifique-se que sua conexão à rede esteja funcionando. Após a instalação dos pacotes, precisamos ligar nosso servidor de Internet. Vá no menu inicial (camaleão) > Computador > Configurações de administrador. Entre com a senha de Administrador e acesse o ícone Serviços de Rede. Clique então em Servidor HTTP no painel direito. Você entrará em uma sequência de 5 passos para configurar seu servidor. 33 5 passo para configurar o Servidor HTTP no YaST 1 - A porta configurada deve ser a 80, e o servidor deve estar escutando a interface 127.0.0.1. Marque o ítem Abrir porta no Firewall. 2 - O ítem Ativar scripts de PHP5 deve estar selecionado. 3 - Será exibido um resumo das configurações. Normalmente não é necessário mudar nada. 4 - Hosts virtuais. Não mude nada. 5 - Selecione Iniciar Servidor Apache2 durante a Inicialização. Isso fará com que seu Linux sempre esteja pronto para exibir seu site em Xoops. Quando o YaST perguntar se deseja instalar novos pacotes, responda sim, pois é bom aproveitar e instalar o phpMyAdmin. Na opção filtro, agora escolha pesquisa, e faça uma pesquisa com o nome phpmyadmin. Selecione o pacote e clique em aceitar para começar a baixar. É necessário estar conectado à Internet para atualizar e baixar o pacote phpMyAdmin, pois este não está no DVD de instalação do openSUSE. Verifique se sua conexão com a Internet já está funcionando antes de instalar novos pacotes. O Linux geralmente se conecta mais facilmente à internet via conexões físicas (cabo de rede). Se sua internet é sem fio (wi-fi, 3G, etc.) experimente conectar-se via cabo de rede. Caso você não consiga baixar o phpMyAdmin, ainda assim será possível instalar e usar o Xoops, porém será necessário o phpMyAdmin para acompanhar instruções sobre criação, administração e exportação de banco de dados. Sem ele, provavelmente você não poderá exportar seu site do seu computador local para a Internet. Após a instalação, abra o navegador de internet e acesse a página localhost (http://localhost/). Caso todos os softwares estejam funcionando bem, a mensagem It works irá aparecer no navegador. Para verificar se o phpMyAdmin está funcionando (não é obrigatório), o endereço é http://localhost/phpMyAdmin. 34 Caso não tenha funcionado, o Apache e o MySQL devem estar desligados. Acesse a configuração do Sistema YaST (menu inicial > Computador > Configurações de administrador), clique em Sistema > Serviços do sistema (nível de execução), e na lista que aparece, habilite o Apache e o MySQL (clique na opção desejada e depois no botão Habilitar). Teste novamente o endereço http://localhost/ no navegador. Caso ainda persistam problemas, verifique a instalação dos pacotes. Copiando o Xoops dentro do Apache Baixe e descompacte o pacote do Xoops dentro de uma partição linux. Caso você tenha feito o download do Xoops no Windows para instalar depois no Linux, acesse a partição windows de dentro do Linux (no openSUSE, clicando em Meu Computador e depois na partição correspondente) e copie o arquivo compactado (.ZIP ou .TAR.GZ) para dentro de uma partição Linux antes de fazer a descompactação. Não copie a pasta que foi descompactada no Windows. Este procedimento é importante para manter as permissões de acesso aos arquivos. Analisando os arquivos do pacote Xoops, temos as seguintes pastas que foram descompactadas: wdocs: Contem informações sobre o pacote do Xoops e instalação. wextras: arquivos extras necessários caso o usuário precise instalar funcionalidades especiais, como o módulo Protector. whtdocs: Local onde estão os arquivos do Xoops em sí. wupgrade: arquivos necessários para fazer upgrade de versões antigas do Xoops (leia manuais das atualizações). wchecksum.php e checksum.md5: Arquivos necessários para verificar se todo o Xoops foi enviado corretamente para a hospedagem. wrelease_notes.txt: texto com as notas de lançamento da versão. Os arquivos do Xoops a serem copiados para o servidor são somente o da pasta HTDOCS. Para copiar os arquivos para a pasta do seu servidor local (/srv/www/htdocs) é necessário abrir um Gerenciador de 35 Arquivos no modo Superusuário. Para isso vá no menu inicial > aplicativos > sistema > gerenciador de arquivos > Gerenciador de Arquivos (modo Superusuário). Será pedido a senha de Administrador. No Gerenciador de Arquivos no modo Superusuário, navegue até a pasta raíz (pasta vermelha) e entre nos diretórios do servidor: /srv/www/htdocs. Crie uma pasta para sua instalação do Xoops e copie e cole dentro desse diretório os arquivos do Xoops. Copiar/Colar Diretório do servidor HTML /srv/www/htdocs/meuxoops Pasta criada para o Xoops Arquivos da pasta htdocs do pacote Xoops Ainda no Gerenciador de Arquivos, será necessário alterar as permissões de acesso de algumas pastas e arquivos. As pastas a serem alteradas são cache, templates_c, uploads e xoops_data. Clique individualmente com o botão direito em cada pasta e escolha propriedades. Em permissões, marque Pode ver & modificar o conteúdo para os 3 tipos de usuário: dono, grupo e outros. Marque também a opção aplicar mudança a todas as sub-pastas e seus conteúdos. Altere também as permissões de acesso do arquivo mainfile.php para pode ler & escrever nas 3 opções. Pronto! Seu Xoops está pronto para ser instalado! 36 SERVIDOR NA INTERNET Caso você esteja instalando o Xoops em uma hospedagem paga, todos os softwares necessários (PHP e MySQL) e a base de dados já estarão rodando direitinho. Para fazer o upload (subida) dos arquivos do Xoops, utilizaremos um programa de FTP. Recomendamos o uso do LeechFTP, já abordado anteriormente. Descompacte o pacote do Xoops. Dentro do pacote Xoops padrão você verá as seguintes pastas: wdocs: Contem informações sobre o pacote do Xoops e instalação. wextras: arquivos extras necessários caso o usuário precise instalar funcionalidades especiais, como o módulo Protector. whtdocs: Local onde estão os arquivos do Xoops em sí. wupgrade: arquivos necessários para fazer upgrade de versões antigas do Xoops (leia manuais das atualizações). wchecksum.php e checksum.md5: Arquivos necessários para verificar se todo o Xoops foi enviado corretamente para a hospedagem. wrelease_notes.txt: texto com as notas de lançamento da versão. Acesse sua conta de FTP e procure uma pasta que pode ter os seguintes nomes: HTDOCS, HTTP ou PUBLIC_HTM e copie os arquivos da pasta HTDOCS do Xoops lá. Este processo pode ser bem demorado de acordo com sua internet. Tenha paciência. Você pode instalar o Xoops dentro de uma pasta no seu site (www.seusite.com/meuxoops). Isto pode ser importante caso você já tenha um site funcionando (em Xoops ou não) e queira instalar o Xoops para teste ou mesmo para migração do site antigo para um site em Xoops. Você também pode instalar mais de uma cópia do Xoops em seu site, bastando para isso criar uma pasta para cada instalação. Se você instalou o Xoops em uma pasta, e agora quer que seus visitantes acessem diretamente seu site, basta criar um redirecionamento automático do endereço principal (www.seusite.com) para a pasta do Xoops. Pesquise por esse procedimento HTML na internet. 37 Alterando as permissões de pastas importantes O Xoops precisa que algumas pastas e arquivos tenham suas propriedades de acesso alteradas antes de ser instalado. Basicamente as pastas /uploads, /caches, /templates_c, xoops_data e o arquivo mainfile.php precisam estar marcados para serem acessados livremente. Através do programa de FTP, procure os arquivos ou pastas a serem alterados e escolha propriedades. Defina o acesso 777 para as pastas, e acesso 666 para o arquivo mainfile.php (veriique as instruções em seu programa FTP). 38 INSTALANDO O XOOPS Com o servidor (local ou não) já pronto, e os arquivos copiados agora sim vamos começar a manipular os arquivos do Xoops. A instalação do Xoops a partir e agora ocorre toda através do navegador de internet (explorer, firefox, safari ou chrome). Acesse através do seu navegador o seu site (se for instalado no seu computador, acesse http://localhost; se já estiver na internet, acesse www.seusite.com.br). Se tudo correr bem, você verá a página de instalação do xoops a seguir: Se você não tem certeza se todos os arquivos foram enviados corretamente para o servidor, ou se você está recebendo telas brancas ao acessar seu site, copie na pasta raiz do site os arquivos checksum.php e checksum.md5 e acesse-os pelo navegador (servidor local: localhost/checksum.php, ou se estiver já na internet: www.seusite.com/cheacksum.php). 39 O processo de instalação daqui em diante é simples, tendo o usuário somente que prestar atenção às informações que o programa solicita. A primeira tela pergunta qual será o idioma padrão a ser instalado. Escolha o idioma português e pressione next. A partir desse momento a instalação passa toda a ser em português. A Segunda tela somente explica o que é o Xoops e passa um checklist de tudo que você tem que ter já aprontado para continuar com a instalação do Xoops. Clique em próximo. A terceira tela faz uma verificação inicial do seu servidor, verificando qual a versão do PHP, se pode fazer uploads, etc. Clique em próximo. A Quarta tela pergunta os caminhos físicos e virtuais do site. O Xoops já preenche automaticamente esses dados. Você deve apenas verificar se a ferramenta automática achou corretamente os caminhos. O caminho físico do site é o diretório em que seu Xoops está instalado (ex: no WinXP pode ser semelhante a C:\xampp\htdocs). O caminho virtual é o endereço de acesso ao site através do navegador. Se o site já estiver na internet, será algo como http://www.seusite.com. Se estiver em um computador local, será algo como http://localhost/site. 40 A qunta tela pede os seguintes dados: Banco de dados: Escolha MySQL Endereço do servidor de banco de dados: Na grande maioria das vezes é localhost mas alguns provedores de internet podem dar um endereço diferente, semelhante a mysql.seusite.com . Nome de usuário do banco de dados: Caso esteja instalando localmente (no seu computador com windows ou linux) use root. Caso esteja instalando na internet, use o nome de usuário fornecido pelo seu provedor. Senha de usuário do banco de dados: Se estiver usando o usuário root, provavelmente deixe a senha em branco. Caso esteja instalando na internet, use a senha de usuário fornecida pelo seu provedor. 41 A Sexta tela pede: Nome do banco de dados: Se você estiver já colocando o site em um provedor de internet, este nome é dado pelo seu provedor. Na maioria dos casos, corresponde ao nome do seu site. Caso tenha dúvidas, acesse seu painel de controle da sua hospedagem e verifique o ítem base de dados, ou entre em contato com seu provedor de hospedagem. Se você estiver instalando localmente (no Windows ou Linux), escolha um nome ligado ao site que está criando. O Xoops irá tentar criar o banco de dados no MySQL. Prefixo das tabelas: Um conjunto de letras que possa identificar as tabelas do Xoops no seu banco de dados. Em geral não é necessário alterar o valor aqui mostrado. O Xoops preenche aleatoriamente (por questões de segurança) esse valor. Conjunto de caracteres para o Banco de Dados: Se você estiver instalando um site em português, procure a opção latin1 (cp1252 West European). Onde pede Banco de dados Collation, deixe a opção default (padrão), que provavelmente será latin1_swedish_ci. Ao clicar em próximo, os dados serão gravados no arquivo mainfile.php e será exibida uma tela com a revisão de todos os dados a serem usados. Se eles estiverem corretos, será dada a gravação das tabelas do banco de dados. 42 Na tela seguinte, o Xoops irá criar o banco de dados (caso ainda não exista) e irá criar as tabelas padrão do Xoops. O Xoops então pedira que você informe os dados de acesso do administrador do site: Entre com seu nome de usuário, e-mail e digite sua senha duas vezes. Se você já estiver instalando esse Xoops na internet, não coloque uma senha fácil. Após clicar em próximo, uma nova gravação na base de dados, e depois seu xoops está instalado, pronto para ser configurado e usado! 43 CONFIGURANDO O XOOPS Agora que estamos com nosso sistema instalado, vamos aprender a configurar ele para nossas necessidades. Por mais simplório que pareça a tela inicial, não se engane! O Xoops é bastante poderoso e poderá ser configurado e personalizado do jeito que você quiser, desde que tenha conhecimentos para isso. Para entrar na área administrativa, entre com seu login e senha que foram criados na instalação do Xoops. Após uma mensagem de boas vindas, você verá o menu de Usuário, onde deve agora clicar no link Menu de Administração. 44 Painel de controle padrão Painel de controle EXM A área administrativa do Xoops inicialmente parece muito com a página inicial. Porém ela não é personalizável, então quando nosso site estiver já todo nas nossas cores e com nossas logos, a área administrativa sempre terá o tom e as marcas do Xoops. Acessando o link Sistema a esquerda, teremos acesso a todos os links de configurações do Xoops. Inicialmente iremos explorar o sublink Preferências. Acessando agora as Configurações Gerais, iremos gravar os primeiros dados de nosso site: wNome do site: É o nome que irá aparecer nas páginas principais, e o nome que será cadastrado nos sites de busca. Seja breve e direto! Pode usar espaços e acentuação. wSlogan do site (ou da empresa): Uma frase sobre o seu site. Irá aparecer na página principal. wEndereço de e-mail do administrador: E-mail que irá receber avisos do site (ex: quando um novo usuário se cadastrar, o site poderá enviar um e-mail para o administrador avisando. wLíngua preferencial: Muda a lingua dos textos do Xoops. Existem opções de criar sites multi-linguas (com mais de uma língua selecionada pelo visitante). Pesquise nos sites de xoops. wMódulo Inicial: Como nosso site não tem nenhum módulo ainda instalado, então não aparece nenhuma opção aqui. Porém depois poderemos definir aqui que nossa página principal mostre primeiro as notícias, ou qualquer outro módulo. wZona de tempo do servidor (procure saber com seu provedor). wZona de tempo do site: As informações sobre as zonas de tempo 45 devem ser configuradas corretamente para que as datas de envio de mensagens (ex. Notícias) apareçam corretamente. Se a página está hospedada nos USA e é visitada por pessoas do Brasil, as zonas devem ser configuradas baseadas nesses dados. wPainel de Controle Padrão: Temos o painel Default (padrão) que é o painel comum do Xoops desde a primeira versão; e temos o painel EXM, criado pelo Xoops Mexico, sendo esse um painel mais bonito, com novos ícones e melhor navegação. Desse ponto em diante iremos trabalhar somente com o painel de controle EXM, porém isso não irá dificultar usuários que prefiram o painel antigo. wTema padrão: O tema é o conjunto de arquivos que dá a cara do seu site. Inicialmente não iremos abordar mudança no tema agora, então poderemos deixar em default. A criação de temas será abordado no capítulo Personalizando o Xoops. wAtualizar os modelos de módulo do diretório "themes/templates"? Selecione sim caso esteja fazendo testes e alterando os arquivos de personalização do site (temas e modelos). Se essa caixa estiver marcada com não, ao alterar os arquivos do tema (ex: mudar cor de menu, alterar logomarca) as alterações não irão aparecer para os visitantes. Então quando estiver fazendo a personalização de seu xoops, lembre-se de sempre marcar sim. wTemas selecionáveis: O seu site pode ter mais de um tema ao mesmo tempo, e você pode dar a opção dos visitantes escolherem esses temas (bastando ligar o bloco temas). Nessa caixa de seleção, você marca todos os temas que os visitantes podem utilizar (para marcar mais de um tema, use CTRL + clique). wConjunto de modelos (templates): O template (ou modelo) também faz parte da personalização do xoops, e será abordado depois. Poderemos deixar ele em default por enquanto. wNome do usuário anônimo: Como você chamará os usuários anônimos (ex: visitante, colaborador, etc.). wGZIP: Tenta acelerar o acesso ao site. Recomenda-se ligar. wNome dos cookies: Altere o ‘xoops’ por algo que identifique seu site. Assim seus cookies não se confundirão com outros sites xoops. Ex: macarrao_user. wUsar sessão personalizada: Selecione sim caso queira que o site lembre o nome de usuário no login, através de cookie. Isso permite que os usuários do site se loguem mais rapidamente. wNome da sessão: Faça o mesmo que nos nome dos cookies: personalize. 46 wDuração máxima da sessão em segundos: Tempo máximo em segundos para uma sessão desativada. Caso um usuário não acesse nenhuma página do site dentro desse tempo, ele é deslogado. wModo Debug: Mantenha desligado a não ser que esteja tendo problemas com telas brancas. wAtivar banners: Se for utilizar o sistema de banners do xoops para anúncios, ligue-o. Porém se for utilizar os sistemas de banners de outra empresa (Google, Yahoo, UOL, MercadoLivre) desligue: a forma de implementação dessas publicidades é outra e será abordada na criação do tema do site (personalização). wDesligar o site: Caso seja necessário fazer manutenções em seu site e deseja impedir que os visitantes acessem o site durante esse período wMotivo para fechamento do site: Texto a ser exibido caso o site esteja desligado. wO seu IP: Caso não queira que suas visitas influenciem as estatísticas de acesso do site, entre com seu IP aqui (somente se utilizar IP fixo). wUsar SSL ao entrar no site? SSL é o sistema de criptografia para envio de informações pela internet. O Xoops pode utilizar SSL (cadeado no navegador) da mesma forma que um banco usa, dando segurança no envio do usuário e senha do xoops. Porém o uso de SSL requer que a hospedagem forneça uma página (ou diretório especial da hospedagem) que tenha SSL. Consulte seu provedor sobre o assunto. wNome da variável SSL Post: Caso use SSL, personalize esse valor. wURL onde a página de entrada com SSL está localizada: Informação que será dada pelo provedor de acesso. wPadrão de visualização dos comentários: O xoops tem um gerenciador de comentários para todo o site. Essa caixa de seleção define qual é a forma padrão de exibição desses comentários. wPadrão de ordenação dos comentários: Define qual é a ordenação padrão de exibição desses comentários. wAtivar as restrições de IP: Sistema de segurança que barra o acesso ao site de visitantes. Basta colocar o IP do visitante na lista de banidos para que este não consiga mais acessar o site. Porém é uma medida ineficaz, já que oda vez que um usuário comum entra na internet, seu número de IP muda. 47 wIps Banidos: Lisa de Ip’s a serem banidos. wCache de módulos: Cache (leia-se kesh) é uma técnica de aceleração de acesso ao site. O site pode cachear módulos, gravando as páginas mais acessadas para que sejam visitadas mais rapidamente. Porém se essas páginas sofrerem alterações, os visitantes não irão ver imediatamente essas mudanças, já que estão ainda vendo as páginas cacheadas. Para utilizar bem essa função e acelerar o acesso ao seu site, ligue os caches e defina os tempos de cache baseados nas alterações das informações dos módulos. Ex: se o módulo notícias recebe informações constantemente, ligue o cache com um tempo curto (minutos). Se a página quem somos é praticamente fixa, sem alterações em meses, ligue o cache com um tempo longo (vários dias ou semanas). Se você alterou alguma informação no seu site (notícia, página com conteúdos, etc) e a alteração ainda não foi ao ar, pode ser que o site esteja ainda mostrando as informações do cache. Para resolver, basta limpar o cache. Para isso, acesse Preferências > Configurações Gerais, e, sem alterar nenhum dado, clique em Prosseguir no final da página. Isso irá resetar todos os caches gravados. Ao final das mudanças nas configurações, clique em prosseguir para gravar as alterações. Se você passar muito tempo para gravar as alterações feitas nas telas de configuração, o xoops dará um aviso VALID TOKEN EXPIRED, e não gravará as alterações. 48 Preferências »» Configuração dos usuários Esta área de configuração define todo o manejo com novos usuários do seu site: wPermitir o registro de novos usuários? Caso esteja ligado, visitantes do site serão convidados a se cadastrar, preencher os dados, e participar do seu site como usuário. wTamanho mínimo para as senhas wTamanho mínimo do nome de usuário wTamanho máximo do nome de usuário wPermitir que os usuários mudem de endereço de e-mail? wEnviar mensagem de Boas Vindas: Caso esteja ligado, o usuário recém cadastrado irá receber uma mensagem de boas vindas no e-mail dele. wAvisar por e-mail quando um novo usuário se cadastrar? Aviso ao administrador do cadastro de novos usuários. wAvisar os grupos: wSelecione o tipo de ativação do registro de novos usuários: w Ativação pelo usuário: O usuário receberá um e-mail com a mensagem: clique aqui para confirmar o seu registro. Recomendado. w Ativação automática: Assim que o usuário entrar com os seus dados, seu cadastro estará pronto (não é completamente seguro porque não verifica se o e-mail é válido). w Ativação por administrador: O administrador tem que entrar no site e aprovar um a um os usuários que se cadastraram. wEnviar o e-mail de ativação de conta para (válido apenas quando a opção 'Ativação pelos administradores' é selecionada): wNível de restrição para caracteres no nome de usuário: wPermitir o envio de avatares? Avatar é uma imagem que representa o usuário. Muito utilizado em fóruns de discussão. wNúmero mínimo de mensagens requerido: Você pode definir que o usuario tenha que mandar um número X de mensagens antes de poder cadastrar seu Avatar. wPermitir que os usuários apaguem as suas próprias contas? wExibir o termo de responsabilidade?Termo de responsabilidade é o texto a ser exibido no ato do cadastro do usuário no site. Informa, além de outras coisas, que o usuário é responsável por tudo que disser nas áreas do site, sendo este último isento das opiniões de seus visitantes. 49 Preferências »» Meta-dados e rodapé Informações importantes, principalmente para que nossos sites sejam bem ranqueados em sistemas de busca como o do Google. Quanto mais preciso essas informações forem colocadas, melhor será de seu visitante encontrar seu site na internet: wPalavras-chave (Palavras-chave que tenham a ver com o site): Inclua palaras separadas por vírgula que tenham muito a ver com o conteúdo de seu site. Lembre-se de incluir informações geográficas (como país, estado, cidade e bairro) e nunca coloque palavras que não fazem parte do conteúdo de seu site. wMeta Description: Descreva o seu site, seus objtivos, produtos principais e informações gerais em até 3 linhas. Essa descrição poderá ser usada pelo Google, por exemplo, na hora de exibir seu site nas buscas. wO campo Meta Robots informa aos sistemas de busca qual tipo de conteúdo será indexado ou rastreado. wO campo Meta Rating define a classificação do conteúdo do site. wAutor: Pode ser uma pessoa física ou jurídica. w Meta Copyright: Contém as informações sobre os direitos de reprodução dos documentos disponíveis. Caso não queria que o material de seu site seja copiado, escreva copyright. Caso não se importe que o material do seu site seja copiado (dando-lhe o crédito) use o copyleft. wRodapé: Define tudo que irá aparecer no final da página de seu site. Preferências »» Palavras censuradas O Xoops dispõe de um eficiente sistema de bloqueio de palavras censuradas, muito útil nos comentários dos usuários. Nesse sistema, palavras cadastradas serão substituidas por uma palavra padrão, impedindo que termos indevidos sejam registrados no site. Lista de palavrões já completa podem ser encontradas na internet. Preferências »» Opções de pesquisa O Xoops já conta com um ótimo sistema de busca interna. Caso queira desligar a busca, ou mudar parâmetros de busca, essa é a área de configuração. 50 Preferências »» Configuração de e-mail Para que seu site envie e-mails corretamente (tanto para usuários como para administradores), as opções aqui listadas devem estar corretamente configuradas e testadas. Primeiramente certifique-se que ser servidor de internet (seja local via Xampp ou na internet via seu provedor de hospedagem) esteja preparado para enviar e-mails. Em geral, o pacote Xampp no windows não está preparado para enviar e-mails. Para sua hospedagem na internet, faça testes e consulte o suporte para verificar as configurações. we-mail do remetente: Conta de e-mail que será usada para enviar os e-mails do site. Recomenda-se criar uma conta de e-mail só para o site (ex: [email protected]). wNome do remetente: O nome que constará no cabeçalho dos emails enviados pelo site. wUsuário remetente de MP: MP é mensagem particular. O Xoops tem já um sistema de envio de mensagens para usuarios registrados no site. Crie uma conta para o site e selecione-a aqui para que o site possa se comunicar com os usuários sem ser por e-mail. wMétodo de envio: Teste as configurações uma por uma para saber qual delas funciona com seu servidor. wCaminho do sendmail: Caso use a opção sendmail, verifique se o caminho digitado corresponde ao serviço. Entre em contato com sua hospedagem para tirar a dúvida. wServidor(es) SMTP: Caso vá usar uma conta com SMTP para o envio, digite aqui os servidores de SMTP a serem usados (deve ser algo como smtp.seusite.com). wNome de usuário do SMTPAuth: SMTPAuth é SMTP autenticado. São contas de e-mail que precisam ser autenticadas também para enviar mensagens. Se esse é o caso do seu e-mail, selecione SMTPAuth, e digite aqui o nome de usuário da sua conta de e-mail. wSenha do SMTPAuth. Para testar as configurações de e-mail, vá em Sistema > Contatar usuários. Lá será possível escrever uma mensagem teste de e-mail e selecionar um grupo de usuários para receber a mensagem teste. 51 Banners O Xoops já contém um sistema de administração de Banners bastante eficiente e prático. É uma ótima solução para sites que precisem de publicidade para arrecadar fundos baseados em publicidade. Ao clicar em banners, você verá informações do tipo banners ativos, banners expirados (fora do ar) e clientes com propaganda. Os banners cadastrados na instalação básica são os do Xoops, em versão GIF animado e em Flash. Para que seus banners sejam exibidos corretamente, o seu tema (cara do site) tem que aceitar corretamente os banners. Nem todos os temas aceitam banners. Ao vender publicidade no seu site em Xoops, primeiramente você deve cadastrar seu cliente, no formulário incluir novo cliente. Será pedido nome, e-mail, e um usuário e senha. Esses dados são para que o cliente possa verificar o andamento da campanha dele pessoalmente, através do endereço www.seusite.com/banners.php . Após incluir o cliente, você incluirá os banners do cliente, através do formulário incluir novo banner. Será pedido qual o cliente, quantas impressões foram pedidas, a URL do banner, a URL do cliente (para o visitante clicar no banner e ser enviado para o site do cliente) e códigos HTML opcionais (necessários caso o banner seja em Flash). Atenção: O sistema de banners do Xoops não tem envio de arquivo automatizado. Você deve enviar os arquivos dos banners via FTP para algum diretório qualquer do seu site. Recomendamos a pasta uploads. 52 Blocos Essa provavelmente é uma das telas mais complicadas porém mais poderosas no sistema Xoops. Os blocos definem muito da exibição das informações do Xoops e, quando bem configurados, podem montar estruturas de páginas dignas de grandes portais avançados. Um bloco é uma caixinha de informação, posicionada pelo designer do site, que irá mostrar dados, links ou formulários de módulos ou do próprio sistema Xoops. Os administradores do site também podem criar blocos personalizados, que podem conter uma imagem, um banner, um código HTML ou PHP. O menu principal e o menu pessoal são os blocos principais, já que eles devem sempre estar visíveis para que os usuários do site tenham links para acessar o site. Na listagem dos blocos, vamos ver o que significa cada uma das colunas: wTitulo: O título do bloco que será exibido. Pode ser alterado pelo administrador. wDescrição do Bloco: Diz suscintamente o que o bloco faz. wMódulo: Diz a que módulo o bloco pertence. Blocos Principal, Votação e Pesquisa wTipo Esquerda - Centro - Direita: alinhados verticalmente num site. Informa em qual posição o bloco irá aparecer na página. wVisivel em: Marca em que páginas o bloco será visível. Para selecionar mais de uma página, basta clicar segurando o CTRL. 53 wTempo de cache: Assim como os módulos possuem caches para acelerar a exibição do site, os blocos também podem ser acelerados. A regra é a mesma para os módulos: defina o tempo do cache de acordo com a frequência de atualização das informações do bloco; blocos que raramente mudam podem ter um tempo longo (dias, semanas). Blocos muito imeditatos (como resultados de votações, notícias, contador de visitas) precisam ter tempos curtos de cache (segundos, minutos). wVisível: Marca se o bloco será visível ou não. wAção Editar: Ao clicar, mostrará as mesmas opções de configuração da tela anterior, podendo o administrador do site verificar mais corretamente as configurações do bloco em questão. Nessa tela Editar também se encontra um link para a edição do modelo (ou template). Isso é útil quando precisamos mudar o formato que as informações dadas pelo bloco são exibidas. Para saber mais sobre isso, veja sobre Modelos (ou templates) na página 67. wAção Clonar: Você pode criar cópias dos blocos. Isto serve para dar mais versatilidade à exibição dos blocos. Exemplo: você pode ter o bloco Menu Principal exibido normalmente na esquerda na tela principal, mas pode ter um blolo clone do Menu principal sendo exibido na direita somente na tela de notícias. Se um bloco está configurado corretamente mas não é exibido para os visitantes do site, verifique se o grupo visitante tem acesso a visualizar esse bloco. Veja mais na parte Grupos, página 61. 54 Cabeçalho (definido pelo tema) Cores e estilo dos blocos (definido pelo tema) Área do Módulo Rodapé (definido pelo tema) As posições laterais definem que os blocos ficarão nos extremos do site. São posições importantes para menus, busca e informações importantes que devem sempre estar em local de fácil acesso aos visitantes. Caso não exista nenhum bloco marcado para um dado lado (esquerda ou direita), a fileira de blocos não aparece. Alguns temas não possuem o bloco direito. Ao usar esses temas,marcando um bloco na direita, ele não aparecerá 55 Cabeçalho (definido pelo tema) Cores e estilo dos blocos (definido pelo tema) Área do Módulo Rodapé (definido pelo tema) As posições superiores definem blocos que irão aparecer acima do conteúdo do módulo. As opções são centro-centro, centro-esquerda e centro-direita. Alguns temas podem não possuir as opções centroesquerda e centro-direita. 56 Cabeçalho (definido pelo tema) Cores e estilo dos blocos (definido pelo tema) Área do Módulo Rodapé (definido pelo tema) As posições inferiores definem blocos que irão aparecer abaixo do conteúdo do módulo. As opções são centro-centro, centro-esquerda e centro-direita. Somente os temas mais novos implementam corretamente as opções inferiores. Certifique-se de que seu tema mostra corretamente as opções inferiores. 57 Exemplo de site tipo padrão comercial com menus e blocos à esquerda. Bloco Esquerda Cabeçalho Módulo Bloco inferior central Rodapé Bloco Direita Cabeçalho Módulo Exemplo de site tipo blog, com links e menus na área da direita. Rodapé Cabeçalho & Menu Principal Exemplo de site sem laterais, valorizando o centro (módulo). Nesse tipo de site não há o menu principal. O tema deve ter todos os links do menu principal já gravados. Módulo Bloco inferior central Rodapé Bloco Esquerda Cabeçalho Módulo Exemplo de site com lateral esquerda em destaque. Bloco inferior central 58 Os blocos podem ser gerados tanto pelo Xoops (menu principal, busca)quanto por módulos (tipo mini-calendário, votação). Selecione aqui que blocos deseja ver para configurar. Alguns blocos podem não ser visualizados por determinados tipos de usuários do site. Por exemplo: As votações podem não estar disponíveis para os visitantes. Nessa caixa é possível ver que blocos estão ligados para que tipo de usuário. Mostra a configuração dos blocos de acordo com a página. Ex: Para ver que blocos estão ligados na página de notícias, selecione notícias aqui. Bloco Personalizado Filtro de visualização para mostrar somente os blocos visíveis ou não. Facilita para se ter certeza de quais blocos estão realmente ligados. Configurações sobre a posição do bloco Título do bloco Gerenciado de imagens do Xoops Link imagem Smiles (sorrisos) Link e-mail Flash Vídeos YouTube Incluir link O editor de textos padrão do Xoops não é WYSIWYG (O que você vé é o que você tem); quer dizer, você não irá ver os textos em negrito, ou com outra fonte, ou não verá uma imagem anexada. Ao invés, você verá códigos que indicam a formatação do texto criado. Para visualizar como ficará seu bloco, clique em Exibir. 59 Ao criar seu bloco personalizado, marque corretamente a caixatipo de conteúdo para que a visualização do conteúdo ocorra corretamente. Ex: Se você incluiu imagens, links e formatação de texto através dos botões do formulário, seu conteúdo é do tipo Script PHP. Mas se você prefere digitar os códigos HTML diretamente, e fazer toda a formatação na mão (ou utilizando um programa editor de HTML como o Dreamweaver), marque que seu conteúdo é HTML. As opções Com Emoticons e Sem Emoticons são sub-opções do tipo Script PHP. A diferença é que na Com emoticons, textos como este :) serão substituidos por imagens smiles como esta . 60 Grupos Nosso site em Xoops classifica os usuários do site em diferentes grupos. Isto facilita quando precisamos ter diferentes dados para diferentes grupos. É nessa área que definimos, por exemplo, que os visitantes de nosso site não podem ter acesso a certas áreas e módulos, e que somente usuários cadastrados poderao ver o link do fórum de discussão, ou participar de algum evento no calendário. Por padrão, o Xoops tem 3 tipos de usuário: wAdministrador: É o usuário máximo do site. Tem acesso à área administrativa, e pode alterar qualquer configuração do Xoops. Não é recomendado dar privilégios de administrador para outros usuários, principalmente se eles não tiverem necessidades administrativas. wUsuário: O Xoops considera usuário todo aquele que tem senha de acesso ao Xoops, mas não pode entrar na área administrativa. wVisitante: É a pessoa que não entrou com nenhuma senha para acessar o site, e só tem acesso às informações que estão liberadas a todos. Para criar um novo grupo de usuários, por exemplo o grupo de editores (podem enviar notícias e artigos, mas não podem entrar no painel de administração do site), basta preencher o nome e a descrição do grupo, e marcar as devidas permissões de acesso para o sistema, para a administração dos módulos, para acesso dos módulos e para o acesso aos blocos. Para editar um grupo de usuários, fazendo com que esse grupo tenha ou não acesso à alguma área do site, clique em editar no link ao lado do grupo e marque (ou desmarque) as áreas que deseja alterar o acesso do grupo. 61 Imagens O gerenciador de imagens do Xoops permite que se crie um organizado catálogo de imagens usadas no site, além de permitir o envio fácil de imagens sem a necessidade de programas de FTP (transferência de arquivo). O primeiro passo antes de enviar imagens para o site é criar categorias de imagens. Dessa forma se pode organizar melhor as imagens armazenadas. wPara criar uma categoria, preencha os dados em Incluir categoria de Imagens. wNome da categoria (ex. Imagens pequenas para notícias) wGrupos que podem usar o gerenciador de imagens: Selecione quais grupos podem ter acesso à biblioteca de imagens do Xoops. wGrupos que podem enviar imagens: Selecione os grupos que podem fazer uploads de novas imagens para a biblioteca do Xoops. wTamanho máximo: O valor padrão é 50000 bytes, ou 50Kb, o que é um valor bem pequeno (comparável a de um ícone). Dependendo da necessidade da categoria, altere o valor para algo maior. Para álbum de fotos, um valor bom é de 400000 (400 Kbytes). wLargura e altura máxima: Limita o tamanho em pixels da imagem. Esse limite é interessante porque se um usuário tentar incluir uma foto em uma notícia, por exemplo, e a foto for grande demais, o site irá ‘estourar’ para os lados, desconfigurando todo o visual. wOrdem: a ordem de visualização do álbum. Se colocar 1, será o primeiro álbum mostrado. wExibir categoria: Coloque sim para que a categoria apareça no gerenciador de imagens. wSalvar imagens com: O padrão é salvar os arquivos na pasta /uploads, mas é possível salvar as imagens no banco de dados também, porém não é recomendado. Recomenda-se a criação de categorias Imagens Pequenas (com limites no tamanho e na largura e altura), imagens grandes (com limites maiores), ou então a separação das imagens por função: imagens de notícias, etc. 62 Módulos Os módulos são as funcionalidades extras de seu site Xoops que podem ser incluidas, desabilitadas e excluidas facilmente, através dessa área administrativa. Ao acessar pela primeira vez, o único módulo ativo é o próprio sistema. Abaixo da lista de módulos instalados, você verá a lista de módulos aguardando instalação. Na listagem de módulos instalados, temos: wMódulo: Pode-se alterar o nome do módulo (que é exibido, por exemplo, no menu: podemos mudar o módulo notícias para novidades). wVersão: Versão do módulo. Útil caso necessitemos de uma versão mais nova de um módulo. wÚltima atualização. wAtivado: Marque para fazer com que o módulo fique funcionando. Para desinstalar um módulo, antes você deve desativá-lo. wOrdem: A ordem de exibição dos módulos no menu principal. Assinale cada módulo com um número definindo quem aparece primeiro. wAção: Botões de ação, onde se pode ver informações do módulo, reinstalar (atualizar) um módulo ou desinstalar o módulo (ícone só aparece quando o módulo esta desativado). 63 Instalando novos módulos Nos repositórios do Xoops é possível encontrar centenas de módulos para as mais diversas funções. Para instalar novos módulos, primeiro baixe o módulo da internet. Vários endereços podem ser pesquisados para se encontrar o módulo desejado, como www.xoops.org (em inglês), www.xoops.pr.gov.br e www.xoopsbr.org, porém um ótimo repositório de módulos já em português é o www.x-trad.org. Após descompactar o arquivo, identifique a pasta principal do módulo. Em geral, o arquivo descompactado já gera a pasta principal, mas é importante que saibamos identificar essa pasta. Estrutura de pastas do módulo Liaise (formulários) destacando o arquivo xoops_version.php As pastas dos módulos contém obrigatoriamente o arquivo xoops_version.php, e dentro delas também encontraremos pastas comuns, como /sql, /admin e /language. Para poder instalar o novo módulo, devemos colocar a pasta principal do módulo na pasta /modules da nossa instalação do Xoops. Copie os arquivos via FTP caso o site esteja na internet, ou diretamente na pasta caso seja um servidor local (windows ou linux). 64 Após enviar o módulo para a pasta /modules, acesse a área administrativa do Xoops e o ícone módulos. Você verá, abaixo da lista dos módulos já instalados, a lista de módulos que podem ser instalados. Para instalar o módulo, basta clicar no ícone do disquete cinza, ao lado da logo do módulo que você quer instalar. Após uma tela de instalação rápida, seu módulo estará pronto para ser configurado e usado. Para ter certeza de que seu módulo está em português, verifique dentro da pasta /language se existe a pasta /portuguesebr. 65 Emoticons ou Smilles Os emoticons ou smilles são ícones representativos das emoções dos usuários do site. São uma ferramenta muito comum na internet, já que há uma necessidade de exprimir sentimentos e humor nos textos postados. A área de emoticons permite que se cadastre novos emoticons, bem como se edite e apague os que já são padrão no sistema. Gerenciamento das posições dos usuários Os sites em Xoops podem ter um sistema de ranking de usuários. Esse ranking cataloga todas as participações do iusuário, e baseado nesses dados dá uma classificação ao cadastrado, que vai de Just Poping it (só dando uma passada) até Webmaster (usuário master). Estas classificações não foram traduzidas e precisam ser editadas para o português aintes de serem usadas. Editar usuário Área do site onde é possível incluir, editar e excluir usuários do nosso site em Xoops. É nessa tela também que podemos aumentar a categoria de um usuário, mudando-o de grupo e dando-lhe poderes de administrador. Procurar usuários Trata-se de um grande formulário com diversas possibilidades de busca de usuários do site. Muito útil para quem tem uma base de dados de usuário bem grande. Contatar usuários Ferramenta de criação de mensagens (e-mail ou mensagem privada) a serem enviadas diretamente do site. Útil quando se quer mandar mensagens em massa para todos os usuários cadastrados no site. Para que esta funcionalidade funcione corretamente, é necessário que a área preferências >> configuração de e-mail estejam configuradas corretamente. 66 Modelos ou Templates Um template ou modelo é como um modelo do Word, uma página pré-pronta para ser usada. Um dos maiores problemas na programação PHP é conseguir manter claro o código que está sendo programado, pois a grande quantidade de sinais de maior e menor acaba misturando tudo e tornando quase impossível qualquer um de ler uma página PHP. Os modelos ou modelos servem para separar o código PHP do código HTML, ou seja, permitem que façamos os programas PHP de forma organizada sem misturá-lo com o HTML. Uma das deficiências do XOOPS até a versão 2.0 era a dificuldade de modificar o layout de blocos e módulos, pois prá isso era preciso abrir arquivos PHP quase que indecifráveis. Após a implementação do Smarty isso ficou muito mais fácil, agora podemos usar o mesmo módulo com layouts completamente diferentes sem a necessidade de abrir nenhum arquivo PHP. Além disso o pessoal do XOOPS montou um “Gerenciador de Conjunto de Modelos” ou “Template Set Manager”, com este recurso, podemos criar diversos conjuntos de modelos para um mesmo site ou então para temas diferentes. Resumindo, um modelo é um código HTML que contém algumas variáveis Smarty que serão substituidas pelos dados do site quando o visitante ver a página. Alterando os modelos, podemos dar uma boa personalizada em nosso site Xoops. Atenção: O modelo default do xoops (que vem com a instalação) não pode ser alterado. Para personalizar os modelos, temos que primeiro clonar o modelo default. Para isso, clique em clonar e escolha o novo nome do modelo: 67 Após a clonagem, vá em Preferências >> Configurações Gerais >> Conjunto de modelos (templates) e marque lá o modelo recém clonado para ser o padrão. Só assim é que as alterações feitas nos modelos aparecerão no site. Vamos fazer um exemplo de personalização via modelo para mudar o bloco pesquisa. O bloco pesquisa faz parte do sistema principal do Xoops, então encotraremos ele clicando em listar ao lado de sistema. Modelo default (não permite atualização) Modelo clonado por nós (pode ser alterado) Na listagem que aparece, devemos procurar o template que queremos alterar. No caso é o system_block_search.html. Nessa tela, vemos que podemos editar o arquivo diretamente do site, excluir o arquivo, fazer o download do arquivo (útil caso você queira personalizar o template em um programa editor de HTML) e o botão de fazer upload de arquivo (caso você já tenha personalizado o modelo no seu computador e queira colocar ele agora no seu site). Ao abrir o modelo em questão, iremos ver o seguinte código HTML: 68 69 Variável Smarty que define o que deve ser escrito dentro do botão de pesquisa Variável Smarty que define o que deve ser escrito no link de pesquisa avançada Olhando o HTML podemos ver também que poderiamos mudar a exibição do bloco, por exemplo, alterando o tamanho da caixa de busca. Para isso bastaria mudar o número size=”14” que aparece na linha 2. Podemos sim substituir algumas tags por textos fixos, como subsituir a tag <{$block.lang_search}> pelas palavras “iniciar busca”, por exemplo. Mas ao fazer isso, também saberemos que o preenchimento automático do texto não vai, por exemplo, corresponder mais à lingua do Xoops: Se mudarmos o idioma do Xoops para inglês, o botão não ficará em inglês. Analisando o código, vemos que não é nada mais nada menos que um código HTML simples, que ao invés de ter textos (definindo por exemplo o que vai escrito no botão de pesquisa) têm tags smarty, que são identificadas pelo padrão <{$uma_tag_aqui}>. Variável Smarty que mostra o caminho do site Xoops <div class="center"><form style="margin-top: 0px;" action="<{$xoops_url}>/search.php" method="get"> <input type="text" name="query" size="14" /> <input type="hidden" name="action" value="results" /> <br /> <input class="xo-formbuttons" type="submit" value="<{$block.lang_search}>" /> </form><br /> <a href="<{$xoops_url}>/search.php"><{$block.lang_advsearch}></a></div> Define um formulário tipo get que joga os resultados para a página search.php Define que é centralizado Esta página está propositalmente impressa de lado para facilitar ver os códigos Para os que não estão habituados a mexer no HTML na marra, a melhor dica mesmo é fazer o download do modelo e abrir o arquivo no seu editor de HTML favorito, como o Dreamweaver. Dessa forma você conseguirá ver uma simulação de como o bloco irá exibir as informações, e fazer as personalizações mais facilmente no editor HTML. Lembrando que os modelos não são somente para os blocos. Navegando pela lista de modelos, veremos que cada módulo tem uma dezena de modelos, todos com alguma especificidade. Lembre-se que a alteração de modelos depende de um bom conhecimento de HTML. E caso você tenha alterado o modelo de forma tal que ele não está mais funcionando, e precisa recuperar o modelo original, use os modelos default, que como não sofrem alterações, sempre estarão lá intactos para serem usados novamente. Comentários O último ponto da área administrativa a ser comentádo é a área de comentários. Nessa página você verá todos os comentários feitos em todas as áreas do site. Será possivel verificar, alterar e apagar comentários, bem como bloquear e liberar eles (caso os comentários necessitem aprovação, será nessa página que você deve desbloquear os comentários um a um). 70 PERSONALIZANDO O XOOPS O primeiro passo para personalizar seu Xoops é baixar temas. Pesquise nos sites de suporte do Xoops por temas para serem baixados. Um tema é uma pasta contendo pelo menos o arquivo theme.html e o style.css, que são os arquivos que definem todo o design do site Xoops. Ao baixar temas, coloque-os na pasta /themes de seu site, via FTP ou copiando os arquivos para a pasta. Para escolher mais facilmente entre os temas baixados aquele que mais lhe agrada, você pode temporariamente ligar o bloco temas para poder tocar rapidamente de tema. Lembre-se de ir também na área administrativa >> preferências >> configurações gerais, e na opção temas selecionáveis, marcar todos os temas que quer testar. Após escolher um tema que já lhe agrade bastante, voce poderá mudá-lo com o auxílio de um programa editor de HTML, fazendo com que ele fique ainda mais personalizado. Para isso edite os arquivos theme.html e o style.css, e a cada alteração, envie novamente os arquivos para o site e veja as mudanças. Também verifique a pasta /images ou as imagens presentes dentro da pasta do tema. Alterando as imagens (por exemplo, substituindo a logomarca que veio com o tema com a sua logo) você rapidamente terá um site personalizado. Personalizar o site requer muito conhecimento de HTML. As possibilidades são diretamente proporcionais aos conhecimentos em trabalhar com HTML. Lembre-se somente que o tema também trabalha com variáveis smarty (veja sobre elas em modelos), e que elas não devem ser alteradas. 71 CONCLUSÃO O Xoops é ao meu ver uma das melhores ferramentas de gerenciamento de site, ideal para aqueles que precisam de um site funcional, modular e de fácil implementação. Este curso e material inicialmente são focados em atender às necessidades de pequenos grupos organizados, ONGs, associações de bairros, para que estes possam ter seu espaço na internet de forma prática e barata. Obviamente espero que este material ajude também outras pessoas interessadas em estudar o Xoops, e, de tabela, espero que possamos fortalecer mais a comunidade brasileira, que vira e mexe passar por alguns percalços para continuar crescendo. A luta pelo direito à comunicação e a comunicação popular digital precisam de comunidades como a do Xoops e do Software Livre. São essas comunidades e suas soluções que geram os instrumentos perfeitos para a real inclusão digital. Porque inclusão digital não é dar computadores aos que não tem, e sim dar voz e alcançe através dos computadores aos que precisam. 72 AGRADECIMENTOS A realização desse curso não seria possível sem o apoio da Associação Comunitária do Bairro Ellery, representados pelos companheiros Aguinaldo Aguiar e Clarice. Sem eles esse mundo tava perdido! Agradecemos também à Prefeitura de Fortaleza, que com os recursos e apoio do Edital de Artes 2007 - Mídias Digitais, proporcionou a execução desse projeto. Por fim dedico esse manual à minha família e a minha noiva Maxmiria Holanda, que teve tanta paciência de me aturar mergulhado em trabalho! Caca, te adoro! Daniel Almeida Chagas Novembro de 2008 Esta apostila é parte integrante do curso Criação de Sites em Software Livre para Bairros, projeto premiado no Edital das Artes 2007 da Fundação de Cultura Esporte e Turismo FUNCET da Prefeitura de Fortaleza. Daniel Almeida Chagas, organizador do curso, natural de Fortaleza-CE, é administrador e consultor de tecnologia, tendo já criado vários sites de âmbito público e privado, sendo a grande maioria deles com ferramentas de software livre Xoops. A Associação Comunitária do Bairro Ellery, entidade parceira no projeto, tem seu sítio eletrônico www.bairroellery.com.br totalmente criado em Xoops, e visa repassar a ótima experiência em software livre para outras comunidades e grupos que necessitem de um site. Esta apostila tem seus direitos garantidos pela licença Creative Commons do tipo Atribuição - Uso não-comercial. Maiores detalhes em www.creativecommons.org ou na página 4 desta apostila. Você pode copiar e distribuir este material desde que seja dado o devido crédito ao autor e que a finalidade seja não-comercial.