Uplink Media Manager organizes your WordPress media library with folders, image optimization, and live folder galleries. It works with any WordPress theme. Bricks 2.4 or later is optional.<\/p>\n\n
Add Uplink Media Manager Gallery<\/strong> or Uplink Media Manager Slideshow<\/strong> from the block inserter. Slideshow is included as a Gallery block variation.<\/p>\n\n Both use a live Uplink Media Manager folder, optionally including child folders, and support custom folder ordering. Display images in gallery layouts or responsive slideshows, with captions, a custom or native lightbox, fullscreen, zoom, thumbnail strips, slideshow playback and EXIF controls.<\/p>\n\n For shortcode contexts, use Choose the enhanced Uplink Media Manager library or the standard WordPress library with folder controls. Both use the same folder records. The optional Bricks integration uses those records too. Nest folders without a plugin-imposed depth limit.<\/p>\n\n Includes bulk folder assignment, custom media order, uploads, attachment details, image editing, file replacement, EXIF metadata, alt text controls, appearance settings, and media health checks.<\/p>\n\n The settings screen includes tabs, cards, appearance controls and floating save controls.<\/p>\n\n The Optimization tab provides local post-upload compression, format comparison, per-size statistics and restoration without Cimo Pro. Format support and reference-update coverage are described below. Existing Cimo optimization data remains visible, and Cimo remains an optional pre-upload integration.<\/p>\n\n The Enhanced Manager's Optimization tab prepares one full-image preview per format. After you choose a result, only that format is encoded for every existing generated size and any unscaled original. Saved results show the actual combined bytes and per-size savings. Quality scales differ by codec. Images can also be recompressed in their current enabled format, including existing WebP files and images previously optimized by Cimo. An active Uplink Media Manager conversion must be restored before starting another conversion. Restoration recovers the exact state immediately before recompression.<\/p>\n\n WebP\/AVIF conversion preserves attachment IDs, titles, captions, alt text, folders and order. Exact known URLs are updated in WordPress content\/excerpts, post metadata, term metadata and stored options, including safe serialized arrays and escaped JSON. Attachment GUIDs and unrelated values are preserved. Arbitrary PHP objects, custom database tables, disk files, remote sites and third-party caches are not rewritten. Original files remain available for those links. Clear any page-builder, site or CDN caches after reference updates.<\/p>\n\n JPEG XL keeps the original attachment and its URLs as fallbacks. WordPress attachment images, post content and Bricks output can receive JPEG XL picture sources and responsive srcsets. Existing picture markup, CSS backgrounds, external links and cached HTML keep their original delivery. Disabling the plugin leaves original-format images usable.<\/p>\n\n Saved results include format, quality, completion time, original\/converted totals and per-file savings. Restore originals reverses the local reference updates without discarding other content edits and restores the attachment metadata. It restores the state immediately before this conversion, including any earlier Cimo optimization. Original EXIF\/GPS remains readable under the existing privacy settings. Restore before replacing or converting an attachment again. Missing or changed originals and stale comparison jobs stop the operation.<\/p>\n\n Administrator, media-upload and attachment-edit permissions plus a nonce are required. Processing is restricted to the current site. Each file must be local; conversion is limited to 100 physical files per attachment and 40 megapixels per file. Animated sources are left unchanged. Web Workers and WebAssembly must be allowed by the browser\/site policy. JPEG XL previews use the bundled decoder when native browser support is absent. Encoding uses 8-bit canvas pixels; HDR\/color-profile-preserving workflows are outside this version.<\/p>\n\n Original and converted files remain available after restoration for existing links. They are tracked for deletion when the attachment is permanently deleted. Temporary server uploads expire after two hours through WordPress cron. No ongoing synchronization runs. Optional pre-upload Cimo integration remains independent of these post-upload actions.<\/p>\n\n When the host cannot resize AVIF images, the browser automatically generates missing sizes during uploads. This works in the WordPress library and Enhanced Manager, including registered custom crops. Original AVIF files and their embedded EXIF stay unchanged; browser-generated copies omit EXIF. Keep the upload page open until processing finishes. Failed size generation can be retried without uploading the image again. Existing images can be repaired under Health > Missing image sizes. Local repair supports still AVIF originals up to 40 megapixels and 32 MB.<\/p>\n\n Works with any WordPress theme. Bricks 2.4 or later is optional and adds shared folders in the Bricks media manager and EXIF dynamic tags.<\/p>\n\n CIMO pre-upload optimization and Keep originals controls are available when CIMO Image Optimizer is active. Bricks dynamic data includes a Uplink Media Manager EXIF group for camera, lens, aperture, shutter speed, ISO, dates, dimensions, and other image fields. GPS tags are opt-in.<\/p>\n\n EtchWP users should use Uplink Media Bridge for Etch.<\/p>\n\n Import supports HappyFiles, Wicked Folders, Folders by Premio, Enhanced Media Library and WP Media Folder by JoomUnited. Copies include stored folder hierarchy, empty folders and optional attachment assignments. Stored records are detected even when the source plugin is inactive. Post and page folders and virtual dynamic folders are excluded. Source data is preserved unless optional cleanup is selected. Media files stay unchanged.<\/p>\n\n Imported folders use shared Uplink Media Manager permissions. Source access rules, ownership, colors, custom media ordering, galleries and shortcodes are not copied. No ongoing synchronization runs. Repeated imports reuse existing mappings. Pause and resume with the same administrator account; the job retains its source and original options.<\/p>\n\n Imports preserve source data by default. An unchecked import option can deactivate the selected site-active source and clear verified legacy media-folder data after a successful import with media assignments. On multisite, network activation stays enabled and cleanup affects only the current site.<\/p>\n\n Cleanup removes imported source folder terms, folder metadata and source assignments. It preserves files, attachments, Uplink Media Manager folders, plugin files, settings, licenses, and other content-type folders. Source galleries or shortcodes using cleared folders can stop working. A separate cleanup action is available after a fresh verified import for inactive or removed sources. Explicit consent, administrator permissions and a nonce are required. Cleanup stops when source records or imported assignments no longer match.<\/p>\n\n Settings and folder imports require administrator capabilities. Shared folder management requires manage_categories. Assigning media requires upload_files and edit permission for each attachment. Inspector, EXIF and gallery output respects private and password-protected parent posts. This does not restrict direct access to WordPress upload URLs.<\/p>\n\n Installation, usage, permissions, import and privacy instructions are included in this readme. The media manager works with any WordPress theme; Bricks integration is optional.<\/p>\n\n EXIF is read from locally stored WordPress media. GPS metadata is hidden by default. Enabling GPS displays locations in the media inspector and makes location tags available through the optional Bricks integration; adding those tags to public content can publish a photo's location. Map service requests occur only as described above. There is no plugin telemetry or external license-check service. Optional CIMO integration uses the separately installed CIMO plugin, whose own settings and policies apply. Deactivation and deletion retain folders, assignments, settings and metadata in WordPress.<\/p>\n\n Maps are optional. Both \"Include GPS coordinates and altitude\" and \"Enable external location maps\" must be enabled by an administrator under Media > Media Manager Settings > EXIF. GPS fields are disabled by default on new installations. External maps are disabled by default on new installations and upgrades until explicitly enabled. GPS fields and dynamic tags work without external maps.<\/p>\n\n When an authorized media user opens an EXIF inspector containing valid GPS coordinates and the map becomes visible, the browser requests satellite tiles from Esri. Selecting OpenStreetMap requests street tiles from the OpenStreetMap Foundation. Panning and zooming request further tiles from the selected provider. Hidden maps, images without GPS, and disabled map settings make no map-tile requests. Leaflet JavaScript, CSS, images and readable source are included locally in this plugin; they are not fetched from a CDN or the Bricks theme.<\/p>\n\n Tile requests disclose the viewer's IP address, browser\/request information and site origin to the selected provider. Tile addresses identify the viewed geographic area and zoom level, which can reveal the photo's approximate location. The plugin requests an origin-only cross-site referrer. Photo files, titles, captions, EXIF records, account details and WordPress credentials are not uploaded by this integration. Requests are made directly from the browser over HTTPS and follow the browser's normal cache behavior. The plugin does not prefetch tiles for offline use or run background map requests. Provider policies apply to their handling and retention of request data. This plugin does not provide a service-availability guarantee.<\/p>\n\n Provides the default satellite imagery from services.arcgisonline.com when the map is displayed. Source attribution remains visible on the map. Use of imagery is subject to Esri's terms and the service's access and usage conditions.<\/p>\n\n Provides the optional street layer from tile.openstreetmap.org after the user selects it. Attribution links to OpenStreetMap contributors and copyright information. The public tile service is subject to its usage policy and capacity limits; it is not an unlimited or offline tile service.<\/p>\n\n The \"Open in OpenStreetMap\" link opens www.openstreetmap.org only when clicked. Its URL includes the photo's GPS latitude and longitude, rounded to six decimal places. Opening that link discloses those coordinates and the browser's normal request information to OpenStreetMap.<\/p>\n\n The plugin ZIP includes the editable PHP, JavaScript and CSS source for all first-party code. In particular, assets\/gallery-lightbox.js is the original handwritten source, not a generated or minified bundle. Edit it directly; no npm, webpack, transpiler or other build step is required. First-party assets are served directly as shipped.<\/p>\n\n Public development repository: https:\/\/github.com\/stphnwlkr\/media-bridge-for-bricks<\/p>\n\n To create an installable package from the included source, place media-bridge-for-bricks.php, readme.txt, LICENSE and the includes, assets and blocks directories inside a media-bridge-for-bricks folder and ZIP that folder. Development tests and reports are not required at runtime.<\/p>\n\n Third-party compiled assets retain their upstream source, build and license references below and in their bundled SOURCES.md files. Browser Image Compression includes its readable original sources in its source map. Leaflet also includes leaflet-src.js.<\/p>\n\n jSquash WebP 1.5.0, AVIF 2.1.1 and JPEG XL 1.3.0 encoders are bundled locally in assets\/vendor\/jsquash, with the JPEG XL decoder for previews. They use Apache-2.0 wrappers and BSD codec licenses. Complete licenses and source\/build links are included in that directory's SOURCES.md. The .wasm files are required runtime codecs for local WebP, AVIF and JPEG XL encoding and JPEG XL preview decoding. They are loaded by image-encode-worker.js and the jSquash JavaScript wrappers, not server executables. License and patent notices are retained as .txt files. Single-thread WebAssembly codecs run in a local background worker. No external encoding service, CDN, Cimo Pro license or cross-origin isolation headers are required.<\/p>\n\n Browser Image Compression 2.0.2 is included in assets\/vendor\/browser-image-compression under the MIT license. It includes UPNG.js and UZIP.js, also under MIT licenses. Complete licenses and a source map containing readable sources are included in that folder. Upstream source and build instructions: https:\/\/github.com\/Donaldcwl\/browser-image-compression<\/p>\n\n The PNG compressor runs inside Uplink Media Manager's local worker with its own nested-worker mode disabled. It does not load a CDN or send images to an external service. Post-upload actions save through Uplink Media Manager's authenticated API and do not require Cimo Pro.<\/p>\n\n Leaflet 1.9.4 is included in assets\/vendor\/leaflet under the GPL-compatible BSD 2-Clause license. Copyright 2010-2023 Volodymyr Agafonkin and 2010-2011 CloudMade. The complete license is in assets\/vendor\/leaflet\/LICENSE; unmodified readable source is in leaflet-src.js, alongside the distributed JavaScript, source maps, CSS and images. No build step is needed to use these distributed files.<\/p>\n\n Lucide outline icons are included under ISC\/MIT licenses. Source revision and full license notices are included in assets\/vendor\/lucide\/. Web Awesome 3.14.0 Free is bundled locally with its license and source notices.<\/p>\n\n\n No. The media manager, folders, imports, compression, restoration, file replacement, EXIF inspector, optional maps and gallery blocks work in standard WordPress. Bricks 2.4 or later adds integration with its media manager and dynamic-data picker.<\/p><\/dd>\n No. Media files stay in WordPress.<\/p><\/dd>\n No ongoing synchronization runs. Import copies supported source folders and optional media assignments. Choose Uplink Media Manager under Folder behavior to use the imported folders in Bricks; otherwise Bricks' automatic selection can use HappyFiles.<\/p><\/dd>\n The plugin preserves its folders, assignments, settings, and metadata.<\/p><\/dd>\n\n<\/dl>\n\n\n Adds missing-size repair for existing images in Media Health. Preserves original AVIF files and EXIF, and validates attachment permissions and generated files.<\/p><\/li>\n Fixes dialog and lightbox keyboard focus, background isolation, inspector keyboard scrolling, and accessibility labels. Uses Media Manager Settings for settings links.<\/p><\/li>\n Restores Show EXIF in inspector in Enhanced display options and adds an administrator-controlled default on the EXIF settings tab.<\/p><\/li>\n Renames the plugin Uplink Media Manager and enables its WordPress features with any theme. Bricks integration is optional. Existing folder records, settings, shortcodes and block identifiers are retained.<\/p><\/li>\n Fixes activation without Bricks, guards all required provider interfaces, uses the WordPress file uploader for conversion staging and bounds serialized reference traversal.<\/p><\/li>\n Documents bundled editable source and limits notification assets to supported media and editor screens.<\/p><\/li>\n Ports the Enhanced Manager interface and fixes from Etch 2.7.0, with local Web Awesome controls, consistent spacing, joined button groups, unified search and corrected input styling.<\/p><\/li>\n Adds Google Maps and Apple Maps links to photo-location maps and loads maps when opening Enhanced from the WordPress-default workflow.<\/p><\/li>\n Adds All sizes, Main image only and Selected sizes with custom-size coverage, reversible partial conversion, and locally bundled Web Awesome controls.<\/p><\/li>\n Adds preview-first image comparisons with per-format quality sliders and larger before-and-after previews.<\/p><\/li>\n[uplink_mbb_gallery collection=\"folder-slug\"]<\/code>. Earlier beta shortcodes remain supported when their legacy name is available. Disable the blocks under Media Manager Settings if they are not needed. Saved content remains in WordPress while disabled.<\/p>\n\nMedia library and folders<\/h4>\n\n
Image optimization and restoration<\/h4>\n\n
Automatic AVIF image sizes and media health<\/h4>\n\n
Optional Bricks and CIMO integration<\/h4>\n\n
Folder imports<\/h4>\n\n
Legacy folder cleanup<\/h4>\n\n
Permissions<\/h4>\n\n
Documentation<\/h4>\n\n
Privacy<\/h4>\n\n
External services<\/h4>\n\n
Esri World Imagery<\/h4>\n\n
\n
OpenStreetMap<\/h4>\n\n
\n
Source code and builds<\/h4>\n\n
Third-party libraries<\/h4>\n\n
\n
Third-party licenses<\/h4>\n\n
\n
\n
Do I need Bricks?<\/h3><\/dt>\n
Does deleting a folder delete its files?<\/h3><\/dt>\n
Does it synchronize HappyFiles folders?<\/h3><\/dt>\n
What happens when I deactivate or delete the plugin?<\/h3><\/dt>\n
1.1.0<\/h4>\n\n
\n
1.0.0<\/h4>\n\n
\n
1.0.0-beta.15<\/h4>\n\n
\n
1.0.0-beta.14<\/h4>\n\n
\n
1.0.0-beta.13<\/h4>\n\n
\n
1.0.0-beta.12<\/h4>\n\n
\n
1.0.0-beta.11<\/h4>\n\n
\n
1.0.0-beta.10<\/h4>\n\n
\n
1.0.0-beta.9<\/h4>\n\n
\n
1.0.0-beta.8<\/h4>\n\n
\n
1.0.0-beta.7<\/h4>\n\n
\n
1.0.0-beta.6<\/h4>\n\n
\n
1.0.0-beta.5<\/h4>\n\n
\n
1.0.0-beta.4<\/h4>\n\n
\n
1.0.0-beta.3<\/h4>\n\n
\n
1.0.0-beta.2<\/h4>\n\n
\n
1.0.0-beta.1<\/h4>\n\n
\n