Portal

This page explains what can be configured in the Farinha Portal (home page) through the internal administration panel (Django Admin).

What can be configured in the Portal through Django Admin

• Highlights: cards displayed in the “Highlights” section of the home page.
• Map: display of the map on the home page and the source of the pins (Institutions or Sectors).

Who can do it

• SuperAdmin: accesses Django Admin and configures Highlights and the Map.

Configure Highlights (cards on the Home page)

“Highlights” are managed in two layers:

1. Highlighted description (card content)
2. Selected highlight (selection for the Home page and position)

Where it is in Django Admin:

• Webapp -> Highlighted descriptions

How to configure:

1. Create/edit a “Highlighted description”.
2. Select the “Description” (the holdings item that will be linked from the card).
3. Fill in the card fields (for example: “Title” and “Descriptive text”).
4. Add an “Image” (recommended).
5. In the “Selected highlight” inline, add an item and define its “Position”.

Important rules:

• The Home page accepts at most 5 highlights.
• The “Position” is unique (it cannot be repeated) and defines the display order.

Portal highlights are configured in Django Admin and can be selected to appear on the Home page.

Configure the Portal Map

The map is controlled by application settings.

Where it is in Django Admin:

• Webapp -> Application Settings

Relevant settings:

• “Map Enabled?”: turns the map section on or off on the Home page.
• “Map pin source?”: defines whether the pins come from “Institutions” or “Sectors”.

Application settings control whether the map appears and which source provides the pins.

Fill in latitude/longitude for the pins

For an item to appear as a pin on the map, it must have latitude and longitude filled in.

When the source is “Institutions”:

• Webapp -> Institutions -> open the Institution
• Under “Contact Area” -> “Location” section: fill in “Latitude” and “Longitude”

When the source is “Sectors”:

• Webapp -> Sectors / Subsectors / Sub-subsectors -> open the record
• Fill in the latitude/longitude fields of that record (when empty, the value may be reused from the level above)

Common problems

• The map does not appear: check whether “Map Enabled?” is enabled.
• No pin appears: latitude/longitude is missing (or only one of the two fields is filled in).
• A highlight does not appear: check whether there is a “Selected highlight” with a defined “Position” (and whether the limit of 5 has not been reached).