Difference between revisions of "Installation"

Revision as of 21:11, 20 April 2011

Note: Excellent Installation guide

An installation guide by Cyberzero can be found on the OGame forums. (Outdated!)

General

After downloading the ZIP file, you need to extract it. After that you will have to modify the config.php and attributes.php (from the /config/ directory) to suit your needs. You receive the required information for the database connection from your webhoster.

Note: Use Wordpad or a good text editing program and NOT Notepad to edit these files, otherwise things could get garbled.

config.php

Note: you can find the file in the folder /config/

Go to your folder where you have downloaded Galaxytool (if you didn't download it yet go to the Download section on our page). In the folder you will find the "readme.txt" and some more files (including "install.php"). First, we are going to find "config.php". Open it and then change the following:

$dbusername = "username";

Write the username for your MySQL database in the quotation marks (you get the username from your webhoster).

$dbpassword = "password";

Write the password for your MySQL database in the quotation marks (you get the password from your webhoster, too).

$dbname = "database"; 

Write the name of your MySQL database in the quotation marks (again, you get the name from your webhoster).

$dbhost = "localhost"; 

Write the address (e.g. localhost) for your MySQL database in the quotation marks. You will get the address from your webhoster.

$dbprefix = "";

Here you can define a prefix for all table names. This way, you don't have to rename all table names by hand. This variable is usually used when installing several Galaxytools into one database.

The following things should not be changed. Use the $dbprefix variable instead, if you need to install more than one Galaxytool into the same database.

$dbtablename = $dbprefix . 'galaxy'; 

You can write the name of the galaxy table (all the data like planets and coordinates) in the quotation marks.

$utablename = $dbprefix . 'user'; 

You can write the name of the user table (the users of the tool) in the quotation marks.

$playertable = $dbprefix . 'players'; 

You can write the name of the players table in the quotation marks.

$allytable = $dbprefix . 'alliances'; 

You can write the name of the alliance table in the quotation marks.

$noticetable = $dbprefix . 'notices'; 

You can write the name of the notices table in the quotation marks.

$reporttable = $dbprefix . 'reports'; 

You can write the name of the espionage reports table in the quotation marks.

$iptablename = $dbprefix . 'iptable'; 

You can write the name of the IP addresses table (IP addresses from the users of the tool) in the quotation marks.

$shouttable = $dbprefix . 'shoutbox'; 

You can write the name of the shoutbox table (the shoutbox on the overview page of the tool) in the quotation marks.

$allyhistory = $dbprefix . 'allyhistory';

You can write the name of the allyhistory table in the quotation marks.

$playerhistory = $dbprefix . 'playerhistory';

You can write the name of the playerhistory table in the quotation marks.

$fleetmovetable  = $dbprefix . "fleet_movements";

You can write the name of the fleetmovements table in the quotation marks.

$player_activity = $dbprefix . "player_activity";

You can write the name of the player activities table in the quotation marks.

$messagetable    = $dbprefix . "messages";

You can write the name of the ingame messages table in the quotation marks.

$combattable     = $dbprefix . "combat_reports";

You can write the name of the combat reports table in the quotation marks.

$combatparty     = $dbprefix . "combat_party";

You can write the name of the combat report parties table in the quotation marks.

attributes.php

Note that you can find the file in the folder: /config/

Now if you have edited "config.php" it is time to edit some stuff to give galaxy tool another look. In the same folder ("config") there is a file called "attributes.php". Open it and we are going to change some things:

$owner = 'yourname'; 

Write your alliance or OGame nickname in the quotation marks. It is shown at the login screen to show which tool you are using if you play in different univereses.

$maxshouts = 15; 

This is the number of shouts shown in the shoutbox on the overview page. All shouts which are not shown are deleted!

$email_to = 'admin@yourdomain.com';

Enter your admin Email address where you want to receive emails about newly registered users.

$email_from = 'email@provider.xxx'; 

Here you can add an email address which should be shown in the FROM field of registration emails. Put the address between quotation marks. If someone registers at the galaxytool, an email is sent to this address showing that someone registered and needs to be activated. If you want to disable registering, you have to delete the register.php file.

If your webserver does not support mail functionality you can also use an external email provider by using these variables:

$usePHPMailer = false;			// use phpmailer ? (true or false)
$phpmailerHost = "smtp.prov.dom";	// smtp hostname
$phpmailerUser = "user@prov.dom";	// smtp username
$phpmailerPass = "password";		// smtp password

$default_language = 'english'; 

Write the default language for the tool in the quotation marks. You can choose between: balkan, brazilian, bulgarian, chinese, croatian, czech, danish, dutch, english, finnish, french, german, greek, hungarian, italian, japan, korean, latvian, lithuanian, norwegian, polish, portugues, romanian, russian, serbian, slovak, slovenian swedish, spanish, taiwan, turkish

$global_universe = "Andromeda";

$global_universe = "12";

This is your universe number/universe name. Do not leave out this variable! It will be used to check for the correct universe if you enter data via Galaxytool Firefox plugin.

$def_to_debris = false;

This is for universes in which destroyed defense creates a debris field. If you play in such a universe set it to true otherwise to false.

$debris_rate = 30;

Here you can adjust the percentage of resources that will create the debris field. For most universes the default of 30 should be alright, but there are several exceptions e.g. uni40.ogame.org where 40% of the resources create the debris field, so in this case you'd have to enter a 40. This value is used to be sent to online battle reports simulators like speedsim or dragosim.

$speed_rate  = 1; 

This option is for speed universes. Here you can set, how fast your universe runs. For example, if your universe runs with double speed, enter a 2 .

After editing config.php and attributes.php

After finishing the modification of your config.php and attributes.php, you need to upload all files to your server. Start the install.php on your webserver by typing

http://address.of.your.webspace/path/to/galaxytool/install.php (this address is just a template!)

in your browser and have a look at the screen. You should see something equal to this picture:

If there are any fields which are not green, you have a problem and you cannot start the installation. After the installation you should delete the install.php and the update.php.

After installation

After the installation you have to delete the install.php and the update.php!

The first login:

Loginname: admin
Password: galatool

You should change the password for the admin account after you log in the first time! Do this in the User Options, not in User Management

Important For those hosted on a Linux Server

For those who have been getting session time out messages as soon as you logged in the problem is in your php.ini file. Log into your hosting providers control panel and find the php controls edit the php.ini when inside it search for session.auto_start and change its attribute of 0 to 1 then save it it. now you should be able to log into gtool as you normally would.