This commit is contained in:
Javier Casares 2026-08-17 17:56:43 +00:00
commit 3a25585090
42 changed files with 1124 additions and 711 deletions

View file

@ -1,10 +1,10 @@
=== Documentation Markdown (by ROBOTSTXT) ===
Contributors: robotstxt
Contributors: robotstxt, javiercasares
Tags: github, documentation, markdown, sync, automation
Requires at least: 6.8
Requires at least: 4.2
Tested up to: 7.1
Requires PHP: 8.0
Stable tag: 1.2.0
Stable tag: 1.2.1
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
@ -45,10 +45,14 @@ Synchronize Markdown documentation from GitHub repositories to WordPress pages a
= Requirements =
* PHP 8.0 or higher
* WordPress 6.8 or higher
* WordPress 4.2 or higher
* GitHub Personal Access Token (free, for accessing repositories)
* Composer (for production build with dependencies)
= Updates =
Automatic updates for this plugin are delivered through the [Manager (by ROBOTSTXT)](https://www.robotstxt.software/plugins/robotstxt-manager/) plugin. Install and activate Manager to receive update notifications.
= Security =
* GitHub tokens encrypted at rest (AES-256-CBC)
@ -178,12 +182,34 @@ Then go to Documentation → Settings, and you'll see a "Debug Tools" section at
== Compatibility ==
* WordPress: 6.8 - 7.1
* WordPress: 4.2 - 7.1
* PHP: 8.0 - 8.5
== Changelog ==
For the complete changelog, see [changelog.txt](https://git.robotstxt.es/ROBOTSTXT/robotstxt-documentation-markdown/raw/branch/main/changelog.txt).
For the complete changelog, see [changelog.txt](https://www.robotstxt.software/plugins/robotstxt-documentation-markdown/).
= 1.2.1 - 2026-08-17 =
**Changed**
* Automatic updates are now delivered through the Manager (by ROBOTSTXT) plugin: the built-in self-updater (`class-robotstxt-updater.php` and `update.json`) has been removed
* When the Manager plugin is not active, a dismissible notice on the Plugins page and a permanent notice on the plugin Settings page recommend installing it
* Minimum WordPress lowered to 4.2 — the real lowest version the code runs on, verified with WP-Compat (`wp_delete_file()`, available since 4.2, is the oldest API used)
* Plugin URI and Update URI now point to https://www.robotstxt.software/plugins/robotstxt-documentation-markdown/
**Security**
* league/commonmark updated to 2.10.0 (via `composer update`)
**Compatibility**
* WordPress: 4.2 - 7.1
* PHP: 8.0 - 8.5
**Translations**
* Spanish (es_ES) and Catalan (ca): 10 missing strings from 1.2.0 added, plus the new Manager notice
= 1.2.0 - 2026-08-07 =
@ -246,93 +272,25 @@ For the complete changelog, see [changelog.txt](https://git.robotstxt.es/ROBOTST
* PHPUnit: 17 plugin header tests added
* PHPCS, PHPStan level 9, PHPUnit all pass with 0 errors
= 1.1.0 - 2026-03-28 =
**Security**
* Patched CVE-2026-33347 and CVE-2026-30838 (league/commonmark updated to 2.8.2)
**Changed**
* Access level changed from administrator (manage_options) to editor (edit_pages) — editors can now manage documentation mappings without requiring full admin access
**Fixed**
* PHPStan level 9 compliance: zero errors across all plugin files (down from 104)
* target_order (menu_order) field was in the UI but never saved or applied — now fully implemented
* Type-safety improvements for all WordPress API returns (get_option, get_post_meta, json_decode, size_format)
* Token decryption false return handled correctly
* Uninstall data cleanup narrows mixed option return before array access
**Compatibility**
* Verified compatible with WordPress 6.8 and 7.0
* Verified compatible with PHP 8.4.x
= 1.0.0 - 2026-01-26 =
**Initial Release**
* ✨ Core synchronization functionality
* 🔄 Automatic scheduled sync (hourly, twice daily, daily)
* ⚡ Manual on-demand sync
* 📝 Markdown to HTML conversion using CommonMark
* 🎯 Flexible file-to-content mapping system
* 🔐 Encrypted GitHub token storage
* 🌍 Full internationalization support
* 📚 Multi-repository support
* 🎨 Clean admin interface with status badges
* 🔧 Custom Post Type for mapping management
* 📦 Support for pages, posts, and custom post types
* 👤 Configurable post author and parent page
* 🔢 Page order (menu_order) support
* 🐛 Debug tools for troubleshooting
* 🔄 Cron job management and repair tools
* 🧹 Clean uninstall with optional data deletion
* ✅ WordPress Coding Standards compliant
* 🛡️ Security best practices (nonces, escaping, sanitization)
**Admin Features:**
* Settings page for GitHub configuration
* Mappings management interface
* Add/Edit mapping with validation
* Sync status monitoring
* Debug tools (when WP_DEBUG enabled)
- Test GitHub connection
- Test token validity
- View scheduled crons
- Run crons manually
- Fix cron schedules
- Clear plugin caches
**Developer Features:**
* Procedural PHP following KISS principles
* PHP 8.0+ modern features
* Complete PHPDoc documentation
* WordPress hooks and filters
* Extensible architecture
* PHPCS and PHPStan validated
== Upgrade Notice ==
= 1.0.0 =
Initial release of Documentation Markdown. Sync your GitHub Markdown files to WordPress automatically!
= 1.2.1 =
Automatic updates now require the Manager (by ROBOTSTXT) plugin. A notice with the download link is shown on the Plugins and Settings pages.
== Additional Information ==
= Support =
* **Documentation:** Comprehensive docs included in `/docs/` directory
* **Repository:** [Report issues](https://git.robotstxt.es/ROBOTSTXT/robotstxt-documentation-markdown/issues)
* **Website:** [ROBOTSTXT.es](https://www.robotstxt.es/)
* **Documentation:** [robotstxt.software](https://www.robotstxt.software/plugins/robotstxt-documentation-markdown/)
* **Updates:** [Manager (by ROBOTSTXT)](https://www.robotstxt.software/plugins/robotstxt-manager/)
* **Website:** [ROBOTSTXT.software](https://www.robotstxt.software/)
* **Security:** robotstxt@robotstxt.es
= Contributing =
We welcome contributions! Please visit our [Gitea repository](https://git.robotstxt.es/ROBOTSTXT/robotstxt-documentation-markdown) to:
We welcome contributions! Please visit our [website](https://www.robotstxt.software/plugins/robotstxt-documentation-markdown/) to:
* Report bugs
* Suggest features
* Submit pull requests
= Privacy =
@ -340,7 +298,7 @@ This plugin does not collect or store any user data. The only external connectio
= Credits =
Developed by ROBOTSTXT with ❤️
Developed by [ROBOTSTXT](https://www.robotstxt.software/) with ❤️
**Dependencies:**
* [league/commonmark](https://commonmark.thephpleague.com/) - Markdown parser and converter