Easy Photo Publisher

Description

Easy Photo Publisher complements the Adobe Lightroom Classic add-on Easy WordPress Publisher.
Together they form a full publishing pipeline: send images directly from Lightroom to your WordPress site,
update or replace them later, and (optionally) create blog posts using those images.

Highlights
– Direct publish from Lightroom Classic via the companion LrC module
– Create / update / delete media via a simple REST API
– Optional post creation with visibility control and Featured Image
– Gallery Shortcode: [wpdet_gallery] with taxonomy filters, sizing and a11y-friendly captions
– Accessible lightbox (keyboard/ARIA aware), toggled per shortcode
– Gallery selection: let visitors mark images and pull the selection into Lightroom (opt-in)
– Media taxonomies: enable Categories and Tags on attachments
– Theme template overrides (HTML-only)
– i18n-ready (easy-wp-publisher)

Quick Start

1. In Lightroom Classic, publish an image using the « Easy WordPress Publisher » service.
2. The image appears in your WordPress Media Library.
3. On any page or post, insert the gallery shortcode:

[wpdet_gallery category= »Portugal » limit= »-1″ order= »DESC » min_width= »240px » gap= »1.5rem » size= »large » class= » » showcaption= »true » lightbox= »true »]

• limit= »-1″ shows all matching images
• showcaption= »true|false » toggles captions
• lightbox= »true|false » enables the accessible lightbox

Shortcode Reference: [wpdet_gallery]

Attributes
– category — Category ID or slug to filter attachments (requires media taxonomies)
– tags — CSV of tag slugs (e.g. tags="portugal,coast")
– limit — Number of images (default 12). Use -1 for all.
– order — ASC or DESC (default DESC)
– size — thumbnail|medium|large|full (or any registered image size)
– min_width — Grid minimum width (CSS value, default 200px)
– gap — Grid gap (CSS value, default 1.5rem)
– class — Extra CSS classes on the wrapper
– showcaption — true|false (default true)
– lightbox — true|false (default true)

Markup & Styles

• Wrapper template: templates/wrapper.php
• Item template: templates/gallery.php
• CSS: templates/css/wpdet-gallery.css
• Lightbox CSS/JS autoload when lightbox="true"

Theme overrides (HTML-only)

your-theme/
└── wpdet/
└── templates/
├── wrapper.php (uses tokens: {items}, {min_width}, {gap}, {extra_class})
└── gallery.php (uses tokens: {link_open}, {img}, {link_close}, {caption})

If present in a child theme, it’s used first; then the parent theme; finally the plugin fallback.

Accessibility

• Lightbox uses proper roles (role= »dialog »), aria-modal, labelled controls, focus trapping, and Esc to close.
• Close button is keyboard-operable (Enter/Space) and returns focus to the trigger.
• Captions are announced via a polite live region.

Media Taxonomies (Categories/Tags on Attachments)

Enable in Settings → From Image to WordPress to use core Categories and Tags on media items. This allows taxonomy-filtered galleries.
– Works with the shortcode filters (category, tags)
– Adds taxonomy UI to the Media screens (without duplicating existing columns)

Gallery Selection (Visitor Voting)

Per-gallery feature, off by default. Turn it on for a specific gallery with the shortcode
attribute ratings="true", and change the visible label with select_label="…". Each image
then shows an accessible selection checkbox below its caption. Example:

[wpdet_gallery category="Portugal" ratings="true" select_label="Select your favourite"]

The choice is stored as one shared on/off flag per image (no counter, no per-visitor state —
visitors may overwrite each other). The selection can then be pulled into Lightroom Classic
with the Easy WordPress Publisher add-on (version 1.0.4 or newer). Clear the stored
selection any time under Settings → Easy Photo Publisher → Gallery selection.

REST endpoints (namespace wpdet/v1):
– GET /capabilities — feature discovery (public)
– POST /rate/{id} — set the on/off state (public; nonce-protected)
– GET /selection — list selected image IDs (Application Password)
– DELETE /selection — reset, optionally scoped by category/tags (Application Password)

Minimum pairing: the selection feature needs this plugin >= 1.1.0 and the Lightroom
add-on >= 1.0.4. Older pairings keep working for publishing; only the selection pull is unavailable.

Validation

• MIME types: image/jpeg, image/png, image/webp, image/avif
• Max size: ~25 MB (configurable in code)

Support & Documentation

• Documentation: https://medienkonzepte.de/easy-wordpress-publisher-a-lightroom-extension/
• Donate: https://buymeacoffee.com/webline

Credits

Made with ❤️ by Detlef Beyer.