porPOISe

Vamos a ver una alternativa a Hoppala. Para ello tenemos que tener un servidor propio. Si no es nuestro caso podemos probar con algunos servicios gratuitos de hosting, por ejemplo en http://www.hostinger.es/

1. Realizamos un registro y creamos un subdominio (tarda menos en activarse que un dominio). Con esto tendremos un servidor para instalar porpoise.
2. Descargamos porpoise. Guardamos y descomprimimos el archivo zip en nuestro ordenador.
3. Utilizaremos el servicio de ftp que nos ofrecen. Vamos a instalar en el ordenador Filezilla para el intercambio de archivos. Una vez instalado, añadimos los datos del servicio ftp del subdominio que hemos creado.
4. Subimos la carpeta de porpoise dentro de la carpeta public_html 
   
5. Una vez subido, escribimos esta dirección en nuestro navegador (sustituyendo dominio.com por nuestro dominio) http://dominio.com/porpoise/web/porpoise.php. Esto nos devolverá una respuesta, si nos devuelve este código JSON, es que todo va bien {"layer":"unspecified","errorCode":20,"errorString":"Missing parameter": "userId","hotspots":[],"nextPageKey":null,"morePages":false}
6. Creamos un usuario con su contraseña introduciendo esta dirección en el navegador: http://dominio.com/porpoise/web/dashboard/crypt.php?nombredeusuario=contraseña  Esto nos devolverá la clave encriptada de nuestra contraseña, la guardamos.
   
7. Editamos este archivo: http://dominio.com/porpoise/web/dashboard/users.inc.php, podemos hacerlo directamente en filezilla, seleccionamos el archivo users.inc.php y haciendo clic en el botón derecho del ratón, accedemos al menú donde tenemos la opción de ver/editar y donde pone: $_access["default"] = ”; lo sustituimos por la linea que guardamos en el paso anterior.
   
8. Podemos repetir el paso 6 y 7 para añadir más usuarios.
9. Ahora editamos el archivo http://dominio.com/porpoise/config/config.xml  Utilizaremos la opción más sencilla, guardaremos los POIs que creemos en un archivo xml. Introducimos el nombre de la capa de Layar (la crearemos después con este mismo nombre y debe tener al menos un número). Yo he puesto raenelaula1 y cambiamos el nombre de example.xml por otro, por ejemplo mispuntos.xml. Yo lo he nombrado poiscurso.xml
   
10. Accedemos en al directorio “config” y renombramos el fichero “example.xml” por el nombre elegido.
    
11. Para que nuestro archivo config.xml no sea accesible través de la web, por seguridad, podemos cambiarlo de lugar o renombrarlo. Editamos el archivo config.php y modificamos "config" por la ruta completa donde hemos colocado la carpeta config o bien modificamos el nombre.
    
12. Ya podemos empezar a agregar nuestros POIs. Accedemos desde el navegador : http://dominio.com/porpoise/web/dashboard/index.php  y validamos con el nombre y contraseña que metimos en users.inc.php.
    
13. Debajo de Layers, aparecerá la capa que registramos en config.xml. Si pinchamos en ella, pasaremos directamente a crear POIs.
    
14. Al crear un nuevo punto de interés aparece el parámetro "Dimension", hay tres opciones: 1 (punto, lo habitual), 2 (una imagen) y 3 (un objeto 3D). Escribimos 1.
15. Accedemos a los campos de edición del punto de interés. Título, descripción, localización... y podemos añadir acciones: abrir una URL, un vídeo, un archivo de voz...(tendrás que subir antes todos los archivos para copiar su URL)
16. Al crear la capa en Layar, escribiremos en API endpoint: http://dominio.com/porpoise/web/porpoise.php

Si vas a realizar una capa con muchos puntos de interés, quizá es más recomendable utilizar una base de datos. Os dejo una presentación de Emilio Gómez que lo explica mejor que yo :-)

Publicación de información geográfica en Layar mediante PorPOIse from Emilio Gómez

Práctica:

• Entra en este enlace. Utiliza tu usuario y contraseña 
• Clic en raenelaula1
• Añade un punto de interés. 

Para ver el punto que has creado, entra en esta capa de layar con el móvil. (Tendrás que localizarte cerca del punto para verlo)

Ejemplos de acciones, donde podemos ver lo que tenemos que poner en la casilla "Content Type" y los números que corresponden con las acciones (casilla "Activity Type",  información, voz, vídeo, correo, teléfono...)  https://www.layar.com/documentation/browser/howtos/how-to-actions/