Merge branch 'dev'

Author: fjb2020

.gitignore

@@ -17,4 +17,9 @@ piwigoPublish.lrplugin/PiwigoHelper.lua
 cat layout.odt
 deploy.sh
 diagnostic.txt
-copilot-instructions.md
+copilot-instructions.md
+
+# i18n
+localize_plugin.py
+extract_localizable_strings.py
+localization_report.txt

Auto_update_documentation.md

@@ -0,0 +1,129 @@
+# Auto-Update System for PiwigoPublish Plugin
+
+By Gotcha26 - contact@julien-moreau.fr
+
+## Overview
+
+The auto-update system allows the PiwigoPublish Lightroom plugin to check for new versions via the GitHub Releases API and notify users when updates are available.
+
+## Features
+
+- **Automatic check on startup**: Silent check when Lightroom loads (once per day)
+- **Manual check**: Button in Plugin Manager to check on demand
+- **Multi-format versioning**: Supports both date-based and SemVer formats
+- **Cross-format comparison**: Can compare versions even when switching versioning schemes
+- **User-friendly notifications**: Dialog with changelog and download link
+
+## Version Format Support
+
+| Format | Example | Use Case |
+|--------|---------|----------|
+| Date-based | `20260121.3` or `v20260121.3` | Current format, revision incremented daily |
+| SemVer | `1.2.3` or `v1.2.3` | Industry standard, for future migration |
+
+The system automatically detects which format is used and applies the appropriate comparison logic.
+
+### Cross-Format Comparison
+
+When the local and remote versions use different formats, the system falls back to comparing the **GitHub release publish date** (`published_at` metadata) against the **build date** embedded in the local version.
+
+This ensures seamless updates even if the versioning scheme changes in the future.
+
+## Configuration
+
+In `UpdateChecker.lua`, the following constants can be adjusted:
+
+```lua
+UpdateChecker.GITHUB_OWNER = "Piwigo"           -- GitHub organization/user
+UpdateChecker.GITHUB_REPO = "PiwigoPublish-lrc-plugin"  -- Repository name
+UpdateChecker.CHECK_INTERVAL_DAYS = 1           -- Days between automatic checks
+```
+
+## User Interface
+
+### Plugin Manager Section
+
+A new "Plugin Updates" section appears in **File > Plug-in Manager > Piwigo Publisher**:
+
+- Current version display
+- Update status indicator
+- "Check for Updates" button
+- "Visit GitHub Repository" button
+
+### Update Notification Dialog
+
+When an update is available, users see:
+
+- Current vs. new version comparison
+- Changelog excerpt (first 500 characters)
+- "Download" button → opens GitHub release page
+- "Later" button → dismisses until next check
+
+## Creating a New Release
+
+1. Update `VERSION` in `Info.lua`:
+   ```lua
+   VERSION = { major=20260122, minor=1, revision=0 },
+   ```
+
+2. Commit and push changes
+
+3. Create a GitHub Release:
+   - **Tag**: `v20260122.1` (or `v1.0.0` for SemVer)
+   - **Title**: Version number or descriptive title
+   - **Description**: Changelog in Markdown format
+
+4. The plugin will automatically detect the new release
+
+## Technical Details
+
+### API Endpoint
+
+```
+GET https://api.github.com/repos/{owner}/{repo}/releases/latest
+```
+
+### Response Fields Used
+
+| Field | Purpose |
+|-------|---------|
+| `tag_name` | Version identifier |
+| `published_at` | Release date (ISO 8601) for cross-format comparison |
+| `body` | Changelog content (Markdown) |
+| `html_url` | Download page URL |
+
+### Storage (LrPrefs)
+
+| Key | Purpose |
+|-----|---------|
+| `lastUpdateCheck` | Timestamp of last check |
+| `latestVersion` | Cached latest version string |
+| `latestVersionUrl` | Cached download URL |
+| `pluginBuildDate` | Build date for SemVer installations |
+
+## Functions Reference
+
+| Function | Description |
+|----------|-------------|
+| `parseVersion(versionStr)` | Converts version string to comparable number |
+| `parseGitHubDate(dateStr)` | Parses ISO 8601 date to timestamp |
+| `getInstalledVersionDate()` | Extracts build date from installed version |
+| `shouldCheckForUpdates()` | Checks if interval has elapsed |
+| `checkForUpdates(silent)` | Main update check logic |
+| `openDownloadPage(url)` | Opens browser to download page |
+| `getUpdateStatus()` | Returns status string for UI |
+
+## Future Considerations
+
+- **Migration to SemVer**: The system is ready for a versioning scheme change without breaking update detection
+- **Pre-release support**: Could be extended to check for beta/RC releases via `prerelease` flag
+- **Auto-download**: Could be enhanced to download and extract updates automatically (requires additional permissions)
+
+## Files Modified
+
+| File | Changes |
+|------|---------|
+| `UpdateChecker.lua` | New file - update checking logic |
+| `Init.lua` | Added require and startup check |
+| `PluginInfoDialogSections.lua` | Added "Plugin Updates" UI section |
+| `Info.lua` | VERSION table (existing, used as source of truth) |

README.md

@@ -22,10 +22,12 @@ You should have received a copy of the GNU General Public License along with thi
 
 As a user of both Lightroom Classic and Piwigo, the ability use the powerful Publishing Service in LrC to keep my Piwigo galleries up to date is very appealing. I've been a long time user of a popular plugin that has been providing this functionality, but unfortunately since the version 15 release of LrC that has not been available. 
 
-This plugin is my attempt to allow me to continue publishing to Piwigo from LrC, and I have looked at the work of others for help and ideas in developing this plugin. In particular, the following should be credited:
+This plugin was developed to allow me to continue publishing to Piwigo from LrC, and I have looked at the work of others for help and ideas in developing this plugin. In particular, the following should be credited:
 
 [All the contributers to Piwigo](https://piwigo.org/)
 
+[Julien Moreau for contributing various improvements](https://julien-moreau.fr/)
+
 [Jeffrey Friedl for JSON.lua](http://regex.info/blog/lua/json)
 
 [Bastian Machek with his Immich Plugin](https://github.com/bmachek/lrc-immich-plugin)

piwigoPublish.lrplugin/Info.lua

@@ -25,7 +25,6 @@ return {
     LrPluginName = "Piwigo Publisher",
     -- typo in PwigoPublish is noted but can't be changed without forcing all services using this plugin to be re-initialised.
     LrToolkitIdentifier = "fiona.boston.PwigoPublish",
-    -- LrToolkitIdentifier = "fiona.boston.PiwigoPublish",
     LrMetadataProvider  = 'CustomMetadata.lua',
     LrMetadataTagsetFactory = 'Tagset.lua',
     LrInitPlugin = "Init.lua",
@@ -67,5 +66,5 @@ return {
 
 	LrPluginInfoProvider = 'PluginInfo.lua',
 
-    VERSION = { major=20260122, minor=27, revision=0 },
+    VERSION = { major=20260124, minor=28, revision=0 },
 }

piwigoPublish.lrplugin/Init.lua

@@ -73,6 +73,28 @@ else
 end
 
 _G.iconPath = _PLUGIN:resourceId("icons/icon_med.png")
-_G.pluginVersion = "20260122.27"
---_G.LocStrings = utils.loadStrings()
+
+-- Build version string from Info.lua VERSION table
+--local versionInfo = _PLUGIN.VERSION or { major = 0, minor = 0, revision = 0 }
+-- _PLUGIN.VERSION is nil here for some reason, so hardcoding for now
+-- just need to ensure both places are updated together
+
+_G.versionInfo = { major=20260122, minor=27, revision=0 }
+
+_G.pluginVersion = string.format("%d.%d", versionInfo.major, versionInfo.minor)
+-- Auto-update checker
+_G.UpdateChecker = require "UpdateChecker"
+
+-- Check for updates on plugin load (silent check)
+LrTasks.startAsyncTask(function()
+    -- Wait for Lightroom to fully load
+    LrTasks.sleep(5)
+    
+    -- Only check if interval has passed
+    if UpdateChecker.shouldCheckForUpdates() then
+        log:info("Init - performing automatic update check")
+        UpdateChecker.checkForUpdates(true) -- silent = true
+    end
+end)
+