Need help with Ushahidi_iPhone?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

ushahidi
127 Stars 59 Forks GNU Lesser General Public License v3.0 392 Commits 28 Opened issues

Services available

!
?

Need anything else?

Contributors list

Ushahidi iOS

Ushahidi is an open source platform for democratizing information, increasing transparency and lowering the barriers for individuals to share their stories.

The iPhone and iPad app synchronizes with any Ushahidi deployment allowing viewing and creation of incident reports on the go.

The app supports loading of multiple deployments at one time, quick filtering through incident reports, exploring incident locations on the map, viewing incident photos, videos, news article, media as well as sharing incident reports via email, SMS, Twitter, Facebook or QRCode.

Once the data has been downloaded, the app can function without an internet connection, allowing accurate collection of data utilizing the device's camera and GPS capabilities.

Old Repository

The old Ushahidi iOS 2.X code repository can be found at Ushahidi iOS 2.X

Using The SDK

Including the Ushahidi SDK in your own project allows you to create your own custom app that synchronizes with an Ushahidi deployment.

  • Add Ushahidi.framework into your project
  • Add Ushahidi.bundle into your project
  • Add libraries marked as Required: Foundation.framework, UIKit.framework, CoreFoundation.framework, CoreGraphics.framework, CoreData.framework, CoreLocation.framework, MobileCoreServices.framework, MapKit.framework, MessageUI.framework, QuartzCore.framework, Security.framework, SystemConfiguration.framework
  • Add libraries marked as Optional: FacebookSDK.framework, Twitter.framework, Accounts.framework, Social.framework, AdSupport.framework
  • Add linked library marked as Optional: libsqlite3.0.dylib

How To White-Label

Whitelabeling the app allows you to quickly and easily create your own branded version of the app, with your own colors, graphics and pointing to your own map deployment.

  • Duplicate the Ushahidi target with the name of your map (ex MapATL)
  • Right-click on your new target (ex MapATL) select Get Info > Build tab > rename Product Name to name of map without spaces (ex MapATL)
  • Duplicate the /Themes/Ushahidi folder with the name of your map as folder name (ex /Themes/MapATL)
  • In XCode, on your new theme folder (ex /Themes/MapATL) Right-Click > Get Info > Targets tab, uncheck Ushahidi and check your new target (ex MapATL)
  • You can now customize your app by editing the following properties in Info.plist in your new Themes folder
Name and Identifier
  • CFBundleIdentifier: unique identifier of your app (ex com.ushahidi.ios.mapatl)
  • CFBundleName: title of your application (ex MapATL)
  • CFBundleDisplayName: name of your application (ex MapATL)
Custom Map URL
  • USHMapURL: URL for your map (ex http://crime.mapatl.com)
  • USHMapURLS: leaving the USHMapURL blank, you can optionally define multiple maps in the USHMapURLS dictionary
Support Email and URL
  • USHSupportEmail: support email for your deployment (ex [email protected])
  • USHSupportURL: website for your deployment (ex http://crime.mapatl.com)
  • USHAppStoreURL: link on App Store to download your application (ex http://itunes.apple.com/app/ushahidi-ios/id410609585)
  • USHAppDescription: sentence describing the application or the organization
Color Codes
  • USHNavBarColor: color for navigation bar
  • USHTabBarColor: color for tab bar
  • USHToolBarColor: color for tool bar
  • USHSearchBarColor: color for search bar
  • USHButtonDoneColor: color for done bar
  • USHRefreshControlColor: color for refresh control
  • USHTableBackColor: background color for tables
  • USHTableRowColor: text color for header
  • USHTableHeaderColor: text color for header
  • USHTableSelectColor: background color of selected rows
Report Settings
  • USHShowReportList: boolean flag whether to show the list/map of reports (disabling will prevent the downloading of reports)
  • USHShowReportButton: boolean flag whether to show the new report button (disabling will prevent submitting new reports)
  • USHSortReportsByDate: sort the report list by the report date
Optional URLs

Optionally you can define Privacy Policy and/or Terms Of Service URLs which require the user to visit before proceeding with the application.

  • USHPrivacyPolicyURL: optional URL for privacy policy
  • USHTermsOfServiceURL: optional URL for terms of service
Facebook App ID

Facebook will require you to register a new app at Facebook Developers

  • FacebookAppID: identifier for your Facebook app
  • CFBundleURLTypes: callback URL, update the CFBundleURLName value to fbXXXXXXXXXXXXXXX with your Facebook app id
YouTube Credentials

If you would like to publish videos under your own YouTube channel, you'll need to sign up for a YouTube Developer Account.

  • USHYouTubeUsername: Youtube login
  • USHYouTubePassword: Youtube password
  • USHYouTubeDeveloperKey: Youtube Developer Key
Custom Images

Replace each image in your theme folder with your own custom graphic, maintaining the image dimensions and filenames.

  • Default.png: launch screen for iPhone
  • [email protected]: launch screen for iPhone with retina display
  • Default-Portrait.png: launch screen for iPad
  • [email protected]: launch screen for iPad with retina display
  • [email protected]: launch screen for iPad 5
  • Icon-iPhone.png: app icon for iPhone
  • [email protected]: app icon for iPhone with retina display
  • Icon-iPad.png: app icon for iPad
  • [email protected]: app icon for iPad with retina display
  • Logo-iPhone.png: image in settings screen which links to USHSupportURL
  • [email protected]: image in settings screen which links to USHSupportURL
  • Logo-iPad.png: image on iPad in settings screen which links to USHSupportURL
  • [email protected]: image on iPad in settings screen which links to USHSupportURL
  • Logo-Title.png: optional logo image in Nav Bar
  • [email protected]: optional logo image in Nav Bar for retina display
  • iTunesArtwork.png: artwork for the iTunes App Store

You should now be able to deploy your white-labelled version of the app to the Simulator for testing, enjoy!!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.