Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/slashmad/slashphoto/archive/refs/heads/main.zipOpen-source photography galleries, client proofing and photo sales for WordPress. No subscriptions, no paid add-ons, no locked features.
Status: early development (0.1.0-dev). Galleries and panorama support work; proofing and the shop are not built yet. Not ready for production.
Features
Working now:
- Galleries and sub-galleries as a hierarchical post type, rendered inside any theme's own layout (block and classic themes).
- Panoramas and 360° images. 360° images are detected from the GPano XMP metadata that cameras and stitchers such as PTGui write, including partial spheres. They keep up to 8192 px instead of WordPress' usual 2560 px, and can be marked manually in the media library. Wide flat panoramas span the full gallery row.
- Lightbox and 360° viewer. A native
<dialog>lightbox with keyboard, swipe and focus handling. 360° images open in an interactive viewer (Photo Sphere Viewer on three.js, both MIT, bundled) that is downloaded only when a visitor opens one. Partial panoramas cannot be panned past their edges, and panoramas that were cropped again after stitching are mapped correctly. - Client access. Password (WordPress' own), secret share links, selected client accounts, end dates and terms to accept, all inherited by sub-galleries. Protected galleries do not leak through the REST API, attachment pages, sitemaps, search, feeds, caches or oEmbed, and their images get unguessable URLs. See docs/security-and-privacy.md.
- Watermarked previews with protected originals: the full-resolution file cannot be derived from a preview URL.
- No visitor logging. No IP addresses, analytics or third-party requests; terms acceptance is a signed cookie in the visitor's browser only.
- Gallery block for placing any gallery on any page, with the same access rules.
- Theme-first styling that adapts to the theme's colors, fonts and width. See docs/theme-compatibility.md.
Planned, in order:
- Proofing: favourites and selections without payment
- Shop: price lists for digital downloads and prints, cart, Stripe Checkout, orders, receipts and secure expiring download links
- Import from Sunshine Photo Cart
- Client invitations by email, licences, print-lab integrations, AVIF/WebP, EXIF/IPTC search
Requirements
- WordPress 6.7 or later
- PHP 8.3 or later (CI covers 8.3–8.5)
Development
Requires Node.js and Docker. PHP and Composer run inside the containers, so they do not need to be installed locally.
npm install
npm run env:start # WordPress at http://localhost:8888 (admin / password)
npm run setup # composer install inside the container
npm run test:php # PHPUnit integration tests
npm run lint:php # WordPress Coding Standards + PHP compatibility
npm run seed # demo galleries; uses your own JPEGs from .dev-media/ if present
npm run test:e2e # Playwright browser tests (needs the seeded site)
npm run vendor # copy three.js / Photo Sphere Viewer from node_modules to assets/vendor
npm run i18n:pot # regenerate languages/slashphoto.pot
npm run env:stop
Put your own test photos, for example 360° panoramas, in .dev-media/. The
folder is ignored by Git.
Browser tests use Playwright's Chromium (npx playwright install chromium),
or a system Chromium: PLAYWRIGHT_CHROMIUM=/usr/bin/chromium-browser npm run test:e2e.
Third-party browser libraries are pinned in package.json and copied into
assets/vendor/ by npm run vendor, which also rewrites their imports to
SlashPhoto-prefixed module IDs so they cannot collide with other plugins.
The copies are committed, so the plugin needs no build step.
Layout
slashphoto.php plugin header and autoloader
src/ PSR-4 classes (SlashPhoto\)
Plugin.php wiring
Gallery/ post type and queries
Access/ access rules, leak guards, terms
Admin/ editor access panel
Blocks/ gallery block
Frontend/ theme compatibility, templates, assets
Media/ panorama and 360° detection
blocks/ block.json, render.php and editor script
templates/ overridable partials (copy to yourtheme/slashphoto/)
assets/ CSS, JavaScript modules, bundled vendor libraries
tests/Integration/ PHPUnit tests against the WordPress test suite
tests/e2e/ Playwright browser tests
docs/ developer documentation
Support the project
SlashPhoto is free and will stay free, with no paid add-ons. If it saves you a subscription, consider supporting development through GitHub Sponsors, Ko-fi or Liberapay.
Licence
GPL-2.0-or-later. See LICENSE.