Knowledge Base

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== Search Results Page =====

==== General description ====

The Search Results page displays the data returned by the SANCTUARIA search engine using two alternative visualization modes:

  * **List View** – tabular and textual representation
  * **Map View** – geographic visualization on an interactive map

Both views rely on the same dataset and are dynamically updated according to the filters configured on the homepage.

Search results are grouped by resource type:

  * **Ex-Voto**
  * **Foundation Legends**

Users can easily switch between the two visualization modes using the icons located in the upper control bar.

----
==== “Legend” page ====

**Access**

From the List View, clicking on a result with *Type = LEGEND* opens the corresponding **Legend detail page**.  
Navigation is performed via the dynamic link available on the *Type* label or on the result title. 

**Page structure**

The Legend detail page includes the following elements:

  * **Title** – full name of the legend (e.g. *Foundation Legend of Santa Maria delle Grazie*)
  * **Source Date** – date of the original source
  * **Description** – full or partial legend text, scrollable vertically
  * **Metadata section** – structured fields (place, language, document type, miracle date, etc.)
  * **Digital Version of the Book** – direct link to the digital source, when available
  * **Related Resources** – list of Ex-Voto related to the same legend or sanctuary, including metadata (type, date, location)

**Functional features**

  * Vertical scrolling of the main text in a full-width layout
  * Dynamic links to related items
  * Uniform visualization of structured metadata in tabular format
  * External links (e.g. DOI, digital URLs) opened in a new browser tab


{{sanctuaria:sanctuaria_foundation_legend.png?650|Foundation Legend }}
{{sanctuaria:sanctuaria_foundation_legend_2.png?650|Foundation Legend 2}}
----
==== “Ex-Voto” page ====

**Access**

From the List View, clicking on a result with *Type = EX-VOTO* redirects the user to the corresponding **Ex-Voto detail page**.  
As for legends, the link is active on the title or on the type label. 

**Page structure**

The Ex-Voto detail page includes:

  * **Title** – e.g. *Ex-Voto of Santa Maria di Vulgo Scapenzo*
  * **Source Date** – reference year (e.g. *1961*)
  * **Description** – interpretative or automatically generated text (e.g. *“A religious scene shows a person lying in bed…”*)
  * **Keywords** – list of extracted thematic terms (e.g. *bed, prayer, illness*)
  * **Metadata table** – structured information including:
    * Place (sanctuary)
    * Date
    * Subject
    * Inscription
    * Signature
    * Photographer

**Functional features**

  * Compact layout with separate blocks for description and metadata
  * Clickable keywords to trigger a new thematic search
  * Layout consistent with the rest of the platform (header, footer, central structure)


{{sanctuaria:sanctuaria_ex_voto.png?650|Ex Voto}}
----
==== Navigation ====

Clicking on *Home* or on the ITSERR logo returns the user to the homepage of the search engine.

Users can return to the previous search context using the breadcrumb (e.g. *Home / Search results / Legend detail*).

----
==== Functional objectives ====

The Search Results page is designed to:

  * provide clear and readable access to textual contents,
  * integrate legends and ex-voto within a coherent relational system,
  * facilitate navigation among connected elements through the *Related Resources* section.

----
==== Technical notes ====

  * Metadata are dynamically generated via API based on the selected record ID.
  * The relationship between Legends and Ex-Voto is established through a shared reference field (*Sanctuary ID*).

----
==== Upper control bar ====

The upper control bar includes the following elements:

  * **List View icon**
  * **Map View icon**
  * **Results counter** (e.g. *67 Ex-Voto & 33 Legends*)
  * **Sort by** menu with criteria such as *Score*, *Date*, and *Sanctuary*
  * For authenticated users: **Export** and **+ Add resource** buttons


{{sanctuaria:sanctuaria_control_bar.png?650|Control Bar}}
----
==== List View ====

Each result item displayed in List View includes:

  * image (when available),
  * title and description with highlighted keywords,
  * metadata: *Type*, *Source Date*, *Sanctuary*, *Region*, *City*.

Pagination controls are displayed at the bottom of the list.

----
==== Map View ====

The Map View displays an interactive map of Italy featuring:

  * regional boundaries and green markers indicating result areas,
  * tooltips showing the region name and number of items (e.g. *Abruzzo (8)*),
  * a side list divided by category (*Ex-Voto*, *Foundation Legends*).

Each region can be zoomed in to visualize the distribution of sanctuaries within the selected area.

----
==== Filters and geographic selection ====

The *Region* field opens a *Select place* modal window that includes:

  * integrated text search,
  * multiple selection via checkboxes,
  * partial automatic update of list and map views.

A new search execution is required to fully apply geographic changes to the map. 

{{sanctuaria:sanctuaria_region_filter.png?650|Region Filter}}
----
==== Interaction and updates ====

Any change applied to filters updates the results and the overall counter in real time.

The two visualization modes (list and map) remain synchronized throughout user interaction.

----
==== Technical notes ====

  * Automatic highlighting of keywords within descriptions.
  * Responsive and bilingual layout.
  * Data management through dynamic pagination.