humanmade / hm-post-history
Adds a widget and REST endpoint for the purpose of displaying post revisions inline on the frontend.
Installs: 38
Dependents: 0
Suggesters: 0
Security: 0
Stars: 6
Watchers: 12
Forks: 2
Open Issues: 1
Language:JavaScript
Type:wordpress-plugin
This package is auto-updated.
Last update: 2024-10-25 03:25:00 UTC
README
This widget allows visitors to easily diff posts against their earlier revisions, displaying diffs of HTML inline.
It should be plug and play: Just add the widget to a sidebar that will appear on a page or post. It will detect everything it needs. If you have more complex needs, the code is heavily documented and includes many filters to modify behavior. If the widget's design doesn't suit your purposes, its class is easily extendable, with methods for generating all of the necessary HTML.
Release process
This plugin requires a small amount of JS and CSS in order to work properly, and these must be built on deployment. To ensure a tagged release includes these built assets, follow the process below for each release:
- Merge all PRs to be included in the release into
main
- Open a PR to bump the version numbers in
package.json
andhm-post-history.php
to the next appropriate version - Once the PR is merged, create a tag on
main
with the version number, e.g.v1.4.0
- GitHub Actions should auto-build the frontend assets and reset that tag to push to the bundled code
Check the build output in the Actions tab to see whether it works or not.
Development Builds
To test the plugin on a deployed instance via composer, register the repository as a VCS source, and set your humanmade/hm-post-history
dependency to track the dev-develop-built
branch source.
Merge PRs which require development testing into the develop
branch, and they will be automatically built and pushed to that develop-built
branch using a GitHub Action.
If code which is not intended for release ends up on develop
, force-reset both develop
and develop-built
to match the latest main
.