Home

Ushahidi Manual - Amazon Web Services

image

Contents

1. 3 Ushahidi USHAHIDI GUIDE A STEP BY STEP GUIDE ON HOW TO USE THE USHAHIDI PLATFORM Anahi Ayala lacucci anahi crisismappers net Table of Contents USN UN asec cocci tanec E 3 PUTO URNS GC race caesarean ctiese be sew ee ceva aacessceaeesnouecuacestanniunessssesuccecaueuseensnsnaetessseseneteedesptins 4 1 Installing The Ushahidi platform sssssussusnunnunnunnunnunnunnunnunnunnnnnunnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnne 5 1 1 Server regure me DiS oaia anaa aaa aAa aAa 5 1 2 Downloading the application ssssssssssunsunnnunnnunnnunnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nannaa 5 1 3 Uploading files amp setting permissions ssssssnssunsnnnnnnnnnunnunnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnna 5 14 Installing the SoftWare sssrinin aaan aaa ce acts aaa Aisa 6 Toupre ce cence ost enact sea ete vac cc ences we went ces tetcseepecesecsencecs se ceuteses xs catevcwuss cuevecsucceeueuseeaas 13 2 Customizing your platform sssssnnsnnnnunnnnnnnnnnnnnnnnunnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nannan 15 2L LOS SINS IN siscaisseancsacesescasstivssuninndsicntetansianssiastieiestastasuainabucaseieideatuaaandusvassneincdsinnieneinnadeedinaadsvatesientes 15 Dice WE SCUMICS SO CUO RM oara EE E E N AAEE EEE 17 2 2 1 Website crs ea coc ou coteeennssnten ie ecennestencartm tan ras ssolaesunitioncniatite nasa cena tninatsansansewacundessuisn eesnceneanuecndsetaninarnonennadaees 17 Dee Wl e EAN E E
2. allow you to set these permissions without needing to do so from the command line Here s an example of that Figure 2 is an i elie ete into example of using Transmit for OS X to set the 5 Pes eas i lt wa config php permission on the same config php as in the CHMOD b P bl t Kind PHP Document example above Im able to use lt 4 php Boca Command I to get info on this file the same as lt a SS Pm able to do on the filesystem In that lt EES window you can see Pm able to check the Qi Modified Tue Jan 11 2011 11 54 AM boxes or enter the value of the level of permissions I want to grant on that file e map Mi Read Write Vf Execute Y Read V Write V Execute Most FTP clients provide similar functionality COREE O eat either in the same way or by right clicking on sett Eau rwxrwxrwx the file or folder If you don t see the option to set permissions in your preferred client check the documentation to see 1f it is a feature With that figured out again here are the files and folders that need full read write execute Figure 2 This is an example of using the 777 permissions Transmit FTP client for OS X to set the permissions of a particular file e application config config p hp e application config e application cache e application logs e media uploads e htaccess If this is still confusing not to worry but you should enlist the help of someone more technical to assist you with this pro
3. or make it invisible which is a default page in the main Toolbar 3 To edit the About Us page just click on the Edit tab under Actions and then fill the blank in the page Description Box 6 After clicking the Save tab the page will be available to be read by users in the About Us page from the homepage To add other pages fill the boxes relative to the Page Title 4 Page Tab name 5 and Page Description 6 Once saved this page will be listed in the main Toolbar in the Homepage and be accessible if visible to the users 7 Dashboard Reports Messages Stats Addons Categories Forms Sharing Pages News Feeds Layers Scheduler Cloudvox About Us Edit Visible Delete This is the default about us page 1 3 2 1 Pages 1 Add Edit Page Title 4 5 Page Tab Name Page Description B 7 U a 222322 6 Path p 7 39 2 3 5 News feeds From this page you can set up the Feeds that will appear in the Official and Mainstream News box in the Homepage To add a new RSS Feed click on the Add New tab on the side of the New Feeds title on the Toolbar 1 or just go on the Add Edit box at the bottom of the page The save an RSS Feed and have it appearing in the Homepage insert the name of the Feed 2 and the URL 3 After having saved the new Feed 6 the number of items coming in will be visible 4 after clicking on the Refresh Feed tab on the top of the page 5 The actions tabs on the side
4. 1 the zoom bar 2 the dots on the map 3 representing the reports and the layers button 4 73 FILTERS gt NEWS PICTURES VIDEO TODO VIEWS gt Terms of Use me h T Gat D 10 amp m O 5 mi 1 Scale 1 493K 71 93985 18 67357 EPSG 900913 OpenStreetMap contributors CC BY SA The Map itself is the one you decide to use as the base map and we will explain later how you can choose which map to use Yahoo Maps Virtual Earth Maps Google Maps or the open source OpenStreet Map The first two maps are not customizable while the latter two are customizable This means that if you decide to use Virtual Earth or Yahoo Map you cannot add or remove or change anything in the map itself like names of streets or locations of buildings The Layer button is the blue button on the right side of the map and the one that changes 40 the base layer from one type of map to another in addition to have the satellite view Additionally the Layer button can allow you to add or remove the reports layer on the Map itself 9 See here http wiki openstreetmap org wiki Editing for information on how to modify a map using OpenStreet Map and see here for instructins on how to edt a Google Map http www google com mapmaker mapfiles s support html 4 To be able to switch from one map to another like from Google Map to OSM using the layer button it 1s required to work on the code As default function the button
5. Item per page Front End This is where you can choose how many items will be displayed in the pages opened by the user such as the Reports page or the News Feeds page 10 Item per Page Admin This is where you can choose how many items will be displayed in the Admin page like the Reports page or the Message page 11 Allow Users to Summit Reports You can decide to have the Submit Reports in the main toolbar on the homepage to allow users to submit report using the online form If the NO 1s selected the page will not be available for users to submit reports directly on line but they will still be able to send emails to the address showed on the homepage or to send SMS if configured 12 Allow Users to Submit Comments to Reports Here is where you can decide to have the Comments function in the Report page If the no is selected the users will not be able to comments on reports uploaded in the Ushahidi 11 platform 13 Include RSS News Feed on the Website This is where you can decide if you want to have the RSS Feeds Box displayed on the homepage 14 Enable Statistics Stored on Ushahidi s server Hit statistics are stored on a server controlled by Ushahidi By enabling this option you gain access to hit statistics directly in your admin panel By disabling it you will stop See section 4 7 1 for how to change languages from the homepage 8 See section 4 5 to see more on the Contact Page See
6. O Yes No Source Reliability 3 Select One Information Probability 4 Select One 2 For more info on Verification of information see http community ushahidi com uploads documents c_Ushahidi Verification Guide pdf 52 3 2 2 Create Report The Create Report tab will bring the administrator to the form to be filled to create a report This form is identical to the form in the user page but also has the Information Evaluation Box Through this page the administrator can create a report and publish it directly to the 30 map Dashboard Reports Messages Stats Addons Settings Manage Users View Reports Create Report comments Download Reports Upload Reports New Report SAVE REPORT SAVE amp CLOSE CANCEL FOrM Select A Form Type Incident Location Latitude Longitude Default Form rg TITLE Description Include as much detail as possible City State and or Country PND LOCATION Search for your location using a location name of latitude longitude coordinates format 38 19 85 61 or click on the map to pinpoint the correct location Modify Date Today at 8 27 pm Modify Date Refine Location name Example Corner of City Market 5th Street amp 4th Avenue Johannesburg Categories Select as many as needed New Category 1 URGENCES EMERGENCY 02 URGENCES LOGISTIQUES VITAL LINES hears suie tea News source link 4 MENACES SECURITY THREATS a aati
7. Ushahidi will not do this for you If you re unsure how to do this but using a fairly standard website hosting provider you likely have access to cPanel or another GUI to help set this up or other documentation to help General The Site Email Address will be one that is publicly displayed on the website something to take into consideration before you launch as you may want to create a new account for this Mail Server This one can be tricky more on this when we get to that screen Map Ushahidi provides several options for base layers for the map displayed on your website many options Google Yahoo and OpenStreetMap Technically you don t need a Map Provider to start but should you want to use Google Maps as your base layer you ll need to obtain an API key from them Click on the Advanced Installation box to begin The first screen Fig 2 1s for entering our database information By now you ll want your database created and the login information handy so enter that under database name user name and password 1 Database 2 General 3 Mail Server 4 Map 5 Finished The location on your server where you placed your Ushahidi files We have automatically detected this Base Path value please make sure that it is correct If the field is empty do not worry it means ushahidi is installed at the top level directory Database Name The name of the database you want to run
8. one that s universal for upgrading any web application backup the application files and the database This is very important so that should anything go wrong you can restore your website to it s current state We can t gt See section 2 2 2 See section 2 2 3 13 fully stress how much you should do this before proceeding While the Ushahidi team has put a lot of effort and testing into making sure this process goes smoothly always plan for the worst Now that your website is backed up step two is to download the newest version of the application from one of the two sources we described earlier the ushahidi com website recommended or from our repository on GitHub Once you have that just like with our first installation unzip the files on your computer Next we have to upload these files to the server but let s be careful not to overwrite files and directories we changed during the initial installation Let s have a look at the complete application directory structure and review what we need to set aside while we upload the new files and folders Since the 2 0 release of Ushahidi we ve taken steps to remove most of the folders you ll will not want to replace during the upgrade process These include the plugins themes and media folders There s two other files you ll want to either download to your computer or move to another part of the server the config php and database php file
9. 3013936590 View Messages SMS Edit Delete 7 Messages 147 Reporter Level 3115166604 View Messages SMS m 9 D oO i Messages 2 Reporter Level Untrusted 3126275613 View Messages SMS Edit Delete 8 Messages 1 Reporter Level MUSC RA Gay To register a phone number as trusted and verified you need to click on the reporter number and you will be asked to flag that reporter as trusted or trusted verified and also choose which means meaning SMS e mail Twitter or Laconica this reporter will use to deliver messages to your deployment Once you have chosen a reporter as trusted all the messages coming form him will be marked with the color corresponding to his mark meaning in green for trusted verified and in blue for trusted only C Test from krtm Abdelgadir 2011 01 08 Preview Message Create Report Delete From 249910301303 O Test Preview Message 2011 01 08 Create Report Delete Reply From 249902555142 _ reporters3 tiff Test JUBA Preview Message Reply Dashboard Reports Messages Stats Addons From 249902555142 00 M ee SMS Email Twitter Laconica Reporters DELETE SPAM Delete SPAM Untrusted Trusted Verify 3115166604 Search All Email Laconica Twitter O 3115166604 view messages SMS Edit Delete Messages 2 Reporter Level Untrusted 1 Pages 1 You can also set the location of a certain reporter by clicking on edit and choosing
10. Incidents List The Incident List Box appears below the Timeline and it shows the list of reports in chronological order starting from the most recent one The list shows the title of the report 1 the location 2 and the date it has been submitted or the date referred to the event reported 3 By clicking on the title you will be directed to the Report Page where you will be able to see the description of the event and all the specification of the event reported Incidents from the map listed in chronological order 1 ymme 2 eocation S oare Hello Ushahidi Nairobi Nov 1 2010 Rained Last Night Tents Urgently Needed saint marc haiti Mar 22 2010 eeded Rue Magasin de l etat Continue Rue Magasin O de l etat 2010 Continue Portail Leogane Aid needed Santo 19 7 Croix des Bouquets Santo 19 7 Mar 16 Croix 2010 des Bouquets Medical assistance needed for sick child Gonaives Mar 15 2010 Food needed Thomazeau Thomazeau Mar 15 2010 Aid needed Brochette 99 Brochette 99 Mar 15 Carrefour 2010 Food Water and Tents needed Delmas 75 Delmas 75 Rue Mar 15 Berenice 2010 Port au Prince Food Water and Shelter needed Village Village Canaan Mar 15 19 2010 Food Water and Sanitation facilities needed Marassa 7 Mar 15 Croix 2010 des Bouquets View More Aid needed Rue Magasin de l etat Continue Portail Leogane Edit Description am Feliger Jean Eddy live in Magaz
11. Location from previous messages Gonaives Time 2010 03 15 14 41 10 Credibility J Comments Anahi Jan 8 2011 We live close to this area and can confirm that this building is collapsed pm Rating e By Leave A Comment Name Email Comments Security Code L YAQ Submit Comment Visualization on the map Date time and location of the incident Comment s added by user s Additional Reports related to that event 4 oa Map ve 72 47406 4846789 Gos tome Pilate L pon Mouk e La Matin Ramier Belizaire rd La Pewou gt Decin Dubedou zorr Ti cone i Piston Cune Ptaton m m Du Fosse S Latanier 1 Mipu I S Danache Dolan I nner E Le Tico Annivert gt Sonal rois Ponts Clavin P Bae des Gonaives M lt Sabane La Chapelk Rande R Baie de a Tortue M re Louite X L estere O PA Largue F B Johan isse Bare Fo eT Bahi de Ti Desdurves Srand Pierre oped Modelle Hautes Q 433K Feuilles ar Rossiano ronment Chauvet Mag 20 1 i i Wider map 7 Additional Reports Medical assistance needed for sick child Gonaives Looking for my Mom 20 30 people in Gonaives home need Help Aid needed in Gonaives Gonaives needs aid 5 For more info on Verification of information see http community ushahidi com uploads documents c_Ushahidi Verification Guide pdf 4 3 Submit a Report Submitting a report to an Ushahidi platform
12. Messages Stats Addons D Wwellite 2 3 iea Hom P y 2 2 1 Website The Website page is the one where the administrator chooses the main appearance settings of the Ushahidi platform mainly the characteristics of the homepage the main navigation and the contact information I Site Name This is the main title that appears on the right side of the your homepage and it is normally the title of your project 2 Site tagline This is the tagline that appears below the title on the home page which normally gives more detailed description of what the platform is about or what the platform intends to monitor or show 17 3 Site Email Address This is the email address that will be shown in the Information Box on the home page which is the one that users will use to email you information or reports This email address will be publicly displayed on the website so it is recommended that you create an email address specifically for this and not to use a personal one To have this function working you need to configure the email account settings by clicking on the configure your email account settings or just by clicking on the Toolbar tab Email 4 Alert Email Address This is the address that will send the Alerts via email It is possible to use the same address configured in the Site Email Address section above In this case remember that the POP function of the email account needs to be allowed in order to be able to send
13. St Michel 4 Zoom In Zoom Out bs ina A msn esr esoo O 76 4 1 2 The Categories On the right side of the Map you will find the categories Each category indicates a typology of information and this may vary according to the issue you want to monitor Each category can have a sub category and you can have as many sub categories as you want For the sake of displaying several categories but keeping the site design simple the sub category will not appear automatically but will appear by clicking on the main category they belong to FILTAR CATEGORIAS l j O 10 Terms of Use Sanjuan m l 79 e ea 4 E 141 lt Mape U Aa A ie TODAS LAS CATEGORIAS I s j RA L 20 EA T a x fa 8 T RA E RA G anaa KM V2 Tiasa ota o0 gorp Mendoza N y Pe gt j 147 h IA n Al BA j rT f ry pt ValparalsoO 4 J S N AS Y San Martin fac ye ry am antiago a 7 eye 2 l gt a 4 lt Villa p 1A ESTRUCTURA COLAPSADA is gone pee 7 a Sub Categories dai Mae eC Curic f San Rafael mm A b 1B INCENDIO 4 PS me FH Aol s 40 X 1C PERSONAS ATRAPADAS i Constituci n ca N J y A S A E A RMenares 2 C RA Ca f i tr Parral ps Ta 4 os Y TENOS Se RA a 1010 B o Pei Taner r Chil n f f 151 E A 1D URGENCIAS MEDICAS alcanhuano j j Sy r fale a Cor X f J gt t 37 a fi x l 100 k
14. Ushahidi platform Ushahidi 2 0 which allows for the use of apps or plugins to further extend and customize the platform We also added geometry mapping so you can map infrastructure or areas and not just dots This guide will give you a step by step overview on how to set up your own Ushahidi map and how to make full use of all the features that the Ushahidi software offers If you d like to learn more we have additional resources available online for you http forums ushahidi com http community ushahidi com http wik1 ushahidi com doku php http www ushahidi com get involved resources This guide will be updated based on the feedback we receive for from you So please do get in touch with any suggestions or questions you may have Finally a big thank you to Anahi Ayala Iacucci for authoring this much needed guide for the community About this Guide This is a guide on how to use the Ushahidi platform Within we will explain how to download and install the Ushahidi platform review the platform s administrative capabilities and briefly introduce the more advanced options for customizing and extending your deployment through plugins and themes The guide will then introduce the main features of the Ushahidi platform explaining all the tabs and functions that your users will interact with once your map is live on the web As we cover Ushahidi s administrative section we will explain how to manage the platform and will de
15. Verify Delete View Reports Create Report Comments Download Reports Up Help croix des bouquets santo 19 7 Time 2010 03 16 10 09 54 More Edit Report Location Santo 19 7 Croix des Bouquets Kenya Submitted By Unknown via WEB Categories 2 URGENCES LOGISTIQUES VITAL LINES 2B PENURIE D EAU WATER SHORTAGE 2D REFUGE SHELTER rm NEEDED 2A PENURIE D ALIMENTS FOOD SHORTAGE Dss Edit Log 0 TITLE 1 Medical assistance needed for sick child Gonaives 2010 03 15 Delete HAVE A CHILD OF 7 MONTHS HAS BEEN HIT BUT IT AFFECTS HIM HSE NOW Time tis si 2010 03 15 11 43 08 have a child of seven More Location Gonaives Kenya Submitted By Unknown via WEB Categories 18 URGENCE MEDICALE MEDICAL EMERGENCY PUBLIC HEALTH Edit Log 0 a r Coun Tieeded Thomazeau 2010 03 15 Approve Verify Delete I m in Thomazeau don t have food is they forget us in that zone we re hardly hungry p J ocation name Time 2010 03 15 12 50 54 More Location Thomazeau Kenya Submitted By Unknown via gies source l anaes 2A PENURIE ALIMEN Edit Log a pload Aid needed Brochette 99 2010 03 15 Approve Verify Delete live has Brochete 99 in the middle of the Market me ever to find no help of which they distribute Time 2010 03 15 11 12 02 More a Brochette 99 Carrefour Kenya apg z Unknown ia WEB Aiaia iliran Bhain Categories 2B PENURIE D EAU WATER SHORTAGE 2D REFUGE SHELTER NEEDED 2A PENURIE D ALIMENTS FOOD First N
16. Video link DAMAGE t 6 NATURAL HAZARDS Upload Photos 7 SECOURS SERVICES AVAILABLE M8 AUTRE OTHER Trusted Reports 30 See section 2 3 to see how to create a report 53 If you have a new version of the Ushahidi platform you may see a slightly different box under the map In the new version in fact you will have the options to select an area 1 or more than one point for your report location 2 In the case you select one area or more than one point for one report report in the public map your dot will be appear in the middle of the area Ones the user will open you report page he she will be able to see the area selected or the multiple locations associated with that report In addition to that you will also have the possibility to see a larger map on the report page 3 Incident Location Search for your location using a location name of latitude longitude coordinates format 38 19 85 61 or click on the map to pinpoint the correct location SAVE REPORT SAVE amp CLOSE CANCEL Latitude 36 77399659 Longitude 3 049821849 3 wider map Pe Ker ZAA ried fa tae et eed ht ony ae eG K A f e Ss Wy lt a FIND LOCATION 54 3 2 3 Comments The comments section allows the administrator to view and manage all comments that are submitted to reports on the website The comment lists 1 allows the administrator to view all comments in the system It also allows them to see just thos
17. deployment For a quick fix to this while the FrontlineSMS programmers are sorting out 30 the issue have a look at the Ushahidi Wiki Remember that your phone may freeze occasionally or the connection to the phone may be lost so you need to keep an eye out for this and restart the phone and or the computer to fix this Option 2 Use a Global SMS Gateway To configure Clickatell as your SMS system in the Ushahidi platform you need to go to Addons section in the main toolbar 1 activate the Clickatell plugin 2 and click on Settings on the site of the Plugin name 3 Image Step 1 Sign up for Clickatell service by following the link on the page and get an API key Step 2 Go back to the Ushahidi SMS page and enter your Clickatell API number that you received after signing up for Clickatell service Step 3 Enter your Clickatell Username Step 4 Enter your Clickatell Password You should get it from Clickatell Step 5 Click on Save Settings button to save the entries Settings Website Map SMS Sharing Email Themes SMS Setup Options Option 2 Use a Global SMS Gateway Step 1 Sign up for Clickatells service by clicking here Step 2 Enter your Clickatell access information below Your Clickatell API Number Your Clickatell User Name Your Clickatell Password SAVE SETTINGS CANCEL The Clikatell plugin will allow you to use Clickatell for outgoing messages like the SMS alerts system If
18. eee 79 AAS TOW CO ROD OLE BOX vic ecet santo teteeeececatanesheniceeer teats niet ac neacdieccetotndide needa densainen eee 80 AAG The Mncidents EiS Ciacaeetaie steerer teaeteoiee ie A 82 4 1 7 The Official and Mainstream Ne WS sscssssssssssesesssesesssesssesssessnessnsssnsnensesnsnsnsansenesonesoessoraraes 83 AZ REDPOTTS innig aa Ae La EAEE 84 AES SUIT a REPO sna cea eee eee ec es sae cece es eect een eect 86 AAP AG OU AGES a a Eaa Eea a E 90 4S Contac US ee ose cei ee tama asec ees estes waco tice dec eaipu cau ea aeesnee nice sucancaue vated evemomceetereeees 91 AEG POU US said cess srs an seated A cnn duces dewea acicauebnssceesvenedecetissctastenvccnesabetuancduacuestas 92 ALT POGMIOMAL BUCCI cbkcn dea lacka ces sabes aa eea as aa Raa a 93 AT NDGA WAC CS anaa E a E a i 93 AT 5 SO A E E A E E E dla E O EE A E ATEA E E T 93 Ushahidi The first Ushahidi platform was launched during Kenya s post election violence in January 2008 Ushahidi means witness in Swahili The Ushahidi platform is free and open source The software allows individuals and groups to collaborate in creating live multi media maps for all kinds of projects For example the Ushahidi platform has been used for projects focusing on local governance environmental monitoring public health mapping human rights monitoring citizen based election observation nonviolent protests disaster response and crisis mapping We recently launched the second version of the
19. email to myemalgmyhost com 3 By sending a tweet with the hashtags fushahidiguide 4 By filing this form Call 11111111111 Incidents from the map listed in chronological order 6 Official amp mainstream news 7 TITLE LOCATION DATE TITLE SOURCE DATE Hello Ushahidi Nairo Now 1 2010 Rained Last Night Tents Urgently Needed sant marc haiti Mar 22 View More 72 In addition to that on the Ushahidi user main page there 1s the toolbar which has five navigation items in addition to the Home one leading to different pages 1 Reports 2 Submit a Report 3 Get Alerts 4 Contact Us 5 About Us Lastly on the top of the Toolbar there are 3 additional buttons A Submit a report B Languages C Search B English US sd C Q Ushahidi My Ushahidi Deployment All ntti HOME 1 2 3 4 5 This is test for the Site message FILTERS gt NEWS PICTURES VIDEO ALL CATEGORY FILTER HIDE fe FULL SCREEN MAP a oO om dio 6 O PN g Mi 1 URGENCES EMERGENCY I 4 MENACES SECURITY In addition to that you can customize your home page in order to add additional boxes like a Twitter Box a Picture Box or a Google Finder Box or anything you would like to have on the Home Page Those customizations will require some work on the code and are not default functions of the Ushahidi platform 4 1 1 The Map The Ushahidi map is an interactive map and it is composed of four different parts the base map
20. in the homepage The scroll down menu allows you to select a country 1 Below the scroll down menu you can set up your Ushahidi platform to include different countries 3 and you can also retrieve cities from geo names to have them displayed in the scroll down menu in your report form 2 Default Location Please select a default country Kenya 1 Retrieve Cities From Geonames 2 Does this Ushahidi Deployment Span Multiple Find a location near you Countries L PE annn 7 O Yes No 3 Select a City Eldama Ravine Eldoret Embu Faza Finno J Gari ssa fettere det Artibaonte F Gazi a a Homa Bay aia Isiolo Kabarnet Kajiado Kakamega Kangundo k Kapsabet f S Scale 1 2M Karuri f Dar es Salaam i Baraha City State and or Country Search for your location using a location name of latitude longitude coordinates format 38 19 85 61 or click on the map to pinpoint the correct location BLE Map provider This section allows you to select which type of base map you want for your project This section guides you step by step in the setting up of the base map e Step 1 There are four default providers Google map Yahoo Map OpenStreetMap and Visual Earth 1 e Step 2 If you chose a Google Map you need to get an API key and to put this key into API box By clicking on Get API you will be forwarded to the page where the provider will give you the AP
21. may limit the amount of calls other tools may make to the system generally or specifically by IP address If you would like to read more about the technical aspects of Ushahidi s API more information 1s available on our wiki at http wiki ushahidi com doku php id ushahidi_ api 34 2 3 The Manage Section The manage section is the section that allows you to set up the main characteristics of the platform as related specifically to your project The Manage page is accessible from the Admin page on the right end of the page When accessing the Manage page a Toolbar will show the eight pages from which the following settings can be modified and customized Categories Forms Sharing Pages News Feeds Layers Scheduler Cloudvox SS ee ee a 2 3 1 Categories The Categories page is where the categories of the reports can be set up The default Ushahidi page has default categories set up which can be deleted and substituted with the ones chosen by the administrator of the project The categories list shows the name of the category 1 the description below the name 2 the color of the category on the side or the icon 3 and on the far end of the raw the actions that could be done Edit 4 Visible 5 and Delete 6 To delete a category just click on the Delete tab and a confirmation message will appear by confirming the action the category will be permanently deleted To edit a category click on the Edit tab and the charac
22. more advanced actions for instance scheduling different responses by date click here to go to advanced view 29 At the bottom of the screen click on Auto Reply and in the menu that pops up select the External Command option then click the edit button to the immediate right BA Auto Reply v oe O Step 5 In the window that opens select HTTP Request as the execution type paste the URL you copied from your Ushahidi deployment above into the command text field that is in the Execution Details section and select the Do Not Wait For Response button Leave all the other fields untouched Step 6 Click on Done and that is it any SMS messages sent to FrontlineSMS will also be forwarded to the admin page of your Ushahidi platform g External Command x Execution Type E HTTP Request g Command Line Execution Execution Details B Command http betal 1l ushahididev com frontlinesms key TWKJHBID amp s sender_number amp m mes Click to include sSender Name 5 Sender Number Keyword Message Content L JSMS id Response Type Plain Text FrontlineSMS Commands Do Not Wait For Response g za Start Date a End Date HE w Done 3 Cancel Keep in mind that FrontlineSMS will not retry the HTTP Request if it fails for whatever reason This means that any SMS messages that come into FrontlineSMS while your Internet connection is down will not be automatically forwarded to your Ushahidi
23. of each Feed allow you to delete 7 edit 8 or made Invisible an RSS Feed 9 To see the items of each feed you need to click on the name of the View Items of each Feed 10 and you will be directed to a page where all the items from that Feed are listed For each item coming in you can delete it 11 or create a report out of it 12 To see all the Feeds coming in there is also the Feed Items tab on the top of the page where all the items coming from all the Feeds URLs are listed together For each Feed Item coming in you will see if the geo location is available 14 the source 14 and a preview of the 1tem 15 Dashboard Reports Messages Stats Addons Categories Forms Sharing Pages News Feeds Layers Scheduler Feeds 5 REFRESH NEWS FEEDS co A N N m Relief Web Sudan View Items Edit Visible Delete http www reliefweb int RWFeed Feed RSS20 amp ID 02 P amp cc sdn Visible Delete 9 7 Sudan Tribune View Items 10 http www sudantribune com spip php page backend 1 Pages 1 1 Add Edit Feed Name Feed URL 2 3 6 i 5 _ eed 100 Ti 2 DELETE 40 2 3 6 Layers In this section of the Manage section you can insert the static layers that will appear on the users Homepage under the Map Those static layers are in the format of KMZ or KML Files and can display points or areas To add a new Static layer use the Add Edit box on the bottom
24. of the page 1 After inserting the layer Name 2 the Layer URL if existing 3 and the color 4 you can upload the file in the Upload KMZ KML File section 5 and then Save 6 Once saved the Layer will appear in the list at the top of the page 7 and from there can be Edited 8 deleted 9 or made invisible 10 If the layer is visible it will automatically appear in the Homepage where users will be able to see it by clicking on it Dashboard Reports Messages Stats Addons Categories Forms Sharing Pages News Feeds Layers Scheduler 7 Provinces Edit Visible Delete 8 10 9 KMZ KML File 128095Z70 4all_provinces kml Delete 1 Pages 1 1 Add Edit Layer Name 2 Upload KMZ KML File 100 100 2 41 2 3 7 Scheduler This function of the Manage section allows you to schedule actions related to Alerts 1 Email 2 Feeds 3 Sharing 4 and Twitter 5 The Alert section allows admins to schedule when and how often the Alert system will send out alerts to the users subscribed For the Email Feeds Sharing and Twitter it allows to schedule the automatic refresh of the information coming into the platform By default all those Schedules are set on automatic refresh every day every hour and every minute To change those settings there is the Edit tab on the side of each item 6 which open a box at the bottom of the page where it is possible to change those settings according to Day of the W
25. outgoing messages 5 Site Message The Site Message is an optional message that you can add on the top of your user page and that can be used for different purposes you can use it to advertise your short code if you have one to put a disclaimer of responsibility or anything else you want to let people know straight forward An example is the following Sudan Vote Monitor An Indepe Jent Sudan Civil Society Initiative 6 Site Copyright Message The Copyright message is where you can let you users know what kind of copyright license your platform submitted is under The message will appear on the bottom of the homepage 7 Site Language gt See section 2 2 4 to see how to configure the email account settings and section 3 3 2 to see how to process incoming emails Ibid 18 Here is where you decided the language for your Ushahidi platform This function will not translate the admin part of the platform but only the homepage and the users settings POSSIBLE ABSTRACT Brian s work on the new translation project How to create translation files with link to the wiki rob 8 Display Contact Page Here 1s where you can decide to have the Contact page in the main Toolbar in the homepage If No is selected the page will not be available for users to contact the administrators of the Platform but they will still be able to send emails to the address showed on the homepage if configured 9
26. reported Again it is important to be sure that the format is JPG or similar and that the picture is relevant to the event being reported on Unlike videos it is possible to upload pictures to the platform J Contact information The reporter may include her personal information with report first name last name and email address Typically this is important information to be include because if there is missing information in the report or mistakes the administrator can immediately contact the reporter for clarification This is not required for the system to accept the report but it can enormously help the managers of the platform We should note that in some instances it would not be advised to collect this information keeping in mind the safety and security of the contributors k Submission Button Once all form has been filled out clicking the submit button will add the report to the administration queue for approval If there are missing pieces of information or mistakes in the report the system will ask the reporter to fix the mistakes Note that the default functionality of the system is such that unless a site administrator or editor submits a report the report remains unpublished not public until approved by an administrator It is really important to review all information in the report for accuracy before clicking submit After submitting the report it will be sent to an administrator for approval and verificat
27. section 2 2 4 for how to set up your e mail address 10 See section 4 3 to see how to submit a report using the online form and section 3 2 to see how to process incoming reports submitted via the online form l See section 3 2 3 to see how to manage incoming reports 12 See section 2 3 5 to se how to set up incoming feeds in your platform and section 4 1 7 to see how to use the Incoming Feeds box from the Homepage 19 collecting statistics and will be unable to recover traffic stats collected while this is turned off 15 Cluster Reports on Map This is the function that combines the individual report markers in the same area on the map to display as a clustered dot displaying the number of individual reports in said cluster This function allows one to see how a certain area is affected as compared to other areas Once the user zooms in on the map the clustering disappears while the more you zoom out the more the dots get clustered together Note that this function has some known problems with the KML and KMZ files that carry data and that display areas so if you have those files on your platform you may have to disable the clustering to have the areas display correctly on the map 16 Default Color for All Categories This is the color of the All Categories tab As default this color is set on CC0000 which is red To change the color just click on the tab and use the pop up window that will appear to chose another color 17 Cache Pa
28. tabs allows users to delete the email 7 or to create a report 8 By clicking on the Create Report tab you will be directed to the Report form page where the email body will be already inserted in the Description Box All the administrator has to do is add a title location and date and then submit the report If instead of Create Report there is a green tab that says View Report it means that the email has been already mapped and by clicking on this tab it is possible to access the report page Just like the SMS tab this section can be customized to show directly the text of the email or to show only the subject In this second case there is a Preview message tab that allows the admin to see the entire body of the email 9 By clicking again on that tab the body of the email will return in its hidden format 32 See section 3 2 2 to see how to fill the report form 61 The Reporters tab here works exactly in the same way as explained in the previous section on SMS Dashboard Reports Messages Stats Addons SMS Email twitter Laconica Reporters 2 inbox 1 3 Trusted 0 4 spam 0 DELETE SPAM NOT SPAM a o URGENT questions 1 Have you tested this code 45609910343 from Sudan recently 2011 01 08 Preview Message 6 From i i C HELLO 2011 01 08 9 Preview Message From milalove30 yahoo co in C Re ushahidi message of death 2011 01 08 Preview Message From robleec gmail com 62 Manage Users
29. the row 3 The fields of the default forms can be edited also by clicking on the 4 Edit Form Fields tab on the side of Default Form Editing the existing form Click on Edit Form to have a tab appear on the bottom just above the Create Edit Field called Add New Field 5 Click on this tab and a box will appear allowing you to create a new field in the default form 36 To add a new field you first need to decide if the field will be a Text Area Field 6 which means that the user can insert free text in it or a preselected Field which means that specific text has to be inserted like for example only a number As a second step you have to insert the Field Name 7 which indicates what information is required in that specific field then the default value required has to be inserted in the second box on the side of the Field Name box 8 if left blank it will allow everything to be inserted in the new field In addition to this you can decide if the new field will be required 9 meaning that the users inserting the report will not be allowed to send the report until they fill that particular box and also decide a limit of characters allowed for that specific field 10 and if it is a data field or not 11 Once done click on the Save tab to have all the changes saved 12 Dashboard Reports Messages Stats Addons Categories Forms Sharing Pages NewsFeeds Layers Scheduler Cloudvox Add Edit Default Form Edit Form Fiel
30. to the Report form page where the voice message body will be already inserted in the report The administrator only has to add a title location and date and then submit the report If instead of Create Report there is a green tab that says View Report 9 it means that the voice message has already been mapped and by clicking on this tab it is possible to access the report page 4 Laconica renamed now StatusNet is a FLOSS microblogging server written in PHP that implements the OStatus standard for interoperation between installations While offering functionality similar to Twitter StatusNet provide the potential for open inter service and distributed communications between microblogging communities gt See section 3 2 2 to see how to fill the report form 36 See section 3 2 2 to see how to fill the report form 64 The list of Cloudvox voice messages shows only the sender of the voice message To see the audio file and listen to it there is a Preview message tab that allows the admin to access the two voice files 10 By clicking on the Play symbol it is possible to listen to the files 11 The Reporters tab here works exactly in the same way as explained in the previous section on SMS 12 Dashboard Reports Messages Stats Addons Settings Manage Users SMS Email Twitter Laconica Cloudvox 2 Inbox 1 S frusted 0 4 Spam 0 12 Reporters DELETE SPAM NOT SPAM amp Message Details Date Actions C New Voice M
31. will only allow you to remove or add the Reports layer 74 FILTERS gt NEWS PICTURES VIDEO ODO views gt TEHLES Terms of Use Base Layer OOpen Street Maps Google Streets Google Satellite Overlays sReports aa i oO Gato 2 10km j O O 5 mi AEN Scale 1 493K 72 17331 18 73470 EPSG 900913 OpenStreetMap contributors CC BY SA The red dots on the map represent reports submitted to the Ushahidi platform and the location of the event reported Reports in a similar location are clustered and appear as larger dots with a number on it which tells you how many reports there are in that location To zoom in and out you can use the Zoom bar on the right side of the map The way reports are clustered is by proximity the more one zooms out the more reports get aggregated while the more you zoom in the more reports will separate one from another and appear as a single dot By clicking on a marker an info window will appear showing you the title of that report If you click on a clustered dot the list of titles of all reports in that area will appear If you then click on the title the platform will forward you to the report itself where you will be able to read the entire description of the report See section 2 2 1 of this guide to see how to set up clusterization of dots 42 Go to section 3 2 1 to see how a report looks like and what information you can find in it 75 People need food at
32. 4 MENACES RITY THREATS ASSAINISSEMENT EAU ET HYGIENE WATER News source link SANITATION AND HY GENE PROMOTION g tA PILLAGE LOOTING 3 s Video link 48 THEFT OF AID 46 GROUP VIOLENCE h 40 RIOT Upload Photos Browse i First Name Ui Submit Last Name Email 86 a Title The person reporting an event the reporter provides a brief description of the event no more than one sentence including nearest landmark eg Rally near Al Askari Mosque in Conakry The title is the first thing that users of the map will see so it is important that the title gives an idea of what happened and where b Description The reporter should describe the event in a few sentences It is important to include the following pieces of information who what where when how and any additional contextual information that you feel is important It 1s also important to describe the source of the information e g it is from a secondary or primary source The description should be brief but comprehensive with all the additional information that is relevant to the event reported c Date amp Time This should refer to the date and time of the event rather than when the report is submitted Note that the system automatically inserts the current date and time so the reporter will need to change the entry if the event happened on a different date than when she is submitting the report d Categor
33. 46 min s ago I saw my friends die but could not beat The Standard Jan 7 2011 ICC Case 1 By RENSON MNYAMWEZI ICC Case 2 Related Stories View More Business TAITA TAVETA COUNTY More than 100 000 people in Taita Taveta are in dire need of relief supply as famine Government assures put yn food situatior cituatian eantiniin ta hita tha Caiints 5 To see how to set up the news feeds displayed here go to section 2 3 5 83 4 2 Reports By clicking on the Reports Tab you will access a page that provides a list of all the reports that are in the Ushahidi system The report summary on the top of the page shows total reports approved 1 the average reports per day 2 and the percentage of verified reports over the total of approved reports 3 The reports are listed in chronological order starting from the most recent one and from the list itself it is possible to have an overview of the multimedia connected to that report 4 the title of the report 5 with the initial sentence of the description 6 the date and time 7 the location 8 the verification status 9 and the categories associated with that report 10 REPORTS Reports Showing page 1 of 175 pages Total Reports Avg Reports Per Day Verified 1 3492 2 9 65 3 5 84 4 Hello Ushahidi Welcome to Ushahidi Please replace this report with a valid incident CATEGORIES 5 Rained Last Night Tents Urgently Needed BE from Therese Desir who is working w
34. 6 Clean URLs Enable Clean URLs This function allows the platform to be reachable by users even if they don t type index php in the address This way it will be easier for the users to find the platform on line if they know the name used in the URL but not the exact address By choosing YES in 21 See also section 3 5 2 to see more on Themes 33 1 the scroll down menu you will allow for this function to be in place After you click Yes or No click on the Save Settings tab 2 Dashboard Reports Messages Stats Addons Website Map SMS Email Themes Clean URLs API Clean URLs 2 SAVE SETTINGS CANCEL Enable Clean URLs ves 3 This option makes Ushahidi to be accessed via clean URLs Without index php in the URL 2 SAVE SETTINGS CANCEL 2 2 7 API Dashboard Reports Messages Stats Addons Website Map SMS Email Themes Clean URLs API API Settings SAVE SETTINGS CANCEL Default no of records to be fetched per API request 20 Maximum no of records to be fetched per API request Maximum no of API requests per IP address per Select 4 Applications with an Application Programming Interface API are fairly common these days Ushahidi s API allows for other online tools to securely access incident reports and application settings such as locations and categories via an API key While this is a fairly technical process the settings here are fairly straightforward you
35. Create Report Delete Create Report Delete 7 8 create Report Delete 3 3 3 Twitter The Twitter messages are accessible from two tabs one directly from the Messages section of the dashboard one from the Toolbar of the dashboard The Twitter tab allows you to do exactly the same things as the SMS tab but for the Twitter messages that are coming directly into the platform Here too it is possible to see the list of all Twitter 1 Inbox 2 Trusted 3 and Spam 4 In the Twitter messages list you can see the Twitter Account that sent the Tweet 5 and the date the Tweet was posted 6 On the right side of the message two tabs allows you to Delete the Tweet 7 or to Create a report 8 By clicking on the Create Report tab you will be directed to the Report form page where the Tweet body will be already inserted in the report description The administrators only have to add a title location and date and then submit the report If instead of Create Report there is a green tab that says 9 View Report it means that the Tweet has already been mapped and by clicking on this tab it is possible to access the report page The Twitter messages most often come with a link attached to it This link can be copied and paste in the Report Form called New Source Link but it 1s suggested to always verify that the link is a correct one This link often allows the mapper to look for the right location where the event happened and to control t
36. E LOCATION DESCRIPTION CATEGORY APPROVED VERIFIED Examples are 1 Suspected death in Nairobi 2009 05 15 01 06 00 Nairobi Three cases have been confirmed in C del Uruguay DEATHS CIVILIANS YES YES 2 Looting 2009 03 18 10 10 00 Accra Looting happening everywhere RIOTS DEATHS PROPERTY LOSS YES NO It is very important to remember that e Reports must be uploaded specifically in CSV format e When incident ID already exists in the database the entry in the CSV file will be ignored e The incident must contain at least Incident Title and Incident Date TIP To make sure you re working with the proper format start by running an export from the system first Even without any reports in the system you can still work from the blank CSV file Dashboard Reports Messages Stats Addons View Reports Create Report Comments Download Reports Upload Reports With the form below you can import incidents into the Ushahidi engine Please Note e Reports must be upladed in CSV format e When incident ID already exists in the database the entry in the CSV file will be ignored e it must contain at least Incident Title and Incident Date A Sample CSV Report INCIDENT TITLE INCIDENT DATE LOCATION DESCRIPTION CATEGORY APPROVED VERIFIED 1 Suspected death in Nairobi 2009 05 15 01 06 00 Nairobi Three cases have been confirmed in C del Uruguay DEATHS CIVILIANS YES YES 2 Loo
37. E EE A E EE 50 EVRE 72 Co E 8 0 6 E en ne E AE A A EAA E OE A AE AA ee 53 o PARLE I Di E AENA A E A N EAEE ATN E A E NAE AEN A A EAA 55 3 2 4 Download Reports ce ecssssscseseseseeeessessesssesescseseseeseseseseseseeseaeacaeeseseseseneoeseasseasasaeeseseseeeaeeeacasaeasaseseeeeas 56 FAS UDOT RODO en E E E OE O E toe et 57 PO WC SS ADCS an E EEEE E E 58 eRe SIS E A E N N AA A EE E A 58 BAS a5 00 12 PENE AA ee EEE ANA A E eee P es ee ree 61 De LW RUC E E cesses ates p ste E cd cects saa eanats A E E A E E EE E A T 63 ee LSC OI Oaea a aaa a dats ababcesenasy an leuceuidtes ateeatearauderettene 64 os VOU VO esac cats cat nat ca ese tes acta eac acta eae atest a aeleae aunts 64 DF E Ee ITE EE E E EEE N EEE E E E E TE EE 66 E EVIS 10 Germ UMA Y A E AN 66 342 Coun Gy Breakdo wiatrem a ne ebeticeiase a 67 2A REPO TATE a AA N 67 See ALC Ory PET ACU ia iets aS A EAE 68 BAS Repor L PUNCH CAN Ch sstessr sci tt acetate alli tear ctretta dc sala Sa leitat giant Adee icra at at ala dee ede 69 SE ee C8 K 40 ane se me De ar SR rm Oe ge ST eee Pe One Rear See A ear ee nee meee 70 Prog 101122 0 hoy ee PPO Pg Orr O en ce re ere 70 52 UC IVES else edeesl ees isaac tae etd ree eh alae da sere alahualaan ets 70 gp PMG USEF UCR a CO snn E 72 AD Te HOME Pagea adana dniae aa aiaa aaa AAE 72 411 The Mapen a 73 A ENE CI 2 24 OTIE Siae a eee oe 77 ADS The TMOG escana ae ae nated ead e seein ocoe cdc aceceectoaneee 78 AlAT State Laye Renee en eee en eee ee
38. HER Ju Aug Sep Oct I ISSUES WITH OFFICIAL 2010 2010 2010 2010 ACTORS Mi MATERIALS amp EQUIPMENT 4 OTHER LAYERS HIDE 4 1 5 How to Report Box The Reporting Box appears below the categories where you can see all the information on how to submit reports to the Ushahidi platform By default there are four ways to report information directly into the platform SMS 1 email 2 Twitter hashtag 3 and directly on the website via online forms 4 As long as the administrator of the platform has created those reporting systems you will find all the relevant data in this box The Submit a report link will direct you to the report form into the platform The growing number of Ushahidi plugins is allowing for more types of submissions through integration other applications One of the more popular plugins is the Cloudvox plugin 1f you have set up a Cloudvox plugin you will see your Cloudvox number 5 in that box too 1 See section 2 2 1 to know how to set up all those reporting system as administrator 48 This form is the same one you can access by using the Submit a report tab button See Section 2 3 8 to see how to set up your Cloudvox plugin 80 How to Report By sending a message to 00000000000 1 By sending an email to 2 myemail myhost com 3 By sending a tweet with the hashtag s 3 ushahidiguide _ By filling this form 4 nN gt Call 11111111111 5 81 4 1 6 The
39. I key Normally to get the key the provider requests the URL of the website 2 e Step 3 Once you ve obtained the API just copy and paste it into the Enter your new API Key box 3 24 Before adding the API key you can see what the differences between the different maps are just by choosing one of them and looking at the map on the right of the screen Map provider Setting up your map provider is a straight forward process Select a provider obtain an API key from the provider s site and enter the API key Step 1 Select a Map Provider Google Maps Normal 1 Step 2 Get an API Key Get an API Key 2 Step 3 Enter the new API Key ABQIAAAAjsEM5UsvCPC 3 Configure Map This section of the Map page allows you to choose the default zoom of the map appearing in the main homepage To choose the default zoom level move the indicator on the bar 1 and wait for image below to show the map relative to that zoom level 2 Once the zoom level has been chosen no other action 1s required other than to leave the marker on the right position in the bar 3 On the right side of the zoom level bar there are two boxes indicating the GPS coordinates 4 of the red marker in the map 5 This is where the red marker will appear to the user who is submitting a report from the web form and can be set to the main city of the country for example or left as default in the center of the country Note that a user who subsequently submi
40. Information 8 Description 9 Categories Here you can also decide to download only reports relative to a certain period of time by inserting the dates in the boxes on the bottom part of the page 10 Once all characteristic have been chosen the reports will be download as a CSV file by clinking on the Download tab 11 Dashboard Reports Messages Stats Addons View Reports Create Report Comments Download Reports Upload Reports Reports will be downloaded in CSV format Choose data points to download SELECT ALL 1 Approved Reports 7 led wichide Location informetion 2 m verified Reports 8 inctude Description 3 M Reports Awaiting Approval 9 M Include Categories 4 Mi Reports Awaiting Verification 5 Include Latitude 6 M Include Longitude 1 0 From to 1 1 DOWNLOAD 56 3 2 5 Upload Report This section allows the administrator to upload a CSV file to import reports into the Ushahidi platform This system can be used if for example you need to upload reports from people that cannot send them to you via email or phone but who that have a computer to combine them in a CSV file Another reason to use this function may be if you are transferring reports from one platform to another minding that both platforms are using identical versions of the software The format that needs to be used to have the system recognize the reports and upload them on the platform is the following INCIDENT TITLE INCIDENT DAT
41. Length ls this a Date Field Yes No Yes No 2 3 3 Sharing This function will allow you to share your platform with other Ushahidi websites or to have those websites sharing their platforms with you If you want to share platforms click on 1 Add Edit then just insert the name of the website 2 the URL 3 and decide the color of their reports on your map 4 After clicking on Save your URL 5 an email address will be sent to them In the list you can see all the Sharing Ushahidi platforms you added to your platform 6 and you can decide to edit them 7 making them invisible or visible 8 or delete them 9 Dashboard Reports Messages Stats Addons Categories Forms Sharing Pages NewsFeeds Layers Scheduler Cloudvox Anahi Edit Visible Delete oe EOT L m ii T 1 Pag 1 L sharing3 tiff 1 aaa edit 9 p d O O a I 1 URGENCES EMERGENCY Name Site URL is W MENACES SECURITY 2 e ren THREATS Oo 2 URGENCES LOGISTIQUES O san F VITAL LINES A W 7 secours SERVICES 5 SAVE gt oO hrane Na AVAILABLE G Pe z UTRE OTHI e o I 3 PUBLIC HEAL TH a o ote ier lle I 5 INFRASTRUCTURE 100 E 4 DAMAGE T N Lanns CDAS A 38 2 3 4 Pages The Pages section is the page that allows you to add other pages in additions to the ones already existing in the main Toolbar in the homepage From here it is also possible to 1 edit 1 or delete the About Us page 2
42. N N eatin decedent ie duens encima ntadae austen 23 DD S N E E coca vein cae teach tice ra cena A E E E 26 DLN MN IN tae eaten tee aa ie dec eae ae canada T raed edeateateandnenean 32 Di Zee VC UACS E EAE E A A E 33 Le Can URES c E A E 33 DPD E N A E AEA A EAN EA EE A N 34 Zed The Manage SCCO creona E nana ANENE EAEE Kaaa ARA Bi anaiai 35 ALCEO a E A E O S 35 Lo FOT a E E E 36 PAS ASE oE E ENE E EAA E A EE Seer er errr 38 IA TE E o E A A T OA essen eee 39 P NONS ECO aa E E eee 40 PAE NGA A ENO OE EAE EA E EA O AA A encase 41 De FC OE E A AAN EE E A A A T A tua 42 Dey VO eae ci ates caste act ca EA A ect cn O minded T E A E tanec needa toate tee 42 2 4 The Users S CtiOn ssssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnmnnn nannan nannan nananana 44 PA Me MO VY Se EEN EEEE E E E E EEE EN E E E E E E Gatanteneeaeer 44 ZN CE SO steed N E E E A A AE ese ee 45 2 4 3 Manage Roles and Permissions sissors aaea Daaa eeetar Petr 46 Za GOH DO ee cs te ste eticee sneer oveeactnen nes baetens edna seesveteasas exseeensecesscauanssareteneasuensewsoees 47 2o SCA Mics tee teres cesses oneness a noes pce tee cenmeuaeenesuea ee cet ase anise cane aes exe cnee cca asuedsasencacaenaescaaseanvencnaanenastvanvccecens 4 7 3 The Administration Section ssssssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnmnnn nnmnnn 48 3 1 Dashboards EEEE EEEE E AEAEE 48 e PA L y E E E E E A E E E E 49 OM VEW REPOT oa T E A
43. OW TO CUSTOMIZE YOUR PLATFORM IF YOU HAVE ANY PROBLEM AND NEED SOME GUIDANCE OR HELP GO TO SECTION 2 5 GET HELP BOX 1 Installing the Ushahidi platform If you ve ever installed WordPress Drupal or another popular downloadable content management system CMS or blogging platform installing Ushahidi will be a walk in the park If not not to worry like many popular web applications available today Ushahidi features an installer to walk you through the process While we ll be providing as much detail as possible with each step this guide assumes you re comfortable with the following what PHP and MySQL are unzipping zip files connecting to a remote server via FTP and setting permissions on directories and files on a remote server If any of that didn t make sense you may want to consult with a web developer or someone in the Ushahidi community that has done this before 1 1 Server requirements Before we get to downloading and installing the application let s consider what s required on your server or more likely the server owned by the hosting company you ve purchased an account with to run Ushahidi e PHP v5 2 3 e MySQL v5 1 e Apache v1 3 Apache 2 0 lighttpd Microsoft IS These requirements are fairly standard to most modern PHP based web applications available today Since both PHP and MySQL are freely available products it s very likely your server meets these requirements Ushahidi will p
44. RT AX Zhongwen Ris we CN Kiswahili KE francais FR CATEGORY FILTER HIDE 4 7 2 Search The search option is also on the top of the toolbar and allows you to look for specific reports into the Ushahidi platform By typing into the box the key word the system will give you all the reports in chronological order starting form the most recent one that contain that word If you are looking for a specific report you can type in the exact title or the number of the report if you know it In the same way you can look for report by a specific day or related to a specific category or to a specific place English US HHA Qaqa SUBMIT A REPORT CATEGORY FILTER HIDE gt It is possible to add other languages and to also translate the admin page and the other functions of the platform by working on the code The translation of the categories has to be done manually To find all the pother translation available go to the Github repository of the Ushahidi platform at https github com ushahidi In addition to that Ushahidi has set up a translation website Tafsiri see here for more info http tafsiri ushahidi com 93 94
45. The news will be displayed with their title source and date The news you will see into this box are Feeds coming from different website blogs twitter accounts or anything relevant that the manager of the platform decided to subscribe to The list shows the title of the report 1 the source 2 and the date it has been submitted 3 This box works like a Google Reader and by clicking on the title of the news you will be directed to the original source of the information Nairobi Kenya e r THE Official amp mainstream news For Fairness and Justice 1 rime 2 source S oate f i r Business Sports Blogs Entertainment Science amp Technology Four south Sudan soldiers killed on vote the Daily Natio Jan 8 2011 Over 100 000 people face starvation in The Standard Jan 8 20 SG PdS R Search for day 8th January 2011 Lightilthebox com niaaen South Sudan in party mood as nationhood the Daily Natio Jan 8 201 Southerners to be foreign in north Sudan the Daily Natio Jan 8 2011 sita kimya movie Voice of Kibera Jan 7 2011 Headlines Reshapity Spy Camera U S Centers for Disease Control Voice of Kibera Jan 7 2011 Ministers Ongeri and Shaaban say they are The Standard Jan 7 2011 eene enpm l Eee Over 100 000 people face starvation in Taita Taveta Kenyan pastoralists move to Uganda The Standard Jan 7 2011 Homs Kidnapping syndicate unearthed The Standard Jan 7 2011 Updated 5 hr s
46. Ushahidi in User Name Your database username Password Your database password If you are running Ushahidi on your own computer this will more than likely be localhost If you are running Ushahidi from a web server you ll get your host information from your web hosting provider Database Host localhost Normally you won t change the table prefix However If you want to run multiple Ushahidi installations from a Table Prefix single database you can do that by changing the prefix here Continue gt Fig 2 There s a few other fields to take into account Base Path As noted in the installer this is automatically detected Database Host Most of the time this will be localhost which is why it is prefilled for you If you re running on an more custom configured server such as Amazon S3 or a private server your database may be running somewhere else meaning you ll want to replace localhost with the right domain This was likely provided for you when you or someone on your team setup the database contact your hosting provider if you re unsure Table Prefix As noted in the installation instructions 1f you re installing multiple Ushahidi instances from one database you ll need to change the table prefix However this is highly discouraged you should have one database per deployment It s recommended you leave this field blank Once you have entered all of this information click
47. Visitor Summary Country Breakdown Report Stats Category Impact Report Punchcard Report Punchcard amp 7 gt et a gt a e cy 5 a F B Gd B Ei b Ss S Th amp Ei s e D e e 6 r e e e a gt 5 G e o e gt Tu a e e x m fay B e Eo e E a D Ga a e a s D a D a G a 69 3 5 Addons 3 5 1 Plugins The Addons button will open a page where you will find the list of Plugins installed in your platform The list of plugins will show to you the plugins that are activated and the ones that have been installed but not activated By clicking on the Activate button you will activate a plugin 1 while by clicking on the Deactivate button you will deactivate it notice that even if you deactivate a plugin it will remain installed in your platform so that you can easily reactivate it at a later time 2 You can also view which plugins you have Active or Inactive by clicking on the sub navigation buttons of the Addons page 3 Each plugin has a Setting function which will bring you to the page where you insert or modify the settings of the plugin 4 Dashboard Reports Messages Stats Addons Addons Plugins Themes Addons Plugins Themes Cloudvox Settings Show all 3 1 ACTIVATE DEACTIVATE 2 Cloudvox Phone Number 11111111111 Cloudvox Domain mydomain cloudvox com 2 Deactivate Cloudvox Username myemail address com Clickatell S
48. ane aat Narra E IORTAGE j Edit Log 0 100 On the bottom right corner of the report there is an important box that only the admin can check the Information Evaluation This box has two questions and two evaluations to be filled by the administrator approval and verification and reliability and probability of the information 1 Approving report If the information in the report makes sense the admin will approve the report by clicking Yes next to Approve this report The report will then appear on the map as a dot 51 2 Verify report the administrator will select Yes to verify report if he she has direct knowledge about the event and can be sure that it is true It is strongly suggested not to click on verified if it is not possible to confirm the information in the report 3 Reliability this section gives the administrator five choices to choose their impression on the reliability of the source submitting the information 4 Probability this section gives five choices to the administrators to give their impression on the probability of the information reported When the administrator has reviewed the report she can click on Save Report or Save and Close button so that the report will be publish on the website If the report is faulty and should not be published the administrator can click on Delete This Report Information Evaluation 1 Approve this Report Yes O No 2 verity this Report
49. cess The Ushahidi Skype chat forums and wiki are also available as resources to help you Once those are set we re ready to go 1 4 Installing the software With the files uploaded and the permission set you can start installing the application itself Begin by visiting your website either at the root directory subdirectory or subdomain where you put the files most likely the root directory meaning you ll want to visit http yourdomain org Let s assume for the purposes of this guide that you are installing this into the root folder You ll be automatically redirected to the installer subdirectory If all of the files were uploaded you should see this fig 1 Ushahidi Welcome to the Ushahidi server install process Choose which type of installation you would like to use below BASIC INSTALLATION ADVANCED INSTALLATION Simple and fast All you need is your website s Get all the basic settings completed through root directory and your database information this 5 step process This includes server map Choose this option if you want to get up and site name and contact details running quickly and you can always configure everything else later Proceed with advanced Proceed with basic gt Fig 1 You ve got two options for installation Basic and Advanced The descriptions provided under each option describe the difference between the two let s review those here Basic Installati
50. ds 4 Edit Active Delete entry Default form for report 1 3 2 Add New Field 5 Select a Field Type Text Field 6 7 Frets Name 8 perau Value 1 aga 1 A na Character Leniti I this a Date Field es Note es No DDr Add a New Form To create an entirely new form there is a box at the bottom of the page 1 Create Edit Form After inserting the Name of the new form 2 and the Description 3 which will not appear in the users interface and clicking Save 4 the New Form will appear listed under the default one 5 This new form will have all the fields existing in the Default Form because those fields cannot be deleted To add new fields to this new Form follow the steps explained above starting from selecting Edit at the and of the row corresponding to the new form created 6 You can add as many Forms as you d like Those Forms will be accessible by the users in a scroll down menu on the top of the Title in the Submit a Report page 37 Dashboard Reports Messages Stats Addons Categories Forms Sharing Pages News Feeds Layers Scheduler Cloudvox 1 adavedit Form Title Form Description 4 save Default Form Edit Form Fields Edit Active Delete Default form for report entry 5 New Form Edit Form Fiel s 6 Edit Active Delete New Form to be tested Add New Field Select a Field Type Text Field Field Name Default Value Required Maximum Character
51. e category and the number of the report submitted in that period of time will appear on the top of the graph Statistical information on the reports submitted is available over time as well and allows the administrator to see only the statistic referred to over a predefined interval of time by inserting the dates in the apposite fields or by clicking on the date range buttons and choosing an interval of one three or six months 68 Get Help OCHA IAU Early Warning System Wiki FAQs Forum Search Dashboard Reports Comments Messages Feedback Stats Settings Manage Users Statistics Visitor Summary Country Breakdown Report Stats Category Impact Reports Impact Choose a date range 1 MO 3MO 6MO ALL 2010 65 03 S 2010 04 15 s E This chart gives you a linear view of the reports by category over time Scroll from left to right to see a comparative Reports view of the different categories Mouse over the graph for more details 48 amp Mass Casualty Attack 14 Reports i Categories 11 3 4 5 Report Punchcard The Report Punchcard is a graph that depicts the number of reports per day according to the hour of the event The graph shows in the Y axe the time of the day and in the X axe the day of the week Looking at the size of the dot in the graph you can easily see which times of which days the majority of the reports where submitted to the platform Dashboard Reports Messages Stats Addons Settings Manage Users Statistics
52. e comments that are Awaiting Approval 2 have already been Approved 3 or have been identified as spam 4 For each comment it is possible to see who submitted the comment 5 the report that the comment was made about 6 the text of the comment 7 and the date of the comment 8 and the IP address 9 The right side of the comment in the comment list section allows the administrator to approve 10 or delete comments 11 or report as spam by clicking on the respective tab 12 Dashboard Reports Messages Stats Addons View Reports Create Report Comments Download Reports Upload Reports Show all 2 3 4 APPROVE UNAPPROVE SPAM NOT SPAM DELETE a l Anahi 5 2011 01 08 Approved Spam Delete In response to Medical assistance needed for sick child Gonaives 6 8 1 0 1 2 1 1 7 we live close to this area and can confirm that this building is collapsed Email anahi crisismappers net IP Address 93 58 110 72 Comment Rating 0 1 Pages 1 55 3 2 4 Download Reports This section allows the administrator to download all the reports as a CSV file There are options to choose what type of information to download and what kind of reports to download By marking on the relative box it is possible to download 1 Approved Reports 2 Verified Reports 3 Reports Awaiting Approval 4 Reports Awaiting Verification In addition to that it is possible to include in the report 5 Latitude 6 Longitude 7 Location
53. eek 7 Day 8 Hour 9 and Minute 10 The scroll down menu allows the administrator to choose in between All or a particular day hour or minute Once done you need to save the settings 11 If you have any issue you can also Force to Run the scheduler to refresh automatically all the incoming information 12 You can also decide to activate or deactivate a particular schedule for a specific incoming feed 13 Scheduler FORCE RUN SCHEDULER 1 2 1 Jaterts Edit Active Schedule 13 2 Email Edit Active Schedule 3 Feeds Schedule m a or Active t Active g E 4 Sharing Schedule Active m a 5 rwitter Schedule 1 Pages 1 6 Edit Scheduler 7p aa Ma aa 11 8 9 10 Examples Every Minute ALL ALL ALL ALL Every Hour ALL ALL ALL 0 Midnight Every Day ALL ALL 0 0 Once A Week on Monday Monday ALL 0 0 Every 1st of the Month ALL 11010 More about running CRON Tasks 2 3 8 Cloudvox This page shows the Cloudvox messages that form the Voice menu Once installed Cloudvox will show here a standard menu 1 but this one can be edited and customized Tf you are having problems in receiving incoming messages from any source try to use this function because most of the times this is the problem 42 The first thing that can be changed is the menu content itself by adding or removing any of the listed messages To do this click on Edi
54. eform Education Consortium CRECO s mission is to promote constitutionalism democratic governance and institutional development through coordination and capacity building of the civil society Ushahidi is a not for profit software development company Their software is used for collecting aggregating and visualizing information from communities around the worid www ushahidi com A The Social Development Network SODNET through its INFONET Programme that aims at strengthening the role of citizen s and civil society in the strategic use of technology www sodnet org Uraia is Kenya s National Civic Education Programme whose mission is to facilitate the provision of quality civic education and practical mechanisms for citizen engagement in public affairs www uraia co ke Uchaguzi is made possible with the generous financial and in kind support of HIVOS www hivos nl and Twaweza www twaweza org See section 2 3 4 to know how to set up the content of this page 92 4 7 Additional Buttons 4 7 1 Languages The languages option is on the top of the toolbar and it allows by default to switch from English to Spanish French Arabic Polish Cantonese Russian and Kiswahili This function will not automatically translate all the options in the website but only the toolbar and the default functions of the user menu English US Q al LB polski PL espanol castellano AR PyccKn a3bik KG SUBMIT A REPO
55. el ta Rochele Gresseau Desarmhes Saint Martin Sapate wat Saint Marc El Bay Degence Pepe e Sans Bouble Nn La Cayene Va Yaille 3 La Chapelle eit gt Etroits Belladere a re Anse a Galets Je PORAS RET E Arcahaie Le Jardin Dos Bois Ss Saint Phard Rouge f 7 le Boucassin B a7 gt El Ce pay Trou 2 Calman 5 Baie c m d Port au pD nnce Santo Arrondiss de pm Vv 2 Croix des Pees e20 0 Go Boke Terms of Use 2 2 3 SMS This page of the Settings allows you to write the phone numbers that you have set up for your platform to receive SMS messages from users We will explain here how to set up your phone numbers providers There are three possible ways to set up the Ushahidi platform to receive SMS directly into the platform 1 Using FrontlineSMS 2 Using an SMS Gateway like Clickatel 3 Using a Short Code Those three methods have significant differences and require additional investment in terms of PHP skills economical resources and time Using FrontlineSMS is easy and fast FrontlineSMS is free and open source and it is possible to download it from their website The software allows for sending and receiving SMS by just having a computer and a laptop or a computer and a GSM modem connected to it You do not need to have Internet connection to use FrontlineSMS The Ushahidi platform already has step by step instruction on how to sync it with the Ushahidi platform see below The FrontlineSMS website fro
56. erform a check on your server to see if you have the right versions of PHP and MySQL during the installation process and deliver a warning in case of a problem If you don t meet the requirements you ll have to move to a different hosting provider or contact them to see if provided more updated versions is an option 1 2 Downloading the application There are 2 ways to download Ushahidi The easiest is to visit the website http ushahidi com downloads and download the complete application as a ZIP file For the more tech savvy the source code is available on github com a popular hosted version control system 1 3 Uploading files amp setting permissions One you downloaded the files unzip them and upload them to the server Once uploaded you have to change the permissions on a few files and directories If we don t do this the Ushahidi installer will recognize this and remind you that this needs to be done during the first step of the installation process so you may as well change them now 1 g The sign beside the version numbers means this version or higher There are two ways to do this a CHMOD command or using your FTP client For the purposes of this guide and keeping it simple we won t be getting into the more technical process of CHMOD commands Let s consider what you can do with your FTP client Most FTP clients such as Transmit or Cyberduck for OS X WS FTP or FileZilla for Windows
57. essage from 16072807491 2010 07 16 8 Icreate Report Delete Preview Message 1 0 Location 11 Report o EEE 5 From 16072807491 C New Voice Message from Anonymous 2010 07 16 9 view Report Delete 7 Preview Message 65 3 4 Stats The statistics section allows you to see detailed information about the reports that have been submitted and the users of the Ushahidi system The statistics page has a toolbar which allow the administrator to access the following pages 1 Visitor Summary 2 Country Breakdown 3 Report Stats 4 Category Impact 5 Report Punchcard 3 4 1 Visitor Summary The Visitor Summary shows information about the users of the Ushahidi page Visitor information tracks e Unique visitors the number of individuals coming to your instance Unique Visitors are determined using cookies In the case that a visitor does not have cookies enabled they will be identified using a simple heuristic taking into account IP address resolution browser plugins OS etc e Visits a record of a unique visitor coming to the site more than 30 minutes past his her last pageview e Page views the total number of pages that visitors have viewed on your site Visitor information is available over time as well and allows the administrator to see only the statistic for a predefined interval of time by inserting the dates in the opposite fields or by clicking on the date range buttons which allows you to choose an inte
58. ettings Send and Receive Text Messages Using Clickatell Author David Kobia Plugin Website http www ushahidi com Cloudvox Password C Cloudmade 0 3 1 Activate Add a Cloudmade base layer Author David Kobia Plugin Website Cloudvox Download Url O CloudVox settings 4 0 9 Deactivate oa Save voice messages to Ushahidi that can then be used to create reports just like SMS F Twitter or Email Author David Kobia Plugin Website http www ushahidi com C FrontlineSMS Settings 0 5 Deactivate Receive Messages from a FrontlineSMS Installations Author David Kobia Plugin Website http www frontlinesms com O Full Screen Map 0 5 Deactivate Render a full screen map with a modal window from main page Author David Kobia Plugin Website http www ushahidi com 3 5 2 Themes The Themes page will show you the different themes that you can chose for your Ushahidi platform Upon installation you ll find the default Ushahidi theme listed here If you create or find new themes you can add them here As mentioned earlier never delete the default theme even if your website is using a different theme Additional themes are based off the default theme deleting the default theme in any instance will cause your website to break It is also important to note pay attention to the theme you employ for your website If you switch from one theme to another one that theme may not support the display of certain 37 To see list o
59. ettings of the platform Settings 6 Manage 7 and Users 8 Also on the very top of the page you can see buttons that allow you to go back to the website to see your profile or to logout Under these buttons there is the Get Help 9 box and the Search box 10 Welcome Administrator View Site My Profile Logout Ushahidi m 9 Wiki FAQs Forum Search 1 0 1 Dashboard 2 Reports S Messages 4 stats 5 Addons Settings Manage Users 6 7 8 Dashboard Reports Timeline View Today Past Month Past Year All Quick Stats 350 l Reports 3 494 300 Not Approved 2 250 Categories 59 16 2 2 The Settings Section The Settings section is the page where the administrator can set up all the settings to customize the Ushahidi platform based on the project they are working on This section of the Ushahidi platform is the first one that needs to be customized once the platform is installed and allows for the main components of the platform such as the map and the email address to be set up by the administrator To access the Settings Page the administrator just needs to click on the Settings tab on the top right of the Dashboard page Once opened the Settings page has a toolbar with seven tabs each one of them allows for the customization of the relative setting 1 Website 2 Map 3 SMS 4 Email 5 Themes 6 Clean URLs 7 API Ushahidi Wiki FAQs Forum Search Dashboard Reports
60. f available plugins look at http apps ushahidi com 38 See section 3 to see how to install a plugin 70 types of data so best to check the developer s notes or run some tests before launching on a new theme Dashboard Reports Messages Stats Addons Manage Users Addons plugins Themes Theme Settings SAVE SETTINGS CANCEL Default Ushahidi Theme Default Ushahidi Theme Version 1 0 Demo http www ushahidi com Contact team ushahidi com Location O Select Theme 71 4 The User Interface 4 1 The Home Page The default Ushahidi home page 1s composed of different sections each of them providing different information 1 The Map 2 The Categories 3 The Timeline 4 The Static Layers 5 The Reporting Box 6 The Incidents List 7 The Official and Mainstream News FULL SCREEN MAP 1 a ET JEE A Data CC gt SUED ai m J j WA gt 0 ai i 0 00000 0 00000 Scale 1 2M ersa 900913 ron jan 2010 l Feb 2010 4 gt Play 3 C ALL CATEGORIES WI 1 URGENCES D EMERGENCY E 4 MENACES SECURITY THREATS E 2 URGENCES LOGISTIQUES VITAL LINES Wi 7 SECOURS SERVICES AVAILABLE I 8 AUTRE OTHER 3 PUBLIC HEALTH E 5 INFRASTRUCTURE DAMAGE E 6 NATURAL HAZARDS OTHER LAYERS HIDE I AFTERSHOCKS 4 OTHER USHAHIDI DEPLOYMENTS H 1D I ANAHI How to Report 5 1 By sending 4 message to 00000000000 2 By sending an
61. g into the box the key word the system will show all the reports in chronological order starting form the most recent one that contain that word If you are looking for a specific report you can type in the exact title or the number of the report if you know either You can look for report of an event by a specific day or related to a specific category or in a specific place Search 25 26 27 http wiki ushahidi com doku php http forums ushahidi com http ushahidi com get involved resources 47 3 The Administration Section 3 1 Dashboard The Dashboard page is the initial page that it appears once you access the platform The Dashboard page provides a summary of all the information coming into the platform and displays a snapshot of the amount of reports over time The Dashboard is composed of four main sections l The Reports Timeline allowing users to view graphically the trend of reports over a period of time By clicking on the top right options the admin can see the trend over the past day month or year The Quick Stats Box which gives an overview of reports in the system It includes number of reports filed and gives the number of the ones inserted into the platform but yet to be approved the number of categories set up in the platform the number of locations inserted the messages coming from media sources as RSS Feeds and the incoming messages divided by typology SMS email Twitter and Laconica The adm
62. ges The administrator may decide whether to cache pages and reports on the website speeding up loading time This is particularly helpful when working with low bandwidth audiences 18 Cache Pages Lifetime If caching 1s enabled here the administrator may set how long the pages are cached for before users visiting pages on the website should be served a new version of the page rather than the cached version saved on their personal computer 19 Google Analytics This function allows the administrator to sync the platform with Google Analytics by inserting the proper ID 20 Twitter Search Terms This tab allows you to enter the Twitter hashtags connected with the platform It 1s possible to choose more than one hashtag separated by a comma It 1s recommended that a short and clear hashtag be chosen This hashtag will also appear on the Information Box on the homepage so that people can use it to post on Twitter messages related to your platform All the twitter messages that will be posted on line with the hashtag s inserted here will also appear in the admin page on the Messages section Twitter so that they can be transformed into reports directly by the admin 21 Akismet Key I3 For more on Google Analytic see here http www google com analytics index html 14 To see how to process Twitter messages go to section 3 3 3 20 The Akismet Key allows the administrator to have Akismet pre screening the messages coming in to look fo
63. gs Manage Users SAVE SETTINGS CANCEL Step 1 Download and install FrontlineSMS on your computer Open the program and check that the software is able to see the phone or modem connected to it This process may require a couple of minutes We suggest you test it by sending and receiving a couple of SMS text messages from your FrontlineSMS software Step 2 In the admin section of your Ushahidi installation click on the settings link on the right hand side and then select the SMS tab In this section click on Option 1 Use FontlineSMS Remember that this is only for outgoing messages Step 3 Enter the phone numbers you have connected to FrontlineSMS then copy the FrontlineSMS HTTP Post LINK provided Your Ushahidi Sync Key TWKJHBID FrontlineSMS HTTP Post LINK http beta1 1 ushahididev com frontlinesms key TWKJHBID amp s sender_number amp m message_content Step 4 In FrontlineSMS open the Keywords tab select the lt BLANK gt keyword in the list on the left Please note that with new version of FrontlineSMS lt BLANK gt has been renamed to lt NONE gt ome Contacts lt O gt Keywords N Messagi O ae 9 gAdd keyword 2 lt BLANK gt Next click on the click here to go to advanced view link on the right below the Keyword Actions section Keyword Actions gt All incoming messages containing Send this message as an auto reply Th f Save If you want to add
64. he Ushahidi platform you need to go to Addons section in the main toolbar 1 activate the FrontlineSMS plugin 2 and click on Settings on the site of the Plugin name 3 21 Dashboard Reports Messages Stats Addons 1 Addons Plugins Themes Show all Inactive Active ACTIVATE DEACTIVATE amp Plugins Version Settings Manage Users Actions Cloudmade Add a Cloudmade base layer Author David Kobia Plugin Website http www ushahidi com This page will give you a step by step guide to sync the Ushahidi platform with FrontlineSMS Dashboard Reports Messages Stats Addons Addons Plugins Themes FrontlineSMS Settings Step 1 Step 2 Download Frontline SMS and install it on your computer FrontlineSMS is free open source software that turns a laptop and a mobile phone into a central communications hub Once installed the program enables users to send and receive text messages with large groups of people through mobile phones Click on the grey box to request a download from FrontlineSMS com anon Sync with Ushahidi Messages received into a FrontlineSMS hub can be synched with Ushahidi Detailed instructions on how to sync can be found here You will require the key and link below to set up the sync with FrontlineSMS FrontlineSMS HTTP Post LINK http 184 106 135 232 frontlinesms key YPLIGOXR amp s sender_number amp m message_content 28 Settin
65. his location on the map By doing this if the reporter is trusted his reports will be mapped automatically 60 The Reporter Has Been MODIFIED SMS Search Edit 3013936590 View Messages Reporter Messages 147 Reporter Level 3013936590 R 3115166604 View Messages Service SMS Messages 2 Reporter Level Untrusted Reporter Level aaa Trusted Give this Reporter A Location Giving the reporter a location will allow their reports to be mapped immediately if they are trusted Location Latitude Longitude Location 0 09000 0 00000 a WW pa 7 4 La Calera Senderos A g de Funza Usaq en F saque Fontibo A lis A rs A A A Kennedy A a E3 Pu 4 Bos Ara ig ais0ad SY EER e 3 3 2 Email The email messages are accessible from two tabs one directly from the Messages section of the dashboard and the other from the main navigation of the dashboard The Email tab allows you to do exactly the same things that the SMS tab does but with Emails sent to the email address you set up for people to email you reports Here too it is possible to see the list of all Emails 1 Inbox 2 Trusted 3 and Spam 4 In the email list you can see the email address that sent the email 5 and the date the email was posted 6 If there is a name instead of the email address this means that sender of the email has been registered into the platform as Reporter On the right side of the message two
66. il or Yahoo as your email provider Gmail especially that can simplify the process Hints are provided alongside the installer to help you with what you should enter Again if you can use one of these it can make this process much simpler If you re using an email address off your domain you ll probably want to check the documentation knowledgebase or FAQ to figure out what the proper settings are for the Mail Server Username Mail Server Port and Mail Server Host fields See section 2 2 4 11 Click the Continue button when you re ready and it s on the last step to configure the map options Fig 5 Ushahidi 1 Database 2 General 3 Mail Server 4 Map 5 Finished w This is an example of an informative message box that we would use to add a bit more context Not sure x if this page needs one or not Ushahidi works equally well with any of these four a mapping providers Google Bing Yahoo or Open Street z Map Choose the one that has the most detail in your area Google API Key Anyone can get an api key Get yours now Google Previous Continue gt Fig 5 The last step is fortunately the simplest Choose the Map you would like Google Yahoo or OpenStreetMap OSM in the dropdown Because of the way Ushahidi is configured as well even if you choose Yahoo or OSM you ll need to enter a Google API key Click the link beside that field to get one for your doma
67. ime and date of the event reported The Reporters tab here works exactly in the same way as explained in the previous section on SMS 10 allowing the administrator to flag the Tweet source Trusted Untrusted or Trusted Verified Dashboard Reports Messages Stats Addons SMS Email Twitter Laconica 2 inbox 1 3 4 10 DELETE SPAM NOT SPAM C RT Sodnet Uchaguzi Tanzania is out http bit ly dfjCj3 2011 01 01 Create Report Delete 7 From lonarydsuoof 5 Yes leading in Molo as vote counting continues kenyadecides 2010 08 04 Create Report Delete 8 From EvelynWambui alfredmutua tell Kivuitu swearing in is just b4 dusk Mxwz KenyaDecides this time 2010 08 04 Create Report Delete uwezo ni wetu From waremboniyes _ Uchaguzi Kaptalamwa pri Sch in marakwet west YES 8 NO 298 REJ 2 2010 08 04 View Report Delete From ombui 33 See section 3 2 2 to see how to fill the report form 63 3 3 4 Laconica The Laconica messages are accessible from two tabs one directly from the Messages section of the dashboard and one from the Toolbar of the dashboard The Laconica tab allows you to do exactly the same things that the SMS and Twitter tab but for the messages sent thought Laconica into your Ushahidi platform It is also possible to see the list of all Laconica Inbox Trusted and Spam In the email list you can see the Laconica Account that sent the Laconica message and the date the Laconica me
68. in and enter in the value provided That s it click the Continue button to finish up 12 ME Kg em a4 Ushahidi 1 Database 2 General 3 Mail Server 4 Map 5 Finished To login go to http u local admin and use the following credentials Username admin Password admin Other next steps e View your website e Upload report data e Configure your map e Setup your SMS server Fig 6 You are done Follow the links provided to see your website log in to the administration dashboard or get right to the next important steps in setting up your website further configuring the map settings and connecting your instance to an SMS server Before you start exploring with your new instance there s two last things you need to do Now that the installer is complete we need to set the permissions on applLication config config php and application config database php to 755 This is a critical step but not one Ushahidi will do for you Not doing so opens up your deployment to a big security risk The second thing you l want to do is delete the installer folder from your website s file system 1 5 Upgrading For the purposes of this guide before we move into learning the application itself at some point you re going to want to upgrade your Ushahidi deployment to keep up with minor security updates and all the cool new features The upgrade process begins with a crucial first step
69. in can access each one of those information pages by clicking on the relative name The Recent Reports Box gives a summary of the most recent reports submitted by showing the title the time of the incident if the report has been approved and verified and the source From this box the admin can click on the title to access the report page The Incoming Media Box gives you an overview of the RSS feeds coming into the platform 48 Dashboard Reports Messages Stats Dashboard 1 Reports Timeline View Today Past Month 350 300 250 3 Recent Reports 1 50 PM Rained Last Night Tents Urgently Needed Report from Therese Desir who is working with the Mayor of St Marc It rained last night in St Marc We have over 100 people looking to our staff fo 4 14 PM PUBLIC HEALTH Port au Prince needs are help to donate food to them Most people in port au Prince are going to die because of a lack of water and food We should all Addons Past Year All Quick Stats 2 Reports Not Approved Categories B Locations E News Feeds E Messages SMS EE Email Twitter ACTIVE Laconica VERIFIED SOURCE sched ACTIVE X VERIFIED X SOURCE News Feeds 4 3 494 59 3494 View All 9 View All Incoming Media 3 2 Reports The Reports section is where the Ushahidi system lists all of the reports that are submitted to the system easily where you ll be spending the most time with the syste
70. in de l etat street in continue area portail leogane since january 12th we have only received a Time 2010 03 16 10 43 19 Credibility DJ Leave A Comment Name Email Comments Security Code 9 4K Submit Comment S oO o oD 6 5 w pi E Baie hba N Geffrarty we Code gt e 4 Fayette Kenscoff hauou Bell Furcy pa Fontan Google amp aques K Scale 1 433K y Map data 8201 Terms of Use Additional Reports Aid needed Rue Magasin de l etat Continue Portail Leogane People Trapped From Facebook GHESKIO Field Hospital Aid Needed at University of Kiskeya Canad wintas and nhalias naadadi in a 50 Tt is up to the reporter to decide if he she wants to use the date of the submission of the date of the incident gt See section 4 2 to see the different parts that compose a report one it has been submitted 82 4 1 7 The Official and Mainstream News The Ushahidi platform provides the ability to subscribe to RSS feeds from other websites and to display them on your website This feature is optional but in some projects particularly those that may be actively covered by the mainstream media or bloggers it can be useful to provide additional context about your project without having to include related but not actionable content on your map If you choose to include news feeds on your homepage they will appear in the box below the Reporting Box
71. ion before appearing on the map unless otherwise decided by the administrator of the platform 54 For more information on this see http irevolution wordpress com 2009 06 15 digital security 88 You will re directed to the same page also if you click on the button on the top of the home page will lead you to the same page that you can access by clicking on the Submit a Report tab on the main tool bar fegin O Ej SUBMIT A REPORT US ABOUT US CATEGORY FILTER HIDE E 89 4 4 Get Alerts The fourth tab on the main page of the Ushahidi platform is called Get Alerts 1 and it allows you to receive alerts on your mobile phone email and or subscribe to categories of reports as an RSS feed as new reports are published on the website To set up an Alert via email or SMS it is just matter of four easy steps a Click the Get Alerts tab on the home page b Select the location to receive alerts about 2 and the size of the area 3 The system will send an alert whenever a report is entered within 1 5 10 20 50 100 km from this location c Select mobile 4 or email alert 5 and enter mobile phone number or email address or both d Click Save Alert 6 On this page there is also possible to subscribe to the RSS feeds to get notifications about new reports submitted into the system a Click the Get Alerts tab b Click on the Link in RSS Feeds box 7 c Select the RSS Aggregated that you use fr
72. ion for your website It s recommended you keep this enabled 10 Fill out these fields click the Continue button again and it s on to Step 3 configuring your Ushahidi mail server Fig 4 1 Database Site Alert Email Address Mail Server Username Mail Server Password Mail Server Port Mail Server Host Mail Server Type Enable or disable SSL Previous 2 General 3 Mail Server IMAP Disable B 4 Map 5 Finished When your site visitors sign up for email alerts they will recieve emails from this address This email address does not have to be the same as the Site Email Address If you re using Gmail Hotmail or Yahoo Mail enter a full email address as a username The password you normally use to login in to your email Common Ports 25 110 995 Gmail POP3 SSL 993 Gmail IMAP SSL Examples mail yourwebsite com imap gmail com pop gmail com Internet Message Access Protocol IMAP or Post Office Protocol POP What s the difference Some mail servers give you the option of using SSL when making a connection Using SSL is recommended as it gives you an added level of security Continue gt Fig 4 Setting up the mail server is important to receive reports via email as well as send out alerts to subscribed users and administrators As mentioned this can be tricky depending on your 2 email provider If you re able to use Gmail Hotma
73. is as easy as filling in any online form administrators will appreciate that the layout of the form is identical to the finished reports Even geo locating your report is as simple as clicking on the map provided Ushahidi will figure out the latitude and longitude for you To access the form click the Submit a Report link in the main navigation This entire page is the online form There are 10 items in the form in which the user can contribute in addition to the required title description and location the following A Title F Refine Location Name and Find Location tab B Description G News Source Link C Date and Time H Video Link D Category I Upload Photos E Map J Contact information SUBMIT A REPORT Submit a New Report q a Find a location near you Report Title Select a City 4 Description b r e iwe S noice gt awe nas foi Las a y ee c PORIRED DY Ke nie j Date c Time im Scile 1 2 Aa Ae 1h Pr OG ei 92 a aa 01 08 2011 a opoe ib p Gi ce Map data 2010 Googe Terms of Usa Categories d City State and or Country 1 URGENCES EMERGENCY tS INFRASTRUCTURE DAMAGE Search for your locaton using a location name of lattude Jongitude coordinates format 4 2 URGENCES LOGISTIQUES VITAL amp 6 NATURAL HAZARDS 38 19 85 61 of click on the map to pinpoint the correct location a f a 7 SECOURS SERVICES AVAILABLE i P3 PUBLIC HEALTH Refine Location name ee TRE THE
74. ith the Mayor of St Marc It rained last night in St Marc We have over 100 people looking to our staff for CATEGORIES Aid needed Rue Magasin de l etat Continue Portail Leogane o9 am Feliger Jean Eddy live in Magazin de l etat street in continue area portail leogane since january 12th we have only received a Time 2010 03 16 Aid needed Santo 19 7 Croix des Bouquets UNVERIFIED Help croix des bouquets santo 19 7 Time 2010 03 16 10 09 54 Sant j roix des Bouque 8 CATEGORIES 84 Clicking on the title will access the full report with all of the information The complete report details from the report page are the following 1 2 3 Category ies 4 Verification status 5 Description 6 7 In addition to that there is a small function 8 on the top of the Comment Box that allows the viewer to give scores to the report by saying if he she trust it or not This function is not going to affect the verification of the report or of the comment but can give to the administrator and to the user an idea of what people reading that comment think about its credibility Medical assistance needed for sick child Gonaives Edit 2 3 m 1B URGENCE MEDICALE MEDICAL EMERGED Description 5 I HAVE A CHILD OF 7 MONTHS HAS BEEN HIT BUT IT AFFECTS HIM HSE NOW Time 2010 03 15 11 43 08 have a child of seven months of age who is striked but it s now that acts on him He can not neither stand nor sit
75. ll automatically order the numbers letters in ascendant order After having inserted deleted or edited the categories on this page save the settings by clicking on the Save tab at the bottom of the page Dashboard Reports Messages Stats Addons Categories Forms Sharing Pages NewsFeeds Layers Scheduler Cloudvox Add Edit 13 7 kategory Name 8 Joescription 9 eotor 1 0 Category 1 URGENCES EMERGENCY 1 1 fegan 4 MENACES SECURITY THREATS 2 URGENCES LOGISTIQUES VITAL LINES ete 7 SECOURS SERVICES AVAILABLE 8 AUTRE OTHER 3 PUBLIC HEALTH 1 2 SAVE 5 INFRASTRUCTURE DAMAGE 6 NATURAL HAZARDS Trusted Reports Category Translations 1 Ji urcences EMERGENCY B Edit Visible Delete D urgence Emergency 4 1D INCENDIE FIRE C Edit Visible Delete 2 incendie Fire 5 1C PERSONNES PRISES AU PIEGE PEOPLE TRAPPED a Edit Visible Delete Personnes prises au piege People trapped 6 1B URGENCE MEDICALE MEDICAL EMERGENCY Edit Visible Delete Urgence medicale Medical Emergency 2 3 2 Forms The Forms page allows you to change the page where users fill in their reports after clicking on the Submit a Report tab This form is set as default with a predefined number of fields but it is possible to add other forms surveys or to edit the default one The default form can be Edited 1 Deleted 2 or made Inactive by clicking on one of the tabs at the end of
76. m Here you can view the full list of reports access details of individual and reports and manage reports that need to be approved or modified The Report page has one toolbar listing actions you can do with the report list Reports where you can see all the View Reports 1 Create Report 2 Comments 3 Download 4 Report and Upload Report 5 Ushahidi Dashboard Reports Messages Stats 1 2 3 Get Help Wiki Addons 4 5 View Reports Create Report Comments Download Reports Upload Reports Show all Approve Unapprove Verify Delete Rained Last Night Tents Urgently Needed 2010 03 22 Report from Therese Desir who is working with the Mayor of St Marc It rained last night in St Marc We have over 100 people looking to our staff for More Location saint marc haiti Kenya Submitted By Unknown via WEB Categories 2D RE HELTER h E Edit Log 0 49 FAQ s Forum Approve Verify Search Delete 3 2 1 View Reports The View Reports section has its own sub toolbar which lists the following tabs Show All 1 Awaiting Approval 2 and Awaiting Verification 3 Show All is the section where you can see all the reports inside the Ushahidi platform meaning verified reports approved reports and reports submitted but yet not approved or verified It 1s important to note here that reports submitted on the Ushahidi platform will not appear automatically on the public list of report
77. m Curanilah 40 a i F gt 100 mi OLos Angeles Od NS sat e i 1E TSUNAMI i lebu b i S Ma ai TA 0 e Q TTR We ak L 151 g RA Scale 1 7M 0 00000 0 00000 EPSG 900913 b 1F REPLICAS E p ren TIMELINE OF EVENTS From Feb 27 2010 lm Aug 29 2010 4 PLAY 2 AMENAZAS The category section works in combination with the map By clicking on all categories you will see all the reports submitted to the Ushahidi platform while clicking on a certain category will display only the reports related to that specific category and the same will happen if you click on the sub category The color of the dots related to a certain category will be the same you have previously assigned to that category or if you have assigned an icon you will see the icon instead of the dot Users can see only one category or sub category at the time 43 See section 2 3 1 to know how to assign to a category an icon or a color Some deployments to date have overridden this functionality to display multiple categories at once but this requires a rewrite of the underlying code 77 4 1 3 The Timeline Below the Map display there is the Timeline The timeline shows the number of reports mapped over time and by default shows the overall trend of the reports from the beginning of your deployment to the current day as a static graph 1 The timeline can also be used in coordination with the map turning the default s
78. m where to download the platform here http www frontlinesms com 26 The SMS Gateway is also easy to set up This does require a bit of money because it 1s necessary to buy a local 12 digit number within the country you re focusing on or a short code normally 4 digits The advantage of using an SMS gateway is that you don t need to have a phone connected to the computer but you normally pay a monthly charge for the number and an activation fee The Ushahidi platform already has step by step instructions on how to sync it see below Setting up an SMS short code is often the most effective way to use SMS with the Ushahidi platform This is because a 3 5 digits number is a lot easier to remember and to advertise That said getting a short code could be a challenge because you need to obtain an agreement with the mobile companies The short code can be synced with the Ushahidi platform but this does require having a PHP developer to set up One advantage of using short codes is that you don t need Internet connection mobile phones or GSM modem Dashboard Reports Messages Stats Addons Website Map SMS Email Themes Clean URLs API SMS Setup Options SAVE SETTINGS CANCEL Default Sending Provider clickatell Enter all the phone numbers that users can use to send text messages into your system below Phone 1 00000000000 Phone 2 Phone 3 Option 1 Use FrontlineSMS To configure FrontlineSMS as your SMS system in t
79. nd User names in addition to setting up the roles of the administrators users and reporters of your platform As we mentioned in the beginning of this guide when Ushahidi is first the default username and password for the administrator account admin Again it is strongly recommended that you change those settings immediately after having download and installed the platform by using the Edit button 2 Dashboard Reports Messages Stats Addons 1 View Users Add Edit Users Manage Roles amp Permissions Administrator admin SUPERADMIN 2 Ea Email david ushahidi com 1 Pages 1 44 2 4 2 Add Edit User To change the user settings the Administrator can go to Add Edit User 1 and just insert the Username 2 Full name 3 email 4 password 5 and then choose the level of administration access allowed 6 and activate or not the notification system 7 This last system if activated by setting it on yes will send a notification to the User every time a new report is submitted to the platform The drop down menu on the level of administration allows the administrator to choose in between three different roles 6 None Administrator and Super Administrator Remember to click on Save Settings once you are done 7 The Admin status allows the person holding it to access and process all the Messages in addition to edit and access the Manage section of the platform The Super Admin can do all the above function and in additi
80. ng 46 2 5 Get Help Box The Get Help box is always located on the top right side of the page From here it 1s possible to access the following three sections on the main Ushahidi website the Wiki 1 the FAQ s section 2 and the Forum 3 Those three sections are an invaluable resource for whatever problem the administrator should encounter in customizing or working on the platform The Wiki is recommended for PHP developers and for more technical problems The Forum is a very good resource for management questions and known bugs The FAQ s section is a very good starting point for questions on how to use certain functions or the general background of the platform and the organization Wiki FAQ s Forum Search wikil tiff G Ushahidi we mee con shahidi 3 Ushahidi 1 um rnam s Opor Souco Pieter 2 FOAUMSHONE WKI CONTACTUS AJOUT HOWTOHELP SLOG UEHAKIDI ME CONTACTUS ABOUT KOWTOHELF BLOG USHAHIDI RESOURCES fue rs t jesigned this section to be a h ing t e Ushahidi Platform Latest Discussions Before Using The Ushahidi Platform his document will walk you through some things P Page nx turd wth admin Welcome n werking2 DN gmuiLenm isis siv t sey tyme Forums A Ushahidi 101 The Basics Of Configuring Your Ushahidi petsa tinte 0 f iiem ianncaneatada Instance 2 6 Search The Search function of the Get Help box allows you to look for specific reports into the Ushahidi platform By typin
81. ng on the Find Location tab The red marker will automatically move to the location identified by the GPS coordinates automatically If there is no data available about the GPS coordinates and the reporter knows the location he she can just write the name in the box under the map and click on the Find Location 87 tab the Ushahidi map will automatically find the coordinates of the location and place the red marker in the map in the right position If the Ushahidi map cannot find the exact location then it is highly recommended to use external online applications such as Google Earth or OpenStreetMap to find more precise coordinates and then copy and paste them in the find location box g News Source Link This section should be used only if the report being submitted 1s from an online source the box allows inserting only a URL address If the information is coming from more than one on line source it is possible to insert as many links as required by clicking on the plus symbol on the side of the box h Video Link In this section the reporter can add a link to a video related to the event reported It is important to be sure that the video is relevant to the accident monitored Note that the Ushahidi platform doesn t allow you to upload videos to the platform the reporter can provide a URL to a video hosted elsewhere such as YouTube i Uploads Photo The reporter can also upload a photo related to the event
82. nge 1MO 3MO 6MO amwe peuz Gos P ay 4 Countries Unique Visitors Visits Pageviews 3 29 92 124 3 4 3 Report Stats The Report Stats page shows the breakdown of reports on a pie chart according to three criteria Category Verified Not verified Approved Not approved Statistical information on reports submitted is also available over time and allows the administrator to see only the statistic referred to a predefined interval of time by inserting the dates in the apposite fields or by clicking on the date range buttons which allows you to choose an interval of one three or six months 67 A table on the right of the chart indicated the number of reports visualized in the chart and the categories or the verified reports or the approved reports visualized in the chart Get Help OCHA IAU Early Warning System Wiki FAQs Forum Search Dashboard Reports Comments Messages Feedback Stats Statistics Visitor Summary Country Breakdown Report Stats Category Impact Reports Statistics Choose a date range 1 MO 3MO 6MO ALL 2010 03 03 2010 04 15 Go gt Reports Categories Reports 48 Categories 11 3 4 4 Category Impact The category impact is a graph that allows the administrator to view reports by category over time By moving from the left to the right it is possible to see a comparative view o the different categories while passing the mouse over the category itself the name of th
83. nts can represent refugee camps or police stations hospitals geographic regions or risk areas The reason you wouldn t want to submit this information as reports for your map is because they will appear as incidents which are likely to confuse your viewers Instead you can insert this type of data as a static layer 1 This will allow you to view this data in relation to you re the incidents reports you have mapped which can help you identify possible connections between those static locations and the dynamic events happening in the same area The Static Layer Box appears only if you use those files and will by default be listed under the category box By clicking on the static layer you will see the points related to that layer appearing on the map Administrators can decide to see as many static layers as you want in the same time See section 3 3 6 to see how you can insert those files into your map 46 You can alternatively insert them in the map itself if you are using OpenStreet Map See here http wiki openstreetmap org wiki Editing 79 FILTERS gt EWS STURE AL CATEGORY FILTER HIDE a gt POLICE ACTION I SECURITY ISSUES Wi POSITIVE EVENTS E HATE SPEECH I VOTE COUNTING amp RESULTS Seren Jeti r National Park E POLLING STATION LOGISTICS E BALLOT ISSUES Mkomaz Scale 1 7M 42 82471 1 60379 EPSG 900913 VOTER ISSUES From Jul 2010 jf Oct 2010 24 Play OT
84. o submit comments questions and suggestions to the administrators of the site The form asks for personal information like name email address and phone number in addition to message subject and text CONTACT US Contact Us Your Name Your E Mail Address Your Phone Number Message Subject Message Security Code 3 SM Send Message 91 4 6 About us Fairly straightforward this is a space for you to including information about the organization or volunteers setting up the platform and about the Ushahidi project Typically organizations explain who they are and what they want to achieve with the platform in addition to give some background information on the country of the deployment ABOUT US About Us Uchaguzi is a technology platform that allows citizens and civil society to monitor and report incidences around the electoral process Uchaguzi provides web and mobile based channels for citizens and civil society to report on electoral offences such as intimidation hate speech vote buying polling clerk bias voting mis information etc The reports are then sent to the electoral authorities or security personnel for action Uchaguzi recognizes the need for empowering citizens in the protection of democracy by inspiring individual and collective action in enforcing transparency accountability and efficient electoral service delivery Uchaguzi Is a collaborative action by The Constitution amp R
85. om the dropdown menu and click Subscribe Now Every time a new report will be uploaded on the Ushahidi map you will be notified the information to your RSS reader fl orrae Get Alerts Step 1 Select your city or location a ae OE O Mobile phone Or place a spot on the map below and we will alert you when a report is enter mobile number with country code submitted within 20 kilometers 0 00000 26000 Deslandes SansBouble QP 4 La Yaille gt itt n i Galets Q Email address Dos Bo enter email address 5 gt Jarain Arcahaie Mn Saint Phard Boucassin Save My Alert 6 2 Fond Sa t Pan Joanneau Parisien a6 6 y INN Confirm A Previous Alert Request Orioren Bnand Bois POWERED E gir Areguy 208 Negres g a Musac Jacmel elle A amS uont Grand RSS Feeds copy the url below y Grand E yGrande Tut Map data 2010 Google Terats 0f Use pag 7 E nttp 1184 106 135 232 feed If you can t find your location please click on the map to pinpoint the correct ocation 55 In the new version of the platform you will also be able to choose the categories of report you want to receive alert for In this case you can select the categories you are interested in and you will only receive alerts on report categorized under that specific category or sub category 90 4 5 Contact Us The Contact Us tab directs to a page where it is possible for Ushahidi users t
86. on All you need is your website s root directory and your database information Choose this option if you want to get up and running quickly you can always configure everything else later Advanced Installation Get all the basic settings completed through this 5 step process This includes server map site name and contact details If you re familiar with Ushahidi or the installation process basic will get you into the administration faster for configuration and setup However if this is your first time advanced will help you make sure the basics are covered before getting into other settings like categories SMS etc As we re assuming this is your first time let s proceed with the advanced installation all the parts of the basic installation are included within anyhow Click the Advanced installation box and you l be taken to the first screen in the installation process describing what you ll need to begin While those are listed for you on this first screen let s break those down into what we need Database Mail Server 1 Database name 1 Site alert email address 2 Database username Mail Server Username 3 Database password Mail Server Password 4 Database host Mail Server Port Mail Server Host oo i General 6 Mail Server Type l Site name amp tagline 2 Site Email Address Map 1 Map Provider 2 API Key Database Also before we proceed you ll have wanted to setup a MySQL database for your website
87. on to that can access and edit the Settings page Dashboard Reports Messages Stats Addons View Users Add Edit Users Manage Roles amp Permissions SAVE SETTINGS Username 2 Full Name 3 Email 4 Password 5 Retype your Password Role NONE 6 Receive Notuncatonssi 7 YES SAVE SETTINGS 8 45 2 4 3 Manage Roles and Permissions Ushahidi 2 0 introduced much more advanced role creation with the ability to specific permissions for each role as well Each user role can be created and edited by the Admin and Super Admin users at any time by going on the Manage Roles and Permission page 1 and clicking on Add Edit 2 On this page it is also possible to create specific roles 3 like reporter viewer observer and give to each one of them specific permissions to see or edit information inside the platform 4 In this section you can also delete a role 5 or edit it 6 Dashboard Reports Messages Stats Addons View Users Add Edit Users Manage Roles amp Permissions 1 2 adaveEdit Name Description 4 View Reports Create Edit Reports Approve amp Verify Reports C Manage Report Comments Download Reports Upload Reports _ Manage Messages C Manage Message Reporters C View Stats Modify Settings C Manage Panel C Manage Users SAVE SETTINGS ADMIN Edit Delete Administrative user has access to almost everything 5 6 SUPERADMIN Super administrative user has access to everythi
88. provider 3 Configure Map Dashboard Reports Messages Stats Addons Settings Manage Website Map SMS Email Themes Clean URLs API Map Settings SAVE SETTINGS CANC 1 JDefault Location 3 Configure Map Please select a default country Default Zoom Level Default Map View kenya ine Map CITTT ITT AITINN Retrieve Cities From Geonames 0 4 8 12 16 20 Latitude 18 54602262 Longitude 72 3456573 Does this Ushahidi Deployment Span Multiple Countries p O Yes No review Click and drag the map to set your exact location 2 Map provider q Oj S oF Setting up your map provider is a straight Grande Saline 4 ha ronaissemen par eNacional forward process Select a provider obtain an API gt Liancourt NU de Hinche oy Rai gar key from the provider s site and enter the API Saint Marc ro ee rs a key lede la Gon ve Naa rep ane B Step 1 Select a Map Provider Anse Galets N bv saint CA Bellade aS Google Maps Normal gr riani a de i 3 Croix NAT iste Step 2 Get an API Key PAS fond iene N lt i gt Petit Goave Get an API Key P ste on Croix Hilaire _Kengcot pansin dJFond Verrettes 4 Sorte O Nan Contres Q og e ho RZ Areg y iaa EE Bchaportin E Step 3 Enter the new API Key MTD Marr Musaco So Jacmel Mapo Qee 46 ess E T o Barahona ABQIAAAAjSEM5UsvVCPC i COOC cc Morne SAVE SETTINGS CANCEL 23 Default Location Here is where you can set up the country that you want your map to display
89. r spam To be able to use this function the administrator needs to be registered for a WordPress account and get a free API key S For more on Akismet see here http akismet com 21 Site Settings SAVE SETTINGS Site Name t 1 Jonna Site Tagline 2 My Ushateci Dasktryynert Site Email Address Alerts Email Address 4 Site Message 5 Site Copyright Statement 6 Uo Display Contact Page eye items Per Page Front End Ceaser items Per Page Admin 10 scien ik Allow Users to Submit Comments to Reports 12 eon include RSS News Feed on Website 13 Enable Statistics Stored on Ushahidi s server 14 15 Default Color For All Categories 16 com Cache Pages 17 Cache Pages Lifetime t 18 Mine Google Analytics 1 9 Wed Property 10 Fommato UL JODOU XE Cluster Reports on Map Twitter Search Terms 20 So steemed gu ce Madhiegi Seperate with corres Akismet Key commrert spar Abiu fron Actorwific 21 You ca bu can get free API bay by regtitering for Wordivets com user accounl 22 CANCEL 2 2 2 Map The default base map for the Ushahidi platform is a Google Map of Kenya To change the map and have it set on another country and to set up which base map to be displayed and how you can click on the Map tab on the Settings page The Map Setting page has three main components 1 Default Location 2 Map
90. reports are already on the map but are flagged as not verified in term of course or content In the list of reports the administrator can see the report title 1 the first sentence of the description field 2 the date 3 the location 4 the associated categories 5 and the source 6 28 For more info on Verification of information see http community ushahidi com uploads documents c_Ushahidi Verification Guide pdf 50 Get Help Ushahidi Wiki FAQ s Forum Search Dashboard Reports Messages Stats Addons View Reports Create Report Comments Download Reports Upload Reports Show all Approve Unapprove Verify Delete EE H Jrained Last Night Tents Urgently Needed 2010 03 22 Approve Verify Delete Report from Therese Desir who is working with the Ma St Marc It rained last 3 night in St Marc We have over 100 people looking to o ff for More Location saint marc haiti Kenya Submitted By Unknown via wee 6 IEF f CHE T s D Categories 2D RE j HELTER N Edit Log 0 In each of those three lists the administrator is able to see the report details by clicking on the report title and from that page review all the specific detail of the report and insert information about the source and the reliability of the information Ushahidi wu 2 reportslist1 tiff E board ports Messag S ddons Aid needed Santo 19 7 Croix des Bouquets 2010 03 16 Approve
91. rom 3013936590 The list of SMS messages can be displayed in two different ways extended meaning it 1s possible to see all the content or partially hidden meaning that you will have to click on the tab Preview Message 1 to see the text of the SMS By re clicking on it the text of the message will be hidden again In addition you will find below each message a function called Reply to be able to reply to the messages 2 This function can be customized to insert default replies 1 e a message that thank the sender and ask for more information Under the SMS tab it is also possible to see the number of the sender 3 while on the right side of the message it is possible to see the date 4 Delete Test from krtm Abdelgadir 4 2011 01 08 Create Report 1 Preview Message Reply 2 Request location Request more information SEND 3 From 249910301303 Test 2011 01 08 Create Report Delete Preview Message Reply From 249902555142 In the Reporters section there is sub navigation which allows the administrator to flag the SMS number sender as Spam 1 Trusted 2 Untrusted 3 or Trusted Verified 4 or to Delete 5 and Delete while flagging them as Spam 6 In the Reporters section you can see who has been registered as trusted reporter 7 or trusted verified 8 59 DELETE SPAM Delete SPAM Untrusted 5 6 1 3 2 4 sms Search The Reporter Has Been MODIFIED
92. rval of 1 month three months or six months Get Help OCHA IAU Early Warning System Wiki FAQ s Forum Search Dashboard Reports Comments Messages Feedback Stats Statistics Visitor Summary Country Breakdown ReportStats Category Impact zz Visitors Summary Choose a date range 1MO 3MO 6MO 2010 03 25 a 2010 04 27 Go gt Unique Visitors Visits Pageviews 29 392 124 66 Under the main graph it is possible to see the list of days with the indication of how many unique visitors visits or page views per day and the percentage 3 4 2 Country Breakdown This section shows the countries where users of the Ushahidi pages are located Country information is available over time and allows the administrator to see only the statistic referred to a predefined interval of time by inserting the dates in the apposite fields or by clicking on the date range buttons which allows you to choose an interval of one three or six months The countries that have the higher number of visitors are highlighted in red on the map while under the map there is the list if the countries with the numbers of unique visitors visits or page views per day per country and the percentage over the total views set Help OCHA IAU Early Warning System Wiki FAQs Forum Search Dashboard Reports Comments Messages Feedback Stats Statistics Visitor Summary Country Breakdown ReportStats Category Impact k m Country Breakdown Choose a date ra
93. s or the map they must first be approved by an administrator with the proper permissions Verifying the report 1s not a requirement to appear on the map but it does let your viewers know that the information in the report itself has been verified by either another source or the administrator of the platform Looking at the Show All reports you can see on the right side of each report if the report has been verified 4 or approved 5 or decide to delete it 6 By clicking on each one of those three choices the administrator will be able to act on that report Ushahidi Wiki FAQ s Forum Search Dashboard Reports Messages Stats Addons View Reports Create Report Comments Download Reports Upload Reports 1 show alt 2 3 Approve Unapprove Verify Delete Rained Last Night Tents Urgently Needed 2010 03 22 Approve Verify Delete Report from Therese Desir who is working with the Mayor of St Marc It rained last 4 5 6 night in St Marc We have over 100 people looking to our staff for More Location saint marc haiti Kenya yubmitted By Unknown via WEB ategories f j Edit Log 0 The Awaiting Approval tab lists only the reports that have not yet been approved by an Admin which means that those reports have been submitted but do not yet appear on the map Once approved the reports will immediately appear on the public map The Awaiting Verification tab lists all reports that have not been verified by an Admin these
94. s require a complete email address 2 Mail Server Password Email account password 3 Mail Server Port 0 Common ports 25 110 995 Gmail POP3 SSL 993 Gmail IMAP SSL 4 Mail Server Host Examples mail yourwebsite com imap gmail com pop gmail com 5 Mail Server Type Examples pop3 imap 6 Mail Server SSL support No Enable or disable SSL connections 7 SAVE SETTINGS CANCEL 2 2 5 Themes Themes Settings In this page you can to choose or change the main theme of the platform As default there are two main themes here Default Ushahidi Theme and Terra by David Cobia but it is possible to add as many themes as the administrator likes It 1s suggested not to change themes once the platform is already working because there is the risk to have some settings reformatted once the theme is changed Do not delete the Default Ushahidi Theme under any circumstance even if you have selected a different theme for your deployment Without getting overly technical in this guide additional themes build off of the templates or views in this theme Each additional theme built for the Ushahidi application pulls its base views form the default view Deleting the default theme will cause your other themes and the website to break Should you delete this theme you can restore your website by dragging the default folder back to within the themes folder without having to reinstall and start over 2 2
95. s within the apoplication conf7g folder That in mind you ll want to replace the following files and folders folders are listed in bold application favicon ico index php installer modules sql system application favicon ico index php J installer License txt media modules plugins README readme html S sal J system jj themes Upload these folders and files from the unzipped application folder on your computer replacing the folders and files currently on your system Since you re replacing the files we won t have to do anything with the permissions as we did with the initial installation Once those are uploaded move or upload the config php and database php files back to their place With all these files in place on the server access your website s administration section to begin the upgrade process This should only take a few moments and you re ready to get back to running your website 14 2 Customizing your platform Like many popular blogging platforms Ushahidi comes with a complete administration section to manage the general platform settings and process user contributed reports Now that your Ushahidi instance is installed and ready to go let s start by looking into how this works and the available functionality The Administrator of the Ushahidi platform has two main tasks The first is to perform the final check on the submitted reports before
96. scribe the different settings that users can use to can customize the platform 1 e choosing the most appropriate base map for your project syncing the platform with FrontlineSMS or other external systems for receiving and processing SMS messages setting up the email address and so on This guide is meant to be a comprehensive learning guide for brand new users of the Ushahidi platform as well as a reference for those who are more technically savvy or have used it in the past in an administrative capacity That said we have some recommendations on where to start in this book given your level of expertise Note that the Ushahidi community is a very active community and that you can always find someone to help you out if you have any problem not mentioned in this guide If you are looking for guidance or help please see the following guides and join these dedicated Skype chat groups 1 Channel for Deployers Researchers and Non Tech volunteers Share your best practices amp Tips List http list ushahidi com 1 2 Ushahidi Developer Chat 1 What you are working on 2 Any challenges 3 What would you like to work on next List at http list ushahidi com IF YOU ARE A USER GO TO SECTION 4 THE USER INTERACE IF YOU ARE AN ADMINISTRATOR AND WANT TO PROCESS MESSAGES COMING INTO YOUR PLATFORM GO TO SECTION 3 THE ADMINISTRATION SECTION IF YOU ARE AN ADMINISTRATOR AND WANT TO CUSTOMIZE YOUR PLATFORM OR CHANGE SETTINGS GO TO SECTION 2 H
97. ssage was posted On the right side of the message two tabs allows to Delete the Laconica message or to Create a report By clicking on the Create Report tab you will be directed to the Report form page where the body of the Laconica message will already be inserted in the Description The admin have only to add a title location and date and then submit the report If instead of Create Report there is a green tab that says View Report it means that the Laconica message has already been mapped and by clicking on this tab it is possible to access the report page The Reporters tab here works exactly the same way as explained in the previous section on SMS allowing the administrator to flag the Laconica message source Trusted Untrusted or Trusted Verified 3 3 5 Cloudvox The Cloudvox messages are accessible from two tabs one directly from the Messages section of the dashboard one from the Toolbar of the dashboard The Cloudvox tab allows you to do exactly the same things as the SMS tab but for the voice messages sent to your Ushahidi Cloudvox number Here too it is possible to see the list of all Voice Messages 1 Inbox 2 Trusted 3 and Spam 4 In the Cloudvox List you can see the Cloudvox number that left the message 5 and the date the voice message was left 6 On the right side of the message two tabs allow you to delete the voice message 7 or to create a report 8 By clicking on the Create Report tab you will be directed
98. t 2 and edit the text of the message in the bottom window that will open 3 The second thing that can be changed is the sounds file the custom file is an automatic voice reading your written message This voice can be substituted with a recorded message as MP3 file To do so you can use the Editing tab again and upload the MP3 file in the apposite field 4 1 Hello thank you for calling Ushahidi 1 Hello Edit tAdd Sound File Optional 2 Upload New After the tone please speak your current location clearly 2 Location Edit Add Sound File Optional For Example Nairobi at the corner of Uhuru Highway and Valley Road 3 Example Edit Add Sound File Optional Location When you are done please press pound 4 Press Edit tAdd Sound File Optional Next please speak the details of your report 5 Report Edit tAdd Sound File Optional Thank you for your report 6 Thanks Edit Add Sound File Optional 1 Pages 1 2 Edit Prompt Text Sound File Optional 3 After the tone please speak your current location clearly Browse 4 a m See Cloudvox website for more http www cloudvox com and see here for more on the Cloudvox plugin http blog ushahidi com index php 2010 07 16 call to report feature via cloudvox 43 2 4 The Users Section 2 4 1 View User The User section 1 is the page where you can see the Accounts set up in your platform change and create accounts by setting up Passwords a
99. t they are publicly displayed on the map On the side of each report there are two options you can click on Create Report 7 or Delete 8 By clicking on the Crete Report tab the admin will be directed to the Report form page where the SMS body will be already inserted in the Description The admin have only to add a title location and date and then submit the report 2 If instead of Create Report there is View Report 9 it means that the message has been already processed and is now a report By clicking on that tab it is possible to see the report that was created form that SMS 3l See section 3 2 2 to see how to fill the report form 58 Dashboard Reports Messages Stats Addons SMS Email Twitter Laconica 1 inbox 2 3 4 5 6 DELETE SPAM NOT SPAM simul 63 10 45 estoy en soacha no tenemos comida ni albergue personas armadas 2010 11 19 7 create Report Delete reparten lo poco que hay a su antojo sin priorizar necesidades armando mas caos Preview Message From 3013936590 simul 63 10 45 estoy en soacha no tenemos comida ni albergue personas armadas 2010 11 17 View Report Delete 8 reparten lo poco que hay a su antojo sin priorizar necesidades armando mas caos Preview Message From 3013936590 simul 3 10 40 estoy en soacha y vemos que ninos que estan sin familiares estan siendo 2010 11 17 Siew Report Delete llevados por personas de grupo armado necesitamos ayuda Preview Message F
100. tatic visualization into a dynamic visualization displaying the reports as they were added to the system 2 To view the published reports in a given period of time you just have to insert the dates in the two boxes located in between the timeline 3 and the map This will set the time interval you want to look at and you will see on the map only the dots representing the reports inserted in that time range If you want to view an animation of the reports mapped over time and space over a certain period of time simply insert the dates in the two boxes and click on the Play button TIMELINE OF EVENTS 3 From Jan 12 2010 To Aug 29 2010 PLAY 2 4 ia r if cy ILU lt U A 1 78 4 1 4 The Static Layers Static layers are useful for your project in displaying information such as different regions states or provinces demographic information borders or other general information that may help provide additional context to the real time information you are gathering on the ground but information you don t want to include as reports to clutter up your other sources Ushahidi provides the means to include and abstract this information from your reports as well as the option for your users to toggle this information on or off depending on their preference The static layers are the KML or KZL file Those files contain information about static points or areas on your map For example these static poi
101. teristic of the selected category will appear on the far end of the page in the section called Add Edit It s possible to change 7 the name of the category 7 the description 8 the color 9 the parental relationship with other categories 10 and icon 11 Click on Save to save the new characteristic of the category 12 To create a new category fill the boxes in the Add Edit section and then save the settings It is also possible to do this by clicking on the Add New tab on the side of the Category tab on the Toolbar 13 All the fields are required except for the Icon one The Parental Category tab allows you to create sub categories if left on Top Level Category the category will be a main one and be shown as such in the homepage under all categories If you want to create a sub category you need to select in the scroll down menu the Top Category under which you wants to add as sub category The sub categories will not show up in the category list on the homepage automatically but only when the user selects the Top Level Category under which the sub one is listed See section 4 1 2 for info on how to see reports by category in the Homepage 35 You can add as many categories or sub categories as you wish but only one level of sub category is allow The Ushahidi platform will list the categories in alphabetical order to choose a different order add a number in front of the category name or a letter and the system wi
102. the Continue button to move on The next screen Fig 3 covers general information about the website Your website name tagline or slogan default language and site email address are all straightforward Ushahidi 1 Database 2 General 3 Mail Server 4 Map 5 Finished Site Name The name of your site Site Tagline Your tagline Default Language English US es Each instance of Ushahidi comes with a set of built in Locale language translations You can also add your own Site wide email communication will be funneled through Site Email Address this address This option makes Ushahidi to be accessed via clean Enable Clean URLs URLs without index php in the URL Previous Continue gt Fig 3 Site email address Keep in mind this will be the email address displayed on the website to accept reports should you enable that functionality Clean URLs What are Clean URLs Clean URLs are URLs that do not display string information in the URL and show only the page and path This is better explained with an example Without Clean URLs enabled here s what the URL for your about page once we complete the installation would look like http yourdomain com index php page about With Clean URLs set to YES your about page will look like this http yourdomain com index php about Clean URLs are preferred as it makes things clearer to the user and improves search engine optimizat
103. they areis published on the website We ll discuss task in more detail in chapter three The second task that the administrator performs is the customization of the platform from the setting up of the map to the SMS number This task is explained in this section of the guide Overall I think this second paragraph is too much detail for two points that are covered later in the guide I removed a big chunk of it as such but still feel that this introduction should cover in order what is listed in the table of contents not pointing out a couple of the features covered much later rob 2 1 Logging in If your website is www yourdomain com the administration login would be available at http yourdomain com admin or http yourdomain com login It will look like this Ushahidi Username Password L Mbtay logged in on this computer Log In orgo a Enter the username and the password to access the Admin page If this is your first time logging in use admin for both the username and password which yovw ll want to be sure to change once you re logged in Now that we re logged in let s look at the available options on the administration page to manage the incoming information in your platform 1 Dashboard 2 Reports 3 Messages 4 Stats 15 5 Addons In addition there are three additional tabs on the top right side of the page related to the customization and the s
104. ting 2009 03 18 10 10 00 Accra Looting happening everywhere RIOTS DEATHS PROPERTY LOSS YES NO File to upload Browse Upload 57 3 3 Messages All of the incoming messages are listed here which in this case refer to SMS emails Twitter and Laconica messages If you have also installed the plug in that allows you to sync with Cloudvox then you will also have in this section the voice messages coming into your platform You can access this section of the admin page by both the tab in the main navigation or the link in the message section of the dashboard As a clarification note keep in mind that with messages here we refer to the incoming information as they enter into the system Those messages will not be displayed publicly until they are processed and transformed into reports via the report form and approved 3 3 1 SMS The SMS messages are accessible from two tabs one directly from the Messages section of the Dashboard one from the Toolbar of the Dashboard Clicking on the SMS tab will access the page were all incoming SMS are listed In this section you can see Inbox 1 Outbox 2 All 3 Trusted 4 Spam 5 or the Reporters 6 All Messages and Inbox will show all the SMS that has come into the platform the ones that have been transformed into report but not approved the ones that yet have to be processed and transformed into report and the ones that have been already processed as report and approved so tha
105. ts a report will not be constrained to the exact location of the default marker To change the default location of the marker insert the GPS coordinates in the two boxes in decimal format Those two actions setting the zoom level and the position of the red marker can be done also just by using the mouse and clicking on the map It is possible to position the red marker by double clicking on the right location By grabbing the map and moving it you can decide which section of the map will be visible to the user on the homepage Once all the settings in the map page have been set they can be saved by clicking on the Save Settings tab on the bottom of the page Every time one of the settings is changed it is required to save the settings again 25 Configure Map Default Zoom Level 1 Default Map View Map gt 3 4 0 4 s 12 16 20 Latitude 18 971187 Longitude 72 285215 Preview Click and drag the map to set your exact location 72 26807 19 29041 9ue Rande ro LN Pignon Ravine Nan Sable 2 oae a a aM Cercadie Froide Desdunes Aiondissement Nan Viin de Saline de Dessalines Lejene rani vame Hautes a Cerca 4 Feuilles Martin Cajou Brule Carvajal Cerca AS Cc Laverdure HautBou Malssade HautJacob Palma Source en Saint M P La Salable Arrondissement _ HL aint Marc Liancourt i L Artibonite de Hinche Pont Chariot Desjardines O99ard Roche Plate Roche YE Bail Matel fte canal g
106. ver host Under the box there are several suggestions on what those hosts can be To verify which Mail server host you have please look at the Settings page of your email account 5 Mail Server Type Here is where you can insert the server type The most common used are POP3 and IMAP but again the settings page of the email account chosen will list the correct server type 6 Mail Server SSL Support In this box you should insert the data related the support of SSL from the server you are using for his email account This information too is available in the setting page of the email account in use Now you can just save the settings by clicking on the Save Settings tab and all the data inserted will be saved Every time something will be changed in those settings you need to click again on the Save Settings tab to have those changes saved It is suggested to test the settings every time something is changed in this page to be sure that the new account is working properly 20 http wiki ushahidi com doku php 32 Dashboard Reports Messages Stats Addons Website Map SMS Email Themes Clean URLs API Mail Server Settings 7 save seTTINGs cancer In order to receive reports by email please input your email account settings below Please note that emails will be received at your site email address myemail myhost com so your settings have to be associated with this email address 1 Mail Server Username Some server
107. y The categories help to categorize the incidents by type The reporter must select at least one category type but it is possible to select as many categories that apply If there are subcategories to see them it is necessary to click on the plus sign placed before the category and a scroll down menu will appear with all the sub categories Correct categorization is important and should not be rushed In general try to select just one category if possible e Map The map allows viewers visually provide the location of the incident If the name of the street address or GPS coordinates are not known but the reporter can find the location on the map she can double click on the location of the event on the map to place the red marker there This will automatically record the coordinates and point on the Ushahidi map It is important to zoom in on the map to a level where it is actually possible to accurately place the marker at the correct location The more specific the better In addition to plotting the report location on the map the reporter is required to write the name of the location in the Refine Location name box under the map f Refine Location Name and Find Location tab The location of the event is one of the most important pieces of information to be inserted into the report If the reporter knows exactly where the event happened she can insert the GPS Coordinates by simply entering them in the box below the map and by clicki
108. you want to use Clickatell also to receive SMS messages you need a 2 way number from Clickatell but once you have it you need to make some changes in the u http wiki ushahidi com doku php 8 For more on this see also http frontlinesms ning com forum topics can flsm recover messages that xg source activity 5 http www clickatell com 31 Ushahidi code to make this work for you Please see the Ushahidi Wiki for instructions on how to do this 2 2 4 Email This page is where you can set up the email settings to be able to receive emails from users To do so you must have an email account already set up with Google Yahoo or whatever domain 1 Mail Server Username This is where you can enter the email address you want to use to receive and send emails It is recommended to set up an separate email address for this purpose preferably one that has lot of available space to avoid the account getting full in a short time especially if the platform will be receiving a lot of submission via email 2 Mail Server password In this section you should put the password of the email account inserted above 3 Mail Server Port In this box you have to put the port that the email account chosen uses for incoming emails This port is normally listed in the settings of the email account itself and under the box there are some suggestions for the most common ports used 4 Mail Server Host This is where you need to insert the mail ser

Download Pdf Manuals

image

Related Search

Related Contents

Uric Acid/Uricase Assay Kit  Manual de instalación rápida  「独占禁止法に関する相談事例集(平成 19 年度)」の  Fiche - Typologie des phénomènes hivernaux verglas  User Manual - Pro-Ject Audio Systems  Magnavox AZ-1102 Owner's Manual  User manual AM10 – outdoor temperature-controlled  Philips PL-E Spot energy saving bulb 871150065989700  HUMATROPEN® 6 mg - Eli Lilly Canada  Guia - Conecta e Modulare Mais  

Copyright © All rights reserved.
Failed to retrieve file