Difference between revisions of "Installation"

Revision as of 21:47, 21 March 2008

Note: Excellent Installation guide

An installation guide by Cyberzero can be found on the OGame forums.

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 /secret/ directory) to suit your needs. You receive the required information for the database connection from your webhoster. If the modification of your config.php is finished, you need to upload all files to your server. Start the install.php on your webserver by typing

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

http://address.of.your.webspace/path/to/galaxytool/install.php

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.

config.php

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

Go to your folder where you have downloaded galaxy tool (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"). Well first we are going to find "config.php". Open in 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.

$dbtablename = 'galaxy'; 

Write the name of the galaxy table (all the data like planets and coordinates) in the quotation marks. It is recommended to use a significant name like u15_galaxy to know what the tables are used for if you look in your database.

$utablename = 'user'; 

Write the name of the user table (the users of the tool) in the quotation marks. It is recommended to use a significant name like u15_user to know what the tables are used for if you look in your database.

$playertable = 'players'; 

Write the name of the players table in the quotation marks. It is recommended to use a significant name like u15_players to know what the tables are used for if you look in your database.

$allytable = 'alliances'; 

Write the name of the alliance table in the quotation marks. It is recommended to use a significant name like u15_alliances to know what the tables are used for if you look in your database.

$noticetable = 'notices'; 

Write the name of the notices table in the quotation marks. It is recommended to use a significant name like u15_notices to know what the tables are used for if you look in your database.

$reporttable = 'reports'; 

Write the name of the espionage reports table in the quotation marks. It is recommended to use a significant name like u15_reports to know what the tables are used for if you look in your database.

$iptablename = 'ips'; 

Write the name of the IP addresses table (IP addresses from the users of the tool) in the quotation marks. It is recommended to use a significant name like u15_ip to know what the tables are used for if you look in your database.

$shouttable = 'shoutbox'; 

Write the name of the shoutbox table (the shoutbox on the overview page of the tool) in the quotation marks. It is recommended to use a significant name like u15_shoutbox to know what the tables are used for if you look in your database.

$allyhistory = 'allyhistory';

Write the name of the allyhistory table in the quotation marks. It is recommended to use a significant name like u15_allyhistory to know what the tables are used for if you look in your database.

If you leave this field empty (no name between the quotation marks), no statistic records are saved. You can save webspace by keeping this field empty. The tables for statistics can become 20 MB / year for an average alliance with 10 members.

$playerhistory = 'playerhistory';

Write the name of the playerhistory table in the quotation marks. It is recommended to use a significant name like u15_playerhistory to know what the tables are used for if you look in your database.

If you leave this field empty (no name between the quotation marks), no statistic records are saved. You can save webspace by keeping this field empty. The tables for statistics can become 20 MB / year for an average alliance with 10 members.

attributes.php

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

Now if you have edited "config.php" it is time to edit some stuff to give galaxy tool another look. Now in the same folder ("secret") there is a file called "attributes.php". Open in 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 himself 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: german, english, spanish, dutch, balkan, french, portugues, turkish, danish, italian,polish, danish, brazil, russian, swedish or greek.

$global_universe = 15;

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

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.