Deploying PEPFAR Rich Text & Video Dashboards App
From the docs on github:
- Install the app via the App Hub or by uploading the zip
- 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.) - 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.)
- Click
Search for items to add to this dashboard
, and selectInformation
underApps
. - Click the Edit button on the Information widget to create content.
- 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 theconfiguration
key and check theOnly open to superusers
box. (This namespace and key will only be present after you have created an Information widget.) - 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.
- 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'.
- If you do not, please create an issue and let us know what message you do see.
- 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