https://github.com/alleyinteractive/wp-modified-date-control
Control the modified date for a post in Gutenberg.
https://github.com/alleyinteractive/wp-modified-date-control
wordpress wordpress-plugin
Last synced: 3 months ago
JSON representation
Control the modified date for a post in Gutenberg.
- Host: GitHub
- URL: https://github.com/alleyinteractive/wp-modified-date-control
- Owner: alleyinteractive
- License: gpl-2.0
- Created: 2024-08-01T20:34:31.000Z (almost 2 years ago)
- Default Branch: develop
- Last Pushed: 2026-03-02T14:33:22.000Z (4 months ago)
- Last Synced: 2026-03-28T00:36:41.973Z (3 months ago)
- Topics: wordpress, wordpress-plugin
- Language: PHP
- Homepage:
- Size: 6.79 MB
- Stars: 3
- Watchers: 17
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Modified Date Control
Contributors: alleyinteractive
Tags: alleyinteractive, wp-modified-date-control
Stable tag: 1.1.1
Requires at least: 5.9
Tested up to: 6.1
Requires PHP: 8.2
License: GPL v2 or later
[](https://github.com/alleyinteractive/wp-modified-date-control/actions/workflows/all-pr-tests.yml)
Control the modified date for a post with Gutenberg.
## Installation
You can install the package via Composer:
```bash
composer require alleyinteractive/wp-modified-date-control
```
## Usage
Activate the plugin in WordPress and you will see a new panel available under
the "Summary" section in Gutenberg:
The panel will allow you to set a modified date for a post or allow the modified
date to be set to the current date and time upon update. Out of the box, the
plugin will continue to allow updates to the modified date unless disabled on a
per-post basis.
If you check `Allow Updates to Modified`, the modified date will be set to the
current date and time when the post is updated. You will be unable to set your
own modified date. If you uncheck the box, you will be able to set your own
modified date. Saving the post will not cause the modified date to be updated,
either, unless you manually updated it.
> [!NOTE]
> This plugin does not have support for non-Gutenberg editors.
### Filters
#### `wp_modified_date_control_default_allow_updates`
Modify the default state of allowing updates to a post's modified date when
saving the post.
Defaults to true. Changing this to `false` would prevent updates to the modified
date unless the user opts into it.
```php
// Disable updates to the modified date by default.
add_filter( 'wp_modified_date_control_default_allow_updates', fn () => false );
```
#### `wp_modified_date_control_prevent_updates`
Modify the default behavior of the plugin to allow/deny updates to the modified
date. By default, the plugin will prevent updates if the meta to allow updates
is set to `'false'`. This filter allows you to override that behavior.
```php
add_filter( 'wp_modified_date_control_prevent_updates', function( bool $prevent, int $post_id, ?\WP_REST_Request $request ) {
// Always allow updates to the modified date.
return false;
}, 10, 3 );
```
## Testing
Run `npm run test` to run Jest tests against JavaScript files. Run
`npm run test:watch` to keep the test runner open and watching for changes.
Run `npm run lint` to run ESLint against all JavaScript files. Linting will also
happen when running development or production builds.
Run `composer test` to run tests against PHPUnit and the PHP code in the plugin.
Unit testing code is written in PSR-4 format and can be found in the `tests`
directory.
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.
## Credits
This project is actively maintained by [Alley
Interactive](https://github.com/alleyinteractive). Like what you see? [Come work
with us](https://alley.com/careers/).
- [Sean Fisher](https://github.com/srtfisher)
- [All Contributors](../../contributors)
## License
The GNU General Public License (GPL) license. Please see [License File](LICENSE) for more information.