GoogleMaps plugin

# Plugin de Mapas Google para FCKeditor

Cambie su idioma

## Introducción

Este es un plugin basado en una ventana de dialogo para controlar la inserción y modificación de Mapas Google en FCKeditor

### Autor:

Alfonso Martínez de Lizarrondo

### Patrocinado por:

Dynamical.biz

Uritec

InControl Solutions

### Historial de versiones :

1. 1.0: 25/08/2007. Primera versión.
2. 1.1: 28/08/2007. Ups, no estaba probado en 2.4.3
3. 1.2: 31/08/2007. Nuevo icono por Dynamical.biz. Utilizar IMG en vez de DIV para mostrar la situación del mapa por el momento.
4. 1.3: 02/09/2007. Documentación completa en HTML para la instalación y para usuarios.
5. 1.4: 21/09/2007. Utilizar el evento onload para generar el mapa (para evitar problemas con IE), e incluir la llamada a GUnload. Eliminar automáticamente el icono de la barra si no existe una clave Google correcta
6. 1.5 30/09/2007. Soporte para poder dibujar lineas en el mapa.
7. 1.6 24/10/2007. Soporte de múltiples marcadores.
8. 1.7 03/02/2008. Soporte de los nuevos cuadros de diálogo en FCKeditor 2.6.
9. 1.8 02/05/2008. Soporte de la vista Terreno y recordar el tipo de vista seleccionado. Se usan los mapas estáticos en el editor.
10. 1.9 19/05/2008. Respeta los valores que se pongan de anchura y altura (solo supone que son pixels si se trata de números sin ningún sufijo)
    Parámetros opcionales de configuración: GoogleMaps_WrapperClass y GoogleMaps_PublicKey (este código propuesto por Makerweb.it) .
11. 1.95 12/09/2008. The preview reflects the real type of the map. It shows also the markers.

Descarga la última versión y/o información actualizada

### Problemas conocidos :

El botón de 'Previsualizar' en FCKeditor no funcionará correctamente si hay algún mapa en el contenido. El problema parece debido a la forma en que la API de Google Maps realiza la inserción y carga del contenido adicional.

Estos temas en el grupo del API apuntan al mismo problema :
http://groups.google.com/group/Google-Maps-API/browse_thread/thread/7849dfd612181b6c/1c3e5f7fb5fa3301
http://groups.google.com/group/Google-Maps-API/browse_thread/thread/89ea5fa4e0a0ccb9/05c364940447891d

Una solución para este problema podría ser utilizar el plugin de Previsualización mediante el servidor

## Instalación

### 1. Copiar los ficheros

Extrae los contenidos del zip en tu carpeta de plugins, de forma que quede como a continuación

    editor\
    	...
    	js\
    	lang\
    	plugins\
    		...
    		googlemaps\
    			fckplugin.js
    			readme.html
    			dialog\
    			docs\
    			images\
    			lang\
    		...
    	skins\

### 2. Añadirlo a FCKeditor

Ahora incluye en tu fckconfig.js o fichero de configuración que estes usando la siguiente linea: `FCKConfig.Plugins.Add( 'googlemaps', 'de,en,es,fr,it,nl') ;`

### 3. Añadirlo a la barra de botones

Añade el botón 'googlemaps' (en minúsculas) a tu barra de botones: `FCKConfig.ToolbarSets["Basic"] = [
['Bold','Italic','-','OrderedList','UnorderedList','-','Link','Unlink', '-','googlemaps','-','About']
] ;`

### 4. Configurar el plugin

La parte más importante es tu clave para GoogleMaps. Debe estar establecida correctamente para que el plugin funcione, ya que sino Google no proporcionará los datos para el mapa.
Debes obtener una para cada servidor donde quieras utilizar el plugin, puedes obtenerlas gratuitamente aquí tras aceptar las condiciones de uso de los Mapas Google: http://www.google.com/apis/maps/signup.html
(Por favor, no hagais preguntas sobre en que sitios se puede usar GoogleMaps o cómo conseguir la clave, ya que son temas que no están relacionados con el plugin.)
Por ejemplo, la clave para "localhost" es
ABQIAAAAlXu5Pw6DFAUgqM2wQn01gxT2yXp_ZAY8_ufC3CFXhHIE1NvwkxSy5hTGQdsosYD3dz6faZHVrO-02A

Una vez que tengas la clave, has de añadirla a tu fichero de configuración:
`FCKConfig.GoogleMaps_Key = 'ABQIAAAAlXu5Pw6DFAUgqM2wQn01gxT2yXp_ZAY8_ufC3CFXhHIE1NvwkxSy5hTGQdsosYD3dz6faZHVrO-02A' ;`

(recuerda que has de sustituir la clave en verde por la tuya)

Nota: si dejas esa variable como una cadena en blanco entonces el icono no se mostrará (así se puede reutilizar la misma configuración de la barra para diferentes situaciones y dependiendo de esa variable se mostrará o no, ya que el sistema actual de FCKeditor no permite el añadir/eliminar plugins o botones de una forma realmente sencilla)

Hay varias opciones que puedes establecer para cambiar los valores por defecto con los que se crearán los nuevos mapas:

- FCKConfig.GoogleMaps_Width : La anchura del mapa
- FCKConfig.GoogleMaps_Height : La altura del mapa
- FCKConfig.GoogleMaps_CenterLat : La latitud del centro
- FCKConfig.GoogleMaps_CenterLon : La longitud del centro
- FCKConfig.GoogleMaps_Zoom : El nivel de zoom
- FCKConfig.GoogleMaps_MarkerText : El texto para el marcador
- FCKConfig.GoogleMaps_WrapperClass : Los mapas Google automaticamente ocupan toda la altura y anchura del div generado, por lo que si quieres mostrar algo de espacio y/o un borde necesitas añadir un div a su alrededor. Si este parámetro no está vacío, entonces se generará ese div con esta clase.
  Importante: ¡en la previsualización en el editor la clase se aplicará a una imagen, no a un div!
- FCKConfig.GoogleMaps_PublicKey : Si estás usando el editor en un dominio diferente a la localización final de la web, los mapas no funcionarán correctamente con la configuración por defecto. En esta situación puedes usar este parámetro. Primero, establece en GoogleMaps_Key la clave del dominio donde funcionará FCKeditor y a continuación tienes dos opciones,:
  - Poner un valor en blanco para GoogleMaps_PublicKey (FCKConfig.GoogleMaps_PublicKey = '';) esto significa que el usuario debe proporcionar la clave para el dominio final. Esto es útil si no se sabe de antemano todos los dominios donde esta instalación será usada. Por supuesto, debes explicarle a los usuarios cómo conseguir la clave API correspondiente
  - Establecer en GoogleMaps_PublicKey la clave adecuada para el dominio final. Para el usuario esto supone que todo funcionará automáticamente sin ningún problema.

Estos valores pueden establecerse en el fichero fckconfig.js, un fichero de configuración personalizado o en el momento de creación del FCKeditor utilizando cualquier lenguaje.

### 5. Úsalo

Ahora vacía la caché del navegador, recarga el editor y el nuevo botón debería estar listo para usarse .

## Notas finales

Si ves que este plugin es útil, considera la opción de realizar una donación para que pueda ser mejorado, cualquier cantidad ayudará a que el desarrollo siga adelante.

Si necesitas alguna funcionalidad especial para este plugin, o si necesitas cualquier otro plugin para FCKeditor, contacta conmigo y hablaremos sobre el tema

## Avisos legales

FCKeditor © FredCK.com

Google, Google Maps y el API de Google Maps son propiedades de Google.