1. INSTALAÇÃO

O conteúdo do arquivo Site_Imobiliar.zip deve ser descompactado no subdiretório desejado dentro da área de acesso do "web server" sendo utilizado. A estrutura obtida será a seguinte:

• Subdiretório "Fotos": Utilizado para armazenar as fotos dos imóveis para venda e locação no formato Jpeg. É atualizado automaticamente por FTP pelo Sistema Imobiliar, não necessitando qualquer alteração manual.
• Subdiretório "Lanctos": Utilizado para armazenar as imagens digitalizadas no formato Jpeg dos documentos de lançamentos. É atualizado automaticamente por FTP pelo Sistema Imobiliar, não necessitando qualquer alteração manual.
• Subdiretório "imagens": Possui os arquivos de imagens das páginas. Pode ser modificado e acrescentado arquivos pelo designer, com exceção dos arquivos "p.png" e "b.png" que devem permanecer inalterados e neste nome de subdiretório (são utilizados para gerar o código de barra nos DOCs).
• Subdiretório "imagens/logos": Possui os logotipos dos bancos para geração dos DOCs. Pode ser alterado desde que se mantenham as dimensões das figuras para evitar que o DOC gerado fique desproporcional.
• Subdiretório "prg": Contém todos os módulos PHP com a lógica de acesso aos dados exportados pelo Sistema Imobiliar. Nenhum arquivo pode ser alterado sob risco de perder compatibilidade com os dados.
• Subdiretório "prg/dados": Contém as diversas bases de dados atualizadas automaticamente por FTP pelo Sistema Imobiliar, não necessitando qualquer alteração manual. Os arquivos deste diretório são no formato texto, não sendo necessário nenhum banco de dados no provedor.
• Subdiretório "prg/modelos": Possui os arquivos "templates" das páginas dinâmicas que serão preechidas pelos módulos PHP. Estes arquivos, que possuem extensão "shtml", deverão ser remodelados pelo designer conforme o projeto visual da imobiliária.
• Arquivos "index.html" e "clionline.html": Estes arquivos deverão ser remodelados pelo designer conforme o projeto visual da imobiliária.

2. ALTERAÇÃO DAS PÁGINAS HTML

As páginas contidas em "prg/modelos" são utilizadas pelos módulos PHP como templates para a geração das páginas dinâmicas. Para isto, existem "tags de substituição" especiais que serão substituídas pelo PHP e que não devem ser removidas das páginas.

As "tags de substituição" para listas possuem um formato mais complexo como nos exemplos abaixo:

<!-- BEGIN DYNAMIC BLOCK: BAIRROS -->
              <option value="{BVALOR}">{BOPCAO}</option>
<!-- END DYNAMIC BLOCK: BAIRROS -->

<!-- BEGIN DYNAMIC BLOCK: IMOV_RES --> 
                  <tr bgcolor="#ffffff" border="0">
                    <td align="center" width="7%" height="20"><font
 face="Verdana, Arial, Helvetica, sans-serif" color="#000000" size="1"><small>{COD}</small></font></td>
                    <td align="center" width="15%" height="20"><font
 face="Verdana, Arial, Helvetica, sans-serif" color="#000000" size="1"><small>{BAIRRO}</small></font></td>
                    <td align="left" width="45%" height="20"><font
 face="Verdana, Arial, Helvetica, sans-serif" color="#000000" size="1"><small>&nbsp;{END}</small></font></td>
                    <td align="center" width="8%" height="20"><font
 face="Verdana, Arial, Helvetica, sans-serif" color="#000000" size="1"><small>{AREA}</small></font></td>
                    <td align="right" width="15%" height="20"><font
 face="Verdana, Arial, Helvetica, sans-serif" color="#000000" size="1"><small>{VAL}&nbsp;</small></font></td>
                    <td align="center" width="5%" height="20"><input
 type="image" height="20" src="{_SRC}" width="25" border="0"
 onclick="{_CLICK}" alt="{_ALT}"> </td>
                  </tr>
<!-- END DYNAMIC BLOCK: IMOV_RES -->

Vale ressaltar que as páginas podem ter sua estrutura de tags html totalmente remodelada, mas devem ser mantidas as "tags de substituição", destacadas em vermelho nos exemplos acima bem como os códigos em Javascript existentes.

3. CONFIGURAÇÃO

Juntamente com os módulos PHP na pasta "prg" existe o arquivo "config.inc-dist.php" que contém os parâmetros que configuram várias funcionalidades do site. Este arquivo deve ser renomeado (ou criada uma cópia) para "config.inc.php" e modificado conforme as características desejadas.

Os parâmetros deste arquivo de configuração são descritos na tabela a seguir:

3.1. SEGURANÇA DOS DADOS

É muito importante que os diretórios de dados não possuam permissão de navegação, ou seja, que nenhum arquivo nesses diretórios possa ser acessado diretamente por uma URL no navegador.

Por exemplo, no caso do servidor onde o site esteja hospedado utilize o Apache então basta utilizar arquivos .htaccess com as restrições desejadas (consulte manual do Apache para maiores detalhes).

Caso não seja possível restringir o acesso como descrito acima então sugere-se renomear a pasta de dados padrão para um nome diferente e conhecido apenas pela equipe de desenvolvimento. Outra sugestão é mover toda a estrutura de diretórios de dados para uma pasta inacessível por URL mas ainda possa ser acessada pelos scripts PHPs. Vale lembrar que qualquer mudança de nome de diretório deve ser devidamente informada no parâmetro de configuração correspondente.

4. TESTES DO SITE

Logo após a instalação o "esqueleto" do site deverá estar perfeitamente operacional, possuindo alguns dados básicos para fins de teste.

4.1. Para acessar o cliente on-line informe o número 18971 para login e senha.

LOGIN: SENHA:

O resultado deste login deve apresentar uma página com conteúdo similar ao seguinte:

Cada um dos botões da tela acima irá exibir as telas correspondentes para Extrato e Demonstrativo de Proprietário, Extrato de Condomínio e DOCs. No caso de não ser exibido algum dos botões acima, entre em contato para revalidar os dados pois existe uma expiração dos dados após decorrer 3 meses da sua geração.

4.2. Para testes da pesquisa de locação acompanha uma pequena quantidade de dados apenas para a cidade de Porto Alegre. Existem duas opções de telas de pesquisa conforme apresentado no index.html.

4.2.1. Pesquisa de Imóveis de Locação ou Venda (tela única)

4.2.2. Pesquisa de Imóveis de Locação ou Venda (duas telas: cidade+busca)

Existe apenas um imóvel com foto que é acessado com as seguintes características de pesquisa:

PESQUISA DE IMOVEIS

Tipo de Imóvel: Apartamento -->BoxCasa Resid. -->Cobertura -->Estacion. Resid.FlatGarag. Resid.JKLoft -->LoteOutros Resid.Sobrado -->Telefone Resid.Terreno   Nº Dormitórios: 1234 Bairro:(use a tecla control+click do mouse para marcar vários bairros para a pesquisa) - QUALQUER BAIRRO -ABERTA DOS MORROSAGRONOMIAANCHIETAARQUIPELAGOAUXILIADORAAZENHABELA VISTABELEM NOVOBELEM VELHOBOA VISTABOM FIMBOM JESUSCAMAQUACASCATACAVALHADACENTROCHACARA DAS PEDRASCHAPEU DO SOLCIDADE BAIXACORONEL APARICIO BORGESCRISTALCRISTO REDENTORESPIRITO SANTOFARRAPOSFARROUPILHAFLORESTAGLORIAGUARUJAHIGIENOPOLISHIPICAHUMAITAINDEPENDENCIAIPANEMAJARDIM BOTANICOJARDIM CARVALHOJARDIM DO SALSOJARDIM FLORESTAJARDIM ITU SABARAJARDIM LINDOIAJARDIM SAO PEDROLAGEADOLAMILOMBA DO PINHEIROMARCILIO DIASMARIO QUINTANAMEDIANEIRAMENINO DEUSMOINHOS DE VENTOMONT SERRATNAVEGANTESNONOAINOSSA SENHORA DAS GRACASPARTENONPASSO D'AREIAPASSO DAS PEDRASPEDRA REDONDAPETROPOLISPONTA GROSSAPRAIA DE BELASPROTASIO ALVESRESTINGARIO BRANCORUBEM BERTASANTA CECILIASANTA MARIA GORETTISANTA TEREZASANTANASANTO ANTONIOSAO GERALDOSAO JOAOSAO JOSESAO SEBASTIAOSARANDISERRARIATERESOPOLISTRES FIGUEIRASTRISTEZAVILA ASSUNCAOVILA CONCEICAOVILA INTERCAPVILA IPIRANGAVILA JARDIMVILA JOAO PESSOAVILA NOVA Faixa de Preço: De: R$  ,00 a R$  ,00

Se ficar decidido o uso deste formato de duas telas então devem ser utilizados os modelos "cidadeloc.shtml", "busca.shtml", "cidadevenda.shtml" e "buscavenda.shtml", sendo descartados os modelos "pesqImovLoc.shtml" e "pesqImovVenda.shtml".

4.2.3. O resultado da pesquisa de uma casa residencial de 4 dormitórios no bairro Agronomia em Porto Alegre deve apresentar o seguinte:

Foram encontrados os seguintes imóveis que se enquadram na sua pesquisa:

PORTO ALEGRE : Casa Resid. 4 Dormitório(s)    Codigo Bairro Endereço Área(m2) Aluguel   13742 AGRONOMIA  R TOCANTINS, 869/20- COND. FECHADO. 440.00 3265.00

Ao clicar na imagem da máquina fotográfica que fica na última coluna da lista será exibida uma janela com as fotos e características do imóvel. Quando não houver fotos associadas ao imóvel será exibida a imagem .

4.3. As demais pesquisas e acessos para teste podem ser realizados sem restrições ou senhas.