The document provides instructions for setting up a development environment for Ushahidi including downloading prerequisites like GIT and PHP, cloning the Ushahidi code from GitHub, setting up the database, and introduces concepts like MVC and the Kohana framework. Examples are given of models, views, and controllers in Kohana and basic GIT commands are outlined along with learning resources for GIT.

2. Introduction to MVC and the Kohana (PHP) framework

4. Setting up: Code Download and Install GIT (more later) http://git-scm.com/download Clone (‘Checkout’) the code cd [WORKING DIRECTORY] git clone git://github.com/ushahidi/Ushahidi_Web.git Fire up editor (e.g. Zend) and set up a new project from existing code

6. Setting up: Database Create a database in mysql called 'ushahidi'. Run USHAHIDI_ROOTqlnshahidi.sql against DB Go to USHAHIDI_ROOTpplicationonfigatabase.php and edit the user, database and host configurations.

7. What is MVC? Model-View-Controller Separates: M: Data model V: Presentation (UI) C: Business logic Can change any of these three without affecting the others (in theory)

8. What is MVC? A Model represents a data structure, usually this is a table in a database. A View contains presentation code such as HTML, CSS and JavaScript. A Controller contains the page logic to tie everything together and generate the page the user sees.

9. Why use an MVC framework? Avoid “reinventing the wheel” Use proven, tested code Automation (ORM, generators) Maintainability “Plugin” functionality …

10. Flow: Traditional vs. MVC Query Controller Model Processing Output Output Query Output Processing View Final Output

11. Kohana Kohana (http://kohanaframework.org/) is a PHP5 framework that uses the Model View Controller architectural pattern. It aims to be secure, lightweight, and easy to use. Documentation: http://docs.kohanaphp.com/ http://learn.kohanaphp.com/

15. class Country_Modelextends ORM { protected $belongs_to= array('location'); protected $has_many= array('city'); // Database table name protected $table_name= 'country'; } Example Model: Country

16. <div id="content"> <div class="content-bg"> <!-- start search block --> <div class="big-block"> <h1>Search Results</h1> <div class="search_block"> <?phpecho $search_info; ?> <?phpecho $search_results; ?> </div> </div> <!-- end search block --> </div> </div> </div> </div> </div> Example View: Search Results

17. Example Controller: Error class Error_Controllerextends Controller { /** * Render Custom 404 Error Page */ public function error_404() { Header("HTTP/1.0 404 Not Found"); $this->layout = new View('error'); $this->layout->title = Kohana::lang('ui_admin.page_not_found'); $this->layout->content = Kohana::lang('ui_admin.page_not_found_message'); $this->layout->render(true); } }

18. Working with GIT GIT is a version control system much like SVN The concepts are more or less the same - revisions, commits… Ushahidi hosts source code repositories with GitHub - http://github.com/ushahidi http://github.com/ushahidi/Ushahidi_Web

19. Basic commands

20. Learning Links GitHub Guide - http://github.com/guides Git Home - http://git.or.cz/ http://github.com/guides/git-cheat-sheet Git - SVN Crash Course - http://git.or.cz/course/svn.html O'Reilly Webcast: Git in One Hour - http://www.youtube.com/watch?v=OFkgSjRnay4

21. More Developer guide: http://wiki.ushahidi.com/doku.php?id=developer