tutorial de mambo em português
Post on 07-Jun-2015
2.501 Views
Preview:
DESCRIPTION
TRANSCRIPT
TUTORIAL DE MAMBO
Desenvolvendo Portais Elegantes com Facilidade
Ribamar FS, ribafs@yahoo.com, 18 de julho de 2005
1
ÍNDICE
1 – Introdução . 32 – Instalação .. 4
2.1 – Servidor web doméstico for Windows: .42.2 – Passos para a instalação . 52.3 – Telas da instalação - Dependências . 62.3- Dependências - 2 . 72.4 – Dados do servidor web, do banco e diretório do mambo. 82.5 – Nome do Site (título da página) . 92.6 – Dados finais . 102.7 - Login e Senha de acesso à seção de administração. 102.8 – Dados para acesso . 112.9 – Remoção do diretório Instalation . 12
3 - ADMINISTRAÇÃO DO MAMBO . 133.1 - Seção de Administração . 133.2 - Menu geral do site (frente) . 143.3 - Menu Administração . 143.4 - Menu Conteúdo . 143.5 - Menu de Componentes . 153.6 - Menu de Módulos . 153.7 - Menu de Mambots . 153.8 - Menu de Instaladores . 15
4 - PERSONALIZANDO UM PORTAL GERADO . 164.1 - TELAS FRONTEND (FRENTE) . 164.1.1 - Item de menu de um Blog . 174.1.2 - Item de menu das Notícias . 184.1.3 - Seção de Perguntas e Respostas . 18
5 - PERSONALIZAÇÃO VIA FRONTEND. 196 - PERSONALIZAÇÃO MANUAL . 197 - PERSONALIZANDO VIA BACKAND (Admin) . 19
7.1 - Alterando um Banner . 207.2 - Adicionar/Remover um Módulo . 207.3 - Adicionar/Remover um Mambot . 217.4 - Adicionar/Remover um Componente . 217.5 - Adicionar/Remover um Template (Temas). 217.6 - Adicionar/Remover um Item de Menu/Conteúdo. 21
8 - ERROS . 22Apêndice A - Configurar Apache, PHP e MySQL . 23Apêndice B . 25
Offline Administrator . 25PopUp Login Box . 26
Apêndice C - Mambo Links . 30Apêndice D - Relação de pastas e arquivos da versão 5.4.2.1 Pt_Br . 33
2
1 - INTRODUÇÃO
O Mambo é um Sistema Gerenciador de Conteúdo inteiramente em PHP, que colabora coma construção de portais web profissionais.
Sistema Gerenciador de Conteúdo é um sistema sofisticado que já traz um grande esqueletoprontinho. 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: opensource, muitos recursos prontos, design e especialmente sua praticidade tanto para oadministrador quanto para o seu cliente.
Se gostar deste tutorial, procure por atualizações, pois sendo meu primeiro tutorial e comoestou 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, porfalta de suporte (templates, módulos, etc). Esta recomendação é somente para instalações de teste, avaliação, pois versões antigastê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.
3
2 - INSTALAÇÃO
2.1 – Servidor web doméstico for Windows:
Para quem quer instalar localmente Apache, PHP, MySQL sem qualquer sacrifício noWindows 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 recebidoe logo em seguida verifique os dados no segundo e-mail (instant activation). Agora veja quepoderá usar FTP (melhor opção de envio do Mambo: descompacte num diretório e envietodos 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
4
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.
5
2.3 – Telas de Instalação
Dependências
Quando teremos as duas telas abaixo. Elas trazem as dependências do Mambo e se seusistemas as atendeu. Caso as preferências vitais sejam atendidas clique em Próximo.
6
2.3- Dependências - 2
7
2.4 – Dados do servidor web e do banco
Marcar Eliminar as tabelas existentes, somente se for o caso, pois não é default.
8
2.5 – Nome do Site (título da página)
9
2.6 – Dados finais
Recomendação: troque a senha.
10
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 esobrescrever o arquivo deconfiguração.
11
2.8 – Dados para acesso
Lembre de remover o diretório de instalação (obrigatório) e em servidor Linux salve o textoselecionado do arquivo configuration.php.
12
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 deum portal.
13
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.
14
3.2 - Menu geral do site (frente)
3.3 - Menu AdministraçãoClique em administra menu para administrar todos os menus.Clique em cada um dos tios para acessá-lo.
3.4 - Menu ConteúdoAqui gerenciamos os itens com conteúdo.
15
3.5 - Menu de ComponentesComponentes alteram a estrutura do Mambo com add-ins.
3.6 - Menu de MódulosMó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
16
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.
17
Veja abaixo alguns dos itens
4.1.1 - Item de menu de um Blog.
18
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
19
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 outrocriado.
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 aseçã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 defundo 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
20
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 imagensdo 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 quesejam exibidos no frontend.
21
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/RemoverInstalar de maneira semelhante aos demais.
Obs.: componentes são elementos que normalmente dependem de um módulo paraaparecerem no frontend. Ao instalar devemos instalar também seu módulo correspondente epublicar 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 queescolha 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údoou 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.
22
8 - ERROS
Ao encontrar o erro 2 ao acessar o site, o mysqld deve estar fora.
23
Apêndice A
Preservando caminhos diferentes e serviços startados adequadamente podemos com estareceita 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.htmlPara: 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 5ScriptAlias /php/ "c:/php/"AddType application/x-httpd-php .phpAction application/x-httpd-php "/php/php-cgi.exe"LoadModule php5_module "c:/php/php5apache.dll"# specify the directory where php.ini isSetEnv PHPRC C:/php
Configuração PHP
Recomendação. Baixe e descompacte a versão no formato zip (por ser mais completa) nodiretó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_ALLAdicionando 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 porconta da segurança.
Altere: ;include_path = ".;c:\php\include"Descomentando a linha de baixo (include_path). Para ficar assim:include_path = ".;c:/php
24
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:\windowsRestartar 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 ouhttp://127.0.0.1/teste.php
25
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 abaixoapó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 à linhado If foi adicionado "&& ! $ok_to_browse".
include_once( 'globals.php' ); require_once( 'configuration.php' );
// Aqui abaixosession_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
26
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 elegantepara 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 -->
27
<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="LembrarSenha" /> Lembrar Senha<br /><input type="hidden" name="option" value="login" /><input type="submit" name="Submit" class="button" value="Login" /></td></tr><tr><td><ahref="http://acaosp.ribafs.org/index.php?option=com_registration&task=lostPassword">Esqueceu sua senha </a></td><td>Sem Conta?<ahref="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>
28
</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"> </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: 3pxsolid #FFFFFF;"> <div> <?php mosLoadModules ( 'top' ); ?> </div> </td><?php } ?> </tr>
<!-- Início - Adicionei o link aqui --><tr> <td width="117" valign="top">
29
<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.phpdo template, adicionei apenas o que existe abaixo.
4) Acesse o sub-diretório css do template e edite o arquivo template_css.css, adicionando aslinhas abaixoao 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
30
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
31
• 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
32
Apêndice D
Relação de pastas e arquivos da versão 5.4.2.1 Pt_Br:
33
34
35
36
37
top related