v4.1.0

System Requirements

• Minimum required database versions increased to MySQL 5.7.9 and MariaDB 10.2.6

Features

• Page authoring improvements
  • Grid layout
    • Omeka S 4.1.0 adds a new selection when authoring site pages, between the original, older page layout ("Normal flow") and the new Grid layout. Grid uses the native CSS grid feature to provide users with more tools for positioning their content the way they want without needing custom theming or CSS skills.
    • Block groups
      - Blocks can be grouped together by site authors for styling and administrative purposes
  • Shared block layout settings
    • This version also adds a new page editing concept of configuration options that are common to all blocks. Things like alignment and choosing a class attribute that were previously implemented piecemeal are available for all blocks, including any added by modules, and modules can also now more easily add their own additional settings to all blocks
    • Among these shared settings is a new background image feature for using assets as backgrounds for any block
  • Block templates
    • Using the shared layout setting feature (see above), all blocks now provide an option for the author to select from among different templates specific to that block which are provided by the site's chosen theme. This allows themes to provide complex behaviors, styles and customizations that users can choose from with a simple UI.
  • Page templates
    • Similar to block templates, the entire page can have a template selected by the author, with the choices also coming from the current theme. Small differences in overall layout or completely custom pages can be created as page templates and exposed for site authors to use.
  • New OEmbed page block
  • Merged item showcase block into media embed block
    - The media embed block now has additional options for display that match what the previous item showcase block did. Item showcase blocks that exist in sites upgraded to 4.1.0 will be migrated to media embed blocks with those settings preselected.
• Performance improvement for performing many "OR"-joined property/value searches at once
• Site navigation allows user to configure a custom link to open in a new tab/window
• New settings for controlling appearance of subnavigation on public site pages
• New batch edit option for setting resource ownership
• OEmbed media can now be updated
• Site setting for pre-expanding value annotations
• Favicon can be selected from assets both globally and per-site
• Global setting for disabling @reverse reverse property listing in API responses
• Improved mail sending error reporting
• Improvements to linked resource display
• The "fallback" file renderer now respects the same linking settings as the thumbnail renderer
• Added WebP to the default allowed types for file and asset uploads
• Database settings can now be provided via an environment variable OMEKA_DB_CONNECTION_URL rather than database.ini (#1789, contributed by @raboof)

Admin UI

• Media upload inputs on item form now accept multiple files selected at once
• Media upload inputs on item form now show a preview of selected images if the browser can natively display them
• New direct link to the current user's settings page in left nav
• Global settings page now divides into more logical groups
• List of sites for an item now includes a link to go directly to the item's page in each site
• Asset upload sidebar now indicates the upload size limit
• Info on free disk space added to system information (#2001, contributed by @Daniel-KM)

Bugs Fixed

• Fulltext searches now allow other sorting despite the default relevance-based sort to be chosen; previously doing a fulltext search would override any other sorting selected
• Fixed TypeError when loading user batch edit (#2100, contributed by @jajm)
• Fixed some incorrect ARIA accessibility attributes (#2111)
• Fixed possible deprecation warning when passing null to API id search (#2118, contributed by @Daniel-KM)
• Forms using element groups did not properly handle fieldsets (#2159, contributed by @Daniel-KM)

Changes

• HTML media now include their text content in the fulltext index
• Sorting options now appear first on advanced search
• Added database index for is_public column for several key tables (#2105, contributed by @Daniel-KM)
• Admin CSRF tokens now expire after 12 hours instead of 1

For Developers

API

• New "api-local" read-only REST endpoint. api-local uses the user's login cookie for auth rather than requiring an API key.
• REST API now allows selecting from different serialization formats (RDF/XML, N3, Turtle, NTriples) and extension of the allowed choices (see Server-Side Events)
• Expanded options for reading scalars from more types of resources (#2023, contributed by @Daniel-KM)
• Search operation now allowed for the generic "resources" endpoint

Server-Side Events

• New filters api.subject_values.query and api.subject_values_simple.query (#2054, contributed by @Daniel-KM)
• New filters api.get_fulltext_text.value_criteria and api.get_fulltext_text.value_annotation_criteria for modifying values to be included in fulltext index (#2069, contributed by @jajm)
• New filters api.output.serialize and api.output.formats
• New view.browse.actions events for adding to action icons on browse pages

Config

• New ['entity_manager']['data_types'] config array for registering new Doctrine datatypes

Classes/Interfaces

• Omeka\Media\Renderer\FulltextSearchableInterface for providing fulltext index content from media

Changes

• New "fallback setting" service and helpers for looking for same-named options in multiple contexts (global, site, user settings)
• Element groups feature is now enabled and used on batch edit forms
• Automated tests now run against PHP 8.3 additionally (#2125, contributed by @Daniel-KM)
• aria-label property now automatically set for translation for Laminas form selects (#2120, contributed by @Daniel-KM)
• Login will not redirect to dashboard if user does not have permission to view dashboard (#1961, contributed @jajm)