Merge pull request #52 from Automattic/release/1.5.0

Author: GaryJones

.github/workflows/deploy.yml

@@ -4,21 +4,28 @@ on:
     types: [released]
   # Allow manual triggering of the workflow.
   workflow_dispatch:
+
+permissions: {}
+
 jobs:
   release:
     name: New release to WordPress.org
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
 
       - name: Install SVN (Subversion)
         run: |
           sudo apt-get update
           sudo apt-get install subversion
 
       - name: Push to WordPress.org
-        uses: 10up/action-wordpress-plugin-deploy@stable
+        uses: 10up/action-wordpress-plugin-deploy@54bd289b8525fd23a5c365ec369185f2966529c2 # 2.3.0
         env:
           SLUG: rewrite-rules-inspector
           SVN_PASSWORD: ${{ secrets.SVN_PASSWORD }}

.wordpress-org/banner-1544x500.png

@@ -4,17 +4,40 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.0] - 2025-10-14
+
+### Added
+
+- feat: Add permastructs table with descriptions and structures by @GaryJones in https://github.com/Automattic/Rewrite-Rules-Inspector/pull/48
+- feat: Implement URL testing feature by @GaryJones in https://github.com/Automattic/Rewrite-Rules-Inspector/pull/51
+
+### Fixed
+
+- fix: undefined $match_path variable by @GaryJones in https://github.com/Automattic/Rewrite-Rules-Inspector/pull/47
+
+### Maintenance
+
+- CI: Refresh deploy.yml by @GaryJones in https://github.com/Automattic/Rewrite-Rules-Inspector/pull/43
+- Composer: Update composer/installers by @GaryJones in https://github.com/Automattic/Rewrite-Rules-Inspector/pull/44
+- Add Rector by @GaryJones in https://github.com/Automattic/Rewrite-Rules-Inspector/pull/45
+- Update GitHub action to install SVN before deploy to WordPress.org by @raamdev in https://github.com/Automattic/Rewrite-Rules-Inspector/pull/46
+- refactor: Extract inline CSS and improve admin interface styling by @GaryJones in https://github.com/Automattic/Rewrite-Rules-Inspector/pull/49
+- refactor: Restructure plugin architecture and enhance service organization by @GaryJones in https://github.com/Automattic/Rewrite-Rules-Inspector/pull/50
+
 ## [1.4.0] - 2024-05-21
+
 - Increase minimum PHP version to 7.4.
 - Increase minimum WordPress version to 5.9.
 - Forcibly delete rules cache on flush.
 - Fix escaping of URL for the Reset button.
 
 ## [1.3.1] - 2021-05-18
+
 - Fix WordPress.org banner image filename.
 - Load text domain, to allow translations.
 
 ## [1.3.0] - 2021-05-18
+
 - Add the count of missing rules.
 - Add license file, changelog, .editorconfig file, PHPCS config file, and GitHub Action to deploy to WordPress.org.
 - Add Composer support.
@@ -28,22 +51,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Remove call to deprecated `screen_icon()` function.
 
 ## [1.2.1] - 2013-09-19
+
 - Fix for strict standards error in declaration of `Rewrite_Rules_Inspector_List_Table::single_row()`. Props [simonhampel](https://github.com/simonhampel).
 
 ## [1.2] - 2013-01-16
+
 - Modify the rewrite rule source with a filter. Props [jeremyfelt](https://github.com/jeremyfelt).
 
 ## [1.1] - 2012-09-25
+
 - Add support for route matching when WordPress lives in a subdirectory. Props [dbernar1](https://github.com/dbernar1).
 - Display a success message after flushing the rewrite rules.
 
 ## [1.0] - 2012-05-09
+
 - Initial public release!
 - View a list of all the rewrite rules.
 - See which rewrite rules match a given URL, and the priorities they match in.
 - Filter by different sources of rewrite rules.
 - An error message appears if rewrite rules are missing in the database.
 
+[1.5.0]: https://github.com/Automattic/Rewrite-Rules-Inspector/compare/1.4.0...1.5.0
 [1.4.0]: https://github.com/Automattic/Rewrite-Rules-Inspector/compare/1.3.1...1.4.0
 [1.3.1]: https://github.com/Automattic/Rewrite-Rules-Inspector/compare/1.3.0...1.3.1
 [1.3.0]: https://github.com/Automattic/Rewrite-Rules-Inspector/compare/1.2.1...1.3.0

.wordpress-org/banner-772x250.png

@@ -1,8 +1,8 @@
 # Rewrite Rules Inspector
 
-Stable tag: 1.4.0  
+Stable tag: 1.5.0  
 Requires at least: 5.9  
-Tested up to: 6.5  
+Tested up to: 6.8  
 Requires PHP: 7.4  
 License: GPLv2 or later  
 Tags: rewrite rules, tools  
@@ -12,9 +12,31 @@ A simple admin tool for inspecting rewrite rules.
 
 ## Description
 
-A simple WordPress admin tool for inspecting rewrite rules. View a listing of all your rewrite rules, see which rewrite rules match a given URL (and the priorites they match in), or filter by different sources of rewrite rules. Perform a soft flush of your rewrite rules to regenerate them.
+A simple WordPress admin tool for inspecting rewrite rules. View a listing of all your rewrite rules, see which rewrite rules match a given URL (and the priorities they match in), or filter by different sources of rewrite rules. Perform a soft flush of your rewrite rules to regenerate them.
 
-Originally developed for clients hosted at [WordPress VIP](https://wpvip.com/), we thought it would be useful for development environments, etc. too. Feel free to [fork the plugin in GitHub](https://github.com/Automattic/Rewrite-Rules-Inspector/) — pull requests are always welcome. Hit us with feedback, questions, bug reports, and feature requests in the GitHub issues.
+[Developed on GitHub](https://github.com/Automattic/Rewrite-Rules-Inspector/) — pull requests are always welcome. Please leave feedback, questions, bug reports, and feature requests in the GitHub issues.
+
+### Where to find it
+
+Go to `Tools → Rewrite Rules` in the WordPress admin.
+
+### URL Tester
+
+Quickly test any URL (or path) against your site's rewrite rules:
+
+- See whether the URL would be a **404** or which rule would match first (the one WordPress uses).
+- View the list of **all matching rules**, in match priority order.
+- Inspect the **query variables** extracted from the match and the resulting **final query** WordPress would run.
+
+Works with full URLs or paths and automatically handles sites installed in a subdirectory.
+
+### Permastructs
+
+Browse a table of all **permastructs** that WordPress is aware of, including:
+
+- **Name** — the permastruct key (e.g. for posts, taxonomies, authors).
+- **Structure** — the permalink structure pattern used to generate rules.
+- **Description** — a human-friendly summary of what the permastruct controls.
 
 ## Installation
 
@@ -27,20 +49,26 @@ Originally developed for clients hosted at [WordPress VIP](https://wpvip.com/),
 
 ### Install the plugin manually
 
-1. Download the plugin from WordPress.org or get the latest release from our [Github Releases page](https://github.com/automattic/Rewrite-Rules-Inspector/releases).
+1. Download the plugin from WordPress.org or get the latest release from our [GitHub Releases page](https://github.com/automattic/Rewrite-Rules-Inspector/releases).
 1. Unzip the downloaded archive.
 1. Upload the entire `rewrite-rules-inspector` folder to your `/wp-content/plugins` directory.
 1. Visit the Plugins page from your WordPress dashboard and look for the newly installed plugin.
 1. Click "Activate" to activate the plugin on your site.
 
 ## Screenshots
 
-1. See which rewrite rules match a given URL, and the priorities they match in.  
+1. See all of the rewrite rules and flush them or download them.  
    ![The main screen showing the rewrite rules](.wordpress-org/screenshot-1.png)
 
-2. An error message appears if rewrite rules are missing in the database  
-   ![One rule is highlighted in red as it is missing](.wordpress-org/screenshot-2.png)
-   
+2. Test a URL against the rules to see which one(s) would match, and the priority they would match in.  
+   ![Showing the URL test results](.wordpress-org/screenshot-2.png)
+
+3. Limit rules and URL testing results down to specificrule sources.  
+   ![Showing the URL test results when no rules from that source match](.wordpress-org/screenshot-3.png)
+
+4. See which permastructs WordPress knows about.  
+   ![Showing the permastructs table](.wordpress-org/screenshot-4.png)
+
 ## Changelog
 
 See the [change log](https://github.com/automattic/Rewrite-Rules-Inspector/blob/master/CHANGELOG.md).