guia_de_migracao.txt
11.3 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
GUIA DE UPDATES
-------------------------------------------------------------------------------------------------
Para a versão 4.5 + SP8
As interfaces Openlayers e Googlemaps por default passaram a utilizar as guias na forma "retrátil"
As interfaces com a guia lateral anterior foram renomeadas para i3geo/interface/openlayers1.htm e googlemaps1.phtml
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).
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.
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 "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"
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
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
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":
<body id="i3geo" onload='i3GEO.inicia();'>
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
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.
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:
- 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)
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.
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.
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 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.
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.
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.
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.
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.
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);
Googlemaps
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.
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
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
Á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
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
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)
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
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
Chamada aos programas PHP
Todas as chamadas a programas PHP via AJAX foram concentradas na classe classe_php.js.