diff --git a/guia_de_migracao.md b/guia_de_migracao.md index 7b6b1c6..e01f59a 100755 --- a/guia_de_migracao.md +++ b/guia_de_migracao.md @@ -169,215 +169,215 @@ i3GEO.arvoreDeTemas.OPCOESADICIONAIS.navegacaoDir = false; ## Para a versão 4.5 - Os arquivos com as interfaces HTML dos diferentes mapas do i3Geo foram movidos do diretório - i3geo/aplicmap para o diretório i3geo/interface. Caso existam links apontando diretamente para - esses arquivos, vc pode simplesmente copiar os arquivos existentes na nova pasta (i3geo/interface) - para a antiga (i3geo/aplicmap). +Os arquivos com as interfaces HTML dos diferentes mapas do i3Geo foram movidos do diretório +i3geo/aplicmap para o diretório i3geo/interface. Caso existam links apontando diretamente para +esses arquivos, vc pode simplesmente copiar os arquivos existentes na nova pasta (i3geo/interface) +para a antiga (i3geo/aplicmap). - As variáveis de configuração $temasdir e $temasaplic foram removidas. Se vc desenvolveu programas em PHP, - no lugar dessas variáveis utilize $locaplic e o local fixo dos arquivos, por exemplo $locaplic."/temas" - e $locaplic."/aplicmap" +As variáveis de configuração $temasdir e $temasaplic foram removidas. Se vc desenvolveu programas em PHP, +no lugar dessas variáveis utilize $locaplic e o local fixo dos arquivos, por exemplo $locaplic."/temas" +e $locaplic."/aplicmap" - A opção de administração com base em arquivos XML em disco foi removida. Agora, deve-se sempre utilizar o banco de dados - de admnistração. +A opção de administração com base em arquivos XML em disco foi removida. Agora, deve-se sempre utilizar o banco de dados +de admnistração. - O banco de dados de administração sofreu alterações. Veja em "Outras opções", no sistema de admnistração. +O banco de dados de administração sofreu alterações. Veja em "Outras opções", no sistema de admnistração. - O arquivo admin.db (banco de dados de admnistração default) foi movido de i3geo/menutemas para i3geo/admin +O arquivo admin.db (banco de dados de admnistração default) foi movido de i3geo/menutemas para i3geo/admin - O "alias" para a interface "zerocal" foi removido, utilize em seu lugar: - http://localhost/i3geo/ms_criamapa.php?interface=zerocal.htm ou - http://localhost/i3geo/interface/zerocal.htm +O "alias" para a interface "zerocal" foi removido, utilize em seu lugar: +http://localhost/i3geo/ms_criamapa.php?interface=zerocal.htm ou +http://localhost/i3geo/interface/zerocal.htm - A pasta "images" foi removida e as imagens movidas para a pasta "imagens\depreciado" +A pasta "images" foi removida e as imagens movidas para a pasta "imagens\depreciado" - Opção de comentários em temas - Foram acrescentadas novas variáveis em ms_configura.php. Veja esse arquivo para editar as variáveis e registrar - as APIs das redes sociais como Twitter e Facebook - Por default, todos os temas agora podem receber comentários. Para bloquear comentários em temas específicos, - utilize o editor de mapfiles do sistema de admnistração para bloquear essa opção em cada tema - Os comentários são armazenados em uma tabela no banco de dados de administração. Essa tabela precisa ser criada no banco. - Para criar a tabela veja o item "Outras opções" em http://localhost/i3geo/admin +Opção de comentários em temas + Foram acrescentadas novas variáveis em ms_configura.php. Veja esse arquivo para editar as variáveis e registrar + as APIs das redes sociais como Twitter e Facebook + Por default, todos os temas agora podem receber comentários. Para bloquear comentários em temas específicos, + utilize o editor de mapfiles do sistema de admnistração para bloquear essa opção em cada tema + Os comentários são armazenados em uma tabela no banco de dados de administração. Essa tabela precisa ser criada no banco. + Para criar a tabela veja o item "Outras opções" em http://localhost/i3geo/admin - Contagem do número de acessos de cada tema - Foi criada uma nova tabela no sistema de administração para guardar o número de vezes que um tema é acessado. Antes - a contagem era mantida na tabela i3geoadmin_temas, cuja coluna nacessos foi depreciada. Essa nova tabela guarda também o dia do acesso. - Para criar a tabela veja o item "Outras opções" em http://localhost/i3geo/admin +Contagem do número de acessos de cada tema + Foi criada uma nova tabela no sistema de administração para guardar o número de vezes que um tema é acessado. Antes + a contagem era mantida na tabela i3geoadmin_temas, cuja coluna nacessos foi depreciada. Essa nova tabela guarda também o dia do acesso. + Para criar a tabela veja o item "Outras opções" em http://localhost/i3geo/admin - O nome dos arquivos js e ccs compactados foram renomeados, incluindo o valor da versão no final. Isso foi feito para se - evitar problemas de cache de versões antigas. Os arquivos renomeados foram: - classesjs/i3geo_tudo_compacto45.js - css/i3geo_ferramentas45.css +O nome dos arquivos js e ccs compactados foram renomeados, incluindo o valor da versão no final. Isso foi feito para se +evitar problemas de cache de versões antigas. Os arquivos renomeados foram: + classesjs/i3geo_tudo_compacto45.js + css/i3geo_ferramentas45.css - Testado o uso de zlib.output_compression = On no php.ini +Testado o uso de zlib.output_compression = On no php.ini - Variáveis ou funções removidas - i3GEO.interface (utilize i3GEO.Interface, com "I" maiúsculo) - g_postpx - g_tipotop - g_tipoleft +Variáveis ou funções removidas + i3GEO.interface (utilize i3GEO.Interface, com "I" maiúsculo) + g_postpx + g_tipotop + g_tipoleft - A inicialização da interface Google Earth (interface/googleearth.phtml) foi incluida na tag "body": - +A inicialização da interface Google Earth (interface/googleearth.phtml) foi incluida na tag "body": + - e-mail institucional (incluido no arquivo de correções SP7) - em ms_configura.php pode ser definido um e-mail padrão que é utilizado nas interfaces dos mapas - Para que o e-mail definido seja mostrado, é necessário adicionar um elemento HTML com id=emailInstituicao no mapa +e-mail institucional (incluido no arquivo de correções SP7) + em ms_configura.php pode ser definido um e-mail padrão que é utilizado nas interfaces dos mapas + Para que o e-mail definido seja mostrado, é necessário adicionar um elemento HTML com id=emailInstituicao no mapa ## Para a versão 4.4 - Verifique se o PHP está configurado (php.ini) para permitir a passagem de parâmetros por referência - (dependendo da versão do PHP, esse parâmetro é definido como "Off" por default): - allow_call_time_pass_reference = On +Verifique se o PHP está configurado (php.ini) para permitir a passagem de parâmetros por referência +(dependendo da versão do PHP, esse parâmetro é definido como "Off" por default): +allow_call_time_pass_reference = On - Foi acrescentado um novo LAYER em i3geo/aplicmp/geral1.map e geral1windows.map com dados do Open Street Map. Caso vc não - queira que essa camada nova apareça, basta removê-las desses arquivos. +Foi acrescentado um novo LAYER em i3geo/aplicmp/geral1.map e geral1windows.map com dados do Open Street Map. Caso vc não +queira que essa camada nova apareça, basta removê-las desses arquivos. - Foi incluida a remoção de cookies no ms_criamapa.php, que inicializa o i3geo ($_COOKIE = array();). Se vc precisa definir cookies, - considere a necessidade de comentar a linha de código do ms_criamapa.php. +Foi incluida a remoção de cookies no ms_criamapa.php, que inicializa o i3geo ($_COOKIE = array();). Se vc precisa definir cookies, +considere a necessidade de comentar a linha de código do ms_criamapa.php. - Por default, o i3Geo passou a usar a interface openlayers.htm. Se vc quiser modificar isso, altere o ms_configura.php. +Por default, o i3Geo passou a usar a interface openlayers.htm. Se vc quiser modificar isso, altere o ms_configura.php. ## Para a versão 4.3 - O banco de dados de administração sofreu as seguintes alterações (vc deve incluir as novas colunas - para que o i3Geo funcione corretamente: +O banco de dados de administração sofreu as seguintes alterações (vc deve incluir as novas colunas +para que o i3Geo funcione corretamente: - - acréscimo das colunas en,es,it nas tabelas (tipo texto) - i3geoadmin_menus - i3geoadmin_temas - i3geoadmin_grupos - i3geoadmin_subgrupos +- acréscimo das colunas en,es,it nas tabelas (tipo texto) + i3geoadmin_menus + i3geoadmin_temas + i3geoadmin_grupos + i3geoadmin_subgrupos - - acréscimo da coluna kmz_tema em i3geoadmin_temas (tipo texto) +- acréscimo da coluna kmz_tema em i3geoadmin_temas (tipo texto) - Foi incluida uma nova opção que permite ao usuário alterar o SQL que faz o acesso aos dados em - um LAYER (elemento DATA do mapfile). Mostrar ou não essa opção é controlado por um metadata - em cada LAYER. Por default, o i3Geo entende que esse metadata é marcado como SIM. Se vc não quer - que o usuário possa acessar essa funcionalidade, utilize o sistema de administração para editar - esse metadata de cada LAYER presente em um mapfile ou então, inclua o metadata "editorsql" "nao". +Foi incluida uma nova opção que permite ao usuário alterar o SQL que faz o acesso aos dados em +um LAYER (elemento DATA do mapfile). Mostrar ou não essa opção é controlado por um metadata +em cada LAYER. Por default, o i3Geo entende que esse metadata é marcado como SIM. Se vc não quer +que o usuário possa acessar essa funcionalidade, utilize o sistema de administração para editar +esse metadata de cada LAYER presente em um mapfile ou então, inclua o metadata "editorsql" "nao". ## Para a versão 4.1 Sistema de administração - A administração do i3geo pode ser feita através de um sistema de formulários web desde que vc opte por isso. +A administração do i3geo pode ser feita através de um sistema de formulários web desde que vc opte por isso. - Se vc quiser continuar usando os arquivos XML existentes em i3geo/menutemas, não tem problema, mas nesse - caso o sistema de administração não lhe será útil. +Se vc quiser continuar usando os arquivos XML existentes em i3geo/menutemas, não tem problema, mas nesse +caso o sistema de administração não lhe será útil. - A opção pelo uso do sistema de administração é default na versão 4.1. Se vc não quiser usá-la, deverá - editar o arquivo i3geo/ms_configura.php e colocar os nomes dos arquivos XML nas opções desejadas. Esse - arquivo está documentado, basta ler para entender o que deve ser feito. +A opção pelo uso do sistema de administração é default na versão 4.1. Se vc não quiser usá-la, deverá +editar o arquivo i3geo/ms_configura.php e colocar os nomes dos arquivos XML nas opções desejadas. Esse +arquivo está documentado, basta ler para entender o que deve ser feito. - O sistema de administração é acessível no endereço i3geo/admin (http://localhost/i3geo/admin). Apenas editores - cadastrados podem usar esse sistema. O cadastramento é feito por número IP (veja i3geo/ms_configura.php). - Por default, "localhost" é um editor cadastrado. +O sistema de administração é acessível no endereço i3geo/admin (http://localhost/i3geo/admin). Apenas editores +cadastrados podem usar esse sistema. O cadastramento é feito por número IP (veja i3geo/ms_configura.php). +Por default, "localhost" é um editor cadastrado. - Os arquivos mapfiles existentes em i3geo/temas continuam sendo necessários e vc pode editá-los manualmente - ou por meio do sistema de administração. +Os arquivos mapfiles existentes em i3geo/temas continuam sendo necessários e vc pode editá-los manualmente +ou por meio do sistema de administração. - Os arquivos XML que vc já possuí em i3geo/menutemas devem ser importados para o sistema de administração. - Utilize as opções existentes em i3geo/admin para fazer isso. +Os arquivos XML que vc já possuí em i3geo/menutemas devem ser importados para o sistema de administração. +Utilize as opções existentes em i3geo/admin para fazer isso. - O banco de dados default do i3geo é em SQLITE e fica em i3geo/menutemas/admin.db. - Vc deve apagar esse arquivo e criar outro antes de importar seus arquivos XML. No sistema de administração - existe uma opção para criar o banco, o que deve ser feito depois que vc apagar o arquivo que vai com o i3geo. +O banco de dados default do i3geo é em SQLITE e fica em i3geo/menutemas/admin.db. +Vc deve apagar esse arquivo e criar outro antes de importar seus arquivos XML. No sistema de administração +existe uma opção para criar o banco, o que deve ser feito depois que vc apagar o arquivo que vai com o i3geo. - 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 - desse arquivo em uma variável no i3geo/ms_configura.php. Um exemplo de arquivo de configuração para POSTGRE - pode ser visto em i3geo/admin/php/conexaomm.php. Ao usar a opção de criação do banco existente no sistema - de administração, as tabelas serão criadas no banco de dados indicado. +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 +desse arquivo em uma variável no i3geo/ms_configura.php. Um exemplo de arquivo de configuração para POSTGRE +pode ser visto em i3geo/admin/php/conexaomm.php. Ao usar a opção de criação do banco existente no sistema +de administração, as tabelas serão criadas no banco de dados indicado. PHP - O sistema de administração do i3geo é baseado na biblioteca PHP chamada "PDO". Nas versões mais recentes do - PHP e no MS4W essa biblioteca já vem habilitada. Se no seu PHP não existir o PDO vc deverá instalá-lo. +O sistema de administração do i3geo é baseado na biblioteca PHP chamada "PDO". Nas versões mais recentes do +PHP e no MS4W essa biblioteca já vem habilitada. Se no seu PHP não existir o PDO vc deverá instalá-lo. YAHOO - A bibblioteca do YAHOO (YUI) foi atualizada. A versão antiga continua em i3geo/pacotes. Se vc desenvolveu - programas baseados na versão antiga, é bom verificar se tudo funcionará corretamente pois o arquivo - i3geo/classesjs/i3geo.js agora utiliza essa nova versão da YUI. +A bibblioteca do YAHOO (YUI) foi atualizada. A versão antiga continua em i3geo/pacotes. Se vc desenvolveu +programas baseados na versão antiga, é bom verificar se tudo funcionará corretamente pois o arquivo +i3geo/classesjs/i3geo.js agora utiliza essa nova versão da YUI. JSOBJECTS - Essa biblioteca não será mais utilizada pelo i3geo, sendo substituída pelo YUI. Se vc utilizava as funcionalidades - dessa biblioteca, embutida no i3geo.js, deverá verificar seu código ou então embutir novamente essa - biblioteca no i3geo.js. Para isso vc deve alterar o programa i3geo/classesjs/compactajs.php e executá-lo - para gerar os arquivos compactados do i3geo. +Essa biblioteca não será mais utilizada pelo i3geo, sendo substituída pelo YUI. Se vc utilizava as funcionalidades +dessa biblioteca, embutida no i3geo.js, deverá verificar seu código ou então embutir novamente essa +biblioteca no i3geo.js. Para isso vc deve alterar o programa i3geo/classesjs/compactajs.php e executá-lo +para gerar os arquivos compactados do i3geo. Classes JS e namespaces - O modelo de desenvolvimento dos programas javascript estão sendo migrados aos poucos para estruturas - baseadas em classes. Isso facilitará a compreensão dos códigos e sua documentação, facilitando a vida - dos desenvolvedores e permitindo uma melhor evolução dos códigos. +O modelo de desenvolvimento dos programas javascript estão sendo migrados aos poucos para estruturas +baseadas em classes. Isso facilitará a compreensão dos códigos e sua documentação, facilitando a vida +dos desenvolvedores e permitindo uma melhor evolução dos códigos. - As classes desenvolvidas ficarão em arquivos únicos de cada classe e devem usar o namespace i3GEO. Essa - regra evitará conflitos entre bibliotecas javascript adicionadas ao i3geo. - Exemplo, para remover a acentuação de uma palavra vc pode usar a classe i3GEO.util: +As classes desenvolvidas ficarão em arquivos únicos de cada classe e devem usar o namespace i3GEO. Essa +regra evitará conflitos entre bibliotecas javascript adicionadas ao i3geo. +Exemplo, para remover a acentuação de uma palavra vc pode usar a classe i3GEO.util: - var palavraAcentuada = "coração"; - var palavraSemAcento = i3GEO.util.removeAcentos(palavraAcentuada); +var palavraAcentuada = "coração"; +var palavraSemAcento = i3GEO.util.removeAcentos(palavraAcentuada); Googlemaps - A chave de registro da API do Google agora deve ser incluída no arquivo i3geo/ms_configura.php na - variável $googleApiKey. +A chave de registro da API do Google agora deve ser incluída no arquivo i3geo/ms_configura.php na +variável $googleApiKey. - Isso foi necessário porque a API do Google será utilizada em outras ferramentas do i3geo. +Isso foi necessário porque a API do Google será utilizada em outras ferramentas do i3geo. - A ferramenta googlemaps agora é chamada com ferramentas/googlemaps/index.php +A ferramenta googlemaps agora é chamada com ferramentas/googlemaps/index.php Idiomas - A lista de palavras e suas traduções foram retiradas do arquivo i3geo/classesjs/configura.js e incluidas no - novo arquivo i3geo/classesjs/dicionario.js +A lista de palavras e suas traduções foram retiradas do arquivo i3geo/classesjs/configura.js e incluidas no +novo arquivo i3geo/classesjs/dicionario.js - Foi criada uma classe específica para manipular a internacionalização. Veja a documentação em - http://localhost/i3geo/documentacao/files/classesjs/classe_idioma-js.html +Foi criada uma classe específica para manipular a internacionalização. Veja a documentação em +http://localhost/i3geo/documentacao/files/classesjs/classe_idioma-js.html Árvore de temas - A árvore de temas, que aparece na guia "Mapa", agora é montada com a biblioteca YUI. Foi criada uma classe - javascript específica para manipular essa árvore. Veja a documentação em - http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredecamadas-js.html - Os aplicativos que usam árvores também utilizam agora essa classe, como o i3geo/datadownload.htm +A árvore de temas, que aparece na guia "Mapa", agora é montada com a biblioteca YUI. Foi criada uma classe +javascript específica para manipular essa árvore. Veja a documentação em +http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredecamadas-js.html +Os aplicativos que usam árvores também utilizam agora essa classe, como o i3geo/datadownload.htm Árvore de camadas - A árvore de camadas, que aparece na guia "+ temas", agora é montada com a biblioteca YUI. Foi criada uma classe - javascript específica para manipular essa árvore. Veja a documentação em - http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredetemas-js.html +A árvore de camadas, que aparece na guia "+ temas", agora é montada com a biblioteca YUI. Foi criada uma classe +javascript específica para manipular essa árvore. Veja a documentação em +http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredetemas-js.html Utilitários - Foi criada uma classe específica com funções de uso geral. Veja em: - http://localhost/i3geo/documentacao/files/classesjs/classe_util-js.html +Foi criada uma classe específica com funções de uso geral. Veja em: +http://localhost/i3geo/documentacao/files/classesjs/classe_util-js.html Cálculos - Os cálculos agora estão na classe i3GEO.calculo, por exemplo, para converter coordenadas de dd para dms, utilize: - i3GEO.calculo.dd2dms(dd) +Os cálculos agora estão na classe i3GEO.calculo, por exemplo, para converter coordenadas de dd para dms, utilize: +i3GEO.calculo.dd2dms(dd) objmapa - A forma de inicialização do i3geo do lado do navegador (javascript) agora é controlado pela classe i3GEO. - O "objmapa" não é mais utilizado. - Os parâmetros do mapa, como extensão geográfica, tamanho do pixel, etc, são agora acessados por meio - de i3GEO.parametros, por exemplo, para obter a extensão geográfica do mapa atual, utilize: - alert(i3GEO.parametros.mapexten) - A lista completa de i3GEO.parametros pode ser vista em i3geo/classesjs/classe_i3geo.js +A forma de inicialização do i3geo do lado do navegador (javascript) agora é controlado pela classe i3GEO. +O "objmapa" não é mais utilizado. +Os parâmetros do mapa, como extensão geográfica, tamanho do pixel, etc, são agora acessados por meio +de i3GEO.parametros, por exemplo, para obter a extensão geográfica do mapa atual, utilize: +alert(i3GEO.parametros.mapexten) +A lista completa de i3GEO.parametros pode ser vista em i3geo/classesjs/classe_i3geo.js Variáveis de configuração - Muitas das novas classes possuem seus próprios métodos de configuração. Porém os parâmetros principais - de configuração do mapa ficam agora na classe i3GEO.configura - Por exemplo, para obter o diretório onde o i3geo está instalado, antes utilizava-se g_locaplic, agora utiliza-se - i3GEO.configura.locaplic +Muitas das novas classes possuem seus próprios métodos de configuração. Porém os parâmetros principais +de configuração do mapa ficam agora na classe i3GEO.configura +Por exemplo, para obter o diretório onde o i3geo está instalado, antes utilizava-se g_locaplic, agora utiliza-se +i3GEO.configura.locaplic Chamada aos programas PHP - Todas as chamadas a programas PHP via AJAX foram concentradas na classe classe_php.js. +Todas as chamadas a programas PHP via AJAX foram concentradas na classe classe_php.js. -- libgit2 0.21.2