Obtendo a �ltima vers�o do programaRetornar ao topo

Lan�amentos, atualiza��es�e novidades sobre o Pindorama estar�o sempre dispon�veis na URL:

http://sourceforge.net/projects/pindorama/�

De posse do arquivo compactado (.zip ou .tar.gz) com a �ltima distribui��o do programa, � poss�vel fazer a instala��o em menos de 5 minutos.

Pr�-requisitosRetornar ao topo

Apesar do Pindorama ter rodado ate mesmo em servidores IIS, � recomendado o uso do servidor Web Apache, pela sua estabilidade e recursos de mapeamento de arquivos virtuais.

Tamb�m � necess�rio�ter habilitado o suporte � linguagem de programa��o PHP, ves�o 4.x (o Pindorama ainda n�o � compat�vel com a vers�o�5.x e 3.x), com os seguintes m�dulos instalados (al�m da configura��o default:

  • XML (utilizando o Expat)
  • Iconv
  • XSLT (utilizando o Sablotron)
  • Curl

Para evitar problemas entre o PHP e outras instru��es de processamento XML, � recomendado desativar a diretriz: short_open_tag

Tamb�m, como o Pindorama trata muitos cabe�alhos HTTP nativamente, � recomendado n�o utilizar qualquer modelo de armazenamento e tratamento dos resultados dos scripts, como: output buffers etc.

Instala��oRetornar ao topo

Primeiro descompacte estes arquivos em algum lugar, como /caminhopara/pindorama, e modifique as permiss�es dentro da pasta /pindorama/var/ para permitir que o usu�rio do servidor Web possa escrever e modificar arquivos e pastas (no Linux/Unix, utilize o comando chmod com a m�scara 666 para arquivos e 777 para diret�rios).

Voc� deve ter o servidor Web e PHP instalado (como m�dulo, n�o como CGI-BIN), com as seguintes bibliotecas no PHP: XSLT (com o sablotron), Curl e Iconv.

O Pindorama fica melhor quando possui um virtual host dedicado para ele, masele pode ser instalado como uma subpasta de seu dom�nio.

Instalando o Pindorama em um novo virtual host (Apache)

Escreva a seguinte diretriz na se��o do virtual host a ser destacado para o Pindorama

AliasMatch /.* /caminhopara/pindorama/active/index.php

(Re)Inicie o servidor e pronto. Ao acessar este dom�nio, o Pindorama voc� dever� ver a p�gina inicial do website Pindorama, com a barra de edi��o de conte�do ao topo.

Instalando o Pindorama em uma subpasta de seu dom�nio

Com a instala��o do Pindorama descompactada fora da raiz de seu website, crie uma pasta dentro da raiz do website para o Pindorama (como /htdocs/admin/) e copie o arquivo /caminhopara/pindorama/copy-this.index.php para esta pasta.

Com um editor de texto, edite o conte�do deste arquivo, atualizando os valores de $_SERVER["pindorama_base"] com o caminho completo para a pasta do Pindorama e $_SERVER["pindorama_url"] com a URL da subpasta do Pindorama em seu dom�nio.

Acesse esta URL e voc� dever� ter acesso � p�gina de entrada do website do Pindorama, com a barra de edi��o ao alto.

Senha do administrador do sistema

Caso voc� utilize a autentica��o HTTP para controlar as permiss�es dos usu�rios, uma tela de login dever� aparecer ao primeiro acesso do Pindorama. Por default, utilize:

Login: admin

Senha: admin1234

Acesse a p�gina de administra��o de usu�rios para atualizar a sua senha o quanto antes (em Usu�rios > Alterar login e informa��es dos usu�rios).

Configura��oRetornar ao topo

Atualizando as informa��es em /pindorama/etc/config/core.php, � poss�vel ajustar todas as prefer�ncias do website ou aplica��o a ser gerenciado pelo Pindorama.

Conceitos b�sicosRetornar ao topo

O conceito da ferramenta � simples, ela mant�m no ambiente de desenvolvimento uma c�pia do website que � gerada dinamicamente, atrav�s de transforma��es XSL. Ela utiliza uma base de dados em XML mas tamb�m acessa dados externos, e possui um sistema de templates para melhor apresentar estas informa��es.

As informa��es no Pindorama podem ser de duas formas: documentos e �ndices. Documentos s�o p�ginas isoladas de informa��o, que podem ter uma URL designada e estarem associados hierarquicamente (estrutura de informa��es). Cada arquivo do site � um documento, sejam p�ginas HTML, imagens, folhas de estilo CSS etc. Os documentos podem ser acessados a partir da interface do pindorama (utilizando a op��o Abrir este documento ou colocando um sufixo ".dav" na URL completa da p�gina (por exemplo, a p�gina inicial do website http://localhost/ pode ser acessada no pindorama atrav�s da URL http://localhost/index.html.dav).

�ndices s�o como tabelas de informa��o, por�m em XML (possuem uma estrutura mais sofisticada que uma tabela cartesiana) e s�o utilizados para associar informa��es. Os �ndices tamb�m podem ter URLs designadas e terem sua visualiza��o pr�pria, mas dependem de regras especificas nos templates para tanto.

Estrutura de diret�rios do PindoramaRetornar ao topo

A estrutura de diret�rios do Pindorama foi estabelecida de forma a separar o c�digo-fonte do programa, das configura��es personalizadas do site e dos arquivos gerenciados pelo servidor.

Assim, a distribui��o do Pindorama fica restrita � pasta /pindorama/active/, tendo como subestrutura a seguinte:

  • /active
  • /active/components��(componentes e m�dulos)
  • /active/config� (configura��o b�sica do programa (n�o deve ser alterada!)
  • /active/docs��(documenta��o)
  • /active/stylesheets� (arquivos XSL de transforma��o da interface do Pindorama e de atualiza��o das informa��es)

As configura��es do site, em /etc, definem o comportamento do website, assim
como configura��es peculiares a cada distribui��o:

  • /etc
  • /etc/config��(configura��es do site — podem ser editadas)
  • /etc/includes��(arquivos que podem ser inclu�dos pelas transforma��es XSLT)
  • /etc/templates��(templates de apresenta��o do pindorama)

e em /var, os arquivos que s�o escritos pelo servidor (� bom colocar estes arquivos com chmod 666 para arquivos e 777 para diret�rios)

  • /var
  • /var/db� (banco de dados das p�ginas em XML)
  • /var/index��(bd dos �ndices em XML)
  • /var/log��(logs da ferramenta)
  • /var/public��(local default para os arquivos publicados)
  • /var/users��(informa��es sobre premiss�es dos usu�rios —�para aumentar a seguran�a, estes arquivos podem ser restritos ao usu�rio� do Apache)
  • /var/webcache��(cache das p�ginas geradas pelo Pindorama)
  • /var/www���(arquivos a serem apresentados diretamente pelo Pindorama)