1

TUTORIAL DE MAMBO

Desenvolvendo Portais Elegantes com Facilidade

Ribamar FS, ribafs@yahoo.com, 18 de julho de 2005

 2

ÍNDICE

1 – Introdução . 3
2 – Instalação .. 4
2.1 – Servidor web doméstico for Windows: .4
2.2 – Passos para a instalação . 5
2.3 – Telas da instalação - Dependências . 6
2.3- Dependências - 2 . 7
2.4 – Dados do servidor web, do banco e diretório do mambo. 8
2.5 – Nome do Site (título da página) . 9
2.6 – Dados finais . 10
2.7 - Login e Senha de acesso à seção de administração. 10
2.8 – Dados para acesso . 11
2.9 – Remoção do diretório Instalation . 12
3 - ADMINISTRAÇÃO DO MAMBO . 13
3.1 - Seção de Administração . 13
3.2 - Menu geral do site (frente) . 14
3.3 - Menu Administração . 14
3.4 - Menu Conteúdo . 14
3.5 - Menu de Componentes . 15
3.6 - Menu de Módulos . 15
3.7 - Menu de Mambots . 15
3.8 - Menu de Instaladores . 15
4 - PERSONALIZANDO UM PORTAL GERADO . 16
4.1 - TELAS FRONTEND (FRENTE) . 16
4.1.1 - Item de menu de um Blog . 17
4.1.2 - Item de menu das Notícias . 18
4.1.3 - Seção de Perguntas e Respostas . 18
5 - PERSONALIZAÇÃO VIA FRONTEND. 19
6 - PERSONALIZAÇÃO MANUAL . 19
7 - PERSONALIZANDO VIA BACKAND (Admin) . 19
7.1 - Alterando um Banner . 20
7.2 - Adicionar/Remover um Módulo . 20
7.3 - Adicionar/Remover um Mambot . 21
7.4 - Adicionar/Remover um Componente . 21
7.5 - Adicionar/Remover um Template (Temas). 21
7.6 - Adicionar/Remover um Item de Menu/Conteúdo. 21
8 - ERROS . 22
Apêndice A - Configurar Apache, PHP e MySQL . 23
Apêndice B . 25
Offline Administrator . 25
PopUp Login Box . 26
Apêndice C - Mambo Links . 30
Apêndice D - Relação de pastas e arquivos da versão 5.4.2.1 Pt_Br . 33
 3

1 - INTRODUÇÃO

O Mambo é um Sistema Gerenciador de Conteúdo inteiramente em PHP, que colabora com

a construção de portais web profissionais.

Sistema Gerenciador de Conteúdo é um sistema sofisticado que já traz um grande esqueleto

prontinho. O Mambo traz mais que um esqueleto, traz um protótipo funcional.

Sua maior compatibilidade com o sistema windows é com o XP (ou nts-like).

Pelas minhas pesquisas com vários SGC open source, o meu preferido é o mambo: open
source, muitos recursos prontos, design e especialmente sua praticidade tanto para o
administrador quanto para o seu cliente.

Se gostar deste tutorial, procure por atualizações, pois sendo meu primeiro tutorial e como
estou mexendo atualmente com Mambo, o atualizo com frequência.

Recomendação: evite o uso da última versão do Mambo logo no seu lançamento, por
falta de suporte (templates, módulos, etc).
Esta recomendação é somente para instalações de teste, avaliação, pois versões antigas
têm falhas de segurança, por isso não são oferecidas nos sites sérios.

Para tópicos avançados veja os Apêndices.

 4

2 - INSTALAÇÃO
2.1 – Servidor web doméstico for Windows:

Para quem quer instalar localmente Apache, PHP, MySQL sem qualquer sacrifício no
Windows temos várias opções, como o PHPEasy e o PHPTriad.

Basta procurar no Google (o PHPtriad fica no SFNet) e fazer o download.

Após instalar do executável já está tudo prontinho: Apache, PHP e MySQL

- Então vá até o item criado PHPTriad, subitem Apache Console, start apache
- e MySQL execute o daemon do seu sistema para ter o apache e mysql rodando.
- Caso queira os programas acima rodando ao iniciar basta copiar para o menu iniciar.

Então abra no browser http://localhost/mambo/

Instalação detalhada escolhendo as versões atuais de cada programa, vide Apêndices.

Hospedagem Grátis – A melhor que conheço (até o momento) e2u:

O http://www.e2uhosting.com/, com as seguintes características:

Webspace 1 GB
Bandwidth 9 GB
PHP 5 support
MySQL support
FTP access
Instant account activation
Domain and sub-domain hosting
Weekly backups
99.9% uptime
Support forums
100% free

Para criar uma conta, accesse o site acima, clique na imagem

(http://www.e2uhosting.com/signup.php), preencha o cadastro, confirme o e-mail recebido
e logo em seguida verifique os dados no segundo e-mail (instant activation). Agora veja que
poderá usar FTP (melhor opção de envio do Mambo: descompacte num diretório e envie
todos os arquivos locais para um diretório remoto (ex.: portal)).
Antes de instalar o Mambo neste host, faça o login (http://www.e2uhosting.com/login.php)
e Create DB para ter o banco disponível.

Caso não esteja satisfeito com a hospedagem acima, procure outra Free aqui:
http://www.free-webhosts.com/webhosting-01.php
 5

2.2 – Passos para a instalação

- Download – Site brasileiro do Mambo (http://www.mambobrasil.org/)
- Baixe sempre a última versão (4.5.2.3Br hoje – 18/06/2005).
- Contrate um espaço web (servidor de hospedagem- WebHosting) ou local
- Envie o arquivo baixado (confira o tamanho baixado) via FTP
- Se localmente copie para o c:\apache\htdocs e aí crie a pasta \portal, descompactando
dentro dela os arquivos do mambo.
- Abrir a url que contém o mambo: http://meusite/portal/ ou http://localhost/portal/
ou http://127.0.0.1/portal/ Este último quando a máquina está sob um domínio.
 6

2.3 – Telas de Instalação

Dependências

Quando teremos as duas telas abaixo. Elas trazem as dependências do Mambo e se seu
sistemas as atendeu. Caso as preferências vitais sejam atendidas clique em Próximo.
 7

2.3- Dependências - 2
 8

2.4 – Dados do servidor web e do banco

Marcar Eliminar as tabelas existentes, somente se for o caso, pois não é default.
 9

2.5 – Nome do Site (título da página)

 10

2.6 – Dados finais

Recomendação: troque a senha.

 11

2.7 - Login e Senha de acesso à seção de administração

A tela abaixo é em sistemas Linux, onde precisamos salvar o conteúdo selecionado e

sobrescrever o arquivo deconfiguração.
 12

2.8 – Dados para acesso

Lembre de remover o diretório de instalação (obrigatório) e em servidor Linux salve o texto

selecionado do arquivo configuration.php.
 13

2.9 – Remoção do diretório Instalation

Alerta,caso ainda não haja removido.

Com isso acabamos de instalar e temos um protótipo de portal com quase todo o básico de
um portal.
 14

3 - ADMINISTRAÇÃO DO MAMBO
(BackEnd)

Agora vamos ver alguns detalhes básicos sobre a administração do Mambo:

Acesse .../admin e faça login.

3.1 - Seção de Administração

Com menus, botões centrais e Abas a direita.

 15

3.2 - Menu geral do site (frente)

3.3 - Menu Administração

Clique em administra menu para administrar todos os menus.
Clique em cada um dos tios para acessá-lo.

3.4 - Menu Conteúdo

Aqui gerenciamos os itens com conteúdo.
 16

3.5 - Menu de Componentes

Componentes alteram a estrutura do Mambo com add-ins.

3.6 - Menu de Módulos

Módulos trabalham junto ou isolados dos Componentes adicionando a estrutura do Mambo.

3.7 - Menu de Mambots

Outro componente que transforma a estrutura do Mambo. Os editores são exemplos.

3.8 - Menu de Instaladores

 17

4 - PERSONALIZANDO UM PORTAL GERADO

4.1 - TELAS FRONTEND (FRENTE)

Veja que temos uma tela index composta de muita coisa: logomarca, banners, frames,
enquete, contato, etc.

Tema padrão de um portal recém-instalado.

 18

Veja abaixo alguns dos itens

4.1.1 - Item de menu de um Blog.

 19

4.1.2 - Item de menu das Notícias

Da a cesso a várias notícias.
Grande fonte de conteúdo do portal, podendo ser adaptados para este fim.

4.1.3 - Seção de Perguntas e Respostas

 20

5 - PERSONALIZAÇÃO VIA FRONTEND

Alterando um item

Abra o site de entrada (http://localhost/Mambo/) e faça login como usuário admin ou outro
criado.

Após fazer o login aparece um lápis ao lado de cada título editável.

Vamos alterar apenas o título do artigo Welcome to Mambo para Bem-vindo ao Mambo.

Clique no lápis e altere o conteúdo.

Após alterar clique no disquete para salva o conteúdo alterado.

A grande vantagem deste método é a praticidade, mas não tem todos os recursos que a
seção Admin.

6 - PERSONALIZAÇÃO MANUAL

Alterando a Logomarca

Esta somente podemos alterar via manualmente, mas assim mesmo sem grande trabalho.

Clicar sobre a imagem do logo (Solar Flare II) com o botão direito, salvar pano de fundo de
fundo como e salvar no disco. Editar e enviar para a pasta template de imagens:

/portal/templates/rhuk_solarflare_ii/images/

7 - PERSONALIZANDO VIA BACKAND (Admin)

Faça login pela seção admin (http://localhost/Mambo/admin/)

Vamos alterar o mesmo acima.

- Menu – Conteúdo – Todos os itens de conteúdo

- Clique em Bem-vindo ao Mambo e altere para Bem-Vindo ao Mambo
- Clique no disquete para salvar
 21

7.1 - Alterando um Banner

Este tem suporte via Admin:

- Menu – Componentes – Banner – Administrar Banner

- Clicar no banner desejado e alterar.
- Após as alterações clicar no disquete para armazenar.

Veja que para usar uma nova imagem antes já deverá a ter enviado para a pasta de imagens
do Banner, que então aparecerá na relação.

7.2 - Adicionar/Remover um Módulo

Obs.: É bom ter sempre uma janela com o frontend e outra com o lado backend.

Remover:

Acessar a seção Admin e

Módulos – Módulos do site

Basta clicar no ícone Publicar para publicar/despublicaar.

Observe que existem mais de 10 itens e precisa exibir os restantes abaixo, se for o caso.
Enquete, por exemplo, basta despublicar para que não mais apareça na página de entrada.
Quando despublicado o ícone fica um X vermelho.
Observe que vários módulos vem marcados ou desmarcados por default.

Os demais (Componentes, Mambots, etc) são similares em comportamento.

Adicionar:

Módulos – Instalar/Desinstalar

Em Pacote de arquivos clicar em Procurar e indicar o arquivo do módulo:

(aqui indiquei veerse_day ecliquei em Upload Arquivo & Instalar).

Após instalar basta ir na relação de módulos instalados e personalizar, se precisar.

Vá até a seção de entrada e dê um refresh para ver o novomódulo.

Obs.: módulos são elementos independentes. Ao serem instalados basta publicar para que
sejam exibidos no frontend.
 22

7.3 - Adicionar/Remover um Mambot

Fica apenasdo lado do adminisrador.

Mambots – Instalar/Desinstalar

Semelhante ao módulo, indiquei o editor HTMLArea3XTDv11RC1.zip e instalei.

Este é o meu editor preferido. Instale e veja se gosta.

7.4 - Adicionar/Remover um Componente

Vamos instalar o MamboXplorer, uma excelente ferramenta do admin.

Componentes – Instalar/Remover
Instalar de maneira semelhante aos demais.

Obs.: componentes são elementos que normalmente dependem de um módulo para

aparecerem no frontend. Ao instalar devemos instalar também seu módulo correspondente e
publicar para que seja exibido.

7.5 - Adicionar/Remover um Template (Temas)

Aqui uma força do Mambo: poder trocar o template do site e até permitir ao usuário que
escolha um entre alguns selecionados.

Site – Administrar Temas – Instalar

Instalar de maneira semelhante aos anteriores.

7.6 - Adicionar/Remover um Item de Menu/Conteúdo

Para adicionar um item de menu, obrigatoriamente antes adicionamos um item de conteúdo

ou outro da lista.
- Primeiro crie um item de conteúdo – Conteúdo – Todos os itens de conteúdo.
- Clique no botão Novo
- Digite o título
- Digite o aliás (nome para referência)
- Insira o conteúdo: texto, imagem, link,etc.

O item de menu associado a um de conteúdo formam o uso básico do Mambo.

 23

8 - ERROS
Ao encontrar o erro 2 ao acessar o site, o mysqld deve estar fora.
 24

Apêndice A

Preservando caminhos diferentes e serviços startados adequadamente podemos com esta

receita ter duas versões de servidor web rodando numa mesma máquina,

Instalar Apache 3.x,

PHP 5.x,
MySQL 4.x ou superiores, exceto apache que deve respeitar a linha 3.x.

Configurar Apache

Após instalar edite o arquivo "...\conf\httpd.conf"

Alterar: DirectoryIndex index.html

Para: DirectoryIndex index.php index.html

Adicione ao final:
# De acordo com as intruções do arquivo "install.txt" do PHP:
# Apache como modulo no PHP 5
ScriptAlias /php/ "c:/php/"
AddType application/x-httpd-php .php
Action application/x-httpd-php "/php/php-cgi.exe"
LoadModule php5_module "c:/php/php5apache.dll"
# specify the directory where php.ini is
SetEnv PHPRC C:/php

Configuração PHP

Recomendação. Baixe e descompacte a versão no formato zip (por ser mais completa) no
diretório c:\php (sugestão):

Faça uma cópia do arquivo "php.ini-recommended" que se encontra no raiz do

php para "php.ini" e configure o arquivo php.ini alterando:

Comente esta linha: error_reporting = E_ALL

Adicionando um ; em seu início e Descomente esta:
;error_reporting = E_ALL & ~E_NOTICE, Removendo o ;
Altere também a linha "display_errors = On" Para Off ao colocar o site em produção por
conta da segurança.

Altere:
;include_path = ".;c:\php\include"
Descomentando a linha de baixo (include_path). Para ficar assim:
include_path = ".;c:/php
 25

Altere esta: doc_root =

Para: doc_root = c:/www

Altere esta: extension_dir = "./"

Para: extension_dir = "c:\php\ext"

Descomenta as linhas:
;extension=php_mysql.dll,
Para dar suporte ao mysql

Altere a linha: ;session.save_path = "/tmp"

Descomentando e mudando o diretório:
session.save_path = "c:\windows\temp" ou "c:\winnt\temp"

Em tempo de desenvolvimento é uma boa ajuda para os desenvolvedores:

display_errors = On

Opcionalmente:

magic_quotes_gpc = On

Copiar as DLLs "libmysql.dll" e "php5ts.dll" do diretório do PHP para:

c:\windown\system32 (ou correspondente do seu sistema).

Para ter as variáveis globais registradas sete: register_globals = On

Copiar o php.ini para o c:\windows

Restartar o Apache

Configuração do MySQL

- Instale no diretório c:\mysql

- A versão mysql-4.1.11-win32.exe está muito boa, especialmente nos nts-like.
Instale como serviço. Ao terminar estará tudo pronto e o serviço no ar.

Terstando:
Crie um arquivo “c:\www\teste.php” com apenas a linha abaixo:
<?php phpinfo(); ?>

Abra no browser com a seguinte URL: http://localhost/teste.php ou

http://127.0.0.1/teste.php
 26

Apêndice B

Offline Administrator

De Andy Stewart <andy@troozers.com> - (http://www.troozers.com/)

Possibilita que o administrador veja o site, este estando offline.

Faça backup dos arquivos antes de editar.

1) Edite o arquivo ../administrator/index2.php adicionando as linhas abaixo

após a linha 22, após esta linha:

session_name( "troozers" );
session_start();
$_SESSION['admin_user'] = "Y";
session_write_close();

2) Edite o arquivo index.php do raiz do Mambo e faça as alterações sugeridas abaixo:

Após a linha 20 deve ficar assim. Veja que foram adicionadas 3 linhas e à linha
do If foi adicionado "&& ! $ok_to_browse".

include_once( 'globals.php' );
require_once( 'configuration.php' );

// Aqui abaixo
session_name( "troozers" );
session_start();

$ok_to_browse = ( $_SESSION['admin_user'] == "Y" );

// Até aqui

// displays offline page

if ( $mosConfig_offline == 1 && ! $ok_to_browse ){

Tradução e adaptação de Ribamar FS - ribafs.org - ribafs@ribafs.org - 28/04/2005

 27

PopUp Login Box

De Andy Stewart <andy@troozers.com> - (http://www.troozers.com/)

Editando o template para inserir o código de um formulário muito elegante

para login dos usuários, veja um exemplo no site http://acaosp.ribafs.org

Faça backup dos arquivos antes de editar.

1) Abrir a index.php e editar adicionando a função em javascript entre as tags <head>

e </head> como a seguir:

<?php defined( "_VALID_MOS" ) or die( "Direct Access to this location is not allowed." );
$iso = split( '=', _ISO );echo '<?xml version="1.0" encoding="'. $iso[1] .'"?' .'>';?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<!--Adicionei para o loginpopup -->
<script language="javascript">
function toggleBox(szDivID, iState) // 1 visible, 0 hidden
{
if(document.layers) // NN4
{
document.layers[szDivID].visibility = iState ? "show" : "hide";
}
else if(document.getElementById) // gecko(NN6) + IE5+
{
var obj = document.getElementById(szDivID);
obj.style.visibility = iState ? "visible" : "hidden";
}
else if(document.all) //IE 4
{
document.all[szDivID].style.visibility = iState ? "visible" : "hidden";
}
}
</script>
<!--Final loginpopup -->

2) Na tag <body> adicionar a div que exibirá/ocultará o form:

<body>

<!-- INÍCIO: ocultar layer login box -->

 28

<div id="LoginBox">
<table>
<tr>
<td colspan="2">
<table cellpadding="0" cellspacing="0" class="moduletable">
<tr>
<th valign="top">
Formulário de Login </th>
</tr>
<tr>
<td>
<form action="http://acaosp.ribafs.org/" method="post" name="login" >
<table width="100%" border="0" cellspacing="0" cellpadding="0" align="center">
<tr>
<td>
Nome de Unuário<br />
<input name="username" type="text" class="inputbox" alt="Login" size="10" />
<br />
Senha <br />
<input type="password" name="passwd" class="inputbox" size="10" alt="Senha" />
<br />
<input type="checkbox" name="remember" class="inputbox" value="yes" alt="Lembrar
Senha" />
Lembrar Senha<br />
<input type="hidden" name="option" value="login" />
<input type="submit" name="Submit" class="button" value="Login" />
</td>
</tr>
<tr>
<td>
<a
href="http://acaosp.ribafs.org/index.php?option=com_registration&amp;task=lostPassword
">
Esqueceu sua senha </a>
</td>
<td>
Sem Conta?<a
href="http://acaosp.ribafs.org/index.php?option=com_registration&task=register">
Crie uma</a>
</td>
</tr>
</table>
<input type="hidden" name="op2" value="login" />
<input type="hidden" name="lang" value="english" />
<input type="hidden" name="return" value="http://acaosp.ribafs.org/index.php?" />
<input type="hidden" name="message" value="0" />
</form>
 29

</td>
</tr>
</table>
</td>
</tr>
<tr>
<td width="50%" align="center">
<a href="#" onClick="toggleBox('LoginBox',0); return false;">
<img src="images/cancel_f2.png" width="20" height="20" border="0" alt="Fechar" />
</a>
</td>
</tr>
</table>
</div>
<!-- FINAL: ocultar layer login box -->

3) O link com a chave:

...
<table width="100%" border="0" align="center" cellpadding="0" cellspacing="0">
<tr>
<td valign="top" style="padding-left:8px; background-repeat: repeat-y;"
background="<?php echo $mosConfig_live_site;?>/templates/247portal-b-
blue/images/shadowl.jpg">&nbsp;</td>
<td valign="top" style="background-repeat: repeat-y;"background="<?php echo
$mosConfig_live_site;?>/templates/247portal-b-blue/images/lb.gif"><?php if
(mosCountModules('left')) { ?>
<div class="leftrow">
<?php mosLoadModules ( 'left' ); ?>
</div>

<?php } ?></td>
<td valign="top" bgcolor="#FAFAFA" width="100%"><div class"main">
<table width="100%" border="0" cellspacing="0" cellpadding="0">
<tr valign="top" bgcolor="#F1F1F1">
<?php if (mosCountModules('top')) { ?><td colspan="3" style="border-top: 3px
solid #FFFFFF;">
<div>
<?php mosLoadModules ( 'top' ); ?>
</div>
</td><?php } ?>
</tr>

<!-- Início - Adicionei o link aqui -->

<tr>
<td width="117" valign="top">
 30

<div align="left" style="z-index:2;">

<a href="#" onClick="toggleBox('LoginBox',1); return false;">
<img src="/templates/247portal-b-blue/images/chave.png" width="75" height="25"
border="0" alt="password" />
</a>
</div>
</td>
</tr>
<!-- Final - Adicionei o link aqui -->

Observe que o que existe acima de "<!-- Início - Adicionei o link aqui -->" até os ... já
existe na index.php
do template, adicionei apenas o que existe abaixo.

4) Acesse o sub-diretório css do template e edite o arquivo template_css.css, adicionando as

linhas abaixo
ao final:

#LoginBox {
position: absolute;
top: 0px;
left: 0px;
width: 200px;
visibility: hidden;
border: 1px solid;
background-color: #ffffff;
}

Tradução e adaptação de Ribamar FS - ribafs.org - ribafs@ribafs.org - 28/04/2005

 31

Apêndice C

Mambo Links
• allmambo.com Tutorials Guides, for M.O.S. Community
• Back-End CMS Home
• Content Management - Content Management Tutorial
• Daibert.net Portal System - Download Profile Tarefas
• Danial Taherzadeh
• Drupal.org
• FrontPage
• GemDoc - Create Html Help, Html, Pdf, Html and Other Formats From a Single
File! Convert Html To Pdf,Text, and PostScript! Process DocBook in Windows!
• help.mambo - Administrator
• Home - AlikonWeb
• Home - Konze Webdesign
• Home - MAMBO HUT Mambo Templates Showcase
• Home - MamboPros - O mambo levado a sério
• Home - MAMBOTEAM - Best free Mambo Templates - Mambo Template Design
• Interspire - Free web templates, Frontpage and Dreamweaver Templates
• Interspire - SiteCenter Private Label Website Builder (PHP)
• Jason Murphy
• Kontact Homepage - Supported Groupware Servers
• Main Page - Wikibooks
• Mambest - Main Page - All Sites
• Mambo - A PHP & MySQL Content Management System - Administration
Questions
• Mambo Brasil - Comunidade dos Usuários do Portal Mambo Open Source no Brasil
• Mambo Content Management System
• Mambo Forum- A PHP & MySQL Content Management System
• MAMBO HUT Mambo Templates Showcase
• Mambo Template Tutorial Absalom Media
• Mambo template tutorial The Complete Guide to Mambo templates using
Dreamweaver and MSAS
• Mambo Templates - Free templates for Mambo Open Source
• Mambo Templates Club
• Mambo Templates Designers Web Page Templates and Themes
• Mambo Tutorial Center
• Mambo Tutorials
• Mambo Websites, Website Design Peterborough, Mambo Tutorials
• MamboForgeSoftware Templates
• mambo-phpShop A Free e.commerce Component For Mambo - Home
• Mamboportal.com - A Mambo Open Source CMS Fansite
 32

• MamboPT - Comunidade Portuguesa de Mambo OS

• Mamboserver.com - Home
• MamboSolutions mambo templates, mambo modules, mambo components, MSAS,
dreamweaver Mambo extension flash mambo
• MAMBOTEAM - Best free Mambo Templates - Mambo Template Design
• MamboWiki Home Page
• MOS-Chat
• Phil Taylor Mambo Components - Write Components(3)
• PhpWiki - HomePage
• PhpWiki - SourceForge.net Project
• PhpWiki WikiWikiWeb HomePage
• scotweb.com - putting the e into your business - Home
• The CMS Matrix - cmsmatrix.org - The Content Management Comparison Tool
• Troozers Learns To Mambo - Home
• Tutorialcenter
• Wiki Welcome Visitors
• Wikilivros
• [enomaly] our focus, your content mambo

Links gerados automaticamente do Favoritos pelo Favepage - FavePage

 33

Apêndice D

Relação de pastas e arquivos da versão 5.4.2.1 Pt_Br:

34
35
36
37