https://github.com/mrwweb/mrw-post-cleanup-utilities
A WordPress plugin that helps clean up posts with poor formatting.
https://github.com/mrwweb/mrw-post-cleanup-utilities
a11y accessibility block-editor gutenberg headings wordpress
Last synced: about 2 months ago
JSON representation
A WordPress plugin that helps clean up posts with poor formatting.
- Host: GitHub
- URL: https://github.com/mrwweb/mrw-post-cleanup-utilities
- Owner: mrwweb
- Created: 2025-02-06T17:19:28.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-02-19T00:35:58.000Z (3 months ago)
- Last Synced: 2025-03-28T19:11:47.099Z (about 2 months ago)
- Topics: a11y, accessibility, block-editor, gutenberg, headings, wordpress
- Language: JavaScript
- Homepage:
- Size: 632 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# MRW Post Cleanup Utilities
v0.3.0
Mark Root-Wiley, [MRW Web Design](https://MRWweb.com)
A WordPress plugin with useful tools to transform blocks and post content for more accessible and consistent formatting.
> [!TIP]
> I put a lot of unpaid work into a plugin like this. I publish it for free in hopes that it helps people save time and make better websites. **If this plugin saved you time on a paid project**, please consider [sponsoring my work on the project](https://github.com/sponsors/mrwweb) or sponsoring work on a specific feature that would help you.
## Features
- Detect fake headings and convert to real heading blocks at a selected level
- Set all heading blocks to one level
- Promote all heading blocks "up" a level in the hiearchy (e.g. H3 to H2)
- Strip all underline styles from the post
- Remove all "hard" linebreaks (the `
` tag)
- Replace all non-breaking spaces (` `) with regular spaces
## Installation
Upload the plugin zip or use `wp-cli`:
```sh
wp plugin install https://github.com/mrwweb/mrw-post-cleanup-utilities/archive/master.zip --force --activate
```
## FAQs
### Where are the utilities?
All utilities are in a custom block editor sidebar. To open it, click the wrench icon in the top-right corner of the block editor in the same row of buttons as the "Publish" button.
### Where did the sidebar go? / I lost the sidebar
It's possible to remove the wrench icon by clicking the star icon in the top-right corner of the sidebar (next to the "X" close icon). If you do this, you'll find the sidebar in the triple-dot/kebab menu (next to the "Publish" button) under "Plugins".
### Can you add "X" feature?
Maybe! See the existing [list of issues](https://github.com/mrwweb/mrw-post-cleanup-utilities/issues). You can help by leaving a comment or reaction on an existing issue, opening a new one, or even sponsoring work on a feature you care about.
## Changelog
### 0.3.0 (18 Feb, 2025)
- Major refactor to componentize the transform buttons and sidebar sections for easier maintenance and contribution
- Add "Strip Underlines" button (#1)
- Add "Remove Linebreaks" button (#3)
- Add "Remove Non-breaking Spaces" button (#2)
- Make all strings translatable (#8)
- Add `CONTRIBUTING.md` with contribution guidelines and documentation of plugin architecture (#10)
- Additional code consistent and commenting to improve quality and readability
### 0.2.0 (10 Feb, 2025)
- Add heading level "reset" and promotion features
- Add icons for each button to help differentiate
- Move features into separate sidebar with collapsible panels
- Add Github-friendly `README.md` in favorite of plugin repo-style readme
- Bump browsers list (no changes when compiling)
### 0.1.0
- Initial release with fake heading detection and conversion