==== How to install Information Exchange ====

Please make sure you read [[InfoXLicensing our licensing]] before continuing.

== Requirements for [[InfoExchange]] ==
~-A webserver capable of running PHP (we used Apache)
~-PHP 4.3 or greater
~-MySQL 4 or greater

== Quick guide ==
~1 Make sure you meet the requirements listed above
~2 Obtain a copy of the software from [[InfoXDownloads our download page]]
~3 Uncompress the software in a web accessible folder (tar -zxvf, unzip etc)
~4 Use the SQL creation script
~5 Edit includes/config.inc.php and set the database variables and email variables
~6 Navigate to the site and log in as an administrator (admin/test)
~7 Use the software - please view down below the section titled "Translation Notes"


== The Longer, more detailed guide ==
~1 Make sure that you have PHP 4.3+ or MySQL 4 on your server.
~~- create a script with just ##phpinfo();## in it to obtain information about your copy of PHP, or if you have shell access and a CLI version of PHP you can use ##php -version##
~~- to obtain your MySQL version you can type ##mysql -v##

~2 Visit [[InfoXDownloads our download page]] and pick the appropriate version and appropriate archive form. Windows users probably want the ##.zip## file and Unix/Linux (this includes OSX) users probably want the ##.tar.gz##

~3 Decompression
~~- Users with a ##.zip## file can use Win Zip or another utility to uncompress
~~- Users with a ##.tar.gz## file can either use Win Rar (windows) or use ##tar -zxvf infox-whatever.tar.gz## (Unix/Linux and variants)

~~ //where # represents a number in your file name (eg infox-0.98.tar.gz)//

~4 ##mysql -u (username) -P < dump.sql## from the /sql directory

~5 Edit ##includes/config.inc.php## and at least set up the database variables and the email url

~6 Go to wherever you put the installation - for example http://localhost/infox-0.98/ - and log in with the upper left hand corner, using the pair "admin" and "test" as username/password

~7 Read the section below titled "Translation Notes"

Now that you're set up, read [[InfoXHelp our help]] for more details!


== Translation Note ==

Right now Info-Exchange is rigged to provide both a Spanish and English version, the default language is set to Spanish. If you want to view the english version without being logged in append ##?l=en## to any URL.

If you want to change the dictionary please edit the database tables ##lang_en## and ##lang_es## respectively. If you edit any of the KEY field, or add new ones you will need to go into the PHP and edit the ##translate()## call for that string. If you wish to add a new dictionary, make ##it lang_[tag]## and go into the ##languages## table and insert a record with the tag, description and enabled (set to either 0 or 1). Then insert the translation into ##lang_[tag]## for all the keys in the system.

<< Hint: it might help to dump ##lang_en## or ##lang_es## to get all the keys. [[http://sourceforge.net/projects/phpmyadmin phpMyAdmin]] is quite nice, or you can find another front-end tool on the web. <<::c::
Adding pages is easy:

~-Write the PHP
~-Instead of plaintext, have a call to ##translate()## on a key for the new text
~-Insert records into the DB for all the languages for the new key

Adding a dictionary:

~-Create a table called ##lang_tag## (where tag is like en, esr, es, fr) with the structure of ##lang_tag(KEY, value)## where KEY is also a primary key/unique. Both fields are varchar.
~-Insert a record into languages, example: ##INSERT INTO languages(tag,description,enabled) VALUES('en','English',1)##
~-Do a bunch of inserts for the KEY value, with the string value being your languages' equivalent.

----
This page is [[CategoryInfoExchange]]