外掛標籤
開發者團隊
原文外掛簡介
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.
Organize media in nested folders with bulk assignment and custom image order.
Choose the enhanced media manager or the standard WordPress library with folder controls.
Add Gallery and Slideshow displays in the WordPress block editor.
Compare and optimize WebP, AVIF and JPEG XL locally, with backups and restoration.
Edit and replace images, view EXIF metadata, manage alt text, and check media health.
Import existing folders from HappyFiles, Wicked Folders and other supported media plugins.
Gallery and Slideshow in the block editor
Add Uplink Media Manager Gallery or Uplink Media Manager Slideshow from the block inserter. Slideshow is included as a Gallery block variation.
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.
For shortcode contexts, use [uplink_mbb_gallery collection="folder-slug"]. 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.
Media library and folders
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.
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.
The settings screen includes tabs, cards, appearance controls and floating save controls.
Image optimization and restoration
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.
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.
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.
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.
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.
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.
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.
Automatic AVIF image sizes and media health
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.
Optional Bricks and CIMO integration
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.
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.
EtchWP users should use Uplink Media Bridge for Etch.
Folder imports
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.
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.
Legacy folder cleanup
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.
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.
Permissions
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.
Documentation
Installation, usage, permissions, import and privacy instructions are included in this readme. The media manager works with any WordPress theme; Bricks integration is optional.
Privacy
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.
External services
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.
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.
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.
Esri World Imagery
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.
Service: https://services.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer
Terms: https://www.esri.com/en-us/legal/terms/web-site-service
Privacy: https://www.esri.com/en-us/privacy/privacy-statements/privacy-statement
Products and services privacy supplement: https://www.esri.com/en-us/privacy/privacy-statements/privacy-supplement
OpenStreetMap
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.
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.
Service: https://www.openstreetmap.org/
Tile usage policy: https://operations.osmfoundation.org/policies/tiles/
Copyright and license: https://www.openstreetmap.org/copyright
Privacy: https://osmfoundation.org/wiki/Privacy_Policy
Terms: https://osmfoundation.org/wiki/Terms_of_Use
Source code and builds
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.
Public development repository: https://github.com/stphnwlkr/media-bridge-for-bricks
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.
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.
Third-party libraries
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.
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
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.
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.
Project: https://leafletjs.com/
Source: https://github.com/Leaflet/Leaflet/tree/v1.9.4
Official release package: https://registry.npmjs.org/leaflet/-/leaflet-1.9.4.tgz
Third-party licenses
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.
