# MammothWP Acceptance Logs: commands

Read from admin-terms-acceptance at main.

## wp mmwp terms get

Show the active terms version

Returns the terms version users must currently have accepted.

```
wp mmwp terms get
```

Source: https://github.com/mammothwp/admin-terms-acceptance/blob/36f6f145beb885d95f3852dfb0faf4d902510f75/src/Api/TermsResource.php#L1

## wp mmwp terms list

List archived terms versions

Lists every archived terms version, newest first.

```
wp mmwp terms list [--limit=<limit>] [--offset=<offset>]
```

| Argument | Description |
| --- | --- |
| --limit=<limit> | Rows to return. |
| --offset=<offset> | Rows to skip. |

Source: https://github.com/mammothwp/admin-terms-acceptance/blob/36f6f145beb885d95f3852dfb0faf4d902510f75/src/Api/TermsResource.php#L1

## wp mmwp terms show

Get one archived terms version

Returns one archived terms version, including its full text.

```
wp mmwp terms show <id>
```

| Argument | Description |
| --- | --- |
| <id> | Version ID. |

Source: https://github.com/mammothwp/admin-terms-acceptance/blob/36f6f145beb885d95f3852dfb0faf4d902510f75/src/Api/TermsResource.php#L1

## wp mmwp terms publish

Publish a new terms version

Publishes the text as the active version. Everyone in scope is asked to accept it again.

```
wp mmwp terms publish --content=<content> [--version_number=<version_number>] [--effective_date=<effective_date>] [--change_summary=<change_summary>] [--only_if_changed]
```

| Argument | Description |
| --- | --- |
| --content=<content> | The terms text. HTML is filtered through wp_kses_post(). |
| --version_number=<version_number> | Human version number, e.g. 2.1. Derived if omitted. |
| --effective_date=<effective_date> | Effective date, Y-m-d. |
| --change_summary=<change_summary> | Shown to returning users above the terms. |
| --only_if_changed | Do nothing if the text matches the active version. |

Source: https://github.com/mammothwp/admin-terms-acceptance/blob/36f6f145beb885d95f3852dfb0faf4d902510f75/src/Api/TermsResource.php#L1

## wp mmwp terms refresh

Re-read the terms content source

Re-reads the terms content source now instead of waiting for the daily check, and publishes a new version if it changed.

```
wp mmwp terms refresh
```

Source: https://github.com/mammothwp/admin-terms-acceptance/blob/36f6f145beb885d95f3852dfb0faf4d902510f75/src/Api/TermsResource.php#L1

## wp mmwp terms acceptances

List acceptance log entries

Read-only, redacted export of the acceptance log. Restricted to the plugin managers.

```
wp mmwp terms acceptances [--user_id=<user_id>] [--version_id=<version_id>] [--date_from=<date_from>] [--date_to=<date_to>] [--limit=<limit>] [--offset=<offset>]
```

| Argument | Description |
| --- | --- |
| --user_id=<user_id> | Only this user. 0 for everyone. |
| --version_id=<version_id> | Only this terms version. 0 for all. |
| --date_from=<date_from> | First day, Y-m-d (UTC). |
| --date_to=<date_to> | Last day, Y-m-d (UTC). |
| --limit=<limit> | Rows to return. |
| --offset=<offset> | Rows to skip. |

Source: https://github.com/mammothwp/admin-terms-acceptance/blob/36f6f145beb885d95f3852dfb0faf4d902510f75/src/Api/TermsResource.php#L1

## wp mmwp terms purge

Report or permanently delete all acceptance evidence

Without --force this only reports what exists. With --force it drops the log, the version archive and the audit events.

```
wp mmwp terms purge [--dry_run] [--force]
```

| Argument | Description |
| --- | --- |
| --dry_run | Report only, even with --force. |
| --force | Actually delete. Irreversible. |

Source: https://github.com/mammothwp/admin-terms-acceptance/blob/36f6f145beb885d95f3852dfb0faf4d902510f75/src/Api/TermsResource.php#L1