|
|
| (23 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| − | == Note: Excellent Installation guide==
| |
| − |
| |
| − | An installation guide by Cyberzero can be found on the [http://board.ogame.org/board703-miscellaneous/board156-archive-version-2-0/board705-help-questions-archive/board631-faq-s-guides/273337-galaxietool-guide-v3/#post4677935 OGame forums.]
| |
| − |
| |
| | == General == | | == General == |
| | | | |
| − | After [[Download|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. | + | After [[Download|downloading]] the ZIP file, you need to extract it. |
| − | | + | After that you need to upload all files to your server. |
| − | '''Note:''' Use Wordpad or a good text editing program and NOT Notepad to edit these files, otherwise things could get garbled.
| + | 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 |
| − | == 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"). 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.
| |
| − | | |
| − | | |
| − | | |
| − | | |
| − | $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.
| + | http://example.com/path/to/galaxytool/install.php (this address is just a template!) |
| | | | |
| − | $utablename = 'user';
| + | in your browser and have a look at the screen. |
| | | | |
| − | 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.
| + | 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.''' |
| − | $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. In the same folder ("secret") 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,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 [[Toolbar|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:
| |
| − | | |
| − | [[Image:Installation.gif]]
| |
| − | | |
| − | 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 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:
| |
| − | 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|User Options]], not in [[User_management|User Management]]
| |
| | | | |
| − | === Important For those hosted on a Linux Server === | + | === 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. | + | '''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> |
| | + | 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. |
| | | | |
| | [[de:Installation]] | | [[de:Installation]] |
| | [[es:Instalación]] | | [[es:Instalación]] |
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 the installation you have to delete the install.php and the update.php! Then you can logon with the account data created during installation.
