Platform User Manual
[Mzima] User Manual
[Mzima] User Manual
  • [Mzima] Ushahidi Platform User Manual
  • Navigating the Ushahidi Platform User Manual
  • Downloading the User Manual
  • Translating the User Manual
  • About Ushahidi
  • Overview of Ushahidi Platform [Mzima]
    • Technical Specifications
  • 1. Installing Ushahidi Platform
  • 2. Setting up a deployment
  • 3. Configuring your deployment
    • 3.1 Accessing your deployment
    • 3.2 General Settings
    • 3.3 Surveys
    • 3.4 Data Sources
      • 3.4.1 Email
      • 3.4.2 Gmail
      • 3.4.3 Vonage(formerly NextMo)
      • 3.4.4 SMSSync
      • 3.4.5 Twilio
      • 3.4.6 Twitter
      • 3.4.7 Africa's Talking
    • 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
    • 5.4 Data managing functionalities shared among views
  • 6. Managing Data in your deployment
    • 6.1 Viewing Posts
    • 6.2 Filtering and Sorting Posts
    • 6.3 Adding Posts
    • 6.4 Editing Posts
    • 6.5 Translating Posts
    • 6.6 Publishing Posts
    • 6.7 Deleting Posts
    • Page
    • 6.8 Importing Data
    • 6.9 Exporting and Tagging Data
      • 6.9.1 Exporting Data
      • 6.9.2 Tagging Data - HDX integration
  • 7. Analysing Data on your deployment
    • Untitled
    • 7.1 Saved Searches
    • 7.2 Collections
  • 8. Additional Links
Powered by GitBook
On this page
  • Description
  • Permissions included in the platform
  • Video setup guide
  • Actions that need Authorization or Login to be Accessed
  • Setup Guide
  • 4.1.1 Add Role
  • 4.1.2 Edit Role
  • 4.1.3 Delete Role
Export as PDF
  1. 4. Managing People on your deployment

4.1 Roles


Description

This feature allows you to set up and manage default and custom roles and permissions for different user groups on your deployment. Each deployment has a default “Admin” and "Member" role, which cannot be deleted. The default “Admin” role allows for full control over ALL functionality on your deployment, while the default "Member" role only grants access to edit their own posts. "Member" role can be edited to update the permissions. "Admin" role cannot be edited to update the permissions.

Also, permissions are fully determined by Role-Based Access Control (RBAC). This means that each user can be assigned a specific role by an admin, which in turn grants them a particular set of operations within the platform. Below is a list of permissions included in the Mzima Platform;


Permissions included in the platform

  • Manage Users: This permission entails the following operations;

    • Viewing the list of users on the platform

    • Adding, Editing or Deleting Users

    • Changing the Roles of Users

  • Manage Posts: This permission entails the following;

    • Viewing the Posts

    • Adding or Editing their Posts

    • Publishing Posts

    • Archiving Posts

    • Adding Posts to Collections

  • Manage Settings: This permission entails managing the settings in the platform

    • Users can manage the general settings which allow the user to:

      • Change the deployment details

      • Adjust the privacy settings for the deployment

      • Adjusting the location settings. You can find more about this here.

    • Adding, Editing or Deleting data sources

    • Adding, Editing or Deleting Surveys

    • Adding, Editing or Deleting Categories

    • Users can configure the HDX API and create webhooks

  • Bulk Data Import and Export: Allows users to import and export CSV files

  • Edit their own posts: Allows the user to be able to edit their posts

  • Manage Collections and Saved Searches: This permission entails the following:

    • Addition/Removal of posts from all saved searches and collections

    • Editing all saved searches or collections

    • Deleting all saved searches and collections

  • Delete Posts: This permission allows the user to be able to delete posts from the platform

  • Delete their own Posts: This permission allows the user to be able to delete the posts that they have created themselves.

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

Video coming soon


Actions that need Authorization or Login to be Accessed

Users can still interact with the Mzima Platform while logged out, but their capabilities will be limited compared to those of logged-in users. Here is a breakdown:

If a user is not authenticated;

  • The user can create posts on the platform although the usernames will be marked as Anonymous. Also, the user cannot edit their posts once submitted.

  • The user can view statuses that are published only.

  • The user can view saved filters if only the visibility of the filters is set to ‘Everyone’.

  • The user can view categories if only the visibility of the categories is set to ‘Everyone’.

  • The user can view collections if only the visibility of the collections is set to ‘Everyone’.

  • The user can share posts.

If a user is authenticated;

  • The user can access the platform settings if they have the 'Manage Settings' permission only.

  • The user can create saved filters and adjust the visibility.

  • The users can create posts. It is worth noting that they can only edit them if they have the 'Edit their own posts' permission.

  • The user can create a collection but they will only be visible to them and the admins. If they have the ‘Manage Collections and Saved Searches’ permission in their role, they can adjust the visibility to either ‘only me’, ‘everyone’ or ‘specific roles’. Also, a user can create and delete collections but cannot edit them if they do not have this permission.

  • The user can see published posts for everyone and their posts that are 'under review' or 'archived'.


Setup Guide

To access the roles management page, on the sidebar, click on Settings


Then, click on Roles

You’ll be redirected to a page with a list of all existing roles - default & custom roles (created by admins if any exist).


4.1.1 Add Role

To add a custom user role, click on the yellow Add icon


Add the following details

  • Name: Provide a name for this new custom role

  • Description: Provide a brief description of what/who this custom role has been created for

    • Manage Users:

    • Manage Posts:

    • Manage Settings:

    • Bulk Data import and Export:

    • Edit their own posts:

    • Manage collections and saved searches:

  • Click on Save.


4.1.2 Edit Role

To edit a role, click on a role from the list provided to you.


Next:

  • Click on Save to update the role.


4.1.3 Delete Role

To delete a role, click on a role from the Roles management list page


Then, click on the Delete button at the bottom of the page

A pop up box will appear on the top of the page, prompting you to confirm whether you would like to delete the custom role. If:

  • You would like to proceed with deletion, click on Delete

  • You would not like to proceed with deletion, click on Cancel

Previous4. Managing People on your deploymentNext4.2 Users

Last updated 6 months ago

Set your permissions. The list below shows the list of permissions included in the platform. You can view the brief breakdown of each of the permissions that can be granted to users by selecting .

On redirection to the edit page, make your desired changes to the role (i.e fill out details as directed in the section)

here
Add role
Settings button on the Ushahidi Platform sidebar.
Settings list page. Roles button highlighted.
Click on the 'add role' button to add a new role.
The add role page contains a role name, description, and preferred permissions.
Click on a role from the Role - "Test123 Role" highlighted
Adding details to a new role. Name, description and permission fields available.
Selecting a role "Test123 Role" in the roles list.
Click the DELETE button
Delete role confirmation pop-up
Settings button on the Ushahidi Platform sidebar.
Settings list page. Roles button highlighted.
Click on the 'add role' button to add a new role.
The add role page contains a role name, description, and preferred permissions.
Click on a role from the Role  - "Test123 Role" highlighted
Adding details to a new role. Name, description and permission fields available.
Selecting a role "Test123 Role" in the roles list.
Click the DELETE button
Delete role confirmation pop-up