1

TUTORIAL DE MAMBO
Desenvolvendo Portais Elegantes com Facilidade

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

2

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

Sign up to vote on this title
UsefulNot useful