ushahidi / Ushahidi_Web
- Source
- Commits
- Network (39)
- Downloads (5)
- Graphs
-
Branch:
master
Brian Herbert (author)
Fri Mar 26 14:16:23 -0700 2010
name | age | message | |
---|---|---|---|
.gitignore | Sun Mar 14 21:11:58 -0700 2010 | ||
.htaccess | Tue Mar 09 14:45:07 -0800 2010 | ||
License.txt | Thu Mar 05 16:29:48 -0800 2009 | ||
README | Wed Mar 24 08:22:01 -0700 2010 | ||
application/ | Fri Mar 26 14:16:23 -0700 2010 | ||
favicon.ico | Fri Nov 07 14:40:33 -0800 2008 | ||
index.php | Thu Jul 16 09:23:21 -0700 2009 | ||
installer/ | Fri Feb 26 06:15:51 -0800 2010 | ||
media/ | Tue Mar 09 10:07:25 -0800 2010 | ||
modules/ | Mon Mar 02 13:16:11 -0800 2009 | ||
readme.html | Fri Dec 04 19:29:33 -0800 2009 | ||
sql/ | Tue Mar 23 08:55:44 -0700 2010 | ||
system/ | Sat Nov 14 10:43:31 -0800 2009 | ||
themes/ | Fri Nov 06 09:50:07 -0800 2009 |
README
WELCOME ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Thanks for using Ushahidi. We hope that you find the setup and installation process as smooth as possible. We have an active community so if you get stuck along the way, head over to the forums (http://forums.ushahidi.com/) and get some help. In addition to the forums, we have a wiki (http://wiki.ushahidi.com/doku.php) with more detailed information about the platform. System Requirements ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - A server with Unicode support. - MySQL version 5.0 or greater. - PHP version 5.2.3 or greater. - An HTTP Server. Kohana which Ushahidi is built upon is known to work with the following web servers: Apache 1.3+, Apache2.0+, lighttpd, and MS IIS. Required Extensions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The follwing is a list of PHP extensions that must be installed on your server in order for Ushahidi to run properly. - PCRE (http://php.net/pcre) must be compiled with –enable-utf8 and –enable-unicode-properties for UTF-8 functions to w ork properly. - iconv (http://php.net/iconv) is required for UTF-8 transliteration. - mcrypt (http://php.net/mcrypt) is required for encryption. - SPL (http://php.net/spl) is required for several core libraries - mbstring (http://php.net/mbstring) which speeds up Kohana's UTF-8 functions. - cURL (http://php.net/curl) which is used to access remote sites. * Need to figure out what extensions you already have installed on your server? Here are instructions to do just that: http://jontangerine.com/silo/php/phpinfo/ Preliminary Setup ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Before installing Ushahidi you will need to give your server authority to write to certian files and folders. Please make sure the following files and folders are writable by your server: - application/config/config.php - application/config - application/cache - application/logs - media/uploads - .htaccess * The process of configuring file permissions is different for various operating systems. Here are some helpful links about permissions for the Windows (http://support.microsoft.com/kb/308419) and Unix (http://www.washington.edu/computing/unix/permissions.html) operating systems. Installation Guide ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Ushahidi can be installed manually or via the web installer. The easiest way to install Ushahidi is to use the web installer as it takes you through everything step by step. Web Installer ~~~~~~~ - Upload the unpacked/unzipped Ushahidi files to your server. - Make sure the appropriate files are writable by your web server (see "Preliminary Setup" above). - Point your browser to the http://[Your Ushahidi URL]/installer and follow the step by step instructions. Manual Installation ~~~~~~~ - Upload the unpacked/unzipped Ushahidi files to your server. - Create a database and note the connection credentials. - Make sure the appropriate files are writable by your web server (see "Preliminary Setup" above). - Copy or rename ./application/config/database.template.php to ./application/config/database.php. - Edit database.php and provide it with your database credentials. - Copy or rename ./application/config/config.template.php to ./application/config/config.php. - Edit config.php and provide it with the appropriate values. The comments in the file will tell you exactly what to provide. In most cases, you won't need to change many of them. - Create the appropriate tables into your database by executing the sql statements in the following file: ./sql/ushahidi.sql - Browse to your site: URL: http://[Your Ushahidi URL]/ - Admin Area: http://[Your Ushahidi URL]/admin - User: admin - Password: admin *Please note: There are still more settings and configurations that you will still need to complete in order to get your instance fully opporational. More information about these settings can be found on our wiki. Online Resources ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ For further references and documentation, head over to our wiki (http://wiki.ushahidi.com/doku.php?id=how_to_use_ushahidi_alpha). Also, we encourage you to drop by our forums (http://forums.ushahidi.com/) if you have any additional questions or concerns.