Getting Started

Installation

Requirements

  • Omeka S 4.x (the module declares omeka_version_constraint = "^4.0")
  • PHP 8.1 or later, as required by Omeka S 4
  • A theme that supports configurable resource page blocks. Omeka's Configure resource pages button only appears for themes that declare resource_page_blocks in their theme.ini. The default theme does; most themes written for Omeka S 4 do too.

The module has no external dependencies and creates no database tables.

Installing

  1. Copy the ValueSplitter folder into your Omeka S modules/ directory.
  2. Log in to the admin panel as a Global Administrator.
  3. Go to Admin > Modules and click Install next to ValueSplitter.

After installation a Value Splitter link appears in the admin sidebar under the modules section, and four new block layouts (Value Splitter: Primary, Secondary, Media and Overflow) become available in each site's Configure resource pages screen.

Installation changes nothing on the public site until you add the blocks to a resource page. See Adding Blocks to Resource Pages.

Upgrading

Copy the new version over the existing modules/ValueSplitter folder, then visit Admin > Modules. If the module shows Upgrade available, click Upgrade.

Uninstalling

Go to Admin > Modules and click Uninstall next to ValueSplitter. The module has no uninstall routine, so nothing is deleted:

  • The per-site configuration stays in the site_setting table under the key value_splitter_config. Reinstalling the module picks it up again.
  • Any Value Splitter blocks you placed on resource pages remain in the theme's resource page configuration. Omeka renders them as empty Unknown blocks, so public pages keep working but the values those blocks displayed disappear. Remove the blocks in Configure resource pages before uninstalling, and put Omeka's own Values block back if you removed it.

To remove the stored configuration by hand:

DELETE FROM site_setting WHERE id = 'value_splitter_config';
Log in for Support