Obtendo a última versão do programa

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é-requisitos

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ção

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ção

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ásicos

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 Pindorama

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)