Title: Gallery for Immich Author: sietsevisser Published: 2025 年 12 月 9 日 Last modified: 2026 年 4 月 13 日 --- 搜尋外掛 ![](https://ps.w.org/gallery-for-immich/assets/icon-128x128.png?rev=3415538) # Gallery for Immich 由 [sietsevisser](https://profiles.wordpress.org/sietsevisser/) 開發 [下載](https://downloads.wordpress.org/plugin/gallery-for-immich.0.7.0.zip) * [詳細資料](https://tw.wordpress.org/plugins/gallery-for-immich/#description) * [使用者評論](https://tw.wordpress.org/plugins/gallery-for-immich/#reviews) * [安裝方式](https://tw.wordpress.org/plugins/gallery-for-immich/#installation) * [開發資訊](https://tw.wordpress.org/plugins/gallery-for-immich/#developers) [技術支援](https://wordpress.org/support/plugin/gallery-for-immich/) ## 外掛說明 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: 1. Add a new block and search for “Gallery for Immich” 2. Select your display mode (all albums, single album, multiple albums, or single photo) 3. Configure display options using the sidebar controls 4. Customize thumbnail size and text sizes as needed 5. 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) ## 適用於區塊編輯器 這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。 * Gallery for Immich Display photos and albums from your Immich server ## 安裝方式 1. Install via WordPress admin: Plugins > Add New > Search for “Gallery for Immich” 2. Click “Install Now” and then “Activate” 3. Or upload the plugin files to `/wp-content/plugins/gallery-for-immich/` directory and activate through the ‘Plugins’ menu **Configuration:** After activation, configure your Immich server connection: **Step 1: Create an Immich API Key** 1. Log in to your Immich server with the user account whose photos you want to display 2. Go to **Account Settings** (click your profile picture in the top right) 3. Navigate to **API Keys** tab 4. Click **New API Key** 5. Give it a descriptive name (e.g., “WordPress Plugin”) 6. Set the following **minimum required permissions**: 7. * `album.read` – Required to list and view albums * `asset.read` – Required to access photo metadata (EXIF data, descriptions, dates) * `asset.view` – Required to retrieve photo thumbnails * `sharedLink.create` – Required when using video mode ‘Shared Link’ * `sharedLink.delete` – Required when using video mode ‘Shared Link’ 8. **Important:** Only grant read-only access. Never grant write permissions for security reasons. 9. Click **Create** and copy the generated API key **Step 2: Configure the Plugin in WordPress** 1. Navigate to Settings > Gallery for Immich in your WordPress admin 2. Enter your Immich server URL (e.g., https://immich.example.com) 3. Paste the API key you created in Step 1 4. Choose **Video playback** mode (shared links, proxy via fopen, or ignore videos) 5. Save changes **Video playback modes:** * **Shared links (default)** – Creates temporary shared links on Immich. Videos stream directly from Immich and links expire automatically. * **Proxy via fopen** – Streams videos through WordPress. Most elegant solution, but requires `fopen` support on the WordPress server which is not always supported. * **Ignore videos** – Hides videos in galleries and only shows photos. ## 常見問題集 ### What is Immich? Immich is a self-hosted photo and video backup solution. Learn more at https://immich. app ### Do I need my own Immich server? Yes, this plugin requires a running Immich server with API access. ### How do I find my album or photo IDs? You can find IDs in your Immich server’s URL when viewing albums or photos, or through the Immich API. ### Does this work with localhost? Yes, for development purposes localhost URLs (http://localhost or http://127.0.0.1) are allowed. Production servers must use HTTPS. ### Can I customize the appearance? Yes, the plugin generates standard HTML with CSS classes. You can override styles in your theme’s CSS. ### Is the plugin translated? Yes, the plugin is fully internationalized and includes translations for: * Dutch( nl_NL) – Nederlands * German (de_DE) – Deutsch * French (fr_FR) – Français Additional translations can be contributed via .po files in the languages directory. ## 使用者評論 ![](https://secure.gravatar.com/avatar/97d30260ebc038539e8b5426fc39f631125b21a4706eec93bb6f76a9a427633a? s=60&d=retro&r=g) ### 󠀁[It works](https://wordpress.org/support/topic/it-works-2604/)󠁿 [avs0153](https://profiles.wordpress.org/avs0153/) 2026 年 3 月 31 日 thx ![](https://secure.gravatar.com/avatar/60be139630c4da4604dc30ae479bfb71d4f850f7cf89a29ed6f602d8ee0577ce? s=60&d=retro&r=g) ### 󠀁[A Great Photo Gallery Plugin for Self-Hosted Images](https://wordpress.org/support/topic/a-great-photo-gallery-plugin-for-self-hosted-images/)󠁿 [mstewart14](https://profiles.wordpress.org/mstewart14/) 2025 年 12 月 16 日 1 則留言 Since I started running Immich (self-hosted photo server, drop in replacement for google photos) I’ve been looking for a way to use Immich to serve images for Wordpress. This plugin solves the problem almost completely. The images stay on your Immich server and show quite promptly (depending on your setup) in Wordpress, one at a time or albums at a time. There are a bunch of tweaks to include additional data including descriptions, titles, dates etc. I’ve found it very useful. Currently it doesn’t show videos so ensure the albums you load don’t have videos. [ 閱讀全部 2 則使用者評論 ](https://wordpress.org/support/plugin/gallery-for-immich/reviews/) ## 參與者及開發者 以下人員參與了開源軟體〈Gallery for Immich〉的開發相關工作。 參與者 * [ sietsevisser ](https://profiles.wordpress.org/sietsevisser/) 〈Gallery for Immich〉外掛目前已有 1 個本地化語言版本。 感謝[全部譯者](https://translate.wordpress.org/projects/wp-plugins/gallery-for-immich/contributors) 為這個外掛做出的貢獻。 [將〈Gallery for Immich〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/gallery-for-immich) ### 對開發相關資訊感興趣？ 任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/gallery-for-immich/)、 查看 [SVN 存放庫](https://plugins.svn.wordpress.org/gallery-for-immich/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/gallery-for-immich/?limit=100&mode=stop_on_copy&format=rss) 訂閱[開發記錄](https://plugins.trac.wordpress.org/log/gallery-for-immich/)。 ## 變更記錄 #### 0.7.0 _Release Date – 13 April 2026_ * New: Apple Live Photos support — play button in the lightbox for photos with a Live Photo video component * New: Connection & permissions check button on the settings page * New: HTTP server URLs are now allowed (with a confirmation warning modal) * Removed: `asset.download` is no longer a required API permission #### 0.6.1 * Fix for missing album list. #### 0.6.0 _Release Date – 16 February 2026_ * New: Video playback modes (shared links, proxy via fopen, ignore videos) * Improved: Video handling for editor/preview and shared link cleanup #### 0.5.0 * Release date 17 December 2025* * New: Support for videos from Immich * For single asset: define alignment to allow text around the asset #### 0.4.0 _Release Date – 10 December 2025_ * New: Gutenberg block “Gallery for Immich” with visual editor * New: Full Gutenberg block support with all shortcode features * New: Full translation support for Dutch, German, and French #### 0.3.3 _Release Date – 9 December 2025_ * WordPress.org compliance improvements * Fixed: Removed direct file access * Fixed: Added translation support for plugin name and description * Updated: License changed to GPLv3 for consistency * Improved: Image proxy now uses query parameters instead of direct PHP files * Improved: glightbox in its own namespace #### 0.3.1 _Release Date – 29 November 2025_ * Added flexible sorting with order parameter (none, date_asc, date_desc, name_asc, name_desc) * Albums can be sorted by date or name, ascending or descending * Photos can be sorted by date (ascending/descending) or use Immich’s original order * Default sorting: albums newest first (date_desc), photos oldest first (date_asc/ chronological) * Uses standard database terminology (asc/desc) * WordPress.org compliance: bundled GLightbox locally (no CDN dependencies) * Removed load_plugin_textdomain() – WordPress.org handles translations automatically * Removed debug error_log() calls for production * Full WordPress Plugin Check compliance with zero errors * Ready for WordPress.org plugin directory submission #### 0.3.0 _Release Date – 29 November 2025_ * WordPress.org compliance: bundled GLightbox locally (no CDN dependencies) * Removed load_plugin_textdomain() – WordPress.org handles translations automatically * Removed debug error_log() calls for production * Full WordPress Plugin Check compliance with zero errors * Ready for WordPress.org plugin directory submission #### 0.3.0 _Release Date – 29 November 2025_ * Disabled zoom functionality in lightbox (removed confusing zoom icon) * Improved lightbox user experience with cleaner interface * Code hardening for enhanced security * Enhanced documentation with API key setup instructions * Added security and privacy information in README * Added access control documentation * Updated installation instructions with detailed API key permissions #### 0.2.1 _Release Date – 29 November 2025_ * Enhanced security: UUID validation for all IDs * Added HTTPS enforcement for production * Improved input sanitization and validation * Added timeout settings for API requests * SSL verification enabled * Better error handling and logging * Security headers for image proxies * Sanitization callbacks for settings * Capability checks for admin access #### 0.2.0 _Release Date – 27 September 2025_ * Added photo sorting by dateTimeOriginal (chronological order) * Added album sorting by endDate (newest first) * Improved photo descriptions in lightbox * Added EXIF date display * Enhanced grid layouts with CSS Grid * Added hover effects and animations * Portrait photo support with object-fit #### 0.1.0 _Release Date – September 2025_ * Initial release * Basic album and photo display * GLightbox integration * Shortcode support * Internationalization support * Dutch translation included ## 中繼資料 * 版本 **0.7.0** * 最後更新 **6 天前** * 啟用安裝數 **60+** * WordPress 版本需求 ** 5.8 或更新版本 ** * 已測試相容的 WordPress 版本 **6.9.4** * PHP 版本需求 ** 7.4 或更新版本 ** * 語言 * [Dutch](https://nl.wordpress.org/plugins/gallery-for-immich/) 及 [English (US)](https://wordpress.org/plugins/gallery-for-immich/). * [將這個外掛本地化為你的母語版本](https://translate.wordpress.org/projects/wp-plugins/gallery-for-immich) * 標籤 * [albums](https://tw.wordpress.org/plugins/tags/albums/)[gallery](https://tw.wordpress.org/plugins/tags/gallery/) [immich](https://tw.wordpress.org/plugins/tags/immich/)[lightbox](https://tw.wordpress.org/plugins/tags/lightbox/) [photos](https://tw.wordpress.org/plugins/tags/photos/) * [進階檢視](https://tw.wordpress.org/plugins/gallery-for-immich/advanced/) ## 評分 5 星，滿分為 5 星 * [ 2 個 5 星使用者評論 ](https://wordpress.org/support/plugin/gallery-for-immich/reviews/?filter=5) * [ 0 個 4 星使用者評論 ](https://wordpress.org/support/plugin/gallery-for-immich/reviews/?filter=4) * [ 0 個 3 星使用者評論 ](https://wordpress.org/support/plugin/gallery-for-immich/reviews/?filter=3) * [ 0 個 2 星使用者評論 ](https://wordpress.org/support/plugin/gallery-for-immich/reviews/?filter=2) * [ 0 個 1 星使用者評論 ](https://wordpress.org/support/plugin/gallery-for-immich/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/gallery-for-immich/reviews/#new-post) [查看全部使用者評論](https://wordpress.org/support/plugin/gallery-for-immich/reviews/) ## 參與者 * [ sietsevisser ](https://profiles.wordpress.org/sietsevisser/) ## 技術支援 最近 2 個月解決的問題: 總計 3 個問題，已解決 2 個 [檢視技術支援論壇](https://wordpress.org/support/plugin/gallery-for-immich/)