Commit 2ce25ea0fa3089b1e63664a833c9edc76ee13a25

Authored by Edmar Moretti
1 parent badcba4f

Criado guia demigração para aversão 4.1

Showing 1 changed file with 98 additions and 0 deletions   Show diff stats
guia_migracao_41.txt 0 → 100644
... ... @@ -0,0 +1,98 @@
  1 +Guia de migração do i3Geo para a versão 4.1
  2 +
  3 +Sistema de administração
  4 +
  5 + A administração do i3geo pode ser feita através de um sistema de formulários desde que vc opte por isso.
  6 +
  7 + Se vc quiser continuar usando os arquivos XML existentes em i3geo/menutemas, não tem problema, mas nesse
  8 + caso o sistema de administração não lhe será útil.
  9 +
  10 + A opção pelo uso do sistema de administração é default na versão 4.1. Se vc não quiser usá-la, deverá
  11 + editar o arquivo i3geo/ms_configura.php e colocar os nomes dos arquivos XML nas opções desejadas. Esse
  12 + arquivo está documentado, basta ler para entender o que deve ser feito.
  13 +
  14 + O sistema de administração é acessível no endereço i3geo/admin (http://localhost/i3geo/admin). Apenas editores
  15 + cadastrados podem usar esse sistema. O cadastramento é feito por número IP (veja i3geo/ms_configura.php).
  16 + Por default, "localhost" é um editor cadastrado.
  17 +
  18 + Os arquivos mapfiles existentes em i3geo/temas continuam sendo necessários e vc pode editá-los manualmente
  19 + ou por meio do sistema de administração.
  20 +
  21 + Os arquivos XML que vc já possuí em i3geo/menutemas devem ser importados para o sistema de administração.
  22 + Utilize as opções existentes em i3geo/admin para fazer isso.
  23 +
  24 + O banco de dados default do i3geo é em SQLITE e fica em i3geo/menutemas/admin.db.
  25 + Vc deve apagar esse arquivo e criar outro antes de importar seus arquivos XML. No sistema de administração
  26 + existe uma opção para criar o banco, o que deve ser feito depois que vc apagar o arquivo que vai com o i3geo.
  27 +
  28 + Se vc não quiser usar o SQLITE vc deve criar um arquivo de conexão com seu banco de dados e registrar o endereço
  29 + desse arquivo em uma variável no i3geo/ms_configura.php. Um exemplo de arquivo de configuração para POSTGRE
  30 + pode ser visto em i3geo/admin/php/conexaomm.php. AO usar a opção de criação do banco existente no sistema
  31 + de administração, as tabelas serão criadas no banco de dados indicado.
  32 +
  33 +PHP
  34 +
  35 + O sistema de administração do i3geo é baseado na biblioteca PHP chamada "PDO". Nas versões mais recentes do
  36 + PHP e no MS4W essa biblioteca já vem habilitada. Se no seu PHP não existir o PDO vc deverá instalá-lo.
  37 +
  38 +YAHOO
  39 +
  40 + A bibblioteca do YAHOO (YUI) foi atualizada. A versão antiga continua em i3geo/pacotes. Se vc desenvolveu
  41 + programas baseados na versão antiga, é bom verificar se tudo funcionará corretamente pois o arquivo
  42 + i3geo/classesjs/i3geo.js agora utiliza essa nova versão da YUI.
  43 +
  44 +JSOBJECTS
  45 +
  46 + Essa biblioteca não será mais utilizada pelo i3geo, sendo substituída pelo YUI. Se vc utilizava as funcionalidades
  47 + dessa biblioteca, embutida no i3geo.js, deverá verificar seu código ou então embutir novamente essa
  48 + biblioteca no i3geo.js. Para isso vc deve alterar o programa i3geo/classesjs/compactajs.php e executá-lo
  49 + para gerar os arquivos compactados do i3geo.
  50 +
  51 +Classes JS e namespaces
  52 +
  53 + O modelo de desenvolvimento dos programas javascript estão sendo migrados aos poucos para estruturas
  54 + baseadas em classes. Isso facilitará a compreensão dos códigos e sua documentação, facilitando a vida
  55 + dos desenvolvedores e permitindo uma melhor evolução dos códigos.
  56 +
  57 + As classes desenvolvidas ficarão em arquivos únicos de cada classe e devem usar onamespace i3GEO. Essa
  58 + regra evitará conflitos entre bibliotecas javascript adicionadas ao i3geo.
  59 + Exemplo, para remover a acentuação de uma palavra vc pode usar a classe i3GEO.util:
  60 +
  61 + var palavraAcentuada = "coração";
  62 + var palavraSemAcento = i3GEO.util.removeAcentos(palavraAcentuada);
  63 +
  64 +Googlemapas
  65 +
  66 + A chave de registro da API do Google agora deve ser incluída no arquivo i3geo/ms_configura.php na
  67 + variável $googleApiKey.
  68 +
  69 + Isso foi necessário por que a API do Google será utilizada em outras ferramentas do i3geo.
  70 +
  71 + A ferramenta googlemaps agora é chamada com ferramentas/googlemaps/index.php e seu tamanho
  72 + é calculado automaticamente conforme asproporções do mapa aberto no i3geo
  73 +
  74 +Idiomas
  75 +
  76 + A lista de palavras e suas traduções foram retiradas do arquivo i3geo/classesjs/configura.js e incluidas no
  77 + novo arquivo i3geo/classesjs/dicionario.js
  78 +
  79 + Foi criada uma classe específicapara manipular a internacionalização. Veja a documentação em
  80 + http://localhost/i3geo/documentacao/files/classesjs/classe_idioma-js.html
  81 +
  82 +Árvore de temas
  83 +
  84 + A árvore de temas, que aparece na guia "Adiciona", agora é montada com a biblioteca YUI. Foi criada uma classe
  85 + javascript específica para manipular essa árvore. Veja a documentação em
  86 + http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredecamadas-js.html
  87 + Os aplicativos que usam árvores também utilizam agora essa classe, como o i3geo/datadownload.htm
  88 +
  89 +Árvore de camadas
  90 +
  91 + A árvore de camadas, que aparece na guia "Temas", agora é montada com a biblioteca YUI. Foi criada uma classe
  92 + javascript específica para manipular essa árvore. Veja a documentação em
  93 + http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredetemas-js.html
  94 +
  95 +Utilitários
  96 +
  97 + Foi criada uma classe específica com funções de uso geral. Veja em:
  98 + http://localhost/i3geo/documentacao/files/classesjs/classe_util-js.html
0 99 \ No newline at end of file
... ...