Field types

Link

Field type link. A web address, stored as text. It is checked when displayed, not when saved. Data entry from the cataloguer’s side is described under Link .

Link field Objektadresse (object address) in Moliri with the address of the museum's object page, on the right inside the field the icon for opening it in a new window, below it the hint Valid URL

Parameters

KeyValuesIf omittedEffect
placeholderStringemptyPlaceholder in the empty field
check_syntaxtrue, falsetrueChecks the spelling and shows the status
check_reachabletrue, falsefalseTries to reach the page. From the browser this is only an indication
auto_protocoltrue, falsetruePuts https:// in front of a bare domain
allow_relativetrue, falsefalseAllows relative addresses
allowed_protocolsListhttp:, https:Permitted protocols. Anything else counts as invalid
embednone, inline, dropdown, modalnonePreview: none, in the field, expandable, in a window
preview_heightNumber320Height of the embedded preview in pixels, limited to 160 to 1200
modal_sizemedium, large, fullscreenlargeSize of the preview with embed: modal
JSON
{
  "allowed_protocols": ["https:", "mailto:"],
  "embed": "modal",
  "modal_size": "large"
}

allowed_protocols is the place for mailto:, ftp: or protocols of your own applications. Older fields carry the check switches as checkUrl with valid and reachable; that form is still read.

With embed: dropdown the preview expands below the field:

Example Result
JSON
{
  "check_syntax": true,
  "allowed_protocols": ["http:", "https:"],
  "embed": "dropdown",
  "preview_height": 420
}
Link field Weiterführende Seite (further reading) in Moliri with a Wikipedia address, below it the hint Valid URL and the expanded preview of the page on blue and white porcelain
The field “Weiterführende Seite” (further reading) with the preview of the linked Wikipedia page expanded; between address and preview the status “Valid URL” from check_syntax.

embed: inline is worthwhile when the content is needed while cataloguing. Many websites forbid embedding; the preview then stays empty. When in doubt, use none.

Formatting

The field type comes with two formattings, neither of them preselected anywhere, because a shortened link can no longer be clicked:

FormattingIdentifierResult
Without protocolstandardScheme and trailing slash are dropped
Domain onlydomainOnly the host name, without www.

See Formatting .

When another field type fits

If the address points to a file that belongs to the object: File . The file is then kept in-house, with preview, rights information and history. If the address is built from an identifier in another field: a template field or a virtual field .