FAQs

Troubleshooting

I do not see "Configure resource pages" under the site's Theme

Omeka only shows that button for themes that declare resource_page_blocks in their theme.ini. Switch to the default theme or a theme built for Omeka S 4, or add resource_page_regions and resource_page_blocks entries to your theme's theme.ini. Value Splitter cannot add the button on its own.

The Value Splitter layouts are not listed in the block sidebar

Check that the module is installed and active at Admin > Modules. The four layouts are offered on the Item page, Media page and Item set page tabs; make sure you have selected a region in Select a region first.

A block does not appear on the public page

Work through these in order:

  1. The block must be added to the resource page and saved in Configure resource pages for that site. See Adding Blocks to Resource Pages.
  2. The block must have properties assigned on the Value Splitter page for the same site, and the item must have values for at least one of them. With When empty set to Hidden (the default) a block with nothing to show outputs nothing.
  3. For the Media block, Show media must be checked and the item must have media.
  4. The configuration is per site. Check that the Site drop-down on the Value Splitter page was set to the site you are viewing when you saved.

Values appear twice

Omeka's built-in Values block is still on the page alongside the Value Splitter blocks. Remove it in Configure resource pages. The same applies to Media embeds if you use the Value Splitter Media block.

A media or item set page shows an error after adding the Media block

The Media block reads the media attached to an item and only works on the Item page. Media and item set representations have no attached media list, so the block fails on those pages. Remove Value Splitter: Media from the Media page and Item set page tabs. On media pages use Omeka's Media render block instead.

Saving fails with "A property can only be assigned to one block."

The same property term is in the property list of more than one of blocks A, B and D. The drop-down hides properties that are already assigned, but a stale form or an edited import file can still contain duplicates. Remove the duplicate tag and save again. Note that block D's list is checked even when catch-all is on.

I reordered the tags but the values still print in the old order

The order of tags within a block is saved but not used for display. Values are printed in Omeka's normal order, which follows the resource template assigned to the item and then the property order. Change the resource template to change the order.

Reset to Defaults did not undo anything

Reset to Defaults only clears the form in the browser. Nothing is stored until you click Save. If you reset by mistake, reload the page without saving.

Import says "Invalid configuration file."

The file must be JSON with a top-level blocks object, as produced by Export. Check the file is not empty and was exported from Value Splitter rather than another module. The file must also be under your PHP upload_max_filesize limit; a partially uploaded file is reported as No file uploaded.

The Value Splitter link is missing from the admin sidebar

The page requires the editor, site_admin or global_admin role. Researchers, authors and reviewers cannot see or open it. See Configuration.

Linked items are missing from a block

If the site setting Exclude resources not in site is on, linked items and item sets that are not assigned to the current site are dropped from the display, and a property whose only values are such links is treated as empty. Add the linked resources to the site or turn the setting off under Sites > [site] > Settings.

Log in for Support