VersionPress has powerful search with syntax inspired by GitHub or Gmail. It lets you filter the main table by authors, post types, date ranges etc.
Search is available since VersionPress 3.0.
Let's start with a couple of examples.
Finds changes that have the words "hello" and "world" somewhere in the change description (commit message).
hello world author:joe
Search operators are supported, e.g.,
author:. The search is always case insensitive so this will find 'Joe', 'JOE' etc.
hello world author: joe* date:">= 2016-01-01"
Here you can see a couple of syntax rules in play: you can combine as many operators as you like, wildcards are supported, value containing spaces must be quoted, there are optional spaces after the colon, etc.
Searches the commit text. Without quotes, it will look for commits containing all the words. With quotes, it does a strict match (still case in-sensitive). Single and double quotes are both supported.
Space after colon is optional. Value can be quoted and wildcarded as above.
Operators can be repeated, their values are then combined using logical OR. For example, you can search for changes done by either Adam or Betty by using
author:Adam author:Betty. The only exception is
date: which is AND'd, see below.
Multiple operators are combined using logical AND.
All of the syntaxes above can be freely combined.
Author of the action. You can use author name or his/her email, wildcards are supported.
There are two special authors:
author:firstname.lastname@example.org anonymous actions like posting a comment on a blog.
author:wp-clifinds actions done via WP-CLI.
Commit date. Recommended format is
date: 2016-01-01, but anything that can be parsed by
strtotime() is supported. You can use greater than / less than operators such as
date: >=2016-01-01 or a range operator
.., for example,
date: 2016-01-01..2016-02-01. Either boundary can be replaced with a wildcard, e.g.,
date: operator has currently some limitations:
- Time portion is ignored.
- Repeating this operator is tricky and we recommend using only a single
date:at a time. For example, if you searched for
date:2016-01-01 date:2016-01-02you might expect to see commits from both of the dates, but the result would be empty because
date:uses logical AND due to technical limitations. You could use the AND logic for something like
date:>2016-01-01 date:<2016-02-01but we recommend you use the range operator instead.
- You cannot search for two date periods with a gap between them. The range must be continuous.
All actions tracked by VersionPress are done on some entity (
postmeta etc.), the action is something like
delete and every entity has a unique ID, something like
126BBC0541B14B528C623E32EE1B497C. You can search for these using the operators above, most commonly by
We currently don't have a good way to generate the definitive list of supported entities, you can see them in the commit messages when using a standard Git client but it's not ideal. We'll have a better way to document this in the future.
VP tags are pieces of metadata that VersionPress stores with each commit. For example, updating the site title creates a commit message like this:
[VP] Edited option 'blogname' VP-Action: option/edit/blogname X-VP-Version: 3.0 X-VP-Environment: staging
You can search for VP tags, either in a full form or without the
X-VP- prefix. Some examples that will work equally fine against the commit above are:
VP-Action actually gets a bit of a treatment because it is also an operator (see above) and quite useful. You can skip the
/* wildcard as that is added automatically so something like
action: option/edit will just work.
Search in 3.0 does not support negative search. You cannot say something like "author is NOT Joe".