Dirigible Portfolio changelog

3.1.55 2026-10-24

Fixed

• Collection filter tags skip a filter that has since been deleted (or isn't a Portfolio filter) instead of printing an empty tag and PHP warnings. Filters the pieces don't use load in one database query instead of one each. The other tags look and filter the same.

3.1.54 2026-10-24

Fixed

• Collection filter tags (with Allow Filtering on) close each tag's label properly, and the label text is escaped. The tags look and filter the same.

3.1.53 2026-10-23

Fixed

• Work pages built from a Portfolio template (Image Hero, Project Header, Side Details, Split Intro) no longer carry leftover CreativeWork microdata next to the work's structured data (JSON-LD). Nothing changes on the page.

3.1.52 2026-10-23

Changed

• Internal: the shared Dirigible field reader is updated (v5, also used by Dirigible Documentation). Pages and saved settings are unchanged.
• A work's structured data names the site's business as its author by pointing at the business details the Dirigible theme already prints on every page (theme 5.31.101 or later), instead of repeating the site's name and link. Older themes keep the inline author. Works the theme had already cached are rebuilt on their next view.

Fixed

• Portfolio cards (Collection, Logo Collection, Logo Grid Collection, Packery Collection, and collection pages) no longer carry leftover structured-data markup that search engines read as broken: each card claimed to be a separate item named by both its title and its subtitle, with the post's ID number where a web address belongs. Work pages keep their structured data.
• Card subtitles are a paragraph instead of a heading, so they no longer add a level-4 heading under every card title in the page outline. They look the same: the Subtitle Style setting still sets their size.

3.1.51 2026-10-22

Changed

• In the editor, a work's Template picker sits on a light gray band across the top, and the work's content starts right below it instead of after a gap.

3.1.50 2026-10-22

Fixed

• In the editor, a work's full-width and wide blocks (sections, heroes, Action Strips) run as wide as they do on the page, instead of being held to the content width. Pages don't change.

3.1.49 2026-10-22

Added

• Work page templates. Besides Default (your theme's page, unchanged), a work can use Image Hero, Project Header, Side Details or Split Intro, picked from drawings of each. Portfolio → Settings → Single Page → Default Template sets it for every work left on Site Default, which every existing work is. The setting starts at Default, so no page changes until you change it.
• Edit a work on its page. The editor shows the work's template at the top with a Change button, and the template's header (featured image, subtitle, short description, collections) with an Edit button on each part.

Changed

• The sidebar's Portfolio panel previews the work's Collection card (featured image, card title, subtitle, short description) with an Edit button on each part. The Title field is now called Card Title; it stores the same thing.
• Each work's content now sits inside a Work Page block, which the editor adds when you open the work and new works start with. Pages look exactly the same.

3.1.48 2026-10-22

Changed

• Internal: block and field settings are read through the shared Dirigible field reader (the same one Cards, Manifest, Portfolio and Locations now carry). Pages and saved settings are unchanged.

3.1.47 2026-10-22

Changed

• Portfolio no longer needs ACF. Collection, Packery Collection, Logo Collection, Logo Grid Collection and Portfolio Slider are built-in blocks now, with the same names, settings and saved content, so every page looks exactly as before and nothing needs re-saving. Their sidebars have the same settings, with the same choices, defaults and show-when rules (Filters after Allow Filtering, Padding for Overlay, and so on). They also keep working on sites that still run ACF.
• A work's Title and Subtitle move to a Portfolio panel in the editor sidebar, with the same values.
• The block editor is lighter on pages with Portfolio blocks. A Portfolio Slider preview no longer piles up page elements each time it refreshes, and adding and removing a Collection no longer leaves its old settings form behind.
• The one-time move of old image and excerpt fields to the featured image and excerpt also runs on sites without ACF. Before, it waited for ACF.

Fixed

• On sites without ACF, a project page could stop with a critical error whenever its structured data was rebuilt (it asked ACF for the subtitle).

3.1.46 2026-10-22

Changed

• Portfolio's settings move from the Customizer to Portfolio → Settings (needs the latest Dirigible theme; older themes keep the Customizer panel). Every setting keeps its value, and old Customizer links open the new page. Single Page and Archives each show a live preview of made-up sample projects that updates before you save, and the layout choices (Prev/Next Width, Portfolio Item Style, Image Shape) show small drawings. Portfolio Page now sits under Single Page, beside the return link it sets, and settings that only matter with Prev/Next Navigation or the return link on appear only then.
• Portfolio Item Style shows Seamless as its default, which is what collection pages have always shown when it was never changed. Before, it showed Card selected while pages showed Seamless, and choosing Card on such a site never stuck. Collection pages look the same as before.

Fixed

• The Return link at the bottom of project pages is hidden when no Portfolio Page is picked, or the picked page is deleted or unpublished. Before, it linked back to the project itself (or to an empty or draft address).

Added

• Portfolio → Import & Export (needs the latest Dirigible theme). Import works from a spreadsheet or another Dirigible site, with a preview of every row first and an undo afterwards, and export the portfolio as a CSV or JSON file. Titles, the sidebar Title and Subtitle, excerpts, case studies, featured images, collections, filters and order all travel; a work's parent doesn't yet.

3.1.44 2026-10-21

Fixed

• A work's structured data prints its name, description, subtitle and collection and filter names as plain text ("D&D", not "D&D"; descriptions without their <p> tags), and leaves the description out when the work has none instead of printing "". Works the theme had already cached are rebuilt on their next view.

3.1.43 2026-10-19

Added

• The studio's site report includes the progress of Portfolio's one-time image and excerpt transfer (how many works it filled and how many it would still fill). Counts only, no content.

3.1.42 2026-10-15

Changed

• Removed the old Colcade library file, unused since our own search/layout code replaced it on 2026-10-01; it was kept only for pages cached before then.

3.1.41 2026-10-08

Changed

• Old portfolio images and excerpts move to the featured image and excerpt automatically, once, in the background; only empty fields are filled, and page content and last-modified dates don't change. The Transfer DS Portfolio Images tool is gone. To stop it on a site, add define('DSP_AUTO_TRANSFER', false); to wp-config.php.

3.1.40 2026-10-08

Changed

• A Work's structured data picks up renamed Collections and Filters without saving the Work again (Dirigible theme 5.31.98 or newer).

3.1.39 2026-10-01

Fixed

• The Transfer DS Portfolio Images tool keeps backslashes in migrated excerpts.

3.1.38 2026-10-01

Fixed

• Portfolio cards and category items are one stop each when tabbing, and screen readers no longer hear unnamed image links. When a List layout hides the title and link, the image link stays and is named after the work.

3.1.37 2026-09-30

Changed

• Packery Collection uses its own small layout script: the same layout, about 7 KB less, and it corrects the columns if an image arrives without a size.
• Blocks register from a prebuilt list instead of reading each block's settings file on every uncached request.
• Update checks use the Dirigible theme's license handling, so a plugin with no license key no longer sends an empty one.

3.1.36 2026-09-30

Changed

• Portfolio collection pages and collection blocks load faster: each piece's image is fetched together with the others, not one at a time.

3.1.35 2026-09-30

Changed

• Block stylesheet versions are kept in one saved setting and refreshed on updates, instead of a database read and a file check per block on every uncached page load.

3.1.34 2026-09-30

Fixed

• Card images load a file sized for the card instead of a full-width one, so pages with cards download less.

3.1.33 2026-09-30

Fixed

• Style fixes to blocks now show in the editor, and on pages that load block CSS as a file, right after an update. Browsers and the host's cache used to keep the old stylesheet for up to a year; each block's CSS now gets a new address only when it actually changes.

3.1.32 2026-09-30

Security

• Updates come only from Dirigible: WordPress no longer matches this plugin to a WordPress.org listing with the same name.

Changed

• The installable zip is smaller: build sources, source maps, right-to-left stylesheets and Markdown are no longer shipped. Nothing sites load changed.

Fixed

• A visitor who lands while the plugin is being updated sees "This site is updating, refresh in a minute" instead of a critical error, and error replies never include server file paths.

3.1.31 2026-09-29

Changed

• The Packery Collection block's layout library (Colcade 0.2.0) now ships with the plugin instead of loading from unpkg.

3.1.30 2026-09-29

Security

• Block class names, ids, style values and links in the Portfolio, Packery, Logo, Logo Grid and Portfolio Slider blocks and the collection pages are escaped.

Fixed

• The Customizer can't crash when the Dirigible theme is missing or older.

3.1.29 2026-09-29

Security

• The image transfer tool on the Tools page is limited to administrators.

3.1.28 2026-09-28

Changed

• Upgrade notice: update the Dirigible theme to 5.31.19 or later with this release. Portfolio used to refresh permalinks on every page load, which also applied other plugins' Customizer slug changes on sites running Portfolio; theme 5.31.19 now refreshes permalinks after Customizer saves instead.
• Permalinks refresh only when Portfolio updates or its Slug or Collection Slug changes, instead of on every page load.
• The installable zip leaves out builder docs and development files.

Fixed

• The hidden Filters taxonomy no longer adds permalink rules that differed between admin and front-end requests, which made WordPress rewrite its stored rules on most page loads.

3.1.27 2026-09-22

Added

• Accessible alt text on showcase screenshots in screenshots.json for Dirigible Support docs (screen readers; pipeline falls back to caption when needed).

3.1.26 2026-09-21

Changed

• Recapture Portfolio block Settings sidebar screenshots at 2× (retina) for Dirigible Support docs.

3.1.25 2026-09-21

Added

• Sample data fixtures under docs/sample-data/ (WXR + wire + media) registered via ds_sample_data_sources for Dirigible → Import/Export demos and screenshots.

Changed

• Retina front-end featured screenshot (2880×1800) and screenshot manifest for the Portfolio / Collection block.

3.1.24 2026-09-16

Changed

• Update blocks: logo-collection, logo-grid-collection, packery-collection, portfolio-slider, portfolio.

3.1.23 2026-09-08

Changed

• Update templates.

3.1.22 2026-08-18

Changed

• Update blocks: portfolio-slider.

3.1.21 2026-06-01

Added

• Add blocks: logo-collection, logo-grid-collection, packery-collection, portfolio.

Changed

• Update blocks: portfolio-slider.

3.1.20 2025-12-11

Changed

• Update jsonld.

3.1.19 2025-11-26

Changed

• Update templates.

3.1.18 2025-11-26

Changed

• Update templates.

3.1.17 2025-11-26

Changed

• Update portfolio, templates.

3.1.16 2025-11-26

Changed

• Update portfolio, templates.

3.1.15 2025-11-12

Changed

• Update portfolio, templates.

3.1.14 2025-11-12

Changed

• Update blocks: logo-collection.
• Update portfolio, templates.

3.1.13 2025-10-30

Changed

• Update blocks: logo-collection, logo-grid-collection, packery-collection, portfolio-slider, portfolio.
• Update templates.

3.1.12 2025-10-23

Changed

• Version bump (2 files changed, 5 insertions(+), 40 deletions(-)).

3.1.11 2025-10-21

Changed

• Version bump (2 files changed, 7 insertions(+), 2 deletions(-)).

3.1.10 2025-10-21

Changed

• Update portfolio, templates.

3.1.09 2025-10-21

Changed

• Update templates.

3.1.08 2025-10-21

Changed

• Update README, portfolio, templates.

3.1.07 2025-10-15

Changed

• Update templates.

3.1.06 2025-10-15

Changed

• Update templates.

3.1.05 2025-10-15

Changed

• Update templates.

3.1.04 2025-10-03

Changed

• Update blocks: portfolio-slider.

3.1.03 2025-10-03

Added

• Add blocks: portfolio-slider.

3.1.02 2025-07-16

Changed

• Version bump (2 files changed, 7 insertions(+), 4 deletions(-)).

3.1.01 2025-07-16

Changed

• Version bump (1 file changed, 2 insertions(+), 2 deletions(-)).

3.0.44 2025-07-16

Changed

• Version bump (2 files changed, 51 insertions(+), 30 deletions(-)).

3.0.42 2024-08-02

Changed

• Update templates.

3.0.41 2023-09-15

Added

• Add blocks: portfolio.

Changed

• Update blocks: portfolio.
• Update templates.

3.0.39 2023-06-27

Changed

• Update README.

3.0.38 2023-06-12

Changed

• Update blocks: logo-collection, logo-grid-collection, packery-collection, portfolio.
• Update README.

3.0.37 2023-04-25

Changed

• Update README, templates.

3.0.36 2023-02-17

Added

• Add blocks: logo-grid-collection.

Changed

• Update README.

3.0.35 2023-02-13

Changed

• Update README, portfolio.

3.0.34 2023-02-06

Added

• Add files: admin.js.

Changed

• Update README.

3.0.33 2023-02-06

Changed

• Update README.

3.0.32 2023-02-06

Added

• Add blocks: logo-collection, packery-collection, portfolio.
• Add files: helpers.php.

Changed

• Update README, templates.

3.0.30 2023-01-19

Changed

• Update templates.

3.0.29 2022-12-09

Changed

• Update README, templates.

3.0.28 2022-12-06

Changed

• Update README, portfolio.

3.0.27 2022-11-09

Changed

• Update templates.

3.0.26 2022-11-01

Changed

• Update templates.

3.0.25 2022-10-17

Changed

• Update templates.

3.0.24 2022-10-06

Changed

• Update templates.

3.0.23 2022-10-06

Changed

• Update templates.

3.0.21 2022-10-06

Changed

• Version bump (2 files changed, 20 insertions(+), 12 deletions(-)).

3.0.20 2022-09-20

Changed

• Version bump (2 files changed, 2 insertions(+), 2 deletions(-)).

3.0.19 2022-09-20

Changed

• Update templates.

3.0.18 2022-01-11

Added

• Add files: licensing.php.

Changed

• Update admin-min, admin, licensing-min, licensing, .editorconfig, .gitignore, and 37 more.

3.0.17 2022-01-11

Changed

• Version bump (1 file changed, 5 insertions(+), 9 deletions(-)).

3.0.16 2022-01-11

Added

• Add files: README.md, admin-min.js, licensing-min.css, licensing.css.

Changed

• Update admin.

3.0.15 2021-11-23

Changed

• Version bump (2 files changed, 2 insertions(+), 2 deletions(-)).

3.0.14 2021-10-28

Changed

• Version bump (2 files changed, 2 insertions(+), 2 deletions(-)).

3.0.13 2021-09-30

Changed

• Version bump (2 files changed, 3 insertions(+), 3 deletions(-)).

3.0.12 2021-06-30

Changed

• Update templates.

3.0.11 2021-05-28

Changed

• Update templates.

3.0.10 2021-05-28

Changed

• Update portfolio, templates.

3.0.8 2021-05-28

Changed

• Update templates.
• 0.8

3.0.7 2021-05-28

Changed

• Update templates.

3.0.5 2021-05-28

Changed

• Update templates.

3.0.4 2021-05-26

Changed

• Version bump (2 files changed, 4 insertions(+), 4 deletions(-)).

3.0.3 2021-05-26

Changed

• Update templates.

3.0.2 2021-04-19

Changed

• Version bump (1 file changed, 1 insertion(+), 1 deletion(-)).

3.0.1 2021-03-09

Changed

• Update templates.

3.0.0 2021-03-08

Changed

• Update portfolio, templates.

2.0.1 2021-01-15

Changed

• Update dirigible-portfolio.php

2.0.0 2021-01-15

Added

• Add files: CHANGELOG.md, README.md, licensing.php, admin.js, helpers.php.

Changed

• Enable post revisions on custom post types.
• Update admin, .editorconfig, .gitignore, README, composer, puc-debug-bar, and 37 more.

Fixed

• Roll ACF blocks back to blockVersion 2 and dedupe field keys across 5 blocks (logo-collection, logo-grid-collection, packery-collection, portfolio-slider, portfolio).