Portugus do Brasil

e ar ftw re So Liv

m * te e en rg m .o ta s ui op at o gr w.x xe w ai w

Guia de Instalao e Uso

Crie sites dinmicos e modulares. XOOPS um Sistema de Gerenciamento de Contedo (SGC), poderoso, modular e de rpida assimilao na administrao de sites. Possibilita a criao de sites dinmicos, sendo ideal para projetos em pequena e grande escala de portais, comunidades virtuais, sites de notcias, intranets ou weblogs. Possui uma biblioteca de mdulos, incluindo notcias, foruns, enquetes, classificados, gerenciamento de informaes e at ecommerce, dentre outros.

Verso 2.3
RELEASE OUT/2008

Daniel Almeida Chagas

EXtended Object Oriented Portal System

GUIA DE INSTALAO E USO

Verso 2.3
RELEASE OUT/2008

Daniel Almeida Chagas

Notas de verso do software: Esta apostila enfocada na verso 2.3 ptbr, lanada em Outubro de 2008. Contudo, os ensinamentos dados nesse material so em geral compatveis com verses do Xoops diferentes, ficando a critrio do usurio usar outras verses baixadas em outros sites. Para maiores informaes sobre o Xoops Core original, acesse www.xoops.org. Para verses j portadas para o portugus do Brasil, procure em www.xoopsbr.com.br ou em outros sites de suporte xoops em portugus. Esta apostila usa uma metodologia passo-a-passo para ensinar a operao e instalao do sistema Xoops. Para que o acompanhamento do texto seja perfeito, interessante que o leitor esteja seguindo as lies operando um computador com o sistema, fixando assim o contedo 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 no 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 preferncia ao uso de softwares livres, ento boa parte das instrues ser dada como se o usurio estivesse utilizando o Linux como sistema operacional. Porm instrues para Windows XP estaro juntas. O linux utilizado o OpenSUSE 11.

04

Atribuio-Uso No-Comercial 3.0 Unported Este documento distribuido atravs da licena Creative Commons Atribuio (by nc). De acordo com esta licena o autor permite uma utilizao ampla da sua obra, limitada, contudo, pela impossibilidade de se obter atravs dessa utilizao uma vantagem comercial. tambm essencial que seja dado o devido crdito ao autor da obra original. Voc pode: copiar, distribuir, exibir e executar a obra criar obras derivadas Sob as seguintes condies: Atribuio. Voc deve dar crdito ao autor original, da forma especificada pelo autor ou licenciante. Uso No-Comercial. Voc no pode utilizar esta obra com finalidades comerciais. Para cada novo uso ou distribuio, voc deve deixar claro para outros os termos da licena desta obra. w Qualquer uma destas condies podem ser renunciadas, desde que Voc obtenha permisso do autor. w Nada nessa licena implica ou restringe os direitos morais do autor.
w

Este um sumrio para leigos da Licena Jurdica, que se encontra na ntegra em: http://creativecommons.org/licenses/by-nc/3.0/legalcode
05

NDICE
Prefcio Introduo Porque eu preciso de um CMS Software Livre e Licena GPL Hospedagem Criando um endereo endreo internacional tecnologias de site espao e transferncia 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 Preferncias - Config. Gerais Preferncias - Config. Usurios Preferncias - Meta dados e Rodape Preferncias - Palavras censuradas Preferncias - Opes de Pesquisa Preferncias - Configurao de e-mail Banners Blocos Grupos Imagens Mdulos Emoticons Posies de usurios Editar usurios Procurar usurios Contactar usurios Modelos ou templates Comentrios Personalizando o Xoops Concluso Agradecimentos 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

06

PREFCIO
O Xoops um gerenciador de contedo dinmico de cdigo livre, escrito em PHP. Ele permite que administradores de sites possam facilmente criar websites dinmicos com um bom contedo e muitas funcionalidades, com o mnimo de programao. O Xoops perfeito para criar pequenos e grandes sites institucionais, sites de comunidades e intranets. Ele tambm tem uma comunidade entusiasmada e receptiva.

CONHECIMENTOS BSICOS
Para usar esta apostila e poder entender e desfrutar de todas as caractersticas do Xoops, o leitor precisa ter conhecimentos no mnimo bsicos em: Operao de computador (Conceito e manipulao de arquivos) Internet (fundamentos, navegao) HTML (Hyper Text Makeup Language) CSS (Cascade Style Sheet) Editor de HTML (Notepad, Dreamweaver, etc.) FTP (File Transfer Protocol) Caso no 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

INTRODUO
XOOPS um poderoso, flexvel e fcil de usar Sistema de Gerenciamento de Contedo, mais conhecido pelo acrnimo ingls CMS - Content Management System. Quando instalado em um servidor web com PHP e o banco de dados MySQL, o sistema possibilita a criao e administrao de stios totalmente dinmicos, revelando-se uma ferramenta excelente para a construo dos mais variados tipos de portais, e contando ainda com diversos recursos modulares, como administrao de associados, troca simples de lay-out, alm da insero e administrao visual de contedos. Todas estas aes so efetuadas atravs de uma interface web simples e funcional, deixando aos administradores, praticamente s a tarefa de gerenciar o contedo do stio. A palavra XOOPS (pronuncia-se "zups") um acrnimo de "eXtensible Object Oriented Portal System". O XOOPS foi concebido sob os termos da GNU - General Public License - GPL (Licensa Pblica Geral), o que significa que voc pode us-lo e modific-lo livremente, desde de que de acordo com os termos da referida licena. Depois de instalado, um website em XOOPS pode ser gerenciado sem a necessidade de ferramentas externas ou conhecimentos avanados 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 Contedo, capaz de estruturar stios pequenos, mdios ou grandes.

O site oficial do projeto www.xoops.org

08

PORQUE EU PRECISO DE UM CMS?

Um CMS (ou Sistema Gerenciador de Contedo) a soluo ideal para algum que precise criar ou administrar um website e seu contedo de forma rpida e inteligente, sem precisar entender ou programar complicadas rotinas web. muito comum se ver sites todos feitos em HTML. Para sites pequenos e com contedo que no muda com tanta frequncia, o HTML resolve. Vejamos como um webmaster adiministra e atualiza um site HTML: - Para alterar um texto de uma pgina, necessrio baixar o arquivo para o computador (geralmente via FTP), e, com a ajuda de um editor (tipo o Dreamweaver) o usurio altera o necessrio. Aps salvar, necessrio subir (upload) o arquivo novamente para o servidor. - Para criar-se uma nova pgina, o usurio usa um editor (tipo Dreamweaver) e cria a nova pgina. Aps fazer o upload do arquivo para o servidor, ser necessrio alterar outras pginas do site para criar os links (ligaes) para aquela nova pgina (seno os visitantes do site nunca acharo a nova pgina). - Caso se queira incluir uma pgina que deva aparecer em todas as pginas do site, o webmaster deve alterar todas as pginas do site uma a uma. Vimos que pequenas alteraes podem ser bastante trabalhosas quando temos um site todo baseado em HTML. Ao longo da evoluo do HTML, vrias solues para diminuir esse trabalho apareceram, mas nenhuma soluo mais prtica do que se ter um site dinmico, baseado em programao.

Lembrando que sites em Flash sofrem do mesmo mal. O Flash tem um ambiente prprio de programao (Actionscript) mas este no trabalha com acesso a banco de dados diretamente. Isto quer dizer que o Flash mais avanado que o HTML, proporcionando a criao de sites mais bonitos, e at a criao de jogos, mas no fcil implementar um site dinmico, onde se possa alterar os contedos rapidamente.
09

HOMEPAGE

Exemplo de uma estrutura de um site em HTML. Todas as pginas tem uma ligao bem definida, mas difcil de se administrar. Se o webmaster preciar alterar um link do menu (que aparece em todas as pginas), a alterao ser muito mais trabalhosa.

ESTRUTURA DE SITES DINMICOS

A forma de funcionamento de um site dinmico bem diferente! Basicamente podemos dizer que as pginas so construidas no momento em que so requisitadas. Vejamos o desenho antes de explicar:

BASE DE DADOS

MENU

CABEALHO

RODAP

CORES

FONTES

IMAGENS

TEXTOS

INDEX 10

Veja que na nossa ilustrao de um site dinmico, h uma pgina para cada elemento da nossa pgina: Menu, cabealho, rodap, etc. As pginas visitadas em nossos websites so criadas dinamicamente, baseadas nessas outras pginas elementares. Dessa forma, quando eu preciso fazer uma alterao no meu menu principal, basta eu alterar a pgina que constroe meu menu e todas as outras pginas do site estaro alteradas. Outra grande diferena que no temos pginas para falar dos textos do site. Em um site HTML, teramos as pginas quemsomos.htm, missao.htm, produtos.htm. Em um site dinmico, o que temos so as informaes dessas pginas gravadas em um Banco de Dados. As informaes no banco de dados podem ser incluidas, alteradas e excluidas muito facilmente, e as informaes podem ser combinadas e reutilizadas em mais de uma pgina. Ex: O endereo da empresa pode aparecer na sesso A Empresa e em Contato. Se alterarmos o endereo da empresa, basta fazer uma vez para ele aparecer corretamente nas duas sesses. O ltimo detalhe de nossa ilustrao que as pginas dos elementos do site tambm esto ligadas ao banco de dados, porque o banco de dados tambm pode gravar informaes de como o menu e formado, etc. Isso tambm facilita a alterao de todos os elementos do site.

Nossas pginas em um site dinmico so como uma colcha de retalhos que costurada toda vez que um visitante requisita uma pgina. O servidor PHP pega os textos do banco de dados, as pginas que definem os menus, cabealhos e rodaps, junta tudo e transforma numa pgina na tela do computador do visitante.
Outra grande vantagem que esse ato de juntar as informaes pode ser feito de tal maneira que podemos criar funcionalidas para o site, do tipo: Agendas, Classificados, Comentrios, Galerias, etc. Tudo funcionando de forma automtica e de fcil configurao. Esses so os mdulos de trabalho.

11

SOFTWARE LIVRE E LICENCA GPL

O XOOPS foi concebido sob os termos da GNU - General Public License - GPL (Licensa Pblica Geral), que a designao da licena para software livre idealizada por Richard Stallman no final da dcada de 1980, no mbito do projecto GNU da Free Software Foundation (FSF). A GPL a licena com maior utilizao por parte de projectos de software livre, em grande parte devido sua adoo para o Linux. O software utilizado para administrar o contedo da Wikipdia coberto por esta licena, na sua verso 2.0 ou superiores. Em termos gerais, a GPL baseia-se em 4 liberdades: 1. A liberdade de executar o programa, para qualquer propsito (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 cdigofonte um pr-requisito para esta liberdade. 3. A liberdade de redistribuir cpias de modo que voc possa ajudar ao seu prximo (liberdade n 2). 4. A liberdade de aperfeioar o programa, e liberar os seus aperfeioamentos, de modo que toda a comunidade se beneficie deles (liberdade n 3). O acesso ao cdigo-fonte um pr-requisito para esta liberdade. Com a garantia destas liberdades, a GPL permite que os programas sejam distribudos e reaproveitados, mantendo, porm, os direitos do autor por forma a no permitir que essa informao seja usada de uma maneira que limite as liberdades originais. A licena no permite, por exemplo, que o cdigo seja apoderado por outra pessoa, ou que sejam impostos sobre ele restries que impeam que seja distribudo da mesma maneira que foi adquirido.

Por conta da licena GPL, qualquer pessoa pode ter acesso ao Xoops e a seus cdigos. Ento quando se est vendendo um site em Xoops, o que est se cobrando no o software, e sim a instalao e a configurao.
12

HOSPEDAGEM - CONCEITOS
Vamos agora entender como funciona um site, sua estrutura e sua colocao no ar. Se voc j domina esses conhecimentos, pode passar para o captulo segunte, mas sempre recomendado fazer uma pequena reviso sobre o assunto! Para ter uma pgina na internet, voc vai precisar basicamente de 2 elementos: Um endereo e uma hospedagem. Apesar de algumas empresas fornecerem o servio em conjunto, devemos ter noo de que so duas coisas distintas, e que tm formas de pagamento distintas tambm. Um endereo de internet o nosso famoso algumacoisa.com.br ou algumacoisa.com . O endereo liga nossos visitantes nossa hospedagem.

O ENDEREO FAZ O LINK ENTRE O VISITANTE E A HOSPEDAGEM VISITANTE DIGITA NOSSO ENDEREO A HOSPEDAGEM TRANSMITE AS INFORMAES PARA O VISITANTE

Hospedar uma pgina basicamente deixar os arquivos de uma pgina da internet em um computador permanentemente ligado Internet. Tecnicamente qualquer computador pessoal poderia fazer esse servio, mas como no possumos computadores potentes o suficiente e nem conexes de internet rpidas e dedicadas para aguentar todos os acessos a nossas pginas, o ideal alugar um espao no computador de uma empresa de hospedagem.
13

Entendendo esses conceitos, podemos ver a diferena dos servios e entender que essa estrutura vem a facilitar a administrao de sites. Por exemplo, podemos mudar de empresa de hospedagem sem precisar mudar nosso endereo .com:

HOSPEDAGEM ANTIGA VISITANTE ALGUMACOISA.COM

HOSPEDAGEM NOVA

Entendendo a estrutura tambm vemos que podemos ter mais de um endereo apontando para o mesmo site. Dessa forma, podemos garantir que o cliente ache nosso site mesmo sem saber exatamente qual nosso endereo.

ALGUMACOISA.COM

VISITANTE

HOSPEDAGEM

COISAALGUMA.COM

CRIANDO UM ENDEREO
A criao de endereos de responsabilidade de entidades em geral ligadas ao governo do pas. No Brasil, o CGI - Comit Gestor de Internet o responsvel por coordenar e integrar todas as iniciativas de servios Internet no pas, promovendo a qualidade tcnica, a inovao e a disseminao dos servios ofertados.

14

Para a criao de um endereo .br precisamos acessar o site www.registro.br . Desde 1995, o Registro.br o executor de algumas das atribuies do Comit Gestor da Internet no Brasil, entre as quais as atividades de registro de nomes de domnio, a administrao e a publicao do DNS para o domnio .br . O registro de um endereo feito por pagamento anual (R$ 30 em 2007) e tecnicamente bem fcil de ser realizado, bastando que o interessado crie um login e senha de acesso para o site www.registro.br . Lembrando que no existe somente o famoso .com.br como opo de registro. Como em geral a disputa por um endereo pode ser grande, o CGI criou vrias opes para a criao de endereos, muitas delas ainda desconhecidas. Seno vejamos: Domnios para Pessoas Jurdicas (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 Empresas agrcolas, fazendas Empresas de radiodifuso sonora Artes: msica, pintura, folclore Entidades de ensino superior Comrcio em geral Cooperativas Esporte em geral Farmcias e drogarias Empresas de radiodifuso sonora Entidades de ensino de primeiro e segundo grau Entidades do governo federal Imobilirias Industrias Meios de informao (rdios, jornais, bibliotecas, etc..) Foras Armadas Brasileiras Detentores de autorizao para os servios de Comunicao Multimdia (SCM), Rede e Circuito Especializado (SLE) da Anatel e/ou detentores de Sistema Autnomo conectado a Internet conforme o RFC1930 Entidades no governamentais sem fins lucrativos Provedores de servio Internet Atividades de entretenimento, diverso, jogos, etc... Empresas prestadoras de servios Eventos temporrios, como feiras e exposies Entidades da rea de turismo Empresas de radiodifuso de sons e imagens Entidades que no se enquadram nas outras categorias 15

ORG.BR PSI.BR REC.BR SRV.BR TMP.BR TUR.BR TV.BR ETC.BR

Domnios 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 Bilogos Biomdicos Corretores Cengrafos Contadores Economistas Engenheiros Especialista em Tecnologia da Informao Fonoaudilogos Fotgrafos Fisioterapeutas Gegrafos Jornalistas Leiloeiros Matemticos e Estatsticos Mdicos Msicos Notrios Nutricionistas Dentistas Publicitrios e profissionais da rea de propaganda e marketing Professores Psiclogos Rdio amadores Socilogos Tradutores Veterinrios Zologos

Domnios para Pessoa Fsica (Necessita CPF)

BLOG.BR FLOG.BR NOM.BR VLOG.BR WIKI.BR Web logs Foto logs Pessoas Fsicas Vdeo logs Pginas do tipo 'wiki'

16

A escolha de um bom endereo pea chave para uma boa presena na internet. Quanto mais curto e fcil de lembrar e comunicar, melhor. Obviamente a opo mais perfeita para uma emrpesa, por exemplo, seria criar algo do tipo [nomedaempresa].com.br , mas por conta da concorrncia por nomes esta opo nem sempre est acessvel. Quando este for o caso, algumas dicas podem ajudar: Tente procourar outra opo ao .com.br: Se o tipo de sua empresa est listado nos outros domnios disponveis, esta uma otima opo. Uma empresa de esportes chamada Gol de Letra pode ter um endereo www.goldeletra.esp.br . Tente incluir um outro nome ao nome da sua empresa: Se o dono da Pousada Vero no conseguiu o endereo 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 endereo www.pousadaverao.com.br j estiver ocupado, outra opo seria algo como www.pousada-verao.com.br (com hfen) ou www.pousada_verao.com.br (com underline ou sublinhado). No possvel ter espaos no endereo. Para saber se seu nome fcil, 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) no so boas opes. Caso no consiga endereos nacionais (.br) tente os internacionais: Ao invs de www.verao.com.br, tente www.verao.com. Essa opo as vezes ainda mais indicada, j que o endereo .com ainda mais curto e rpido de se pronunciar. Porm a concorrncia para um endereo .com ainda maior, ento se seu nome no for bem exclusivo, poder ser difcil achar uma boa opo.
17

CRIANDO UM ENDEREO INTERNACIONAL

Um endereo considerado internacional quando no tem o componente que indique o pas (.br, .pt, .es, .jp, etc.). As opes so poucas, e a concorrncia grande, mas se seu nome for exclusivo (ou se voc der sorte) poder ter um endereo bem curto e fcil de ser lembrado. O registro de endereos internacionais fica a cargo da Internic (www.internic.com), entidade ligada ao departamento de comrcio dos Estados Unidos. Porm o registro e pagamento diretamente a Internic pode ser complicado (por conta do idioma e da necessidade de carto de crdito internacional), ento recomendamos que se procurem empresa brasileiras que intermediem esse contato.

Sugesto para registros .com: acesse www.100br.com

Tecnicamente o registro de endereos .com mais rpido e at menos burocrtico que endereos brasileiros, dado a no necessidade de CPF o CNPJ. Porm as opes de endereo so poucas: .Com .Net .Org .Info .Biz .Cc .Tv .Nu .Ws Empresas Empresas de internet Organizaes De informaes Contrao de Business (negcios) Sigla de Credit Card (Carto de Crdito) Televiso ? ?

Aps a criao e o pagamento do endereo (seja nacional ou internacional), o mesmo entra em funcionamento entre 24 e 48 horas depois. Este o tempo que leva para que a informao do novo endereo seja recebida por todos os principais servidores do mundo, fazendo com que o endereo esteja disponvel para qualquer visitante de qualquer pas.
18

TECNOLOGIAS DE SITE
Por tecnologia de site entende-se qual a linguagem de programao 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 benefcio. Sobre tecnologia de sites, vejamos as mais comuns: Sites HTML: o tipo mais simples de site. No tem programao, e basicamente o site um conjunto de pginas simples com links entre si. No permite edio das pginas via internet, nem criao de formulrios de contato*, nem interatividade com o usurio. Para hospedagens, os planos HTML so sempre os mais baratos. Sites Flash: Os sites em flash tm programao embutida, mas esta simples e no precisa de maiores gastos com hospedagem (uma hospedagem HTML suficiente para um site em Flash). No permite edio das pginas via internet, nem criao de formulrios de contato*, mas permite alguma interao mais avanada com os visitantes. Sites PHP: PHP uma linguagem de programao livre muito usada para gerar contedo dinmico na Web. Apesar de ser de fcil aprendizagem, o PHP uma linguagem poderosa orientada a objetos. As hospedagens PHP so tambm baratas, perdendo apenas para as hospedagens HTML. Sites ASP: (de Active Server Pages) uma estrutura de programao em Script que se utiliza de VBScript, JScript, PerlScript ou Python processadas pelo lado servidor para gerao de contedo dinmico 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 aplicaes 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 bsicas com formulrios.

19

Sites AJAX: (Asynchronous Javascript And XML) o uso sistemtico de tecnologias providas por navegadores, como Javascript e XML, para tornar pginas mais interativas com o usurio. AJAX no uma tecnologia, so realmente vrias tecnologias trabalhando juntas. O valor da hospedagem vai depender de quais tecnologias sero usadas. Sites Ruby On Rails: Trata-se de um framework de cdigo aberto para desenvolvimento de aplicaes Web, escrito em Ruby, extremamente produtivo e com baixa curva de aprendizagem. Hospedagens no Brasil ainda so raras e com preos semelhantes ao ASP. Sites Coldfusion: CFML ou ColdFusion Markup Language uma linguagem baseada em tags que, por ser similar linguagem HTML (tambm baseada em tags), apresenta uma boa curva de aprendizagem em comparao com outras linguagens tais como ASP e PHP. Porm o pouco uso no Brasil torna a hospedagem uma das mais caras e at raras no mercado. Sites Flash Communication Server: Pginas desse tipo oferecem uma interface excelente com interatividade grande, incluindo stream de vdeo e udio, videoconferncia nas pginas da internet, e at possibilidade de comandos de voz. Porm o preo de uma hospedagem com essa tecnologia proibitivo e depende de muitos detalhes, at do nmero de conexes (visitantes simultneos) ao site. Para Banco de Dados voltados para sites, os mais comuns so: MySQL: atualmente um dos bancos de dados mais populares, e seu sucesso deve-se em grande medida fcil integrao com o PHP. livre. PostgreSQL: Outro sistema tambm livre de banco de dados, porm mais discreto no mercado. Firebird: Baseado no cdigo do InterBase da Borland, se tornou um banco com caractersticas prprias. Tambm livre.

20

SQL Server: Feito pela Microsof, um Banco de dados robusto e usado por sistemas corporativos dos mais diversos portes, com integrao com o Framework .Net. um software caro. Microsoft Access: Vem includo no pacote do Microsoft Office Professional. Usurios inexperientes podem us-lo para construir aplicaes simples, mas se recomenda algo mais poderoso para a Web.

ESPAO E TRANSFERNCIA
Espao do site quanto o servio de hospedagem libera de espao para os arquivos do seu site, isto , a soma dos tamanhos de todos os arquivos que compem seu site. medido em Megabytes. Uma instalao bsica do Xoops toma, pelo menos, 7 megabytes e esse valor vai crescendo com o uso do site. Lembrando que o uso de muitos fotografias, vdeos, arquivos de download e Flash aumenta o tamanho do site. Taxa de Transferncia mensal a soma de todos os downloads do seu site no ms. Toda vez que um visitante entra no site, ele est fazendo um download das suas pginas (e imagens) para visualizar no seu computador. Quanto mais visitantes voc tiver, maior ser sua transferncia mensal. Outros fatores influenciam tambm, como tamanho de imagens, uso de vdeos e msica, uso de flashs, etc. Caso um site ultrapasse o valor mximo de transferncia 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 mximo, sem imagens muito grandes e sem abuso de flash ou vdeos.

21

Para um site bsico em Xoops: A configurao de hospedagem ideal para um site em Xoops : - Suporte a PHP. - Pelo menos 1 base de dados MySQL. - Pelo menos 50 Megabytes de espao em disco para sites pequenos. Para sites com muitas figuras recomenda-se de 100 a 200 Megabytes. - Pelo menos 1 Gigabyte de taxa de transferncia 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
Aps voc fechar o contrato com a empresa de hospedagem, provavelmente a empresa lhe enviar vrios dados sobre seu contrato. Seno vejamos um exemplo:

Obrigado por efetuar sua hospedagem conosco! Abaixo esto os dados de sua hospedagem: Cliente: Login: Senha: FTP: Cpanel: DNS CD Power Comrcio cdpower t5y7u8 ftp.cdpower.com www.cdpower.com/cpanel ns1.hospedaqui.com

Vamos analisar esses dados enviados um a um: Cpanel: Trata-se do Painel de Controle do site. nesse endereo que o usurio altera sua senha, cria novos e-mails, v estatsticas de acesso, cria os banco de dados, etc. Login: Usurio 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 endereo que ser usado para transferir arquivos para seu site na internet. necessrio um programa especial para usar esse endereo. Ser abordado mais adiante. DNS: So endereos que tero que ser preenchidos no site em que voc criou o seu domnio (ou no www.registro.br ou no www.100br.com). Ao criar seu endereo .com.br ser pedido os servidores DNS. Basta colar essas informaes l.

23

Este um fluxograma de sugesto de todo o processo de criao inicial de um site. interessante estudar ele para ter noo que passos so realizados primeiro e que passos precisam seguir uma ordem para que tudo saia o mais rpido possvel.
Incio

Pesquisa do endereo .com Registro e criao do endereo Escolha das tecnologias do site Pesquisa de Hospedagem Fechar contrato de hospedagem Voltar ao site de registro do endereo e digitar o DNS Acesar via FTP e comear a enviar os arquivos
Aps a entrada do endereo DNS, normal uma demora de 24 a 48 horas para que o site esteja pronto para ser acessado e para se copiar os arquivos. Na hora de criao do endereo pode-se deixar em branco as informaes do DNS por enquanto A escolha da tecnologia do site ir influenciar na escolha da hospedagem: Tecnologias diferentes tm preos diferentes.

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 endereo registrado e com a hospedagem j contratada, voc j pode inicar o envio das pginas para seu site. Para isso voc utilizar um programa de FTP e o endereo de FTP enviado pela empresa de hospedagem. Existem vrios programas de FTP, muitos inclusive gratuitos. Em nossos exerccios estaremos utilizando o LeechFTP* verso 1.3 em ingls, porm os princpios de uso do FTP so os mesmos para a grande maioria dos programas. Vejamos ento a tela inical do programa:

Botes de funes Status do FTP

Painel de transferncias

Arquivos no site

Arquivos no seu computador

Botes de funes (principais)

Upload (enviar para o site) Download (baixar do site) Baixar compactado Atualizar

Desconectar Bookmark Lista de Endereos

Resuming (recomenda-se manter ligado)

Modo de transferncia (no mudar)

Sair

* O LeechFTP encontra-se na pasta /FREEWARE do seu CD. 25

Primeiramente vamos cadastrar nosso endereo de FTP (que foi dado pela empresa de hospedagem) em nosso programa. Vamos clicar no boto 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 endereo de FTP), Username (o seu nome de usurio) e Password (senha). No preciso mudar nenhuma outra configurao. 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).

Ateno s pastas: Em geral, o endereo FTP assim que acessado mostra algumas pastas. Apenas uma delas lhe leva aos arquivos do seu site. Em geral os nomes das pastas onde estaro seus arquivos so htdocs, public_html ou www. No recomendado vasculhar ou alterar as outras pastas.
27

Para trasnferir arquivos entre seu site e seu computador, basta usar os botes upload e downlaod. Para fazer um upload, selecione os arquivos que voc quer enviar no painel do centro e clique no boto 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 transferncias):

Transferncias Fila de uploads

Fila de downloads Falhas nos processos

28

Observaes sobre as transferncias: Ao selecionar arquivos para o upload, os arquivos so listados na fila de upload para as devidas transferncias. O processo demora de acordo com sua conexo e com o tamanho dos arquivos. Arquivos de texto so rpidos, arquivos multimdia (fotos, vdeos e textos) so mais lentos. Na orelha Threads (transferncias) h uma opo do nmero mximo de transferncias simultneas. 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 conexes. Para arquivos grandes (imagens e vdeos) mx. 3 conexes. Muita ateno na guia Failures (falhas), pois ela indica os arquivos que no puderam ser enviados por algum motivo desconhecido. bastante comum que no envio de vrios arquivos, algumas dezenas de arquivos falhem. Se um arquivo tiver sido esquecido de ser enviado, o site pode ficar instvel e ser muito difcil 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 (boto resubmit job).

Mensagens vermelhas acusam a falha na transferncia de arquivos.

Boto 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 requisies de pginas de internet. Em geral, contratamos o servio 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 no faz nenhuma alterao no seu Windows. Se quiser desinstalar, basta apagara pasta. A verso que iremos utilizar aqui a XAMPP Lite para Windows.

Passo 1: Descompacte o arquivo ZIP em um diretrio a sua escolha. Procure o cone setup_XAMPPlite.bat e inicie a instalao.
30

Passo 2: Se a instalao for bem sucedida, inicie os servios pelo cone xampp-control. Clique em Start nos botes ao lado de Apache e MySQL para iniciar estes servios. O aviso Running (em fundo verde) informa que o servio foi iniciado corretamente.

Ateno ao seu Firewall. Ao ligar os servios do XAMPP, o Firewall do Windows poder perguntar se quer mesmo desbloquear os servios. Clique em desbloquear.
Passo 3: Inicie seu browser de internet e digit http://localhost . Voc dever ver a tela inicial do XAMPP. Caso no aparea nada, verifique se o endereo digitado est correto e cheque no painel de controle do XAMPP se os dois servios (Apache e MySQL) estao rodando (palavra running ao lado). Nos links a esquerda na pgina do XAMPP ser possvel encontrar o phpMyAdmin que o programa que lhe dar acesso ao Banco de Dados MySQL.Neste endereo possvel 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 preferncia em uma pasta s para o Xoops (tipo C:/xamplite/htdocs/xoops) para no misturar com os arquivos do XAMPP.
31

Copiando o Xoops dentro do XAMPP wBaixe a verso mais atual do Xoops e descompacte em uma pasta qualquer. Dentro do pacote Xoops padro voc ver as seguintes pastas: wdocs: Contem informaes sobre o pacote do Xoops e instalao. wextras: arquivos extras necessrios caso o usurio precise instalar funcionalidades especiais, como o mdulo Protector. whtdocs: Local onde esto os arquivos do Xoops em s. wupgrade: arquivos necessrios para fazer upgrade de verses antigas do Xoops (leia manuais das atualizaes). wchecksum.php e checksum.md5: Arquivos necessrios para verificar se todo o Xoops foi enviado corretamente para a hospedagem. wrelease_notes.txt: texto com as notas de lanamento da verso. Os arquivos a serem copiados para o servidor so 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 Diretrio do XAMPP

C:/xampp/htdocs/meuxoops
Pasta criada para o Xoops Arquivos da pasta htdocs do pacote Xoops

Caso necessite de mais de uma instalao do Xoops no mesmo servidor (para testes de verses, ou para criar vrios sites diferentes ao mesmo tempo), crie uma pasta para cada instalao do Xoops. No Xoopos necessrio ainda alterar as permisses de acesso de algumas pastas e arquivos. As pastas a serem alteradas so cache, templates_c, uploads e xoops_data, alm do arquivo mainfile.php. Porm no windows esse procedimento desnecessrio, haja visto que as propriedades dos arquivos no windwos j so por padro 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 servios PHP, MySQL e Apache. A maneira mais fcil de baixar tudo da internet acessando o cone YaST, que um programa baixador de repositrios (programas) para o Linux. Clique no menu inicial (camaleo), depois em Aplicativos > Sistema > Configurao > Instale Software. Ser pedido a senha de administrador; digite-a. Na opo Filtro, mude para Padres. Na listagem que aparece abaixo, procure pelas Funes de Servidor Servidor de Internet e LAMP. Marque a opo e clique em Aceitar (canto inferior direito) para baixar os pacotes correspondentes. Tenha em mos o DVD de instalao do seu openSUSE; ele ser pedido. Lembre-se tambm que parte dos pacotes pode precisar ser baixado da Internet. Certifique-se que sua conexo rede esteja funcionando.

Aps a instalao dos pacotes, precisamos ligar nosso servidor de Internet. V no menu inicial (camaleo) > Computador > Configuraes de administrador. Entre com a senha de Administrador e acesse o cone Servios de Rede. Clique ento em Servidor HTTP no painel direito. Voc entrar em uma sequncia 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 configuraes. Normalmente no necessrio mudar nada. 4 - Hosts virtuais. No mude nada. 5 - Selecione Iniciar Servidor Apache2 durante a Inicializao. 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 opo filtro, agora escolha pesquisa, e faa uma pesquisa com o nome phpmyadmin. Selecione o pacote e clique em aceitar para comear a baixar. necessrio estar conectado Internet para atualizar e baixar o pacote phpMyAdmin, pois este no est no DVD de instalao do openSUSE. Verifique se sua conexo com a Internet j est funcionando antes de instalar novos pacotes. O Linux geralmente se conecta mais facilmente internet via conexes fsicas (cabo de rede). Se sua internet sem fio (wi-fi, 3G, etc.) experimente conectar-se via cabo de rede. Caso voc no consiga baixar o phpMyAdmin, ainda assim ser possvel instalar e usar o Xoops, porm ser necessrio o phpMyAdmin para acompanhar instrues sobre criao, administrao e exportao de banco de dados. Sem ele, provavelmente voc no poder exportar seu site do seu computador local para a Internet. Aps a instalao, abra o navegador de internet e acesse a pgina 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 (no obrigatrio), o endereo http://localhost/phpMyAdmin.

34

Caso no tenha funcionado, o Apache e o MySQL devem estar desligados. Acesse a configurao do Sistema YaST (menu inicial > Computador > Configuraes de administrador), clique em Sistema > Servios do sistema (nvel de execuo), e na lista que aparece, habilite o Apache e o MySQL (clique na opo desejada e depois no boto Habilitar). Teste novamente o endereo http://localhost/ no navegador. Caso ainda persistam problemas, verifique a instalao dos pacotes. Copiando o Xoops dentro do Apache Baixe e descompacte o pacote do Xoops dentro de uma partio linux. Caso voc tenha feito o download do Xoops no Windows para instalar depois no Linux, acesse a partio windows de dentro do Linux (no openSUSE, clicando em Meu Computador e depois na partio correspondente) e copie o arquivo compactado (.ZIP ou .TAR.GZ) para dentro de uma partio Linux antes de fazer a descompactao. No copie a pasta que foi descompactada no Windows. Este procedimento importante para manter as permisses de acesso aos arquivos. Analisando os arquivos do pacote Xoops, temos as seguintes pastas que foram descompactadas: wdocs: Contem informaes sobre o pacote do Xoops e instalao. wextras: arquivos extras necessrios caso o usurio precise instalar funcionalidades especiais, como o mdulo Protector. whtdocs: Local onde esto os arquivos do Xoops em s. wupgrade: arquivos necessrios para fazer upgrade de verses antigas do Xoops (leia manuais das atualizaes). wchecksum.php e checksum.md5: Arquivos necessrios para verificar se todo o Xoops foi enviado corretamente para a hospedagem. wrelease_notes.txt: texto com as notas de lanamento da verso. Os arquivos do Xoops a serem copiados para o servidor so somente o da pasta HTDOCS. Para copiar os arquivos para a pasta do seu servidor local (/srv/www/htdocs) necessrio abrir um Gerenciador de
35

Arquivos no modo Superusurio. Para isso v no menu inicial > aplicativos > sistema > gerenciador de arquivos > Gerenciador de Arquivos (modo Superusurio). Ser pedido a senha de Administrador. No Gerenciador de Arquivos no modo Superusurio, navegue at a pasta raz (pasta vermelha) e entre nos diretrios do servidor: /srv/www/htdocs. Crie uma pasta para sua instalao do Xoops e copie e cole dentro desse diretrio os arquivos do Xoops.
Copiar/Colar Diretrio 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 necessrio alterar as permisses de acesso de algumas pastas e arquivos. As pastas a serem alteradas so cache, templates_c, uploads e xoops_data. Clique individualmente com o boto direito em cada pasta e escolha propriedades. Em permisses, marque Pode ver & modificar o contedo para os 3 tipos de usurio: dono, grupo e outros. Marque tambm a opo aplicar mudana a todas as sub-pastas e seus contedos. Altere tambm as permisses de acesso do arquivo mainfile.php para pode ler & escrever nas 3 opes. 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 necessrios (PHP e MySQL) e a base de dados j estaro 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 padro voc ver as seguintes pastas: wdocs: Contem informaes sobre o pacote do Xoops e instalao. wextras: arquivos extras necessrios caso o usurio precise instalar funcionalidades especiais, como o mdulo Protector. whtdocs: Local onde esto os arquivos do Xoops em s. wupgrade: arquivos necessrios para fazer upgrade de verses antigas do Xoops (leia manuais das atualizaes). wchecksum.php e checksum.md5: Arquivos necessrios para verificar se todo o Xoops foi enviado corretamente para a hospedagem. wrelease_notes.txt: texto com as notas de lanamento da verso.

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 pacincia.
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 no) e queira instalar o Xoops para teste ou mesmo para migrao do site antigo para um site em Xoops. Voc tambm pode instalar mais de uma cpia do Xoops em seu site, bastando para isso criar uma pasta para cada instalao. Se voc instalou o Xoops em uma pasta, e agora quer que seus visitantes acessem diretamente seu site, basta criar um redirecionamento automtico do endereo principal (www.seusite.com) para a pasta do Xoops. Pesquise por esse procedimento HTML na internet.
37

Alterando as permisses 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. Atravs 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 instrues em seu programa FTP).

38

INSTALANDO O XOOPS
Com o servidor (local ou no) j pronto, e os arquivos copiados agora sim vamos comear a manipular os arquivos do Xoops. A instalao do Xoops a partir e agora ocorre toda atravs do navegador de internet (explorer, firefox, safari ou chrome). Acesse atravs 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 pgina de instalao do xoops a seguir:

Se voc no 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 instalao daqui em diante simples, tendo o usurio somente que prestar ateno s informaes que o programa solicita. A primeira tela pergunta qual ser o idioma padro a ser instalado. Escolha o idioma portugus e pressione next. A partir desse momento a instalao passa toda a ser em portugus. 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 instalao do Xoops. Clique em prximo. A terceira tela faz uma verificao inicial do seu servidor, verificando qual a verso do PHP, se pode fazer uploads, etc. Clique em prximo. A Quarta tela pergunta os caminhos fsicos e virtuais do site. O Xoops j preenche automaticamente esses dados. Voc deve apenas verificar se a ferramenta automtica achou corretamente os caminhos. O caminho fsico do site o diretrio em que seu Xoops est instalado (ex: no WinXP pode ser semelhante a C:\xampp\htdocs). O caminho virtual o endereo de acesso ao site atravs 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 Endereo do servidor de banco de dados: Na grande maioria das vezes localhost mas alguns provedores de internet podem dar um endereo diferente, semelhante a mysql.seusite.com . Nome de usurio 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 usurio fornecido pelo seu provedor. Senha de usurio do banco de dados: Se estiver usando o usurio root, provavelmente deixe a senha em branco. Caso esteja instalando na internet, use a senha de usurio 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 dvidas, 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 no necessrio alterar o valor aqui mostrado. O Xoops preenche aleatoriamente (por questes de segurana) esse valor. Conjunto de caracteres para o Banco de Dados: Se voc estiver instalando um site em portugus, procure a opo latin1 (cp1252 West European). Onde pede Banco de dados Collation, deixe a opo default (padro), que provavelmente ser latin1_swedish_ci. Ao clicar em prximo, os dados sero gravados no arquivo mainfile.php e ser exibida uma tela com a reviso de todos os dados a serem usados. Se eles estiverem corretos, ser dada a gravao das tabelas do banco de dados.

42

Na tela seguinte, o Xoops ir criar o banco de dados (caso ainda no exista) e ir criar as tabelas padro do Xoops.

O Xoops ento pedira que voc informe os dados de acesso do administrador do site:

Entre com seu nome de usurio, e-mail e digite sua senha duas vezes. Se voc j estiver instalando esse Xoops na internet, no coloque uma senha fcil. Aps clicar em prximo, uma nova gravao 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 simplrio que parea a tela inicial, no 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 instalao do Xoops.

Aps uma mensagem de boas vindas, voc ver o menu de Usurio, onde deve agora clicar no link Menu de Administrao.

44

Painel de controle padro

Painel de controle EXM

A rea administrativa do Xoops inicialmente parece muito com a pgina inicial. Porm ela no personalizvel, ento 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 configuraes do Xoops. Inicialmente iremos explorar o sublink Preferncias. Acessando agora as Configuraes Gerais, iremos gravar os primeiros dados de nosso site: wNome do site: o nome que ir aparecer nas pginas principais, e o nome que ser cadastrado nos sites de busca. Seja breve e direto! Pode usar espaos e acentuao. wSlogan do site (ou da empresa): Uma frase sobre o seu site. Ir aparecer na pgina principal. wEndereo de e-mail do administrador: E-mail que ir receber avisos do site (ex: quando um novo usurio se cadastrar, o site poder enviar um e-mail para o administrador avisando. wLngua preferencial: Muda a lingua dos textos do Xoops. Existem opes de criar sites multi-linguas (com mais de uma lngua selecionada pelo visitante). Pesquise nos sites de xoops. wMdulo Inicial: Como nosso site no tem nenhum mdulo ainda instalado, ento no aparece nenhuma opo aqui. Porm depois poderemos definir aqui que nossa pgina principal mostre primeiro as notcias, ou qualquer outro mdulo. wZona de tempo do servidor (procure saber com seu provedor). wZona de tempo do site: As informaes sobre as zonas de tempo
45

devem ser configuradas corretamente para que as datas de envio de mensagens (ex. Notcias) apaream corretamente. Se a pgina est hospedada nos USA e visitada por pessoas do Brasil, as zonas devem ser configuradas baseadas nesses dados. wPainel de Controle Padro: Temos o painel Default (padro) que o painel comum do Xoops desde a primeira verso; e temos o painel EXM, criado pelo Xoops Mexico, sendo esse um painel mais bonito, com novos cones e melhor navegao. Desse ponto em diante iremos trabalhar somente com o painel de controle EXM, porm isso no ir dificultar usurios que prefiram o painel antigo. wTema padro: O tema o conjunto de arquivos que d a cara do seu site. Inicialmente no iremos abordar mudana no tema agora, ento poderemos deixar em default. A criao de temas ser abordado no captulo Personalizando o Xoops. wAtualizar os modelos de mdulo do diretrio "themes/templates"? Selecione sim caso esteja fazendo testes e alterando os arquivos de personalizao do site (temas e modelos). Se essa caixa estiver marcada com no, ao alterar os arquivos do tema (ex: mudar cor de menu, alterar logomarca) as alteraes no iro aparecer para os visitantes. Ento quando estiver fazendo a personalizao de seu xoops, lembre-se de sempre marcar sim. wTemas selecionveis: O seu site pode ter mais de um tema ao mesmo tempo, e voc pode dar a opo dos visitantes escolherem esses temas (bastando ligar o bloco temas). Nessa caixa de seleo, 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) tambm faz parte da personalizao do xoops, e ser abordado depois. Poderemos deixar ele em default por enquanto. wNome do usurio annimo: Como voc chamar os usurios annimos (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 no se confundiro com outros sites xoops. Ex: macarrao_user. wUsar sesso personalizada: Selecione sim caso queira que o site lembre o nome de usurio no login, atravs de cookie. Isso permite que os usurios do site se loguem mais rapidamente. wNome da sesso: Faa o mesmo que nos nome dos cookies: personalize.
46

wDurao mxima da sesso em segundos: Tempo mximo em segundos para uma sesso desativada. Caso um usurio no acesse nenhuma pgina do site dentro desse tempo, ele deslogado. wModo Debug: Mantenha desligado a no ser que esteja tendo problemas com telas brancas. wAtivar banners: Se for utilizar o sistema de banners do xoops para anncios, ligue-o. Porm se for utilizar os sistemas de banners de outra empresa (Google, Yahoo, UOL, MercadoLivre) desligue: a forma de implementao dessas publicidades outra e ser abordada na criao do tema do site (personalizao). wDesligar o site: Caso seja necessrio fazer manutenes em seu site e deseja impedir que os visitantes acessem o site durante esse perodo wMotivo para fechamento do site: Texto a ser exibido caso o site esteja desligado. wO seu IP: Caso no queira que suas visitas influenciem as estatsticas 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 informaes pela internet. O Xoops pode utilizar SSL (cadeado no navegador) da mesma forma que um banco usa, dando segurana no envio do usurio e senha do xoops. Porm o uso de SSL requer que a hospedagem fornea uma pgina (ou diretrio especial da hospedagem) que tenha SSL. Consulte seu provedor sobre o assunto. wNome da varivel SSL Post: Caso use SSL, personalize esse valor. wURL onde a pgina de entrada com SSL est localizada: Informao que ser dada pelo provedor de acesso. wPadro de visualizao dos comentrios: O xoops tem um gerenciador de comentrios para todo o site. Essa caixa de seleo define qual a forma padro de exibio desses comentrios. wPadro de ordenao dos comentrios: Define qual a ordenao padro de exibio desses comentrios. wAtivar as restries de IP: Sistema de segurana que barra o acesso ao site de visitantes. Basta colocar o IP do visitante na lista de banidos para que este no consiga mais acessar o site. Porm uma medida ineficaz, j que oda vez que um usurio comum entra na internet, seu nmero de IP muda.
47

wIps Banidos: Lisa de Ips a serem banidos. wCache de mdulos: Cache (leia-se kesh) uma tcnica de acelerao de acesso ao site. O site pode cachear mdulos, gravando as pginas mais acessadas para que sejam visitadas mais rapidamente. Porm se essas pginas sofrerem alteraes, os visitantes no iro ver imediatamente essas mudanas, j que esto ainda vendo as pginas cacheadas. Para utilizar bem essa funo e acelerar o acesso ao seu site, ligue os caches e defina os tempos de cache baseados nas alteraes das informaes dos mdulos. Ex: se o mdulo notcias recebe informaes constantemente, ligue o cache com um tempo curto (minutos). Se a pgina quem somos praticamente fixa, sem alteraes em meses, ligue o cache com um tempo longo (vrios dias ou semanas). Se voc alterou alguma informao no seu site (notcia, pgina com contedos, etc) e a alterao ainda no foi ao ar, pode ser que o site esteja ainda mostrando as informaes do cache. Para resolver, basta limpar o cache. Para isso, acesse Preferncias > Configuraes Gerais, e, sem alterar nenhum dado, clique em Prosseguir no final da pgina. Isso ir resetar todos os caches gravados. Ao final das mudanas nas configuraes, clique em prosseguir para gravar as alteraes.

Se voc passar muito tempo para gravar as alteraes feitas nas telas de configurao, o xoops dar um aviso VALID TOKEN EXPIRED, e no gravar as alteraes.

48

Preferncias Configurao dos usurios Esta rea de configurao define todo o manejo com novos usurios do seu site: wPermitir o registro de novos usurios? Caso esteja ligado, visitantes do site sero convidados a se cadastrar, preencher os dados, e participar do seu site como usurio. wTamanho mnimo para as senhas wTamanho mnimo do nome de usurio wTamanho mximo do nome de usurio wPermitir que os usurios mudem de endereo de e-mail? wEnviar mensagem de Boas Vindas: Caso esteja ligado, o usurio recm cadastrado ir receber uma mensagem de boas vindas no e-mail dele. wAvisar por e-mail quando um novo usurio se cadastrar? Aviso ao administrador do cadastro de novos usurios. wAvisar os grupos: wSelecione o tipo de ativao do registro de novos usurios: w Ativao pelo usurio: O usurio receber um e-mail com a mensagem: clique aqui para confirmar o seu registro. Recomendado. w Ativao automtica: Assim que o usurio entrar com os seus dados, seu cadastro estar pronto (no completamente seguro porque no verifica se o e-mail vlido). w Ativao por administrador: O administrador tem que entrar no site e aprovar um a um os usurios que se cadastraram. wEnviar o e-mail de ativao de conta para (vlido apenas quando a opo 'Ativao pelos administradores' selecionada): wNvel de restrio para caracteres no nome de usurio: wPermitir o envio de avatares? Avatar uma imagem que representa o usurio. Muito utilizado em fruns de discusso. wNmero mnimo de mensagens requerido: Voc pode definir que o usuario tenha que mandar um nmero X de mensagens antes de poder cadastrar seu Avatar. wPermitir que os usurios apaguem as suas prprias contas? wExibir o termo de responsabilidade?Termo de responsabilidade o texto a ser exibido no ato do cadastro do usurio no site. Informa, alm de outras coisas, que o usurio responsvel por tudo que disser nas reas do site, sendo este ltimo isento das opinies de seus visitantes.
49

Preferncias Meta-dados e rodap Informaes importantes, principalmente para que nossos sites sejam bem ranqueados em sistemas de busca como o do Google. Quanto mais preciso essas informaes 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 vrgula que tenham muito a ver com o contedo de seu site. Lembre-se de incluir informaes geogrficas (como pas, estado, cidade e bairro) e nunca coloque palavras que no fazem parte do contedo de seu site. wMeta Description: Descreva o seu site, seus objtivos, produtos principais e informaes gerais em at 3 linhas. Essa descrio 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 contedo ser indexado ou rastreado. wO campo Meta Rating define a classificao do contedo do site. wAutor: Pode ser uma pessoa fsica ou jurdica. w Meta Copyright: Contm as informaes sobre os direitos de reproduo dos documentos disponveis. Caso no queria que o material de seu site seja copiado, escreva copyright. Caso no se importe que o material do seu site seja copiado (dando-lhe o crdito) use o copyleft. wRodap: Define tudo que ir aparecer no final da pgina de seu site. Preferncias Palavras censuradas O Xoops dispe de um eficiente sistema de bloqueio de palavras censuradas, muito til nos comentrios dos usurios. Nesse sistema, palavras cadastradas sero substituidas por uma palavra padro, impedindo que termos indevidos sejam registrados no site. Lista de palavres j completa podem ser encontradas na internet. Preferncias Opes de pesquisa O Xoops j conta com um timo sistema de busca interna. Caso queira desligar a busca, ou mudar parmetros de busca, essa a rea de configurao.
50

Preferncias Configurao de e-mail Para que seu site envie e-mails corretamente (tanto para usurios como para administradores), as opes 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 no est preparado para enviar e-mails. Para sua hospedagem na internet, faa testes e consulte o suporte para verificar as configuraes.

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: site@seusite.com). wNome do remetente: O nome que constar no cabealho dos emails enviados pelo site. wUsurio 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 usurios sem ser por e-mail. wMtodo de envio: Teste as configuraes uma por uma para saber qual delas funciona com seu servidor. wCaminho do sendmail: Caso use a opo sendmail, verifique se o caminho digitado corresponde ao servio. Entre em contato com sua hospedagem para tirar a dvida. 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 usurio do SMTPAuth: SMTPAuth SMTP autenticado. So contas de e-mail que precisam ser autenticadas tambm para enviar mensagens. Se esse o caso do seu e-mail, selecione SMTPAuth, e digite aqui o nome de usurio da sua conta de e-mail. wSenha do SMTPAuth. Para testar as configuraes de e-mail, v em Sistema > Contatar usurios. L ser possvel escrever uma mensagem teste de e-mail e selecionar um grupo de usurios para receber a mensagem teste.
51

Banners O Xoops j contm um sistema de administrao de Banners bastante eficiente e prtico. uma tima soluo para sites que precisem de publicidade para arrecadar fundos baseados em publicidade. Ao clicar em banners, voc ver informaes do tipo banners ativos, banners expirados (fora do ar) e clientes com propaganda. Os banners cadastrados na instalao bsica so os do Xoops, em verso 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 formulrio incluir novo cliente. Ser pedido nome, e-mail, e um usurio e senha. Esses dados so para que o cliente possa verificar o andamento da campanha dele pessoalmente, atravs do endereo www.seusite.com/banners.php . Aps incluir o cliente, voc incluir os banners do cliente, atravs do formulrio incluir novo banner. Ser pedido qual o cliente, quantas impresses 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 cdigos HTML opcionais (necessrios caso o banner seja em Flash).

Ateno: O sistema de banners do Xoops no tem envio de arquivo automatizado. Voc deve enviar os arquivos dos banners via FTP para algum diretrio qualquer do seu site. Recomendamos a pasta uploads.

52

Blocos Essa provavelmente uma das telas mais complicadas porm mais poderosas no sistema Xoops. Os blocos definem muito da exibio das informaes do Xoops e, quando bem configurados, podem montar estruturas de pginas dignas de grandes portais avanados. Um bloco uma caixinha de informao, posicionada pelo designer do site, que ir mostrar dados, links ou formulrios de mdulos ou do prprio sistema Xoops. Os administradores do site tambm podem criar blocos personalizados, que podem conter uma imagem, um banner, um cdigo HTML ou PHP. O menu principal e o menu pessoal so os blocos principais, j que eles devem sempre estar visveis para que os usurios do site tenham links para acessar o site. Na listagem dos blocos, vamos ver o que significa cada uma das colunas:

wTitulo: O ttulo do bloco que ser exibido. Pode ser alterado pelo administrador. wDescrio do Bloco: Diz suscintamente o que o bloco faz. wMdulo: Diz a que mdulo o bloco pertence. Blocos Principal, Votao e Pesquisa wTipo Esquerda - Centro - Direita: alinhados verticalmente num site. Informa em qual posio o bloco ir aparecer na pgina. wVisivel em: Marca em que pginas o bloco ser visvel. Para selecionar mais de uma pgina, basta clicar segurando o CTRL.
53

wTempo de cache: Assim como os mdulos possuem caches para acelerar a exibio do site, os blocos tambm podem ser acelerados. A regra a mesma para os mdulos: defina o tempo do cache de acordo com a frequncia de atualizao das informaes do bloco; blocos que raramente mudam podem ter um tempo longo (dias, semanas). Blocos muito imeditatos (como resultados de votaes, notcias, contador de visitas) precisam ter tempos curtos de cache (segundos, minutos). wVisvel: Marca se o bloco ser visvel ou no. wAo Editar: Ao clicar, mostrar as mesmas opes de configurao da tela anterior, podendo o administrador do site verificar mais corretamente as configuraes do bloco em questo. Nessa tela Editar tambm se encontra um link para a edio do modelo (ou template). Isso til quando precisamos mudar o formato que as informaes dadas pelo bloco so exibidas. Para saber mais sobre isso, veja sobre Modelos (ou templates) na pgina 67. wAo Clonar: Voc pode criar cpias dos blocos. Isto serve para dar mais versatilidade exibio 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 notcias. Se um bloco est configurado corretamente mas no exibido para os visitantes do site, verifique se o grupo visitante tem acesso a visualizar esse bloco. Veja mais na parte Grupos, pgina 61.

54

Cabealho (definido pelo tema)

Cores e estilo dos blocos (definido pelo tema)

rea do Mdulo

Rodap (definido pelo tema)

As posies laterais definem que os blocos ficaro nos extremos do site. So posies importantes para menus, busca e informaes importantes que devem sempre estar em local de fcil acesso aos visitantes. Caso no exista nenhum bloco marcado para um dado lado (esquerda ou direita), a fileira de blocos no aparece.

Alguns temas no possuem o bloco direito. Ao usar esses temas,marcando um bloco na direita, ele no aparecer
55

Cabealho (definido pelo tema)

Cores e estilo dos blocos (definido pelo tema)

rea do Mdulo

Rodap (definido pelo tema)

As posies superiores definem blocos que iro aparecer acima do contedo do mdulo. As opes so centro-centro, centro-esquerda e centro-direita.

Alguns temas podem no possuir as opes centroesquerda e centro-direita.

56

Cabealho (definido pelo tema)

Cores e estilo dos blocos (definido pelo tema)

rea do Mdulo

Rodap (definido pelo tema)

As posies inferiores definem blocos que iro aparecer abaixo do contedo do mdulo. As opes so centro-centro, centro-esquerda e centro-direita.

Somente os temas mais novos implementam corretamente as opes inferiores. Certifique-se de que seu tema mostra corretamente as opes inferiores.
57

Cabealho

Bloco Esquerda

Exemplo de site tipo padro comercial com menus e blocos esquerda.

Mdulo

Bloco inferior central Rodap Cabealho

Mdulo

Bloco Direita

Exemplo de site tipo blog, com links e menus na rea da direita.

Rodap Cabealho & Menu Principal

Exemplo de site sem laterais, valorizando o centro (mdulo). Nesse tipo de site no h o menu principal. O tema deve ter todos os links do menu principal j gravados.

Mdulo

Bloco inferior central Rodap Cabealho Bloco Esquerda

Mdulo

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 mdulos (tipo mini-calendrio, votao). Selecione aqui que blocos deseja ver para configurar.

Alguns blocos podem no ser visualizados por determinados tipos de usurios do site. Por exemplo: As votaes podem no estar disponveis para os visitantes. Nessa caixa possvel ver que blocos esto ligados para que tipo de usurio. Filtro de visualizao para mostrar somente os blocos visveis ou no. Facilita para se ter certeza de quais blocos esto realmente ligados. Configuraes sobre a posio do bloco

Mostra a configurao dos blocos de acordo com a pgina. Ex: Para ver que blocos esto ligados na pgina de notcias, selecione notcias aqui.

Bloco Personalizado

Ttulo do bloco

Gerenciado de imagens do Xoops Link imagem Smiles (sorrisos) Link e-mail Flash Vdeos YouTube Incluir link

O editor de textos padro do Xoops no WYSIWYG (O que voc v o que voc tem); quer dizer, voc no ir ver os textos em negrito, ou com outra fonte, ou no ver uma imagem anexada. Ao invs, voc ver cdigos que indicam a formatao do texto criado. Para visualizar como ficar seu bloco, clique em Exibir.
59

Ao criar seu bloco personalizado, marque corretamente a caixatipo de contedo para que a visualizao do contedo ocorra corretamente. Ex: Se voc incluiu imagens, links e formatao de texto atravs dos botes do formulrio, seu contedo do tipo Script PHP. Mas se voc prefere digitar os cdigos HTML diretamente, e fazer toda a formatao na mo (ou utilizando um programa editor de HTML como o Dreamweaver), marque que seu contedo HTML. As opes Com Emoticons e Sem Emoticons so sub-opes do tipo Script PHP. A diferena que na Com emoticons, textos como este :) sero substituidos por imagens smiles como esta .

60

Grupos Nosso site em Xoops classifica os usurios 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 no podem ter acesso a certas reas e mdulos, e que somente usurios cadastrados poderao ver o link do frum de discusso, ou participar de algum evento no calendrio. Por padro, o Xoops tem 3 tipos de usurio:

wAdministrador: o usurio mximo do site. Tem acesso rea administrativa, e pode alterar qualquer configurao do Xoops. No recomendado dar privilgios de administrador para outros usurios, principalmente se eles no tiverem necessidades administrativas. wUsurio: O Xoops considera usurio todo aquele que tem senha de acesso ao Xoops, mas no pode entrar na rea administrativa. wVisitante: a pessoa que no entrou com nenhuma senha para acessar o site, e s tem acesso s informaes que esto liberadas a todos.
Para criar um novo grupo de usurios, por exemplo o grupo de editores (podem enviar notcias e artigos, mas no podem entrar no painel de administrao do site), basta preencher o nome e a descrio do grupo, e marcar as devidas permisses de acesso para o sistema, para a administrao dos mdulos, para acesso dos mdulos e para o acesso aos blocos. Para editar um grupo de usurios, fazendo com que esse grupo tenha ou no 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 catlogo de imagens usadas no site, alm de permitir o envio fcil de imagens sem a necessidade de programas de FTP (transferncia 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 notcias) 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 mximo: O valor padro 50000 bytes, ou 50Kb, o que um valor bem pequeno (comparvel 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 mxima: Limita o tamanho em pixels da imagem. Esse limite interessante porque se um usurio tentar incluir uma foto em uma notcia, por exemplo, e a foto for grande demais, o site ir estourar para os lados, desconfigurando todo o visual. wOrdem: a ordem de visualizao do lbum. Se colocar 1, ser o primeiro lbum mostrado. wExibir categoria: Coloque sim para que a categoria aparea no gerenciador de imagens. wSalvar imagens com: O padro salvar os arquivos na pasta /uploads, mas possvel salvar as imagens no banco de dados tambm, porm no recomendado. Recomenda-se a criao de categorias Imagens Pequenas (com limites no tamanho e na largura e altura), imagens grandes (com limites maiores), ou ento a separao das imagens por funo: imagens de notcias, etc.
62

Mdulos Os mdulos so as funcionalidades extras de seu site Xoops que podem ser incluidas, desabilitadas e excluidas facilmente, atravs dessa rea administrativa. Ao acessar pela primeira vez, o nico mdulo ativo o prprio sistema. Abaixo da lista de mdulos instalados, voc ver a lista de mdulos aguardando instalao.

Na listagem de mdulos instalados, temos: wMdulo: Pode-se alterar o nome do mdulo (que exibido, por exemplo, no menu: podemos mudar o mdulo notcias para novidades). wVerso: Verso do mdulo. til caso necessitemos de uma verso mais nova de um mdulo. wltima atualizao. wAtivado: Marque para fazer com que o mdulo fique funcionando. Para desinstalar um mdulo, antes voc deve desativ-lo. wOrdem: A ordem de exibio dos mdulos no menu principal. Assinale cada mdulo com um nmero definindo quem aparece primeiro. wAo: Botes de ao, onde se pode ver informaes do mdulo, reinstalar (atualizar) um mdulo ou desinstalar o mdulo (cone s aparece quando o mdulo esta desativado).
63

Instalando novos mdulos Nos repositrios do Xoops possvel encontrar centenas de mdulos para as mais diversas funes. Para instalar novos mdulos, primeiro baixe o mdulo da internet. Vrios endereos podem ser pesquisados para se encontrar o mdulo desejado, como www.xoops.org (em ingls), www.xoops.pr.gov.br e www.xoopsbr.org, porm um timo repositrio de mdulos j em portugus o www.x-trad.org. Aps descompactar o arquivo, identifique a pasta principal do mdulo. Em geral, o arquivo descompactado j gera a pasta principal, mas importante que saibamos identificar essa pasta.

Estrutura de pastas do mdulo Liaise (formulrios) destacando o arquivo xoops_version.php

As pastas dos mdulos contm obrigatoriamente o arquivo xoops_version.php, e dentro delas tambm encontraremos pastas comuns, como /sql, /admin e /language. Para poder instalar o novo mdulo, devemos colocar a pasta principal do mdulo na pasta /modules da nossa instalao 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

Aps enviar o mdulo para a pasta /modules, acesse a rea administrativa do Xoops e o cone mdulos. Voc ver, abaixo da lista dos mdulos j instalados, a lista de mdulos que podem ser instalados.

Para instalar o mdulo, basta clicar no cone do disquete cinza, ao lado da logo do mdulo que voc quer instalar. Aps uma tela de instalao rpida, seu mdulo estar pronto para ser configurado e usado.

Para ter certeza de que seu mdulo est em portugus, verifique dentro da pasta /language se existe a pasta /portuguesebr.

65

Emoticons ou Smilles Os emoticons ou smilles so cones representativos das emoes dos usurios do site. So 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 so padro no sistema. Gerenciamento das posies dos usurios Os sites em Xoops podem ter um sistema de ranking de usurios. Esse ranking cataloga todas as participaes do iusurio, e baseado nesses dados d uma classificao ao cadastrado, que vai de Just Poping it (s dando uma passada) at Webmaster (usurio master). Estas classificaes no foram traduzidas e precisam ser editadas para o portugus aintes de serem usadas. Editar usurio rea do site onde possvel incluir, editar e excluir usurios do nosso site em Xoops. nessa tela tambm que podemos aumentar a categoria de um usurio, mudando-o de grupo e dando-lhe poderes de administrador. Procurar usurios Trata-se de um grande formulrio com diversas possibilidades de busca de usurios do site. Muito til para quem tem uma base de dados de usurio bem grande. Contatar usurios Ferramenta de criao de mensagens (e-mail ou mensagem privada) a serem enviadas diretamente do site. til quando se quer mandar mensagens em massa para todos os usurios cadastrados no site. Para que esta funcionalidade funcione corretamente, necessrio que a rea preferncias >> configurao de e-mail estejam configuradas corretamente.
66

Modelos ou Templates Um template ou modelo como um modelo do Word, uma pgina pr-pronta para ser usada. Um dos maiores problemas na programao PHP conseguir manter claro o cdigo que est sendo programado, pois a grande quantidade de sinais de maior e menor acaba misturando tudo e tornando quase impossvel qualquer um de ler uma pgina PHP. Os modelos ou modelos servem para separar o cdigo PHP do cdigo HTML, ou seja, permitem que faamos os programas PHP de forma organizada sem mistur-lo com o HTML. Uma das deficincias do XOOPS at a verso 2.0 era a dificuldade de modificar o layout de blocos e mdulos, pois pr isso era preciso abrir arquivos PHP quase que indecifrveis. Aps a implementao do Smarty isso ficou muito mais fcil, agora podemos usar o mesmo mdulo com layouts completamente diferentes sem a necessidade de abrir nenhum arquivo PHP. Alm 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 ento para temas diferentes. Resumindo, um modelo um cdigo HTML que contm algumas variveis Smarty que sero substituidas pelos dados do site quando o visitante ver a pgina. Alterando os modelos, podemos dar uma boa personalizada em nosso site Xoops.

Ateno: O modelo default do xoops (que vem com a instalao) no 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

Aps a clonagem, v em Preferncias >> Configuraes Gerais >> Conjunto de modelos (templates) e marque l o modelo recm clonado para ser o padro. S assim que as alteraes feitas nos modelos aparecero no site.
Vamos fazer um exemplo de personalizao via modelo para mudar o bloco pesquisa. O bloco pesquisa faz parte do sistema principal do Xoops, ento encotraremos ele clicando em listar ao lado de sistema.
Modelo default (no permite atualizao)

Modelo clonado por ns (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 boto 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 questo, iremos ver o seguinte cdigo HTML:
68

Define que centralizado Define um formulrio tipo get que joga os resultados para a pgina search.php

<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>

Varivel Smarty que mostra o caminho do site Xoops Varivel Smarty que define o que deve ser escrito no link de pesquisa avanada Varivel Smarty que define o que deve ser escrito dentro do boto de pesquisa

Esta pgina est propositalmente impressa de lado para facilitar ver os cdigos

69

Analisando o cdigo, vemos que no nada mais nada menos que um cdigo HTML simples, que ao invs de ter textos (definindo por exemplo o que vai escrito no boto de pesquisa) tm tags smarty, que so identificadas pelo padro <{$uma_tag_aqui}>.

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, tambm saberemos que o preenchimento automtico do texto no vai, por exemplo, corresponder mais lingua do Xoops: Se mudarmos o idioma do Xoops para ingls, o boto no ficar em ingls.

Olhando o HTML podemos ver tambm que poderiamos mudar a exibio do bloco, por exemplo, alterando o tamanho da caixa de busca. Para isso bastaria mudar o nmero size=14 que aparece na linha 2.

Para os que no esto 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 simulao de como o bloco ir exibir as informaes, e fazer as personalizaes mais facilmente no editor HTML. Lembrando que os modelos no so somente para os blocos. Navegando pela lista de modelos, veremos que cada mdulo tem uma dezena de modelos, todos com alguma especificidade. Lembre-se que a alterao de modelos depende de um bom conhecimento de HTML. E caso voc tenha alterado o modelo de forma tal que ele no est mais funcionando, e precisa recuperar o modelo original, use os modelos default, que como no sofrem alteraes, sempre estaro l intactos para serem usados novamente.

Comentrios O ltimo ponto da rea administrativa a ser comentdo a rea de comentrios. Nessa pgina voc ver todos os comentrios feitos em todas as reas do site. Ser possivel verificar, alterar e apagar comentrios, bem como bloquear e liberar eles (caso os comentrios necessitem aprovao, ser nessa pgina que voc deve desbloquear os comentrios 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 so 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 tambm na rea administrativa >> preferncias >> configuraes gerais, e na opo temas selecionveis, marcar todos os temas que quer testar. Aps escolher um tema que j lhe agrade bastante, voce poder mud-lo com o auxlio 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 alterao, envie novamente os arquivos para o site e veja as mudanas. Tambm 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 so diretamente proporcionais aos conhecimentos em trabalhar com HTML. Lembre-se somente que o tema tambm trabalha com variveis smarty (veja sobre elas em modelos), e que elas no devem ser alteradas.
71

CONCLUSO
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 fcil implementao. Este curso e material inicialmente so focados em atender s necessidades de pequenos grupos organizados, ONGs, associaes de bairros, para que estes possam ter seu espao na internet de forma prtica e barata. Obviamente espero que este material ajude tambm 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 percalos para continuar crescendo. A luta pelo direito comunicao e a comunicao popular digital precisam de comunidades como a do Xoops e do Software Livre. So essas comunidades e suas solues que geram os instrumentos perfeitos para a real incluso digital. Porque incluso digital no dar computadores aos que no tem, e sim dar voz e alcane atravs dos computadores aos que precisam.

72

AGRADECIMENTOS
A realizao desse curso no seria possvel sem o apoio da Associao Comunitria do Bairro Ellery, representados pelos companheiros Aguinaldo Aguiar e Clarice. Sem eles esse mundo tava perdido! Agradecemos tambm Prefeitura de Fortaleza, que com os recursos e apoio do Edital de Artes 2007 - Mdias Digitais, proporcionou a execuo desse projeto. Por fim dedico esse manual minha famlia e a minha noiva Maxmiria Holanda, que teve tanta pacincia de me aturar mergulhado em trabalho! Caca, te adoro! Daniel Almeida Chagas Novembro de 2008

Esta apostila parte integrante do curso Criao de Sites em Software Livre para Bairros, projeto premiado no Edital das Artes 2007 da Fundao 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 vrios sites de mbito pblico e privado, sendo a grande maioria deles com ferramentas de software livre Xoops. A Associao Comunitria do Bairro Ellery, entidade parceira no projeto, tem seu stio eletrnico www.bairroellery.com.br totalmente criado em Xoops, e visa repassar a tima experincia em software livre para outras comunidades e grupos que necessitem de um site. Esta apostila tem seus direitos garantidos pela licena Creative Commons do tipo Atribuio - Uso no-comercial. Maiores detalhes em www.creativecommons.org ou na pgina 4 desta apostila. Voc pode copiar e distribuir este material desde que seja dado o devido crdito ao autor e que a finalidade seja no-comercial.