WP Manifestindependent plugin directory
manifest / media / slashphoto

SlashPhoto

Open-source photography galleries, client proofing and photo sales for WordPress. No subscriptions, no locked features.

★ 0stars

Install

Download source zip No release zip yet

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.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Open-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:

  1. Proofing: favourites and selections without payment
  2. Shop: price lists for digital downloads and prints, cart, Stripe Checkout, orders, receipts and secure expiring download links
  3. Import from Sunshine Photo Cart
  4. 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.