Easy Photo Publisher

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:

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.