Português

do Brasil

So Liv
B

ftw re
ai w
xe w
gr w.x

ar
at o
ui op
Guia de

e
ta s

* te e
m .o
en rg
Instalação e Uso

m
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é e-
commerce, dentre outros.

Versão 2.3RELEASE 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.

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

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 07
Introdução 08
Porque eu preciso de um CMS 09
Software Livre e Licença GPL 12
Hospedagem 13
Criando um endereço 14
endreço internacional 18
tecnologias de site 19
espaço e transferência 21
Dados de Hospedagem 23
FTP - File Transfer Protocol 25
Instalando o servidor e banco de dados 30
Servidor Windwos com XAMPP 30
Servidor Linux com OpenSUSE 33
Servidor na Internet 37
Instalando o Xoops 39
Configurando o Xoops 44
Preferências - Config. Gerais 45
Preferências - Config. Usuários 49
Preferências - Meta dados e Rodape 50
Preferências - Palavras censuradas 50
Preferências - Opções de Pesquisa 50
Preferências - Configuração de e-mail 51
Banners 52
Blocos 53
Grupos 61
Imagens 62
Módulos 63
Emoticons 66
Posições de usuários 66
Editar usuários 66
Procurar usuários 66
Contactar usuários 66
Modelos ou templates 67
Comentários 68
Personalizando o Xoops 69
Conclusão 70
Agradecimentos 71

06
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 FONTES IMAGENS TEXTOS

INDEX
10
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ódigo-
fonte é 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 a-

cesso 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
VISITANTE DIGITA
TRANSMITE AS INFORMAÇÕES
NOSSO ENDEREÇO
PARA O VISITANTE

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

VISITANTE HOSPEDAGEM

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 Empresas agrícolas, fazendas
AM.BR Empresas de radiodifusão sonora
ART.BR Artes: música, pintura, folclore
EDU.BR Entidades de ensino superior
COM.BR Comércio em geral
COOP.BR Cooperativas
ESP.BR Esporte em geral
FAR.BR Farmácias e drogarias
FM.BR Empresas de radiodifusão sonora
G12.BR Entidades de ensino de primeiro e segundo grau
GOV.BR Entidades do governo federal
IMB.BR Imobiliárias
IND.BR Industrias
INF.BR Meios de informação (rádios, jornais, bibliotecas, etc..)
MIL.BR Forças Armadas Brasileiras
NET.BR 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
ORG.BR Entidades não governamentais sem fins lucrativos
PSI.BR Provedores de serviço Internet
REC.BR Atividades de entretenimento, diversão, jogos, etc...
SRV.BR Empresas prestadoras de serviços
TMP.BR Eventos temporários, como feiras e exposições
TUR.BR Entidades da área de turismo
TV.BR Empresas de radiodifusão de sons e imagens
ETC.BR Entidades que não se enquadram nas outras categorias

15
 Domínios para Profissionais Liberais (Necessita CPF)
ADM.BR Administradores
ADV.BR Advogados
ARQ.BR Arquitetos
ATO.BR Atores
BIO.BR Biólogos
BMD.BR Biomédicos
CIM.BR Corretores
CNG.BR Cenógrafos
CNT.BR Contadores
ECN.BR Economistas
ENG.BR Engenheiros
ETI.BR Especialista em Tecnologia da Informação
FND.BR Fonoaudiólogos
FOT.BR Fotógrafos
FST.BR Fisioterapeutas
GGF.BR Geógrafos
JOR.BR Jornalistas
LEL.BR Leiloeiros
MAT.BR Matemáticos e Estatísticos
MED.BR Médicos
MUS.BR Músicos
NOT.BR Notários
NTR.BR Nutricionistas
ODO.BR Dentistas
PPG.BR Publicitários e profissionais da área de propaganda e marketing
PRO.BR Professores
PSC.BR Psicólogos
QSL.BR Rádio amadores
SLG.BR Sociólogos
TRD.BR Tradutores
VET.BR Veterinários
ZLG.BR Zoólogos

Domínios para Pessoa Física (Necessita CPF)

BLOG.BR Web logs
FLOG.BR Foto logs
NOM.BR Pessoas Físicas
VLOG.BR Vídeo logs
WIKI.BR 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 Empresas
.Net Empresas de internet
.Org Organizações
.Info De informações
.Biz Contração de Business (negócios)
.Cc Sigla de Credit Card (Cartão de Crédito)
.Tv Televisão
.Nu ?
.Ws ?

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: CD Power Comércio

Login: cdpower
Senha: t5y7u8
FTP: ftp.cdpower.com
Cpanel: 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 Na hora de criação do endereço

criação do pode-se deixar em branco as
endereço informações do DNS por enquanto

Escolha das A escolha da tecnologia do site irá

tecnologias influenciar na escolha da hospedagem:
do site Tecnologias diferentes têm preços diferentes.

Pesquisa de
Hospedagem

Fechar contrato
de hospedagem

Voltar ao site Após a entrada do endereço DNS,

de registro do é normal uma demora de 24 a 48 horas
endereço e para que o site esteja pronto para
digitar o DNS ser acessado e para se copiar os arquivos.

Acesar via FTP Acesar o painel Acesar o painel

e começar a de controle de controle
enviar os e criar os e criar as bases
arquivos e-mails de dados (Dbs)

24
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) Baixar compactado Atualizar

Sair
Desconectar Resuming Modo de
(recomenda-se transferência
Bookmark manter ligado) (não mudar)
Lista de Endereços

* 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 inter-
net: 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: site@seusite.com).
wNome do remetente: O nome que constará no cabeçalho dos e-
mails 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 men-
sagem 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 centro-
esquerda 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 corretamen-
te as opções inferiores. Certifique-se de que seu tema
mostra corretamente as opções inferiores.

57
 Cabeçalho

Bloco Esquerda
Exemplo de site tipo padrão comercial Módulo
com menus e blocos à esquerda.

Bloco inferior central

Rodapé
Cabeçalho
Bloco Direita

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 Módulo
há o menu principal. O tema deve ter todos
os links do menu principal já gravados.
Bloco inferior central

Rodapé

Cabeçalho
Bloco Esquerda

Exemplo de site com lateral esquerda

Módulo em destaque.

Bloco inferior central

58
 Os blocos podem ser gerados Alguns blocos podem não
tanto pelo Xoops (menu principal, ser visualizados por determi-
busca)quanto por módulos (tipo nados tipos de usuários do
mini-calendário, votação). site. Por exemplo: As votações
Selecione aqui que blocos deseja podem não estar disponíveis
ver para configurar. para os visitantes. Nessa caixa
é possível ver que blocos estão
ligados para que tipo de usuário.
Mostra a configuração dos Filtro de visualização para
blocos de acordo com a mostrar somente os blocos
página. Ex: Para ver que visíveis ou não. Facilita
blocos estão ligados na para se ter certeza de
página de notícias, selecione quais blocos estão
notícias aqui. realmente ligados.

Bloco Personalizado 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
Incluir link Vídeos YouTube

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 Peque-
nas (com limites no tamanho e na largura e altura), ima-
gens 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 possibili-

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

gem 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 funci-
one 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 proble-
mas 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 apare-
cerã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
 Define que é centralizado

Define um formulário tipo get que joga os resultados para a página 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>

Variável Smarty que mostra o caminho do site Xoops

Variável Smarty que define o que deve ser escrito
no link de pesquisa avançada
Variável Smarty que define o que deve ser escrito

69
dentro do botão de pesquisa

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

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.
Esta página está propositalmente impressa de lado para facilitar ver os códigos

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