Skip to content

Conversation

@soderlind
Copy link
Owner

This pull request introduces automatic update support for the plugin by integrating the Plugin Update Checker library, enabling seamless updates directly from GitHub releases. It also adds new GitHub Actions workflows for building release zip files, updates documentation to reflect the new update mechanism, and bumps the plugin version to 1.1.0.

Automatic update integration:

  • Added the yahnis-elsts/plugin-update-checker library as a Composer dependency and implemented a new GitHub_Plugin_Updater class in class-github-plugin-updater.php to handle update checks and notifications from GitHub releases. The updater is initialized in custom-document-folder.php. [1] [2] [3]
  • Updated plugin version to 1.1.0 in custom-document-folder.php, readme.txt, and updated changelogs to reflect the new release and features. [1] [2] [3] [4] [5] [6]

Release automation:

  • Added .github/workflows/on-release-add.zip.yml to automatically build and attach a release zip file when a new release is published.
  • Added .github/workflows/manually-build-zip.yml to allow manual building and uploading of release zip files via workflow dispatch.

Documentation and funding:

  • Updated installation instructions in README.md to highlight the new automatic update process and simplified installation steps.
  • Added .github/FUNDING.yml to support various sponsorship platforms.

- Introduced a new file `PucReadmeParser.php` in the vendor directory of the yahnis-elsts/plugin-update-checker package.
- The `PucReadmeParser` class is designed to parse WordPress plugin readme files, providing structured access to metadata such as plugin name, description, installation instructions, FAQs, changelog, and more.
- The parser utilizes Parsedown for Markdown processing, replacing the previous "Markdown Extra" parser.
- Key functionalities include:
  - Reading and sanitizing the readme file content.
  - Extracting essential fields like plugin name, required PHP version, stable tag, tags, contributors, and donation link.
  - Handling special sections like description, installation, FAQs, screenshots, and changelog.
  - Supporting short descriptions and managing content truncation.
  - Implementing a robust filtering mechanism to ensure safe HTML output.
- This addition enhances the plugin update checker functionality by allowing it to read and interpret plugin metadata directly from the readme files, improving the overall update experience.
@soderlind soderlind merged commit 47a0e44 into main Nov 25, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants