This commit is contained in:
Javier Casares 2026-11-04 17:27:19 +00:00
commit 121c35737d

View file

@ -2,9 +2,9 @@
Contributors: robotstxt, javiercasares
Tags: github, documentation, markdown, sync, automation
Requires at least: 4.2
Tested up to: 7.1
Tested up to: 7.2
Requires PHP: 8.0
Stable tag: 1.2.2
Stable tag: 1.2.3
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
@ -182,13 +182,35 @@ Then go to Documentation → Settings, and you'll see a "Debug Tools" section at
== Compatibility ==
* WordPress: 4.2 - 7.1
* PHP: 8.0 - 8.5
* WordPress: 4.2 - 7.2
* PHP: 8.0 - 8.6
== Changelog ==
For the complete changelog, see [changelog.txt](https://www.robotstxt.software/plugins/robotstxt-documentation-markdown/).
= 1.2.3 - 2026-11-04 =
**Changed**
* Admin menu icon switched from the `dashicons-media-document` font glyph to an inline SVG (base64 data URI) — crisp at any resolution and aligned with the WordPress move from Dashicons to SVG icons (WordPress 7.2 / Trac #65089). Renders identically on every supported WordPress version (4.2 – 7.2); no dependency on the new WP 7.2-only `wp_get_icon()` API
* PHPStan static analysis raised from level 9 to level 10 (the maximum, no baseline): `$_POST`/`$_GET` input helpers now documented as accepting `array<mixed>`, `WP_Query::$posts` and `global $wpdb` type-narrowed, post-type labels narrowed to string
* The two transient-cleanup queries (debug "Clear All Plugin Caches" and uninstall) now escape LIKE patterns with the `esc_sql( $wpdb->esc_like( ... ) )` chain documented in `wpdb::esc_like()`, instead of `$wpdb->prepare()` — equivalent safety for bulk prefix deletes
* `composer update`: league/commonmark 2.10.0 → 2.10.7 (production, no known CVEs); phpstan 2.3.5, wordpress-stubs 7.1.2 (dev). Composer platform pin added at the PHP 8.0 floor so the shipped vendor tree can never require a newer PHP than declared (`nette/schema` 1.4.0 / `nette/utils` 4.1.6 needed PHP 8.1/8.2; the pin ships 1.2.5 / 4.0.11 instead). `composer audit` clean
**Compatibility**
* WordPress: 4.2 - 7.2 (floor re-verified with WP-Compat; smoke-tested on WordPress 7.2-beta4)
* PHP: 8.0 - 8.6 (floor re-verified with PHPCompatibility 5.6-8.6 full-range scan)
**Tests**
* PHP Coding Standards: PHPCS with WordPress-Core, WordPress-Docs, WordPress-Extra — 0 errors
* PHPStan: level 10 (maximum), 0 errors, no baseline
* PHPCompatibility: PHP 8.0-8.6 validated (full-range scan 5.6-8.6)
* WP-Compat: WordPress 4.2 floor validated
* PHPUnit: 23 tests pass (17 plugin header tests + 6 Manager-detection tests)
= 1.2.2 - 2026-08-24 =
**Changed**
@ -227,35 +249,15 @@ For the complete changelog, see [changelog.txt](https://www.robotstxt.software/p
* 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 =
= Previous versions =
**Added**
* **Title from H1:** the synced post title is now taken from the first `# H1` in the Markdown (inline formatting stripped), with the H1 removed from the body to avoid a duplicate heading. Falls back to the filename-derived title when no H1 is present
* **Internal link translation:** repo-relative Markdown links (e.g. `./api.md`, `../README.md`) are rewritten to the permalink of the matching mapped WordPress content. External, `mailto:`, and anchor links are left untouched; links with no matching mapping keep their original URL
* **Repository image sideloading:** images referenced in the Markdown are downloaded from the repository, added to the Media Library, and their references replaced with the attachment URL. Already-imported images are reused on subsequent syncs (tracked per post); removed images are kept in the Media Library (non-destructive)
**Security**
* Patched CVE-2026-71478 (and advisory GHSA-2q4p-g7hv-5rgv) in league/commonmark — an unsafe-link filter bypass that could defeat `allow_unsafe_links: false`. Updated league/commonmark 2.8.2 → 2.9.0
* GitHub token encryption now derives its AES-256 key with HKDF-SHA256 from `wp_salt('auth')` instead of using the salt directly; existing tokens are migrated transparently to the new `v2:` format on first decrypt (covers the cron path too)
* Discover Files "Refresh from GitHub" action is now nonce-protected — previously a crafted link could force an unrequested GitHub API call (CSRF)
* GitHub API request paths are now `rawurlencode()`d (defensive hardening)
* Sideloaded images are validated by extension (jpg, jpeg, png, gif, webp) and size (< 10 MB) before storage; SVG is intentionally excluded
**Fixed**
* "Using cached data / fetching fresh data" indicator on Discover Files now reflects reality — it always showed "cached" because the cache was tested after being populated
* `target_post_type` is now validated against registered public post types on save, falling back to `page` (prevents saving an unregistered or internal type)
* Debug action dispatch refactored into a single `switch`, each case retaining its `check_admin_referer()` check, to reduce the chance of a missing nonce check
**Changed**
* Inline `onclick` confirm on Delete replaced with a `data-confirm` attribute + delegated handler (CSP-friendlier, less fragile)
* Add Mapping "existing content" dropdown now queries only public post types (excludes attachments and the internal mapping CPT) with `no_found_rows` for better performance on large sites
If you want to see the full changelog, visit the [changelog.txt](https://www.robotstxt.software/plugins/robotstxt-documentation-markdown/) file.
== Upgrade Notice ==
= 1.2.3 =
Tested up to WordPress 7.2 and PHP 8.6. New SVG admin menu icon; no settings or data changes are needed.
= 1.2.2 =
Manager (by ROBOTSTXT) detection updated: now uses the ROBOTSTXT_MANAGER_NOTICED presence constant (Manager 1.6.2+) with a fallback for older Manager versions.