內容簡介
Gallery for Immich 是一款 WordPress 外掛，能夠無縫整合自架設的 Immich 照片伺服器，讓使用者透過簡單的短碼顯示美麗的照片畫廊和相簿，提升網站的視覺效果。
【主要功能】
• 支援 Gutenberg 區塊編輯器，視覺化選擇相簿和照片
• 短碼支援，適用於任何編輯器
• 顯示 Immich 的相簿列表和完整相簿
• 美觀的響應式網格佈局
• 整合 GLightbox 的燈箱效果
• 照片和影片的靈活排序選項
外掛標籤
開發者團隊
原文外掛簡介
Gallery for Immich is a WordPress plugin that seamlessly integrates your self-hosted Immich photo server with your WordPress site. Display beautiful photo galleries and albums using simple shortcodes.
Key Features:
Gutenberg Block Editor – Visual block for selecting albums, photos and settings
Shortcode Support – Classic [gallery_for_immich] shortcode for any editor
Display list of albums from Immich
Display entire albums from Immich
Beautiful responsive grid layouts
Integrated lightbox with GLightbox
Video playback modes (shared links, stream through WordPress, or ignore videos)
Photos and videos on password-protected and private pages are only shown to visitors who may see the page
Caching of album lists, album contents and photo details, with a button to clear the cache
Flexible sorting options (date/name, ascending/descending)
Limit the number of albums or photos shown, either the first ones or a random selection
Single photo embedding – Display one photo with alignment (left/right/center) and configurable link behavior (lightbox, no link, or custom URL)
Full internationalization support (Dutch, German, French translations)
Configure Immich server URL and API key in the WordPress admin panel
Perfect for:
Photography portfolios
Family photo sharing
Event galleries
Travel blogs
Any self-hosted photo management with Immich
Usage
Using the Gutenberg Block Editor:
The easiest way to add an Immich gallery is through the Gutenberg block editor:
Add a new block and search for “Gallery for Immich”
Select your display mode (all albums, single album, multiple albums, or single photo)
Configure display options using the sidebar controls
Customize thumbnail size and text sizes as needed
The preview shows the shortcode that will be used
Using Shortcodes:
You can also use shortcodes directly in your content:
Display all albums:
[gallery_for_immich]
Display specific albums (comma-separated IDs):
[gallery_for_immich albums=”album-id-1,album-id-2″]
Display single album:
[gallery_for_immich album=”album-id”]
Display single photo:
[gallery_for_immich asset=”photo-id”]
Customize display options:
[gallery_for_immich show=”gallery_name,asset_description”]
Available show options (no defaults – must be explicitly specified):
* gallery_name – Show album/gallery name
* gallery_description – Show album description
* asset_date – Show photo date
* asset_description – Show photo description
Note: If the show parameter is not specified, only thumbnails are displayed without any text.
Different texts on the album page:
[gallery_for_immich show=”gallery_name” detail_show=”gallery_name,gallery_description,asset_date”]
When a visitor clicks an album in an overview, the album opens with the same show options. detail_show sets different options for that album page, using the same values as show. detail_show="" shows no text there; without detail_show, show applies to both.
Customize sizes:
[gallery_for_immich size=”300″ title_size=”18″ description_size=”15″ date_size=”12″]
Size options:
* size – Thumbnail size for albums (100-500, default: 200); max-width for single photos (100-1200, default: 200)
* title_size – Title font size (10-30, default: 16)
* description_size – Description font size (10-30, default: 14)
* date_size – Date font size (10-30, default: 13)
Single photo alignment and link behavior:
[gallery_for_immich asset=”photo-id” align=”left” link=”none”]
[gallery_for_immich asset=”photo-id” align=”right” link=”https://example.com”]
Align options: left, right, center (default: no float)
Link options: lightbox (default — opens in overlay), none (no link), or any https://... URL
Link target (custom URL only): new (default — opens in a new tab) or same (opens in the current tab)
[gallery_for_immich asset=”photo-id” link=”https://example.com/page” link_target=”same”]
Sort order:
[gallery_for_immich order=”date_desc”]
[gallery_for_immich album=”album-id” order=”description_asc”]
Available order options:
* date_desc – Newest first (default for albums)
* date_asc – Oldest first (default for photos – chronological order)
* name_asc – Alphabetically A-Z (albums only)
* name_desc – Alphabetically Z-A (albums only)
* description_asc – Alphabetically A-Z by description (photos only)
* description_desc – Alphabetically Z-A by description (photos only)
Note: Name sorting is only available for albums. Photos can be sorted by date or description.
Limit the number of albums or photos:
[gallery_for_immich album=”album-id” limit=”10″ order=”date_desc”]
[gallery_for_immich limit=”3″ pick=”random”]
limit – Maximum number of albums (overview) or photos (album), 1-1000. Omit to show all.
pick – first (default) takes the first ones in the sort order; random shows a random selection, still displayed in the sort order
For albums sorted by date, or with pick="random", only the requested photos are fetched from Immich. An album opened from a limited overview still shows all of its photos.
Show the latest photo of an album, linking to your gallery page:
[gallery_for_immich album=”album-id” limit=”1″ order=”date_desc” link=”https://example.com/gallery” link_target=”same”]
link and `link_target` work for albums with the same values as for single photos. A custom URL applies to every photo in the album; album overviews are not affected.
Privacy & Security
This plugin:
* Connects to your self-hosted Immich server via API
* Does not collect or transmit any user data to third parties
* Warns when the connection to Immich is not encrypted (HTTP instead of HTTPS)
* Validates all user input and API parameters
* Uses WordPress security best practices
Your Immich server credentials (URL and API key) are stored in your WordPress database. Cached album and photo details from Immich (names, descriptions, dates, IDs) are stored there too, as transients that expire after the configured cache time. No location or camera data is cached.
Support
For issues, feature requests, or contributions, please visit:
https://github.com/vogon1/immich-wordpress-plugin
Credits
Lightbox powered by GLightbox (https://github.com/biati-digital/glightbox)
Integrates with Immich (https://immich.app)
