GUIA DE UPDATES e UPGRADES

-------------------------------------------------------------------------------------------------
Para a verso 6.0

- para permitir o retorno da requisio WMS getfeatureinfo em JSON, foi includo no mapfile base utilizado para
gerar os servios OGC a linha "wms_feature_info_mime_type" "application/json" em WEB->METADATA
Caso voc utilize um mapfile especfico da sua instalao, veja o arquivo original existente em i3geo/aplicmap
para fazer as adaptaes.

- style.overflow passou a ser definido automaticamente como "hidden" para previnir problemas com as janelas de informao.
Essa definio ocorre apenas quando o elemento body do HTML contiver o id definido como "i3geo" e quando seu estilo
"overflow" no estiver previamente definido.

- Remoo da biblioteca baloon-tooltips em prol das rotinas especficas de cada API para construo de janelas
de informao

- Incluso da varivel $i3geo_proxy_server no ms_configura.php para uso em algumas operaes baseadas no acesso
a outros servidores via Curl e OGC

- Incluso da varivel $statusFerramentas no ms_configura para controlar o status de ferramentas que 
dependem de configurao especfica do servidor

- Foram includos subitens no menu suspenso para acomodar o grande nmero de opes. Os cdigos locais que
manipulam o menu suspenso devem ser revisados para verificar o funcionamento nessa nova condio.

- Nova varivel em ms_configura chamada $customDir que indica a pasta com as customizaes dos mapas

- nas interfaces que utilizam a API do google maps agora  necessrio carregar a biblioteca geometry com o seguinte cdigo:
<script type="text/javascript" src="http://maps.google.com/maps/api/js?sensor=false&libraries=drawing,geometry"></script>

- os links para a rvore hiperblica foram removidos.

- a biblioteca pacotes/wicket/wicket.js agora  carregada com i3geo.js

- a biblioteca Richdraw foi removida em favor das bibliotecas de desenho nativas de cada API utilizada nos mapas

- o cdigo dos editores vetoriais para as interfaces Openlayers e Googlemaps foram movidos para a pasta i3geo/classesjs

- foi aumentado o nmero de botes padro da barra de botes para 13 se voc quiser manter em 12, utilize em seu javascript:
	i3GEO.barraDeBotoes.MAXBOTOES = 12;

- a ordem dos botes na barra de botes foi alterada para mostrar primeiro o boto da barra de edio

- as funes de desenho de elementos grficos utilizados pela interface GoogleEarth foram movidos de classesjs/classe_interface.js
para classe_desenho.js

- por default a rvore de temas agora  mostrada com checkbox ao invs de boto do tipo radio

- a rvore de temas agora pode ser utilizada para ligar/desligar camadas j existentes no mapa

- alterao na estrutura do objeto que contm as informaes sobre as camadas existentes no mapa. Esse objeto foi reduzido em
tamanho passando a usar uma lista de chaves e um array com os valores. Esse objeto  estruturado no servidor por classe_temas.php

- remoo do arquivo css/botoes.css em favor de css/botoes2.css

- as opes da guia mvel foram alteradas. Podem ser necessrios ajustes nos estilos inline das interfaces em uso
para posicionar corretamente os elementos dentro das guias

-------------------------------------------------------------------------------------------------
Para a verso 5.0

- O usurio agora pode ver a pasta i3geo/aplicmap/dados e navegar pelos arquivos para adicionar camadas ao mapa
Se voc no quiser permitir isso, inclua na interface do seu mapa a varivel javascript
i3GEO.arvoreDeTemas.OPCOESADICIONAIS.navegacaoDir = false;

- Novas variveis no i3geo/ms_configura.php:
	$saikuUrl e $saikuConfigDataSource para controle da integrao com o SAIKU

	$ogcwsmap permite definir qual arquivo map ser utilizado pelo gerador de servios OGC


-------------------------------------------------------------------------------------------------
Para a verso 4.7

- para testar via javascript se a verso  a 4.7, utilize:

	if(i3GEO.eventos.cliquePerm){
		//seu codigo vai aqui
	}

- Criada a pasta init que contm uma nova pgina de inicializao
- O banco de dados de administrao foi alterado. Deve ser executado o programa de upgrade do banco, existente em i3geo/admin.
- Para permitir o upgrade  necessrio ter um usurio master cadastrado em i3geo/ms_configura.php
- A interface Flamingo foi removida definitivamente
- A interface "padrao" (geral) foi removida definitivamente
- O gadget "quadro" foi removido
- A opo de ativao/desativao do entorno foi removida
- Remoo da pasta i3geo/classesjs/zerocal
- Remoo da pasta i3geo/mobile
- Remoo da pasta i3geo/pacotes/yui270
- Remoo dos arquivos de exemplo de i3geo/ferramentas
- Remoo das pastas depreciadas de i3geo/ferramentas
- Remoo da pasta i3geo/pacotes/rlib
- Remoo da pasta i3geo/pacotes/jsts
- Remoo da pasta i3geo/pacotes/jsobjects
- Remoo dos arquivos js da raiz de i3geo/ferramentas
- Os arquivos javascript das ferramentas foram renomeados, removendo-se a extenso .php
- As tabelas do sistema de administrao agora j podem ser armazenadas em um esquema diferente do public
- O arquivo mashups/openlayers.js.php foi substituido por mashups/openlayers.js
- O mapa com os estados do Brasil foi comentado nos mapfiles de inicializao. Para reativ-lo, deve-se remover os comentrios do layer brasil existentes nos arquivos .map existentes em i3Geo/aplicmap
- O layer com os limites estaduais no so mais carregados automaticamente, o layer estadosl est agora nos mapfiles de inicializao, porm, comentado para no ser ativado automaticamente
- Os layers com a ZEE e base raster do MMA foram removidos dos mapfiles de inicializao
- ms_configura.php
	- Nova varivel de configurao para indicar o local das bibliotecas adicionais do software R: R_libpath
- Funes removidas de classesphp/funcoes_gerais.php e inseridas nos respectivos programas que as chamam:
	classesRasterI
	fusaoGrafico
	executaR
	criaImagemR
	pegaValores
	pegaValoresM
	agrupaValores
	reSLD
	criaDirMapa
	permissoesarquivo
-------------------------------------------------------------------------------------------------
Para a verso 4.6

	Simbologia

		Verifique o uso de smbolos lineares.
			Utilize WIDTH no lugar de SIZE
			No smbolo chamado "linhas", utilize um smbolo simples, exemplo:
				STYLE
					WIDTH 3
					COLOR 255 0 0
				END
	Layout

		Para utilizar o padro CSS3 foi includo nas pginas o doctype:
		<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

		Se vc usa customizaes, verifique se o seu HTML  compatvel com CSS3.
		Um dos principais problemas  a necessidade de uso de "px" sempre que forem utilizados os estilos top, left, width e height
-------------------------------------------------------------------------------------------------
Para a verso 4.5 + SP11

	Mudanas que foram feitas para uso da verso 6 do Mapserver:

		Os mapfiles de inicializao geral1.map, geral1debian.map e geral1windows.map, existentes em i3geo/aplicmap,
		foram mantidos para efeitos de compatibilidade. Os novos mapfiles de inicializao agora so:
			geral1v5.map
			geral1v6.map
			geral1debianv5.map
			geral1debianv6.map
			geral1windowsv5.map
			gral1windowsv6.map
		"vX" indica a verso do Mapserver

		Caso o i3Geo seja inicializado com um mapfile diferente dos que so padro, existentes em i3geo/aplicmap, 
		necessrio alterar esse mapfile para compatibiliz-lo com a verso 6 do Mapserver.
		Utilize o arquivo i3geo/aplicmap/geral1.map ou geral1windows.map para copiar
		os elementos iniciais (de MAP at o primeiro LAYER) para o mapfile de inicializao desejado.

		Arquivos de definio de smbolos:
			i3geo/symbols/simbolos.sym no deve mais ser usado, continua a existir apenas para compatibilidade
			novos smbolos devem ser inseridos em i3geo/symbols/simbolosv5.sym ou em i3geo/symbols/simbolosv6.sym,
			conforme a verso do Mapserver em uso

			Nos mapfiles existentes em i3geo/temas, deve-se substituir a linha
			SYMBOLSET ../symbols/simbolos.sym
			por
			SYMBOLSET ../symbols/simbolosv6.sym
			ou
			SYMBOLSET ../symbols/simbolosv5.sym
			conforme a verso do Mapserver em uso
			Sem essa mudana, o i3Geo continuar a funcionar, mas se forem criados novos smbolos em um arquivo
			simbolosv5.sym ou simbolosv6.sym, deve-se fazer o mesmo em simbolos.sym


Para a verso 4.5 + SP8

	As interfaces Openlayers e Googlemaps por default passaram a utilizar as guias na forma "retrtil"
	As interfaces com a guia lateral anterior foram renomeadas para i3geo/interface/openlayers1.htm e googlemaps1.phtml

Para a verso 4.5

	Os arquivos com as interfaces HTML dos diferentes mapas do i3Geo foram movidos do diretrio
	i3geo/aplicmap para o diretrio 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 variveis de configurao $temasdir e $temasaplic foram removidas. Se vc desenvolveu programas em PHP,
	no lugar dessas variveis utilize $locaplic e o local fixo dos arquivos, por exemplo $locaplic."/temas"
	e $locaplic."/aplicmap"

	A opo de administrao com base em arquivos XML em disco foi removida. Agora, deve-se sempre utilizar o banco de dados
	de admnistrao.

	O banco de dados de administrao sofreu alteraes. Veja em "Outras opes", no sistema de admnistrao.

	O arquivo admin.db (banco de dados de admnistrao 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"

	Opo de comentrios em temas
		Foram acrescentadas novas variveis em ms_configura.php. Veja esse arquivo para editar as variveis e registrar
		as APIs das redes sociais como Twitter e Facebook
		Por default, todos os temas agora podem receber comentrios. Para bloquear comentrios em temas especficos,
		utilize o editor de mapfiles do sistema de admnistrao para bloquear essa opo em cada tema
		Os comentrios so armazenados em uma tabela no banco de dados de administrao. Essa tabela precisa ser criada no banco.
		Para criar a tabela veja o item "Outras opes" em http://localhost/i3geo/admin

	Contagem do nmero de acessos de cada tema
		Foi criada uma nova tabela no sistema de administrao para guardar o nmero de vezes que um tema  acessado. Antes
		a contagem era mantida na tabela i3geoadmin_temas, cuja coluna nacessos foi depreciada. Essa nova tabela guarda tambm o dia do acesso.
		Para criar a tabela veja o item "Outras opes" em http://localhost/i3geo/admin

	O nome dos arquivos js e ccs compactados foram renomeados, incluindo o valor da verso no final. Isso foi feito para se
	evitar problemas de cache de verses 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

	Variveis ou funes removidas
		i3GEO.interface (utilize i3GEO.Interface, com "I" maisculo)
		g_postpx
		g_tipotop
		g_tipoleft

	A inicializao 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 correes SP7)
		em ms_configura.php pode ser definido um e-mail padro que  utilizado nas interfaces dos mapas
		Para que o e-mail definido seja mostrado,  necessrio adicionar um elemento HTML com id=emailInstituicao no mapa

-------------------------------------------------------------------------------------------------
Para a verso 4.4

	Verifique se o PHP est configurado (php.ini) para permitir a passagem de parmetros por referncia
	(dependendo da verso do PHP, esse parmetro  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 no
	queira que essa camada nova aparea, basta remov-las desses arquivos.

	Foi incluida a remoo 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 cdigo 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 verso 4.3

	O banco de dados de administrao sofreu as seguintes alteraes (vc deve incluir as novas colunas
	para que o i3Geo funcione corretamente:

	- acrscimo das colunas en,es,it nas tabelas (tipo texto)
		i3geoadmin_menus
		i3geoadmin_temas
		i3geoadmin_grupos
		i3geoadmin_subgrupos

	- acrscimo da coluna kmz_tema em i3geoadmin_temas (tipo texto)

	Foi incluida uma nova opo que permite ao usurio alterar o SQL que faz o acesso aos dados em
	um LAYER (elemento DATA do mapfile). Mostrar ou no essa opo  controlado por um metadata
	em cada LAYER. Por default, o i3Geo entende que esse metadata  marcado como SIM. Se vc no quer
	que o usurio possa acessar essa funcionalidade, utilize o sistema de administrao para editar
	esse metadata de cada LAYER presente em um mapfile ou ento, inclua o metadata "editorsql" "nao".

-------------------------------------------------------------------------------------------------
Para a verso 4.1

Sistema de administrao

	A administrao do i3geo pode ser feita atravs de um sistema de formulrios  web desde que vc opte por isso.

	Se vc quiser continuar usando os arquivos XML existentes em i3geo/menutemas, no tem problema, mas nesse
	caso o sistema de administrao no lhe ser til.

	A opo pelo uso do sistema de administrao  default na verso 4.1. Se vc no quiser us-la, dever
	editar o arquivo i3geo/ms_configura.php e colocar os nomes dos arquivos XML nas opes desejadas. Esse
	arquivo est documentado, basta ler para entender o que deve ser feito.

	O sistema de administrao  acessvel no endereo i3geo/admin (http://localhost/i3geo/admin). Apenas editores
	cadastrados podem usar esse sistema. O cadastramento  feito por nmero IP (veja i3geo/ms_configura.php).
	Por default, "localhost"  um editor cadastrado.

	Os arquivos mapfiles existentes em i3geo/temas continuam sendo necessrios e vc pode edit-los manualmente
	ou por meio do sistema de administrao.

	Os arquivos XML que vc j possu em i3geo/menutemas devem ser importados para o sistema de administrao.
	Utilize as opes 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 administrao
	existe uma opo para criar o banco, o que deve ser feito depois que vc apagar o arquivo que vai com o i3geo.

	Se vc no quiser usar o SQLITE vc deve criar um arquivo de conexo com seu banco de dados e registrar o endereo
	desse arquivo em uma varivel no i3geo/ms_configura.php. Um exemplo de arquivo de configurao para POSTGRE
	pode ser visto em i3geo/admin/php/conexaomm.php. Ao usar a opo de criao do banco existente no sistema
	de administrao, as tabelas sero criadas no banco de dados indicado.

PHP

	O sistema de administrao do i3geo  baseado na biblioteca PHP chamada "PDO". Nas verses mais recentes do
	PHP e no MS4W essa biblioteca j vem habilitada. Se no seu PHP no existir o PDO vc dever instal-lo.

YAHOO

	A bibblioteca do YAHOO (YUI) foi atualizada. A verso antiga continua em i3geo/pacotes. Se vc desenvolveu
	programas baseados na verso antiga,  bom verificar se tudo funcionar corretamente pois o arquivo
	i3geo/classesjs/i3geo.js agora utiliza essa nova verso da YUI.

JSOBJECTS

	Essa biblioteca no ser mais utilizada pelo i3geo, sendo substituda pelo YUI. Se vc utilizava as funcionalidades
	dessa biblioteca, embutida no i3geo.js, dever verificar seu cdigo ou ento 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 esto sendo migrados aos poucos para estruturas
	baseadas em classes. Isso facilitar a compreenso dos cdigos e sua documentao, facilitando a vida
	dos desenvolvedores e permitindo uma melhor evoluo dos cdigos.

	As classes desenvolvidas ficaro 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 acentuao de uma palavra vc pode usar a classe i3GEO.util:

	var palavraAcentuada = "corao";
	var palavraSemAcento = i3GEO.util.removeAcentos(palavraAcentuada);

Googlemaps

	A chave de registro da API do Google agora deve ser includa no arquivo i3geo/ms_configura.php na
	varivel $googleApiKey.

	Isso foi necessrio 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 tradues foram retiradas do arquivo i3geo/classesjs/configura.js e incluidas no
	novo arquivo i3geo/classesjs/dicionario.js

	Foi criada uma classe especfica para manipular a internacionalizao. Veja a documentao 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 especfica para manipular essa rvore. Veja a documentao em
	http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredecamadas-js.html
	Os aplicativos que usam rvores tambm 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 especfica para manipular essa rvore. Veja a documentao em
	http://localhost/i3geo/documentacao/files/classesjs/classe_arvoredetemas-js.html

Utilitrios

	Foi criada uma classe especfica com funes de uso geral. Veja em:
	http://localhost/i3geo/documentacao/files/classesjs/classe_util-js.html

Clculos

	Os clculos agora esto na classe i3GEO.calculo, por exemplo, para converter coordenadas de dd para dms, utilize:
	i3GEO.calculo.dd2dms(dd)

objmapa

	A forma de inicializao do i3geo do lado do navegador (javascript) agora  controlado pela classe i3GEO.
	O "objmapa" no  mais utilizado.
	Os parmetros do mapa, como extenso geogrfica, tamanho do pixel, etc, so agora acessados por meio
	de i3GEO.parametros, por exemplo, para obter a extenso geogrfica do mapa atual, utilize:
	alert(i3GEO.parametros.mapexten)
	A lista completa de i3GEO.parametros pode ser vista em i3geo/classesjs/classe_i3geo.js

Variveis de configurao

	Muitas das novas classes possuem seus prprios mtodos de configurao. Porm os parmetros principais
	de configurao do mapa ficam agora na classe i3GEO.configura
	Por exemplo, para obter o diretrio 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.


