DSE Projects Pack

Portfolio / case-study Projects for DSE Blueprint sites (2.2+), packaged as an installable plugin: project CPT, sector/division/sub-sector taxonomies, PHP-registered ACF fields, archive with grid⇄map toggle, single template with hero + spec bar + Flexible Blocks, sample content, neat uninstall.

Install

1. Copy dse-projects-pack/ into wp-content/plugins/ and activate (requires ACF PRO; DSE Blueprint theme 2.2+ recommended).
2. Permalinks flush automatically on activation.
3. Optional: Tools → Projects Pack → Create sample content seeds 3 sample projects with images, terms and map pins.

Updates

The pack updates itself from GitHub Releases — new versions show up in Dashboard → Plugins like any other plugin. WordPress's update check doesn't look at GitHub on its own; the checker wired into the main plugin file points it there using the bundled Plugin Update Checker. This is the DS.Emotion house convention — see dse-plugin-boilerplate.

The repo is public, so no token or authentication is needed on the sites that run the pack.

Cutting a release (maintainers):

1. Bump the Version: header and the DSE_PP_VERSION constant in dse-projects-pack.php to the same X.Y.Z, add a changelog entry below, and commit. (The two must match — WordPress compares the header; the constant version-stamps assets.)
2. Tag and push: git tag vX.Y.Z && git push origin vX.Y.Z.
3. Publish a Release from that tag on GitHub.

Installed sites then offer the update immediately via Plugins → "Check again", or automatically within ~12 h on WP-Cron.

Retune for a different scope

Labels, slugs and menu icon are filterable — see the docblock in dse-projects-pack.php (dse_projects_pack_config). Field changes are made in inc/acf-fields.php; read CLAUDE.md first (field keys are permanent).

Uninstall

Deactivation keeps all content. Uninstall removes sample content + options; removing ALL project content requires opting in first at Tools → Projects Pack. See uninstall.php.

Versioning

Semantic versioning; changes logged per release. Fixes proven on a client site get ported back here with a changelog line (same promotion rule as the Blueprint theme). Releases are cut as GitHub Releases tagged vX.Y.Z (see Updates above).

1.2.4

• Project Spec Bar reorganised into three editable Items (ported from the Marshall build). The Spec Bar tab now shows an intro note plus three one-row Items — each heading · details · note at 1/3 width — defaulting to Client, Value and Status. Each Item's heading is an optional override (blank = the default label); leave an Item's details blank to hide it. Sector still comes from the taxonomy and Year stays a separate field (the card eyebrow). Data-safe: the underlying field names stay client / value / status (+ _note), so existing content maps with no migration; the new *_label heading fields are the only additions. PHP-registered fields — no ACF JSON sync, no build; deploy the two PHP files.

1.2.3

• Fixed a one-frame "flash of single-column cards" on the Projects archive when switching from grid to map view (ported from the Marshall build). Each map marker node carries the InfoWindow's card markup (thumb, sector, title, link); those raw nodes are now hidden (.projects-map .marker { display:none }), so the browser can't paint them as a stacked column in the frame before Google Maps takes over the container. The map JS still reads each marker's coordinates and infowindow HTML from the DOM, so pins and pop-ups are unaffected. Also added a fail-safe fade-in: the map container stays hidden (.is-initialising) until tiles have painted, then fades in — with a 1.5s timeout so a slow or failed Maps init can never leave it stuck invisible.

1.2.2

• Developer-guide link now opens the GitHub-rendered CUSTOMISING.md (public repo) in a new tab instead of downloading the raw .md file. Refreshed the guide's "Updating" section to describe the live GitHub self-updater.

1.2.1

• Updater realigned to the DS.Emotion house style (dse-plugin-boilerplate): Plugin Update Checker moved to the repo root and wired directly in the main plugin file, tracking GitHub Releases via enableReleaseAssets(). The repo is public, so the previous private-repo access token is no longer used or needed.

1.2.0

• Self-updating from GitHub Releases — the pack checks its GitHub repo for new versions and surfaces them in Dashboard → Plugins (bundled Plugin Update Checker; see the Updates section above).
• Tools → Projects Pack: "Projects listing / archive display" — a visual picker to set the project card order: Default (image first, then text — every card the same) or Card Order flip (the alternating checkerboard rhythm). Fed to the Blueprint theme via the blueprint_card_order filter, so the order is consistent everywhere project cards render — the /projects/ archive and any Feed/Picker block showing projects. Requires Blueprint 2.2+ for the shared renderer; degrades to the archive on older themes. New option dse_pp_card_order (removed on uninstall).

1.1.1

• Added CUSTOMISING.md — the developer guide for customising the pack from the theme (overrides, never editing pack files, so updates stay clean).

1.1.0

• Tools → Projects Pack: "Replace all projects with sample data" — deletes every existing project (and now-empty terms), then seeds the sample set. The one-step boilerplate-prep action for clearing real/client content.
• Sample set expanded to 6 UK projects across 4 sectors (Commercial, Residential, Leisure, Education) in six cities — two rows of three cards, fuller map spread, all four sector filters populated.

1.0.0

• Initial extraction from the Marshall Holdings build via Blueprint 2.2.