Skip to content
saragilcas edited this page May 20, 2024 · 18 revisions

Homepage App is a DHIS2 Web Application part of EyeSeeTea's DHIS2 Suite. It is an innovative and user-friendly solution for creating customized landing pages within your DHIS2-based instance. It streamlines the development process by providing a wiki-style editor that allows for easy organization and editing of content. This powerful tool was inspired by Training App, which took home top honors at the 2021 DHIS2 Annual Conference.

This app allows to provide direct links to DHIS2 applications and the fully customizable landing pages can work on a per-user/group basis.

Installation

Homepage App can be installed on any existing DHIS2 instance. It is installed using the built-in App Manager. You can download it from the DHIS2 App Hub. Once you have the zip file on your computer, please visit the "App Management" app on your DHIS2 instance and upload the file you just downloaded.

Once the upload finishes, you will be able to access the HomePage app from the applications menu, which can be found in the search bar.

Presentation and Demo Video

youtube presentation screenshot

Presentation of HomePage App during the 2023 DHIS2 App Competition. You can watch a brief presentation of the application and a short demo by Nacho Foche, EyeSeeTea's Director.

Features

Settings

To start using Homepage App, click on the settings icon on the top left. It should go to http://your_instance.com/api/apps/Homepage-App/index.html#/settings

settings

Google Analytics 4 Support

You can track your visits using GA4. Just go to settings and add the code

analytics

It can also capture click actions as Google Analytics page view events

How to create a landing page

Click on the plus icon on the bottom right and choose "landing page". Then you can select different options and add the content through a very intuitive interface.

landing_gif

How to see the landing pages

If you are on the setting page, click on the top left arrow. It should go to http://your_instance.com/api/apps/Homepage-App/index.html#/ where you will see a display with all the available landing pages. Clicking on any of them will take you to the corresponding site.

landing_pages_homepage

Each landing page can have different sharing settings for different users. Only allowed users will see the corresponding landing pages. when there is only one available page for one user, the user will be redirected to this landing page.

How to export and import a landing page

Once you create a page, you can easily export it to another DHIS2 instance.

To export it, select the landing page and click on the three dots menu to the right. You will see the option "export landing page". On clicking, a zip will be downloaded to your computer.

To import it into a new instance, just click on the settings icon on the right and choose "import landing page". Then you have to select the zip that was created during a previous export. In a few seconds, you will have your landing page available.

import

landing_imported

How to import translations

You can easily add translations for your landing page using json files. For instance, to add a Spanish translation to an English website, you first would download the translations file. Select the landing page and click on the three dots menu to the right. You will see the option "export translation". On clicking, a zip will be downloaded to your computer. When you unzip it, you will have the json files.

The English JSON file will look something like this:

{ "CGe1P6i8hb6-name": "Landing Page Test 1", "CGe1P6i8hb6-title": "Landing Page Test 1", "CGe1P6i8hb6-content": "Hello World!\n\nThis is my first website!\n\n![](https://media3.giphy.com/media/v1.Y2lkPTc5MGI3NjExeDMzcnBvN3ZqOW8yemV2bTZmZ2w4azZsc2RiY3prbTVqeXN0NDlmbSZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/heIX5HfWgEYlW/giphy.gif)" }

Then you have to create the translated version:

{ "CGe1P6i8hb6-name": "Página Test 1", "CGe1P6i8hb6-title": "Página Test 1", "CGe1P6i8hb6-content": "Hola mundo!\n\nThis is my first website!\n\n![](https://media3.giphy.com/media/v1.Y2lkPTc5MGI3NjExeDMzcnBvN3ZqOW8yemV2bTZmZ2w4azZsc2RiY3prbTVqeXN0NDlmbSZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw/heIX5HfWgEYlW/giphy.gif)" }

Then, select the landing page and click on the three dots menu to the right. You will see the option "import translation". On clicking, upload the file you just created and then select from the menu the associated language.

spanish

General Aspects

Developed by

EyeSeeTea (EST) is a Spanish technological consulting company. EST's main mission is to make technology useful for human development through science and non-profit organizations. The EST staff is composed of engineers and computer scientists with a wide array of experience in biological science, telecommunications and cooperation for development.

Supported by

Homepage App is sustainable thanks to the partners for which we build customized DHIS2 solutions. It has been funded by Samaritan's Purse and WHO to support countries in strengthening the collection and use of health data through DHIS2. Also, the WHO Integrated Data Platform (WIDP), where several WHO departments and units share a dedicated hosting and maintenance provided by EyeSeeTea, back some specific new features. The Long Term Agreement EyeSeeTea holds with WHO for this maintenance includes maintenance of this application, ensuring that it will always work at least with the last version of WIDP. We are passionate about both DHIS2 and open source, so giving back to the community through dedicated open-source development is and will always be part of EyeSeeTea’s commitment.

You can also support our work through a one-time contribution or becoming a regular github sponsor.

DHIS2 Versions

This application has been specifically developed for DHIS2 versions 2.35-2.40.