Changelog History
-
v2.7.1 Changes
January 28, 2020The minimum required version of PHP is now 5.4.
π Features
- π PHP 7.4 support
π Bugs Fixed
- β¬οΈ Direct upgrades from significantly old versions could fail on the "unEntityTags" migration
- π· Tags could not be deleted through the API
- π The link to the Omeka documentation on error pages referred to the older Omeka site structure
- Mismatched closing tag on login pages
- π Files with large amounts of embedded metadata could fail when uploading
Internationalization
- β‘οΈ Updates to Catalan, Esperanto, Spanish, French, Italian, Japanese, Brazilian Portuguese, Albanian, Ukrainian
External Libraries
- β‘οΈ getID3 updated to 1.9.18
- β‘οΈ HTML Purifier updated to 4.12.0
- β Removed Zend_Test_PHPUnit and Zend_Tool components
-
v2.7 Changes
May 21, 2019π Features
- PHP 7.3 compatibility
- π Version notifications for new releases of plugins and themes
- Omeka now respects the
X-Forwarded-Proto
header for determining if it should generatehttp:
orhttps:
absolute URLs. This is primarily useful for users hosting Omeka behind a reverse proxy that's handling the HTTPS connections.- A new
sslTrustProxy
configuration key is available for users using thessl
force-redirect configuration to trust the X-Forwarded-Proto header and not issue unnecessary, looping redirects
- A new
- π New
forceSSL
option for ZendS3 storage adapter to force use ofhttps:
addresses for file URLs (#877, contributed by @ebellempire) mail.force_from
andmail.force_from_name
options for forcing From: address for all outgoing email
π Bugs Fixed
- π· Tag UI javascript error when editing items (#853, contributed by @luku)
- Inconsistent tag markup for new and existing tags when editing items (#854, contributed by @luku)
- π Deprecation notice when running on PHP 7.2+ (#860, contributed by @Daniel-KM)
- "Remember me" checkbox on login non-functional on PHP 7.2+ (#872)
- Invalid SQL mode error when running on MySQL 8 (#858)
- Migration error when migrating from 1.x using MySQL 5.7+ (#831)
item_next
anditem_prev
filters had no way to indicate the end of the sequence (#851)- Inconsistent form enctype between collection add and edit forms (#856)
items_output_url
page detection fails on "items" pages added by plugins, leading to incorrect feed URLs (#880)
π Improvements
- "Simple" item search converted to use subqueries, leads to a significant observed speed increase on modern MySQL versions
- Public-side file show page now includes a link back to the parent item
- 0οΈβ£ "Browse by tag" view for items now sorts tags alphabetically by default
- π New "back to top" link in admin footer
- ZendS3 storage adapter now leaves slashes unencoded in URLs
- ZendS3 storage adapter will "chunk" expiration times, allowing for some end-user caching by preventing the URL from changing on every request
- reCAPTCHA text specifies that v2 keys must be used
For Developers
- New
html_purifier_config_setup
filter (#857, contributed by @luku) - π· New
image_tag_attributes
filter (#871) - New
files_for_item
filter - New option
filesForItem
passed through tofile_markup
helper to indicate when files are being rendered as part of a call tofiles_for_item
- New
file_markup_options
filter for modifying the options passed tofile_markup
- New
file_markup_files
filter for modifying the list of files to be rendered byfile_markup
Bundled Add-ons
- π Thanks, Roy 2.5.1 (fixed visual spacing issues with featured blocks on homepage)
- β‘οΈ Exhibit Builder 3.4.2 (updated translations)
- β‘οΈ Simple Pages 3.1.2 (updated translations)
Internationalization
- β‘οΈ Updated translations for Bengali, Catalan, Czech, Danish, Esperanto, Spanish, Estonian, French, Galician, Hebrew, Hungarian, Indonesian, Italian, Japanese, Lithuanian, Portuguese (Brazil), Slovak, Serbian, Turkish, Ukrainian
-
v2.6.1 Changes
May 02, 2018π Omeka 2.6.1 is the first maintenance release in the 2.6 series. All users should update.
π Security Fixes
- β Added CSRF protection to users/api-keys (#842, reported by @JosiahPierce)
- π Fixed XSS issues with adding and editing tags (reported by Zekvan Arslan of Netsparker)
π Bug Fixes
- π Fixed bottom direct pagination input on admin items browse
- "Encountered an error" pages now correctly report an HTTP error status code
- Minor appearance fix to new TinyMCE toolbar
π Changes
- Switched Javascript used for in-place editing on tag browse, users may notice slightly different apperance/behavior
π Bundled Plugins
- π Exhibit Builder 3.4.1 (fixes a bug preventing source code editing for captions)
- π Simple Pages 3.1.1 (restores several removed HTML editing options from versions prior to 3.1)
Bundled Themes
- π Seasons 2.5.1 (fixes a bug in SASS usage, issues with margins and pagination)
-
v2.6 Changes
February 15, 2018Major Changes
- π reCAPTCHA v2 support (#814, contributed by @luku)
- Google is shutting down the original reCAPTCHA API that Omeka has used, so we're transitioning to the newer, supported "v2" API. This also transitions to the newer "I'm not a robot" checkbox interface.
- Users with old reCAPTCHA keys may need to create new ones. You can create a new key at https://www.google.com/recaptcha/admin
- TinyMCE 4
- This update brings a new, more modern interface for HTML editors in Omeka, as well as a supported codebase which should lead to improved compatibility with modern browsers now and going forward.
- Note: internal code and filenames have changed in this version of TinyMCE, so all plugins using HTML editors must be updated. Updated versions of ExhibitBuilder and SimplePages are bundled with the release, but others must be updated, including Commenting, Contribution, Posters, SimpleContactForm, and UserProfiles.
π Improvements
- Message linking to items with no item type (#760, contributed by @Daniel-KM)
- π Allow multiple item types or collections to be specified for item search (#760, contributed by @Daniel-KM)
- β‘οΈ Updated tags admin, improving search, pagination and sorting (#784, #787, contributed by @luku)
- π± Cachebusting for assets (#790, contributed by @luku)
- π UTF-8 support for snippet (depends on mbstring extension) (#806, contributed by @luku)
- π Improved messaging about data deletion when uninstalling plugins (#824)
- Admin can choose whether file thumbnails should link to the original file or the file's show page (#759)
- 0οΈβ£ Clarified default collection show markup and text for listing and linking to items in the collection (#827)
π Bugs Fixed
- π Fixed bad docblock on random_featured_items (#828, contributed by @apjmason)
- β Removed some outdated and broken "related" properties from Item and Collection records (#809, contributed by @luku)
- β Added pagination when necessary to item types page (#823, contributed by @luku)
- 0οΈβ£ Fixed browse_default_sort filter for collections/browse
- π Fixed style/clearing issue in Firefox on link from forgot password page (#829)
- API now correctly retrieves site version from in-code constant, not database
π Changes
- π PHP 7.2 support
- π± Omeka now uses relative URLs for local assets.
- 0οΈβ£ Auto-orientation now enabled by default for thumbnail creation (#777)
- π
omeka-json
output format removed- The same content is available as the
omeka-xml
output format, and the API provides a more useful and less verbose JSON format
- The same content is available as the
- β‘οΈ Updated links to point to new omeka.org structure
- β‘οΈ Updated Font Awesome to 4.7.0 (#800, contributed by @luku)
Internationalization
- π Updated translations for Bulgarian, Catalan, Czech, Estonian, Japanese, Lithuanian, Mongolian, Occitan, Polish, Portuguese (Brazil), Romanian, Russian, Swedish, Turkish, Ukrainian
π Bundled Plugins
- π Exhibit Builder 3.4
- Simple Pages 3.1
Bundled Themes
- Thanks, Roy 2.5
- Berlin 2.6
- Seasons 2.5
- π reCAPTCHA v2 support (#814, contributed by @luku)
-
v2.5.1 Changes
July 18, 2017π Bugs Fixed
- β¬οΈ Upgrades could fail for users moving many versions at once due to zeroes in date columns
- π PHP 7.1 compatibility fixed (Storage interface type mismatch)
- "Full" delete confirmation pages (as opposed to popups) prevented the user from actually clicking the delete button (a regression in 2.5)
- Admin Appearance navigation had the wrong filter name, it is now the correct
admin_navigation_appearance
(contributed by @luku) - The value
0
(zero) was not allowed in several places as an element text (contributed by @luku) - It was impossible to navigate to the "top" link in nested navigation on a touch-enabled device. Now a single tap opens the menu (as before), and tapping again on the top link will actually navigate.
is_allowed
would cause an error if run in the background (or whenever the ACL is not loaded)- TinyMCE would not load correctly in some situations on IE (a regression in 2.5)
π Changes
- π User delete confirm from browse now uses the popup instead of the full page
- π Sample configuration file now links to new location of Zend's session documentation
- β Composer added, currently for dev/testing purposes only
- The
size
column of the files table is nowbigint
, allowing for file sizes greater than 4 GiB (contributed by @jajm) - β¬οΈ TinyMCE is downgraded to 3.5.11
-
v2.5 Changes
January 30, 2017π Bugs Fixed
- Certain sorting options failed on MySQL 5.7 (#684)
- Tabbing on the admin interface could be broken when loading a page with a fragment specified
- Unselected record types in the search settings had the wrong IDs (#698, contributed by @paxed)
- Collections show pages had the wrong title
- The tag interface showed an incorrect number of total tags (#708, contributed by @luku)
- HTML 5 video embeds could end with the wrong closing tag (#710, contributed by @luku)
- The item details toggle didn't work correctly on the first click (#715, contributed by @luku)
- The API results per page label was associated with the wrong control for accessibility purposes
- Element texts could be deleted if they were saved multiple times for the same item in a single request
- Invalid record types on sitewide search could raise a notice (#754)
- π Errors that occurred when uninstalling a plugin were incorrectly hidden from view (#740)
- π· Resources loaded in a different order in background jobs than in the web interface (#725)
- π¨ An error occurred when printing the maximum file upload size on the Item form with some locales (like es_CO) (#756)
π Improvements
- Batch Edit All : Batch editing can now edit an entire search result's worth of items, even if split across several pages (contributed by @Daniel-KM)
- π New Item Advanced Search options
- AND/OR support for combining multiple searches
- "starts with" and "ends with" search types (#688, contributed by @luku)
- "matches" regular expression search type (#695, contributed by @Daniel-KM)
- [No Collection] is now an option for finding items that don't belong to a collection (#693, contributed by @Daniel-KM) (#746)
- π Use Square Thumbnails appearance setting : Admins can now select whether themes use square or "normal" thumbnails by default without editing the theme files (#763)
- β Warnings presented to users when navigating away from pages with unsaved changes (#771, thanks also to @Daniel-KM for #722 and @luku for #753)
- β Additional wider version of admin theme added (#751, contributed by @luku)
- π New autoloader prevents many "white-screen" errors and otherwise consumed error messages from autoloaded files
- Site title on login page links to public side, not admin (#646, contributed by @miniol)
- Admin collections show pages now include the list of output formats
- π Improved ARIA labels for accessibility
- π New "display_title" property to simplify getting a title suitable for use in labels and headings
- π User zooming is now enabled for mobile devices in the admin (#718, contributed by @luku)
- The Item API now allows for simple search
- π Administrators can now allow the
id
attribute in the HTML Security Settings - An option to choose the admin theme is now shown if the user has installed or created an alternative admin theme
- π New
ignore_unknown
option formetadata()
to allow the call to fail silently if Omeka cannot find the Element Set or Element the call refers to (#712) - The delete confirmation dialog title is now translatable (#752, contributed by @luku)
- Mime type detection for "text" filetypes is improved (#757, contributed by @Daniel-KM)
- π Improved theme selection admin page display code (#734, contributed by @Daniel-KM)
- Added
item_next
anditem_previous
filters for altering Omeka's default "Next Item" and "Previous Item" links (#743)
π Changes
- π§ The theme configuration page now redirects back to itself on save, not to the Themes page (#744, contributed by @luku)
- TinyMCE's validation has been loosened (#727, contributed by @doana)
- TinyMCE's conversion of "special characters" to HTML entities is restricted to otherwise-invisible whitespace only
- π Shell command names are escaped with
escapeshellarg
, notescapeshellcmd
. In particular, this should improve treatment of paths containing spaces as is common on Windows - "Add Input" buttons on element form are now "button" type buttons instead of "submit" type, so they no longer submit the form in the case of some scripting problem
- π Collections no longer attempt to show the "Text" Item Type Metadata element when showing a preview of the items in the collection
- The red top border on admin content is now simply red instead of being made out of an image
- 0οΈβ£ The admin record views now check for the specific "delete" privilege before showing the Delete button (this affects only users who alter the default ACL) (#750, contributed by @luku)
- The installer now checks for the "dom" and "filter" extensions before allowing install (#673)
Localization
- π New translations for Bengali (Bangladesh), Basque, and Occitan
External Libraries
- Zend Framework 1.12.20
- getID3 1.9.12
- jQuery 1.12.4
- TinyMCE 3.5.12
π Bundled Plugins
- π Exhibit Builder 3.3.3
- π Simple Pages 3.0.8
Bundled Themes
- π Thanks, Roy 2.4
- π Berlin 2.4
- π Seasons 2.4
-
v2.4.1 Changes
May 25, 2016π Omeka 2.4.1 was released on May 25, 2016. It is the first maintenance release in the 2.4 series.
π Bugs Fixed
- Drag and drop sorting failed for longer lists
- 0οΈβ£ The "linkText" option was ignored for the file markup renderer's default link-only display. (#690)
- Labels weren't properly associated with sitewide search record type checkboxes when unchecked (#698)
- The show page for Collections had the title "Edit Collection"
- A Javascript error could sometimes occur when refreshing an item edit page
π Improvements
- SSL/HTTPS detection is now more reliable (#685)
- π The default extension and mimetype whitelists are expanded to cover the newly-supported filetypes from the 2.4 release (#683)
- Fewer characters will be entity-encoded in HTML values when HTMLPurifier is disabled
Localization
- π New translation for Belarusian (be_BY)
- β‘οΈ Updates to many existing translations
External Libraries
βͺ Omeka 2.4.1 reverts to the following versions of its external dependencies:
- π» jQuery UI 1.11.2
Bundled Add-ons
π Plugins
- π Exhibit Builder 3.3.1
Acknowledgements
π The following members of the Omeka community contributed code, fixes, and improvements to Omeka 2.4.1:
-
v2.4 Changes
January 21, 2016π Omeka 2.4 was released on January 21, 2016.
PHP Requirements Changes
- Omeka 2.4 requires PHP 5.3.2 or higher. Previous versions have worked with the PHP 5.2 series, so be sure to check what version you're running before you upgrade.
- π Omeka 2.4 now supports PHP 7.
π Audio and Video Support Changes
π» To keep up with the changing browser support landscape, Omeka now uses HTML 5's
audio
andvideo
tags when embedding audio and video, instead of theobject
andembed
tags used by previous versions.π This change means generally better support for newer formats on current desktop and mobile browsers (for example, fixing a bug where audio files would improperly auto-play on Chrome), but worse support for older video formats, particularly those that rely on browser plugins like Quicktime, Windows Media Player or VLC. Site visitors will still be able to download those older videos and view them locally, provided they have a video player installed that's capable of playing them.
- β Added embedded audio support for .m4a and .opus
- β Added embedded video support for .m4v and .webm
- β Removed embedded audio support for .mid, .midi, .kar, .rmi and .wma
- β Removed embedded video support for .avi, .mpeg, .mpg, .mpe, .m1v, .m2v, .qt, and .wmv
π For more information about HTML 5 media support in Omeka, see Media Files.
π Bugs Fixed
- Installation could fail on servers running newer versions of MySQL (5.7+) (#678)
- Counting tags could become extremely slow on installations with many tags and tagged records (#674)
- π New version detection could sometimes throw an uncaught exception when failing to connect
- Items would not filter correctly using an Item Type object
- Some old "cellspacing" and "cellpadding" attributes were used instead of their CSS counterparts
- π» An exception within the Navigation component was not properly thrown, leading to an error
- 0οΈβ£ The default files/show view had a mismatched closing div tag
Localization
- π Pluralized strings are now supported
- π New translation for Mongolian (mn)
- β‘οΈ Updates to many existing translations
External Libraries
β‘οΈ Omeka 2.3 updates to the following versions of its external dependencies:
- Zend Framework 1.12.17
- getID3 1.9.11
- HTML Purifier 4.7.0
- jQuery 1.12.0
- π» jQuery UI 1.11.4
Bundled Add-ons
π Plugins
- π Exhibit Builder 3.3
- Users can now manually select a "cover image" to serve as the thumbnail for an Exhibit
- Added a new File-only block layout that allows files to be centered on the page
- Fixed problems with dialog box placement
- Fixed an issue with API Import
- Improves compatibility with MySQL 5.7+
- Updated translations
- Simple Pages 3.0.7
- Improved compatibility with MySQL 5.7+
- Updated translations
Themes
- Thanks, Roy 2.3.2
- Seasons 2.3.1
- Berlin 2.3.1
For Developers
π For change information geared toward developers, see What's New in Omeka 2.4 on Omeka's Read the Docs site.
Acknowledgements
π The following members of the Omeka community contributed code, fixes, and improvements to Omeka 2.4:
- Julian Maurice (#665)
- Daniel Berthereau (#680)
- π Will Simpson and Ginger Bidwell (Exhibit Builder #80)
-
v2.3.1 Changes
August 27, 2015π Omeka 2.3.1 is the first maintenance release for version 2.3. It was released on August 27, 2015.
β¨ Enhancements
- It is now possible to view tags assigned to zero records in the admin interface for tags
- The item shortcodes now allow filtering by item type (#668).
- Invalid strings are now handled more gracefully when using PHP 5.4 or newer
- The full set of available filters for Items are now available for use in the API
- The ExternalImageMagick and Imagick file derivative strategies now have a autoOrient option to automatically fix the orientation of images that have an embedded orientation flag.
π Bugs Fixed
- An error occurred when adding tags differing only in trailing spaces
- Sessions containing invalid UTF-8 text data could be dropped or truncated
- Invalid element text records could cause nonsensical API output
- Element texts could be duplicated if a record was saved more than once in a single request
- π The linkToMetadata option for file_markup could cause a PHP notice
- The Imagick derivative strategy handled images with layers and transparency improperly
- The Mixin_ElementText::getAllElementTextsByElement function introduced in 2.3 did not work correctly ([#662, #662], fix contributed by Daniel Berthereau)
- There was a typo in the admin interface (#664, fix contributed by Zach Ploskey)
π Changes
- PHP's error reporting level is now set the same regardless of the "environment" setting
Localization
- π New translation for Latvian (lv_LV)
- π Updates for Czech (cs), Estonian (et), Italian (it), Dutch (nl_NL), Polish (pl), Swedish (sv_SE), and Turkish (tr_TR).
Bundled Add-ons
Themes
- π Thanks, Roy 2.3.1 (fixed a problem with site logos not showing correctly on item pages)
π Plugins
- β‘οΈ Exhibit Builder 3.2.1 (fixed a problem that sometimes prevented exhibits from being deleted, updated translations)
- β‘οΈ Simple Pages 3.0.6 (updated translations)
-
v2.3 Changes
January 31, 2017π Omeka 2.3 was released on March 19, 2015.
β¨ Enhancements
- Accessibility improvements (added ARIA roles and landmarks, improved labels, navigation skip links)
- π New file derivative strategy using PHP's GD extension
- 0οΈβ£ Built-in support for setting default sort orders for browse pages
- π§ Element dropdowns on item advanced search respect the admin-configured element sorting order (#643)
- π§ The admin-configured page limits for browse pages are used for more controllers, including plugins
- The listing of items on collection pages now follows the admin page limits (#601)
- π Support for the new access control directives used by Apache 2.4 (#631)
- 0οΈβ£ URLs within the default citation output now include a span wrapper to allow specific styling
- π New interface for resetting customized navigation to default settings
- π Improved error output for exceptions
- β¬οΈ Detailed error messages are now always shown for exceptions during upgrade
- π Support for newer versions (4.2+) of PHPUnit
- The API now accepts
sort_field
andsort_dir
GET parameters for sorting results - Omeka will hide the "Path to ImageMagick" setting when an alternative derivative strategy is in use
- π The System Information panel now uses internal "folder" names for both themes and plugins
- π Improved translation coverage (#655, #659)
π Bugs Fixed
- π· Tags were incorrectly treated as case-sensitive in some places
- Assigning tags to records caused an SQL error for some newer MySQL servers
- The item advanced search "does not contain" worked incorrectly with elements having multiple texts
- API authentication did not work properly on installations with no database prefix
browse_sort_links
for "bare" links handled attributes incorrectly (#648)- Setting a custom homepage including a query string would silently set that query on all pages
- β¬οΈ Upgrades could fail on some "strict mode" MySQL configurations
- β¬οΈ Upgrades directly from old 1.x versions could fail when migrating collections
- π Theme overrides of plugin views did not apply when on a different plugin's page (#635)
- The display of item search filters did not always recognize when users filtered by tag
- Automatic
alt
attributes for file display were over-escaped - Admin-side page titles on hover were over-escaped
- Long titles for records indexed for the sitewide search could be silently truncated or cause an error
- The sitewide search form did not respect the documented
submit_value
option - π· Errors on individual items could cause the "Index Records" job to fail
- Item Types did not properly clean up after themselves after they were deleted
Localization
- π The Norwegian (no) translation has been moved to Norwegian BokmΓ₯l (nb).
- New translations for Bulgarian (bg_BG), Korean (ko_KR).
- β‘οΈ Updates to many existing translations
External Libraries
β‘οΈ Omeka 2.3 updates to the following versions of its external dependencies:
- Zend Framework 1.12.11
- jQuery 1.11.2
- π» jQuery UI 1.11.2
- TinyMCE 3.5.11
Bundled Add-ons
π Plugins
- π Exhibit Builder 3.2
- Simple Pages 3.0.5
Themes
- Thanks, Roy 2.3
- Seasons 2.3
- Berlin 2.3
For Developers
π For change information geared toward developers, see What's New in Omeka 2.3 on Omeka's Read the Docs site.
Acknowledgements
π The following members of the Omeka community contributed code, fixes, and improvements to Omeka 2.3: