Module Settings

Overview

Every module in eMuseum (e.g., Objects, Exhibitions, People) includes a set of shared configuration settings that control core functionality and user interaction. These options define how users search, filter, and view module content. Understanding and configuring these settings consistently across modules ensures a uniform user experience and tailored discoverability for records.

How to Use

1. Navigate to Modules and Pages, and click Edit next to any module.

2. In the Basic Settings tab, configure the module’s shared behaviors using the available checkboxes, dropdowns, and toggles.

3. Optionally restrict module visibility to specific roles or add multilingual intro text via the Permissions and Intro Text tabs.

4. Click Save to apply your changes.

Details and Options

Basic Settings

• Enable Module Activates or deactivates the module entirely.

• Default View Defines the initial layout used for module results:

  • Images, List, Table, etc. Controls how users will see search results on first load.

• Enable Quick Search Enables a simple search bar for fast keyword-based lookup.

• Enable Advanced Search Allows access to a configurable multi-field search interface.

• Enable Filter Panel Adds a sidebar or inline filters to narrow search results by facets like type, date, or classification.

• Enable Discover More Enables the related content feature at the bottom of detail pages.

• Enable Search Suggestions Offers autocomplete or suggested search terms based on available content.

• Sort Field / Order / Relevance Toggle

  • Set the default sorting field (e.g., Title, Date, Object Number).

  • Choose sort order (Ascending or Descending).

  • Toggle relevance ranking (Disable Relevance) if not preferred.

• Enable Multi-lingual Content Allows module content to be configured and displayed in multiple languages.

---

Permissions

• Restrict Module Limits access to the module to specific user roles. If checked, at least one role (e.g., Superuser, User, Staff, Educator, etc.) must be selected. If left unchecked, the module is publicly accessible.

---

Intro Text

• Show Intro Text Displays a customizable text block at the top of the module’s main page.

• Language Tabs Add translations for English, German, French, Spanish, Chinese, and Italian. Includes a full WYSIWYG editor to format content (e.g., bold, links, images, code view).

---

Tips or Notes

• Best Practice: Keep settings consistent across modules for better usability, but tailor filters, search depth, and sort preferences based on content type.

• Discover More Dependency: This setting only surfaces if the module has rich metadata and is enabled globally.

---

Related Features

• Modules and Pages Configuration: Controls visibility and menu inclusion for each module.

• Display and Appearance > Result Pages: Impacts how grid, list, and table views behave across modules.

• Field Configuration: Defines which metadata fields are used in searches, filters, and sort dropdowns.

People Module-Specific Settings

The People module in eMuseum includes two unique configuration options that govern how names are linked across the site and how alphabetical navigation (via a Letters Index) is handled on the module’s index page. These options support more intuitive browsing and contextual linking of people records, enhancing accessibility and content relationships.

How to Use

1. Navigate to Modules and Pages > People > Edit.

2. In the module settings, locate the sections for Person Link Target and Letters Index.

3. Adjust options as needed:

   • Choose how person names link (detail page or associated objects).

   • Enable and configure the letter-based index for browsing.

4. Click Save to apply changes.

Details and Options

Person Link Target

Specifies the destination page when a user's click targets a person name.

• Details Page (default) Links person names to their People detail page, displaying biographical and related metadata.

• Objects Page Links person names to a filtered Objects page, automatically displaying all records associated with that person.

🔍 Use Case: Selecting “Objects Page” is helpful when a person’s primary relevance lies in their relationship to objects (e.g., artists, creators).

---

Letters Index

Controls the presence and behavior of an alphabetical navigation strip on the People index page.

• Enable Toggles visibility of the letters index.

• Field Specifies the metadata field from which to extract the first letter (typically Name).

• Language Determines the language-specific rules for sorting and indexing letters (e.g., English, German, French).

• Order

  • Natural: Sort letters based on native character order (may include diacritics).

  • Normalized: Uses Unicode NFD (Normalization Form Decomposed) for consistent alphabetical behavior regardless of accents or diacritical marks.

---

Tips or Notes

• Letters Index UX: Ideal for modules with large numbers of people. Ensure chosen field is consistently populated and formatted.

• Normalized Order is recommended for international collections to reduce confusion around accented characters.