內容簡介
Gallery for Immich 可將自架的 Immich 照片伺服器與 WordPress 網站整合，透過短代碼或 Gutenberg 區塊輕鬆展示精美的相簿與照片圖庫，適合攝影作品集、家庭相簿及旅遊部落格使用。
【主要功能】
• 支援 Gutenberg 區塊編輯器視覺化操作
• 提供短代碼顯示相簿或單張照片
• 響應式網格排版與 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, proxy via fopen, or ignore videos)
Flexible sorting options (date/name, ascending/descending)
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.
Customize sizes:
[gallery_for_immich size=”300″ title_size=”18″ description_size=”15″ date_size=”12″]
Size options:
* size – Thumbnail size in pixels (100-500, 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)
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.
Privacy & Security
This plugin:
* Connects to your self-hosted Immich server via API
* Does not collect or transmit any user data to third parties
* Requires HTTPS for production security
* 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.
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)
