Revision as of 19:34, 14 June 2010

First of all, you have to define the correct setting for your universe/Galaxytool.

To do this, click on "Tools" -> "Add-ons" in Firefox:

Find your Galaxytool addon and select the options button.

You can also reach the options screen via Firefox context menu: Just click somewhere with the right mouse, and select "Galaxytool Plugin" -> "GTP Options"

Version 2.3.*

GTP Settings

In the beginning, you have to enter the OGame Servername. You will easily get this address when logging in into you OGame account and copying everything from the address bar of you browser, except of the leading "http://" and without all the things behind the TLD:

electra.ogame.org - this would the OGame Servername.

In the next field you have to enter the path to the galaxyplugin.php. An example could be http://www.yourdomain.de/galaxytool/secret/galaxyplugin.php. Of course you have to adjust this address to your Galaxytool installation. If you are unsure, ask the admin of your Galaxytool, he should know the address.

It is possible to add an infinite number of Galaxytools. The Firefox Add-On sends information from one universe also to different Galaxytools.

Finally, you have to enter your username/password from your Galaxytool account.

If you would like to add some more Galaxytools, just click on "Add new Tool".

As you can see, you can set for every single Galaxytool which information shall be sent.

If you would like to delete one Galaxytool, just select it in the dropdown menu and click on "Delete".

Please notice, that all changed information (added/deleted tools, changed settings) will be saved, when you click on "OK". All changes can be made undone by clicking on the "Cancel"-button.

Status Window

As soon, as the Add-On finds something to upload, a status window appears and shows, what has been sent:

Important: The website needs to be loaded completely, otherwise the Add-On won't recognize anything.

General settings

Status Window

Here you can define the view of the status window via CSS styles. For example you could replace left with right, so the window would be displayed on the right side of OGame instead on the left side.

Debug Mode

The debug output may contain information, which could help supporters to help you with your problems. To get a debug output, you have to enable the checkbox "Show debug information" in the settings

If you try to upload something after you enabled that option, the status window looks like this:

Copy the text into a Pastebin. (Don't copy it directly into the IRC window, you may become disconnected then!) Don't forget to replace the password. After that, give the link to a supporter. Finally, you can disable the Debug mode again.

Submitting espionage reports

It is possible to submit espionage reports only via Firefox context menu. Please enable in OGame the option "Show full spy report" so several espionage reports can be sent at the same time.

Version 2.1.*

GTP Settings

That will bring you to the new options screen.

There is room for up to 5 universes through the plugin.

You have to fill in the server of your universe in the "Ogame Servername" field. You can get the server address by right-clicking on the "overview" link at OGame and choose "copy link location". You will get an address like this:

http://uni15.ogame.de/game/overview.php?session=yoursession (german Uni 15).

Now you remove the "http://" and everything from "/game" to the end. That's your server address:

uni15.ogame.de 

you have to fill in the first column.

In the "Galaxytool URL" field you need to fill in the path to the galaxyplugin.php of the corresponding galaxytool. Normally the file galaxyplugin.php is stored at the secret folder of your galaxytool. That file receives the information from the toolbar and its URL must be inserted at the URL textfield. You need to fill in the complete path, e.g. http://www.yourdomain.com/pathtogalaxytool/secret/galaxyplugin.php The admin can delete the file if he does not want the usage of the toolbar. He can also rename the file, so nobody knows the URL except authorized users. So if you are not sure ask your admin what the URL is to the required file.

Note-http://www.yourdomain.com/pathtogalaxytool/secret/galaxyplugin.php
Your link should look like that, with the /secret/galaxyplugin.php.

The "Username" and "Password" fields should be filled in with your Galaxytool username/password.

Also, the universe field should fill itself on upon your first login to ogame with the toolbar 2.0 enabled.

Save the data by clicking "ok".

Now your toolbar is ready to use!

If the data was sent successfully the status of the toolbar changes to show what you have updated.

The status information and all texts of the toolbar are only available in english but you can use them with every OGame language! It works with english as well as with french, spanish...

Important: Your browser needs to load the pages (stats or galaxy view) completely! Otherwise the script won't start and the information will not be sent to the galaxytool.

Updating Galaxies

To upload galaxy data to your Galaxy, just view the Galaxy. Pay special attention to your status window within ogame.

Upon viewing the galaxyview has finished loading completely you should see:

Once it says the information is updated, you're ready to change views.

Updating Statistics

Updating statistics is done much like updating galaxies, upon viewing the statistics, you will see they're found, and that they've finished updating.

Uploading Espionage Reports

One of the new features of the plugin is the ability to automatically upload your espionage reports.

Please make sure you don't have the truncated view option selected in your ogame options for this to work.

Upon clicking on "Messages" in your ogame menu, the reports should be uploaded automatically, and you should receive a status update.

Disabling Automatic Espionage Report Upload

You may enable/disable automatic uploading of espionage reports via the Galaxyplugin options in the

Manual uploading of espionage reports

To upload espionage reports with automatic report uploading disabled, you may right click on your browser window and choose to manually upload your reports. Please note that you must of course be on your messages window for this function to work.

Redesign universes

In the current version for redesign universes this is the only possibility to upload espionage reports via Firefox Extension. Automatic Transmission has been disabled for performance reasons. Make sure, that you enabled in your ogame account the option to show full espionage reports.

Enable debugging functionality

Sometimes it is helpful to activate the debug printout to allow developer or supporter to analyze the problem. In this case you need to activate the debugging at your toolbar options.

After that you can view every page as usual but you will get a lot more information.

Please remove your password from the printout if you submit those information to anybody.

Don't try to copy & paste the entire text into any IRC Channel. Instead use http://galaxietool.pastebin.com/pastebin.php submit your debug info and forward the link to your paste on to whoever is helping you.