Matrix Field Preview

🚨 Read Before Updating

We need to reset the Matrix Field Preview data as part of the Craft 5 upgrade. Unfortunately there's no way to migrate existing data from version 4 to 5, due to the changes in matrix fields in Craft 5 (specifically the migration from "block types" to "entry types").

Therefore, after updating to version 5 you'll need to re-enter titles, descriptions and images for the entry types within your matrix fields. Neo fields are unaffected, as is any other data on your site.

⚠️ Matrix Field "Views"

Currently, only the "block" view for matrix fields is supported. Support for the "card" and "element index" views will follow shortly in a future update (5.1). This is due to requiring some additions in the Craft codebase to be able to detect these new views in the Craft CP Javascript environment.

Added

• Craft 5 support

Fixed

• Fixed "add block above" issue with Neo fields (see Issue #112 and PR #123)
• Stop page scroll bug when modal is closed (Issue #106)

Fixed

• Neo previews now respect the "enabled" tag. (Issue #118 & PR #121)

Added

• Support for GIFs when transforms are disabled (issue #119). See the troubleshooting docs for more on issues with GIFs.

Changed

• Updated branding! Shiny new icon that better suits the Craft CMS aesthetic, as well as a new documentation website.

Added

• Added basic MatrixMate compatibility (issue #109 & PR #90).
• Added proper static translation, allowing interface to be updated (issue #110).
• Ability to disable previews on nested Neo fields, if there's only a single child (issue #111).

Fixed

• Fixed inline previews not showing on the top-level Neo blocks (issue #103).
• Fixed issue with "add block above" option on Neo menus not working (issue #104).
• Fixed issue with Spoon compatibility (issue #100).

Changed

• Changed preview image transform from "stretch" to "fit", possibly addressing issue #105.

Thanks @ttempleton for PR #91, helping to address issues with Neo.

Added

• Ability to takeover the default Neo block button (addressing issue #85 and potentially #84)

Fixed

• Fixed inline previews not showing in Neo fields (issue #92)
• Added/fixed proper modal filtering for Neo fields, now the modal respects the children available to the block (issue #87)
• Fixed bug with Neo block configuration crashing the previews (issue #88)
• Fixed Supertable "matrix row" issue, where previews were incorrectly showing in nested Supertable rows for Matrix Fields (issue #96)

Fixed

• Fixed issue with sortOrder missing (issue #95)

Fixed

• Fixed issue with Neo migration not being run correctly (issue #88)
• Fixed issue with ordering > 10 fields (issue #93)

Fixed

• Version 4 of the plugin still included Craft 3/PHP 7 as valid requirements so these have been removed.

Fixed

• Issue with preview image upload (Issue #82)

Added

• Craft 4 support!
• Added phpstan and rector for code quality.
• Updated types for Craft 4 and PHP 8 support.

Changed

• Split JavaScript asset bundles out for clarity and readability.
• Improved the JavaScript for consistant loading.

Fixed

• Issue with Neo field configuration settings page
• Small display issue with inline previews.

Fixed

• Improved migrations to address #77.
• Added missing "Install" migrations.

Fixed

• Updated the admin permissions being used to address #75.

After an unplanned hiatus we're back with a whole load of useful updates.

Note that we've jumped from version 1.X.X to 3.X.X. This is to make it easier and clearer to add Craft 4 support: plugin version 3.X.X (this version) will continue to work for Craft 3 while plugin version 4.X.X will work for Craft 4 (eventually).

Added

• Categories. Blocks can be assigned to categories for easier filtering via the new categories sidebar.
• Search. You can now search via the modal preview, making it much quick to find and select matrix field blocks.
• Sorting. You can now set the order of previews via a simple drag-and-drop interface. This means you can put the most common blocks near the top.
• Full-screen preview. You can now view a full-screen preview of the ... preview.
• Markdown descriptions. Added ability to add markdown to descriptions.

Changed

• New modal design. Completely overhauled the modal overlay for easier search and filtering.
• Improved the settings templates with breadcrumbs etc.
• Code cleanup. Overhauled the codebase for easier maintainance and prep for Craft 4.

Fixed

• Fixed issue #62 with Supertable via @daltonrooney PR.

Changed

• Fixed migration issues with latest release.

Added

• Beta Neo support (Issue #17)

Changed

• Updated interface look and feel.
• Added custom icon to preview button.
• Overhauled asset bundles.
• Fixed issue with Garnish events (Issue #41).

Changed

• Release fixes. Paths were incorrect after making changes for composer 2.

Added

• Ability to enable/disable previews for particular matrix fields (Issue #31).
• Ability to control "takeover" of default Craft UI experience for particular matrix fields.
• Block types are now grouped by their matrix field (Issue #30).

Changed

• Improved settings page. Setting should now be available without needing to enable the settings (Issue #18).
• Fixed bug with enabling/disabling "add block" button when max block types reached (Issue #71)
• Fixed deprecation for Composer 2.0 (Issue #43).
• Fixed bug with block type names (Issue #32).
• Refactored code base for easier maintenance.

Changed

• Fixed with matrix fields and max-blocks. Now the max-block setting will be respected.
• Added a "take-over" option which can be disabled so that the preview field augments the matrix field as opposed to taking it over. This allows use alongside Spoon for example.

Changed

• Quick-fix for soft-deleted assets issue.

Changed

• Fixed issue with a stray console log.

Changed

• Fixed issue with "Position Fieldtype" plugin.

Added

• Debugging output for preview field.

Changed

• Fixed issues with default preview images.

Changed

• Fixed issue with the JavaScript asset bundle running on non-cp requests.

Added

• Initial release.