Logo of museum-digital

museum-digital

Software Frontend/Portal
BannerImage from page 280 of "The practical aspect of the slope deflection method and its application to the design of the Roosevelt Road Viaduct" (1920); Grodsky, Morris; Contributing Library: Paul V. Galvin Library, Illinois Institute of Technology; Digitizing Sponsor: CARLI: Consortium of Academic and Research Libraries in Illinois

The Main Frontend of museum-digital

museum-digital was founded to publish museum object information online. That's not possible without the right software.

The "frontend" is thus the first application, that was developed at museum-digital. With it, museums can join together to present themselves and their objects online.

To offer a comprehensive glimpse at the museums and their objects, a variety of additional information has been made presentable since. On the one hand, museums can now add information on their collections, object groups, exhibitions, and events. On the other, a number of options for linking and visualizing information have been added.


Screenshots

Start page of the German national portal of museum-digital.
Extended search page in the museum-digital frontend.
Using the extended search settings, users can define exact searches.
Enriched search results in the museum-digital frontend
Search result pages are enriched based on data from our controlled vocabularies.
A timeline page in museum-digital.
The museum-digital frontend offers a timeline, for viewing search results sorted by their relations to time.
Objects on map pages in museum-digital.
Using the "objects on map" pages, users can find interesting objects based on their geographical background.
An object page.
An object page in the frontend of museum-digital.
Multilinguality in the museum-digital frontend.
museum-digital is multilingual, and so, too, can be the displayed entries. The navigation language and the record language can be switched independent of each other.
Exhibition overview page in the museum-digital frontend
The exhibition overview page in tiles mode.
Calendars are available for exhibitions and events.
Calendars are available for exhibitions and events.
Graph view
The "graph view" offers users an alternative option for navigating the portal.
Keyboard control of the museum-digital frontend.
Power users can navigate the portal using their keyboard through an emacs-inspired interface.
Comparing obects
Two objects can be compared with each other.

Technical Information

Focus - Design Principles

"The "frontend" of museum-digital is primarily designed to always offer a clear focus on whichever information is central to a given page or section. This allows for easy understanding. A lot of additional options exist for power users - from visualizations to a command line menu embedded into the website. These are however "hidden" in sidebars or only accessible through keyboard shortcuts, so that they don't irritate first-time users.

API(s)

Publishing and making things accessible doesn't only mean making it possible to view something. It also means enabling people to use data to realize their own ideas. Accordingly, all information that is published using the "frontend" of museum-digital is also accessible in a machine-readable way via our JSON API.

As much as possible, the "frontend" provides information in open standards as well: object information can be accessed in LIDO, information about museums can be downloaded as electronic business cards (vCard), and calendar information such as exhibitions can be integrated with calendar tools using the iCalendar standard.

Open Standards

LIDOfor object metadata

Based on CIDOC-CRM, LIDO offers a standardized XML format for exchanging object metadata for museums. Many of the central concepts museum-digital is built on originate from LIDO (such as the event structure for more precisely describing location and dating).

iCalendarfor calendar entries

Calendar entries for events and exhibitions can be downloaded and subscribed to using the iCalendar format and the adjacent WebCal standard. iCalendar is a well-established format that can - among others - be used for importing events to one's mobile calendar.

vCardfor institutions' contact information

What iCalendar is for calendar entries, vCard is for contact information: A very simple and widely adopted standard that can be used for exchanging contact information between practically all of the popular address book managers. museum-digital's frontend implements the interoperable sharing of museums and collections' contact information using vCard.

oEmbedfor referencing object, series, and institution pages

oEmbed is a standard for describing the preferred way to embed a page in another. Using oEmbed, object, institution and series pages can be referenced in - e.g. - WordPress blog posts in a breeze.

TEIfor transcriptions

TEI (Text Encoding Initiative) is a standard for encoding text in a maschine-readable way. At museum-digital, it is natively supported for transcriptions and can be used as an alternative output format for object information focusing on transcriptions and the sending / receiving of letters and similar objects.

IIIFfor images

IIIF offers a standardized API for referencing images or sections of these. In the standard setup, images are gathered to represent a thing (e.g. a museum object), but these collections can in turn be compiled into superordinate collections. As IIIF requires server-side editing of the images before they are sent to the user, it is only available for locally hosted images. For these however, IIIF version 2.1 is fully implemented.

RSSfor staying up-to-date

Where objects, events, or exhibitions are listed, museum-digital's frontend generates an RSS feed. These feeds can be subscribed to using a feed reader.

JSON-LDfor making information legible to Search Engines

Google and other search engines can use more detailed structured data for generating previews about some commonly appearing types of data - such as events or FAQs. Whereever suitable, the required structured data is provided by the frontend.

Development

The "frontend" of museum-digital is built using PHP8 and MySQL. JavaScript is used for interactive features and visualizations. A list of the used libraries can be found here. We use git for version control.


13
languages

The frontend is build for multi-lingual use and has been translated to a number of languages. Of course, we are always looking forward to help in translating the frontend (just like all other tools at museum-digital) to new languages. A description of how our dedicated translation tool can be used for doing so is available on the blog (German).


Many museums come together to use museum-digital as a publication platform - and thus come to present their objects using the frontend.

1076
institutions

FAQ

How can a museum publish its objects on museum-digital?

The museum first needs to set up in musdb by the regional administrators responsible for the respective instance of museum-digital. For this, we require a name, an address, a short description of the museum (min. 25 characters), and an image symbolizing the museum. Once the museum has been set up in musdb, objects can be entered and published one by one - or the existing collection data of an institution can be imported in bulk. The institution is only publicly listed once one of its objects has been published.

Are past versions of object pages archived for enabling scientific references?

Yes. Once a public object page has been updated, a snapshot of its contents are taken and made available using the page archive.

Does the frontend of museum-digital offer persistent URLs?

We do not automatically assign DOIs, handles, or anything alike to published pages. We however take utmost care, that any URL of a primary page (e.g. an object or museum page) is kept stable and that there are sufficient referals from old URL structures to have no links be lost. For our approach to this topic, see Tim Berners-Lee's's Cool URIs don't change.

Is the layout of the frontend of museum-digital responsive?

Yes.

I have a great idea for a new visualization method? Can you implement it?

If it is really a good and suitable idea, sure. Just send us a mail.


Resources

Handbook pages (German) API documentation

News About the Frontend in the Blog
API documentation for frontend and md:term Summary of the monthly user meetup (April 2023) / New features and improvements Summary of the monthly user meetup (March 2023) New Features at museum-digital (November 2022) musdb and frontend available in French and Russian