Dictator controls the State of WordPress
PHP Gherkin Shell
Switch branches/tags
Nothing to show
Permalink
Failed to load latest commit information.
bin End with newline Aug 2, 2014
features
php
utils Set up config file; use composer install Aug 2, 2014
.gitignore
.travis.yml
CONTRIBUTING.md Crib WP-CLI's CONTRIBUTING.md and make it our own Apr 1, 2014
README.md Use master branch for Travis chicklet Apr 9, 2014
autoload.php
composer.json
dictator.php

README.md

Dictator

Build Status

Dictator controls the State of WordPress. Strongly influenced by Salt, Dictator permits configuration attributes stored in YAML state files to be imposed upon WordPress.

Dictator's primary concern is to permit the expression of how WordPress is configured as YAML state files. It understands WordPress in terms of states. States are collections of regions. Each state file has the state declaration, and any tracked configuration details for each region.

For example, the site state includes the settings, users, and terms regions. Running wp dictator export site site-state.yml against production data will export the production state into a human-readable state file:

state: site
settings:
  title: Dictator
  description: Just another WordPress site controlled by Dictator
  date_format: F j, Y
  time_format: g:i a
  active_theme: twentyfourteen

Apply the state file locally with wp dictator impose site-state.yml and you've replicated production without having to download the database.

Installing

Dictator is a series of WP-CLI commands.

Once WP-CLI is installed, Dictator can be installed via Composer, or WP-CLI's --require attribute.

Using

Dictator comprises these WP-CLI commands:

  • dictator compare <file> - Compare a given state file to the State of WordPress. Produces a colorized diff if differences, otherwise empty output.
  • dictator export <state> <file> [--regions=<regions>] [--force] - Export the State of WordPress to a state file.
  • dictator impose <file> [--regions=<regions>] - Impose a given state file onto WordPress.
  • dictator validate <file> - Validate the provided state file against each region's schema.

First time user? Try Dictator out by calling wp dictator export site site-state.yml, making a change to the state file, and seeing a colorized diff of how it compares with wp dictator compare site-state.yml.

Extending

Even though Dictator is in its infancy, it was written with extensibility in mind. New states can be registered with Dictator::add_state();, and can comprise a selection of existing or custom regions. Write a state / region for your plugin / theme to make it easy for your users to export / impose settings.