Platform User Manual
[Legacy v3] User Manual
[Legacy v3] User Manual
  • [Legacy v3] Ushahidi Platform User Manual
  • Navigating the Ushahidi Platform User Manual
  • About Ushahidi
  • Overview of Ushahidi Platform v3.0
    • Technical Specifications
  • 1. Installing Ushahidi Platform
  • 2. Setting up a deployment
    • 2.1 Upgrading/Downgrading your deployment plan
  • 3. Configuring your deployment
    • 3.1 Accessing your deployment
    • 3.2 General Settings
    • 3.3 Surveys
    • 3.4 Data Sources
    • 3.5 Categories
  • 4. Managing People on your deployment
    • 4.1 Roles
    • 4.2 Users
  • 5. Modes for visualizing and managing data on your deployment
    • 5.1 Map View
    • 5.2 Data view
    • 5.3 Activity view
  • 6. Managing Data in your deployment
    • 6.1 Viewing Posts
    • 6.2 Filtering Posts
    • 6.3 Adding Posts
    • 6.4 Editing Posts
    • 6.5 Translating Posts
    • 6.6 Publishing Posts
    • 6.7 Deleting Posts
    • 6.8 Importing Data
    • 6.9 Exporting Data
      • 6.10 HDX integration
  • 7. Managing your Donations
    • 7.1 Donations
  • 8. Analysing Data on your deployment
    • 8.1 Saved Searches
    • 8.2 Collections
  • 9. Additional Links
Powered by GitBook
On this page
  • Video setup guide
  • Setup Guide
  • 3.5.1 Adding and Configuring Categories
  • 3.5.2 Editing Categories
  • 3.5.3 Deleting Categories
  1. 3. Configuring your deployment

3.5 Categories

Previous3.4 Data SourcesNext4. Managing People on your deployment

Categories are a way of grouping your posts based on their content within a Survey.

The setup in this guide is demonstrated in the below video as well. You can watch and follow the guide at the same time!

Video setup guide

Setup Guide

To access the Categories configuration page,

  • On the left hand menu bar, click on Settings

  • Then, click on Categories.

  • You’ll be redirected to a page where you can manage categories on your deployment

3.5.1 Adding and Configuring Categories

Unlike Ushahidi v2.x, your deployment DOES NOT come with pre installed/set-up categories. You will need to create this on your new Ushahidi deployment. Categories are now treated as custom fields within a Survey. This gives you the flexibility to add certain categories to some surveys, but not others.

There are two ways to create new categories. First, navigate to Settings → Categories

  • Click on the Add Category icon as shown below

  • In the upper left corner of the category page, you will see the default language that your deployment is currently in.

  • Add the following details

    • Category Name: Give your category a name that will appear on your homepage and when users are creating new posts.

    • Description: You can provide a brief description of what kind of information you will fall under this category

    • Child / parent settings: You can choose to set any category as a “child” to another, creating a hierarchy within the categories themselves, and will reflect this in their positioning on the sidebar.

    • Default language: Click on the drop down menu to select your preferred default language

Once that is done, you can translate the category into other languages.

To do that;

  • Click on + Add translation at the upper right-hand corner of the screen.

  • A pop-up module will appear on your screen, click on the dropdown menu, and select the language you want to translate to.

  • Click on Add to finish.

  • You will be redirected to a page with the translatable content in the default language and fields where you can add your translations.

  • On the empty fields, translate the category name and description details into the chosen language e.g in the above image the default language is English and the added language is Swahili.

  • Click Save when all is done to create the category. You can now choose to add this category to any of your Surveys.

  • Under the category name, you will see the available languages the category has been translated into.

Add categories as custom fields as you build and edit Surveys. First, navigate to Settings → Surveys, and either select the already existing Survey you’d like to edit, or create a new Survey.

  • Click on Add field at the bottom of the survey builder and select _Categories _from the list of field options

  • Configure the following:

    • Name: Name or prompt for your survey field

    • Show field description: Turn this on if you’d like to add a short description or help text to the field

    • Which labels should be available: Select which categories you’d like to add to the field as options

  • Click Add & Close to save your new categories field

  • It will now appear as a custom field with the appropriate categories on your Survey form

3.5.2 Editing Categories

To edit a category,

  • Click on the desired category from the category list page

  • When done, click on Save, and your changes will reflect shortly.

3.5.3 Deleting Categories

You can delete one or multiple categories at a time.

Deleting a category from the category list page

To delete a single category, select the trash icon adjacent to the category.

To delete multiple categories:

  • Tick the checkbox on the left, adjacent to the category/categories you would like to delete from the category list page

  • This action will activate the previously inactive Delete button on top left hand corner of the page. Click on this button to initiate deletion.

Deleting a category from the category edit page:

  • Click on the Delete Category button

  • A pop up box will appear on the top of the page, prompting you to confirm whether you would like to delete the category/categories

    • Click on Delete to delete your category/categories

Roles: You can opt to set your category as visible to specific user roles on your deployment here. This list is populated based on custom roles created. More on .

Select a language you want to translate your content to.
Swahili was the language selected for translation
All the available languages that the content has been translated to are shown.

You’ll get redirected to the Edit Category page, where you should be able to add/edit details as described in the above.

If you’d like to cancel the category deletion process, click on Cancel

Roles here
adding categories section
Category configuration video
Settings button in Ushahidi side bar.
Clicking on Settings -> Categories to access category list and actions.
Click on the + yellow circle to add a category.
Click on the + yellow circle to add a category.
Add categories to a survey.
Adding a category as a field to a survey. "Add field" modal.
Select a category's checkbox from the categories list in the Settings -> Categories page to edit it.
Save your changes with the yell
Highlighted: trash (delete) button on the right side of the categories list.
Select the checkboxes in the category list corresponding to categories you wish to delete. Click the trash button on the top menu bar to delete.
DELETE CATEGORY button on the bottom of the edit page.