Value Splitter has no global settings. All configuration is per site and lives on the Value Splitter page in the admin sidebar (/admin/value-splitter). Pick the site in the Site drop-down at the top of the page; the page reloads with that site's configuration (/admin/value-splitter?site_id=ID).
Until you save a configuration for a site, the defaults below apply.
Settings common to every block
| Setting | Default | Description |
|---|---|---|
| Label | empty | Optional heading printed above the block's values as an <h4>. Leave blank for no heading. |
| When empty | Hidden | What the block does when it has nothing to show. Hidden: outputs nothing at all. Placeholder: prints the label and the text No values available. (No media available. for the Media block). Visible (empty): prints the label inside an empty container so the layout keeps its shape. |
Block-specific settings
| Block | Setting | Default | Description |
|---|---|---|---|
| A: Primary Values | Properties | none | The properties this block displays. With no properties assigned the block is empty. |
| B: Secondary Values | Properties | none | Same as block A. |
| C: Media | Show media | checked | Renders every media attached to the item. When unchecked the block outputs nothing, whatever the When empty setting says. |
| D: Overflow | Catch-all: show all unassigned properties | checked | When checked the block shows every property that is not assigned to block A or block B. Its own Properties list is ignored. |
| D: Overflow | Properties | none | Used only when catch-all is unchecked. The block then behaves like blocks A and B. |
A property can be assigned to only one of blocks A, B and D. The form rejects a save that assigns the same property twice with the message A property can only be assigned to one block.
With the defaults (nothing assigned, catch-all on, media on) the Overflow block shows exactly what Omeka's built-in Values block shows, and the Media block shows what Media embeds shows.
How the configuration is stored
The settings are saved as one site setting per site, value_splitter_config, in Omeka's site_setting table. The value is the same JSON structure the Export button downloads. See Block Reference for the format.
Related site settings
Blocks A, B and D honour the Omeka site setting Exclude resources not in site (Sites > [site] > Settings, under Show). When it is on, linked items and item sets that do not belong to the current site are left out of the displayed values, exactly as in the core Values block.
Permissions
The module adds one ACL rule covering the configuration page and its save, export and import actions.
| Role | Open the Value Splitter page | Save, export, import |
|---|---|---|
| researcher | no | no |
| author | no | no |
| reviewer | no | no |
| editor | yes | yes |
| site_admin | yes | yes |
| global_admin | yes | yes |
The page lists every site in the installation and does not check site-level ownership, so any user with the editor role or above can change the configuration of any site. The Value Splitter sidebar link is hidden from roles without access.
Placing the blocks on resource pages is done in Omeka's own Configure resource pages screen, which follows Omeka's site update permission.