Usage

Assigning Properties to Blocks

The Value Splitter page in the admin sidebar (/admin/value-splitter) decides which properties each block shows. The page edits one site at a time.

Choosing the site

  1. Click Value Splitter in the admin sidebar.
  2. Pick the site in the Site drop-down. The page reloads with that site's saved configuration, or with the defaults if the site has never been configured.

Assigning properties

Blocks A, B and D each have a Properties field.

  1. Click into the Search properties... box under the block. A drop-down lists every property from every vocabulary on the site, showing the label and the term (for example Title and dcterms:title).
  2. Type to narrow the list. The search matches the property label, the term and the vocabulary name.
  3. Click a property, or move to it with the arrow keys and press Enter. It is added as a tag.
  4. Remove a tag with its x button, or press Backspace in the empty search box to remove the last tag.

Properties already assigned to any block are left out of the drop-down, so the same property cannot be picked twice. If a duplicate slips through, saving fails with A property can only be assigned to one block.

Tags can be dragged into a different order within a block. This ordering is stored but does not change the order on the public page; values are printed in Omeka's usual order (the resource template order, then property order).

Setting a label and empty behaviour

Each block has two fields in its header:

  • Label: an optional heading printed above the values.
  • When empty: Hidden, Placeholder or Visible (empty). See Configuration for what each does.

The Media block

Block C has no property list. Leave Show media checked to render every media attached to the item with Omeka's media renderers (images, PDFs, embedded video and so on). Uncheck it to switch the block off without removing it from the page.

The Overflow block

Block D has a Catch-all: show all unassigned properties checkbox.

  • Checked (the default): the block shows every property that is not assigned to block A or block B. Its own Properties list is ignored.
  • Unchecked: the block shows only the properties in its own list, like blocks A and B.

Catch-all is the usual choice: assign the properties you want to position explicitly to A and B, and let D pick up whatever is left so no metadata is lost.

Saving

Click Save at the top right. The message Value Splitter configuration saved. confirms the change, and the public site reflects it immediately.

Resetting

Reset to Defaults clears every tag, label and setting in the form for the current site after a confirmation dialog. It changes the form only; click Save to store the reset, or reload the page to keep the previous configuration.

Exporting and importing

The Export button downloads the current site's configuration as value-splitter-config.json. The Import button asks for a JSON file and, as soon as one is chosen, uploads it and replaces the current site's configuration with the file's contents.

Use export and import to copy a layout between sites or between installations. The file must contain a top-level blocks key; anything else is rejected with Invalid configuration file. The file is not otherwise validated, so edit exported files rather than writing them by hand. The format is described in Block Reference.

Log in for Support