Deploying PEPFAR Rich Text & Video Dashboards App

From the docs on github:

  1. Install the app via the App Hub or by uploading the zip
  2. Be sure to grant access to the app to all users, or they will not see the content. To do this, go to DHIS2 Users > User role > [role] > Apps > select Information app. Make sure to do this on enough roles to give all users access. (For example, if all users on your system have a Guest or Read Only role, giving the permission to that role is sufficient.)
  3. From the Dashboards page of your DHIS2 installation, edit a dashboard. (If you do not have any dashboards, you will need to add a new dashboard.)
  4. Click Search for items to add to this dashboard, and select Information under Apps.
  5. Click the Edit button on the Information widget to create content.
  6. If you would like to restrict the creation and editing of Information content to superusers, go to the Datastore Manager, select the dashboard-information namespace, then the configuration key and check the Only open to superusers box. (This namespace and key will only be present after you have created an Information widget.)
  7. If the widget shows the message Refused to connect after you add it to the dashboard, follow these instructions to fix.

It is likely we will need to change the NGINX headers to

allow X-FRAME-Options to SAMEORIGIN…

Refused to Connect Error message

If you get the message Refused to connect when you hover over the widget after adding it to a dahsboard, follow these steps to fix.

  1. Go into the developer console and see if you see this message:
Refused to display ... in a frame because it set multiple 'X-Frame-Options' headers with conflicting values ('SAMEORIGIN, DENY'). Falling back to 'deny'.
  1. If you do not, please create an issue and let us know what message you do see.
  2. If you do, your nginx config needs to be updated to allow the application to run. Change this line in your nginx config:
add_header X-Frame-Options DENY

to:

add_header X-Frame-Options SAMEORIGIN