Galaxy tools

.- Presentación del programa

(¡¡se necesita instalar en un server, no en un PC, ojo con esto!!)

El Galaxytool es una herramienta independiente para Ogame. Permite a un jugador, mejor dicho a una Alianza, crear y administrar una imagen del Universo en el que juega. Lo cual permite a los jugadores conseguir información, que el Ogame no les proporciona. Así podemos realizar las siguientes consultas o búsquedas:

* Buscar etiquetas de alianzas.
* Buscar nombres de jugadores.
* Solo buscar planetas con Lunas.
* Solo buscar planetas con notas.
* Solo buscar planetas con informes de espionaje.
* Solo buscar planetas colonizables desde la posición X a la posición Y.
* Restringir la capacidad de búsqueda a galaxias o sistemas.
* Solo mostrar las entradas que sean mas nuevas/viejas que una fecha determinada.
* Solo mostrar las entradas que en el campo de escombros tengan más de X de Metal, Y de cristal
o tengan más de Z en total.
* Posibilidad de establecer una prelación en el orden.
* Buscar jugadores de un determinado estado - inactivo, suspendido o de vacaciones
* Buscar jugadores del Top X (Puntos o Flotas)
* Posibilidad de poder establecer cuantas entradas son mostradas por pagina.
* Marcar Alianzas como enemigas, amigas.
* Posibilidad de actualización de las Estadísticas y de la Galaxia mediante extensión de Firefox.
* Posibilidad de ordenar las estadísticas como uno prefiera.
* Los usuarios pueden registrarse en galaxietool y el Admin solo necesita autorizar su entrada.
* Información detallada de usuarios, para saber quien trabaja y quien no.
* Sistema de mensajería en visión general para comunicación interna.
* y mucho más...



2.- Requisitos: (para instalacion y uso)


Necesitamos un espacio web (Hosting) con PHP y soporte MYSQL.

Existen diversos Hostings gratuitos que os pueden servir, sin embargo puede ocurrir que os suspendan el hosting por rebasar el limite de transferencia o que tras unos meses os borren la cuenta. Personalmente os recomendaría que escogierais un hosting con soporte para el módulo GD, el cual se encarga de construir gráficos que luego aparecen en determinadas secciones del Galaxytool.

Requisitos técnicos:

Los requisitos del hosting en sí son escasos, a partir de 50 MB podemos tener una cantidad considerable de información guardada. Mientras más MB tenga el hosting más información se podrá introducir.

Respecto al PHP es necesaria la version 4.3 o superior. En el caso de MYSQL es como mínimo la version 4.1.16 (recomendable la v 5.0.16)

Requisitos usuarios del Galaxytool

La utilización del navegador web Mozilla FireFox para poder introducir los datos en el Galaxytool. Ello se hace a través de la Toolbar. También se admiten otros navegadores web como el Internet Explorer, pero en este caso no se permite subir los datos, ya que no se pueden instalar extensiones.

3.- Descargas necesarias

Los usuarios deberán de descargar e instalar la Galaxytoolbar. Es una barra que permite subir de forma automática la información al servidor, de manera que se mantenga actualizada la base de datos.

Descarga del Galaxytool y de la Galaxytoolbar :
http://en.wiki.galaxytool.eu/index.php/Downloads

4.- Instalación del Galaxytool

Una vez dispongamos de nuestro espacio web, debemos averiguar la dirección del servidor FTP, nuestro nombre de usuario y nuestra contraseña. Esto depende de cada hosting, pero cuando accedamos a nuestra cuenta personal en la web del hosting y consultemos nuestros datos, debemos encontrar dicha información.

A continuación algunos archivos del Galaxytool que hemos descargado deberán ser editados. Una vez descomprimido el Galaxytool, debemos acceder a la carpeta en la que lo hemos echo, y dentro de ésta a la carpeta "secret". Empezaremos editando, por ejemplo, el archivo "attributes.php" con un editor de texto sencillo como puede ser el wordpad o un editor de código. Bajo ningún concepto utilizaremos editores como Office o OpenOffice cuando tratemos con archivos de código, como es el caso (suelen transformar algunos caracteres como las comillas, lo que ocasiona problemas). Las líneas a modificar son las siguientes:

· $owner = 'yourname'; Este nombre saldrá en la pantalla de login, así que una buena idea podría ser poner el nombre de nuestra alianza.

· $maxshouts = 15; Dentro del Galaxytool hay una sección en la que se pueden escribir mensajes. Este número indica el número de mensajes a escribir. Nótese que no se almacenarán los mensajes no guardados, así que si escribimos mucho podríamos optar por poner un número elevado, como por ejemplo el 100.

· $email_to = 'admin@yourdomain.com'; Este e-mail es el que recibirá las notificaciones de nuevos registros.

· $email_from = 'email@provider.xxx'; Este es el e-mail que será mostrado como autor de los e-mails de registro. Lo normal es que nosotros mismos, como administradores, activemos las cuentas registradas manualmente, de modo que esto tiene una utilidad relativa.

· A continuación aparecen un seguido de líneas encabezadas por phpmailer. Su función consiste en que, en caso de que nuestro servidor no soporte el envío de e-mails, podamos configurar los datos de nuestro correo, como cuando utilizamos un lector de e-mail como Outlook, Thunderbird o Evolution. Personalmente no conozco ningún servidor que no soporte dicha funcionalidad, pero si se diera el caso deberíais rellenarlo de la siguiente forma:

$usePHPMailer = true;
$phpmailerHost = "smtp.prov.dom"; // el nombre del host stmp; este varía según que correo utilicemos y deberemos averiguarlo. En el caso de gmail, por ejemplo, es smtp.gmail.com
$phpmailerUser = "user@prov.dom"; // nuestro nombre de usuario, como por ejemplo teclado@gmail.com
$phpmailerPass = "password"; // nuestra contraseña del correo
$phpmailerSMTPSecure = ""; // esto sirve por si queremos utilizar una conexión segura (ssl) o no. Lo podéis dejar tal y como está.
$phpmailerPort = ""; // este dato también lo tiene que proporcionar el servidor. En el caso de gmail, por ejemplo, se puede usar el puerto 465 o el 587.

$default_language = "spanish"; si queremos el Galaxy en castellano. Podemos rellenar este campo con uno de los siguientes idiomas: german, english, spanish, dutch, balkan, french, portugues, turkish, danish, italian,polish, danish, brazil, russian, swedish o greek.

$global_universe = X; número del universo en el que utilizaremos el Galaxytool.

Bien, guardamos el archivo y proseguimos a editar "config.php".

Los primeros cuatro campos hacen referencia a la base de datos MYSQL en la cual se guarda la información del Galaxytool y la cual debemos crear (logueados en nuestra cuenta en la web del hosting, deberemos buscar la sección en la cual podemos crear una base de datos). Así pues, los siguientes campos hay que rellenarlos con la información que obtengamos de nuestro host:

$dbusername = "username"; // nuestro nombre de usuario de la base de datos. Suele ser el mismo que el usuario con el que nos logueamos.
$dbpassword = "password"; // contraseña de la base de datos
$dbname = "database"; // nombre de la base de datos
$dbhost = "dbhost"; // la dirección del host de nuestra base MYSQL.

Con esto ya habremos terminado de editar este archivo. Ahora falta subir el Galaxytool a nuestro hosting. Este paso se puede hacer desde la propia web del hosting, pero resulta muy lento, por lo que es recomendable usar un programa que suba los archivos de una forma más cómoda y veloz. En esta guía se utilizará FileZilla, que funciona tanto para Linux como para Windows como para Mac y que os lo podéis descargar de aquí: http://filezilla-project.org/download.php?type=client

Una vez instalado FileZilla, lo ejecutamos. Utilizaremos el método de conexión rápida para conectarnos a nuestro servidor FTP:



En "Servidor" pondremos la dirección de nuestro servidor FTP, en "Nombre de usuario" nuestro nombre de usuario del FTP (suele ser diferente al usuario que utilizamos para loguearnos en la web del hosting) y en "Contraseña" nuestro password del FTP. Rara vez hace falta indicar un puerto, por lo que sólo queda pulsar en conexión rápida. A continuación, debemos seleccionar el directorio en el que hemos descomprimido el Galaxytool (parte izquierda de la siguiente imagen) y el directorio de nuestro servidor (parte derecha de la siguiente imagen) en el que queremos instalar el Galaxytool (no hace falta que creemos una carpeta sino queremos, sino que lo podemos subir en el sitio que aparece por defecto):



Seguidamente seleccionaremos todos los archivos y carpetas del Galaxytool (parte izquierda), pulsaremos el botón derecho y luego clickaremos en "Subir" y ahora toca esperar a que se termine de subir.

Una vez se ha terminado de subir, falta instalar las tablas del Galaxytool, así que debemos acceder al archivo install.php de nuestro servidor. Esto lo haremos escribiendo la dirección en que actualmente se encuentra nuestro Galaxytool subido añadiendo "/install.php". Si todo está bien configurado, nos dejará darle a instalar y no nos dará problemas. Hecho esto, es imprescindible borrar los archivos "install.php" y "update.php" de nuestro servidor (lo podemos hacer con el FileZilla mismo, seleccionando los archivos y pulsando la tecla Supr). Automáticamente se habrá creado una cuenta de administrador cuyo nombre será "admin" y su contraseña "galaxytool". En la página principal de nuestro Galaxytool nos loguearemos con estos datos y en "Opciones de usuario" tendremos la muy recomendable opción de cambiar la contraseña por defecto.

4.1.- Instalación y configuración de la Galaxytoolbar

Para poder utilizar la Galaxytoolbar es impresindible contar con el navegador web Firefox. Es muy recomendable usarla, ya que ella sola envía información (informes de espionaje, visión de galaxia, etc) de forma automática y veloz.

Si al pulsar el link para descargar la Galaxytoolbar ésta no se instala automáticamente, podemos arrastrar el archivo descargado hacia la ventana del Firefox (entonces podremos instalarla). Una vez instalada, es necesario configurarla. Para hacerlo, dentro del Firefox nos dirigiremos a Herramientas>Complementos, marcaremos Galaxytoolbar y pulsaremos en "Opciones". Aquí encontraremos dos pestañas: "Galaxytools" y "Opciones del plugin". Vayamos por la primera:



Nombre del servidor OGame (OGame servername): uniX.ogame.com.es ,donde X es el número del universo para el que hemos configurado el Galaxytool.
URL o dirección del Galaxytool: http://pepito.hosting.es/secret/galaxyplugin.php (osea, la misma dirección que utilizamos para consultar el Galaxytool pero añadiendo "/secret/galaxyplugin.php").
Nuestro nombre de usuario y nuestra contraseña. El universo se pondrá automáticamente.

Ahora, en complementos, dale a opciones de Foxgame o de Neogame (si es que lo tienes instalado). Asegúrate que tienes desactivada la opción "Activar visión reducida de la alianza" (vital para el correcto funcionamiento de la toolbar).

Para comprobar que funciona, ve a Ogame, dirígite a galaxia y comprueba que te sale una ventanita arriba. Te pondrá Wrong universe pero cuando le vuelves a dar a mostrar, el universo se guardará en la toolbar y pondrá sistema actualizado.

La segunda pestaña sirve para indicar que información (tuya, de tu cuenta) quieres enviar al Galaxytool. Puede ser interesante tenerlo todo marcado (excepto la tercera opción, que es muy molesta y no aporta nada útil) para que así los compañeros puedan saber nuestras tecnologías y nuestra flota por si necesitan simular SACs. Si nos fiamos de ellos, podemos desactivar las distintas opciones a conveniencia.

Por último, es necesario destacar que es muy importante procurar tener la toolbar y el Galaxy en sus versiones actualizadas, ya que esto evitará problemas de compabilidad.

5.- Dentro del programa

5.1.- Visión General:

En Información podemos ver la cantidad de datos que tenemos a nuestra disposición.

Debajo de la información, tenemos el cuadro de "Mensajes actuales" que se puede usar para comunicarse con los demas usuarios registrados. No es mas que un chat, pero sirve para dejar constancia de las actualizaciones realizadas por los usuarios, por ejemplo.

Clickeando en el número de versión, que aparece arriba a la izquierda se carga la Visión general, pero también busca posibles actualizaciones. Es suficiente comprobarlo cada 10 días.


5.2.- Introducción de datos en la Base de datos:

Luego de terminar con la instalación, necesitaremos introducir información en la base de datos. Cuanto mas actualizada tengamos la base de datos, mas fiable será la información que obtengamos.

Lo ideal es actualizar la base de datos 1 vez a la semana, aunque si todos los jugadores de la alianza usan Firefox con la Galaxytoolbar la base de datos se irá actualizando sola por las zonas de acción de sus compañeros de alianza. Asi que solo tendría que actualizar el resto.

Otra forma de actualizar el Galaxytool es hacerlo manualmente desde la opción "Actualizar la base de datos", en Opciones ... pero es una tarea engorrosa y que lleva mucho tiempo.

1.- Ver galaxias

Esta opción permite la posibilidad recorrer los sistemas sin hacer peticiones de la búsqueda. Podremos conseguir la información sobre jugadores, alianzas, nombres de planetas, la lunas (con tamaño al pasar ratón por encima), tamaño del campo de escombros, notas e informes.
Las notas disponibles son mostrados con ese símbolo Si no hay ninguna nota para esas coordenadas, se muestra este icono Si clickeamos un icono verde, se muestran todos las notas (públicas) disponibles. Si no hay nota, podemos crear una clickeando en ese cuadro.
Los informes disponibles de espionaje son mostrados por éste cuadro Si no hay informe, veremos éste icono


Si están actualizadas las estadísticas y dejamos el cursor sobre el nick del jugador nos aparecerán los datos de ese jugador (estadísticas por puntos, flota e investigaciones).
Igualmente para las alianzas.

Si estamos viendo una galaxia y un sistema y vamos a otro módulo del programa, cuando regresemos a galaxia aparecerá en el mismo sistema donde estaba anteriormente, ya que la herramienta almacena la última posición que estabamos viendo.

También tenemos la posiblidad de darle un color al nombre de las alianzas para saber si son amigas, enemigas, neutrales, etc, cambiando su estado. Para dar a una alianza un nuevo estado vamos a las estadísticas de alianza y desde allí se puede cambiar, una vez cambiado, cambiara el color en la vision de galaxia cada vez que aparezca el nombre de esa alianza. Veremos como hacerlo más adelante.

2.- Notas

Hay dos vistas difentes para las notas. La primero, el cuadro de texto para crear un aviso:



Y la segunda es el resultado de una petición de la búsqueda. Si existen notas, seran mostradas y puedemos corregirlas o borrarlas clickeando en el link.
Las notas de otros usuarios se demuestran pero no pueden ser corregidas (a no ser que tengamos permisos de administración).



¡Si suprimimos a un usuario, todos sus avisos serán suprimidos también!


3.- Buscar notas

Se puede buscar dentro de todas las notas registradas por la herramienta, una palabra en concreto, por ejemplo, el nombre de un jugador, para ver si hay notas al respecto de él.





4.- Buscar en base de datos

Aquí podemos buscar dentro de la base de datos entera de la galaxia. Las opciones de la búsqueda son múltiples. Todas las opciones se pueden combinar para una petición compleja de búsqueda.

Una lista de las capacidades de la búsqueda:

* Búsqueda para las etiquetas de la alianza.
* Búsqueda para los nicks.
* Búsqueda de planetas solo con luna.
* Búsqueda de planetas solo con notas.
* Búsqueda de planetas solo con informes del espionaje.
* Búsqueda de planetas solamente colonizables de la posición X a la posición Y.
* Restricción para la galaxia o los sistemas especiales.
* Muestra solamente las entradas más nuevas/más viejas que una fecha determinada.
* Muestre solamente entradas de planetas que tienen más de X metal, cristal o deuteiro.
* Capacidad para elegir el orden de aparición.
* Búsqueda para el estado del jugador (inactivos, posibles objetivos, todos).
* Búsqueda de jugadores en el top X.
* Parámetro para seleccionar cuántas entradas se deben mostrar.




Cabe destacar que si no nos sabemos el nombre completo de una alianza o jugador, podemos usar el asterisco para que se nos indiquen todos los usuarios o alianzas que tengan unas determinadas letras iniciales, como se puede observar a continuación:



Además, si pulsáis en el símbolo de la izquierda (el que está señalado con el cursor en la captura de pantalla), podréis guardar los datos del formulario. Esto se puede hacer en la mayoría de las secciones del Galaxytool.

Cuando busquemos un jugador o una alianza, tendremos acceso a todas sus coordenadas, todos sus planetas, todas sus lunas, su gráfico de distribución de puntos (alianzas), su producción y todos aquellos datos que hayamos podido adquirir mediante informes de espionaje.

También es necesario comentar que las gráficas sólo funcionarán si nuestro hosting dispone del módulo GD.


5.- Estadística

Las estadísticas son similares a las que todos conocemos de OGame. Pero aquí podemos puede ver toda la información sobre un jugador en una página, puntos, flota e investigaciones.

Podemos ordenar la tabla usando como valor lo nos sea de mas utilidad, flotas, puntos, etc, solamente clickeando sobre el criterio de orden que preferimos. Como podéis observar en la imagen, si pasáis el cursor por encima de las ruedas amarillas de la derecha, podéis cambiar vuestra postura diplomática respecto a un jugador:



Y lo mismo para la estadística de alianzas:



Por cierto, si pasáis el cursor por encima de la etiqueta de una alianza, veréis el mismo gráfico del que os hablaba anteriormente.

5.1.- Estadísticas temporales

Esta sección nos permitirá obtener gráficos de la evolución en puntos, flotas e investigaciones tanto de jugadores como de alianzas. Podemos escribir varios jugadores y/o varias alianzas y compararlas entre ellas o simplemente observar la evolución de un jugador y/o una alianza de forma individual, tal y como se puede ver a continuación:



Es necesario comentar que la opción "Mes actual" en realidad muestra los datos referentes a los últimos 30 días.

6.- Buscar informes de espionaje

Para poder realizar una búsqueda por lo menos algun valor de la tabla debe ser superior a 1. Esta manera de buscar es muy util, porque si tenemos muchos informes de espionaje metidos en la base de datos, podemos buscar por ejemplo a jugadores con las minas muy altas, ya que producen mas que otros y podremos saquearles. O tambien podemos buscar a gente que tenga mas de una cantidad de naves de un tipo en concreto.
Ademas tambien se pueden combinar varios campos para realizar búsquedas complejas o pedirle a la herramienta que solo busque en un rango de sistemas cercanos para nosotros.



Los resultados muestran todos los datos conocidos, pero además aparece el tiempo que lleva ese informe en la base de datos, para que podamos hacernos una idea de la progresión de ese jugador hasta la fecha actual.
Los resultados son mostrados siguiendo el orden de sus coordenadas.

Otra forma de buscar informes es utilizando la opción "Búsqueda avanzada" dentro de la misma sección "Buscar informes de espionaje". Esto nos devolverá una tabla que contendrá la información de los informes con las características que hayamos indicado. Por ejemplo, si buscamos todos los informes en los que aparezcan más de 200k de cristal en una determinada zona, obtenemos algo parecido a esto: