FOR ARCHIVAL PURPOSES ONLY

The information in this wiki hasn't been maintained for a good while. Some of the projects described have since been deprecated.

In particular, the "Ushahidi Platform v3.x" section contains information that is often misleading. Many details about this version of Platform have changed since.

This website is an extraction of the original Ushahidi wiki into a static form. Because of that, functions like logging in, commenting or searching will not work.

For more documentation, please refer to https://docs.ushahidi.com

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

How To White-Label The App

  • 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)
  • Replace each image in the folder with your own custom graphic, maintaining the image dimensions and filenames
  • 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)
  • Duplicate the Ushahidi.plist file using the name of your map as filename (ex MapATL.plist)
  • Edit BUNDLE NAME AND VERSION section with name of your map and an unique Bundle Indentifer (ex com.ushahidi.ios.mapatl)
  • Edit SUPPORT INFORMATION section with email and website for your map
  • Edit SINGLE DEPLOYMENT URL section with the URL for your map
  • Edit STYLING COLOR CODES section with various HEX color codes to match your map styling
  • Optionally edit BITLY AND TWITTER API KEYS if you have your own API keys for these services
  • For BITLY, Sign Up for a Bitly Account, then visit Your bitly API Key to find your BitlyLogin and BitlyApiKey
  • For TWITTER, Sign Up for a Twitter Dev Account, entering your application name, description, website, organization, etc then visit Using Twitter xAuth for information on obtaining xAuth which is not enabled by default. Note, you'll need to email api@twitter.com explaining that your mobile application requires xAuth to skip the request_token and authorize steps and jump right to the access_token step.
  • In Xcode, Right-Click target (ex MapATL) > Get Info > Targets tab, edit the Info.plist File to your new plist file (ex MapATL.plist)
  • You should now be able to deploy your white-labelled version of the app to the Simulator for testing, enjoy!