Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/eyedol/agbena

a little project
https://github.com/eyedol/agbena

Last synced: about 5 hours ago
JSON representation

a little project

Awesome Lists containing this project

README 

        



Ushahidi - 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 and get some help. In addition to the forums, we have a wiki with more detailed information about the platform.


          
System Requirements


    

          
  1. A server with Unicode support.
    2. 

                        
  2.  MySQL version 5.0 or greater.
    3. 

                        
  3. PHP version 5.2.3 or greater.
    4. 

                        
  4. 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.
    5. 

              


          
Required Extensions


          
The follwing is a list of PHP extensions that must be installed on your server in order for Ushahidi to run properly.


                
    

                    
  1. 

    PCRE must be compiled with –enable-utf8 and –enable-unicode-properties for UTF-8 functions to work properly.
    2. 

                        
  2.  iconv is required for UTF-8 transliteration.
    3. 

                        
  3. 

    mcrypt is required for encryption.
    4. 

                        
  4. 

    SPL is required for several core libraries
    5. 

                        
  5.  mbstring which speeds up Kohana's UTF-8 functions.
    6. 

              


                



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
    • 

                


            

          
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


                
    

                        
  1. Upload the unpacked/unzipped Ushahidi files to your server.
    2. 

                        
  2. Make sure the appropriate files are writable by your web server (see "Preliminary Setup" above).
    3. 

                        
  3. Point your browser to the http://[Your Ushahidi URL]/installer and follow the step by step instructions. 
    4. 

                    



          
Manual Installation


                
    

                        
  1. Upload the unpacked/unzipped Ushahidi files to your server.
    2. 

                        
  2. Create a database and note the connection credentials.
    3. 

                        
  3. Make sure the appropriate files are writable by your web server (see "Preliminary Setup" above).
    4. 

                        
  4. Copy or rename ./application/config/database.template.php to ./application/config/database.php.
    5. 

                        
  5. Edit database.php and provide it with your database credentials.
    6. 

                        
  6. Copy or rename ./application/config/config.template.php to ./application/config/config.php.
    7. 

                        
  7. 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.
    8. 

                        
  8. Create the appropriate tables into your database by executing the sql statements in the following file: ./sql/ushahidi.sql

    9. 

                        
  9. Browse to your site:

                          
      

    •  URL: http://[Your Ushahidi URL]/

      • 

    • Admin Area: http://[Your Ushahidi URL]/admin

      • 

                              
    • User: admin

      • 

                              
    • Password: admin

      • 

                            
    

                        
    10. 

                    


                

          

          

          
Online Resources


          
For further references and documentation, head over to our wiki. Also, we encourage you to drop by our forums if you have any additional questions or concerns.