Recent versions: ||| Galaxytool: v5.1 ||| Galaxytoolbar: v2.6.32 |||

Difference between revisions of "Installation"

From Galaxytool wiki
Jump to: navigation, search
(attributes.php)
m (Important for those hosted on a Linux Server)
 
(74 intermediate revisions by 16 users not shown)
Line 1: Line 1:
After downloading the file, you need to extract it. After that you will have to modify the config.php to suit your needs. You receive the required information for the database connection from your webhoster.
+
== General ==
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
 
  
http://address.of.your.webspace/path/to/galaxytool/install.php
+
After [[Download|downloading]] the ZIP file, you need to extract it.
 +
After that you need to upload all files to your server.  
 +
Now you should [[How to set writable permissions|set writable permissions]] to the '''config''' folder.
 +
Then, start the install.php on your webserver by typing
  
in your browser and see what happens (of course with your specific address and path).
+
http://example.com/path/to/galaxytool/install.php (this address is just a template!)
If there are any problems during the installation, you have to look what is wrong with your config.php!
 
After the installation you should delete the install.php and the update.php.
 
The attributes.php allows to modify the Galaxytool, but you don't need to change anything there.
 
  
Please note that special characters like ' are not allowed except for those already present there!
+
in your browser and have a look at the screen.
  
 
+
Now follow the instructions on the screen.  
 
+
They will give you detailed information about what to enter or they'll tell you, if something did not work as expected.<br>'''Everything is created automatically during installation - no need to edit any file.'''
== /secret/config.php ==
 
Go to your map where you have downloaded galaxy tool. (if you didn't downloaded it yet go to the download section on
 
our page.) In the map you will find the readme.txt and some more files (including install.php) Well first we are gone find config.php
 
you can find it in the map secret. Open in and then:
 
 
 
$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).
 
 
 
$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.
 
 
 
$pstablename = 'playerstats';
 
 
 
Write the name of the playerstats table in the quotation marks. It is recommended to use a significant name like u15_playerstats to know what the tables are used for if you look in your database.
 
 
 
$astablename = 'allystats';
 
 
 
Write the name of the allystats table in the quotation marks. It is recommended to use a significant name like u15_allystats 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.
 
 
 
$dbhost = 'localhost';
 
 
 
Write the address (e.g. localhost) for your MySQL database in the quotation marks. You will get the address from your webhoster.
 
 
 
== /secret/attributes.php ==
 
Now if you have edited config.php it is time to edit some stuff to give it a other look. Now in the same map (secret) there is a file
 
called attributes.php open in and we are gone chance 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!
 
 
 
$statspage = 100;
 
 
 
Number of entries at the statistics page. If you don't like to scroll down use a smaller number.
 
 
 
$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.
 
 
 
$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 and polish.
 
 
 
$default_charset = 'iso-8859-1';
 
 
 
This iso-code should work for most languages. If not - adjust it for your needs.
 
 
 
Modify the main menu
 
 
 
$additional_links_english = array(
 
'Ogame' => 'http://www.ogame.org'
 
);
 
 
 
In this example the main menu gets an additional link to the OGame startpage.
 
If you like, you can add new links (e.g. to your alliance board) by adding a new entry.
 
 
 
$additional_links_english = array(
 
'Ogame' => 'http://www.ogame.org',
 
'Allyboard' => 'http://www.yourallypage.com/path/to/board'
 
);
 
 
 
The more links you add, the more complex the main menu will get.
 
You modify only the english main menu in this example. If you want to have the extension in other languages too, you need to modify their array too.
 
 
 
 
 
 
 
=== Ostat ===
 
 
 
After several requests to add links to ostat these links are integrated now.
 
You need to modify the ostat-server (&quot;de&quot; for german, or &quot;org&quot; for english universes).
 
You should always fill in the universe value, to help other users to know for which universe the tool is used. The universe is shown above the main menu if you have filled in a value.
 
 
 
$ostat_universe = '25';
 
$ostat_server = 'org';
 
 
 
This is an example for the english universe 25.
 
  
 
== After installation ==
 
== After installation ==
  
After the installation you have to delete the install.php and the update.php!
+
After the installation you have to delete the install.php and the update.php! Then you can logon with the account data created during installation.
  
The first login:
+
=== Important for those hosted on a Linux Server ===
Loginname: admin
+
'''Please note: the following setting can also be harmful for the Galaxytool, so you cannot logon at all, but see only a white page or a Fatal error when you try to do so. This is therefore no general solution.'''<br>
Password: galatool
+
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: search for session.auto_start and change its attribute of 0 to 1, then save it. Now you should be able to log into gtool as you normally would.
  
You should change the password for the admin account after you log in the first time!
+
[[de:Installation]]
 +
[[es:Instalación]]

Latest revision as of 15:06, 16 March 2013

General

After downloading the ZIP file, you need to extract it. After that you need to upload all files to your server. Now you should set writable permissions to the config folder. Then, start the install.php on your webserver by typing

http://example.com/path/to/galaxytool/install.php (this address is just a template!)

in your browser and have a look at the screen.

Now follow the instructions on the screen. They will give you detailed information about what to enter or they'll tell you, if something did not work as expected.
Everything is created automatically during installation - no need to edit any file.

After installation

After the installation you have to delete the install.php and the update.php! Then you can logon with the account data created during installation.

Important for those hosted on a Linux Server

Please note: the following setting can also be harmful for the Galaxytool, so you cannot logon at all, but see only a white page or a Fatal error when you try to do so. This is therefore no general solution.
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: search for session.auto_start and change its attribute of 0 to 1, then save it. Now you should be able to log into gtool as you normally would.