From eb97bccbc9d0f4a0d9c33f5af58b944844c10de2 Mon Sep 17 00:00:00 2001 From: scribu Date: Sun, 4 Nov 2012 23:55:42 +0200 Subject: [PATCH 001/194] add initial version; generated via github --- CNAME | 1 + images/bkg.png | Bin 0 -> 4261 bytes images/blacktocat.png | Bin 0 -> 1266 bytes index.html | 255 +++++++++++++++++++++++++++++++++++ javascripts/main.js | 1 + params.json | 1 + stylesheets/pygment_trac.css | 68 ++++++++++ stylesheets/stylesheet.css | 247 +++++++++++++++++++++++++++++++++ 8 files changed, 573 insertions(+) create mode 100644 CNAME create mode 100644 images/bkg.png create mode 100644 images/blacktocat.png create mode 100644 index.html create mode 100644 javascripts/main.js create mode 100644 params.json create mode 100644 stylesheets/pygment_trac.css create mode 100644 stylesheets/stylesheet.css diff --git a/CNAME b/CNAME new file mode 100644 index 00000000..07dab832 --- /dev/null +++ b/CNAME @@ -0,0 +1 @@ +wp-cli.org diff --git a/images/bkg.png b/images/bkg.png new file mode 100644 index 0000000000000000000000000000000000000000..fcebb5b22999adb792afee1f74bcf4af91db8441 GIT binary patch literal 4261 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 E2cLQQbpQYW literal 0 HcmV?d00001 diff --git a/images/blacktocat.png b/images/blacktocat.png new file mode 100644 index 0000000000000000000000000000000000000000..273d5710a2e0968d77584ad073e4a089fbfd7e68 GIT binary patch literal 1266 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`k|nMYCBgY=CFO}lsSJ)O`AMk? zp1FzXsX?iUDV2pMQ*9U+nA0*tB1$5BeXNr6bM+EIYV;~{3xK*A7;Nk-3KEmEQ%e+* zQqwc@Y?a>c-mj#PnPRIHZt82`Ti~3Uk?B!Ylp0*+7m{3+ootz+WN)WnQ(*-(AUCxn zQK2F?C$HG5!d3}vt`(3C64qBz04piUwpD^SD#ABF!8yMuRl!uxKsVXI%s|1+P|wiV z#N6CmN5ROz&_Lh7NZ-&%*U;R`*vQJjKmiJrfVLH-q*(>IxIyg#@@$ndN=gc>^!3Zj z%k|2Q_413-^$jg8EkR}&8R-I5=oVMzl_XZ^<`pZ$OmImpPA){ffi_eM3D1{oGuTzrd=COM+4n&cLd=IHa;5RX-@T zIKQ+g85kdF$}r8qu)}W=NFmTQR{lkqz(`5Vami0E%}vcK@pQ3O0?O#6WTsdd7+V+^ z8k(CJm>U_GSr{5xm>asenYlPSS~yx7IT;(l%)qAC#mvab6&Utr2Bs#4hOUN|=4MVV zCI+U?PDZXKZWgXEy`Fi+C5d^-sW5vpf%Zc6n&H)JD;QCfH z^og8&1M`mKzE)l;d=qjrb~vvJSy|Mouyo1dg^ni6?thVCs0yAf`Q@5aq}s+K9`V=C z{rP`=v-NB<-^nFOYBRV_`Rx;uVYQy^)9a}ALqMd-xJi4fVcRLrrgF#H^(z_`gmYNg z8`ZC~^QU(&GySnBKw|Qotw~8oCN7?p;&T4i?d&@L$Gl%$8&-dv`S`$=`T36X{>ZDw zT=kLd?0S^caPZI_ua^-qKl~;=EWB<}?CV->TJO$Qp2Pd-+ + + + + + + + + + + wp-cli by wp-cli + + + + +
+
+

wp-cli

+

A command line interface for WordPress

+ +
+ Download as .zip + Download as .tar.gz + View on GitHub +
+
+
+ +
+
+

What is wp-cli?

+ +

wp-cli is a set of command-line tools for managing WordPress installations. You can update plugins, set up multisite installs, update posts and much more.

+ +

Visit the wiki for more information.

+ +

Requirements

+ +
    +
  • PHP >= 5.3
    • +
  • WP >= 3.3
    • +

Installing

+ +

Via PEAR:

+ +
sudo pear config-set auto_discover 1
+sudo pear install wp-cli.github.com/pear/wpcli
+
+ +

Via GIT:

+ +
git clone --recursive git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
+cd ~/git/wp-cli
+sudo utils/dev-build
+
+ +

You can replace ~/git/wp-cli with whatever you want.

+ +

MAMP, XAMP, etc.

+ +

If the php command is not available, you can try finding an appropriate binary:

+ +
./utils/find-php
+
+ +

Then, create an environment variable called WP_CLI_PHP with the path found by find-php.

+ +

In a UNIX environment, you would do this by adding the following line to your .bashrc file:

+ +
WP_CLI_PHP=/path/to/php-binary
+
+ +

Using

+ +

Go into a WordPress root folder:

+ +
cd /var/www/wp/
+
+ +

Typing wp help should show you an output similar to this:

+ +
Example usage:
+    wp google-sitemap [build|help] ...
+    wp core [update|help] ...
+    wp home [help] ...
+    wp option [add|update|delete|get|help] ...
+    wp plugin [status|activate|deactivate|install|delete|update|help] ...
+    wp theme [status|details|activate|help] ...
+
+ +

So this tells us which commands are installed: eg. google-sitemap, core, home, ... +Between brackets you can see their sub commands.

+ +

Let's for example try to install the hello dolly plugin from wordpress.org:

+ +
wp plugin install hello-dolly
+
+ +

Output:

+ +
Installing Hello Dolly (1.5)
+
+Downloading install package from http://downloads.WordPress.org/plugin/hello-dolly.1.5.zip ...
+Unpacking the package ...
+Installing the plugin ...
+
+Success: The plugin is successfully installed
+
+ +

Multisite

+ +

On a multisite installation, you need to pass a --blog parameter, so that WP knows which site it's supposed to be operating on:

+ +
wp theme status --blog=localhost/wp/test
+
+ +

If you have a subdomain installation, it would look like this:

+ +
wp theme status --blog=test.example.com
+
+ +

If you're usually working on the same site most of the time, you can put the url of that site in a file called 'wp-cli-blog' in your root WP dir:

+ +
echo 'test.example.com' > wp-cli-blog
+
+ +

Then, you can call wp without the --blog parameter again:

+ +
wp theme status
+
+ +

Adding commands

+ +

Adding commands to wp-cli is very easy. You can even add them from within your own plugin. +You can find more information about adding commands in the Commands Cookbook on our Wiki.

+ +

Please share the commands you make, issue a pull request to get them included in wp-cli by default.

+ +

Changelog

+ +

0.6

+ +
    +
  • added wp post and wp post-meta +
    • +
  • added wp user-meta +
    • +
  • added wp blog create +
    • +
  • added wp export +
    • +
  • added wp transient +
    • +
  • added wp db optimize and wp db repair +
    • +
  • added wp db create, wp db drop and wp db reset +
    • +
  • added wp db import +
    • +
  • added wp theme install and wp theme update +
    • +
  • added wp core install_network +
    • +
  • added wp core update_db +
    • +
  • added --json option to several subcommands
    • +
  • added --network option to wp plugin activate +
    • +
  • added --require global parameter
    • +
  • fixed wp plugin update +
    • +
  • fixed "out of memory" error
    • +
  • misc bugfixes and optimizations
    • +
  • man pages (not in PEAR package)
    • +

0.5

+ +
    +
  • added wp user +
    • +
  • added wp core download +
    • +
  • added wp core config +
    • +
  • added wp plugin update --all +
    • +
  • added wp theme update +
    • +
  • added wp db import +
    • +
  • added --url --path and --user global parameters
    • +
  • various bugfixes
    • +

0.4

+ +
    +
  • added wp eval and wp eval-file +
    • +
  • added wp export +
    • +
  • added wp core install +
    • +
  • fixed wp core update +
    • +
  • added --dev flag to wp plugin install +
    • +
  • added wp plugin uninstall +
    • +
  • fixed wp plugin install and wp plugin update +
    • +

0.3

+ +
    +
  • added wp sql +
    • +
  • improved wp option +
    • +
  • pear installer
    • +

0.2

+ +
    +
  • added multisite support
    • +
  • improved wp plugin and wp theme +
    • +
  • added wp generate +
    • +
  • added wp core version +
    • +
  • added wp --version +
    • +
  • added bash completion script
    • +

0.1

+ +
    +
  • initial release
    • +

Contributors

+ + +
+
+ + + + + + \ No newline at end of file diff --git a/javascripts/main.js b/javascripts/main.js new file mode 100644 index 00000000..d8135d37 --- /dev/null +++ b/javascripts/main.js @@ -0,0 +1 @@ +console.log('This would be the main JS file.'); diff --git a/params.json b/params.json new file mode 100644 index 00000000..c136bf41 --- /dev/null +++ b/params.json @@ -0,0 +1 @@ +{"note":"Don't delete this file! It's used internally to help with page regeneration.","google":"UA-962663-21","tagline":"A command line interface for WordPress","name":"wp-cli","body":"What is wp-cli?\r\n--------------\r\n\r\nwp-cli is a set of command-line tools for managing WordPress installations. You can update plugins, set up multisite installs, update posts and much more.\r\n\r\nVisit the [wiki](https://github.com/wp-cli/wp-cli/wiki) for more information.\r\n\r\nRequirements\r\n============\r\n\r\n* PHP >= 5.3\r\n* WP >= 3.3\r\n\r\nInstalling\r\n==========\r\n\r\n**Via PEAR:**\r\n\r\n```sh\r\nsudo pear config-set auto_discover 1\r\nsudo pear install wp-cli.github.com/pear/wpcli\r\n```\r\n\r\n**Via GIT:**\r\n\r\n```sh\r\ngit clone --recursive git://github.com/wp-cli/wp-cli.git ~/git/wp-cli\r\ncd ~/git/wp-cli\r\nsudo utils/dev-build\r\n```\r\n\r\nYou can replace `~/git/wp-cli` with whatever you want.\r\n\r\nMAMP, XAMP, etc.\r\n-----------\r\n\r\nIf the `php` command is not available, you can try finding an appropriate binary:\r\n\r\n```sh\r\n./utils/find-php\r\n```\r\n\r\nThen, create an environment variable called `WP_CLI_PHP` with the path found by `find-php`.\r\n\r\nIn a UNIX environment, you would do this by adding the following line to your `.bashrc` file:\r\n\r\n```sh\r\nWP_CLI_PHP=/path/to/php-binary\r\n```\r\n\r\nUsing\r\n=====\r\n\r\nGo into a WordPress root folder:\r\n\r\n```\r\ncd /var/www/wp/\r\n```\r\n\r\nTyping `wp help` should show you an output similar to this:\r\n\r\n```\r\nExample usage:\r\n\twp google-sitemap [build|help] ...\r\n\twp core [update|help] ...\r\n\twp home [help] ...\r\n\twp option [add|update|delete|get|help] ...\r\n\twp plugin [status|activate|deactivate|install|delete|update|help] ...\r\n\twp theme [status|details|activate|help] ...\r\n```\r\n\r\nSo this tells us which commands are installed: eg. google-sitemap, core, home, ...\r\nBetween brackets you can see their sub commands. \r\n\r\nLet's for example try to install the hello dolly plugin from wordpress.org:\r\n\r\n```\r\nwp plugin install hello-dolly\r\n```\r\n\r\nOutput:\r\n\r\n```\r\nInstalling Hello Dolly (1.5)\r\n\r\nDownloading install package from http://downloads.WordPress.org/plugin/hello-dolly.1.5.zip ...\r\nUnpacking the package ...\r\nInstalling the plugin ...\r\n\r\nSuccess: The plugin is successfully installed\r\n```\r\n\r\nMultisite\r\n---------\r\n\r\nOn a multisite installation, you need to pass a --blog parameter, so that WP knows which site it's supposed to be operating on:\r\n\r\n```\r\nwp theme status --blog=localhost/wp/test\r\n```\r\n\r\nIf you have a subdomain installation, it would look like this:\r\n\r\n```\r\nwp theme status --blog=test.example.com\r\n```\r\n\r\nIf you're usually working on the same site most of the time, you can put the url of that site in a file called 'wp-cli-blog' in your root WP dir:\r\n\r\n```\r\necho 'test.example.com' > wp-cli-blog\r\n```\r\n\r\nThen, you can call `wp` without the --blog parameter again:\r\n\r\n```\r\nwp theme status\r\n```\r\n\r\nAdding commands\r\n===============\r\n\r\nAdding commands to wp-cli is very easy. You can even add them from within your own plugin.\r\nYou can find more information about adding commands in the [Commands Cookbook](https://github.com/wp-cli/wp-cli/wiki/Commands-Cookbook) on our Wiki.\r\n\r\n**Please share the commands you make, issue a pull request to get them included in wp-cli by default.**\r\n\r\nChangelog\r\n=========\r\n\r\n**0.6**\r\n\r\n- added `wp post` and `wp post-meta`\r\n- added `wp user-meta`\r\n- added `wp blog create`\r\n- added `wp export`\r\n- added `wp transient`\r\n- added `wp db optimize` and `wp db repair`\r\n- added `wp db create`, `wp db drop` and `wp db reset`\r\n- added `wp db import`\r\n- added `wp theme install` and `wp theme update`\r\n- added `wp core install_network`\r\n- added `wp core update_db`\r\n- added `--json` option to several subcommands\r\n- added `--network` option to `wp plugin activate`\r\n- added `--require` global parameter\r\n- fixed `wp plugin update`\r\n- fixed \"out of memory\" error\r\n- misc bugfixes and optimizations\r\n- man pages (not in PEAR package)\r\n\r\n**0.5**\r\n\r\n- added `wp user`\r\n- added `wp core download`\r\n- added `wp core config`\r\n- added `wp plugin update --all`\r\n- added `wp theme update`\r\n- added `wp db import`\r\n- added `--url` `--path` and `--user` global parameters\r\n- various bugfixes\r\n\r\n**0.4**\r\n\r\n- added `wp eval` and `wp eval-file`\r\n- added `wp export`\r\n- added `wp core install`\r\n- fixed `wp core update`\r\n- added `--dev` flag to `wp plugin install`\r\n- added `wp plugin uninstall`\r\n- fixed `wp plugin install` and `wp plugin update`\r\n\r\n**0.3**\r\n\r\n- added `wp sql`\r\n- improved `wp option`\r\n- pear installer\r\n\r\n**0.2**\r\n\r\n- added multisite support\r\n- improved `wp plugin` and `wp theme`\r\n- added `wp generate`\r\n- added `wp core version`\r\n- added `wp --version`\r\n- added bash completion script\r\n\r\n**0.1**\r\n\r\n- initial release\r\n\r\nContributors\r\n------------\r\n\r\n- [Contributor list](https://github.com/wp-cli/wp-cli/contributors)\r\n- [Contributor guide](https://github.com/wp-cli/wp-cli/wiki/Commands-Cookbook)\r\n"} \ No newline at end of file diff --git a/stylesheets/pygment_trac.css b/stylesheets/pygment_trac.css new file mode 100644 index 00000000..d1df6a21 --- /dev/null +++ b/stylesheets/pygment_trac.css @@ -0,0 +1,68 @@ +.highlight .c { color: #999988; font-style: italic } /* Comment */ +.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */ +.highlight .k { font-weight: bold } /* Keyword */ +.highlight .o { font-weight: bold } /* Operator */ +.highlight .cm { color: #999988; font-style: italic } /* Comment.Multiline */ +.highlight .cp { color: #999999; font-weight: bold } /* Comment.Preproc */ +.highlight .c1 { color: #999988; font-style: italic } /* Comment.Single */ +.highlight .cs { color: #999999; font-weight: bold; font-style: italic } /* Comment.Special */ +.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */ +.highlight .gd .x { color: #000000; background-color: #ffaaaa } /* Generic.Deleted.Specific */ +.highlight .ge { font-style: italic } /* Generic.Emph */ +.highlight .gr { color: #aa0000 } /* Generic.Error */ +.highlight .gh { color: #999999 } /* Generic.Heading */ +.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */ +.highlight .gi .x { color: #000000; background-color: #aaffaa } /* Generic.Inserted.Specific */ +.highlight .go { color: #888888 } /* Generic.Output */ +.highlight .gp { color: #555555 } /* Generic.Prompt */ +.highlight .gs { font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #800080; font-weight: bold; } /* Generic.Subheading */ +.highlight .gt { color: #aa0000 } /* Generic.Traceback */ +.highlight .kc { font-weight: bold } /* Keyword.Constant */ +.highlight .kd { font-weight: bold } /* Keyword.Declaration */ +.highlight .kn { font-weight: bold } /* Keyword.Namespace */ +.highlight .kp { font-weight: bold } /* Keyword.Pseudo */ +.highlight .kr { font-weight: bold } /* Keyword.Reserved */ +.highlight .kt { color: #445588; font-weight: bold } /* Keyword.Type */ +.highlight .m { color: #009999 } /* Literal.Number */ +.highlight .s { color: #d14 } /* Literal.String */ +.highlight .na { color: #008080 } /* Name.Attribute */ +.highlight .nb { color: #0086B3 } /* Name.Builtin */ +.highlight .nc { color: #445588; font-weight: bold } /* Name.Class */ +.highlight .no { color: #008080 } /* Name.Constant */ +.highlight .ni { color: #800080 } /* Name.Entity */ +.highlight .ne { color: #990000; font-weight: bold } /* Name.Exception */ +.highlight .nf { color: #990000; font-weight: bold } /* Name.Function */ +.highlight .nn { color: #555555 } /* Name.Namespace */ +.highlight .nt { color: #CBDFFF } /* Name.Tag */ +.highlight .nv { color: #008080 } /* Name.Variable */ +.highlight .ow { font-weight: bold } /* Operator.Word */ +.highlight .w { color: #bbbbbb } /* Text.Whitespace */ +.highlight .mf { color: #009999 } /* Literal.Number.Float */ +.highlight .mh { color: #009999 } /* Literal.Number.Hex */ +.highlight .mi { color: #009999 } /* Literal.Number.Integer */ +.highlight .mo { color: #009999 } /* Literal.Number.Oct */ +.highlight .sb { color: #d14 } /* Literal.String.Backtick */ +.highlight .sc { color: #d14 } /* Literal.String.Char */ +.highlight .sd { color: #d14 } /* Literal.String.Doc */ +.highlight .s2 { color: #d14 } /* Literal.String.Double */ +.highlight .se { color: #d14 } /* Literal.String.Escape */ +.highlight .sh { color: #d14 } /* Literal.String.Heredoc */ +.highlight .si { color: #d14 } /* Literal.String.Interpol */ +.highlight .sx { color: #d14 } /* Literal.String.Other */ +.highlight .sr { color: #009926 } /* Literal.String.Regex */ +.highlight .s1 { color: #d14 } /* Literal.String.Single */ +.highlight .ss { color: #990073 } /* Literal.String.Symbol */ +.highlight .bp { color: #999999 } /* Name.Builtin.Pseudo */ +.highlight .vc { color: #008080 } /* Name.Variable.Class */ +.highlight .vg { color: #008080 } /* Name.Variable.Global */ +.highlight .vi { color: #008080 } /* Name.Variable.Instance */ +.highlight .il { color: #009999 } /* Literal.Number.Integer.Long */ + +.type-csharp .highlight .k { color: #0000FF } +.type-csharp .highlight .kt { color: #0000FF } +.type-csharp .highlight .nf { color: #000000; font-weight: normal } +.type-csharp .highlight .nc { color: #2B91AF } +.type-csharp .highlight .nn { color: #000000 } +.type-csharp .highlight .s { color: #A31515 } +.type-csharp .highlight .sc { color: #A31515 } diff --git a/stylesheets/stylesheet.css b/stylesheets/stylesheet.css new file mode 100644 index 00000000..a54a6397 --- /dev/null +++ b/stylesheets/stylesheet.css @@ -0,0 +1,247 @@ +body { + margin: 0; + padding: 0; + background: #151515 url("../images/bkg.png") 0 0; + color: #eaeaea; + font: 16px; + line-height: 1.5; + font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace; +} + +/* General & 'Reset' Stuff */ + +.container { + width: 90%; + max-width: 600px; + margin: 0 auto; +} + +section { + display: block; + margin: 0 0 20px 0; +} + +h1, h2, h3, h4, h5, h6 { + margin: 0 0 20px; +} + +li { + line-height: 1.4 ; +} + +/* Header,
+ header - container + h1 - project name + h2 - project description +*/ + +header { + background: rgba(0, 0, 0, 0.1); + width: 100%; + border-bottom: 1px dashed #b5e853; + padding: 20px 0; + margin: 0 0 40px 0; +} + +header h1 { + font-size: 30px; + line-height: 1.5; + margin: 0 0 0 -40px; + font-weight: bold; + font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace; + color: #b5e853; + text-shadow: 0 1px 1px rgba(0, 0, 0, 0.1), + 0 0 5px rgba(181, 232, 83, 0.1), + 0 0 10px rgba(181, 232, 83, 0.1); + letter-spacing: -1px; + -webkit-font-smoothing: antialiased; +} + +header h1:before { + content: "./ "; + font-size: 24px; +} + +header h2 { + font-size: 18px; + font-weight: 300; + color: #666; +} + +#downloads .btn { + display: inline-block; + text-align: center; + margin: 0; +} + +/* Main Content +*/ + +#main_content { + width: 100%; + -webkit-font-smoothing: antialiased; +} +section img { + max-width: 100% +} + +h1, h2, h3, h4, h5, h6 { + font-weight: normal; + font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace; + color: #b5e853; + letter-spacing: -0.03em; + text-shadow: 0 1px 1px rgba(0, 0, 0, 0.1), + 0 0 5px rgba(181, 232, 83, 0.1), + 0 0 10px rgba(181, 232, 83, 0.1); +} + +#main_content h1 { + font-size: 30px; +} + +#main_content h2 { + font-size: 24px; +} + +#main_content h3 { + font-size: 18px; +} + +#main_content h4 { + font-size: 14px; +} + +#main_content h5 { + font-size: 12px; + text-transform: uppercase; + margin: 0 0 5px 0; +} + +#main_content h6 { + font-size: 12px; + text-transform: uppercase; + color: #999; + margin: 0 0 5px 0; +} + +dt { + font-style: italic; + font-weight: bold; +} + +ul li { + list-style: none; +} + +ul li:before { + content: ">>"; + font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace; + font-size: 13px; + color: #b5e853; + margin-left: -37px; + margin-right: 21px; + line-height: 16px; +} + +blockquote { + color: #aaa; + padding-left: 10px; + border-left: 1px dotted #666; +} + +pre { + background: rgba(0, 0, 0, 0.9); + border: 1px solid rgba(255, 255, 255, 0.15); + padding: 10px; + font-size: 14px; + color: #b5e853; + border-radius: 2px; + -moz-border-radius: 2px; + -webkit-border-radius: 2px; + text-wrap: normal; + overflow: auto; + overflow-y: hidden; +} + +table { + width: 100%; + margin: 0 0 20px 0; +} + +th { + text-align: left; + border-bottom: 1px dashed #b5e853; + padding: 5px 10px; +} + +td { + padding: 5px 10px; +} + +hr { + height: 0; + border: 0; + border-bottom: 1px dashed #b5e853; + color: #b5e853; +} + +/* Buttons +*/ + +.btn { + display: inline-block; + background: -webkit-linear-gradient(top, rgba(40, 40, 40, 0.3), rgba(35, 35, 35, 0.3) 50%, rgba(10, 10, 10, 0.3) 50%, rgba(0, 0, 0, 0.3)); + padding: 8px 18px; + border-radius: 50px; + border: 2px solid rgba(0, 0, 0, 0.7); + border-bottom: 2px solid rgba(0, 0, 0, 0.7); + border-top: 2px solid rgba(0, 0, 0, 1); + color: rgba(255, 255, 255, 0.8); + font-family: Helvetica, Arial, sans-serif; + font-weight: bold; + font-size: 13px; + text-decoration: none; + text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.75); + box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.05); +} + +.btn:hover { + background: -webkit-linear-gradient(top, rgba(40, 40, 40, 0.6), rgba(35, 35, 35, 0.6) 50%, rgba(10, 10, 10, 0.8) 50%, rgba(0, 0, 0, 0.8)); +} + +.btn .icon { + display: inline-block; + width: 16px; + height: 16px; + margin: 1px 8px 0 0; + float: left; +} + +.btn-github .icon { + opacity: 0.6; + background: url("../images/blacktocat.png") 0 0 no-repeat; +} + +/* Links + a, a:hover, a:visited +*/ + +a { + color: #63c0f5; + text-shadow: 0 0 5px rgba(104, 182, 255, 0.5); +} + +/* Clearfix */ + +.cf:before, .cf:after { + content:""; + display:table; +} + +.cf:after { + clear:both; +} + +.cf { + zoom:1; +} \ No newline at end of file From 20b2a34ca2b030d089208fb64e919d9e963d004c Mon Sep 17 00:00:00 2001 From: scribu Date: Sun, 4 Nov 2012 23:59:08 +0200 Subject: [PATCH 002/194] remove params.json; going to use Jekyll manually --- params.json | 1 - 1 file changed, 1 deletion(-) delete mode 100644 params.json diff --git a/params.json b/params.json deleted file mode 100644 index c136bf41..00000000 --- a/params.json +++ /dev/null @@ -1 +0,0 @@ -{"note":"Don't delete this file! It's used internally to help with page regeneration.","google":"UA-962663-21","tagline":"A command line interface for WordPress","name":"wp-cli","body":"What is wp-cli?\r\n--------------\r\n\r\nwp-cli is a set of command-line tools for managing WordPress installations. You can update plugins, set up multisite installs, update posts and much more.\r\n\r\nVisit the [wiki](https://github.com/wp-cli/wp-cli/wiki) for more information.\r\n\r\nRequirements\r\n============\r\n\r\n* PHP >= 5.3\r\n* WP >= 3.3\r\n\r\nInstalling\r\n==========\r\n\r\n**Via PEAR:**\r\n\r\n```sh\r\nsudo pear config-set auto_discover 1\r\nsudo pear install wp-cli.github.com/pear/wpcli\r\n```\r\n\r\n**Via GIT:**\r\n\r\n```sh\r\ngit clone --recursive git://github.com/wp-cli/wp-cli.git ~/git/wp-cli\r\ncd ~/git/wp-cli\r\nsudo utils/dev-build\r\n```\r\n\r\nYou can replace `~/git/wp-cli` with whatever you want.\r\n\r\nMAMP, XAMP, etc.\r\n-----------\r\n\r\nIf the `php` command is not available, you can try finding an appropriate binary:\r\n\r\n```sh\r\n./utils/find-php\r\n```\r\n\r\nThen, create an environment variable called `WP_CLI_PHP` with the path found by `find-php`.\r\n\r\nIn a UNIX environment, you would do this by adding the following line to your `.bashrc` file:\r\n\r\n```sh\r\nWP_CLI_PHP=/path/to/php-binary\r\n```\r\n\r\nUsing\r\n=====\r\n\r\nGo into a WordPress root folder:\r\n\r\n```\r\ncd /var/www/wp/\r\n```\r\n\r\nTyping `wp help` should show you an output similar to this:\r\n\r\n```\r\nExample usage:\r\n\twp google-sitemap [build|help] ...\r\n\twp core [update|help] ...\r\n\twp home [help] ...\r\n\twp option [add|update|delete|get|help] ...\r\n\twp plugin [status|activate|deactivate|install|delete|update|help] ...\r\n\twp theme [status|details|activate|help] ...\r\n```\r\n\r\nSo this tells us which commands are installed: eg. google-sitemap, core, home, ...\r\nBetween brackets you can see their sub commands. \r\n\r\nLet's for example try to install the hello dolly plugin from wordpress.org:\r\n\r\n```\r\nwp plugin install hello-dolly\r\n```\r\n\r\nOutput:\r\n\r\n```\r\nInstalling Hello Dolly (1.5)\r\n\r\nDownloading install package from http://downloads.WordPress.org/plugin/hello-dolly.1.5.zip ...\r\nUnpacking the package ...\r\nInstalling the plugin ...\r\n\r\nSuccess: The plugin is successfully installed\r\n```\r\n\r\nMultisite\r\n---------\r\n\r\nOn a multisite installation, you need to pass a --blog parameter, so that WP knows which site it's supposed to be operating on:\r\n\r\n```\r\nwp theme status --blog=localhost/wp/test\r\n```\r\n\r\nIf you have a subdomain installation, it would look like this:\r\n\r\n```\r\nwp theme status --blog=test.example.com\r\n```\r\n\r\nIf you're usually working on the same site most of the time, you can put the url of that site in a file called 'wp-cli-blog' in your root WP dir:\r\n\r\n```\r\necho 'test.example.com' > wp-cli-blog\r\n```\r\n\r\nThen, you can call `wp` without the --blog parameter again:\r\n\r\n```\r\nwp theme status\r\n```\r\n\r\nAdding commands\r\n===============\r\n\r\nAdding commands to wp-cli is very easy. You can even add them from within your own plugin.\r\nYou can find more information about adding commands in the [Commands Cookbook](https://github.com/wp-cli/wp-cli/wiki/Commands-Cookbook) on our Wiki.\r\n\r\n**Please share the commands you make, issue a pull request to get them included in wp-cli by default.**\r\n\r\nChangelog\r\n=========\r\n\r\n**0.6**\r\n\r\n- added `wp post` and `wp post-meta`\r\n- added `wp user-meta`\r\n- added `wp blog create`\r\n- added `wp export`\r\n- added `wp transient`\r\n- added `wp db optimize` and `wp db repair`\r\n- added `wp db create`, `wp db drop` and `wp db reset`\r\n- added `wp db import`\r\n- added `wp theme install` and `wp theme update`\r\n- added `wp core install_network`\r\n- added `wp core update_db`\r\n- added `--json` option to several subcommands\r\n- added `--network` option to `wp plugin activate`\r\n- added `--require` global parameter\r\n- fixed `wp plugin update`\r\n- fixed \"out of memory\" error\r\n- misc bugfixes and optimizations\r\n- man pages (not in PEAR package)\r\n\r\n**0.5**\r\n\r\n- added `wp user`\r\n- added `wp core download`\r\n- added `wp core config`\r\n- added `wp plugin update --all`\r\n- added `wp theme update`\r\n- added `wp db import`\r\n- added `--url` `--path` and `--user` global parameters\r\n- various bugfixes\r\n\r\n**0.4**\r\n\r\n- added `wp eval` and `wp eval-file`\r\n- added `wp export`\r\n- added `wp core install`\r\n- fixed `wp core update`\r\n- added `--dev` flag to `wp plugin install`\r\n- added `wp plugin uninstall`\r\n- fixed `wp plugin install` and `wp plugin update`\r\n\r\n**0.3**\r\n\r\n- added `wp sql`\r\n- improved `wp option`\r\n- pear installer\r\n\r\n**0.2**\r\n\r\n- added multisite support\r\n- improved `wp plugin` and `wp theme`\r\n- added `wp generate`\r\n- added `wp core version`\r\n- added `wp --version`\r\n- added bash completion script\r\n\r\n**0.1**\r\n\r\n- initial release\r\n\r\nContributors\r\n------------\r\n\r\n- [Contributor list](https://github.com/wp-cli/wp-cli/contributors)\r\n- [Contributor guide](https://github.com/wp-cli/wp-cli/wiki/Commands-Cookbook)\r\n"} \ No newline at end of file From 002751d8e9e7ac90f550d8d3ebea526eeb74ee98 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 00:03:08 +0200 Subject: [PATCH 003/194] change CNAME to www.wp-cli.org --- CNAME | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CNAME b/CNAME index 07dab832..2d42b569 100644 --- a/CNAME +++ b/CNAME @@ -1 +1 @@ -wp-cli.org +www.wp-cli.org From 5695756f0e5924b934a3aba9c3d54a0d37f62dd8 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 00:04:18 +0200 Subject: [PATCH 004/194] change title --- index.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index e2464a9b..0903288f 100644 --- a/index.html +++ b/index.html @@ -8,7 +8,7 @@ - wp-cli by wp-cli + wp-cli - A command line interface for WordPress @@ -252,4 +252,4 @@

Changelog

- \ No newline at end of file + From 880ac5d7232ff60677adc0bb44540295976df43c Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 00:11:58 +0200 Subject: [PATCH 005/194] add github settings to _config.yml --- _config.yml | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 _config.yml diff --git a/_config.yml b/_config.yml new file mode 100644 index 00000000..008eb109 --- /dev/null +++ b/_config.yml @@ -0,0 +1,3 @@ +safe: true +lsi: false +pygments: true From 02de298ab8c96d753bc3d738354d106e86db7fc2 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 00:12:17 +0200 Subject: [PATCH 006/194] ignore _site dir --- .gitignore | 1 + 1 file changed, 1 insertion(+) create mode 100644 .gitignore diff --git a/.gitignore b/.gitignore new file mode 100644 index 00000000..0baf0152 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +/_site From 74ead4eb2af6071eb813b569a45f51d31b5dda3a Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 00:34:57 +0200 Subject: [PATCH 007/194] replace index.html with index.md --- _layouts/default.html | 48 ++++++++ index.html | 255 ------------------------------------------ index.md | 196 ++++++++++++++++++++++++++++++++ 3 files changed, 244 insertions(+), 255 deletions(-) create mode 100644 _layouts/default.html delete mode 100644 index.html create mode 100644 index.md diff --git a/_layouts/default.html b/_layouts/default.html new file mode 100644 index 00000000..93c824c7 --- /dev/null +++ b/_layouts/default.html @@ -0,0 +1,48 @@ + + + + + + + + + + + {{ page.title }} + + + + +
+
+

wp-cli

+

A command line interface for WordPress

+ +
+ Download as .zip + Download as .tar.gz + View on GitHub +
+
+
+ +
+
+ + {{ content }} + +
+
+ + + + + diff --git a/index.html b/index.html deleted file mode 100644 index 0903288f..00000000 --- a/index.html +++ /dev/null @@ -1,255 +0,0 @@ - - - - - - - - - - - wp-cli - A command line interface for WordPress - - - - -
-
-

wp-cli

-

A command line interface for WordPress

- -
- Download as .zip - Download as .tar.gz - View on GitHub -
-
-
- -
-
-

What is wp-cli?

- -

wp-cli is a set of command-line tools for managing WordPress installations. You can update plugins, set up multisite installs, update posts and much more.

- -

Visit the wiki for more information.

- -

Requirements

- -
    -
  • PHP >= 5.3
    • -
  • WP >= 3.3
    • -

Installing

- -

Via PEAR:

- -
sudo pear config-set auto_discover 1
-sudo pear install wp-cli.github.com/pear/wpcli
-
- -

Via GIT:

- -
git clone --recursive git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
-cd ~/git/wp-cli
-sudo utils/dev-build
-
- -

You can replace ~/git/wp-cli with whatever you want.

- -

MAMP, XAMP, etc.

- -

If the php command is not available, you can try finding an appropriate binary:

- -
./utils/find-php
-
- -

Then, create an environment variable called WP_CLI_PHP with the path found by find-php.

- -

In a UNIX environment, you would do this by adding the following line to your .bashrc file:

- -
WP_CLI_PHP=/path/to/php-binary
-
- -

Using

- -

Go into a WordPress root folder:

- -
cd /var/www/wp/
-
- -

Typing wp help should show you an output similar to this:

- -
Example usage:
-    wp google-sitemap [build|help] ...
-    wp core [update|help] ...
-    wp home [help] ...
-    wp option [add|update|delete|get|help] ...
-    wp plugin [status|activate|deactivate|install|delete|update|help] ...
-    wp theme [status|details|activate|help] ...
-
- -

So this tells us which commands are installed: eg. google-sitemap, core, home, ... -Between brackets you can see their sub commands.

- -

Let's for example try to install the hello dolly plugin from wordpress.org:

- -
wp plugin install hello-dolly
-
- -

Output:

- -
Installing Hello Dolly (1.5)
-
-Downloading install package from http://downloads.WordPress.org/plugin/hello-dolly.1.5.zip ...
-Unpacking the package ...
-Installing the plugin ...
-
-Success: The plugin is successfully installed
-
- -

Multisite

- -

On a multisite installation, you need to pass a --blog parameter, so that WP knows which site it's supposed to be operating on:

- -
wp theme status --blog=localhost/wp/test
-
- -

If you have a subdomain installation, it would look like this:

- -
wp theme status --blog=test.example.com
-
- -

If you're usually working on the same site most of the time, you can put the url of that site in a file called 'wp-cli-blog' in your root WP dir:

- -
echo 'test.example.com' > wp-cli-blog
-
- -

Then, you can call wp without the --blog parameter again:

- -
wp theme status
-
- -

Adding commands

- -

Adding commands to wp-cli is very easy. You can even add them from within your own plugin. -You can find more information about adding commands in the Commands Cookbook on our Wiki.

- -

Please share the commands you make, issue a pull request to get them included in wp-cli by default.

- -

Changelog

- -

0.6

- -
    -
  • added wp post and wp post-meta -
    • -
  • added wp user-meta -
    • -
  • added wp blog create -
    • -
  • added wp export -
    • -
  • added wp transient -
    • -
  • added wp db optimize and wp db repair -
    • -
  • added wp db create, wp db drop and wp db reset -
    • -
  • added wp db import -
    • -
  • added wp theme install and wp theme update -
    • -
  • added wp core install_network -
    • -
  • added wp core update_db -
    • -
  • added --json option to several subcommands
    • -
  • added --network option to wp plugin activate -
    • -
  • added --require global parameter
    • -
  • fixed wp plugin update -
    • -
  • fixed "out of memory" error
    • -
  • misc bugfixes and optimizations
    • -
  • man pages (not in PEAR package)
    • -

0.5

- -
    -
  • added wp user -
    • -
  • added wp core download -
    • -
  • added wp core config -
    • -
  • added wp plugin update --all -
    • -
  • added wp theme update -
    • -
  • added wp db import -
    • -
  • added --url --path and --user global parameters
    • -
  • various bugfixes
    • -

0.4

- -
    -
  • added wp eval and wp eval-file -
    • -
  • added wp export -
    • -
  • added wp core install -
    • -
  • fixed wp core update -
    • -
  • added --dev flag to wp plugin install -
    • -
  • added wp plugin uninstall -
    • -
  • fixed wp plugin install and wp plugin update -
    • -

0.3

- -
    -
  • added wp sql -
    • -
  • improved wp option -
    • -
  • pear installer
    • -

0.2

- -
    -
  • added multisite support
    • -
  • improved wp plugin and wp theme -
    • -
  • added wp generate -
    • -
  • added wp core version -
    • -
  • added wp --version -
    • -
  • added bash completion script
    • -

0.1

- -
    -
  • initial release
    • -

Contributors

- - -
-
- - - - - - diff --git a/index.md b/index.md new file mode 100644 index 00000000..cc153268 --- /dev/null +++ b/index.md @@ -0,0 +1,196 @@ +What is wp-cli? +--------------- + +wp-cli is a set of command-line tools for managing WordPress installations. You can update plugins, set up multisite installs, update posts and much more. + +Visit the [wiki](https://github.com/wp-cli/wp-cli/wiki) for more information. + +Requirements +============ + +* PHP >= 5.3 +* WP >= 3.3 + +Installing +========== + +**Via PEAR:** + +```sh +sudo pear config-set auto_discover 1 +sudo pear install wp-cli.github.com/pear/wpcli +``` + +**Via GIT:** + +```sh +git clone --recursive git://github.com/wp-cli/wp-cli.git ~/git/wp-cli +cd ~/git/wp-cli +sudo utils/dev-build +``` + +You can replace `~/git/wp-cli` with whatever you want. + +MAMP, XAMP, etc. +----------- + +If the `php` command is not available, you can try finding an appropriate binary: + +```sh +./utils/find-php +``` + +Then, create an environment variable called `WP_CLI_PHP` with the path found by `find-php`. + +In a UNIX environment, you would do this by adding the following line to your `.bashrc` file: + +```sh +WP_CLI_PHP=/path/to/php-binary +``` + +Using +===== + +Go into a WordPress root folder: + +``` +cd /var/www/wp/ +``` + +Typing `wp help` should show you an output similar to this: + +``` +Example usage: + wp google-sitemap [build|help] ... + wp core [update|help] ... + wp home [help] ... + wp option [add|update|delete|get|help] ... + wp plugin [status|activate|deactivate|install|delete|update|help] ... + wp theme [status|details|activate|help] ... +``` + +So this tells us which commands are installed: eg. google-sitemap, core, home, ... +Between brackets you can see their sub commands. + +Let's for example try to install the hello dolly plugin from wordpress.org: + +``` +wp plugin install hello-dolly +``` + +Output: + +``` +Installing Hello Dolly (1.5) + +Downloading install package from http://downloads.WordPress.org/plugin/hello-dolly.1.5.zip ... +Unpacking the package ... +Installing the plugin ... + +Success: The plugin is successfully installed +``` + +Multisite +--------- + +On a multisite installation, you need to pass a --blog parameter, so that WP knows which site it's supposed to be operating on: + +``` +wp theme status --blog=localhost/wp/test +``` + +If you have a subdomain installation, it would look like this: + +``` +wp theme status --blog=test.example.com +``` + +If you're usually working on the same site most of the time, you can put the url of that site in a file called 'wp-cli-blog' in your root WP dir: + +``` +echo 'test.example.com' > wp-cli-blog +``` + +Then, you can call `wp` without the --blog parameter again: + +``` +wp theme status +``` + +Adding commands +=============== + +Adding commands to wp-cli is very easy. You can even add them from within your own plugin. +You can find more information about adding commands in the [Commands Cookbook](https://github.com/wp-cli/wp-cli/wiki/Commands-Cookbook) on our Wiki. + +**Please share the commands you make, issue a pull request to get them included in wp-cli by default.** + +Changelog +========= + +**0.6** + +- added `wp post` and `wp post-meta` +- added `wp user-meta` +- added `wp blog create` +- added `wp export` +- added `wp transient` +- added `wp db optimize` and `wp db repair` +- added `wp db create`, `wp db drop` and `wp db reset` +- added `wp db import` +- added `wp theme install` and `wp theme update` +- added `wp core install_network` +- added `wp core update_db` +- added `--json` option to several subcommands +- added `--network` option to `wp plugin activate` +- added `--require` global parameter +- fixed `wp plugin update` +- fixed "out of memory" error +- misc bugfixes and optimizations +- man pages (not in PEAR package) + +**0.5** + +- added `wp user` +- added `wp core download` +- added `wp core config` +- added `wp plugin update --all` +- added `wp theme update` +- added `wp db import` +- added `--url` `--path` and `--user` global parameters +- various bugfixes + +**0.4** + +- added `wp eval` and `wp eval-file` +- added `wp export` +- added `wp core install` +- fixed `wp core update` +- added `--dev` flag to `wp plugin install` +- added `wp plugin uninstall` +- fixed `wp plugin install` and `wp plugin update` + +**0.3** + +- added `wp sql` +- improved `wp option` +- pear installer + +**0.2** + +- added multisite support +- improved `wp plugin` and `wp theme` +- added `wp generate` +- added `wp core version` +- added `wp --version` +- added bash completion script + +**0.1** + +- initial release + +Contributors +------------ + +- [Contributor list](https://github.com/wp-cli/wp-cli/contributors) +- [Contributor guide](https://github.com/wp-cli/wp-cli/wiki/Commands-Cookbook) From 859a2e20d4f802fb6f6bc80bdcb1aa4d95a7ff6a Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 00:35:44 +0200 Subject: [PATCH 008/194] Revert "change CNAME to www.wp-cli.org" This reverts commit 002751d8e9e7ac90f550d8d3ebea526eeb74ee98. --- CNAME | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CNAME b/CNAME index 2d42b569..07dab832 100644 --- a/CNAME +++ b/CNAME @@ -1 +1 @@ -www.wp-cli.org +wp-cli.org From facf5727a8f75147a893295d1b87acad054a479d Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 00:59:37 +0200 Subject: [PATCH 009/194] rename index.md back to index.html and call markdownify --- _layouts/default.html | 2 +- index.md => index.html | 53 +++++++++++++++++++++++------------------- 2 files changed, 30 insertions(+), 25 deletions(-) rename index.md => index.html (94%) diff --git a/_layouts/default.html b/_layouts/default.html index 93c824c7..d0387e5c 100644 --- a/_layouts/default.html +++ b/_layouts/default.html @@ -29,7 +29,7 @@

A command line interface for WordPress

- {{ content }} + {{ content | markdownify }}
diff --git a/index.md b/index.html similarity index 94% rename from index.md rename to index.html index cc153268..93ec4126 100644 --- a/index.md +++ b/index.html @@ -1,3 +1,8 @@ +--- +layout: default +title: wp-cli - A command line interface for WordPress +--- + What is wp-cli? --------------- @@ -16,18 +21,18 @@ **Via PEAR:** -```sh +
 sudo pear config-set auto_discover 1
 sudo pear install wp-cli.github.com/pear/wpcli
-```
+
**Via GIT:** -```sh +
 git clone --recursive git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
 cd ~/git/wp-cli
 sudo utils/dev-build
-```
+
You can replace `~/git/wp-cli` with whatever you want. @@ -36,30 +41,30 @@ If the `php` command is not available, you can try finding an appropriate binary: -```sh +
 ./utils/find-php
-```
+
Then, create an environment variable called `WP_CLI_PHP` with the path found by `find-php`. In a UNIX environment, you would do this by adding the following line to your `.bashrc` file: -```sh +
 WP_CLI_PHP=/path/to/php-binary
-```
+
Using ===== Go into a WordPress root folder: -``` +
 cd /var/www/wp/
-```
+
Typing `wp help` should show you an output similar to this: -``` +
 Example usage:
 	wp google-sitemap [build|help] ...
 	wp core [update|help] ...
@@ -67,20 +72,20 @@
 	wp option [add|update|delete|get|help] ...
 	wp plugin [status|activate|deactivate|install|delete|update|help] ...
 	wp theme [status|details|activate|help] ...
-```
+
So this tells us which commands are installed: eg. google-sitemap, core, home, ... Between brackets you can see their sub commands. Let's for example try to install the hello dolly plugin from wordpress.org: -``` +
 wp plugin install hello-dolly
-```
+
Output: -``` +
 Installing Hello Dolly (1.5)
 
 Downloading install package from http://downloads.WordPress.org/plugin/hello-dolly.1.5.zip ...
@@ -88,34 +93,34 @@
 Installing the plugin ...
 
 Success: The plugin is successfully installed
-```
+
Multisite --------- On a multisite installation, you need to pass a --blog parameter, so that WP knows which site it's supposed to be operating on: -``` +
 wp theme status --blog=localhost/wp/test
-```
+
If you have a subdomain installation, it would look like this: -``` +
 wp theme status --blog=test.example.com
-```
+
If you're usually working on the same site most of the time, you can put the url of that site in a file called 'wp-cli-blog' in your root WP dir: -``` +
 echo 'test.example.com' > wp-cli-blog
-```
+
Then, you can call `wp` without the --blog parameter again: -``` +
 wp theme status
-```
+
Adding commands =============== From 02fc8e72ea8ff7ac76c9ad9b7fcbca6ff5976958 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 01:05:36 +0200 Subject: [PATCH 010/194] add header and footer partials --- _includes/footer.html | 15 +++++++++++++ _includes/header.html | 30 ++++++++++++++++++++++++++ _layouts/default.html | 49 +++---------------------------------------- 3 files changed, 48 insertions(+), 46 deletions(-) create mode 100644 _includes/footer.html create mode 100644 _includes/header.html diff --git a/_includes/footer.html b/_includes/footer.html new file mode 100644 index 00000000..dbadd381 --- /dev/null +++ b/_includes/footer.html @@ -0,0 +1,15 @@ + + + + + + + diff --git a/_includes/header.html b/_includes/header.html new file mode 100644 index 00000000..8b2904d4 --- /dev/null +++ b/_includes/header.html @@ -0,0 +1,30 @@ + + + + + + + + + + {{ page.title }} + + + + +
+
+

wp-cli

+

A command line interface for WordPress

+ +
+ Download as .zip + Download as .tar.gz + View on GitHub +
+
+
+ +
+
+ diff --git a/_layouts/default.html b/_layouts/default.html index d0387e5c..e2e3765a 100644 --- a/_layouts/default.html +++ b/_layouts/default.html @@ -1,48 +1,5 @@ - - - - - +{% include header.html %} - - - +{{ content | markdownify }} - {{ page.title }} - - - - -
-
-

wp-cli

-

A command line interface for WordPress

- -
- Download as .zip - Download as .tar.gz - View on GitHub -
-
-
- -
-
- - {{ content | markdownify }} - -
-
- - - - - +{% include footer.html %} From 51f14d9dbd563b3ea0d87d9894b56a1845140a82 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 01:21:57 +0200 Subject: [PATCH 011/194] add blog templates --- _config.yml | 1 + _includes/header.html | 3 +-- _layouts/post.html | 5 +++++ _posts/2012-11-05-test.md | 4 ++++ blog.html | 10 ++++++++++ 5 files changed, 21 insertions(+), 2 deletions(-) create mode 100644 _layouts/post.html create mode 100644 _posts/2012-11-05-test.md create mode 100644 blog.html diff --git a/_config.yml b/_config.yml index 008eb109..8f52696f 100644 --- a/_config.yml +++ b/_config.yml @@ -1,3 +1,4 @@ safe: true lsi: false pygments: true +url: http://wp-cli.org diff --git a/_includes/header.html b/_includes/header.html index 8b2904d4..629b7f37 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -18,9 +18,8 @@

wp-cli

A command line interface for WordPress

- Download as .zip - Download as .tar.gz View on GitHub + Blog
diff --git a/_layouts/post.html b/_layouts/post.html new file mode 100644 index 00000000..7ee00ac3 --- /dev/null +++ b/_layouts/post.html @@ -0,0 +1,5 @@ +{% include header.html %} + +{{ content }} + +{% include footer.html %} diff --git a/_posts/2012-11-05-test.md b/_posts/2012-11-05-test.md new file mode 100644 index 00000000..43d20ef8 --- /dev/null +++ b/_posts/2012-11-05-test.md @@ -0,0 +1,4 @@ +--- +layout: post +title: Testing +--- diff --git a/blog.html b/blog.html new file mode 100644 index 00000000..a37b4cb1 --- /dev/null +++ b/blog.html @@ -0,0 +1,10 @@ +--- +layout: default +title: wp-cli - Blog +--- + +
    + {% for post in site.posts %} +
  • {{ post.date | date_to_string }} » {{ post.title }}
    • + {% endfor %} +
From 15a4f7350480c5639a52705833ff3c46c2478150 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 01:29:25 +0200 Subject: [PATCH 012/194] don't really need site.url --- _config.yml | 1 - _includes/header.html | 4 ++-- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index 8f52696f..008eb109 100644 --- a/_config.yml +++ b/_config.yml @@ -1,4 +1,3 @@ safe: true lsi: false pygments: true -url: http://wp-cli.org diff --git a/_includes/header.html b/_includes/header.html index 629b7f37..27fd3a21 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -14,12 +14,12 @@
-

wp-cli

+

wp-cli

A command line interface for WordPress

View on GitHub - Blog + Blog
From 7abe56d28c4c0a3f8305607eafb9594d027ffbb5 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 01:31:09 +0200 Subject: [PATCH 013/194] fix stylesheet path for blog posts --- _includes/header.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/_includes/header.html b/_includes/header.html index 27fd3a21..4d7d8c9d 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -3,9 +3,9 @@ - - - + + + {{ page.title }} From c1da120eb910d2a78f0cef92dda89094b92e41a8 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 01:53:40 +0200 Subject: [PATCH 014/194] replace test blog post with new-home one --- _posts/2012-11-05-new-home.md | 6 ++++++ _posts/2012-11-05-test.md | 4 ---- 2 files changed, 6 insertions(+), 4 deletions(-) create mode 100644 _posts/2012-11-05-new-home.md delete mode 100644 _posts/2012-11-05-test.md diff --git a/_posts/2012-11-05-new-home.md b/_posts/2012-11-05-new-home.md new file mode 100644 index 00000000..fc1c815f --- /dev/null +++ b/_posts/2012-11-05-new-home.md @@ -0,0 +1,6 @@ +--- +layout: post +title: New Home +--- + +Welcome to the new website for the wp-cli project! diff --git a/_posts/2012-11-05-test.md b/_posts/2012-11-05-test.md deleted file mode 100644 index 43d20ef8..00000000 --- a/_posts/2012-11-05-test.md +++ /dev/null @@ -1,4 +0,0 @@ ---- -layout: post -title: Testing ---- From e96499c3d25a0ceedda8c3f95a67cbe18658278f Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 01:54:09 +0200 Subject: [PATCH 015/194] add Atom feed --- _config.yml | 2 ++ _includes/header.html | 5 ++++- atom.xml | 31 +++++++++++++++++++++++++++++++ 3 files changed, 37 insertions(+), 1 deletion(-) create mode 100644 atom.xml diff --git a/_config.yml b/_config.yml index 008eb109..7df33990 100644 --- a/_config.yml +++ b/_config.yml @@ -1,3 +1,5 @@ safe: true lsi: false pygments: true +url: http://wp-cli.org +permalink: /blog/:title.html diff --git a/_includes/header.html b/_includes/header.html index 4d7d8c9d..0cbe27f4 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -1,4 +1,5 @@ - + + @@ -7,6 +8,8 @@ + + {{ page.title }} diff --git a/atom.xml b/atom.xml new file mode 100644 index 00000000..9e88114b --- /dev/null +++ b/atom.xml @@ -0,0 +1,31 @@ +--- +layout: nil +--- + + + + wp-cli + + + {{ site.time | date_to_xmlschema }} + {{ site.url }} + + scribu + mail@scribu.net + + + {% for post in site.posts %} + + {{ site.url }}{{ post.id }} + + {{ post.title | xml_escape }} + {{ post.date | date_to_xmlschema }} + + scribu + {{ site.url }} + + {{ post.content | xml_escape }} + + {% endfor %} + + From 8be8e67ddd664eeb9d034f5c5672bdb84a79c5c7 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 01:57:22 +0200 Subject: [PATCH 016/194] move link to wiki to header --- _includes/header.html | 1 + index.html | 5 ----- 2 files changed, 1 insertion(+), 5 deletions(-) diff --git a/_includes/header.html b/_includes/header.html index 0cbe27f4..a95558f5 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -23,6 +23,7 @@

A command line interface for WordPress

View on GitHub Blog + Wiki
diff --git a/index.html b/index.html index 93ec4126..c4fb996d 100644 --- a/index.html +++ b/index.html @@ -3,13 +3,8 @@ title: wp-cli - A command line interface for WordPress --- -What is wp-cli? ---------------- - wp-cli is a set of command-line tools for managing WordPress installations. You can update plugins, set up multisite installs, update posts and much more. -Visit the [wiki](https://github.com/wp-cli/wp-cli/wiki) for more information. - Requirements ============ From 22c31480e9456ed880f31d197ae564be842eb81e Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 02:09:32 +0200 Subject: [PATCH 017/194] make header link blend better --- stylesheets/stylesheet.css | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/stylesheets/stylesheet.css b/stylesheets/stylesheet.css index a54a6397..10d930f7 100644 --- a/stylesheets/stylesheet.css +++ b/stylesheets/stylesheet.css @@ -57,6 +57,11 @@ header h1 { -webkit-font-smoothing: antialiased; } +header h1 a { + color: inherit; + text-decoration: none +} + header h1:before { content: "./ "; font-size: 24px; @@ -244,4 +249,4 @@ a { .cf { zoom:1; -} \ No newline at end of file +} From c4d6eb8c9f9436efe4bd4573515d28b85f07b403 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 5 Nov 2012 02:24:35 +0200 Subject: [PATCH 018/194] content updates --- _posts/2012-11-05-new-home.md | 2 +- index.html | 33 ++++++++++++++++----------------- 2 files changed, 17 insertions(+), 18 deletions(-) diff --git a/_posts/2012-11-05-new-home.md b/_posts/2012-11-05-new-home.md index fc1c815f..a19c8f2a 100644 --- a/_posts/2012-11-05-new-home.md +++ b/_posts/2012-11-05-new-home.md @@ -1,6 +1,6 @@ --- layout: post -title: New Home +title: New Home | wp-cli --- Welcome to the new website for the wp-cli project! diff --git a/index.html b/index.html index c4fb996d..1f737617 100644 --- a/index.html +++ b/index.html @@ -3,13 +3,13 @@ title: wp-cli - A command line interface for WordPress --- -wp-cli is a set of command-line tools for managing WordPress installations. You can update plugins, set up multisite installs, update posts and much more. +wp-cli is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, update posts and much more. Requirements ============ * PHP >= 5.3 -* WP >= 3.3 +* WordPress >= 3.3 Installing ========== @@ -57,22 +57,22 @@ cd /var/www/wp/ -Typing `wp help` should show you an output similar to this: +Typing `wp` should show you output similar to this: 
-Example usage:
-	wp google-sitemap [build|help] ...
-	wp core [update|help] ...
-	wp home [help] ...
-	wp option [add|update|delete|get|help] ...
-	wp plugin [status|activate|deactivate|install|delete|update|help] ...
-	wp theme [status|details|activate|help] ...
+Available commands:
+    wp blog create|delete
+    wp cache add|decr|delete|flush|get|incr|replace|set|type
+    wp comment create|delete|trash|untrash|spam|unspam|approve|unapprove|count|status|last
+    wp core download|config|is-installed|install|install-network|version|update|update-db
+    wp db create|drop|reset|optimize|repair|connect|cli|query|export|import
+    wp eval-file
+    ...
+
+See 'wp help <command>' for more information on a specific command.
-So this tells us which commands are installed: eg. google-sitemap, core, home, ... -Between brackets you can see their sub commands. - -Let's for example try to install the hello dolly plugin from wordpress.org: +Let's try to install the Hello Dolly plugin from wordpress.org: 
 wp plugin install hello-dolly
@@ -86,14 +86,13 @@
 Downloading install package from http://downloads.WordPress.org/plugin/hello-dolly.1.5.zip ...
 Unpacking the package ...
 Installing the plugin ...
-
-Success: The plugin is successfully installed
+Plugin installed successfully.
Multisite --------- -On a multisite installation, you need to pass a --blog parameter, so that WP knows which site it's supposed to be operating on: +On a multisite installation, you need to pass a `--blog` parameter, so that wp-cli knows which site it's supposed to be operating on: 
 wp theme status --blog=localhost/wp/test

From 52e76d7f137399dd21185f8d8f99b1148783b919 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 5 Nov 2012 02:33:45 +0200
Subject: [PATCH 019/194] move 'wp-cli' pre/suffix out of title strings

---
 _includes/header.html         | 4 ++--
 _posts/2012-11-05-new-home.md | 2 +-
 blog.html                     | 2 +-
 index.html                    | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/_includes/header.html b/_includes/header.html
index a95558f5..3894329a 100644
--- a/_includes/header.html
+++ b/_includes/header.html
@@ -10,7 +10,7 @@
 
 		
 
-		{{ page.title }}
+		{{ page.title }} | wp-cli
 	
 
 	
@@ -22,8 +22,8 @@ 
A command line interface for WordPress

 
 			

 			View on GitHub
-			Blog
 			Wiki
+			Blog
 			

 		
 		
diff --git a/_posts/2012-11-05-new-home.md b/_posts/2012-11-05-new-home.md
index a19c8f2a..fc1c815f 100644
--- a/_posts/2012-11-05-new-home.md
+++ b/_posts/2012-11-05-new-home.md
@@ -1,6 +1,6 @@
 ---
 layout: post
-title: New Home | wp-cli
+title: New Home
 ---
 
 Welcome to the new website for the wp-cli project!
diff --git a/blog.html b/blog.html
index a37b4cb1..b90b0f91 100644
--- a/blog.html
+++ b/blog.html
@@ -1,6 +1,6 @@
 ---
 layout: default
-title: wp-cli - Blog
+title: Blog
 ---
 
 
    
diff --git a/index.html b/index.html
index 1f737617..9f7f4d16 100644
--- a/index.html
+++ b/index.html
@@ -1,6 +1,6 @@
 ---
 layout: default
-title: wp-cli - A command line interface for WordPress
+title: Command line interface for WordPress
 ---
 
 wp-cli is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, update posts and much more.

From a91453e7284553d693c9f53191adfb3f43537868 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 5 Nov 2012 02:34:29 +0200
Subject: [PATCH 020/194] add explanation for site

---
 _posts/2012-11-05-new-home.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/_posts/2012-11-05-new-home.md b/_posts/2012-11-05-new-home.md
index fc1c815f..80740690 100644
--- a/_posts/2012-11-05-new-home.md
+++ b/_posts/2012-11-05-new-home.md
@@ -4,3 +4,7 @@ title: New Home
 ---
 
 Welcome to the new website for the wp-cli project!
+
+wp-cli already had a public code repository, an issue tracker and a wiki. The only thing that was missing was a blog for publishing release notes and other news.
+
+Since github has built-in support for [Jekyll](https://github.com/mojombo/jekyll/wiki), I decided to use that. The code for this website is also public: [github.com/wp-cli/wp-cli.github.com](https://github.com/wp-cli/wp-cli.github.com)

From 80b465c454fb511e6581ba9134258c11e2465ebe Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 5 Nov 2012 02:53:45 +0200
Subject: [PATCH 021/194] show content on blog page

---
 blog.html                  | 17 ++++++++++++-----
 stylesheets/stylesheet.css | 10 ++++++++++
 2 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/blog.html b/blog.html
index b90b0f91..c3ee6cd2 100644
--- a/blog.html
+++ b/blog.html
@@ -3,8 +3,15 @@
 title: Blog
 ---
 
-
      
-	{% for post in site.posts %}
-	
    • {{ post.date | date_to_string }} » {{ post.title }}
      • 
-	{% endfor %}
-
    
+{% for post in site.posts limit: 10 %}
+
    
+	
    
+	
    {{ post.title }}
    
+	{{ post.date | date_to_string }}
+	
    
+
+	
    
+	{{ post.content }}	
+	
    
+
    
+{% endfor %}
diff --git a/stylesheets/stylesheet.css b/stylesheets/stylesheet.css
index 10d930f7..d0e33bb2 100644
--- a/stylesheets/stylesheet.css
+++ b/stylesheets/stylesheet.css
@@ -250,3 +250,13 @@ a {
 .cf {
   zoom:1;
 }
+
+/* Blog */
+
+article + article {
+  margin-top: 40px;
+}
+
+.post-header span {
+  color: #666;
+}

From 942892571bc0ee436064c57fbd202a2d3bfb8484 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 5 Nov 2012 03:03:13 +0200
Subject: [PATCH 022/194] add title and date to single posts

---
 _layouts/post.html | 11 ++++++++++-
 blog.html          |  4 ++--
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/_layouts/post.html b/_layouts/post.html
index 7ee00ac3..acfac697 100644
--- a/_layouts/post.html
+++ b/_layouts/post.html
@@ -1,5 +1,14 @@
 {% include header.html %}
 
-{{ content }}
+
    
+	
    
+		
    {{ page.title }}
    
+		{{ page.date | date_to_string }}
+	
    
+
+	
    
+	{{ content }}
+	
    
+
    
 
 {% include footer.html %}
diff --git a/blog.html b/blog.html
index c3ee6cd2..3a7d4875 100644
--- a/blog.html
+++ b/blog.html
@@ -6,8 +6,8 @@
 {% for post in site.posts limit: 10 %}
 
    
 	
    
-	
    {{ post.title }}
    
-	{{ post.date | date_to_string }}
+		
    {{ post.title }}
    
+		{{ post.date | date_to_string }}
 	
    
 
 	
    

From afcc282d193339ac3093310301a53eecbd9ef387 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 5 Nov 2012 03:05:23 +0200
Subject: [PATCH 023/194] bold wp-cli

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 9f7f4d16..de4a8e0a 100644
--- a/index.html
+++ b/index.html
@@ -3,7 +3,7 @@
 title: Command line interface for WordPress
 ---
 
-wp-cli is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, update posts and much more.
+**wp-cli** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, update posts and much more.
 
 Requirements
 ============

From a6d3647405b2a03cc0f722b058574f45eb47ad7f Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 5 Nov 2012 03:07:34 +0200
Subject: [PATCH 024/194] it seems Jekyll also has some texturizing

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index de4a8e0a..26585e1e 100644
--- a/index.html
+++ b/index.html
@@ -110,7 +110,7 @@
 echo 'test.example.com' > wp-cli-blog
-Then, you can call `wp` without the --blog parameter again: +Then, you can call `wp` without the `--blog` parameter again: 
 wp theme status

From 2e7dc382e89389a280908563f5713c7cb1aa23d0 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 5 Nov 2012 03:09:37 +0200
Subject: [PATCH 025/194] remove unused javascripts folder

---
 javascripts/main.js | 1 -
 1 file changed, 1 deletion(-)
 delete mode 100644 javascripts/main.js

diff --git a/javascripts/main.js b/javascripts/main.js
deleted file mode 100644
index d8135d37..00000000
--- a/javascripts/main.js
+++ /dev/null
@@ -1 +0,0 @@
-console.log('This would be the main JS file.');

From 4bbe148afbb0251a6cf1132494b364376b584fdd Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 5 Nov 2012 03:12:34 +0200
Subject: [PATCH 026/194] more links

---
 _posts/2012-11-05-new-home.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_posts/2012-11-05-new-home.md b/_posts/2012-11-05-new-home.md
index 80740690..126bfd6e 100644
--- a/_posts/2012-11-05-new-home.md
+++ b/_posts/2012-11-05-new-home.md
@@ -5,6 +5,6 @@ title: New Home
 
 Welcome to the new website for the wp-cli project!
 
-wp-cli already had a public code repository, an issue tracker and a wiki. The only thing that was missing was a blog for publishing release notes and other news.
+wp-cli already has a public [code repository](https://github.com/wp-cli/wp-cli), an [issue tracker](https://github.com/wp-cli/wp-cli/issues) and a [wiki](https://github.com/wp-cli/wp-cli/wiki). The only thing that was missing was a blog for publishing release notes and other news.
 
 Since github has built-in support for [Jekyll](https://github.com/mojombo/jekyll/wiki), I decided to use that. The code for this website is also public: [github.com/wp-cli/wp-cli.github.com](https://github.com/wp-cli/wp-cli.github.com)

From 76ca53c8041b35868024d42235ab8b28abe84bbb Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 5 Nov 2012 03:17:50 +0200
Subject: [PATCH 027/194] move blog.html to blog/index.html

---
 _includes/header.html        | 2 +-
 blog.html => blog/index.html | 0
 2 files changed, 1 insertion(+), 1 deletion(-)
 rename blog.html => blog/index.html (100%)

diff --git a/_includes/header.html b/_includes/header.html
index 3894329a..c45d829f 100644
--- a/_includes/header.html
+++ b/_includes/header.html
@@ -23,7 +23,7 @@ 
A command line interface for WordPress

 			

 			View on GitHub
 			Wiki
-			Blog
+			Blog
 			

 		
 		
diff --git a/blog.html b/blog/index.html
similarity index 100%
rename from blog.html
rename to blog/index.html

From f1b18814997cae16cd4335717e8f6d8fdb0b7046 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 5 Nov 2012 03:50:44 +0200
Subject: [PATCH 028/194] avoid repetition

---
 index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.html b/index.html
index 26585e1e..e5f0a0b9 100644
--- a/index.html
+++ b/index.html
@@ -3,7 +3,7 @@
 title: Command line interface for WordPress
 ---
 
-**wp-cli** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, update posts and much more.
+**wp-cli** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, create posts and much more.
 
 Requirements
 ============

From e78de2522183a1099ce157f9e770dbf85a933af1 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 5 Nov 2012 19:26:02 +0200
Subject: [PATCH 029/194] update PEAR channel URL

---
 index.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index e5f0a0b9..7de55d67 100644
--- a/index.html
+++ b/index.html
@@ -17,8 +17,8 @@
 **Via PEAR:**
 
 
-sudo pear config-set auto_discover 1
-sudo pear install wp-cli.github.com/pear/wpcli
+sudo pear channel-discover wp-cli.org/pear
+sudo pear install wpcli/wpcli
 

 
 **Via GIT:**

From c458e50ebe633b6814169d7cb739819616f47c23 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 10 Nov 2012 11:51:07 +0200
Subject: [PATCH 030/194] add author to blog posts

---
 _layouts/post.html            | 2 +-
 _posts/2012-11-05-new-home.md | 1 +
 blog/index.html               | 2 +-
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/_layouts/post.html b/_layouts/post.html
index acfac697..198802fb 100644
--- a/_layouts/post.html
+++ b/_layouts/post.html
@@ -3,7 +3,7 @@
 

 	

 		
{{ page.title }}

-		{{ page.date | date_to_string }}
+		by {{page.author}}, on {{ page.date | date_to_string }}
 	

 
 	

diff --git a/_posts/2012-11-05-new-home.md b/_posts/2012-11-05-new-home.md
index 126bfd6e..2ae059d7 100644
--- a/_posts/2012-11-05-new-home.md
+++ b/_posts/2012-11-05-new-home.md
@@ -1,6 +1,7 @@
 ---
 layout: post
 title: New Home
+author: scribu
 ---
 
 Welcome to the new website for the wp-cli project!
diff --git a/blog/index.html b/blog/index.html
index 3a7d4875..fce38e04 100644
--- a/blog/index.html
+++ b/blog/index.html
@@ -7,7 +7,7 @@
 

 	

 		
{{ post.title }}

-		{{ post.date | date_to_string }}
+		by {{post.author}}, on {{ post.date | date_to_string }}
 	

 
 	


From 4fdcc0fe242f864a13eb2ed064ec9df62e9e5d28 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 10 Nov 2012 11:52:02 +0200
Subject: [PATCH 031/194] add wp shell blog post

---
 _posts/2012-11-10-wp-shell.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 _posts/2012-11-10-wp-shell.md

diff --git a/_posts/2012-11-10-wp-shell.md b/_posts/2012-11-10-wp-shell.md
new file mode 100644
index 00000000..8b899d1e
--- /dev/null
+++ b/_posts/2012-11-10-wp-shell.md
@@ -0,0 +1,24 @@
+---
+layout: post
+title: Interactive WordPress Debugging
+author: scribu
+---
+
+A new command [landed](https://github.com/wp-cli/wp-cli/pull/89) in wp-cli a few days ago, called `shell`. When you run `wp shell`, a REPL will start, in which you can run any WordPress function.
+
+The major advantage over `wp eval` and `wp eval-file` is that it's interactive: you immediately see the result of the previous command; it's also stored in the special `$_` variable, which you can use in the next command and so on.
+
+Here's a contrived example session:
+
+
+scribu@air:~/wp/core$ wp shell
+Type "exit" to close session.
+wp> get_bloginfo('wpurl')
+'http://wp.dev/core'
+wp> $_ . '/feed/'
+'http://wp.dev/core/feed/'
+wp> exit
+scribu@air:~/wp/core$
+

+
+wp-shell will be available in the 0.7 release of wp-cli, but if you want to try it out right now, clone the [latest version](https://github.com/wp-cli/wp-cli) from github. If you have suggestions for making it better, don't hesitate to open issues and pull requests. 

From 151419d4db644f9cfb4a85e40aeefef037b20595 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 10 Nov 2012 12:02:39 +0200
Subject: [PATCH 032/194] use github's favicon, instead of just nothing

---
 _includes/header.html | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/_includes/header.html b/_includes/header.html
index c45d829f..a03c842f 100644
--- a/_includes/header.html
+++ b/_includes/header.html
@@ -8,6 +8,8 @@
 		
 		
 
+		
+
 		
 
 		{{ page.title }} | wp-cli

From 74adb73c1ea591c9266b5c2e7b3af0aa56fcdffa Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 11 Nov 2012 15:54:12 +0200
Subject: [PATCH 033/194] use indentation instead of 
 tag

---
 _posts/2012-11-10-wp-shell.md | 18 ++++++++----------
 1 file changed, 8 insertions(+), 10 deletions(-)

diff --git a/_posts/2012-11-10-wp-shell.md b/_posts/2012-11-10-wp-shell.md
index 8b899d1e..1fc08c4e 100644
--- a/_posts/2012-11-10-wp-shell.md
+++ b/_posts/2012-11-10-wp-shell.md
@@ -10,15 +10,13 @@ The major advantage over `wp eval` and `wp eval-file` is that it's interactive:
 
 Here's a contrived example session:
 
-
-scribu@air:~/wp/core$ wp shell
-Type "exit" to close session.
-wp> get_bloginfo('wpurl')
-'http://wp.dev/core'
-wp> $_ . '/feed/'
-'http://wp.dev/core/feed/'
-wp> exit
-scribu@air:~/wp/core$
-

+	scribu@air:~/wp/core$ wp shell
+	Type "exit" to close session.
+	wp> get_bloginfo('wpurl')
+	'http://wp.dev/core'
+	wp> $_ . '/feed/'
+	'http://wp.dev/core/feed/'
+	wp> exit
+	scribu@air:~/wp/core$
 
 wp-shell will be available in the 0.7 release of wp-cli, but if you want to try it out right now, clone the [latest version](https://github.com/wp-cli/wp-cli) from github. If you have suggestions for making it better, don't hesitate to open issues and pull requests. 

From 417f053cf32b35adcc33977fea89984ae995975b Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 11 Nov 2012 15:58:16 +0200
Subject: [PATCH 034/194] use kramdown as markdown parser; needed for twitter
 embeds

---
 _config.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_config.yml b/_config.yml
index 7df33990..ee450e24 100644
--- a/_config.yml
+++ b/_config.yml
@@ -1,5 +1,6 @@
 safe: true
 lsi: false
 pygments: true
+markdown: kramdown
 url: http://wp-cli.org
 permalink: /blog/:title.html

From fa13496020487bf2c44c3c200d5ac91086920dd7 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 11 Nov 2012 16:15:26 +0200
Subject: [PATCH 035/194] add older 0.6 release post

---
 _posts/2012-09-05-version-0.6.md |  85 +++++++++++++++++++++++++++++++
 images/wp-cli-man-page.png       | Bin 0 -> 40062 bytes
 2 files changed, 85 insertions(+)
 create mode 100644 _posts/2012-09-05-version-0.6.md
 create mode 100644 images/wp-cli-man-page.png

diff --git a/_posts/2012-09-05-version-0.6.md b/_posts/2012-09-05-version-0.6.md
new file mode 100644
index 00000000..2534ee49
--- /dev/null
+++ b/_posts/2012-09-05-version-0.6.md
@@ -0,0 +1,85 @@
+---
+layout: post
+title: Version 0.6
+author: scribu
+---
+
+Got a lot of exciting news regarding wp-cli, so let's get right into it:
+
+### The Reach
+
+
+
+
+Besides Dreamhost, it's used and recommended by the WordPress.com VIP team to all their clients.
+
+Oh, and it's also used in a Juju Charm for [deploying WordPress in the cloud](http://jujucharms.com/charms/precise/wordpress). :D
+
+### The Latest
+
+Version 0.6 just became available, and it's full of goodies. Some highlights:
+
+- added `wp post` and `wp post-meta`
+- added `wp user-meta`
+- added `wp blog create`
+- added `wp export`
+- added `wp transient`
+- added `wp db optimize` and `wp db repair`
+- added `wp db create`, `wp db drop` and `wp db reset`
+- added `wp db import`
+- added `wp theme install` and `wp theme update`
+- added `wp core install_network`
+- added `--json` option for several subcommands
+- added `--network` and `--all` options for `wp plugin activate`
+- fixed "out of memory" error
+
+A full list of [fixed issues](https://github.com/wp-cli/wp-cli/issues?milestone=4&page=2&state=closed) can be found on github.
+
+#### The `--require`
+
+An interesting but easily overlooked feature is the new `--require` global parameter. Say you wrote a custom command called `chores` for yourself:
+
+	WP_CLI::add_command( 'chores', 'My_Chores' );
+
+	class My_Chores extends WP_CLI_Command {
+
+		function do_laundry() {
+			...
+		}
+		
+		function wash_dishes() {
+			...
+		}
+	}
+
+Now, where do you put this code, so that wp-cli can reach it? You could put it in a plugin, but if you have multiple WP installations, you'd have to install that plugin on each one. You could put it inside one of the wp-cli directories, but that creates problems when you want to update. Here's what you could do instead:
+
+	wp --require=/path/to/chores.php chores do_laundry
+
+The `--require` parameter will load that PHP file at just the right time for the command to work as you'd expect.
+
+#### The Manual
+
+The help system has been improved. When you do `wp help core config`, an actual man page will show up, with details about each parameter:
+
+![wp-cli man-page](/images/wp-cli-man-page.png)
+
+Unfortunately, this doesn't work if you install wp-cli via the PEAR package, because PEAR doesn't know how to handle them. :(
+
+### The Community
+
+Most of the new commands you see in this release were actually implemented by other people. A few examples:
+
+[Mike Shroeder](https://github.com/getsource) was responsible for `wp theme install`, the much loved `wp plugin update --all` and a bunch of other things.
+
+[Michael Williamson](https://github.com/mwilliamson-red-gate) wrote `wp user-meta` and came up with the idea for the `--json` parameter.
+
+[Evan Anderson](https://github.com/kidfiction) contributed `wp blog create`, [Tott](https://github.com/tott) contributed `wp export` and [Zack Tollman](https://github.com/tollmanz) contributed `wp transient`.
+
+And that's just the beginning. The [full list of contributors](https://github.com/wp-cli/wp-cli/graphs/contributors?from=2011-09-04&to=2012-09-02&type=a) can be found on github.
+
+### The Future
+
+The first thing I want to tackle next is revamping the install process. I'm also thinking of ditching PEAR entirely; it's just too limited: no man pages, no command auto-complete etc.
+
+Beyond that, there are a lot of gaps to fill: `wp import`, `wp blog update`, `wp attachment` anyone?
diff --git a/images/wp-cli-man-page.png b/images/wp-cli-man-page.png
new file mode 100644
index 0000000000000000000000000000000000000000..daa4a9113b8ebc892361566618512639cd029473
GIT binary patch
literal 40062
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
z
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
LZHl_%`RxAyNk+7z

literal 0
HcmV?d00001


From 90c8be53102adc454fa41b0c0d1e3fb523e3a851 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 11 Nov 2012 16:23:10 +0200
Subject: [PATCH 036/194] show only excerpt on blog index

---
 blog/index.html | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/blog/index.html b/blog/index.html
index fce38e04..fcd20fa8 100644
--- a/blog/index.html
+++ b/blog/index.html
@@ -10,8 +10,8 @@ 
{{ post.title }}

 		by {{post.author}}, on {{ post.date | date_to_string }}
 	

 
-	

-	{{ post.content }}	
-	

+	
{{ post.content | strip_html | truncatewords: 55 }}

+
+	
Read more...

 

 {% endfor %}

From a263be36d2f1118b267613c644e6d0072e0fe17f Mon Sep 17 00:00:00 2001
From: scribu 
Date: Tue, 13 Nov 2012 16:54:37 +0200
Subject: [PATCH 037/194] fix link to closed issues

---
 _posts/2012-09-05-version-0.6.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_posts/2012-09-05-version-0.6.md b/_posts/2012-09-05-version-0.6.md
index 2534ee49..9a7c6b31 100644
--- a/_posts/2012-09-05-version-0.6.md
+++ b/_posts/2012-09-05-version-0.6.md
@@ -33,7 +33,7 @@ Version 0.6 just became available, and it's full of goodies. Some highlights:
 - added `--network` and `--all` options for `wp plugin activate`
 - fixed "out of memory" error
 
-A full list of [fixed issues](https://github.com/wp-cli/wp-cli/issues?milestone=4&page=2&state=closed) can be found on github.
+A full list of [fixed issues](https://github.com/wp-cli/wp-cli/issues?milestone=4&state=closed) can be found on github.
 
 #### The `--require`
 

From 8689f17dfa85121f0f3b8be8a4b53c3bf6332f82 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Tue, 13 Nov 2012 17:45:29 +0200
Subject: [PATCH 038/194] use tabs for CSS indentation

---
 stylesheets/stylesheet.css | 257 ++++++++++++++++++-------------------
 1 file changed, 128 insertions(+), 129 deletions(-)

diff --git a/stylesheets/stylesheet.css b/stylesheets/stylesheet.css
index d0e33bb2..bc93b79f 100644
--- a/stylesheets/stylesheet.css
+++ b/stylesheets/stylesheet.css
@@ -1,60 +1,60 @@
 body {
-  margin: 0;
-  padding: 0;
-  background: #151515 url("../images/bkg.png") 0 0;
-  color: #eaeaea;
-  font: 16px;
-  line-height: 1.5;
-  font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace;
+	margin: 0;
+	padding: 0;
+	background: #151515 url("../images/bkg.png") 0 0;
+	color: #eaeaea;
+	font: 16px;
+	line-height: 1.5;
+	font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace;
 }
 
 /* General & 'Reset' Stuff */
 
 .container {
-  width: 90%;
-  max-width: 600px;
-  margin: 0 auto;
+	width: 90%;
+	max-width: 600px;
+	margin: 0 auto;
 }
 
 section {
-  display: block;
-  margin: 0 0 20px 0;
+	display: block;
+	margin: 0 0 20px 0;
 }
 
 h1, h2, h3, h4, h5, h6 {
-  margin: 0 0 20px;
+	margin: 0 0 20px;
 }
 
 li {
-  line-height: 1.4 ;
+	line-height: 1.4;
 }
 
 /* Header, 

-   header   - container
-   h1       - project name
-   h2       - project description
+	 header   - container
+	 h1       - project name
+	 h2       - project description
 */
 
 header {
-  background: rgba(0, 0, 0, 0.1);
-  width: 100%;
-  border-bottom: 1px dashed #b5e853;
-  padding: 20px 0;
-  margin: 0 0 40px 0;
+	background: rgba(0, 0, 0, 0.1);
+	width: 100%;
+	border-bottom: 1px dashed #b5e853;
+	padding: 20px 0;
+	margin: 0 0 40px 0;
 }
 
 header h1 {
-  font-size: 30px;
-  line-height: 1.5;
-  margin: 0 0 0 -40px;
-  font-weight: bold;
-  font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace;
-  color: #b5e853;
-  text-shadow: 0 1px 1px rgba(0, 0, 0, 0.1),
-               0 0 5px rgba(181, 232, 83, 0.1),
-               0 0 10px rgba(181, 232, 83, 0.1);
-  letter-spacing: -1px;
-  -webkit-font-smoothing: antialiased;
+	font-size: 30px;
+	line-height: 1.5;
+	margin: 0 0 0 -40px;
+	font-weight: bold;
+	font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace;
+	color: #b5e853;
+	text-shadow: 0 1px 1px rgba(0, 0, 0, 0.1),
+	             0 0 5px rgba(181, 232, 83, 0.1),
+	             0 0 10px rgba(181, 232, 83, 0.1);
+	letter-spacing: -1px;
+	-webkit-font-smoothing: antialiased;
 }
 
 header h1 a {
@@ -63,200 +63,199 @@ header h1 a {
 }
 
 header h1:before {
-  content: "./ ";
-  font-size: 24px;
+	content: "./ ";
+	font-size: 24px;
 }
 
 header h2 {
-  font-size: 18px;
-  font-weight: 300;
-  color: #666;
+	font-size: 18px;
+	font-weight: 300;
+	color: #666;
 }
 
 #downloads .btn {
-  display: inline-block;
-  text-align: center;
-  margin: 0;
+	display: inline-block;
+	text-align: center;
+	margin: 0;
 }
 
 /* Main Content
 */
 
 #main_content {
-  width: 100%;
-  -webkit-font-smoothing: antialiased;
+	width: 100%;
+	-webkit-font-smoothing: antialiased;
 }
 section img {
-  max-width: 100%
+	max-width: 100%
 }
 
 h1, h2, h3, h4, h5, h6 {
-  font-weight: normal;
-  font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace;
-  color: #b5e853;
-  letter-spacing: -0.03em;
-  text-shadow: 0 1px 1px rgba(0, 0, 0, 0.1),
-               0 0 5px rgba(181, 232, 83, 0.1),
-               0 0 10px rgba(181, 232, 83, 0.1);
+	font-weight: normal;
+	font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace;
+	color: #b5e853;
+	letter-spacing: -0.03em;
+	text-shadow: 0 1px 1px rgba(0, 0, 0, 0.1),
+	             0 0 5px rgba(181, 232, 83, 0.1),
+	             0 0 10px rgba(181, 232, 83, 0.1);
 }
 
 #main_content h1 {
-  font-size: 30px;
+	font-size: 30px;
 }
 
 #main_content h2 {
-  font-size: 24px;
+	font-size: 24px;
 }
 
 #main_content h3 {
-  font-size: 18px;
+	font-size: 18px;
 }
 
 #main_content h4 {
-  font-size: 14px;
+	font-size: 14px;
 }
 
 #main_content h5 {
-  font-size: 12px;
-  text-transform: uppercase;
-  margin: 0 0 5px 0;
+	font-size: 12px;
+	text-transform: uppercase;
+	margin: 0 0 5px 0;
 }
 
 #main_content h6 {
-  font-size: 12px;
-  text-transform: uppercase;
-  color: #999;
-  margin: 0 0 5px 0;
+	font-size: 12px;
+	text-transform: uppercase;
+	color: #999;
+	margin: 0 0 5px 0;
 }
 
 dt {
-  font-style: italic;
-  font-weight: bold;
+	font-style: italic;
+	font-weight: bold;
 }
 
 ul li {
-  list-style: none;
+	list-style: none;
 }
 
 ul li:before {
-  content: ">>";
-  font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace;
-  font-size: 13px;
-  color: #b5e853;
-  margin-left: -37px;
-  margin-right: 21px;
-  line-height: 16px;
+	content: ">>";
+	font-family: Monaco, "Bitstream Vera Sans Mono", "Lucida Console", Terminal, monospace;
+	font-size: 13px;
+	color: #b5e853;
+	margin-left: -37px;
+	margin-right: 21px;
+	line-height: 16px;
 }
 
 blockquote {
-  color: #aaa;
-  padding-left: 10px;
-  border-left: 1px dotted #666;
+	color: #aaa;
+	padding-left: 10px;
+	border-left: 1px dotted #666;
 }
 
 pre {
-  background: rgba(0, 0, 0, 0.9);
-  border: 1px solid rgba(255, 255, 255, 0.15);
-  padding: 10px;
-  font-size: 14px;
-  color: #b5e853;
-  border-radius: 2px;
-  -moz-border-radius: 2px;
-  -webkit-border-radius: 2px;
-  text-wrap: normal;
-  overflow: auto;
-  overflow-y: hidden;
+	background: rgba(0, 0, 0, 0.9);
+	border: 1px solid rgba(255, 255, 255, 0.15);
+	padding: 10px;
+	font-size: 14px;
+	color: #b5e853;
+	border-radius: 2px;
+	-moz-border-radius: 2px;
+	-webkit-border-radius: 2px;
+	text-wrap: normal;
+	overflow: auto;
+	overflow-y: hidden;
 }
 
 table {
-  width: 100%;
-  margin: 0 0 20px 0;
+	width: 100%;
+	margin: 0 0 20px 0;
 }
 
 th {
-  text-align: left;
-  border-bottom: 1px dashed #b5e853;
-  padding: 5px 10px;
+	text-align: left;
+	border-bottom: 1px dashed #b5e853;
+	padding: 5px 10px;
 }
 
 td {
-  padding: 5px 10px;
+	padding: 5px 10px;
 }
 
 hr {
-  height: 0;
-  border: 0;
-  border-bottom: 1px dashed #b5e853;
-  color: #b5e853;
+	height: 0;
+	border: 0;
+	border-bottom: 1px dashed #b5e853;
+	color: #b5e853;
 }
 
-/* Buttons
-*/
+/* Buttons */
 
 .btn {
-  display: inline-block;
-  background: -webkit-linear-gradient(top, rgba(40, 40, 40, 0.3), rgba(35, 35, 35, 0.3) 50%, rgba(10, 10, 10, 0.3) 50%, rgba(0, 0, 0, 0.3));
-  padding: 8px 18px;
-  border-radius: 50px;
-  border: 2px solid rgba(0, 0, 0, 0.7);
-  border-bottom: 2px solid rgba(0, 0, 0, 0.7);
-  border-top: 2px solid rgba(0, 0, 0, 1);
-  color: rgba(255, 255, 255, 0.8);
-  font-family: Helvetica, Arial, sans-serif;
-  font-weight: bold;
-  font-size: 13px;
-  text-decoration: none;
-  text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.75);
-  box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.05);
+	display: inline-block;
+	background: -webkit-linear-gradient(top, rgba(40, 40, 40, 0.3), rgba(35, 35, 35, 0.3) 50%, rgba(10, 10, 10, 0.3) 50%, rgba(0, 0, 0, 0.3));
+	padding: 8px 18px;
+	border-radius: 50px;
+	border: 2px solid rgba(0, 0, 0, 0.7);
+	border-bottom: 2px solid rgba(0, 0, 0, 0.7);
+	border-top: 2px solid rgba(0, 0, 0, 1);
+	color: rgba(255, 255, 255, 0.8);
+	font-family: Helvetica, Arial, sans-serif;
+	font-weight: bold;
+	font-size: 13px;
+	text-decoration: none;
+	text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.75);
+	box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.05);
 }
 
 .btn:hover {
-  background: -webkit-linear-gradient(top, rgba(40, 40, 40, 0.6), rgba(35, 35, 35, 0.6) 50%, rgba(10, 10, 10, 0.8) 50%, rgba(0, 0, 0, 0.8));
+	background: -webkit-linear-gradient(top, rgba(40, 40, 40, 0.6), rgba(35, 35, 35, 0.6) 50%, rgba(10, 10, 10, 0.8) 50%, rgba(0, 0, 0, 0.8));
 }
 
 .btn .icon {
-  display: inline-block;
-  width: 16px;
-  height: 16px;
-  margin: 1px 8px 0 0;
-  float: left;
+	display: inline-block;
+	width: 16px;
+	height: 16px;
+	margin: 1px 8px 0 0;
+	float: left;
 }
 
 .btn-github .icon {
-  opacity: 0.6;
-  background: url("../images/blacktocat.png") 0 0 no-repeat;
+	opacity: 0.6;
+	background: url("../images/blacktocat.png") 0 0 no-repeat;
 }
 
 /* Links
-   a, a:hover, a:visited
+	 a, a:hover, a:visited
 */
 
 a {
-  color: #63c0f5;
-  text-shadow: 0 0 5px rgba(104, 182, 255, 0.5);
+	color: #63c0f5;
+	text-shadow: 0 0 5px rgba(104, 182, 255, 0.5);
 }
 
 /* Clearfix */
 
 .cf:before, .cf:after {
-  content:"";
-  display:table;
+	content:"";
+	display:table;
 }
 
 .cf:after {
-  clear:both;
+	clear:both;
 }
 
 .cf {
-  zoom:1;
+	zoom:1;
 }
 
 /* Blog */
 
 article + article {
-  margin-top: 40px;
+	margin-top: 40px;
 }
 
 .post-header span {
-  color: #666;
+	color: #666;
 }

From ad41511bd16529cb9cb43be723b6aa739e240718 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Tue, 13 Nov 2012 20:22:59 +0200
Subject: [PATCH 039/194] fix margins in post header

---
 stylesheets/stylesheet.css | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/stylesheets/stylesheet.css b/stylesheets/stylesheet.css
index bc93b79f..4b6c10c6 100644
--- a/stylesheets/stylesheet.css
+++ b/stylesheets/stylesheet.css
@@ -256,6 +256,15 @@ article + article {
 	margin-top: 40px;
 }
 
+.post-header {
+	margin-bottom: 20px;
+}
+
+.post-header h2 {
+	margin-bottom: 0;
+}
+
 .post-header span {
 	color: #666;
 }
+

From 6d74e1919d25bcbf477dd089397e772d2d4b71d3 Mon Sep 17 00:00:00 2001
From: Andreas Creten 
Date: Tue, 13 Nov 2012 19:52:21 +0100
Subject: [PATCH 040/194] Added footer

---
 _includes/footer.html      | 6 +++++-
 stylesheets/stylesheet.css | 6 ++++++
 2 files changed, 11 insertions(+), 1 deletion(-)

diff --git a/_includes/footer.html b/_includes/footer.html
index dbadd381..e5dc025d 100644
--- a/_includes/footer.html
+++ b/_includes/footer.html
@@ -1,6 +1,10 @@
 			
 		

-
+		
 		
+
diff --git a/_includes/footer.html b/_includes/footer.html
index e5dc025d..c1e1801b 100644
--- a/_includes/footer.html
+++ b/_includes/footer.html
@@ -5,15 +5,7 @@
 				Original code by Andreas Creten. Project maintained by Cristi Burcă.
 			
 		
-		
-		
+
+		{% include analytics.html %}
 	
 

From 7df2e297562203439b0c34d13952184972869134 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 28 Dec 2012 12:52:19 +0200
Subject: [PATCH 050/194] stylesheets/stylesheet.css ->
 assets/css/stylesheet.css

---
 _includes/header.html                      |   4 +-
 _posts/2012-09-05-version-0.6.md           |   2 +-
 {stylesheets => assets/css}/stylesheet.css |   4 +-
 {images => assets/img}/bkg.png             | Bin
 {images => assets/img}/blacktocat.png      | Bin
 {images => assets/img}/wp-cli-man-page.png | Bin
 stylesheets/pygment_trac.css               |  68 ---------------------
 7 files changed, 4 insertions(+), 74 deletions(-)
 rename {stylesheets => assets/css}/stylesheet.css (97%)
 rename {images => assets/img}/bkg.png (100%)
 rename {images => assets/img}/blacktocat.png (100%)
 rename {images => assets/img}/wp-cli-man-page.png (100%)
 delete mode 100644 stylesheets/pygment_trac.css

diff --git a/_includes/header.html b/_includes/header.html
index a03c842f..05899569 100644
--- a/_includes/header.html
+++ b/_includes/header.html
@@ -4,9 +4,7 @@
 		
 		
 
-		
-		
-		
+		
 
 		
 
diff --git a/_posts/2012-09-05-version-0.6.md b/_posts/2012-09-05-version-0.6.md
index 2ecde9c3..60a008fe 100644
--- a/_posts/2012-09-05-version-0.6.md
+++ b/_posts/2012-09-05-version-0.6.md
@@ -42,7 +42,7 @@ The `--require` parameter will load that PHP file at just the right time for the
 
 The help system has been improved. When you do `wp help core config`, an actual man page will show up, with details about each parameter:
 
-![wp-cli man-page](/images/wp-cli-man-page.png)
+![wp-cli man-page](/assets/img/wp-cli-man-page.png)
 
 Unfortunately, this doesn't work if you install wp-cli via the PEAR package, because PEAR doesn't know how to handle them. :(
 
diff --git a/stylesheets/stylesheet.css b/assets/css/stylesheet.css
similarity index 97%
rename from stylesheets/stylesheet.css
rename to assets/css/stylesheet.css
index c818e12b..5d0fad0f 100644
--- a/stylesheets/stylesheet.css
+++ b/assets/css/stylesheet.css
@@ -1,7 +1,7 @@
 body {
 	margin: 0;
 	padding: 0;
-	background: #151515 url("../images/bkg.png") 0 0;
+	background: #151515 url("../img/bkg.png") 0 0;
 	color: #eaeaea;
 	font: 16px;
 	line-height: 1.5;
@@ -229,7 +229,7 @@ hr {
 
 .btn-github .icon {
 	opacity: 0.6;
-	background: url("../images/blacktocat.png") 0 0 no-repeat;
+	background: url("../img/blacktocat.png") 0 0 no-repeat;
 }
 
 /* Links
diff --git a/images/bkg.png b/assets/img/bkg.png
similarity index 100%
rename from images/bkg.png
rename to assets/img/bkg.png
diff --git a/images/blacktocat.png b/assets/img/blacktocat.png
similarity index 100%
rename from images/blacktocat.png
rename to assets/img/blacktocat.png
diff --git a/images/wp-cli-man-page.png b/assets/img/wp-cli-man-page.png
similarity index 100%
rename from images/wp-cli-man-page.png
rename to assets/img/wp-cli-man-page.png
diff --git a/stylesheets/pygment_trac.css b/stylesheets/pygment_trac.css
deleted file mode 100644
index d1df6a21..00000000
--- a/stylesheets/pygment_trac.css
+++ /dev/null
@@ -1,68 +0,0 @@
-.highlight .c { color: #999988; font-style: italic } /* Comment */
-.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */
-.highlight .k { font-weight: bold } /* Keyword */
-.highlight .o { font-weight: bold } /* Operator */
-.highlight .cm { color: #999988; font-style: italic } /* Comment.Multiline */
-.highlight .cp { color: #999999; font-weight: bold } /* Comment.Preproc */
-.highlight .c1 { color: #999988; font-style: italic } /* Comment.Single */
-.highlight .cs { color: #999999; font-weight: bold; font-style: italic } /* Comment.Special */
-.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
-.highlight .gd .x { color: #000000; background-color: #ffaaaa } /* Generic.Deleted.Specific */
-.highlight .ge { font-style: italic } /* Generic.Emph */
-.highlight .gr { color: #aa0000 } /* Generic.Error */
-.highlight .gh { color: #999999 } /* Generic.Heading */
-.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
-.highlight .gi .x { color: #000000; background-color: #aaffaa } /* Generic.Inserted.Specific */
-.highlight .go { color: #888888 } /* Generic.Output */
-.highlight .gp { color: #555555 } /* Generic.Prompt */
-.highlight .gs { font-weight: bold } /* Generic.Strong */
-.highlight .gu { color: #800080; font-weight: bold; } /* Generic.Subheading */
-.highlight .gt { color: #aa0000 } /* Generic.Traceback */
-.highlight .kc { font-weight: bold } /* Keyword.Constant */
-.highlight .kd { font-weight: bold } /* Keyword.Declaration */
-.highlight .kn { font-weight: bold } /* Keyword.Namespace */
-.highlight .kp { font-weight: bold } /* Keyword.Pseudo */
-.highlight .kr { font-weight: bold } /* Keyword.Reserved */
-.highlight .kt { color: #445588; font-weight: bold } /* Keyword.Type */
-.highlight .m { color: #009999 } /* Literal.Number */
-.highlight .s { color: #d14 } /* Literal.String */
-.highlight .na { color: #008080 } /* Name.Attribute */
-.highlight .nb { color: #0086B3 } /* Name.Builtin */
-.highlight .nc { color: #445588; font-weight: bold } /* Name.Class */
-.highlight .no { color: #008080 } /* Name.Constant */
-.highlight .ni { color: #800080 } /* Name.Entity */
-.highlight .ne { color: #990000; font-weight: bold } /* Name.Exception */
-.highlight .nf { color: #990000; font-weight: bold } /* Name.Function */
-.highlight .nn { color: #555555 } /* Name.Namespace */
-.highlight .nt { color: #CBDFFF } /* Name.Tag */
-.highlight .nv { color: #008080 } /* Name.Variable */
-.highlight .ow { font-weight: bold } /* Operator.Word */
-.highlight .w { color: #bbbbbb } /* Text.Whitespace */
-.highlight .mf { color: #009999 } /* Literal.Number.Float */
-.highlight .mh { color: #009999 } /* Literal.Number.Hex */
-.highlight .mi { color: #009999 } /* Literal.Number.Integer */
-.highlight .mo { color: #009999 } /* Literal.Number.Oct */
-.highlight .sb { color: #d14 } /* Literal.String.Backtick */
-.highlight .sc { color: #d14 } /* Literal.String.Char */
-.highlight .sd { color: #d14 } /* Literal.String.Doc */
-.highlight .s2 { color: #d14 } /* Literal.String.Double */
-.highlight .se { color: #d14 } /* Literal.String.Escape */
-.highlight .sh { color: #d14 } /* Literal.String.Heredoc */
-.highlight .si { color: #d14 } /* Literal.String.Interpol */
-.highlight .sx { color: #d14 } /* Literal.String.Other */
-.highlight .sr { color: #009926 } /* Literal.String.Regex */
-.highlight .s1 { color: #d14 } /* Literal.String.Single */
-.highlight .ss { color: #990073 } /* Literal.String.Symbol */
-.highlight .bp { color: #999999 } /* Name.Builtin.Pseudo */
-.highlight .vc { color: #008080 } /* Name.Variable.Class */
-.highlight .vg { color: #008080 } /* Name.Variable.Global */
-.highlight .vi { color: #008080 } /* Name.Variable.Instance */
-.highlight .il { color: #009999 } /* Literal.Number.Integer.Long */
-
-.type-csharp .highlight .k { color: #0000FF }
-.type-csharp .highlight .kt { color: #0000FF }
-.type-csharp .highlight .nf { color: #000000; font-weight: normal }
-.type-csharp .highlight .nc { color: #2B91AF }
-.type-csharp .highlight .nn { color: #000000 }
-.type-csharp .highlight .s { color: #A31515 }
-.type-csharp .highlight .sc { color: #A31515 }

From f2e625578538022b4c9196e17534c39a9ccde9fd Mon Sep 17 00:00:00 2001
From: scribu 
Date: Tue, 1 Jan 2013 22:41:06 +0200
Subject: [PATCH 051/194] replace 'Original code' with 'Initial code', which
 seems more accurate

---
 _includes/footer.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_includes/footer.html b/_includes/footer.html
index c1e1801b..67a74fcb 100644
--- a/_includes/footer.html
+++ b/_includes/footer.html
@@ -2,7 +2,7 @@
 		
 		
 

From a81de5612be5c9825bc1e07c437c7b805c911531 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 28 Dec 2012 12:12:21 +0200
Subject: [PATCH 052/194] replace wp-cli-blog with wp-cli.yml

---
 index.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index f7879e8b..a9c6c12e 100644
--- a/index.html
+++ b/index.html
@@ -104,10 +104,10 @@
 wp theme status --url=test.example.com
-If you're usually working on the same site most of the time, you can put the url of that site in a file called 'wp-cli-blog' in your root WP dir: +If you're usually working on the same site most of the time, you can create a `wp-cli.yml` file in the root directory: 
-echo 'test.example.com' > wp-cli-blog
+url: test.example.com
Then, you can call `wp` without the `--url` parameter again: From d7b3805935d2a6ac6fb6130a36e74cce4ecb4082 Mon Sep 17 00:00:00 2001 From: scribu Date: Fri, 28 Dec 2012 12:30:32 +0200 Subject: [PATCH 053/194] add changelog for 0.8 --- index.html | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/index.html b/index.html index a9c6c12e..7f31739d 100644 --- a/index.html +++ b/index.html @@ -127,6 +127,33 @@ Changelog ========= +### [0.8](https://github.com/wp-cli/wp-cli/issues?milestone=6&state=closed) + +Commands: + +- added `wp search-replace` command +- added `wp cap` command +- added `wp user add-role` subcommand +- added `--role` parameter to `wp user remove-role` +- added `--ids` parameter to `wp user list` +- added `--post__in` parameter to `wp export` +- added `--str` parameter to most `wp db` subcommands +- removed community commands (`wp total-cache`, `wp super-cache`, `wp sitemap`) +- made `wp post update` accept multiple IDs +- fixed incorrect exit code from `wp core is-installed` in some cases +- fixed `wp user import-csv` +- fixed `wp theme update ` +- fixed `wp plugin update ` not reactivating the plugin + +Internals: + +- added support for `wp-cli.yml` config file +- bypass full-page caching plugins (pretend we're in wp-admin) +- disabled coloring when not in a TTY +- [Composer](http://getcomposer.org) compatibility +- added `wp --info` utility +- added unit tests for `wp core` subcommands + ### [0.7](https://github.com/wp-cli/wp-cli/issues?milestone=5&state=closed) Commands: From 42c8a6b6d00a49a578e3e5908d988b0bb541c21f Mon Sep 17 00:00:00 2001 From: scribu Date: Fri, 28 Dec 2012 12:44:10 +0200 Subject: [PATCH 054/194] move index.html to index.md --- _layouts/default.html | 2 +- index.html => index.md | 0 2 files changed, 1 insertion(+), 1 deletion(-) rename index.html => index.md (100%) diff --git a/_layouts/default.html b/_layouts/default.html index e2e3765a..7ee00ac3 100644 --- a/_layouts/default.html +++ b/_layouts/default.html @@ -1,5 +1,5 @@ {% include header.html %} -{{ content | markdownify }} +{{ content }} {% include footer.html %} diff --git a/index.html b/index.md similarity index 100% rename from index.html rename to index.md From 500d9591946e0cb7f6da29960391a17306bf6e72 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 31 Dec 2012 16:53:08 +0200 Subject: [PATCH 055/194] update changelog; add props --- index.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/index.md b/index.md index 7f31739d..898909c5 100644 --- a/index.md +++ b/index.md @@ -132,6 +132,7 @@ Changelog Commands: - added `wp search-replace` command +- added `wp scaffold` command. props [jmslbam](http://github.com/jmslbam) and [sebastiaandegeus](http://github.com/sebastiaandegeus) - added `wp cap` command - added `wp user add-role` subcommand - added `--role` parameter to `wp user remove-role` @@ -141,18 +142,18 @@ Commands: - removed community commands (`wp total-cache`, `wp super-cache`, `wp sitemap`) - made `wp post update` accept multiple IDs - fixed incorrect exit code from `wp core is-installed` in some cases -- fixed `wp user import-csv` +- fixed `wp user import-csv`. props [danielbachhuber](http://github.com/danielbachhuber) - fixed `wp theme update ` - fixed `wp plugin update ` not reactivating the plugin Internals: - added support for `wp-cli.yml` config file -- bypass full-page caching plugins (pretend we're in wp-admin) +- bypass full-page caching plugins - disabled coloring when not in a TTY - [Composer](http://getcomposer.org) compatibility - added `wp --info` utility -- added unit tests for `wp core` subcommands +- added unit tests for `wp core` subcommands. props [mwilliamson](http://github.com/mwilliamson) ### [0.7](https://github.com/wp-cli/wp-cli/issues?milestone=5&state=closed) From e447ea7ec6e0954e79f5557e60b827ab84d4e3d6 Mon Sep 17 00:00:00 2001 From: scribu Date: Tue, 1 Jan 2013 22:10:23 +0200 Subject: [PATCH 056/194] add skeleton for /commands/ page --- commands/index.html | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 commands/index.html diff --git a/commands/index.html b/commands/index.html new file mode 100644 index 00000000..ec067990 --- /dev/null +++ b/commands/index.html @@ -0,0 +1,16 @@ +--- +layout: default +title: Built-in Commands +--- + + + + + + + + + + {% include cmd-list.html %} + +
CommandDescription
From b404f866a9e748fd926dc1c5174de6c8a01d4eb3 Mon Sep 17 00:00:00 2001 From: scribu Date: Tue, 1 Jan 2013 22:10:33 +0200 Subject: [PATCH 057/194] add link to /commands/ in header --- _includes/header.html | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/_includes/header.html b/_includes/header.html index 05899569..a1262bd7 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -21,9 +21,10 @@

wp-cli

A command line interface for WordPress

- View on GitHub - Wiki + Commands Blog + Source + Wiki
From 6951348e11eb67708c4b9af8c2b4cb8ac6bf1afe Mon Sep 17 00:00:00 2001 From: scribu Date: Tue, 1 Jan 2013 23:00:52 +0200 Subject: [PATCH 058/194] add cmd-list.html include --- _includes/cmd-list.html | 92 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 _includes/cmd-list.html diff --git a/_includes/cmd-list.html b/_includes/cmd-list.html new file mode 100644 index 00000000..542e864c --- /dev/null +++ b/_includes/cmd-list.html @@ -0,0 +1,92 @@ + + blog + Manage blogs in a multisite install. + + + cache + Manage the object cache. + + + cap + Manage user capabilities. + + + comment + Manage comments. + + + core + Download, install, update and otherwise manage WordPress proper. + + + db + Perform basic database operations. + + + eval + Execute arbitrary PHP code after loading WordPress. + + + eval-file + Load and execute a PHP file after loading WordPress. + + + export + Export content to a WXR file. + + + help + Get help on a certain topic. + + + home + Open the wp-cli homepage in your browser. + + + option + Manage WordPress options. + + + plugin + Manage plugins. + + + post + Manage posts. + + + post-meta + Manage post custom fields. + + + rewrite + Manage rewrite rules. + + + scaffold + Generate code for post types, taxonomies, etc. + + + search-replace + Search/replace strings in the database. + + + shell + Interactive PHP console. + + + theme + Manage themes. + + + transient + Manage WordPress transients. + + + user + Manage users. + + + user-meta + Manage user custom fields. + From cc883cb2f82c100be64b72097a69023ced5ab105 Mon Sep 17 00:00:00 2001 From: scribu Date: Wed, 2 Jan 2013 10:15:02 +0200 Subject: [PATCH 059/194] add utilities --- _utils/cmd-list.php | 26 ++++++++++++++++++++++++++ _utils/compare-cmd | 22 ++++++++++++++++++++++ _utils/syn-list.php | 26 ++++++++++++++++++++++++++ _utils/utils.php | 18 ++++++++++++++++++ 4 files changed, 92 insertions(+) create mode 100644 _utils/cmd-list.php create mode 100755 _utils/compare-cmd create mode 100644 _utils/syn-list.php create mode 100644 _utils/utils.php diff --git a/_utils/cmd-list.php b/_utils/cmd-list.php new file mode 100644 index 00000000..e1d39c08 --- /dev/null +++ b/_utils/cmd-list.php @@ -0,0 +1,26 @@ + + {$command['name']} + {$command['description']} + + +EOB; +} + diff --git a/_utils/compare-cmd b/_utils/compare-cmd new file mode 100755 index 00000000..744d512b --- /dev/null +++ b/_utils/compare-cmd @@ -0,0 +1,22 @@ +#!/bin/bash + +# utility for comparing commands between two different wp-cli versions. + +if [ $# -lt 3 ]; then + echo 'usage: ' + exit 1 +fi + +wp_path=$3 + +get_syn_list() { + git checkout $1 + wp --path=$wp_path --cmd-dump | php $(dirname $0)/syn-list.php +} + +get_syn_list $1 > /tmp/wp-cli-a +get_syn_list $2 > /tmp/wp-cli-b + +diff /tmp/wp-cli-a /tmp/wp-cli-b > cmd.diff + +echo 'Generated cmd.diff' diff --git a/_utils/syn-list.php b/_utils/syn-list.php new file mode 100644 index 00000000..392adcca --- /dev/null +++ b/_utils/syn-list.php @@ -0,0 +1,26 @@ + Date: Wed, 2 Jan 2013 10:34:27 +0200 Subject: [PATCH 060/194] don't check 'internal' flag; it doesn't exist anymore --- _utils/cmd-list.php | 3 --- _utils/syn-list.php | 3 --- 2 files changed, 6 deletions(-) diff --git a/_utils/cmd-list.php b/_utils/cmd-list.php index e1d39c08..a82cf3a4 100644 --- a/_utils/cmd-list.php +++ b/_utils/cmd-list.php @@ -12,9 +12,6 @@ $wp = read_json(); foreach ( $wp['subcommands'] as $command ) { - if ( !$command['internal'] ) - continue; - echo << {$command['name']} diff --git a/_utils/syn-list.php b/_utils/syn-list.php index 392adcca..773d8b17 100644 --- a/_utils/syn-list.php +++ b/_utils/syn-list.php @@ -8,9 +8,6 @@ include __DIR__ . '/utils.php'; function generate_synopsis( $command, $path = '' ) { - if ( isset( $command['internal'] ) && !$command['internal'] ) - continue; - $full_path = $path . ' ' . $command['name']; if ( !isset( $command['subcommands'] ) ) { From 28d33cee286038a729b1a7934e3956ec8de35a99 Mon Sep 17 00:00:00 2001 From: scribu Date: Wed, 2 Jan 2013 10:35:52 +0200 Subject: [PATCH 061/194] remove /path/to/wp from examples --- _utils/cmd-list.php | 2 +- _utils/syn-list.php | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/_utils/cmd-list.php b/_utils/cmd-list.php index a82cf3a4..bba158a0 100644 --- a/_utils/cmd-list.php +++ b/_utils/cmd-list.php @@ -5,7 +5,7 @@ # # Example usage: # -# wp --cmd-dump --path=/path/to/wp | php _utils/cmd-list.php +# wp --cmd-dump | php _utils/cmd-list.php include __DIR__ . '/utils.php'; diff --git a/_utils/syn-list.php b/_utils/syn-list.php index 773d8b17..03d07dca 100644 --- a/_utils/syn-list.php +++ b/_utils/syn-list.php @@ -3,7 +3,7 @@ # # Example usage: # -# wp --cmd-dump --path=/path/to/wp | php _utils/syn-list.php +# wp --cmd-dump | php _utils/syn-list.php include __DIR__ . '/utils.php'; From 196ac86c9014680eebae8fd065920be85295cbcd Mon Sep 17 00:00:00 2001 From: scribu Date: Wed, 23 Jan 2013 02:49:00 +0200 Subject: [PATCH 062/194] add phake as a dev dependency --- .gitignore | 5 ++++- composer.json | 5 +++++ 2 files changed, 9 insertions(+), 1 deletion(-) create mode 100644 composer.json diff --git a/.gitignore b/.gitignore index 0baf0152..c7603137 100644 --- a/.gitignore +++ b/.gitignore @@ -1 +1,4 @@ -/_site +_site + +composer.lock +vendor diff --git a/composer.json b/composer.json new file mode 100644 index 00000000..b37ae195 --- /dev/null +++ b/composer.json @@ -0,0 +1,5 @@ +{ + "require-dev": { + "jaz303/phake": "dev-master" + } +} From 1c15bc47f33c281d8d402f4b4b03f08b375f7ce7 Mon Sep 17 00:00:00 2001 From: scribu Date: Wed, 23 Jan 2013 03:04:56 +0200 Subject: [PATCH 063/194] convert cmd-list.php and syn-list.php to Phakefile --- Phakefile.php | 53 +++++++++++++++++++++++++++++++++++++++++++++ README.md | 15 +++++++++++++ _config.yml | 2 ++ _utils/cmd-list.php | 23 -------------------- _utils/syn-list.php | 23 -------------------- _utils/utils.php | 18 --------------- 6 files changed, 70 insertions(+), 64 deletions(-) create mode 100644 Phakefile.php create mode 100644 README.md delete mode 100644 _utils/cmd-list.php delete mode 100644 _utils/syn-list.php delete mode 100644 _utils/utils.php diff --git a/Phakefile.php b/Phakefile.php new file mode 100644 index 00000000..3b5bc679 --- /dev/null +++ b/Phakefile.php @@ -0,0 +1,53 @@ + + {$command['name']} + {$command['description']} + + +EOB; + } + + file_put_contents( '_includes/cmd-list.html', $out ); +}); + +task( 'default', 'cmd-list' ); + diff --git a/README.md b/README.md new file mode 100644 index 00000000..5af42d20 --- /dev/null +++ b/README.md @@ -0,0 +1,15 @@ +### Setup + +1. Install [composer](http://getcomposer.org/). + +2. Install dev dependencies: + +```bash +composer install --dev +``` + +3. Build: + +```bash +vendor/bin/phake path=/path/to/wp/install +``` diff --git a/_config.yml b/_config.yml index ee450e24..ffcf6188 100644 --- a/_config.yml +++ b/_config.yml @@ -4,3 +4,5 @@ pygments: true markdown: kramdown url: http://wp-cli.org permalink: /blog/:title.html +exclude: + - Phakefile.php diff --git a/_utils/cmd-list.php b/_utils/cmd-list.php deleted file mode 100644 index bba158a0..00000000 --- a/_utils/cmd-list.php +++ /dev/null @@ -1,23 +0,0 @@ - - {$command['name']} - {$command['description']} - - -EOB; -} - diff --git a/_utils/syn-list.php b/_utils/syn-list.php deleted file mode 100644 index 03d07dca..00000000 --- a/_utils/syn-list.php +++ /dev/null @@ -1,23 +0,0 @@ - Date: Wed, 23 Jan 2013 03:36:24 +0200 Subject: [PATCH 064/194] add /config/ page + corresponding phake task see wp-cli/wp-cli#277 --- Phakefile.php | 43 ++++++++++++++++++++++++++++++++++- _includes/header.html | 1 + _includes/param-list.html | 48 +++++++++++++++++++++++++++++++++++++++ config/index.html | 18 +++++++++++++++ 4 files changed, 109 insertions(+), 1 deletion(-) create mode 100644 _includes/param-list.html create mode 100644 config/index.html diff --git a/Phakefile.php b/Phakefile.php index 3b5bc679..f59c7dbf 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -49,5 +49,46 @@ function generate_synopsis( $command, $path = '' ) { file_put_contents( '_includes/cmd-list.html', $out ); }); -task( 'default', 'cmd-list' ); +task( 'param-list', function( $app ) { + $config_spec = invoke_wp_cli( 'wp --param-dump', $app ); + + $out = ''; + + foreach ( $config_spec as $key => $details ) { + if ( isset( $details['deprecated'] ) ) + continue; + + if ( false !== $details['file'] ) { + $config = "$key: " . htmlspecialchars( $details['file'] ); + } else { + $config = ''; + } + + if ( false !== $details['runtime'] ) { + $flag = ( true === $details['runtime'] ) + ? "--$key/--no-$key" + : "--$key" . htmlspecialchars( $details['runtime'] ); + } else { + $flag = ''; + } + + $default = json_encode( $details['default'] ); + + $description = $details['desc']; + + $out .= << + $config + $flag + $default + $description + + +EOB; + } + + file_put_contents( '_includes/param-list.html', $out ); +}); + +task( 'default', 'cmd-list', 'param-list' ); diff --git a/_includes/header.html b/_includes/header.html index a1262bd7..f9385a25 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -22,6 +22,7 @@

A command line interface for WordPress

Commands + Config Blog Source Wiki diff --git a/_includes/param-list.html b/_includes/param-list.html new file mode 100644 index 00000000..29e6444a --- /dev/null +++ b/_includes/param-list.html @@ -0,0 +1,48 @@ + + path: <path> + --path=<path> + null + Path to the WordPress files + + + url: <url> + --url=<url> + null + Pretend request came from given URL + + + user: <id|login> + --user=<id|login> + null + Set the WordPress user + + + require: <path> + --require=<path> + null + Load given PHP file before running the command + + + disabled_commands: <list> + + [] + (Sub)commands to disable + + + color: <bool> + --color/--no-color + "auto" + Whether to colozire the output + + + debug: <bool> + --debug + false + Show all PHP errors + + + quiet: <bool> + --quiet + false + Suppress informational messages + diff --git a/config/index.html b/config/index.html new file mode 100644 index 00000000..b1a60a72 --- /dev/null +++ b/config/index.html @@ -0,0 +1,18 @@ +--- +layout: default +title: Configuration +--- + + + + + + + + + + + + {% include param-list.html %} + +
ConfigFlagDefaultDescription
From 3636531ab0c912dd17498cc303ea6eab28c8d446 Mon Sep 17 00:00:00 2001 From: scribu Date: Wed, 23 Jan 2013 04:41:26 +0200 Subject: [PATCH 065/194] fix indentation --- Phakefile.php | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Phakefile.php b/Phakefile.php index f59c7dbf..c41f3439 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -65,9 +65,9 @@ function generate_synopsis( $command, $path = '' ) { } if ( false !== $details['runtime'] ) { - $flag = ( true === $details['runtime'] ) - ? "--$key/--no-$key" - : "--$key" . htmlspecialchars( $details['runtime'] ); + $flag = ( true === $details['runtime'] ) + ? "--$key/--no-$key" + : "--$key" . htmlspecialchars( $details['runtime'] ); } else { $flag = ''; } From 5e9e20f6546d8e297f0a17d095e756a3113e37a3 Mon Sep 17 00:00:00 2001 From: scribu Date: Wed, 23 Jan 2013 04:53:38 +0200 Subject: [PATCH 066/194] add description to /config/ page --- config/index.html | 18 ------------------ config/index.md | 38 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 38 insertions(+), 18 deletions(-) delete mode 100644 config/index.html create mode 100644 config/index.md diff --git a/config/index.html b/config/index.html deleted file mode 100644 index b1a60a72..00000000 --- a/config/index.html +++ /dev/null @@ -1,18 +0,0 @@ ---- -layout: default -title: Configuration ---- - - - - - - - - - - - - {% include param-list.html %} - -
ConfigFlagDefaultDescription
diff --git a/config/index.md b/config/index.md new file mode 100644 index 00000000..6999aab7 --- /dev/null +++ b/config/index.md @@ -0,0 +1,38 @@ +--- +layout: default +title: Configuration +--- +The following is a list of the currently supported configuration options. These can all be specified by creating a `wp-cli.yml` file in your site's root directory. + +Most can also be passed directly to the `wp` executable. + +The order of precedence is: + +1. Command-line flags +1. `wp-cli.local.yml` file +1. `wp-cli.yml` file +1. Defaults + + + + + + + + + + + + {% include param-list.html %} + +
ConfigFlagDefaultDescription
+ +Example `wp-cli.yml` file: + + path: wp-core + url: http://example.com + user: admin + color: false + disabled_commands: + - db drop + - plugin install From c8297e18fb57c796a7a73a8bc6e4169fd74d1084 Mon Sep 17 00:00:00 2001 From: scribu Date: Wed, 23 Jan 2013 05:29:18 +0200 Subject: [PATCH 067/194] /config/ fixes --- _includes/header.html | 2 +- _includes/param-list.html | 6 ++++++ config/index.md | 2 +- 3 files changed, 8 insertions(+), 2 deletions(-) diff --git a/_includes/header.html b/_includes/header.html index f9385a25..ea93681f 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -22,7 +22,7 @@

A command line interface for WordPress

Commands - Config + Configuration Blog Source Wiki diff --git a/_includes/param-list.html b/_includes/param-list.html index 29e6444a..21e1b09e 100644 --- a/_includes/param-list.html +++ b/_includes/param-list.html @@ -1,3 +1,9 @@ + + + --config=<path> + null + Path to the wp-cli config file + path: <path> --path=<path> diff --git a/config/index.md b/config/index.md index 6999aab7..49cadb12 100644 --- a/config/index.md +++ b/config/index.md @@ -2,7 +2,7 @@ layout: default title: Configuration --- -The following is a list of the currently supported configuration options. These can all be specified by creating a `wp-cli.yml` file in your site's root directory. +The following is a list of the currently supported configuration options. They can be specified by creating a `wp-cli.yml` file in your site's root directory. Most can also be passed directly to the `wp` executable. From 6e3c8f94daa6d0a04e6dafac8e3065f0ed5c51e9 Mon Sep 17 00:00:00 2001 From: scribu Date: Wed, 23 Jan 2013 05:42:51 +0200 Subject: [PATCH 068/194] update changelog --- index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/index.md b/index.md index 898909c5..c3eaa804 100644 --- a/index.md +++ b/index.md @@ -150,10 +150,11 @@ Internals: - added support for `wp-cli.yml` config file - bypass full-page caching plugins -- disabled coloring when not in a TTY -- [Composer](http://getcomposer.org) compatibility +- disabled coloring when not in a TTY and added `--color/no-color` global parameters +- added `--debug` global parameter - added `wp --info` utility - added unit tests for `wp core` subcommands. props [mwilliamson](http://github.com/mwilliamson) +- [Composer](http://getcomposer.org) compatibility ### [0.7](https://github.com/wp-cli/wp-cli/issues?milestone=5&state=closed) From 468f3449196e9fc6aeab2b56ff35e1f46ded8c03 Mon Sep 17 00:00:00 2001 From: scribu Date: Sun, 27 Jan 2013 14:34:42 +0100 Subject: [PATCH 069/194] --key/--no-key -> --[no-]key --- Phakefile.php | 2 +- _includes/param-list.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/Phakefile.php b/Phakefile.php index c41f3439..7814cbba 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -66,7 +66,7 @@ function generate_synopsis( $command, $path = '' ) { if ( false !== $details['runtime'] ) { $flag = ( true === $details['runtime'] ) - ? "--$key/--no-$key" + ? "--[no-]$key" : "--$key" . htmlspecialchars( $details['runtime'] ); } else { $flag = ''; diff --git a/_includes/param-list.html b/_includes/param-list.html index 21e1b09e..95e4cb8a 100644 --- a/_includes/param-list.html +++ b/_includes/param-list.html @@ -36,7 +36,7 @@ color: <bool> - --color/--no-color + --[no-]color "auto" Whether to colozire the output From 1f8ea2e2efaef12f1b83ce066208be1278dbb9b2 Mon Sep 17 00:00:00 2001 From: scribu Date: Sat, 2 Feb 2013 16:43:18 +0200 Subject: [PATCH 070/194] add descriptions for Phake tasks --- Phakefile.php | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/Phakefile.php b/Phakefile.php index 7814cbba..2fd4a55f 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -15,6 +15,7 @@ function invoke_wp_cli( $cmd, $app ) { return json_decode( $json, true ); } +desc( 'Generate a list of commands with all accepted arguments on STDOUT.' ); task( 'syn-list', function( $app ) { function generate_synopsis( $command, $path = '' ) { $full_path = $path . ' ' . $command['name']; @@ -31,6 +32,7 @@ function generate_synopsis( $command, $path = '' ) { generate_synopsis( invoke_wp_cli( 'wp --cmd-dump', $app ) ); }); +desc( 'Update the /commands/ page.' ); task( 'cmd-list', function( $app ) { $wp = invoke_wp_cli( 'wp --cmd-dump', $app ); @@ -49,6 +51,7 @@ function generate_synopsis( $command, $path = '' ) { file_put_contents( '_includes/cmd-list.html', $out ); }); +desc( 'Update the /config/ page.' ); task( 'param-list', function( $app ) { $config_spec = invoke_wp_cli( 'wp --param-dump', $app ); @@ -90,5 +93,6 @@ function generate_synopsis( $command, $path = '' ) { file_put_contents( '_includes/param-list.html', $out ); }); +desc( 'Build the site.' ); task( 'default', 'cmd-list', 'param-list' ); From 423bafd04251663c1354911b0e185d24d12c73cc Mon Sep 17 00:00:00 2001 From: scribu Date: Wed, 13 Feb 2013 02:31:26 +0200 Subject: [PATCH 071/194] replace PEAR instructions with Phar archive --- index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.md b/index.md index c3eaa804..6551f8a9 100644 --- a/index.md +++ b/index.md @@ -14,11 +14,11 @@ Requirements Installing ========== -**Via PEAR:** +**Via Phar Archive:** 
-sudo pear channel-discover wp-cli.org/pear
-sudo pear install wpcli/wpcli
+sudo wget http://wp-cli.org/packages/phar/wp-cli.phar -O /usr/bin/wp
+sudo chmod +x /usr/bin/wp
**Via GIT:** From 3917d3ff3513f6abefc439d4894e256e696496a1 Mon Sep 17 00:00:00 2001 From: scribu Date: Tue, 19 Feb 2013 03:03:42 +0200 Subject: [PATCH 072/194] add Disqus comments --- _includes/disqus.html | 14 ++++++++++++++ _layouts/post.html | 2 ++ 2 files changed, 16 insertions(+) create mode 100644 _includes/disqus.html diff --git a/_includes/disqus.html b/_includes/disqus.html new file mode 100644 index 00000000..adcf9e92 --- /dev/null +++ b/_includes/disqus.html @@ -0,0 +1,14 @@ +
+ + +comments powered by Disqus diff --git a/_layouts/post.html b/_layouts/post.html index 198802fb..17623f98 100644 --- a/_layouts/post.html +++ b/_layouts/post.html @@ -11,4 +11,6 @@

{{ page.title }}

+{% include disqus.html %} + {% include footer.html %} From 7bc40d95356ae83c925db42e516b5070287671c5 Mon Sep 17 00:00:00 2001 From: scribu Date: Tue, 19 Feb 2013 03:10:13 +0200 Subject: [PATCH 073/194] add blog post about setting up plugin unit tests --- _posts/2013-02-19-plugin-unit-tests.md | 41 ++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 _posts/2013-02-19-plugin-unit-tests.md diff --git a/_posts/2013-02-19-plugin-unit-tests.md b/_posts/2013-02-19-plugin-unit-tests.md new file mode 100644 index 00000000..c6b2c372 --- /dev/null +++ b/_posts/2013-02-19-plugin-unit-tests.md @@ -0,0 +1,41 @@ +--- +layout: post +title: Easily Set Up Unit Tests For Your Plugin +author: scribu +--- +One of the reasons so few people take the time to write [unit tests for plugins][3] they write is that it's a chore to set everything up. You need to install [PHPUnit][4], the [WordPress testing library][5], as well as the actual plugin tests configuration files. + +If you're running wp-cli 0.9.0-alpha2 or later, there are a few commands that make this significantly easier: + + wp core init-tests + +Given some database credentials, the above command will download and configure the WordPress testing library, using the current WordPress install as the base. + + wp scaffold plugin-tests + +This command will generate all the necessary files for running the plugin tests locally. + +Additionally, if you choose to host your plugin on Github, you can make the tests run automatically after every commit, via [Travis CI][1]. + +So, here's a complete example: + + # Initialize the testing library + wp core init-tests ~/svn/wp-tests --dbname=wp_test --dbuser=root --dbpass=asd + mysql -u'root' -p'asd' -e 'CREATE DATABASE IF NOT EXISTS wp_test' + + # Generate the plugin files + wp scaffold plugin sample-plugin + + # Run the tests + cd wp-content/plugins/sample-plugin + WP_TESTS_DIR=~/svn/wp-tests phpunit + +You can check out the [sample-plugin][2] repo to see what the generated plugin looks like. + +Run `wp help scaffold plugin-tests` for more info. + +[1]: http://about.travis-ci.org +[2]: https://github.com/wp-cli/sample-plugin +[3]: http://wordpress.tv/2011/08/20/nikolay-bachiyski-unit-testing-will-change-your-life/ +[4]: http://www.phpunit.de/manual/current/en/automating-tests.html +[5]: http://make.wordpress.org/core/handbook/automated-testing/ From f5b6ddddd2b99322cb871a524b7eac48558dd306 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cristi=20Burc=C4=83?= Date: Wed, 20 Feb 2013 02:21:02 +0200 Subject: [PATCH 074/194] Use curl instead of wget curl is available by default on OSX and is easy to install in Linux. --- index.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/index.md b/index.md index 6551f8a9..9b231b5e 100644 --- a/index.md +++ b/index.md @@ -17,8 +17,9 @@ Installing **Via Phar Archive:** 
-sudo wget http://wp-cli.org/packages/phar/wp-cli.phar -O /usr/bin/wp
-sudo chmod +x /usr/bin/wp
+sudo -s
+curl http://wp-cli.org/packages/phar/wp-cli.phar > /usr/bin/wp
+chmod +x /usr/bin/wp
**Via GIT:** From 9f13324f0a8f08d7b60d7f13cd9aba44f59f665d Mon Sep 17 00:00:00 2001 From: Evan Solomon Date: Sun, 24 Feb 2013 06:35:09 -0800 Subject: [PATCH 075/194] export WP_CLI_PHP var to make it available to subprocesses --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 9b231b5e..0709e559 100644 --- a/index.md +++ b/index.md @@ -46,7 +46,7 @@ Then, create an environment variable called `WP_CLI_PHP` with the path found by In a UNIX environment, you would do this by adding the following line to your `.bashrc` file: 
-WP_CLI_PHP=/path/to/php-binary
+export WP_CLI_PHP=/path/to/php-binary
Using From a5ed3232790b7803d9cc4b71e374080bede73c81 Mon Sep 17 00:00:00 2001 From: scribu Date: Thu, 28 Feb 2013 22:21:41 +0200 Subject: [PATCH 076/194] no more submodules; see wp-cli/wp-cli#336 --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 0709e559..eba29405 100644 --- a/index.md +++ b/index.md @@ -25,7 +25,7 @@ chmod +x /usr/bin/wp **Via GIT:** 
-git clone --recursive git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
+git clone git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
 cd ~/git/wp-cli
 sudo utils/dev-build
From 2f8fd35250102e5e55207f2ed506f3f1e89aa549 Mon Sep 17 00:00:00 2001 From: Frank Louwers Date: Fri, 1 Mar 2013 11:00:49 +0100 Subject: [PATCH 077/194] Clarify suhosin should be disabled (or at least phar whitelisted) --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index eba29405..1f5c9578 100644 --- a/index.md +++ b/index.md @@ -10,6 +10,7 @@ Requirements * PHP >= 5.3 * WordPress >= 3.3 +* Either suhosin disabled or suhosin.executor.include.whitelist="phar" in your /etc/php5/conf.d/suhosin.ini or php.ini file Installing ========== From ee05c489c249761d44ace0c5a4f41408609292b8 Mon Sep 17 00:00:00 2001 From: scribu Date: Sat, 2 Mar 2013 00:33:49 +0200 Subject: [PATCH 078/194] mention the Suhosin setting only when installing the Phar archive directly. see #6 --- index.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/index.md b/index.md index 1f5c9578..334af45b 100644 --- a/index.md +++ b/index.md @@ -10,7 +10,6 @@ Requirements * PHP >= 5.3 * WordPress >= 3.3 -* Either suhosin disabled or suhosin.executor.include.whitelist="phar" in your /etc/php5/conf.d/suhosin.ini or php.ini file Installing ========== @@ -23,6 +22,8 @@ curl http://wp-cli.org/packages/phar/wp-cli.phar > /usr/bin/wp chmod +x /usr/bin/wp +If you have Suhosin enabled, make sure to set `suhosin.executor.include.whitelist="phar"` in your `suhosin.ini` or `php.ini` file. + **Via GIT:** 

From 2282af06f2d0ec95b324ce9a0299549cd4116da3 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 3 Mar 2013 23:46:11 +0200
Subject: [PATCH 079/194] mention utils/local-build as an installation method

Intentionally avoid sourcing it, so that the user gets the install
instructions.

see wp-cli/wp-cli#342
---
 index.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/index.md b/index.md
index 334af45b..15ace576 100644
--- a/index.md
+++ b/index.md
@@ -34,6 +34,14 @@ sudo utils/dev-build
 
 You can replace `~/git/wp-cli` with whatever you want.
 
+**Without sudo:**
+
+```
+git clone git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
+cd ~/git/wp-cli
+./utils/local-build
+```
+
 MAMP, XAMP, etc.
 -----------
 

From b3ba8c9d055235403487d61d781424ab4c700b55 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 4 Mar 2013 00:00:23 +0200
Subject: [PATCH 080/194] convert to Redcarpet and use fenced code blocks

---
 _config.yml |  2 +-
 index.md    | 48 ++++++++++++++++++++++++------------------------
 2 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/_config.yml b/_config.yml
index ffcf6188..d137e76a 100644
--- a/_config.yml
+++ b/_config.yml
@@ -1,7 +1,7 @@
 safe: true
 lsi: false
 pygments: true
-markdown: kramdown
+markdown: redcarpet
 url: http://wp-cli.org
 permalink: /blog/:title.html
 exclude:
diff --git a/index.md b/index.md
index 15ace576..4e1c38ec 100644
--- a/index.md
+++ b/index.md
@@ -16,21 +16,21 @@ Installing
 
 **Via Phar Archive:**
 
-
+```
 sudo -s
 curl http://wp-cli.org/packages/phar/wp-cli.phar > /usr/bin/wp
 chmod +x /usr/bin/wp
-

+```
 
 If you have Suhosin enabled, make sure to set `suhosin.executor.include.whitelist="phar"` in your `suhosin.ini` or `php.ini` file.
 
 **Via GIT:**
 
-
+```
 git clone git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
 cd ~/git/wp-cli
 sudo utils/dev-build
-

+```
 
 You can replace `~/git/wp-cli` with whatever you want.
 
@@ -47,30 +47,30 @@ MAMP, XAMP, etc.
 
 If the `php` command is not available, you can try finding an appropriate binary:
 
-
+```
 ./utils/find-php
-

+```
 
 Then, create an environment variable called `WP_CLI_PHP` with the path found by `find-php`.
 
 In a UNIX environment, you would do this by adding the following line to your `.bashrc` file:
 
-
+```
 export WP_CLI_PHP=/path/to/php-binary
-

+```
 
 Using
 =====
 
 Go into a WordPress root folder:
 
-
+```
 cd /var/www/wp/
-

+```
 
 Typing `wp` should show you output similar to this:
 
-
+```
 Available commands:
     wp blog create|delete
     wp cache add|decr|delete|flush|get|incr|replace|set|type
@@ -81,51 +81,51 @@ Available commands:
     ...
 
 See 'wp help <command>' for more information on a specific command.
-

+```
 
 Let's try to install the Hello Dolly plugin from wordpress.org:
 
-
+```
 wp plugin install hello-dolly
-

+```
 
 Output:
 
-
+```
 Installing Hello Dolly (1.5)
 
 Downloading install package from http://downloads.WordPress.org/plugin/hello-dolly.1.5.zip ...
 Unpacking the package ...
 Installing the plugin ...
 Plugin installed successfully.
-

+```
 
 Multisite
 ---------
 
 On a multisite installation, you need to pass a `--url` parameter, so that wp-cli knows which site it's supposed to be operating on:
 
-
+```
 wp theme status --url=localhost/wp/test
-

+```
 
 If you have a subdomain installation, it would look like this:
 
-
+```
 wp theme status --url=test.example.com
-

+```
 
 If you're usually working on the same site most of the time, you can create a `wp-cli.yml` file in the root directory:
 
-
+```
 url: test.example.com
-

+```
 
 Then, you can call `wp` without the `--url` parameter again:
 
-
+```
 wp theme status
-

+```
 
 Adding commands
 ===============

From 705663ae6b02c613c4369afb9a25aadc95c6e019 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 4 Mar 2013 16:13:58 +0200
Subject: [PATCH 081/194] add link to .md5 file. see wp-cli/wp-cli#340

---
 index.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/index.md b/index.md
index 4e1c38ec..7c23165e 100644
--- a/index.md
+++ b/index.md
@@ -16,6 +16,8 @@ Installing
 
 **Via Phar Archive:**
 
+You can download WP-CLI packaged as a [single file](http://wp-cli.org/packages/phar/wp-cli.phar) ([md5](http://wp-cli.org/packages/phar/wp-cli.phar.md5)):
+
 ```
 sudo -s
 curl http://wp-cli.org/packages/phar/wp-cli.phar > /usr/bin/wp
@@ -34,7 +36,7 @@ sudo utils/dev-build
 
 You can replace `~/git/wp-cli` with whatever you want.
 
-**Without sudo:**
+**Via GIT (without sudo):**
 
 ```
 git clone git://github.com/wp-cli/wp-cli.git ~/git/wp-cli

From 783e08266dabfad0e480f28a10289c84d8649be0 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Tue, 5 Mar 2013 01:45:09 +0200
Subject: [PATCH 082/194] add link to wordpress-plugin-tests/contributors

---
 _posts/2013-02-19-plugin-unit-tests.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/_posts/2013-02-19-plugin-unit-tests.md b/_posts/2013-02-19-plugin-unit-tests.md
index c6b2c372..9d391ecd 100644
--- a/_posts/2013-02-19-plugin-unit-tests.md
+++ b/_posts/2013-02-19-plugin-unit-tests.md
@@ -34,8 +34,11 @@ You can check out the [sample-plugin][2] repo to see what the generated plugin l
 
 Run `wp help scaffold plugin-tests` for more info.
 
+A shout-out to the people that contributed to [benbalter/wordpress-plugin-tests][6] is in order.
+
 [1]: http://about.travis-ci.org
 [2]: https://github.com/wp-cli/sample-plugin
 [3]: http://wordpress.tv/2011/08/20/nikolay-bachiyski-unit-testing-will-change-your-life/
 [4]: http://www.phpunit.de/manual/current/en/automating-tests.html
 [5]: http://make.wordpress.org/core/handbook/automated-testing/
+[6]: https://github.com/benbalter/wordpress-plugin-tests/contributors

From c28848d3e45ef92d6bdbdfe8853e37518daeb883 Mon Sep 17 00:00:00 2001
From: Jaime Martinez 
Date: Tue, 5 Mar 2013 21:00:45 +0100
Subject: [PATCH 083/194] Use th instead of td

---
 commands/index.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/commands/index.html b/commands/index.html
index ec067990..c4ef67f0 100644
--- a/commands/index.html
+++ b/commands/index.html
@@ -6,8 +6,8 @@
 
-		
-		
+		
+		

From 29a2d9e191b9ee55dd1912995c26463f6158ab75 Mon Sep 17 00:00:00 2001
From: Jaime Martinez 
Date: Tue, 5 Mar 2013 21:01:34 +0100
Subject: [PATCH 084/194] Use th instead of td

---
 config/index.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/config/index.md b/config/index.md
index 49cadb12..eead1574 100644
--- a/config/index.md
+++ b/config/index.md
@@ -16,10 +16,10 @@ The order of precedence is:
 

 	
 	
CommandDescriptionCommandDescription
 	

 	
 	

-		
-		
-		
-		
+		
+		
+		
+		

From 5d80b1443255f4ec330a2945daef26c1e90cfa8a Mon Sep 17 00:00:00 2001
From: Jaime Martinez 
Date: Tue, 5 Mar 2013 21:03:13 +0100
Subject: [PATCH 085/194] Vertical align top

---
 assets/css/stylesheet.css | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/assets/css/stylesheet.css b/assets/css/stylesheet.css
index 5d0fad0f..20293b30 100644
--- a/assets/css/stylesheet.css
+++ b/assets/css/stylesheet.css
@@ -179,6 +179,9 @@ table {
 	margin: 0 0 20px 0;
 }
 
+th, td {
+	vertical-align: top;
+}
 th {
 	text-align: left;
 	border-bottom: 1px dashed #b5e853;

From 5ec2f64181921c8a58c19de18953eefbfff35200 Mon Sep 17 00:00:00 2001
From: Jaime Martinez 
Date: Tue, 5 Mar 2013 21:04:14 +0100
Subject: [PATCH 086/194] Whitelines

---
 assets/css/stylesheet.css | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/assets/css/stylesheet.css b/assets/css/stylesheet.css
index 20293b30..07e2148d 100644
--- a/assets/css/stylesheet.css
+++ b/assets/css/stylesheet.css
@@ -92,6 +92,7 @@ footer {
 	width: 100%;
 	-webkit-font-smoothing: antialiased;
 }
+
 section img {
 	max-width: 100%
 }
@@ -182,6 +183,7 @@ table {
 th, td {
 	vertical-align: top;
 }
+
 th {
 	text-align: left;
 	border-bottom: 1px dashed #b5e853;

From 71b982a8bf23fdf8ccaf959b78953ffaecfff800 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 11 Mar 2013 13:46:15 +0200
Subject: [PATCH 087/194] show instructions for setting up the `wp` alias

... instead of using `utils/local-build`.

see wp-cli/wp-cli#353
---
 index.md | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/index.md b/index.md
index 7c23165e..35d389fe 100644
--- a/index.md
+++ b/index.md
@@ -41,9 +41,19 @@ You can replace `~/git/wp-cli` with whatever you want.
 ```
 git clone git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
 cd ~/git/wp-cli
-./utils/local-build
+curl -sS https://getcomposer.org/installer | php
+php composer.phar install
 ```
 
+Now, set up the `wp` alias:
+
+```bash
+alias wp='~/git/wp-cli/bin/wp'
+source ~/git/wp-cli/utils/wp-completion.bash
+```
+
+Add the above two lines to your `.bashrc` or `.bash_profile` file to have it set up automatically when you log in.
+
 MAMP, XAMP, etc.
 -----------
 

From ae566b12743c2112136580f4c10b127c83a65640 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 15 Mar 2013 23:18:16 +0200
Subject: [PATCH 088/194] show full content on blog index

---
 _layouts/post.html | 2 +-
 blog/index.html    | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/_layouts/post.html b/_layouts/post.html
index 17623f98..945a0544 100644
--- a/_layouts/post.html
+++ b/_layouts/post.html
@@ -3,7 +3,7 @@
 

 	

 		
{{ page.title }}

-		by {{page.author}}, on {{ page.date | date_to_string }}
+		by {{ page.author }}, on {{ page.date | date_to_string }}
 	

 
 	

diff --git a/blog/index.html b/blog/index.html
index fcd20fa8..61c6d98c 100644
--- a/blog/index.html
+++ b/blog/index.html
@@ -7,11 +7,11 @@
 
 {% endfor %}

From e53f896e69598314daa34ffcdffdcfd13479c787 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 16 Mar 2013 01:13:10 +0200
Subject: [PATCH 089/194] link to CONTRIBUTING.md

---
 index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.md b/index.md
index 35d389fe..88201ff2 100644
--- a/index.md
+++ b/index.md
@@ -286,4 +286,4 @@ Contributors
 ------------
 
 - [Contributor list](https://github.com/wp-cli/wp-cli/contributors)
-- [Contributor guide](https://github.com/wp-cli/wp-cli/wiki/Commands-Cookbook)
+- [Contributor guide](https://github.com/wp-cli/wp-cli/blob/master/CONTRIBUTING.md)

From aa6b1700f9fe0ebc964b2ea4ec40c72482542d68 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 15 Mar 2013 23:32:30 +0200
Subject: [PATCH 090/194] convert changelog section to blog posts

---
 _posts/2011-11-06-version-0.3.md |  25 ++++++
 _posts/2011-12-29-version-0.4.md |  18 +++++
 _posts/2012-03-27-version-0.5.md |  22 +++++
 _posts/2012-09-05-version-0.6.md |  32 ++++++--
 _posts/2012-11-10-wp-shell.md    |   6 +-
 _posts/2012-11-16-version-0.7.md |  41 +++++++++-
 _posts/2013-01-26-version-0.8.md |  39 +++++++++
 index.md                         | 135 -------------------------------
 8 files changed, 173 insertions(+), 145 deletions(-)
 create mode 100644 _posts/2011-11-06-version-0.3.md
 create mode 100644 _posts/2011-12-29-version-0.4.md
 create mode 100644 _posts/2012-03-27-version-0.5.md
 create mode 100644 _posts/2013-01-26-version-0.8.md

diff --git a/_posts/2011-11-06-version-0.3.md b/_posts/2011-11-06-version-0.3.md
new file mode 100644
index 00000000..4667b53c
--- /dev/null
+++ b/_posts/2011-11-06-version-0.3.md
@@ -0,0 +1,25 @@
+---
+layout: post
+title: Version 0.3
+author: scribu
+---
+Version 0.3.0 is now available.
+
+### Changelog
+
+Commands:
+
+- added `wp sql`
+- improved `wp option`
+- improved `wp plugin` and `wp theme`
+- added `wp generate`
+- added `wp core version`
+
+Internals:
+
+- added `--version` special parameter
+- added `--blog` global parameter
+- added bash completion script
+- added pear installer
+
+Contributors to this release: [andreascreten](http://github.com/andreascreten), [conatus](http://github.com/conatus), [matiskay](http://github.com/matiskay), [nb](http://github.com/nb), [scribu](http://github.com/scribu), [toszcze](http://github.com/toszcze).
diff --git a/_posts/2011-12-29-version-0.4.md b/_posts/2011-12-29-version-0.4.md
new file mode 100644
index 00000000..49067fb9
--- /dev/null
+++ b/_posts/2011-12-29-version-0.4.md
@@ -0,0 +1,18 @@
+---
+layout: post
+title: Version 0.4
+author: scribu
+---
+Version 0.4.0 is now available. See [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=2&state=closed).
+
+### Changelog
+
+- added `wp eval` and `wp eval-file`
+- added `wp export`
+- added `wp core install`
+- fixed `wp core update`
+- added `--dev` flag to `wp plugin install`
+- added `wp plugin uninstall`
+- fixed `wp plugin install` and `wp plugin update`
+
+Contributors to this release: [mwilliamson](http://github.com/mwilliamson), [scribu](http://github.com/scribu), [tott](http://github.com/tott).
diff --git a/_posts/2012-03-27-version-0.5.md b/_posts/2012-03-27-version-0.5.md
new file mode 100644
index 00000000..6374e08a
--- /dev/null
+++ b/_posts/2012-03-27-version-0.5.md
@@ -0,0 +1,22 @@
+---
+layout: post
+title: Version 0.5
+author: scribu
+---
+Version 0.5.0 is now available. See [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=3&state=closed).
+
+### Changelog
+
+Commands:
+
+- added `wp user`
+- added `wp core download`
+- added `wp core config`
+- added `wp plugin update --all`
+
+Internals:
+
+- added `--url` `--path` and `--user` global parameters
+- various bugfixes
+
+Contributors to this release: [andreascreten](http://github.com/andreascreten), [ericandrewlewis](http://github.com/ericandrewlewis), [getsource](http://github.com/getsource), [johnpbloch](http://github.com/johnpbloch), [scribu](http://github.com/scribu), [spuriousdata](http://github.com/spuriousdata), [svaj](http://github.com/svaj), [wopr42](http://github.com/wopr42).
diff --git a/_posts/2012-09-05-version-0.6.md b/_posts/2012-09-05-version-0.6.md
index 60a008fe..616ad6ce 100644
--- a/_posts/2012-09-05-version-0.6.md
+++ b/_posts/2012-09-05-version-0.6.md
@@ -46,17 +46,37 @@ The help system has been improved. When you do `wp help core config`, an actual
 
 Unfortunately, this doesn't work if you install wp-cli via the PEAR package, because PEAR doesn't know how to handle them. :(
 
-### The Community
+### The Changelog
+
+Commands:
+
+- added `wp post` and `wp post-meta`
+- added `wp user-meta`
+- added `wp blog create`
+- added `wp export`
+- added `wp theme install` and `wp theme update`
+- added `wp transient`
+- added `wp db optimize` and `wp db repair`
+- added `wp db create`, `wp db drop` and `wp db reset`
+- added `wp db import`
+- added `wp core install_network`
+- added `wp core update_db`
+- added `--json` option to several subcommands
+- added `--network` option to `wp plugin activate`
+- fixed `wp plugin update`
 
-Most of the new commands you see in this release were actually implemented by other people. A few examples:
+Internals:
 
-[Mike Shroeder](https://github.com/getsource) was responsible for `wp theme install`, the much loved `wp plugin update --all` and a bunch of other things.
+- fixed "out of memory" error
+- misc bugfixes and optimizations
 
-[Michael Williamson](https://github.com/mwilliamson-red-gate) wrote `wp user-meta` and came up with the idea for the `--json` parameter.
+You can also browse the full list of [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=4&state=closed).
+
+### The Community
 
-[Evan Anderson](https://github.com/kidfiction) contributed `wp blog create`, [Tott](https://github.com/tott) contributed `wp export` and [Zack Tollman](https://github.com/tollmanz) contributed `wp transient`.
+Most of the new commands you see in this release were actually implemented by other people.
 
-And that's just the beginning. The [full list of contributors](https://github.com/wp-cli/wp-cli/graphs/contributors?from=2011-09-04&to=2012-09-02&type=a) can be found on github.
+Here are all the people that have contributed to this release: [andreascreten](http://github.com/andreascreten), [dwightjack](http://github.com/dwightjack), [getsource](http://github.com/getsource), [johnpbloch](http://github.com/johnpbloch), [joshstoik1](http://github.com/joshstoik1), [kidfiction](http://github.com/kidfiction), [marcoceppi](http://github.com/marcoceppi), [mgburns](http://github.com/mgburns), [mwilliamson](http://github.com/mwilliamson), [roelven](http://github.com/roelven), [scribu](http://github.com/scribu), [soulou](http://github.com/soulou), [tollmanz](http://github.com/tollmanz).
 
 ### The Future
 
diff --git a/_posts/2012-11-10-wp-shell.md b/_posts/2012-11-10-wp-shell.md
index 1fc08c4e..db6be2af 100644
--- a/_posts/2012-11-10-wp-shell.md
+++ b/_posts/2012-11-10-wp-shell.md
@@ -4,7 +4,9 @@ title: Interactive WordPress Debugging
 author: scribu
 ---
 
-A new command [landed](https://github.com/wp-cli/wp-cli/pull/89) in wp-cli a few days ago, called `shell`. When you run `wp shell`, a REPL will start, in which you can run any WordPress function.
+A new command [landed](https://github.com/wp-cli/wp-cli/pull/89) in wp-cli a few days ago, called `shell`. It was inspired by an older project called [wpshell](http://code.trac.wordpress.org/browser/wpshell).
+
+When you run `wp shell`, a REPL will start, in which you can run any WordPress function.
 
 The major advantage over `wp eval` and `wp eval-file` is that it's interactive: you immediately see the result of the previous command; it's also stored in the special `$_` variable, which you can use in the next command and so on.
 
@@ -19,4 +21,4 @@ Here's a contrived example session:
 	wp> exit
 	scribu@air:~/wp/core$
 
-wp-shell will be available in the 0.7 release of wp-cli, but if you want to try it out right now, clone the [latest version](https://github.com/wp-cli/wp-cli) from github. If you have suggestions for making it better, don't hesitate to open issues and pull requests. 
+`wp shell` will be available in the 0.7 release of WP-CLI, but if you want to try it out right now, clone the [latest version](https://github.com/wp-cli/wp-cli) from github. If you have suggestions for making it better, don't hesitate to open issues and pull requests. 
diff --git a/_posts/2012-11-16-version-0.7.md b/_posts/2012-11-16-version-0.7.md
index 8d783aa1..39cfc91e 100644
--- a/_posts/2012-11-16-version-0.7.md
+++ b/_posts/2012-11-16-version-0.7.md
@@ -3,9 +3,46 @@ layout: post
 title: Version 0.7
 author: scribu
 ---
-
-Version 0.7 is now available. You can consult the [changelog](/#changelog) for an executive summary.
+Version 0.7.0 is now available.
 
 If you had installed WP-CLI using PEAR, you will probably have to re-install it from scratch, since the URL for the channel has changed.
 
 There is a new wiki page for [creating commands](https://github.com/wp-cli/wp-cli/wiki/Creating-Commands) which has information about the new `@synopsis` tag etc. It also describes how you can create man pages for your custom commands.
+
+### Changelog 
+
+Commands:
+
+- added [wp shell](/blog/wp-shell.html)
+- added `wp cache`
+- added `wp comment`
+- added `wp rewrite`
+- added `wp user import-csv`
+- added `wp user set-role` and `wp user remove-role`
+- added `wp core is-installed`
+- added `wp blog delete`
+- added `wp post list`
+- made `wp post delete` accept a list of IDs
+- added `--dry-run` option `wp plugin update-all`
+- improved `wp export`
+
+Breaking changes:
+
+- converted `wp plugin update --all` to `wp plugin update-all`
+- converted `wp theme update --all` to `wp theme update-all`
+- converted `wp generate posts` to `wp post generate`
+- converted `wp generate users` to `wp user generate`
+- renamed `wp core install_network` to `wp core install-network`
+- renamed `--path` option to `--dir` in `wp export`
+
+Internals:
+
+- removed support for default subcommands
+- introduced `@synopsis` docblock tag
+- introduced `@subcommand` docblock tag
+- introduced `@alias` docblock tag
+- introduced `WP_CLI::add_man_dir()`
+
+You can also browse the full list of [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=5&state=closed).
+
+Contributors to this release: [andreascreten](http://github.com/andreascreten), [bendoh](http://github.com/bendoh), [builtbylane](http://github.com/builtbylane), [danielbachhuber](http://github.com/danielbachhuber), [goldenapples](http://github.com/goldenapples), [jghazally](http://github.com/jghazally), [lackingpenguin](http://github.com/lackingpenguin), [navitronic](http://github.com/navitronic), [ozh](http://github.com/ozh), [scribu](http://github.com/scribu), [tddewey](http://github.com/tddewey).
diff --git a/_posts/2013-01-26-version-0.8.md b/_posts/2013-01-26-version-0.8.md
new file mode 100644
index 00000000..1fc7bb06
--- /dev/null
+++ b/_posts/2013-01-26-version-0.8.md
@@ -0,0 +1,39 @@
+---
+layout: post
+title: Version 0.8
+author: scribu
+---
+Version 0.8.0 is now available.
+
+### Changelog 
+
+Commands:
+
+- added `wp search-replace`. hat tip to [interconnectit/Search-Replace-DB](https://github.com/interconnectit/Search-Replace-DB)
+- added `wp scaffold`
+- added `wp cap`
+- added `wp user add-role`
+- added `--role` parameter to `wp user remove-role`
+- added `--ids` parameter to `wp user list`
+- added `--post__in` parameter to `wp export`
+- added `--str` parameter to most `wp db` subcommands
+- removed community commands (`wp total-cache`, `wp super-cache`, `wp sitemap`)
+- made `wp post update` accept multiple IDs
+- fixed incorrect exit code from `wp core is-installed` in some cases
+- fixed `wp user import-csv`
+- fixed `wp theme update `
+- fixed `wp plugin update ` not reactivating the plugin
+
+Internals:
+
+- added support for `wp-cli.yml` config file
+- bypass full-page caching plugins
+- disabled coloring when not in a TTY and added `--color/no-color` global parameters
+- added `--debug` global parameter
+- added `wp --info` utility
+- added unit tests for `wp core` subcommands
+- [Composer](http://getcomposer.org) compatibility
+
+You can also browse the full list of [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=6&state=closed).
+
+Contributors to this release: [danielbachhuber](http://github.com/danielbachhuber), [ericmann](http://github.com/ericmann), [jmslbam](http://github.com/jmslbam), [milesj](http://github.com/milesj), [mwilliamson](http://github.com/mwilliamson), [scribu](http://github.com/scribu), [sebastiaandegeus](http://github.com/sebastiaandegeus).
diff --git a/index.md b/index.md
index 88201ff2..b526fc7e 100644
--- a/index.md
+++ b/index.md
@@ -147,141 +147,6 @@ You can find more information about adding commands in the [Commands Cookbook](h
 
 **Please share the commands you make, issue a pull request to get them included in wp-cli by default.**
 
-Changelog
-=========
-
-### [0.8](https://github.com/wp-cli/wp-cli/issues?milestone=6&state=closed)
-
-Commands:
-
-- added `wp search-replace` command
-- added `wp scaffold` command. props [jmslbam](http://github.com/jmslbam) and [sebastiaandegeus](http://github.com/sebastiaandegeus)
-- added `wp cap` command
-- added `wp user add-role` subcommand
-- added `--role` parameter to `wp user remove-role`
-- added `--ids` parameter to `wp user list`
-- added `--post__in` parameter to `wp export`
-- added `--str` parameter to most `wp db` subcommands
-- removed community commands (`wp total-cache`, `wp super-cache`, `wp sitemap`)
-- made `wp post update` accept multiple IDs
-- fixed incorrect exit code from `wp core is-installed` in some cases
-- fixed `wp user import-csv`. props [danielbachhuber](http://github.com/danielbachhuber)
-- fixed `wp theme update `
-- fixed `wp plugin update ` not reactivating the plugin
-
-Internals:
-
-- added support for `wp-cli.yml` config file
-- bypass full-page caching plugins
-- disabled coloring when not in a TTY and added `--color/no-color` global parameters
-- added `--debug` global parameter
-- added `wp --info` utility
-- added unit tests for `wp core` subcommands. props [mwilliamson](http://github.com/mwilliamson)
-- [Composer](http://getcomposer.org) compatibility
-
-### [0.7](https://github.com/wp-cli/wp-cli/issues?milestone=5&state=closed)
-
-Commands:
-
-- added [wp shell](/blog/wp-shell.html)
-- added `wp cache`, props [tollmanz](http://github.com/tollmanz)
-- added `wp comment`, props [ozh](http://github.com/ozh)
-- added `wp rewrite`, props [goldenapples](http://github.com/goldenapples)
-- added `wp user import-csv`, props [danielbachhuber](http://github.com/danielbachhuber)
-- added `wp user set-role` and `wp user remove-role`, props danielbachhuber 
-- added `wp core is-installed`
-- added `wp blog delete`
-- added `wp post list`
-- made `wp post delete` accept a list of IDs
-- added `--dry-run` option `wp plugin update-all`
-- improved `wp export`, props danielbachhuber
-
-Breaking changes:
-
-- converted `wp plugin update --all` to `wp plugin update-all`
-- converted `wp theme update --all` to `wp theme update-all`
-- converted `wp generate posts` to `wp post generate`
-- converted `wp generate users` to `wp user generate`
-- renamed `wp core install_network` to `wp core install-network`
-- renamed `--path` option to `--dir` in `wp export`
-
-Internals:
-
-- removed support for default subcommands
-- introduced `@synopsis` docblock tag
-- introduced `@subcommand` docblock tag
-- introduced `@alias` docblock tag
-- introduced `WP_CLI::add_man_dir()`
-
-### [0.6](https://github.com/wp-cli/wp-cli/issues?milestone=4&state=closed)
-
-Commands:
-
-- added `wp post` and `wp post-meta`
-- added `wp user-meta`, props [mwilliamson-red-gate](http://github.com/mwilliamson-red-gate)
-- added `wp blog create`, props [kidfiction](http://github.com/kidfiction)
-- added `wp export`, props [tott](http://github.com/tott)
-- added `wp theme install` and `wp theme update`, props [getsource](http://github.com/getsource)
-- added `wp transient`, props [tollmanz](http://github.com/tollmanz)
-- added `wp db optimize` and `wp db repair`, props getsource
-- added `wp db create`, `wp db drop` and `wp db reset`
-- added `wp db import`, props [svaj](http://github.com/svaj)
-- added `wp core install_network`
-- added `wp core update_db`, props mwilliamson-red-gate
-- added `--json` option to several subcommands
-- added `--network` option to `wp plugin activate`
-- fixed `wp plugin update`
-
-Internals:
-
-- added `--require` global parameter
-- fixed "out of memory" error
-- misc bugfixes and optimizations
-- man pages (not in PEAR package)
-
-### [0.5](https://github.com/wp-cli/wp-cli/issues?milestone=3&state=closed)
-
-Commands:
-
-- added `wp user`, props [wopr42](http://github.com/wopr42)
-- added `wp core download`, props [ericandrewlewis](http://github.com/ericandrewlewis)
-- added `wp core config`
-- added `wp plugin update --all`, props [getsource](http://github.com/getsource)
-
-Internals:
-
-- added `--url` `--path` and `--user` global parameters
-- various bugfixes
-
-### [0.4](https://github.com/wp-cli/wp-cli/issues?milestone=2&state=closed)
-
-- added `wp eval` and `wp eval-file`
-- added `wp export`
-- added `wp core install`
-- fixed `wp core update`
-- added `--dev` flag to `wp plugin install`
-- added `wp plugin uninstall`
-- fixed `wp plugin install` and `wp plugin update`
-
-### 0.3
-
-- added `wp sql`
-- improved `wp option`
-- pear installer
-
-### 0.2
-
-- added multisite support
-- improved `wp plugin` and `wp theme`
-- added `wp generate`
-- added `wp core version`
-- added `wp --version`
-- added bash completion script
-
-### 0.1
-
-- initial release
-
 Contributors
 ------------
 

From fcabe41c4760a0ba39f28b98d375b690ad79feb9 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 16 Mar 2013 22:07:45 +0200
Subject: [PATCH 091/194] add post about `wp post edit`

---
 _posts/2013-03-16-editing-posts.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 _posts/2013-03-16-editing-posts.md

diff --git a/_posts/2013-03-16-editing-posts.md b/_posts/2013-03-16-editing-posts.md
new file mode 100644
index 00000000..cbf1209d
--- /dev/null
+++ b/_posts/2013-03-16-editing-posts.md
@@ -0,0 +1,18 @@
+---
+layout: post
+title: Edit WordPress Posts in Vim or Emacs or Whatever
+author: scribu
+---
+A few years ago, I came across a very interesting project by Joseph Scott, called [PressFS][1]; it exposed WordPress posts as plain text files on your filesystem. This allowed you to use all your favorite command-line tools to manipulate these posts, including editing their content in your favorite text editor.
+
+With [WP-CLI](/) 0.9.0-beta, you can do the same thing:
+
+```bash
+wp post edit 123
+```
+
+Once you run that command, your `$EDITOR` will open up, pre-filled with the content of the post with ID 123. After you've made your changes and quit the editor, WP-CLI will update the post in the database.
+
+Credit goes to [goldenapples](https://github.com/goldenapples) for [implementing](https://github.com/wp-cli/wp-cli/pull/302) it.
+
+[1]: https://github.com/josephscott/pressfs

From 43dce5ceeaf9c52b783a4a90cfedf3c2c26f3d6d Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 17 Mar 2013 07:55:58 +0200
Subject: [PATCH 092/194] mention Jekyll

---
 README.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 5af42d20..9ac5037f 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,16 @@
 ### Setup
 
-1. Install [composer](http://getcomposer.org/).
+1. Install [Composer](http://getcomposer.org/).
 
-2. Install dev dependencies:
-
-```bash
-composer install --dev
-```
+2. Install dev dependencies with `composer install --dev`
 
 3. Build:
 
 ```bash
 vendor/bin/phake path=/path/to/wp/install
 ```
+
+### Preview locally
+
+1. [Install Jekyll](https://github.com/mojombo/jekyll/wiki/install).
+2. Run `jekyll --serve --auto`

From cf0e27936f1403b733ec77c559befd66edb213fe Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 8 Mar 2013 15:15:49 +0200
Subject: [PATCH 093/194] clarify minimum requirements

see wp-cli/wp-cli#338
---
 index.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/index.md b/index.md
index b526fc7e..f0e96509 100644
--- a/index.md
+++ b/index.md
@@ -5,11 +5,12 @@ title: Command line interface for WordPress
 
 **wp-cli** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, create posts and much more.
 
-Requirements
-============
+Minimum Requirements
+==========
+
+You'll need **PHP 5.3** or later.
 
-* PHP >= 5.3
-* WordPress >= 3.3
+All WP-CLI commands are guaranteed to work with **WordPress 3.4** or later. Some commands, like `wp core update`, might work with older versions as well.
 
 Installing
 ==========

From 2dd5e24fbea30b742ec23dcf67a55538e7c8cb99 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 20 Mar 2013 18:34:08 +0200
Subject: [PATCH 094/194] update the command list

---
 _includes/cmd-list.html   | 12 ++++++++++++
 _includes/param-list.html |  2 +-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/_includes/cmd-list.html b/_includes/cmd-list.html
index 542e864c..ecd4f497 100644
--- a/_includes/cmd-list.html
+++ b/_includes/cmd-list.html
@@ -42,6 +42,10 @@
 		

+	
+		
+		
+	
@@ -62,6 +66,10 @@
 		
+	
+		
+		
+	
@@ -74,6 +82,10 @@
 		
+	
+		
+		
+	
diff --git a/_includes/param-list.html b/_includes/param-list.html
index 95e4cb8a..ba26493a 100644
--- a/_includes/param-list.html
+++ b/_includes/param-list.html
@@ -38,7 +38,7 @@
 		
-		
+		

From 8e0d739d94b590458f326f22dfde19b2eb4bb28b Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 17 Feb 2013 21:26:12 +0200
Subject: [PATCH 095/194] add release post for 0.9

---
 _posts/2013-03-20-version-0.9.md | 41 ++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 _posts/2013-03-20-version-0.9.md

diff --git a/_posts/2013-03-20-version-0.9.md b/_posts/2013-03-20-version-0.9.md
new file mode 100644
index 00000000..07fa8138
--- /dev/null
+++ b/_posts/2013-03-20-version-0.9.md
@@ -0,0 +1,41 @@
+---
+layout: post
+title: Version 0.9 released
+author: scribu
+---
+Version 0.9.0 is now available.
+
+### New distribution method
+
+The PEAR channel has been abandoned, and replaced with a much simpler distribution method: you download a single Phar archive. Done.
+
+Of course, installing via git is still possible and encouraged, if you want to hack on WP-CLI.
+
+The [front page](/) has up-to-date information about all the supported installation methods.
+
+### Changelog
+
+Commands:
+
+- added `wp role` command
+- added `wp term` command
+- added [wp post edit](/blog/editing-posts.html)
+- added `--edit` flag to `wp post create`
+- added `wp scaffold _s`
+- added `wp core init-tests`
+- made `wp scaffold plugin` generate files for unit tests. see the [blog post](/blog/plugin-unit-tests.html)
+- added `--format` parameter to `wp user list`
+- made `wp help` work without a WP install
+- added `--force` flag to `wp core download`
+
+Internals:
+
+- fixed `--path` argument getting ignored when running `wp core download`
+- don't set `WP_ADMIN` to true
+- fixed loading error with some `wp-config.php` files
+- replaced git submodules with Composer dependencies
+- improved functional test coverage and set up [Travis CI builds](https://travis-ci.org/wp-cli/wp-cli)
+
+You can also browse the full list of [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=7&state=closed).
+
+Contributors to this release: [danielbachhuber](http://github.com/danielbachhuber), [drrobotnik](http://github.com/drrobotnik), [erwanlr](http://github.com/erwanlr), [goldenapples](http://github.com/goldenapples), [jmslbam](http://github.com/jmslbam), [leewillis77](http://github.com/leewillis77), [nacin](http://github.com/nacin), [nb](http://github.com/nb), [ocean90](http://github.com/ocean90), [scribu](http://github.com/scribu), [sebastiaandegeus](http://github.com/sebastiaandegeus), [taupecat](http://github.com/taupecat).

From 74288dabaab5f8ee41fe89a3b685df079ec8a281 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 20 Mar 2013 19:30:04 +0200
Subject: [PATCH 096/194] mention media regenerate. see #3

---
 _posts/2013-03-20-version-0.9.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_posts/2013-03-20-version-0.9.md b/_posts/2013-03-20-version-0.9.md
index 07fa8138..6bbf953a 100644
--- a/_posts/2013-03-20-version-0.9.md
+++ b/_posts/2013-03-20-version-0.9.md
@@ -17,6 +17,7 @@ The [front page](/) has up-to-date information about all the supported installat
 
 Commands:
 
+- added `wp media regenerate` command. props [Viper007Bond](https://github.com/Viper007Bond) and [benmay](https://github.com/benmay) for the initial work
 - added `wp role` command
 - added `wp term` command
 - added [wp post edit](/blog/editing-posts.html)

From 767174e13396316f90937f156136d1b66a0f0512 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 21 Mar 2013 01:43:22 +0200
Subject: [PATCH 097/194] add pagination

---
 _config.yml               |  1 +
 _includes/footer.html     |  7 ++-----
 assets/css/stylesheet.css | 16 ++++++++++++++++
 blog/index.html           | 20 +++++++++++++++++++-
 4 files changed, 38 insertions(+), 6 deletions(-)

diff --git a/_config.yml b/_config.yml
index d137e76a..cf171e3e 100644
--- a/_config.yml
+++ b/_config.yml
@@ -4,5 +4,6 @@ pygments: true
 markdown: redcarpet
 url: http://wp-cli.org
 permalink: /blog/:title.html
+paginate: 10
 exclude:
   - Phakefile.php
diff --git a/_includes/footer.html b/_includes/footer.html
index 67a74fcb..0f1ad07a 100644
--- a/_includes/footer.html
+++ b/_includes/footer.html
@@ -1,10 +1,7 @@
 			
 		
-		
+
+		
 
 		{% include analytics.html %}
 	
diff --git a/assets/css/stylesheet.css b/assets/css/stylesheet.css
index 07e2148d..5c663190 100644
--- a/assets/css/stylesheet.css
+++ b/assets/css/stylesheet.css
@@ -74,6 +74,8 @@ header h2 {
 }
 
 footer {
+	clear: both;
+	display: block;
 	text-align: center;
 	font-size: 10px;
 	margin: 20px 10px 10px 10px;
@@ -279,3 +281,17 @@ article + article {
 	color: #666;
 }
 
+/* Pagination */
+
+.pagination {
+	display: block;
+	overflow: hidden;
+}
+
+.pagination .prev {
+	float: left;
+}
+
+.pagination .next {
+	float: right;
+}
diff --git a/blog/index.html b/blog/index.html
index 61c6d98c..c5d3c488 100644
--- a/blog/index.html
+++ b/blog/index.html
@@ -3,7 +3,7 @@
 title: Blog
 ---
 
-{% for post in site.posts limit: 10 %}
+{% for post in paginator.posts %}
 
 {% endfor %}
+
+

From 642221e224346250a608bcfeac5da820d82051d6 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 21 Mar 2013 01:49:50 +0200
Subject: [PATCH 098/194] trigger another page build

---
 _includes/header.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/_includes/header.html b/_includes/header.html
index ea93681f..e0ce8199 100644
--- a/_includes/header.html
+++ b/_includes/header.html
@@ -1,8 +1,8 @@
 
 
 	
-		
-		
+		
+		
 
 		
 

From 8bd31b800f0463c251e291bf7baa6eefe61a6e35 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 21 Mar 2013 02:07:19 +0200
Subject: [PATCH 099/194] add ugly hack for Jekyll 0.12.0. fixes #9

---
 index.md => _includes/index.md | 5 -----
 index.html                     | 9 +++++++++
 2 files changed, 9 insertions(+), 5 deletions(-)
 rename index.md => _includes/index.md (98%)
 create mode 100644 index.html

diff --git a/index.md b/_includes/index.md
similarity index 98%
rename from index.md
rename to _includes/index.md
index f0e96509..8b223355 100644
--- a/index.md
+++ b/_includes/index.md
@@ -1,8 +1,3 @@
----
-layout: default
-title: Command line interface for WordPress
----
-
 **wp-cli** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, create posts and much more.
 
 Minimum Requirements
diff --git a/index.html b/index.html
new file mode 100644
index 00000000..a539b8d9
--- /dev/null
+++ b/index.html
@@ -0,0 +1,9 @@
+---
+layout: default
+title: Command line interface for WordPress
+---
+{% capture content %}
+{% include index.md %}
+{% endcapture %}
+
+{{ content | markdownify }}

From 319b47c2d862fa767500203e0a4736d3a1c68dd0 Mon Sep 17 00:00:00 2001
From: jmslbam 
Date: Mon, 18 Mar 2013 13:06:55 +0100
Subject: [PATCH 100/194] Added post about scaffolding custom post types and
 taxonomies

---
 ...olding-custom-post-types-and-taxonomies.md | 63 +++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 _posts/2013-03-18-scaffolding-custom-post-types-and-taxonomies.md

diff --git a/_posts/2013-03-18-scaffolding-custom-post-types-and-taxonomies.md b/_posts/2013-03-18-scaffolding-custom-post-types-and-taxonomies.md
new file mode 100644
index 00000000..e0495079
--- /dev/null
+++ b/_posts/2013-03-18-scaffolding-custom-post-types-and-taxonomies.md
@@ -0,0 +1,63 @@
+---
+layout: post
+title: Scaffolding custom post types and taxonomies
+author: jmslbam
+---
+
+The `wp scaffold command` can generate code that registers Custom Post Types and Custom Taxonomies. Most of the time this is done by copy+pasting it from let's say the WordPress Codex or having the code as shortcode/snippet in your editor.  
+Now you can use WP-CLI for this.
+
+### Scaffold a custom post type
+The following command generates a Custom Post Type and registers the post type including update messages.
+
+```bash
+wp scaffold post-type zombie
+```
+
+Scaffold a taxonomy
+The following command generates a Custom Taxonomy and registers the taxonomy to the Post Type zombie.
+
+```bash
+wp scaffold taxonomy zombie-speed post-type=zombie
+```
+
+### But where does the code go?
+This is a personal preference. Some ship it within a theme, while others will save it within a plugin.
+That's why there a these two flags:
+
+```bash
+wp scaffold post-type zombie --theme
+```
+`–theme` stores the generated code within your current active theme under a `/post-types` directory and names a file name `zombie.php`
+
+```bash
+wp scaffold post-type zombie --plugin=pluginname
+```
+
+`–plugin=plugin-dir-name` stores the generated code within the given plugin name.  
+ 
+No flag will output the code to you terminal (STDOUT) so you could write it too your file of choice.
+
+```bash
+wp scaffold post-type zombie > ~/project/foo/bar.php
+```
+### But I only want the registration of the post-type...
+Then you can add the `–raw` flag 
+
+```bash
+wp scaffold post-type zombie --raw
+```
+This will only output the code that will `register_post_type()` without the init action and the update messages.
+
+### And what about I18n?
+Internationalization by gettext can be achieved through `–textdomain=my-textdomain`
+
+Default when using the `–theme`, the textdomain will be that of your active theme.
+Otherwise by using the `–plugin` flag, the textdomain will be your plugin name.
+
+```bash
+wp scaffold post-type zombie --textdomain=my-textdomain
+```
+Enjoy these commands, we hope it will speed-up and ease your development with WordPress and  WP-CLI!
+
+Props [sebastiaandegeus](https://github.com/sebastiaandegeus), [scribu](https://github.com/scribu), [jmslbam](https://github.com/jmslbam)

From 38f8793072ef9171386092cd234d28f7731d283d Mon Sep 17 00:00:00 2001
From: jmslbam 
Date: Mon, 18 Mar 2013 16:33:33 +0100
Subject: [PATCH 101/194] Dashes and title fix

---
 ...13-03-18-scaffolding-custom-post-types-and-taxonomies.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/_posts/2013-03-18-scaffolding-custom-post-types-and-taxonomies.md b/_posts/2013-03-18-scaffolding-custom-post-types-and-taxonomies.md
index e0495079..84bdd3a0 100644
--- a/_posts/2013-03-18-scaffolding-custom-post-types-and-taxonomies.md
+++ b/_posts/2013-03-18-scaffolding-custom-post-types-and-taxonomies.md
@@ -1,6 +1,6 @@
 ---
 layout: post
-title: Scaffolding custom post types and taxonomies
+title: Scaffolding Custom Post Types and Taxonomies
 author: jmslbam
 ---
 
@@ -28,13 +28,13 @@ That's why there a these two flags:
 ```bash
 wp scaffold post-type zombie --theme
 ```
-`–theme` stores the generated code within your current active theme under a `/post-types` directory and names a file name `zombie.php`
+`--theme` stores the generated code within your current active theme under a `/post-types` directory and names a file name `zombie.php`
 
 ```bash
 wp scaffold post-type zombie --plugin=pluginname
 ```
 
-`–plugin=plugin-dir-name` stores the generated code within the given plugin name.  
+`--plugin=plugin-dir-name` stores the generated code within the given plugin name.  
  
 No flag will output the code to you terminal (STDOUT) so you could write it too your file of choice.
 

From b6de5d1df743fadf8d10b43ee985aad5c7cbf62c Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 29 Mar 2013 01:34:00 +0200
Subject: [PATCH 102/194] update post date. see #8

---
 ...=> 2013-03-29-scaffolding-custom-post-types-and-taxonomies.md} | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename _posts/{2013-03-18-scaffolding-custom-post-types-and-taxonomies.md => 2013-03-29-scaffolding-custom-post-types-and-taxonomies.md} (100%)

diff --git a/_posts/2013-03-18-scaffolding-custom-post-types-and-taxonomies.md b/_posts/2013-03-29-scaffolding-custom-post-types-and-taxonomies.md
similarity index 100%
rename from _posts/2013-03-18-scaffolding-custom-post-types-and-taxonomies.md
rename to _posts/2013-03-29-scaffolding-custom-post-types-and-taxonomies.md

From 6e0b85dc21a358d6820a4eb6868e20aea4f811d3 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 29 Mar 2013 01:59:15 +0200
Subject: [PATCH 103/194] clean up scaffolding blog post:

* add missing newlines
* fix formatting, typos etc.
* remove props; the contributors are already mentioned in the release posts

see #8
---
 ...olding-custom-post-types-and-taxonomies.md | 48 +++++++++++--------
 1 file changed, 27 insertions(+), 21 deletions(-)

diff --git a/_posts/2013-03-29-scaffolding-custom-post-types-and-taxonomies.md b/_posts/2013-03-29-scaffolding-custom-post-types-and-taxonomies.md
index 84bdd3a0..f7c38e73 100644
--- a/_posts/2013-03-29-scaffolding-custom-post-types-and-taxonomies.md
+++ b/_posts/2013-03-29-scaffolding-custom-post-types-and-taxonomies.md
@@ -3,31 +3,44 @@ layout: post
 title: Scaffolding Custom Post Types and Taxonomies
 author: jmslbam
 ---
+Custom post types and custom taxonomies are the building blocks for advanced functionality. Most of the time, the code for registering them is either copy+pasted from somewhere or it's saved as a snippet in your text editor.  
 
-The `wp scaffold command` can generate code that registers Custom Post Types and Custom Taxonomies. Most of the time this is done by copy+pasting it from let's say the WordPress Codex or having the code as shortcode/snippet in your editor.  
-Now you can use WP-CLI for this.
+Now you can do this with WP-CLI, using the `wp scaffold` command.
 
 ### Scaffold a custom post type
-The following command generates a Custom Post Type and registers the post type including update messages.
+
+The following command generates the code for registering the post type and also for customizing the update messages:
 
 ```bash
 wp scaffold post-type zombie
 ```
 
-Scaffold a taxonomy
-The following command generates a Custom Taxonomy and registers the taxonomy to the Post Type zombie.
+### Scaffold a taxonomy
+
+The following command generates the code for registering the taxonomy to the zombie post type:
 
 ```bash
-wp scaffold taxonomy zombie-speed post-type=zombie
+wp scaffold taxonomy zombie-speed --post-type=zombie
+```
+
+### But I only want the registration of the post-type...
+
+Then you can add the `--raw` flag:
+
+```bash
+wp scaffold post-type zombie --raw
 ```
 
+This will only output the code that will `register_post_type()` without the `init` action and the update messages.
+
 ### But where does the code go?
-This is a personal preference. Some ship it within a theme, while others will save it within a plugin.
-That's why there a these two flags:
+
+This is a personal preference. Some ship it within a theme, while others will save it within a plugin. That's why we have these two flags:
 
 ```bash
 wp scaffold post-type zombie --theme
 ```
+
 `--theme` stores the generated code within your current active theme under a `/post-types` directory and names a file name `zombie.php`
 
 ```bash
@@ -36,28 +49,21 @@ wp scaffold post-type zombie --plugin=pluginname
 
 `--plugin=plugin-dir-name` stores the generated code within the given plugin name.  
  
-No flag will output the code to you terminal (STDOUT) so you could write it too your file of choice.
+By default, the code will be output to your terminal (STDOUT) so you could write it to your file of choice:
 
 ```bash
 wp scaffold post-type zombie > ~/project/foo/bar.php
 ```
-### But I only want the registration of the post-type...
-Then you can add the `–raw` flag 
-
-```bash
-wp scaffold post-type zombie --raw
-```
-This will only output the code that will `register_post_type()` without the init action and the update messages.
 
 ### And what about I18n?
-Internationalization by gettext can be achieved through `–textdomain=my-textdomain`
 
-Default when using the `–theme`, the textdomain will be that of your active theme.
-Otherwise by using the `–plugin` flag, the textdomain will be your plugin name.
+Internationalization by gettext can be achieved through the `--textdomain` parameter:
 
 ```bash
 wp scaffold post-type zombie --textdomain=my-textdomain
 ```
-Enjoy these commands, we hope it will speed-up and ease your development with WordPress and  WP-CLI!
 
-Props [sebastiaandegeus](https://github.com/sebastiaandegeus), [scribu](https://github.com/scribu), [jmslbam](https://github.com/jmslbam)
+By default when using the `--theme`, the textdomain will be that of your active theme, and if 
+using the `--plugin` flag, the textdomain will be your plugin name.
+
+Enjoy these commands; we hope it will speed-up and ease your development with WordPress!

From d3395300d297ba63f6dd5bd4bfebaa9f5a6a0919 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 29 Mar 2013 04:26:20 +0200
Subject: [PATCH 104/194] don't use sudo to invoke dev-build. closes
 wp-cli/wp-cli#368

---
 _includes/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_includes/index.md b/_includes/index.md
index 8b223355..cd67d2cc 100644
--- a/_includes/index.md
+++ b/_includes/index.md
@@ -27,7 +27,7 @@ If you have Suhosin enabled, make sure to set `suhosin.executor.include.whitelis
 ```
 git clone git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
 cd ~/git/wp-cli
-sudo utils/dev-build
+./utils/dev-build
 ```
 
 You can replace `~/git/wp-cli` with whatever you want.

From e38c7c38bc842a0f6cfd44865be5c60aec451069 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 8 Apr 2013 08:09:28 +0300
Subject: [PATCH 105/194] add link to list of community commands

---
 commands/index.html | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/commands/index.html b/commands/index.html
index c4ef67f0..91fb29a3 100644
--- a/commands/index.html
+++ b/commands/index.html
@@ -14,3 +14,5 @@
 	{% include cmd-list.html %}
 	

 	
 	
ConfigFlagDefaultDescriptionConfigFlagDefaultDescription
 	

 	
 	
home
 		Open the wp-cli homepage in your browser.
 	
mediaControl the media library and its attachments.

 	

 		option
 		Manage WordPress options.rewrite
 		Manage rewrite rules.
 	
roleManage user roles.

 	

 		scaffold
 		Generate code for post types, taxonomies, etc.shell
 		Interactive PHP console.
 	
termManage terms.

 	

 		theme
 		Manage themes.color: <bool>
 		--[no-]color
 		"auto"Whether to colozire the outputWhether to colorize the output
 	

 	

 		debug: <bool>

 

+
+
Also see the list of community commands.


From 3d72bca58bb166becbd105e5f70fa6ffc6e1b7ce Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 26 Apr 2013 23:09:55 +0300
Subject: [PATCH 106/194] rename install methods

---
 _includes/index.md | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/_includes/index.md b/_includes/index.md
index cd67d2cc..66605f72 100644
--- a/_includes/index.md
+++ b/_includes/index.md
@@ -10,7 +10,7 @@ All WP-CLI commands are guaranteed to work with **WordPress 3.4** or later. Some
 Installing
 ==========
 
-**Via Phar Archive:**
+### Easy install (Phar archive)
 
 You can download WP-CLI packaged as a [single file](http://wp-cli.org/packages/phar/wp-cli.phar) ([md5](http://wp-cli.org/packages/phar/wp-cli.phar.md5)):
 
@@ -22,17 +22,19 @@ chmod +x /usr/bin/wp
 
 If you have Suhosin enabled, make sure to set `suhosin.executor.include.whitelist="phar"` in your `suhosin.ini` or `php.ini` file.
 
-**Via GIT:**
+### Global install (requires sudo)
+
+Install WP-CLI for all users of the system:
 
 ```
-git clone git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
-cd ~/git/wp-cli
+git clone git://github.com/wp-cli/wp-cli.git /usr/share/wp-cli
+cd /usr/share/wp-cli
 ./utils/dev-build
 ```
 
-You can replace `~/git/wp-cli` with whatever you want.
+### Local install
 
-**Via GIT (without sudo):**
+Install WP-CLI only for yourself:
 
 ```
 git clone git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
@@ -50,10 +52,9 @@ source ~/git/wp-cli/utils/wp-completion.bash
 
 Add the above two lines to your `.bashrc` or `.bash_profile` file to have it set up automatically when you log in.
 
-MAMP, XAMP, etc.
------------
+### MAMP, XAMP, etc.
 
-If the `php` command is not available, you can try finding an appropriate binary:
+If the `php` command is not available in your PATH, you can try finding an appropriate binary:
 
 ```
 ./utils/find-php

From 60a941abd4747059294fa272088e9c275a3cf30f Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 27 Apr 2013 00:43:13 +0300
Subject: [PATCH 107/194] more useful find-php invocation

---
 _includes/index.md | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/_includes/index.md b/_includes/index.md
index 66605f72..09ba9289 100644
--- a/_includes/index.md
+++ b/_includes/index.md
@@ -57,15 +57,7 @@ Add the above two lines to your `.bashrc` or `.bash_profile` file to have it set
 If the `php` command is not available in your PATH, you can try finding an appropriate binary:
 
 ```
-./utils/find-php
-```
-
-Then, create an environment variable called `WP_CLI_PHP` with the path found by `find-php`.
-
-In a UNIX environment, you would do this by adding the following line to your `.bashrc` file:
-
-```
-export WP_CLI_PHP=/path/to/php-binary
+ln -s $(./utils/find-php) /usr/bin/php
 ```
 
 Using

From f576a2e5aa9bf911693794d9b3781052c466793a Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 8 May 2013 20:06:19 +0300
Subject: [PATCH 108/194] Add installer.sh and update install instructions

Focus on a single, sudoless, install method.

Sysadmins that need to install WP-CLI globally can fend for themselves.
---
 _includes/index.md | 49 +++++++++++++++-------------------------------
 installer.sh       | 49 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 65 insertions(+), 33 deletions(-)
 create mode 100755 installer.sh

diff --git a/_includes/index.md b/_includes/index.md
index 09ba9289..fe7be226 100644
--- a/_includes/index.md
+++ b/_includes/index.md
@@ -1,4 +1,4 @@
-**wp-cli** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, create posts and much more.
+**WP-CLI** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, create posts and much more.
 
 Minimum Requirements
 ==========
@@ -10,54 +10,37 @@ All WP-CLI commands are guaranteed to work with **WordPress 3.4** or later. Some
 Installing
 ==========
 
-### Easy install (Phar archive)
-
-You can download WP-CLI packaged as a [single file](http://wp-cli.org/packages/phar/wp-cli.phar) ([md5](http://wp-cli.org/packages/phar/wp-cli.phar.md5)):
+Just execute the following command:
 
 ```
-sudo -s
-curl http://wp-cli.org/packages/phar/wp-cli.phar > /usr/bin/wp
-chmod +x /usr/bin/wp
+curl http://wp-cli.org/installer.sh | sh
 ```
 
-If you have Suhosin enabled, make sure to set `suhosin.executor.include.whitelist="phar"` in your `suhosin.ini` or `php.ini` file.
-
-### Global install (requires sudo)
+This will allow you to run `~/.composer/bin/wp`.
 
-Install WP-CLI for all users of the system:
+If you want to be able to type just `wp`, add the following lines to your `.bash_profile` file:
 
 ```
-git clone git://github.com/wp-cli/wp-cli.git /usr/share/wp-cli
-cd /usr/share/wp-cli
-./utils/dev-build
-```
-
-### Local install
+# Composer scripts
+PATH=$HOME/.composer/bin/:$PATH
 
-Install WP-CLI only for yourself:
-
-```
-git clone git://github.com/wp-cli/wp-cli.git ~/git/wp-cli
-cd ~/git/wp-cli
-curl -sS https://getcomposer.org/installer | php
-php composer.phar install
+# WP-CLI completions
+source $HOME/.composer/vendor/wp-cli/wp-cli/utils/wp-completion.bash
 ```
 
-Now, set up the `wp` alias:
+Finally, reload the file:
 
-```bash
-alias wp='~/git/wp-cli/bin/wp'
-source ~/git/wp-cli/utils/wp-completion.bash
+```
+source ~/.bash_profile
 ```
 
-Add the above two lines to your `.bashrc` or `.bash_profile` file to have it set up automatically when you log in.
-
-### MAMP, XAMP, etc.
+### Updating
 
-If the `php` command is not available in your PATH, you can try finding an appropriate binary:
+If you installed WP-CLI using the method above, you can also easily update it:
 
 ```
-ln -s $(./utils/find-php) /usr/bin/php
+cd ~/.composer
+php composer.phar update
 ```
 
 Using
diff --git a/installer.sh b/installer.sh
new file mode 100755
index 00000000..5e224479
--- /dev/null
+++ b/installer.sh
@@ -0,0 +1,49 @@
+#!/usr/bin/env sh
+
+set -e
+
+# check that PHP is available
+command -v php > /dev/null || {
+	echo "can't find PHP binary" >&2
+	exit 1
+}
+
+mkdir -p ~/.composer
+cd ~/.composer
+
+# install Composer
+if [ ! -x composer.phar ]; then
+	curl -sS https://getcomposer.org/installer | php
+fi
+
+# set up global composer.json file
+if [ ! -f composer.json ]; then
+	cat > composer.json <
Date: Wed, 8 May 2013 20:47:27 +0300
Subject: [PATCH 109/194] attempt to find appropriate PHP CLI

---
 installer.sh | 42 +++++++++++++++++++++++++++++++++++++-----
 1 file changed, 37 insertions(+), 5 deletions(-)

diff --git a/installer.sh b/installer.sh
index 5e224479..2ef45689 100755
--- a/installer.sh
+++ b/installer.sh
@@ -2,18 +2,50 @@
 
 set -e
 
-# check that PHP is available
-command -v php > /dev/null || {
-	echo "can't find PHP binary" >&2
+find_php() {
+	AMP_PATHS=< /dev/null && {
+			echo $cmd
+			exit
+		}
+	done
+
 	exit 1
 }
 
+# Find a PHP binary
+PHP=`find_php`
+if [ $? -eq 0 ]; then
+	if [ "$PHP" != 'php' ]; then
+		echo "using non-default PHP CLI: $php"
+	fi
+else
+	read -p "path to PHP CLI: " PHP
+fi
+
 mkdir -p ~/.composer
 cd ~/.composer
 
 # install Composer
 if [ ! -x composer.phar ]; then
-	curl -sS https://getcomposer.org/installer | php
+	curl -sS https://getcomposer.org/installer | $PHP
 fi
 
 # set up global composer.json file
@@ -31,7 +63,7 @@ if [ ! -f composer.json ]; then
 EOB
 fi
 
-COMPOSER="php composer.phar"
+COMPOSER="$PHP composer.phar"
 
 # install wp-cli
 $COMPOSER require wp-cli/wp-cli=dev-master

From edc67e008e3547b12da7d5a03db0101421d7b237 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 8 May 2013 21:01:17 +0300
Subject: [PATCH 110/194] mention WP_CLI_PHP

---
 _includes/index.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/_includes/index.md b/_includes/index.md
index fe7be226..32e76dd9 100644
--- a/_includes/index.md
+++ b/_includes/index.md
@@ -18,6 +18,12 @@ curl http://wp-cli.org/installer.sh | sh
 
 This will allow you to run `~/.composer/bin/wp`.
 
+If you get a `using non-default PHP CLI:` message, you should save that path in your `.bash_profile` file:
+
+```
+export WP_CLI_PHP=/path/found/during/install
+```
+
 If you want to be able to type just `wp`, add the following lines to your `.bash_profile` file:
 
 ```

From 429bae2cc2bf0f81bfe81d0cfa31978dfaae20af Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 8 May 2013 21:05:01 +0300
Subject: [PATCH 111/194] remove extra slash from PATH

---
 _includes/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_includes/index.md b/_includes/index.md
index 32e76dd9..3d527f95 100644
--- a/_includes/index.md
+++ b/_includes/index.md
@@ -28,7 +28,7 @@ If you want to be able to type just `wp`, add the following lines to your `.bash
 
 ```
 # Composer scripts
-PATH=$HOME/.composer/bin/:$PATH
+PATH=$HOME/.composer/bin:$PATH
 
 # WP-CLI completions
 source $HOME/.composer/vendor/wp-cli/wp-cli/utils/wp-completion.bash

From 218c32cf04cc53bdbae3e70d88ad3392afbbc4b8 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 8 May 2013 23:31:32 +0300
Subject: [PATCH 112/194] bump required PHP version to 5.3.2, since that's what
 Composer needs

---
 _includes/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/_includes/index.md b/_includes/index.md
index 3d527f95..69fbee30 100644
--- a/_includes/index.md
+++ b/_includes/index.md
@@ -3,7 +3,7 @@
 Minimum Requirements
 ==========
 
-You'll need **PHP 5.3** or later.
+You'll need **PHP 5.3.2** or later.
 
 All WP-CLI commands are guaranteed to work with **WordPress 3.4** or later. Some commands, like `wp core update`, might work with older versions as well.
 

From 8cb2188da74abcfacbee78b4bccb0e8a61d886b4 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 9 May 2013 13:21:50 +0300
Subject: [PATCH 113/194] installer: use 'bash' instead of 'sh'

In this day and age, bash is almost as ubiquituous as sh.
---
 _includes/index.md | 2 +-
 installer.sh       | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/_includes/index.md b/_includes/index.md
index 69fbee30..80af8869 100644
--- a/_includes/index.md
+++ b/_includes/index.md
@@ -13,7 +13,7 @@ Installing
 Just execute the following command:
 
 ```
-curl http://wp-cli.org/installer.sh | sh
+curl http://wp-cli.org/installer.sh | bash
 ```
 
 This will allow you to run `~/.composer/bin/wp`.
diff --git a/installer.sh b/installer.sh
index 2ef45689..c1a69ba8 100755
--- a/installer.sh
+++ b/installer.sh
@@ -1,4 +1,4 @@
-#!/usr/bin/env sh
+#!/usr/bin/env bash
 
 set -e
 

From 5aabe8e9e5a8231316264669efbc3a3021a715a2 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 12 May 2013 21:18:26 +0300
Subject: [PATCH 114/194] Abort install if the `wp` command is already
 available

see wp-cli/wp-cli#448
---
 installer.sh | 20 ++++++++++++++++----
 1 file changed, 16 insertions(+), 4 deletions(-)

diff --git a/installer.sh b/installer.sh
index c1a69ba8..6305b9c3 100755
--- a/installer.sh
+++ b/installer.sh
@@ -1,7 +1,5 @@
 #!/usr/bin/env bash
 
-set -e
-
 find_php() {
 	AMP_PATHS=<&2
+		echo "installation aborted" 1>&2
+		exit 1
+	fi
+fi
+
+set -e
+
 # Find a PHP binary
 PHP=`find_php`
 if [ $? -eq 0 ]; then
@@ -40,8 +52,8 @@ else
 	read -p "path to PHP CLI: " PHP
 fi
 
-mkdir -p ~/.composer
-cd ~/.composer
+mkdir -p $COMPOSER_DIR
+cd $COMPOSER_DIR
 
 # install Composer
 if [ ! -x composer.phar ]; then

From 5e36245bbb5342b06385b33db39e49ec6446d3e1 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 12 May 2013 21:45:06 +0300
Subject: [PATCH 115/194] Allow users to continue with the installation, even
 when there's a global `wp` available.

Example use-case: Dreamhost has wp-cli 0.7 installed globally and
someone wants to install the latest version just for themselves.

see wp-cli/wp-cli#448
---
 installer.sh | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/installer.sh b/installer.sh
index 6305b9c3..fa0e0aeb 100755
--- a/installer.sh
+++ b/installer.sh
@@ -34,9 +34,13 @@ COMPOSER_DIR=$HOME/.composer
 where=$(which wp)
 if [ $? -eq 0 ]; then
 	if [ "$COMPOSER_DIR/bin/wp" != "$where" ]; then
-		echo "the \`wp\` command is already available elsewhere: $where" 1>&2
-		echo "installation aborted" 1>&2
-		exit 1
+		echo "warning: the \`wp\` command is already available elsewhere: $where" 1>&2
+		read -p "this installation will not overwrite it. continue? [y/n] " -n 1 -r
+		echo
+		if [[ ! $REPLY =~ ^[Yy]$ ]]
+		then
+			exit 1
+		fi
 	fi
 fi
 

From 1fc61b56430db9434f661bdb12337343d19bcf20 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Tue, 14 May 2013 12:27:57 +0300
Subject: [PATCH 116/194] revert 8bd31b800f0463c251e291bf7baa6eefe61a6e35

Github Pages just updated to Jekyll 1.0.2
---
 index.html                     | 9 ---------
 _includes/index.md => index.md | 4 ++++
 2 files changed, 4 insertions(+), 9 deletions(-)
 delete mode 100644 index.html
 rename _includes/index.md => index.md (97%)

diff --git a/index.html b/index.html
deleted file mode 100644
index a539b8d9..00000000
--- a/index.html
+++ /dev/null
@@ -1,9 +0,0 @@
----
-layout: default
-title: Command line interface for WordPress
----
-{% capture content %}
-{% include index.md %}
-{% endcapture %}
-
-{{ content | markdownify }}
diff --git a/_includes/index.md b/index.md
similarity index 97%
rename from _includes/index.md
rename to index.md
index 80af8869..8b156a10 100644
--- a/_includes/index.md
+++ b/index.md
@@ -1,3 +1,7 @@
+---
+layout: default
+title: Command line interface for WordPress
+---
 **WP-CLI** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, create posts and much more.
 
 Minimum Requirements

From b3bb609bc450df48ff7ee2beb89e0388e4bd6895 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 15 May 2013 23:48:47 +0300
Subject: [PATCH 117/194] fix case where php-cli isn't installed

---
 installer.sh | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/installer.sh b/installer.sh
index fa0e0aeb..a7f76355 100755
--- a/installer.sh
+++ b/installer.sh
@@ -25,7 +25,7 @@ EOB
 		}
 	done
 
-	exit 1
+	return 1
 }
 
 COMPOSER_DIR=$HOME/.composer
@@ -44,8 +44,6 @@ if [ $? -eq 0 ]; then
 	fi
 fi
 
-set -e
-
 # Find a PHP binary
 PHP=`find_php`
 if [ $? -eq 0 ]; then
@@ -53,9 +51,11 @@ if [ $? -eq 0 ]; then
 		echo "using non-default PHP CLI: $php"
 	fi
 else
-	read -p "path to PHP CLI: " PHP
+	read -p "path to PHP binary: " PHP
 fi
 
+set -e
+
 mkdir -p $COMPOSER_DIR
 cd $COMPOSER_DIR
 

From 1251cd40e42ad14732b128d397817afd6b290f88 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 16 May 2013 03:06:21 +0300
Subject: [PATCH 118/194] fix message about non-default PHP and move it to the
 bottom

---
 installer.sh | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/installer.sh b/installer.sh
index a7f76355..171de18a 100755
--- a/installer.sh
+++ b/installer.sh
@@ -46,11 +46,7 @@ fi
 
 # Find a PHP binary
 PHP=`find_php`
-if [ $? -eq 0 ]; then
-	if [ "$PHP" != 'php' ]; then
-		echo "using non-default PHP CLI: $php"
-	fi
-else
+if [ $? -gt 0 ]; then
 	read -p "path to PHP binary: " PHP
 fi
 
@@ -95,3 +91,7 @@ To test, run:
 
 	~/.composer/bin/wp --info
 EOB
+
+if [ "$PHP" != 'php' ]; then
+	echo "using non-default PHP CLI: $PHP"
+fi

From 7baab50843c7fcb4a0ad3178de30b66521f313bc Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 16 May 2013 03:44:31 +0300
Subject: [PATCH 119/194] check for WP_CLI_PHP env variable and validate it

this also allows forcing a particular PHP binary
---
 installer.sh | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/installer.sh b/installer.sh
index 171de18a..65110317 100755
--- a/installer.sh
+++ b/installer.sh
@@ -18,12 +18,7 @@ EOB
 		fi
 	done
 
-	for cmd in php php-cli; do
-		command -v $cmd > /dev/null && {
-			echo $cmd
-			exit
-		}
-	done
+	which php || which php-cli
 
 	return 1
 }
@@ -45,19 +40,24 @@ if [ $? -eq 0 ]; then
 fi
 
 # Find a PHP binary
-PHP=`find_php`
-if [ $? -gt 0 ]; then
-	read -p "path to PHP binary: " PHP
+if [ -z $WP_CLI_PHP ]; then
+	WP_CLI_PHP=`find_php`
+	if [ $? -gt 0 ]; then
+		read -p "path to PHP binary: " WP_CLI_PHP
+	fi
+else
+	command -v $WP_CLI_PHP > /dev/null || {
+		echo "invalid PHP binary: $WP_CLI_PHP" 1>&2
+		exit 1
+	}
 fi
 
-set -e
-
 mkdir -p $COMPOSER_DIR
 cd $COMPOSER_DIR
 
 # install Composer
 if [ ! -x composer.phar ]; then
-	curl -sS https://getcomposer.org/installer | $PHP
+	curl -sS https://getcomposer.org/installer | $WP_CLI_PHP
 fi
 
 # set up global composer.json file
@@ -75,7 +75,7 @@ if [ ! -f composer.json ]; then
 EOB
 fi
 
-COMPOSER="$PHP composer.phar"
+COMPOSER="$WP_CLI_PHP composer.phar" 
 
 # install wp-cli
 $COMPOSER require wp-cli/wp-cli=dev-master
@@ -90,8 +90,9 @@ WP-CLI files have been succesfully installed.
 To test, run:
 
 	~/.composer/bin/wp --info
+
 EOB
 
-if [ "$PHP" != 'php' ]; then
-	echo "using non-default PHP CLI: $PHP"
+if [ $WP_CLI_PHP != $(which php) ]; then
+	echo "using non-default PHP binary: $WP_CLI_PHP"
 fi

From d2b4ca1094a4f5c4aa874fb68a92a2cf34780c89 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 16 May 2013 03:46:53 +0300
Subject: [PATCH 120/194] disable colors when installing Boris

---
 installer.sh | 16 ++++++++++++----
 1 file changed, 12 insertions(+), 4 deletions(-)

diff --git a/installer.sh b/installer.sh
index 65110317..8aa1369d 100755
--- a/installer.sh
+++ b/installer.sh
@@ -77,11 +77,19 @@ fi
 
 COMPOSER="$WP_CLI_PHP composer.phar" 
 
-# install wp-cli
-$COMPOSER require wp-cli/wp-cli=dev-master
+command -v bin/wp > /dev/null || {
+	echo
+	echo "Installing the main WP-CLI package..."
+	echo "-------------------------------------"
+	$COMPOSER require wp-cli/wp-cli=dev-master
+}
 
-# try installing Boris
-$COMPOSER require d11wtq/boris=dev-master || true
+command -v bin/boris > /dev/null || {
+	echo
+	echo "Installing the Boris package..."
+	echo "-------------------------------"
+	$COMPOSER --no-ansi require d11wtq/boris=dev-master || true
+}
 
 cat <
Date: Thu, 16 May 2013 20:06:14 +0300
Subject: [PATCH 121/194] installer: add quotes around variables, in case
 they're empty

---
 installer.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/installer.sh b/installer.sh
index 8aa1369d..ba89dc0f 100755
--- a/installer.sh
+++ b/installer.sh
@@ -101,6 +101,6 @@ To test, run:
 
 EOB
 
-if [ $WP_CLI_PHP != $(which php) ]; then
+if [ "$WP_CLI_PHP" != "$(which php)" ]; then
 	echo "using non-default PHP binary: $WP_CLI_PHP"
 fi

From ca4028fd58ee00ce4cdac67108303825394b615b Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 16 May 2013 23:47:05 +0300
Subject: [PATCH 122/194] installer: return 1 only if the `which` calls fail

---
 installer.sh | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/installer.sh b/installer.sh
index ba89dc0f..733abb57 100755
--- a/installer.sh
+++ b/installer.sh
@@ -18,9 +18,7 @@ EOB
 		fi
 	done
 
-	which php || which php-cli
-
-	return 1
+	which php || which php-cli || return 1
 }
 
 COMPOSER_DIR=$HOME/.composer

From b53f9efcb774f3000e45a3157186cf7191dbcef1 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 16 May 2013 20:22:45 +0300
Subject: [PATCH 123/194] `which` is not silent on Linux

---
 installer.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/installer.sh b/installer.sh
index 733abb57..93b5990d 100755
--- a/installer.sh
+++ b/installer.sh
@@ -24,7 +24,7 @@ EOB
 COMPOSER_DIR=$HOME/.composer
 
 # Abort install if wp-cli is already installed via ./utils/dev-build
-where=$(which wp)
+where=$(which wp 2>/dev/null)
 if [ $? -eq 0 ]; then
 	if [ "$COMPOSER_DIR/bin/wp" != "$where" ]; then
 		echo "warning: the \`wp\` command is already available elsewhere: $where" 1>&2

From babab072930db2f7503492c9257dbd11d8a35a39 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 16 May 2013 20:22:07 +0300
Subject: [PATCH 124/194] allow setting the COMPOSER_DIR variable

---
 installer.sh | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/installer.sh b/installer.sh
index 93b5990d..8f686b9e 100755
--- a/installer.sh
+++ b/installer.sh
@@ -21,7 +21,9 @@ EOB
 	which php || which php-cli || return 1
 }
 
-COMPOSER_DIR=$HOME/.composer
+if [ -z $COMPOSER_DIR ]; then
+	COMPOSER_DIR=$HOME/.composer
+fi
 
 # Abort install if wp-cli is already installed via ./utils/dev-build
 where=$(which wp 2>/dev/null)

From e191b26b2e9369baf5c8dd9abacf95f3d59bb321 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 16 May 2013 23:04:17 +0300
Subject: [PATCH 125/194] rename COMPOSER_DIR to INSTALL_DIR

---
 installer.sh | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/installer.sh b/installer.sh
index 8f686b9e..9d0435a3 100755
--- a/installer.sh
+++ b/installer.sh
@@ -21,14 +21,14 @@ EOB
 	which php || which php-cli || return 1
 }
 
-if [ -z $COMPOSER_DIR ]; then
-	COMPOSER_DIR=$HOME/.composer
+if [ -z $INSTALL_DIR ]; then
+	INSTALL_DIR=$HOME/.composer
 fi
 
 # Abort install if wp-cli is already installed via ./utils/dev-build
 where=$(which wp 2>/dev/null)
 if [ $? -eq 0 ]; then
-	if [ "$COMPOSER_DIR/bin/wp" != "$where" ]; then
+	if [ "$INSTALL_DIR/bin/wp" != "$where" ]; then
 		echo "warning: the \`wp\` command is already available elsewhere: $where" 1>&2
 		read -p "this installation will not overwrite it. continue? [y/n] " -n 1 -r
 		echo
@@ -52,8 +52,8 @@ else
 	}
 fi
 
-mkdir -p $COMPOSER_DIR
-cd $COMPOSER_DIR
+mkdir -p $INSTALL_DIR
+cd $INSTALL_DIR
 
 # install Composer
 if [ ! -x composer.phar ]; then
@@ -97,7 +97,7 @@ WP-CLI files have been succesfully installed.
 
 To test, run:
 
-	~/.composer/bin/wp --info
+	$INSTALL_DIR/bin/wp --info
 
 EOB
 

From 7786a6995529df45409c0f96bd1fe95ee56b41ac Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 17 May 2013 14:20:13 +0300
Subject: [PATCH 126/194] add link to Alternative Install Methods

---
 index.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/index.md b/index.md
index 8b156a10..90735196 100644
--- a/index.md
+++ b/index.md
@@ -53,6 +53,8 @@ cd ~/.composer
 php composer.phar update
 ```
 
+Also see [Alternative Install Methods](https://github.com/wp-cli/wp-cli/wiki/Alternative-Install-Methods).
+
 Using
 =====
 

From 56f3ce12f75ae6ed4f8fca3ed77f64a6245ac8b8 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 18 May 2013 14:36:34 +0300
Subject: [PATCH 127/194] installer: add VERSION variable

---
 installer.sh | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/installer.sh b/installer.sh
index 9d0435a3..17ca31ee 100755
--- a/installer.sh
+++ b/installer.sh
@@ -25,6 +25,10 @@ if [ -z $INSTALL_DIR ]; then
 	INSTALL_DIR=$HOME/.composer
 fi
 
+if [ -z $VERSION ]; then
+	VERSION='dev-master'
+fi
+
 # Abort install if wp-cli is already installed via ./utils/dev-build
 where=$(which wp 2>/dev/null)
 if [ $? -eq 0 ]; then
@@ -81,7 +85,7 @@ command -v bin/wp > /dev/null || {
 	echo
 	echo "Installing the main WP-CLI package..."
 	echo "-------------------------------------"
-	$COMPOSER require wp-cli/wp-cli=dev-master
+	$COMPOSER require wp-cli/wp-cli="$VERSION"
 }
 
 command -v bin/boris > /dev/null || {

From db1ec377edf6d6ea4adb7c83fa1cf007625e9e56 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Mon, 20 May 2013 01:01:14 +0300
Subject: [PATCH 128/194] set paginate_path config var

fixes #14
---
 _config.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_config.yml b/_config.yml
index cf171e3e..8186ed0b 100644
--- a/_config.yml
+++ b/_config.yml
@@ -5,5 +5,6 @@ markdown: redcarpet
 url: http://wp-cli.org
 permalink: /blog/:title.html
 paginate: 10
+paginate_path: /blog/page:num
 exclude:
   - Phakefile.php

From 03d96e33c286c7628ac63124c802d0709ed93580 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 1 Jun 2013 01:53:14 +0300
Subject: [PATCH 129/194] installer: remove confirmation when finding an
 existing install

closes #15
---
 installer.sh | 14 --------------
 1 file changed, 14 deletions(-)

diff --git a/installer.sh b/installer.sh
index 17ca31ee..432535c8 100755
--- a/installer.sh
+++ b/installer.sh
@@ -29,20 +29,6 @@ if [ -z $VERSION ]; then
 	VERSION='dev-master'
 fi
 
-# Abort install if wp-cli is already installed via ./utils/dev-build
-where=$(which wp 2>/dev/null)
-if [ $? -eq 0 ]; then
-	if [ "$INSTALL_DIR/bin/wp" != "$where" ]; then
-		echo "warning: the \`wp\` command is already available elsewhere: $where" 1>&2
-		read -p "this installation will not overwrite it. continue? [y/n] " -n 1 -r
-		echo
-		if [[ ! $REPLY =~ ^[Yy]$ ]]
-		then
-			exit 1
-		fi
-	fi
-fi
-
 # Find a PHP binary
 if [ -z $WP_CLI_PHP ]; then
 	WP_CLI_PHP=`find_php`

From af5556845759d0ff844bf494df3ac119cd229450 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 5 Jun 2013 04:11:15 +0300
Subject: [PATCH 130/194] installer: use composer --prefer-source

1. it's generally more stable (less errors from github or PHP)
2. faster upgrades, since git only downloads a compact diff
---
 installer.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/installer.sh b/installer.sh
index 432535c8..bdf66d0e 100755
--- a/installer.sh
+++ b/installer.sh
@@ -65,7 +65,7 @@ if [ ! -f composer.json ]; then
 EOB
 fi
 
-COMPOSER="$WP_CLI_PHP composer.phar" 
+COMPOSER="$WP_CLI_PHP composer.phar --prefer-source" 
 
 command -v bin/wp > /dev/null || {
 	echo

From d2148b1ebee0cecbc7def7c099398935d8ebd938 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 5 Jun 2013 19:17:14 +0300
Subject: [PATCH 131/194] installer: quote variable tested by -z

fixes wp-cli/wp-cli#490
---
 installer.sh | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/installer.sh b/installer.sh
index bdf66d0e..52f1c952 100755
--- a/installer.sh
+++ b/installer.sh
@@ -21,16 +21,16 @@ EOB
 	which php || which php-cli || return 1
 }
 
-if [ -z $INSTALL_DIR ]; then
+if [ -z "$INSTALL_DIR" ]; then
 	INSTALL_DIR=$HOME/.composer
 fi
 
-if [ -z $VERSION ]; then
+if [ -z "$VERSION" ]; then
 	VERSION='dev-master'
 fi
 
 # Find a PHP binary
-if [ -z $WP_CLI_PHP ]; then
+if [ -z "$WP_CLI_PHP" ]; then
 	WP_CLI_PHP=`find_php`
 	if [ $? -gt 0 ]; then
 		read -p "path to PHP binary: " WP_CLI_PHP

From 0fabb75efe9e1e9f9539bd565d994efbaaa3ba48 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 7 Jun 2013 19:40:40 +0300
Subject: [PATCH 132/194] remove mention of 'home' command

---
 _includes/cmd-list.html | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/_includes/cmd-list.html b/_includes/cmd-list.html
index ecd4f497..3e4a83f8 100644
--- a/_includes/cmd-list.html
+++ b/_includes/cmd-list.html
@@ -38,10 +38,6 @@
 		help
 		Get help on a certain topic.
 	
-	
-		home
-		Open the wp-cli homepage in your browser.
-	
 	
 		media
 		Control the media library and its attachments.

From 23ce14ca718f073829372f4ee9fc5679469769a8 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 7 Jun 2013 19:41:37 +0300
Subject: [PATCH 133/194] readme: update jekyll command

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9ac5037f..d59cfd5b 100644
--- a/README.md
+++ b/README.md
@@ -13,4 +13,4 @@ vendor/bin/phake path=/path/to/wp/install
 ### Preview locally
 
 1. [Install Jekyll](https://github.com/mojombo/jekyll/wiki/install).
-2. Run `jekyll --serve --auto`
+2. Run `jekyll serve --watch`

From 4d30938c6ba0f5c1e95fc0b2bb1c6aa0f1b84e75 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Fri, 7 Jun 2013 19:42:18 +0300
Subject: [PATCH 134/194] exclude readme from built site

---
 _config.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_config.yml b/_config.yml
index 8186ed0b..63e78d97 100644
--- a/_config.yml
+++ b/_config.yml
@@ -8,3 +8,4 @@ paginate: 10
 paginate_path: /blog/page:num
 exclude:
   - Phakefile.php
+  - README.md

From aaee8738b31b310a4528c60e2162852486a8426a Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 9 Jun 2013 01:19:22 +0300
Subject: [PATCH 135/194] fix some typografy issues

---
 assets/css/stylesheet.css | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/assets/css/stylesheet.css b/assets/css/stylesheet.css
index 5c663190..b93dd6ec 100644
--- a/assets/css/stylesheet.css
+++ b/assets/css/stylesheet.css
@@ -87,8 +87,7 @@ footer {
 	margin: 0;
 }
 
-/* Main Content
-*/
+/* Main Content */
 
 #main_content {
 	width: 100%;
@@ -119,6 +118,8 @@ h1, h2, h3, h4, h5, h6 {
 
 #main_content h3 {
 	font-size: 18px;
+	margin-top: 20px;
+	margin-bottom: -5px;
 }
 
 #main_content h4 {
@@ -163,6 +164,11 @@ blockquote {
 	border-left: 1px dotted #666;
 }
 
+code {
+	font-family: monospace;
+	font-size: 17px;
+}
+
 pre {
 	background: rgba(0, 0, 0, 0.9);
 	border: 1px solid rgba(255, 255, 255, 0.15);

From f45c5fe03a82dd9fcfe1520bf0ad501250a8f944 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 9 Jun 2013 02:14:08 +0300
Subject: [PATCH 136/194] add background color to  tags

---
 assets/css/stylesheet.css | 1 +
 1 file changed, 1 insertion(+)

diff --git a/assets/css/stylesheet.css b/assets/css/stylesheet.css
index b93dd6ec..34527e12 100644
--- a/assets/css/stylesheet.css
+++ b/assets/css/stylesheet.css
@@ -165,6 +165,7 @@ blockquote {
 }
 
 code {
+	background-color: #333;
 	font-family: monospace;
 	font-size: 17px;
 }

From 61ede87ebe081332131d4f576733f707828b9c04 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 9 Jun 2013 02:16:24 +0300
Subject: [PATCH 137/194] don't change background color of  tags inside
 
 tags

---
 assets/css/stylesheet.css | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/assets/css/stylesheet.css b/assets/css/stylesheet.css
index 34527e12..4824dfcd 100644
--- a/assets/css/stylesheet.css
+++ b/assets/css/stylesheet.css
@@ -184,6 +184,10 @@ pre {
 	overflow-y: hidden;
 }
 
+pre code {
+	background-color: inherit;
+}
+
 table {
 	width: 100%;
 	margin: 0 0 20px 0;

From 063554fdb2b90fed1187cc18844150bb78d0b27c Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 9 Jun 2013 02:34:27 +0300
Subject: [PATCH 138/194] release version 0.10

---
 _posts/2013-06-08-version-0.10.md | 49 +++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 _posts/2013-06-08-version-0.10.md

diff --git a/_posts/2013-06-08-version-0.10.md b/_posts/2013-06-08-version-0.10.md
new file mode 100644
index 00000000..23e88ed6
--- /dev/null
+++ b/_posts/2013-06-08-version-0.10.md
@@ -0,0 +1,49 @@
+---
+layout: post
+author: scribu
+title: Version 0.10 is out!
+---
+In the last two and a half months, we've added a ton of new features, fixed many bugs and improved our functional test suite.
+
+### New installer
+
+You can still install WP-CLI by cloning the git repo, but the preferred method is to use the installer, as described on the [front page](/).
+
+The main reason for using the installer is to be able to leverage the optional [Boris](https://github.com/d11wtq/boris/) package, for an enhanced [wp shell](/blog/wp-shell.html) experience.
+
+### Changelog
+
+Commands:
+
+* added `wp scaffold child-theme` subcommand
+* added `wp media import` subcommand
+* added `wp blog empty` subcommand
+* added `wp post get` subcommand
+* added `wp plugin list` and `wp theme list` subcommands
+* added `--extra-php` flag to `wp core config` subcommand
+* added `--label` option to `wp scaffold post-type` and `wp scaffold taxonomy`
+* added `--verbose` flag to `wp export` command
+* added `--fields` option to all `list` subcommands
+* removed `wp home` command
+* `wp search-replace`: added `--skip_columns` option; added `--network` flag; fixed a lot of bugs
+* `wp theme install`: fixed `--version` parameter being ignored
+* `wp core init-tests`: create the test database if necessary
+* `wp db`: ignore `~/.my.cnf` file when running subcommands
+* `wp db query`: read from STDIN if no parameter is passed
+
+Internals:
+
+* made it possible to call `wp` from subdirectories
+* set `WP_ADMIN` to true
+* improved Cygwin compatibility
+* replaced `--man` flag with `--help --gen`
+* converted `--json` to `--format=json` everywhere
+* show PHP errors only on STDERR
+
+You can also browse the full list of [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=9&state=closed) on Github.
+
+Contributors to this release: [cyberhobo](http://github.com/cyberhobo), [daithi-coombes](http://github.com/daithi-coombes), [danielbachhuber](http://github.com/danielbachhuber), [future500](http://github.com/future500), [glebis](http://github.com/glebis), [goldenapples](http://github.com/goldenapples), [j3lamp](http://github.com/j3lamp), [jmslbam](http://github.com/jmslbam), [mwilliamson](http://github.com/mwilliamson), [om4james](http://github.com/om4james), [scribu](http://github.com/scribu), [tlovett1](http://github.com/tlovett1), [tolgap](http://github.com/tolgap), [twisty](http://github.com/twisty), [westonruter](http://github.com/westonruter).
+
+### What's next?
+
+I foresee a comeback of community commands, but in a better form.

From e8fb907ea137a3e95b2d6bc9e490af892207483d Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 9 Jun 2013 15:01:14 +0300
Subject: [PATCH 139/194] installer: install only stable versions

see wp-cli/wp-cli#450
---
 installer.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/installer.sh b/installer.sh
index 52f1c952..be7c8c76 100755
--- a/installer.sh
+++ b/installer.sh
@@ -26,7 +26,7 @@ if [ -z "$INSTALL_DIR" ]; then
 fi
 
 if [ -z "$VERSION" ]; then
-	VERSION='dev-master'
+	VERSION='@stable'
 fi
 
 # Find a PHP binary

From 6f767fe3c7e17402480f830c4b482b27ea629831 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 12 Jun 2013 17:12:11 +0300
Subject: [PATCH 140/194] move export instructions to installer

see wp-cli/wp-cli#516
---
 index.md     | 6 ------
 installer.sh | 8 ++++++--
 2 files changed, 6 insertions(+), 8 deletions(-)

diff --git a/index.md b/index.md
index 90735196..3a46a65a 100644
--- a/index.md
+++ b/index.md
@@ -22,12 +22,6 @@ curl http://wp-cli.org/installer.sh | bash
 
 This will allow you to run `~/.composer/bin/wp`.
 
-If you get a `using non-default PHP CLI:` message, you should save that path in your `.bash_profile` file:
-
-```
-export WP_CLI_PHP=/path/found/during/install
-```
-
 If you want to be able to type just `wp`, add the following lines to your `.bash_profile` file:
 
 ```
diff --git a/installer.sh b/installer.sh
index be7c8c76..52ac6181 100755
--- a/installer.sh
+++ b/installer.sh
@@ -88,9 +88,13 @@ WP-CLI files have been succesfully installed.
 To test, run:
 
 	$INSTALL_DIR/bin/wp --info
-
 EOB
 
 if [ "$WP_CLI_PHP" != "$(which php)" ]; then
-	echo "using non-default PHP binary: $WP_CLI_PHP"
+	cat <
Date: Wed, 12 Jun 2013 17:24:09 +0300
Subject: [PATCH 141/194] installer: stop if Composer install fails

---
 installer.sh | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/installer.sh b/installer.sh
index 52ac6181..4182446c 100755
--- a/installer.sh
+++ b/installer.sh
@@ -48,6 +48,9 @@ cd $INSTALL_DIR
 # install Composer
 if [ ! -x composer.phar ]; then
 	curl -sS https://getcomposer.org/installer | $WP_CLI_PHP
+	if [ $? -gt 0 ]; then
+		exit 1
+	fi
 fi
 
 # set up global composer.json file

From caec477480e0500895d305ae1d6b7d2f834adc3a Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 13 Jun 2013 16:12:47 +0300
Subject: [PATCH 142/194] make Boris install less verbose

see wp-cli/wp-cli#516
---
 installer.sh | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/installer.sh b/installer.sh
index 4182446c..0529153f 100755
--- a/installer.sh
+++ b/installer.sh
@@ -79,9 +79,13 @@ command -v bin/wp > /dev/null || {
 
 command -v bin/boris > /dev/null || {
 	echo
-	echo "Installing the Boris package..."
-	echo "-------------------------------"
-	$COMPOSER --no-ansi require d11wtq/boris=dev-master || true
+	printf "Trying to install the optional Boris package... "
+	$COMPOSER --quiet require d11wtq/boris=dev-master 
+	if [ $? -gt 0 ]; then
+		echo "failed."
+	else
+		echo "done."
+	fi
 }
 
 cat <
Date: Sat, 15 Jun 2013 11:51:53 +0300
Subject: [PATCH 143/194] add post for version 0.10.1

---
 _posts/2013-06-15-version-0.10.1.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 _posts/2013-06-15-version-0.10.1.md

diff --git a/_posts/2013-06-15-version-0.10.1.md b/_posts/2013-06-15-version-0.10.1.md
new file mode 100644
index 00000000..121168f2
--- /dev/null
+++ b/_posts/2013-06-15-version-0.10.1.md
@@ -0,0 +1,20 @@
+---
+layout: post
+author: scribu
+title: Version 0.10.1 released
+---
+This is a minor, bugxfix-only release.
+
+### Changelog
+
+Commands:
+
+* improved `--version` handling for `wp plugin` and `wp theme` subcommands
+* updated man page for `wp post get`
+* improved `.travis.xml` file generated by `wp scaffold plugin-tests`
+
+Internals:
+
+* show warning if a URL redirect is attempted while using WP-CLI
+
+You can also browse the list of [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=11&state=closed) on Github.

From 9099624de18aecdd49a39ccb050a9490621dd24f Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 15 Jun 2013 11:54:52 +0300
Subject: [PATCH 144/194] ignore _drafts dir

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index c7603137..d82d65ac 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,3 +2,4 @@ _site
 
 composer.lock
 vendor
+_drafts/

From a2379aa627eb271bfd73c94ee33a82d9007411b9 Mon Sep 17 00:00:00 2001
From: Tamlyn Rhodes 
Date: Sat, 15 Jun 2013 23:57:02 +0200
Subject: [PATCH 145/194] Bug fix for home directories with spaces

My home dir on Windows has a space in it so when I run the install script (in Git Bash) WP-CLI gets dumped into a weird location.

Change not tested on *nix.
---
 installer.sh | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/installer.sh b/installer.sh
index 0529153f..856d1071 100755
--- a/installer.sh
+++ b/installer.sh
@@ -42,8 +42,8 @@ else
 	}
 fi
 
-mkdir -p $INSTALL_DIR
-cd $INSTALL_DIR
+mkdir -p "$INSTALL_DIR"
+cd "$INSTALL_DIR"
 
 # install Composer
 if [ ! -x composer.phar ]; then

From 5a8f3c8a34fac3a2dd474e4f8103c799c4c5196a Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sun, 16 Jun 2013 17:12:31 +0300
Subject: [PATCH 146/194] installer: download stable versions of Boris

---
 installer.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/installer.sh b/installer.sh
index 856d1071..1f201d66 100755
--- a/installer.sh
+++ b/installer.sh
@@ -80,7 +80,7 @@ command -v bin/wp > /dev/null || {
 command -v bin/boris > /dev/null || {
 	echo
 	printf "Trying to install the optional Boris package... "
-	$COMPOSER --quiet require d11wtq/boris=dev-master 
+	$COMPOSER --quiet require 'd11wtq/boris=@stable'
 	if [ $? -gt 0 ]; then
 		echo "failed."
 	else

From 84d3a4dad5f90cbbc77be644549ef5f74df48967 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 19 Jun 2013 17:33:30 +0300
Subject: [PATCH 147/194] make it clearer that bash completions don't work in
 ZSH

see wp-cli/wp-cli#518
---
 index.md | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/index.md b/index.md
index 3a46a65a..e4ad4d5d 100644
--- a/index.md
+++ b/index.md
@@ -27,8 +27,12 @@ If you want to be able to type just `wp`, add the following lines to your `.bash
 ```
 # Composer scripts
 PATH=$HOME/.composer/bin:$PATH
+```
+
+If you're using Bash (patches welcome for [ZSH support](https://github.com/wp-cli/wp-cli/issues/518)), you can enable autocomplete for WP-CLI commands and subcommands:
 
-# WP-CLI completions
+```
+# WP-CLI Bash completions
 source $HOME/.composer/vendor/wp-cli/wp-cli/utils/wp-completion.bash
 ```
 

From 6c919d6f08823db6bf39a5da7dab4c5559fe7d27 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 19 Jun 2013 17:48:36 +0300
Subject: [PATCH 148/194] add instructions for Zsh users

closes wp-cli/wp-cli#518
---
 index.md | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/index.md b/index.md
index e4ad4d5d..0fd17554 100644
--- a/index.md
+++ b/index.md
@@ -29,19 +29,37 @@ If you want to be able to type just `wp`, add the following lines to your `.bash
 PATH=$HOME/.composer/bin:$PATH
 ```
 
-If you're using Bash (patches welcome for [ZSH support](https://github.com/wp-cli/wp-cli/issues/518)), you can enable autocomplete for WP-CLI commands and subcommands:
+### Autocomplete
+WP-CLI comes with an autocomplete script for commands and subcommands.
+
+If you're using Bash, add the following lines to `~/.bash_profile`:
 
 ```
 # WP-CLI Bash completions
 source $HOME/.composer/vendor/wp-cli/wp-cli/utils/wp-completion.bash
 ```
 
-Finally, reload the file:
+And re-load the file:
 
 ```
 source ~/.bash_profile
 ```
 
+If you're using Zsh, add the following lines to `~/.zprofile`:
+
+```
+# WP-CLI Bash completions
+autoload bashcompinit
+bashcompinit
+source $HOME/.composer/vendor/wp-cli/wp-cli/utils/wp-completion.bash
+```
+
+And re-load the file:
+
+```
+source ~/.zprofile
+```
+
 ### Updating
 
 If you installed WP-CLI using the method above, you can also easily update it:

From 51ef69950127a5cbae05b0412b8218f5007162b9 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Wed, 19 Jun 2013 20:34:19 +0300
Subject: [PATCH 149/194] installer: fix *AMP discovery

1. the AMP_PATHS variable wasn't properly initialized, hence `read`
2. the wildcard expansion yielded the php5.2 directory first, so we just
skip it
---
 installer.sh | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/installer.sh b/installer.sh
index 1f201d66..ef44b2a4 100755
--- a/installer.sh
+++ b/installer.sh
@@ -1,17 +1,19 @@
 #!/usr/bin/env bash
 
 find_php() {
-	AMP_PATHS=<
Date: Thu, 20 Jun 2013 00:36:17 +0300
Subject: [PATCH 150/194] add 'id' attributes to headers, for linking

---
 index.md | 23 +++++++++--------------
 1 file changed, 9 insertions(+), 14 deletions(-)

diff --git a/index.md b/index.md
index 0fd17554..23c5b10b 100644
--- a/index.md
+++ b/index.md
@@ -4,15 +4,13 @@ title: Command line interface for WordPress
 ---
 **WP-CLI** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, create posts and much more.
 
-Minimum Requirements
-==========
+
Minimum Requirements

 
 You'll need **PHP 5.3.2** or later.
 
 All WP-CLI commands are guaranteed to work with **WordPress 3.4** or later. Some commands, like `wp core update`, might work with older versions as well.
 
-Installing
-==========
+
Installing

 
 Just execute the following command:
 
@@ -29,7 +27,8 @@ If you want to be able to type just `wp`, add the following lines to your `.bash
 PATH=$HOME/.composer/bin:$PATH
 ```
 
-### Autocomplete
+
Autocomplete

+
 WP-CLI comes with an autocomplete script for commands and subcommands.
 
 If you're using Bash, add the following lines to `~/.bash_profile`:
@@ -60,7 +59,7 @@ And re-load the file:
 source ~/.zprofile
 ```
 
-### Updating
+
Updating

 
 If you installed WP-CLI using the method above, you can also easily update it:
 
@@ -71,8 +70,7 @@ php composer.phar update
 
 Also see [Alternative Install Methods](https://github.com/wp-cli/wp-cli/wiki/Alternative-Install-Methods).
 
-Using
-=====
+
Using

 
 Go into a WordPress root folder:
 
@@ -112,8 +110,7 @@ Installing the plugin ...
 Plugin installed successfully.
 ```
 
-Multisite
----------
+
Multisite

 
 On a multisite installation, you need to pass a `--url` parameter, so that wp-cli knows which site it's supposed to be operating on:
 
@@ -139,16 +136,14 @@ Then, you can call `wp` without the `--url` parameter again:
 wp theme status
 ```
 
-Adding commands
-===============
+
Adding commands

 
 Adding commands to wp-cli is very easy. You can even add them from within your own plugin.
 You can find more information about adding commands in the [Commands Cookbook](https://github.com/wp-cli/wp-cli/wiki/Commands-Cookbook) on our Wiki.
 
 **Please share the commands you make, issue a pull request to get them included in wp-cli by default.**
 
-Contributors
-------------
+
Contributors

 
 - [Contributor list](https://github.com/wp-cli/wp-cli/contributors)
 - [Contributor guide](https://github.com/wp-cli/wp-cli/blob/master/CONTRIBUTING.md)

From 8067ffec352545fa2a57e53f4e5f5b3030ac165f Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 20 Jun 2013 00:38:47 +0300
Subject: [PATCH 151/194] emphasize shell types

---
 index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/index.md b/index.md
index 23c5b10b..b3f33e21 100644
--- a/index.md
+++ b/index.md
@@ -31,7 +31,7 @@ PATH=$HOME/.composer/bin:$PATH
 
 WP-CLI comes with an autocomplete script for commands and subcommands.
 
-If you're using Bash, add the following lines to `~/.bash_profile`:
+If you're using **Bash**, add the following lines to `~/.bash_profile`:
 
 ```
 # WP-CLI Bash completions
@@ -44,7 +44,7 @@ And re-load the file:
 source ~/.bash_profile
 ```
 
-If you're using Zsh, add the following lines to `~/.zprofile`:
+If you're using **Zsh**, add the following lines to `~/.zprofile`:
 
 ```
 # WP-CLI Bash completions

From e650aceddbe00deb3ae31493b7912f89ebeb8176 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 20 Jun 2013 00:42:20 +0300
Subject: [PATCH 152/194] better describe autocompletion capabilities

---
 index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.md b/index.md
index b3f33e21..da544aa8 100644
--- a/index.md
+++ b/index.md
@@ -29,7 +29,7 @@ PATH=$HOME/.composer/bin:$PATH
 
 
Autocomplete

 
-WP-CLI comes with an autocomplete script for commands and subcommands.
+WP-CLI comes with an autocomplete script for command, subcommand and flag names.
 
 If you're using **Bash**, add the following lines to `~/.bash_profile`:
 

From ef0520db2765215f010615e9212404b162919bfe Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 20 Jun 2013 00:44:33 +0300
Subject: [PATCH 153/194] s/autocomplete/tab completion/

---
 index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/index.md b/index.md
index da544aa8..450a87d7 100644
--- a/index.md
+++ b/index.md
@@ -27,9 +27,9 @@ If you want to be able to type just `wp`, add the following lines to your `.bash
 PATH=$HOME/.composer/bin:$PATH
 ```
 
-
Autocomplete

+
Tab completions

 
-WP-CLI comes with an autocomplete script for command, subcommand and flag names.
+WP-CLI comes with a tab completion script for command, subcommand and flag names.
 
 If you're using **Bash**, add the following lines to `~/.bash_profile`:
 

From 4306cfc9e5846eab1eefc9d6f7df17135c427243 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Thu, 20 Jun 2013 00:46:54 +0300
Subject: [PATCH 154/194] s/#autocomplete/#complete/

---
 index.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/index.md b/index.md
index 450a87d7..31ad27a3 100644
--- a/index.md
+++ b/index.md
@@ -27,7 +27,8 @@ If you want to be able to type just `wp`, add the following lines to your `.bash
 PATH=$HOME/.composer/bin:$PATH
 ```
 
-
Tab completions

+
+
Tab completions

 
 WP-CLI comes with a tab completion script for command, subcommand and flag names.
 

From b277088cb058f3049e4afefefa0834201beab79b Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 22 Jun 2013 19:06:37 +0300
Subject: [PATCH 155/194] add UNIX-like environment as a requirement

---
 index.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/index.md b/index.md
index 31ad27a3..f3481c64 100644
--- a/index.md
+++ b/index.md
@@ -4,11 +4,11 @@ title: Command line interface for WordPress
 ---
 **WP-CLI** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, create posts and much more.
 
-
Minimum Requirements

+
Requirements

 
-You'll need **PHP 5.3.2** or later.
-
-All WP-CLI commands are guaranteed to work with **WordPress 3.4** or later. Some commands, like `wp core update`, might work with older versions as well.
+* UNIX-like environment (OS X, Linux, FreeBSD, Cygwin)
+* PHP 5.3.2 or later
+* WordPress 3.4 or later
 
 
Installing

 

From 0d3499a25c02a4313a5916feff5086549c53ec02 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 22 Jun 2013 19:11:03 +0300
Subject: [PATCH 156/194] mention that WP-CLI doesn't need a web browser

---
 index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.md b/index.md
index f3481c64..3097dbf3 100644
--- a/index.md
+++ b/index.md
@@ -2,7 +2,7 @@
 layout: default
 title: Command line interface for WordPress
 ---
-**WP-CLI** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs, create posts and much more.
+**WP-CLI** is a set of command-line tools for managing [WordPress](http://wordpress.org) installations. You can update plugins, set up multisite installs and much more, without using a web browser.
 
 
Requirements

 

From 135fd9476106e400715b0cc6e8d52e8c698977ef Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 22 Jun 2013 19:59:22 +0300
Subject: [PATCH 157/194] mention the terminal

---
 index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.md b/index.md
index 3097dbf3..ec5b1db3 100644
--- a/index.md
+++ b/index.md
@@ -12,7 +12,7 @@ title: Command line interface for WordPress
 
 
Installing

 
-Just execute the following command:
+Just execute the following command in your terminal:
 
 ```
 curl http://wp-cli.org/installer.sh | bash

From 1f8fb1df096af2ef4502e544d257f72771547222 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 22 Jun 2013 20:05:19 +0300
Subject: [PATCH 158/194] fix HTML encoding

---
 index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/index.md b/index.md
index ec5b1db3..b3b41b4b 100644
--- a/index.md
+++ b/index.md
@@ -91,7 +91,7 @@ Available commands:
     wp eval-file
     ...
 
-See 'wp help <command>' for more information on a specific command.
+See 'wp help ' for more information on a specific command.
 ```
 
 Let's try to install the Hello Dolly plugin from wordpress.org:

From 2febda6cb6cf57c26f96a17671c46d1d340dfeae Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 22 Jun 2013 20:10:30 +0300
Subject: [PATCH 159/194] branding: WP-CLI, not wp-cli

---
 Phakefile.php                    | 2 +-
 _posts/2012-09-05-version-0.6.md | 4 ++--
 index.md                         | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/Phakefile.php b/Phakefile.php
index 2fd4a55f..40dc3503 100644
--- a/Phakefile.php
+++ b/Phakefile.php
@@ -8,7 +8,7 @@ function invoke_wp_cli( $cmd, $app ) {
 	$json = ob_get_clean();
 
 	if ( $return_code ) {
-		echo "wp-cli returned error code: $return_code\n";
+		echo "WP-CLI returned error code: $return_code\n";
 		exit(1);
 	}
 
diff --git a/_posts/2012-09-05-version-0.6.md b/_posts/2012-09-05-version-0.6.md
index 616ad6ce..c81ba00a 100644
--- a/_posts/2012-09-05-version-0.6.md
+++ b/_posts/2012-09-05-version-0.6.md
@@ -32,7 +32,7 @@ An interesting but easily overlooked feature is the new `--require` global param
 		}
 	}
 
-Now, where do you put this code, so that wp-cli can reach it? You could put it in a plugin, but if you have multiple WP installations, you'd have to install that plugin on each one. You could put it inside one of the wp-cli directories, but that creates problems when you want to update. Here's what you could do instead:
+Now, where do you put this code, so that WP-CLI can reach it? You could put it in a plugin, but if you have multiple WP installations, you'd have to install that plugin on each one. You could put it inside one of the WP-CLI directories, but that creates problems when you want to update. Here's what you could do instead:
 
 	wp --require=/path/to/chores.php chores do_laundry
 
@@ -44,7 +44,7 @@ The help system has been improved. When you do `wp help core config`, an actual
 
 ![wp-cli man-page](/assets/img/wp-cli-man-page.png)
 
-Unfortunately, this doesn't work if you install wp-cli via the PEAR package, because PEAR doesn't know how to handle them. :(
+Unfortunately, this doesn't work if you install WP-CLI via the PEAR package, because PEAR doesn't know how to handle them. :(
 
 ### The Changelog
 
diff --git a/index.md b/index.md
index b3b41b4b..426dc13d 100644
--- a/index.md
+++ b/index.md
@@ -113,7 +113,7 @@ Plugin installed successfully.
 
 
Multisite

 
-On a multisite installation, you need to pass a `--url` parameter, so that wp-cli knows which site it's supposed to be operating on:
+On a multisite installation, you need to pass a `--url` parameter, so that WP-CLI knows which site it's supposed to be operating on:
 
 ```
 wp theme status --url=localhost/wp/test

From 92e449d173aef20daa5443c60afd8d71aa270061 Mon Sep 17 00:00:00 2001
From: scribu 
Date: Sat, 22 Jun 2013 20:13:23 +0300
Subject: [PATCH 160/194] add link to twitter account; rename 'Source' to
 'Github'

---
 _includes/header.html | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/_includes/header.html b/_includes/header.html
index e0ce8199..8ce2453d 100644
--- a/_includes/header.html
+++ b/_includes/header.html
@@ -24,8 +24,9 @@ 
A command line interface for WordPress

 			Commands
 			Configuration
 			Blog
-			Source
 			Wiki
+			Github
+			Twitter
From 3249e2d6cfce7e37dd5473bc243faa24e9a872b0 Mon Sep 17 00:00:00 2001 From: scribu Date: Wed, 26 Jun 2013 12:57:13 +0300 Subject: [PATCH 161/194] add post for version 0.10.2 --- _posts/2013-06-26-version-0.10.2.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 _posts/2013-06-26-version-0.10.2.md diff --git a/_posts/2013-06-26-version-0.10.2.md b/_posts/2013-06-26-version-0.10.2.md new file mode 100644 index 00000000..207b3378 --- /dev/null +++ b/_posts/2013-06-26-version-0.10.2.md @@ -0,0 +1,19 @@ +--- +layout: post +author: scribu +title: Version 0.10.2 released +--- +This is a minor release, mainly meant to fix a dependency issue. + +### Changelog + +Commands: + +* when using `--format=json`, show warning if the value is not a valid JSON string +* updated man page for `wp core install-network` and other man page fixes + +Internals: + +* fix required version for php-cli-tools package + +You can also browse the list of [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=12&state=closed) on Github. From cae2dcf49a998fe6d0b969fef5709406c4f8825f Mon Sep 17 00:00:00 2001 From: scribu Date: Thu, 27 Jun 2013 22:04:05 +0300 Subject: [PATCH 162/194] mention the list of community commands --- index.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/index.md b/index.md index 426dc13d..bcfab529 100644 --- a/index.md +++ b/index.md @@ -139,10 +139,9 @@ wp theme status

Adding commands

-Adding commands to wp-cli is very easy. You can even add them from within your own plugin. -You can find more information about adding commands in the [Commands Cookbook](https://github.com/wp-cli/wp-cli/wiki/Commands-Cookbook) on our Wiki. +Adding commands to WP-CLI is as easy as creating a PHP class. See the [Commands Cookbook](https://github.com/wp-cli/wp-cli/wiki/Commands-Cookbook) for more info. -**Please share the commands you make, issue a pull request to get them included in wp-cli by default.** +Please share the commands you make by adding them to the [List of community commands](https://github.com/wp-cli/wp-cli/wiki/List-of-community-commands).

Contributors

From 9cbf91a084b269c747a4be3e1ba36222476a0997 Mon Sep 17 00:00:00 2001 From: scribu Date: Thu, 27 Jun 2013 22:06:11 +0300 Subject: [PATCH 163/194] branding: WP-CLI --- _includes/header.html | 4 ++-- _posts/2012-11-05-new-home.md | 2 +- _posts/2012-11-10-wp-shell.md | 2 +- _posts/2013-02-19-plugin-unit-tests.md | 2 +- atom.xml | 2 +- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/_includes/header.html b/_includes/header.html index 8ce2453d..5c1c307b 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -10,14 +10,14 @@ - {{ page.title }} | wp-cli + {{ page.title }} | WP-CLI
-

wp-cli

+

WP-CLI

A command line interface for WordPress

diff --git a/_posts/2012-11-05-new-home.md b/_posts/2012-11-05-new-home.md index 2ae059d7..c617d93d 100644 --- a/_posts/2012-11-05-new-home.md +++ b/_posts/2012-11-05-new-home.md @@ -4,7 +4,7 @@ title: New Home author: scribu --- -Welcome to the new website for the wp-cli project! +Welcome to the new website for the WP-CLI project! wp-cli already has a public [code repository](https://github.com/wp-cli/wp-cli), an [issue tracker](https://github.com/wp-cli/wp-cli/issues) and a [wiki](https://github.com/wp-cli/wp-cli/wiki). The only thing that was missing was a blog for publishing release notes and other news. diff --git a/_posts/2012-11-10-wp-shell.md b/_posts/2012-11-10-wp-shell.md index db6be2af..cb478d35 100644 --- a/_posts/2012-11-10-wp-shell.md +++ b/_posts/2012-11-10-wp-shell.md @@ -4,7 +4,7 @@ title: Interactive WordPress Debugging author: scribu --- -A new command [landed](https://github.com/wp-cli/wp-cli/pull/89) in wp-cli a few days ago, called `shell`. It was inspired by an older project called [wpshell](http://code.trac.wordpress.org/browser/wpshell). +A new command [landed](https://github.com/wp-cli/wp-cli/pull/89) in WP-CLI a few days ago, called `shell`. It was inspired by an older project called [wpshell](http://code.trac.wordpress.org/browser/wpshell). When you run `wp shell`, a REPL will start, in which you can run any WordPress function. diff --git a/_posts/2013-02-19-plugin-unit-tests.md b/_posts/2013-02-19-plugin-unit-tests.md index 9d391ecd..5a3c9c4d 100644 --- a/_posts/2013-02-19-plugin-unit-tests.md +++ b/_posts/2013-02-19-plugin-unit-tests.md @@ -5,7 +5,7 @@ author: scribu --- One of the reasons so few people take the time to write [unit tests for plugins][3] they write is that it's a chore to set everything up. You need to install [PHPUnit][4], the [WordPress testing library][5], as well as the actual plugin tests configuration files. -If you're running wp-cli 0.9.0-alpha2 or later, there are a few commands that make this significantly easier: +If you're running WP-CLI 0.9.0-alpha2 or later, there are a few commands that make this significantly easier: wp core init-tests diff --git a/atom.xml b/atom.xml index c066ebf9..c29429ab 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ layout: nil - wp-cli + WP-CLI {{ site.time | date_to_xmlschema }} From b8801185448d0b7332fa5df025b9fc812ea6a932 Mon Sep 17 00:00:00 2001 From: scribu Date: Mon, 1 Jul 2013 03:16:03 +0200 Subject: [PATCH 164/194] installer: generate composer.json using `composer init` --- installer.sh | 22 +++++++--------------- 1 file changed, 7 insertions(+), 15 deletions(-) diff --git a/installer.sh b/installer.sh index ef44b2a4..b28f4f86 100755 --- a/installer.sh +++ b/installer.sh @@ -55,34 +55,26 @@ if [ ! -x composer.phar ]; then fi fi +COMPOSER="$WP_CLI_PHP composer.phar" + # set up global composer.json file if [ ! -f composer.json ]; then - cat > composer.json < /dev/null || { echo echo "Installing the main WP-CLI package..." echo "-------------------------------------" - $COMPOSER require wp-cli/wp-cli="$VERSION" + $COMPOSER require --prefer-source wp-cli/wp-cli="$VERSION" } command -v bin/boris > /dev/null || { echo printf "Trying to install the optional Boris package... " - $COMPOSER --quiet require 'd11wtq/boris=@stable' + $COMPOSER --quiet require --prefer-source 'd11wtq/boris=@stable' if [ $? -gt 0 ]; then echo "failed." else From 6b5806240ef6017d7ee50e9d7f50e76a5ad84f86 Mon Sep 17 00:00:00 2001 From: scribu Date: Sat, 6 Jul 2013 18:11:09 +0200 Subject: [PATCH 165/194] move PATH editing to installer --- index.md | 9 +-------- installer.sh | 15 ++++++++++----- 2 files changed, 11 insertions(+), 13 deletions(-) diff --git a/index.md b/index.md index bcfab529..65e5f3ce 100644 --- a/index.md +++ b/index.md @@ -18,14 +18,7 @@ Just execute the following command in your terminal: curl http://wp-cli.org/installer.sh | bash ``` -This will allow you to run `~/.composer/bin/wp`. - -If you want to be able to type just `wp`, add the following lines to your `.bash_profile` file: - -``` -# Composer scripts -PATH=$HOME/.composer/bin:$PATH -``` +Make sure to read the instructions.

Tab completions

diff --git a/installer.sh b/installer.sh index b28f4f86..c25761a5 100755 --- a/installer.sh +++ b/installer.sh @@ -49,6 +49,8 @@ cd "$INSTALL_DIR" # install Composer if [ ! -x composer.phar ]; then + echo "Installing Composer..." + echo "----------------------" curl -sS https://getcomposer.org/installer | $WP_CLI_PHP if [ $? -gt 0 ]; then exit 1 @@ -69,6 +71,8 @@ command -v bin/wp > /dev/null || { echo "Installing the main WP-CLI package..." echo "-------------------------------------" $COMPOSER require --prefer-source wp-cli/wp-cli="$VERSION" + echo + echo "WP-CLI files have been succesfully installed." } command -v bin/boris > /dev/null || { @@ -84,18 +88,19 @@ command -v bin/boris > /dev/null || { cat < Date: Sat, 6 Jul 2013 18:12:27 +0200 Subject: [PATCH 166/194] Change default install dir from ~/.composer to ~/.wp-cli We don't want to mix with other Composer packages that the user might want to install globally. --- index.md | 6 +++--- installer.sh | 2 +- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/index.md b/index.md index 65e5f3ce..f767cb63 100644 --- a/index.md +++ b/index.md @@ -29,7 +29,7 @@ If you're using **Bash**, add the following lines to `~/.bash_profile`: ``` # WP-CLI Bash completions -source $HOME/.composer/vendor/wp-cli/wp-cli/utils/wp-completion.bash +source $HOME/.wp-cli/vendor/wp-cli/wp-cli/utils/wp-completion.bash ``` And re-load the file: @@ -44,7 +44,7 @@ If you're using **Zsh**, add the following lines to `~/.zprofile`: # WP-CLI Bash completions autoload bashcompinit bashcompinit -source $HOME/.composer/vendor/wp-cli/wp-cli/utils/wp-completion.bash +source $HOME/.wp-cli/vendor/wp-cli/wp-cli/utils/wp-completion.bash ``` And re-load the file: @@ -58,7 +58,7 @@ source ~/.zprofile If you installed WP-CLI using the method above, you can also easily update it: ``` -cd ~/.composer +cd ~/.wp-cli php composer.phar update ``` diff --git a/installer.sh b/installer.sh index c25761a5..8c2b741d 100755 --- a/installer.sh +++ b/installer.sh @@ -24,7 +24,7 @@ EOB } if [ -z "$INSTALL_DIR" ]; then - INSTALL_DIR=$HOME/.composer + INSTALL_DIR=$HOME/.wp-cli fi if [ -z "$VERSION" ]; then From 5f5b02b13615f396771f327fd60d70e6d9941a31 Mon Sep 17 00:00:00 2001 From: scribu Date: Tue, 9 Jul 2013 18:23:25 +0300 Subject: [PATCH 167/194] installer: show destination dir before proceeding --- installer.sh | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/installer.sh b/installer.sh index 8c2b741d..7c8772eb 100755 --- a/installer.sh +++ b/installer.sh @@ -49,8 +49,8 @@ cd "$INSTALL_DIR" # install Composer if [ ! -x composer.phar ]; then - echo "Installing Composer..." - echo "----------------------" + echo "Installing Composer in $INSTALL_DIR" + echo "-------------------" curl -sS https://getcomposer.org/installer | $WP_CLI_PHP if [ $? -gt 0 ]; then exit 1 @@ -68,8 +68,8 @@ fi command -v bin/wp > /dev/null || { echo - echo "Installing the main WP-CLI package..." - echo "-------------------------------------" + echo "Installing WP-CLI in $INSTALL_DIR" + echo "-----------------" $COMPOSER require --prefer-source wp-cli/wp-cli="$VERSION" echo echo "WP-CLI files have been succesfully installed." From bf21305b63655e50ec047beb469d2173b9edf229 Mon Sep 17 00:00:00 2001 From: scribu Date: Wed, 10 Jul 2013 11:27:51 +0300 Subject: [PATCH 168/194] avoid repetition --- _posts/2013-02-19-plugin-unit-tests.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_posts/2013-02-19-plugin-unit-tests.md b/_posts/2013-02-19-plugin-unit-tests.md index 5a3c9c4d..2e2c8935 100644 --- a/_posts/2013-02-19-plugin-unit-tests.md +++ b/_posts/2013-02-19-plugin-unit-tests.md @@ -3,7 +3,7 @@ layout: post title: Easily Set Up Unit Tests For Your Plugin author: scribu --- -One of the reasons so few people take the time to write [unit tests for plugins][3] they write is that it's a chore to set everything up. You need to install [PHPUnit][4], the [WordPress testing library][5], as well as the actual plugin tests configuration files. +One of the reasons so few people take the time to write [unit tests for plugins][3] they author is that it's a chore to set everything up. You need to install [PHPUnit][4], the [WordPress testing library][5], as well as the actual plugin tests configuration files. If you're running WP-CLI 0.9.0-alpha2 or later, there are a few commands that make this significantly easier: From 7f2f618cc6c4fd75935b281326f9003743ece158 Mon Sep 17 00:00:00 2001 From: scribu Date: Fri, 12 Jul 2013 00:57:58 +0300 Subject: [PATCH 169/194] clarify that PHPUnit still needs to be installed manually --- _posts/2013-02-19-plugin-unit-tests.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_posts/2013-02-19-plugin-unit-tests.md b/_posts/2013-02-19-plugin-unit-tests.md index 2e2c8935..cce3ab92 100644 --- a/_posts/2013-02-19-plugin-unit-tests.md +++ b/_posts/2013-02-19-plugin-unit-tests.md @@ -3,9 +3,9 @@ layout: post title: Easily Set Up Unit Tests For Your Plugin author: scribu --- -One of the reasons so few people take the time to write [unit tests for plugins][3] they author is that it's a chore to set everything up. You need to install [PHPUnit][4], the [WordPress testing library][5], as well as the actual plugin tests configuration files. +One of the reasons so few people take the time to write [unit tests for plugins][3] they author is that it's a chore to set everything up. Besides installing [PHPUnit][4], you also have to set up the [WordPress testing library][5], as well as the actual plugin tests configuration files. -If you're running WP-CLI 0.9.0-alpha2 or later, there are a few commands that make this significantly easier: +If you're running WP-CLI 0.9.0-alpha2 or later, there are commands that make the last two steps significantly easier: wp core init-tests From 5a76767a500746d972639964203ea2149cd9a900 Mon Sep 17 00:00:00 2001 From: scribu Date: Sat, 20 Jul 2013 23:09:08 +0300 Subject: [PATCH 170/194] add version parameter to Phakefile tasks --- Phakefile.php | 4 +++- README.md | 2 +- _includes/cmd-list.html | 50 ++++++++++++++++++++--------------------- 3 files changed, 29 insertions(+), 27 deletions(-) diff --git a/Phakefile.php b/Phakefile.php index 40dc3503..d6119425 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -39,9 +39,11 @@ function generate_synopsis( $command, $path = '' ) { $out = ''; foreach ( $wp['subcommands'] as $command ) { + $url = "https://github.com/wp-cli/wp-cli/blob/{$app['version']}/php/commands/{$command['name']}.php"; + $out .= << - {$command['name']} + {$command['name']} {$command['description']} diff --git a/README.md b/README.md index d59cfd5b..a8e902dc 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ 3. Build: ```bash -vendor/bin/phake path=/path/to/wp/install +vendor/bin/phake path=/path/to/wp/install version=v0.10.2 ``` ### Preview locally diff --git a/_includes/cmd-list.html b/_includes/cmd-list.html index 3e4a83f8..44daa44b 100644 --- a/_includes/cmd-list.html +++ b/_includes/cmd-list.html @@ -1,100 +1,100 @@ - blog + blog Manage blogs in a multisite install. - cache + cache Manage the object cache. - cap + cap Manage user capabilities. - comment + comment Manage comments. - core + core Download, install, update and otherwise manage WordPress proper. - db + db Perform basic database operations. - eval + eval Execute arbitrary PHP code after loading WordPress. - eval-file + eval-file Load and execute a PHP file after loading WordPress. - export + export Export content to a WXR file. - help + help Get help on a certain topic. - media + media Control the media library and its attachments. - option + option Manage WordPress options. - plugin + plugin Manage plugins. - post + post Manage posts. - post-meta + post-meta Manage post custom fields. - rewrite + rewrite Manage rewrite rules. - role + role Manage user roles. - scaffold + scaffold Generate code for post types, taxonomies, etc. - search-replace + search-replace Search/replace strings in the database. - shell + shell Interactive PHP console. - term + term Manage terms. - theme + theme Manage themes. - transient + transient Manage WordPress transients. - user + user Manage users. - user-meta + user-meta Manage user custom fields. From ce61eedc49c41e83de4626a9a5654f78cb2fe2ac Mon Sep 17 00:00:00 2001 From: scribu Date: Sat, 20 Jul 2013 23:57:53 +0300 Subject: [PATCH 171/194] use Mustache templates --- Phakefile.php | 38 ++++++++++++------------------------ _includes/param-list.html | 2 +- _templates/cmd-list.mustache | 6 ++++++ _templates/config.mustache | 6 ++++++ composer.json | 3 ++- 5 files changed, 27 insertions(+), 28 deletions(-) create mode 100644 _templates/cmd-list.mustache create mode 100644 _templates/config.mustache diff --git a/Phakefile.php b/Phakefile.php index d6119425..51885ad9 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -1,4 +1,5 @@ render( $template, $binding ); +} + desc( 'Generate a list of commands with all accepted arguments on STDOUT.' ); task( 'syn-list', function( $app ) { function generate_synopsis( $command, $path = '' ) { @@ -35,22 +42,9 @@ function generate_synopsis( $command, $path = '' ) { desc( 'Update the /commands/ page.' ); task( 'cmd-list', function( $app ) { $wp = invoke_wp_cli( 'wp --cmd-dump', $app ); + $wp['version'] = $app['version']; - $out = ''; - - foreach ( $wp['subcommands'] as $command ) { - $url = "https://github.com/wp-cli/wp-cli/blob/{$app['version']}/php/commands/{$command['name']}.php"; - - $out .= << - {$command['name']} - {$command['description']} - - -EOB; - } - - file_put_contents( '_includes/cmd-list.html', $out ); + file_put_contents( '_includes/cmd-list.html', render( 'cmd-list.mustache', $wp ) ); }); desc( 'Update the /config/ page.' ); @@ -64,7 +58,7 @@ function generate_synopsis( $command, $path = '' ) { continue; if ( false !== $details['file'] ) { - $config = "$key: " . htmlspecialchars( $details['file'] ); + $config = "$key: " . $details['file']; } else { $config = ''; } @@ -72,7 +66,7 @@ function generate_synopsis( $command, $path = '' ) { if ( false !== $details['runtime'] ) { $flag = ( true === $details['runtime'] ) ? "--[no-]$key" - : "--$key" . htmlspecialchars( $details['runtime'] ); + : "--$key" . $details['runtime']; } else { $flag = ''; } @@ -81,15 +75,7 @@ function generate_synopsis( $command, $path = '' ) { $description = $details['desc']; - $out .= << - $config - $flag - $default - $description - - -EOB; + $out .= render( 'config.mustache', compact( 'config', 'flag', 'default', 'description' ) ); } file_put_contents( '_includes/param-list.html', $out ); diff --git a/_includes/param-list.html b/_includes/param-list.html index ba26493a..a908825c 100644 --- a/_includes/param-list.html +++ b/_includes/param-list.html @@ -37,7 +37,7 @@ color: <bool> --[no-]color - "auto" + "auto" Whether to colorize the output diff --git a/_templates/cmd-list.mustache b/_templates/cmd-list.mustache new file mode 100644 index 00000000..715cf0ae --- /dev/null +++ b/_templates/cmd-list.mustache @@ -0,0 +1,6 @@ +{{#subcommands}} + + {{name}} + {{description}} + +{{/subcommands}} diff --git a/_templates/config.mustache b/_templates/config.mustache new file mode 100644 index 00000000..f5d84f89 --- /dev/null +++ b/_templates/config.mustache @@ -0,0 +1,6 @@ + + {{config}} + {{flag}} + {{default}} + {{description}} + diff --git a/composer.json b/composer.json index b37ae195..831c5ce8 100644 --- a/composer.json +++ b/composer.json @@ -1,5 +1,6 @@ { "require-dev": { - "jaz303/phake": "dev-master" + "jaz303/phake": "dev-master", + "mustache/mustache": "~2.4" } } From e8a420bac3ad95069d8c9f7fc31f084cdb5fb251 Mon Sep 17 00:00:00 2001 From: scribu Date: Sun, 21 Jul 2013 01:50:21 +0300 Subject: [PATCH 172/194] generate help page for each command --- Phakefile.php | 36 ++++++++++++- README.md | 2 +- _includes/cmd-list.html | 50 ++++++++--------- _templates/cmd-list.mustache | 2 +- _templates/subcmd-list.mustache | 29 ++++++++++ assets/css/stylesheet.css | 10 ++-- commands/blog/create/index.md | 28 ++++++++++ commands/blog/delete/index.md | 22 ++++++++ commands/blog/empty/index.md | 11 ++++ commands/blog/index.md | 33 ++++++++++++ commands/cache/add/index.md | 9 ++++ commands/cache/decr/index.md | 9 ++++ commands/cache/delete/index.md | 9 ++++ commands/cache/flush/index.md | 9 ++++ commands/cache/get/index.md | 9 ++++ commands/cache/incr/index.md | 9 ++++ commands/cache/index.md | 62 +++++++++++++++++++++ commands/cache/replace/index.md | 9 ++++ commands/cache/set/index.md | 9 ++++ commands/cache/type/index.md | 9 ++++ commands/cap/add/index.md | 9 ++++ commands/cap/index.md | 43 +++++++++++++++ commands/cap/list/index.md | 9 ++++ commands/cap/remove/index.md | 9 ++++ commands/comment/approve/index.md | 17 ++++++ commands/comment/count/index.md | 18 +++++++ commands/comment/create/index.md | 21 ++++++++ commands/comment/delete/index.md | 20 +++++++ commands/comment/index.md | 65 ++++++++++++++++++++++ commands/comment/last/index.md | 20 +++++++ commands/comment/spam/index.md | 17 ++++++ commands/comment/status/index.md | 17 ++++++ commands/comment/trash/index.md | 17 ++++++ commands/comment/unapprove/index.md | 17 ++++++ commands/comment/unspam/index.md | 17 ++++++ commands/comment/untrash/index.md | 17 ++++++ commands/core/config/index.md | 39 ++++++++++++++ commands/core/download/index.md | 24 +++++++++ commands/core/index.md | 57 ++++++++++++++++++++ commands/core/init-tests/index.md | 27 ++++++++++ commands/core/install-network/index.md | 20 +++++++ commands/core/install/index.md | 25 +++++++++ commands/core/is-installed/index.md | 14 +++++ commands/core/update-db/index.md | 9 ++++ commands/core/update/index.md | 27 ++++++++++ commands/core/version/index.md | 13 +++++ commands/db/cli/index.md | 9 ++++ commands/db/create/index.md | 9 ++++ commands/db/drop/index.md | 9 ++++ commands/db/export/index.md | 9 ++++ commands/db/import/index.md | 9 ++++ commands/db/index.md | 72 +++++++++++++++++++++++++ commands/db/optimize/index.md | 9 ++++ commands/db/query/index.md | 9 ++++ commands/db/repair/index.md | 9 ++++ commands/db/reset/index.md | 9 ++++ commands/eval-file/index.md | 12 +++++ commands/eval/index.md | 12 +++++ commands/export/index.md | 52 ++++++++++++++++++ commands/help/index.md | 19 +++++++ commands/media/import/index.md | 53 ++++++++++++++++++ commands/media/index.md | 29 ++++++++++ commands/media/regenerate/index.md | 21 ++++++++ commands/option/add/index.md | 9 ++++ commands/option/delete/index.md | 9 ++++ commands/option/get/index.md | 9 ++++ commands/option/index.md | 51 ++++++++++++++++++ commands/option/update/index.md | 9 ++++ commands/plugin/activate/index.md | 16 ++++++ commands/plugin/deactivate/index.md | 16 ++++++ commands/plugin/delete/index.md | 18 +++++++ commands/plugin/index.md | 65 ++++++++++++++++++++++ commands/plugin/install/index.md | 29 ++++++++++ commands/plugin/list/index.md | 17 ++++++ commands/plugin/path/index.md | 22 ++++++++ commands/plugin/status/index.md | 12 +++++ commands/plugin/toggle/index.md | 16 ++++++ commands/plugin/uninstall/index.md | 22 ++++++++ commands/plugin/update-all/index.md | 17 ++++++ commands/plugin/update/index.md | 22 ++++++++ commands/post-meta/add/index.md | 9 ++++ commands/post-meta/delete/index.md | 9 ++++ commands/post-meta/get/index.md | 9 ++++ commands/post-meta/index.md | 45 ++++++++++++++++ commands/post-meta/update/index.md | 9 ++++ commands/post/create/index.md | 36 +++++++++++++ commands/post/delete/index.md | 22 ++++++++ commands/post/edit/index.md | 17 ++++++ commands/post/generate/index.md | 32 +++++++++++ commands/post/get/index.md | 29 ++++++++++ commands/post/index.md | 49 +++++++++++++++++ commands/post/list/index.md | 27 ++++++++++ commands/post/update/index.md | 20 +++++++ commands/rewrite/dump/index.md | 13 +++++ commands/rewrite/flush/index.md | 15 ++++++ commands/rewrite/index.md | 33 ++++++++++++ commands/rewrite/structure/index.md | 21 ++++++++ commands/role/create/index.md | 24 +++++++++ commands/role/delete/index.md | 21 ++++++++ commands/role/exists/index.md | 25 +++++++++ commands/role/index.md | 37 +++++++++++++ commands/role/list/index.md | 20 +++++++ commands/scaffold/_s/index.md | 25 +++++++++ commands/scaffold/child-theme/index.md | 32 +++++++++++ commands/scaffold/index.md | 45 ++++++++++++++++ commands/scaffold/plugin-tests/index.md | 26 +++++++++ commands/scaffold/plugin/index.md | 16 ++++++ commands/scaffold/post-type/index.md | 27 ++++++++++ commands/scaffold/taxonomy/index.md | 34 ++++++++++++ commands/search-replace/index.md | 31 +++++++++++ commands/shell/index.md | 17 ++++++ commands/term/create/index.md | 32 +++++++++++ commands/term/delete/index.md | 19 +++++++ commands/term/index.md | 37 +++++++++++++ commands/term/list/index.md | 25 +++++++++ commands/term/update/index.md | 32 +++++++++++ commands/theme/activate/index.md | 13 +++++ commands/theme/delete/index.md | 17 ++++++ commands/theme/index.md | 53 ++++++++++++++++++ commands/theme/install/index.md | 22 ++++++++ commands/theme/list/index.md | 17 ++++++ commands/theme/path/index.md | 22 ++++++++ commands/theme/status/index.md | 13 +++++ commands/theme/update-all/index.md | 17 ++++++ commands/theme/update/index.md | 21 ++++++++ commands/transient/delete/index.md | 9 ++++ commands/transient/get/index.md | 9 ++++ commands/transient/index.md | 40 ++++++++++++++ commands/transient/set/index.md | 9 ++++ commands/transient/type/index.md | 9 ++++ commands/user-meta/add/index.md | 9 ++++ commands/user-meta/delete/index.md | 9 ++++ commands/user-meta/get/index.md | 9 ++++ commands/user-meta/index.md | 45 ++++++++++++++++ commands/user-meta/update/index.md | 9 ++++ commands/user/add-role/index.md | 9 ++++ commands/user/create/index.md | 35 ++++++++++++ commands/user/delete/index.md | 20 +++++++ commands/user/generate/index.md | 16 ++++++ commands/user/import-csv/index.md | 24 +++++++++ commands/user/index.md | 57 ++++++++++++++++++++ commands/user/list/index.md | 27 ++++++++++ commands/user/remove-role/index.md | 18 +++++++ commands/user/set-role/index.md | 21 ++++++++ commands/user/update/index.md | 20 +++++++ 145 files changed, 3150 insertions(+), 33 deletions(-) create mode 100644 _templates/subcmd-list.mustache create mode 100644 commands/blog/create/index.md create mode 100644 commands/blog/delete/index.md create mode 100644 commands/blog/empty/index.md create mode 100644 commands/blog/index.md create mode 100644 commands/cache/add/index.md create mode 100644 commands/cache/decr/index.md create mode 100644 commands/cache/delete/index.md create mode 100644 commands/cache/flush/index.md create mode 100644 commands/cache/get/index.md create mode 100644 commands/cache/incr/index.md create mode 100644 commands/cache/index.md create mode 100644 commands/cache/replace/index.md create mode 100644 commands/cache/set/index.md create mode 100644 commands/cache/type/index.md create mode 100644 commands/cap/add/index.md create mode 100644 commands/cap/index.md create mode 100644 commands/cap/list/index.md create mode 100644 commands/cap/remove/index.md create mode 100644 commands/comment/approve/index.md create mode 100644 commands/comment/count/index.md create mode 100644 commands/comment/create/index.md create mode 100644 commands/comment/delete/index.md create mode 100644 commands/comment/index.md create mode 100644 commands/comment/last/index.md create mode 100644 commands/comment/spam/index.md create mode 100644 commands/comment/status/index.md create mode 100644 commands/comment/trash/index.md create mode 100644 commands/comment/unapprove/index.md create mode 100644 commands/comment/unspam/index.md create mode 100644 commands/comment/untrash/index.md create mode 100644 commands/core/config/index.md create mode 100644 commands/core/download/index.md create mode 100644 commands/core/index.md create mode 100644 commands/core/init-tests/index.md create mode 100644 commands/core/install-network/index.md create mode 100644 commands/core/install/index.md create mode 100644 commands/core/is-installed/index.md create mode 100644 commands/core/update-db/index.md create mode 100644 commands/core/update/index.md create mode 100644 commands/core/version/index.md create mode 100644 commands/db/cli/index.md create mode 100644 commands/db/create/index.md create mode 100644 commands/db/drop/index.md create mode 100644 commands/db/export/index.md create mode 100644 commands/db/import/index.md create mode 100644 commands/db/index.md create mode 100644 commands/db/optimize/index.md create mode 100644 commands/db/query/index.md create mode 100644 commands/db/repair/index.md create mode 100644 commands/db/reset/index.md create mode 100644 commands/eval-file/index.md create mode 100644 commands/eval/index.md create mode 100644 commands/export/index.md create mode 100644 commands/help/index.md create mode 100644 commands/media/import/index.md create mode 100644 commands/media/index.md create mode 100644 commands/media/regenerate/index.md create mode 100644 commands/option/add/index.md create mode 100644 commands/option/delete/index.md create mode 100644 commands/option/get/index.md create mode 100644 commands/option/index.md create mode 100644 commands/option/update/index.md create mode 100644 commands/plugin/activate/index.md create mode 100644 commands/plugin/deactivate/index.md create mode 100644 commands/plugin/delete/index.md create mode 100644 commands/plugin/index.md create mode 100644 commands/plugin/install/index.md create mode 100644 commands/plugin/list/index.md create mode 100644 commands/plugin/path/index.md create mode 100644 commands/plugin/status/index.md create mode 100644 commands/plugin/toggle/index.md create mode 100644 commands/plugin/uninstall/index.md create mode 100644 commands/plugin/update-all/index.md create mode 100644 commands/plugin/update/index.md create mode 100644 commands/post-meta/add/index.md create mode 100644 commands/post-meta/delete/index.md create mode 100644 commands/post-meta/get/index.md create mode 100644 commands/post-meta/index.md create mode 100644 commands/post-meta/update/index.md create mode 100644 commands/post/create/index.md create mode 100644 commands/post/delete/index.md create mode 100644 commands/post/edit/index.md create mode 100644 commands/post/generate/index.md create mode 100644 commands/post/get/index.md create mode 100644 commands/post/index.md create mode 100644 commands/post/list/index.md create mode 100644 commands/post/update/index.md create mode 100644 commands/rewrite/dump/index.md create mode 100644 commands/rewrite/flush/index.md create mode 100644 commands/rewrite/index.md create mode 100644 commands/rewrite/structure/index.md create mode 100644 commands/role/create/index.md create mode 100644 commands/role/delete/index.md create mode 100644 commands/role/exists/index.md create mode 100644 commands/role/index.md create mode 100644 commands/role/list/index.md create mode 100644 commands/scaffold/_s/index.md create mode 100644 commands/scaffold/child-theme/index.md create mode 100644 commands/scaffold/index.md create mode 100644 commands/scaffold/plugin-tests/index.md create mode 100644 commands/scaffold/plugin/index.md create mode 100644 commands/scaffold/post-type/index.md create mode 100644 commands/scaffold/taxonomy/index.md create mode 100644 commands/search-replace/index.md create mode 100644 commands/shell/index.md create mode 100644 commands/term/create/index.md create mode 100644 commands/term/delete/index.md create mode 100644 commands/term/index.md create mode 100644 commands/term/list/index.md create mode 100644 commands/term/update/index.md create mode 100644 commands/theme/activate/index.md create mode 100644 commands/theme/delete/index.md create mode 100644 commands/theme/index.md create mode 100644 commands/theme/install/index.md create mode 100644 commands/theme/list/index.md create mode 100644 commands/theme/path/index.md create mode 100644 commands/theme/status/index.md create mode 100644 commands/theme/update-all/index.md create mode 100644 commands/theme/update/index.md create mode 100644 commands/transient/delete/index.md create mode 100644 commands/transient/get/index.md create mode 100644 commands/transient/index.md create mode 100644 commands/transient/set/index.md create mode 100644 commands/transient/type/index.md create mode 100644 commands/user-meta/add/index.md create mode 100644 commands/user-meta/delete/index.md create mode 100644 commands/user-meta/get/index.md create mode 100644 commands/user-meta/index.md create mode 100644 commands/user-meta/update/index.md create mode 100644 commands/user/add-role/index.md create mode 100644 commands/user/create/index.md create mode 100644 commands/user/delete/index.md create mode 100644 commands/user/generate/index.md create mode 100644 commands/user/import-csv/index.md create mode 100644 commands/user/index.md create mode 100644 commands/user/list/index.md create mode 100644 commands/user/remove-role/index.md create mode 100644 commands/user/set-role/index.md create mode 100644 commands/user/update/index.md diff --git a/Phakefile.php b/Phakefile.php index 51885ad9..2fe0fbb1 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -39,12 +39,46 @@ function generate_synopsis( $command, $path = '' ) { generate_synopsis( invoke_wp_cli( 'wp --cmd-dump', $app ) ); }); +function gen_cmd_pages( $wp_cli_path, $cmd, $parent = array() ) { + $parent[] = $cmd['name']; + + $binding = $cmd; + $binding['synopsis'] = implode( ' ', $parent ); + $binding['path'] = implode( '/', $parent ); + $binding['has-subcommands'] = isset( $cmd['subcommands'] ) ? array(true) : false; + + $docs_path = $wp_cli_path . '/man-src/' . implode( '-', $parent ) . '.txt'; + if ( is_readable( $docs_path ) ) { + $docs = file_get_contents( $docs_path ); + $docs = preg_replace( '/^## /m', '### ', $docs ); + $docs = preg_replace( '/\n\* `(.+)`([^\n]*):\n\n/', "\n\t\\1\\2\n\t\t", $docs ); + $binding['docs'] = $docs; + } + + $path = __DIR__ . "/commands/" . $binding['path']; + mkdir( $path ); + file_put_contents( "$path/index.md", render( 'subcmd-list.mustache', $binding ) ); + + if ( !isset( $cmd['subcommands'] ) ) + return; + + foreach ( $cmd['subcommands'] as $subcmd ) { + gen_cmd_pages( $wp_cli_path, $subcmd, $parent ); + } +} + desc( 'Update the /commands/ page.' ); task( 'cmd-list', function( $app ) { $wp = invoke_wp_cli( 'wp --cmd-dump', $app ); - $wp['version'] = $app['version']; + // generate main page file_put_contents( '_includes/cmd-list.html', render( 'cmd-list.mustache', $wp ) ); + + system( sprintf( 'rm -rf %s/commands/*/', escapeshellarg( __DIR__ ) ) ); + + foreach ( $wp['subcommands'] as $cmd ) { + gen_cmd_pages( $app['path'], $cmd ); + } }); desc( 'Update the /config/ page.' ); diff --git a/README.md b/README.md index a8e902dc..244632d5 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ 3. Build: ```bash -vendor/bin/phake path=/path/to/wp/install version=v0.10.2 +vendor/bin/phake path=/path/to/wp-cli-dir ``` ### Preview locally diff --git a/_includes/cmd-list.html b/_includes/cmd-list.html index 44daa44b..d62d1a07 100644 --- a/_includes/cmd-list.html +++ b/_includes/cmd-list.html @@ -1,100 +1,100 @@ - blog + blog Manage blogs in a multisite install. - cache + cache Manage the object cache. - cap + cap Manage user capabilities. - comment + comment Manage comments. - core + core Download, install, update and otherwise manage WordPress proper. - db + db Perform basic database operations. - eval + eval Execute arbitrary PHP code after loading WordPress. - eval-file + eval-file Load and execute a PHP file after loading WordPress. - export + export Export content to a WXR file. - help + help Get help on a certain topic. - media + media Control the media library and its attachments. - option + option Manage WordPress options. - plugin + plugin Manage plugins. - post + post Manage posts. - post-meta + post-meta Manage post custom fields. - rewrite + rewrite Manage rewrite rules. - role + role Manage user roles. - scaffold + scaffold Generate code for post types, taxonomies, etc. - search-replace + search-replace Search/replace strings in the database. - shell + shell Interactive PHP console. - term + term Manage terms. - theme + theme Manage themes. - transient + transient Manage WordPress transients. - user + user Manage users. - user-meta + user-meta Manage user custom fields. diff --git a/_templates/cmd-list.mustache b/_templates/cmd-list.mustache index 715cf0ae..0fc2e3e9 100644 --- a/_templates/cmd-list.mustache +++ b/_templates/cmd-list.mustache @@ -1,6 +1,6 @@ {{#subcommands}} - {{name}} + {{name}} {{description}} {{/subcommands}} diff --git a/_templates/subcmd-list.mustache b/_templates/subcmd-list.mustache new file mode 100644 index 00000000..d051a272 --- /dev/null +++ b/_templates/subcmd-list.mustache @@ -0,0 +1,29 @@ +--- +layout: default +title: 'wp {{synopsis}}' +--- + +`wp {{synopsis}}` - {{description}} + +{{{docs}}} + +{{#has-subcommands}} +### SUBCOMMANDS + + + + + + + + + + {{#subcommands}} + + + + + {{/subcommands}} + +
NameDescription
{{name}}{{description}}
+{{/has-subcommands}} diff --git a/assets/css/stylesheet.css b/assets/css/stylesheet.css index 4824dfcd..8fa212fd 100644 --- a/assets/css/stylesheet.css +++ b/assets/css/stylesheet.css @@ -188,6 +188,10 @@ pre code { background-color: inherit; } +h3 + table { + margin-top: 10px; +} + table { width: 100%; margin: 0 0 20px 0; @@ -195,16 +199,12 @@ table { th, td { vertical-align: top; + padding: 5px 20px 5px 0; } th { text-align: left; border-bottom: 1px dashed #b5e853; - padding: 5px 10px; -} - -td { - padding: 5px 10px; } hr { diff --git a/commands/blog/create/index.md b/commands/blog/create/index.md new file mode 100644 index 00000000..9d69fa15 --- /dev/null +++ b/commands/blog/create/index.md @@ -0,0 +1,28 @@ +--- +layout: default +title: 'wp blog create' +--- + +`wp blog create` - Create a blog in a multisite install. + +### OPTIONS + + --slug= + Path for the new blog. Subdomain on subdomain installs, directory on subdirectory installs. + + --title= + Email for Admin user. User will be created if none exists. Assignement to Super Admin if not included. + + --site_id= + Site (network) to associate new blog with. Defaults to current site (typically 1). + + --private + If set, the new blog will be non-public (not indexed) + + --porcelain + If set, only the blog id will be output on success. + + diff --git a/commands/blog/delete/index.md b/commands/blog/delete/index.md new file mode 100644 index 00000000..c57a5919 --- /dev/null +++ b/commands/blog/delete/index.md @@ -0,0 +1,22 @@ +--- +layout: default +title: 'wp blog delete' +--- + +`wp blog delete` - Delete a blog in a multisite install. + +### OPTIONS + + + The id of the blog to delete. If not provided, you must set the --slug parameter. + + --slug= + Path of the blog to be deleted. Subdomain on subdomain installs, directory on subdirectory installs. + + --yes + Answer yes to the confirmation message. + + --keep-tables + Delete the blog from the list, but don't drop it's tables. + + diff --git a/commands/blog/empty/index.md b/commands/blog/empty/index.md new file mode 100644 index 00000000..ec4cc797 --- /dev/null +++ b/commands/blog/empty/index.md @@ -0,0 +1,11 @@ +--- +layout: default +title: 'wp blog empty' +--- + +`wp blog empty` - Empty a blog of its content. + +### EXAMPLES + + wp blog empty + diff --git a/commands/blog/index.md b/commands/blog/index.md new file mode 100644 index 00000000..efb060bf --- /dev/null +++ b/commands/blog/index.md @@ -0,0 +1,33 @@ +--- +layout: default +title: 'wp blog' +--- + +`wp blog` - Manage blogs in a multisite install. + + + +### SUBCOMMANDS + + + + + + + + + + + + + + + + + + + + + + +
NameDescription
createCreate a blog in a multisite install.
deleteDelete a blog in a multisite install.
emptyEmpty a blog of its content.
diff --git a/commands/cache/add/index.md b/commands/cache/add/index.md new file mode 100644 index 00000000..338e9e1d --- /dev/null +++ b/commands/cache/add/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cache add' +--- + +`wp cache add` - Add a value to the object cache. + + + diff --git a/commands/cache/decr/index.md b/commands/cache/decr/index.md new file mode 100644 index 00000000..0086dde7 --- /dev/null +++ b/commands/cache/decr/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cache decr' +--- + +`wp cache decr` - Decrement a value in the object cache. + + + diff --git a/commands/cache/delete/index.md b/commands/cache/delete/index.md new file mode 100644 index 00000000..13524acd --- /dev/null +++ b/commands/cache/delete/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cache delete' +--- + +`wp cache delete` - Remove a value from the object cache. + + + diff --git a/commands/cache/flush/index.md b/commands/cache/flush/index.md new file mode 100644 index 00000000..e4351821 --- /dev/null +++ b/commands/cache/flush/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cache flush' +--- + +`wp cache flush` - Flush the object cache. + + + diff --git a/commands/cache/get/index.md b/commands/cache/get/index.md new file mode 100644 index 00000000..fd69d46c --- /dev/null +++ b/commands/cache/get/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cache get' +--- + +`wp cache get` - Get a value from the object cache. + + + diff --git a/commands/cache/incr/index.md b/commands/cache/incr/index.md new file mode 100644 index 00000000..02bc098c --- /dev/null +++ b/commands/cache/incr/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cache incr' +--- + +`wp cache incr` - Increment a value in the object cache. + + + diff --git a/commands/cache/index.md b/commands/cache/index.md new file mode 100644 index 00000000..4599ae37 --- /dev/null +++ b/commands/cache/index.md @@ -0,0 +1,62 @@ +--- +layout: default +title: 'wp cache' +--- + +`wp cache` - Manage the object cache. + +### EXAMPLES + + wp cache set my_key my_value my_group 300 + + wp cache get my_key my_group + + +### SUBCOMMANDS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescription
addAdd a value to the object cache.
decrDecrement a value in the object cache.
deleteRemove a value from the object cache.
flushFlush the object cache.
getGet a value from the object cache.
incrIncrement a value in the object cache.
replaceReplace an existing value in the object cache.
setSet a value to the object cache.
typeAttempts to determine which object cache is being used.
diff --git a/commands/cache/replace/index.md b/commands/cache/replace/index.md new file mode 100644 index 00000000..6475f419 --- /dev/null +++ b/commands/cache/replace/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cache replace' +--- + +`wp cache replace` - Replace an existing value in the object cache. + + + diff --git a/commands/cache/set/index.md b/commands/cache/set/index.md new file mode 100644 index 00000000..21561b26 --- /dev/null +++ b/commands/cache/set/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cache set' +--- + +`wp cache set` - Set a value to the object cache. + + + diff --git a/commands/cache/type/index.md b/commands/cache/type/index.md new file mode 100644 index 00000000..2e256840 --- /dev/null +++ b/commands/cache/type/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cache type' +--- + +`wp cache type` - Attempts to determine which object cache is being used. + + + diff --git a/commands/cap/add/index.md b/commands/cap/add/index.md new file mode 100644 index 00000000..84e27652 --- /dev/null +++ b/commands/cap/add/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cap add' +--- + +`wp cap add` - Add capabilities to a given role. + + + diff --git a/commands/cap/index.md b/commands/cap/index.md new file mode 100644 index 00000000..7e69b337 --- /dev/null +++ b/commands/cap/index.md @@ -0,0 +1,43 @@ +--- +layout: default +title: 'wp cap' +--- + +`wp cap` - Manage user capabilities. + +### EXAMPLES + + # Add 'spectate' capability to 'author' role + wp cap add 'author' 'spectate' + + # Add all caps from 'editor' role to 'author' role + wp cap list 'editor' | xargs wp cap add 'author' + + # Remove all caps from 'editor' role that also appear in 'author' role + wp cap list 'author' | xargs wp cap remove 'editor' + + +### SUBCOMMANDS + + + + + + + + + + + + + + + + + + + + + + +
NameDescription
addAdd capabilities to a given role.
listList capabilities for a given role.
removeRemove capabilities from a given role.
diff --git a/commands/cap/list/index.md b/commands/cap/list/index.md new file mode 100644 index 00000000..89097639 --- /dev/null +++ b/commands/cap/list/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cap list' +--- + +`wp cap list` - List capabilities for a given role. + + + diff --git a/commands/cap/remove/index.md b/commands/cap/remove/index.md new file mode 100644 index 00000000..ec43de82 --- /dev/null +++ b/commands/cap/remove/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cap remove' +--- + +`wp cap remove` - Remove capabilities from a given role. + + + diff --git a/commands/comment/approve/index.md b/commands/comment/approve/index.md new file mode 100644 index 00000000..ca426161 --- /dev/null +++ b/commands/comment/approve/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp comment approve' +--- + +`wp comment approve` - Approve a comment. + +### OPTIONS + + + The ID of the comment to approve. + +### EXAMPLES + + wp comment approve 1337 + + diff --git a/commands/comment/count/index.md b/commands/comment/count/index.md new file mode 100644 index 00000000..07c62641 --- /dev/null +++ b/commands/comment/count/index.md @@ -0,0 +1,18 @@ +--- +layout: default +title: 'wp comment count' +--- + +`wp comment count` - Count comments, on whole blog or on a given post. + +### OPTIONS + + + The ID of the post to count comments in + +### EXAMPLES + + wp comment count + wp comment count 42 + + diff --git a/commands/comment/create/index.md b/commands/comment/create/index.md new file mode 100644 index 00000000..c35249ea --- /dev/null +++ b/commands/comment/create/index.md @@ -0,0 +1,21 @@ +--- +layout: default +title: 'wp comment create' +--- + +`wp comment create` - Insert a comment. + +### OPTIONS + + --= + Field values for the new comment. See wp_insert_comment(). + + --porcelain + Output just the new comment id. + +### EXAMPLES + + wp comment create --comment_post_ID=15 --comment_content="hello blog" +--comment_author="wp-cli" + + diff --git a/commands/comment/delete/index.md b/commands/comment/delete/index.md new file mode 100644 index 00000000..d8ef9764 --- /dev/null +++ b/commands/comment/delete/index.md @@ -0,0 +1,20 @@ +--- +layout: default +title: 'wp comment delete' +--- + +`wp comment delete` - Delete a comment. + +### OPTIONS + + + The ID of the comment to delete. + + --force + Skip the trash bin. + +### EXAMPLES + + wp comment delete 1337 --force + + diff --git a/commands/comment/index.md b/commands/comment/index.md new file mode 100644 index 00000000..112f3c56 --- /dev/null +++ b/commands/comment/index.md @@ -0,0 +1,65 @@ +--- +layout: default +title: 'wp comment' +--- + +`wp comment` - Manage comments. + + + +### SUBCOMMANDS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescription
approveApprove a comment.
countCount comments, on whole blog or on a given post.
createInsert a comment.
deleteDelete a comment.
lastGet last approved comment.
spamSpam a comment.
statusGet status of a comment.
trashTrash a comment.
unapproveUnapprove a comment.
unspamUnspam a comment.
untrashUntrash a comment.
diff --git a/commands/comment/last/index.md b/commands/comment/last/index.md new file mode 100644 index 00000000..1c9a1fff --- /dev/null +++ b/commands/comment/last/index.md @@ -0,0 +1,20 @@ +--- +layout: default +title: 'wp comment last' +--- + +`wp comment last` - Get last approved comment. + +### OPTIONS + + --id + Output just the last comment id. + + --full + Output complete comment information. + +### EXAMPLES + + wp comment last --full + + diff --git a/commands/comment/spam/index.md b/commands/comment/spam/index.md new file mode 100644 index 00000000..674cbd47 --- /dev/null +++ b/commands/comment/spam/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp comment spam' +--- + +`wp comment spam` - Spam a comment. + +### OPTIONS + + + The ID of the comment to mark as spam. + +### EXAMPLES + + wp comment spam 1337 + + diff --git a/commands/comment/status/index.md b/commands/comment/status/index.md new file mode 100644 index 00000000..e20d02c9 --- /dev/null +++ b/commands/comment/status/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp comment status' +--- + +`wp comment status` - Get status of a comment. + +### OPTIONS + + + The ID of the comment to check + +### EXAMPLES + + wp comment status 1337 + + diff --git a/commands/comment/trash/index.md b/commands/comment/trash/index.md new file mode 100644 index 00000000..ac254279 --- /dev/null +++ b/commands/comment/trash/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp comment trash' +--- + +`wp comment trash` - Trash a comment. + +### OPTIONS + + + The ID of the comment to trash. + +### EXAMPLES + + wp comment trash 1337 + + diff --git a/commands/comment/unapprove/index.md b/commands/comment/unapprove/index.md new file mode 100644 index 00000000..c227f530 --- /dev/null +++ b/commands/comment/unapprove/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp comment unapprove' +--- + +`wp comment unapprove` - Unapprove a comment. + +### OPTIONS + + + The ID of the comment to unapprove. + +### EXAMPLES + + wp comment unapprove 1337 + + diff --git a/commands/comment/unspam/index.md b/commands/comment/unspam/index.md new file mode 100644 index 00000000..9db3027a --- /dev/null +++ b/commands/comment/unspam/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp comment unspam' +--- + +`wp comment unspam` - Unspam a comment. + +### OPTIONS + + + The ID of the comment to unmark as spam. + +### EXAMPLES + + wp comment unspam 1337 + + diff --git a/commands/comment/untrash/index.md b/commands/comment/untrash/index.md new file mode 100644 index 00000000..a9ba56c1 --- /dev/null +++ b/commands/comment/untrash/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp comment untrash' +--- + +`wp comment untrash` - Untrash a comment. + +### OPTIONS + + + The ID of the comment to untrash. + +### EXAMPLES + + wp comment untrash 1337 + + diff --git a/commands/core/config/index.md b/commands/core/config/index.md new file mode 100644 index 00000000..23d2cc3b --- /dev/null +++ b/commands/core/config/index.md @@ -0,0 +1,39 @@ +--- +layout: default +title: 'wp core config' +--- + +`wp core config` - Set up a wp-config.php file. + +### OPTIONS + + --dbname= + Set the database name. + + --dbuser= + Set the database user. + + --dbpass= + Set the database user password. + + --dbhost= + Set the database host. Default: 'localhost' + + --dbprefix= + Set the database table prefix. Default: 'wp_' + + --extra-php + If set, the command reads additional PHP code from STDIN. + +### EXAMPLES + + # Standard wp-config.php file + wp core config --dbname=testing --dbuser=wp --dbpass=securepswd + + # Enable WP_DEBUG and WP_DEBUG_LOG + wp core config --dbname=testing --dbuser=wp --dbpass=securepswd --extra-php < + Select which language you want to download. The --version parameter is +ignored in this case. + + --version= + Select which version you want to download. + + --force + Overwrites existing files, if present. + +### EXAMPLES + + wp core download --version=3.3 + + diff --git a/commands/core/index.md b/commands/core/index.md new file mode 100644 index 00000000..6531fcf5 --- /dev/null +++ b/commands/core/index.md @@ -0,0 +1,57 @@ +--- +layout: default +title: 'wp core' +--- + +`wp core` - Download, install, update and otherwise manage WordPress proper. + + + +### SUBCOMMANDS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescription
configSet up a wp-config.php file.
downloadDownload core WordPress files.
init-testsSet up the official test suite using the current WordPress instance.
installCreate the WordPress tables in the database.
install-networkTransform a single-site install into a multi-site install.
is-installedDetermine if the WordPress tables are installed.
updateUpdate WordPress.
update-dbUpdate the WordPress database.
versionDisplay the WordPress version.
diff --git a/commands/core/init-tests/index.md b/commands/core/init-tests/index.md new file mode 100644 index 00000000..efcc33b7 --- /dev/null +++ b/commands/core/init-tests/index.md @@ -0,0 +1,27 @@ +--- +layout: default +title: 'wp core init-tests' +--- + +`wp core init-tests` - Set up the official test suite using the current WordPress instance. + +### OPTIONS + + + The directory in which to download the testing suite files. (Optional) + + --dbname= + Set the database name. **WARNING**: The database will be whipped every time +you run the tests. + + --dbuser= + Set the database user. + + --dbpass= + Set the database user password. + +### EXAMPLE + + wp core init-tests ~/svn/wp-tests --dbname=wp_test --dbuser=wp_test + + diff --git a/commands/core/install-network/index.md b/commands/core/install-network/index.md new file mode 100644 index 00000000..45dc3617 --- /dev/null +++ b/commands/core/install-network/index.md @@ -0,0 +1,20 @@ +--- +layout: default +title: 'wp core install-network' +--- + +`wp core install-network` - Transform a single-site install into a multi-site install. + +### OPTIONS + + --title= + The title of the new network. + + --base= + Base path after the domain name that each site url will start with. +Default: '/' + + --subdomains + If passed, the network will use subdomains, instead of subdirectories. + + diff --git a/commands/core/install/index.md b/commands/core/install/index.md new file mode 100644 index 00000000..ad84fe56 --- /dev/null +++ b/commands/core/install/index.md @@ -0,0 +1,25 @@ +--- +layout: default +title: 'wp core install' +--- + +`wp core install` - Create the WordPress tables in the database. + +### OPTIONS + + --url= + The address of the new site. + + --title= + The title of the new site. + + --admin_name= + The name of the admin user. Default: 'admin' + + --admin_password= + The password for the admin user. + + --admin_email= + The email address for the admin user. + + diff --git a/commands/core/is-installed/index.md b/commands/core/is-installed/index.md new file mode 100644 index 00000000..062bd672 --- /dev/null +++ b/commands/core/is-installed/index.md @@ -0,0 +1,14 @@ +--- +layout: default +title: 'wp core is-installed' +--- + +`wp core is-installed` - Determine if the WordPress tables are installed. + +### EXAMPLES + + if ! $(wp core is-installed); then + wp core install + fi + + diff --git a/commands/core/update-db/index.md b/commands/core/update-db/index.md new file mode 100644 index 00000000..3ba7891c --- /dev/null +++ b/commands/core/update-db/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp core update-db' +--- + +`wp core update-db` - Update the WordPress database. + + + diff --git a/commands/core/update/index.md b/commands/core/update/index.md new file mode 100644 index 00000000..86ee58e3 --- /dev/null +++ b/commands/core/update/index.md @@ -0,0 +1,27 @@ +--- +layout: default +title: 'wp core update' +--- + +`wp core update` - Update WordPress. + +### OPTIONS + + --version= [package/zip] + When passed, updates to new_version, optionally using package/zip as +input. + +* `--force`: + + Will update even when current WP version < passed version. Use with +caution. + +### EXAMPLES + + wp core update + + wp core update --version=3.4 ../latest.zip + + wp core update --version=3.1 --force + + diff --git a/commands/core/version/index.md b/commands/core/version/index.md new file mode 100644 index 00000000..0226b87a --- /dev/null +++ b/commands/core/version/index.md @@ -0,0 +1,13 @@ +--- +layout: default +title: 'wp core version' +--- + +`wp core version` - Display the WordPress version. + +### OPTIONS + + --extra + Show extended version information. + + diff --git a/commands/db/cli/index.md b/commands/db/cli/index.md new file mode 100644 index 00000000..3e08d7b8 --- /dev/null +++ b/commands/db/cli/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp db cli' +--- + +`wp db cli` - Open a mysql console using the WordPress credentials. + + + diff --git a/commands/db/create/index.md b/commands/db/create/index.md new file mode 100644 index 00000000..8cd18832 --- /dev/null +++ b/commands/db/create/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp db create' +--- + +`wp db create` - Create the database, as specified in wp-config.php + + + diff --git a/commands/db/drop/index.md b/commands/db/drop/index.md new file mode 100644 index 00000000..51f53275 --- /dev/null +++ b/commands/db/drop/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp db drop' +--- + +`wp db drop` - Delete the database. + + + diff --git a/commands/db/export/index.md b/commands/db/export/index.md new file mode 100644 index 00000000..252bfce0 --- /dev/null +++ b/commands/db/export/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp db export' +--- + +`wp db export` - Exports the database using mysqldump. + + + diff --git a/commands/db/import/index.md b/commands/db/import/index.md new file mode 100644 index 00000000..2ae01325 --- /dev/null +++ b/commands/db/import/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp db import' +--- + +`wp db import` - Import database from a file. + + + diff --git a/commands/db/index.md b/commands/db/index.md new file mode 100644 index 00000000..7355e21b --- /dev/null +++ b/commands/db/index.md @@ -0,0 +1,72 @@ +--- +layout: default +title: 'wp db' +--- + +`wp db` - Perform basic database operations. + +### OPTIONS + + --yes + Answer yes to the confirmation message. + + + The name of the export file. If omitted, it will be '{dbname}.sql' + + + A SQL query. + +### EXAMPLES + + # execute a query stored in a file + wp db query < debug.sql + + +### SUBCOMMANDS + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameDescription
cliOpen a mysql console using the WordPress credentials.
createCreate the database, as specified in wp-config.php
dropDelete the database.
exportExports the database using mysqldump.
importImport database from a file.
optimizeOptimize the database.
queryExecute a query against the database.
repairRepair the database.
resetRemove all tables from the database.
diff --git a/commands/db/optimize/index.md b/commands/db/optimize/index.md new file mode 100644 index 00000000..e44c5764 --- /dev/null +++ b/commands/db/optimize/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp db optimize' +--- + +`wp db optimize` - Optimize the database. + + + diff --git a/commands/db/query/index.md b/commands/db/query/index.md new file mode 100644 index 00000000..3123e337 --- /dev/null +++ b/commands/db/query/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp db query' +--- + +`wp db query` - Execute a query against the database. + + + diff --git a/commands/db/repair/index.md b/commands/db/repair/index.md new file mode 100644 index 00000000..ee88ec98 --- /dev/null +++ b/commands/db/repair/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp db repair' +--- + +`wp db repair` - Repair the database. + + + diff --git a/commands/db/reset/index.md b/commands/db/reset/index.md new file mode 100644 index 00000000..ae912f32 --- /dev/null +++ b/commands/db/reset/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp db reset' +--- + +`wp db reset` - Remove all tables from the database. + + + diff --git a/commands/eval-file/index.md b/commands/eval-file/index.md new file mode 100644 index 00000000..3b7cf30c --- /dev/null +++ b/commands/eval-file/index.md @@ -0,0 +1,12 @@ +--- +layout: default +title: 'wp eval-file' +--- + +`wp eval-file` - Load and execute a PHP file after loading WordPress. + +### EXAMPLES + + wp eval-file my-code.php + + diff --git a/commands/eval/index.md b/commands/eval/index.md new file mode 100644 index 00000000..f102a435 --- /dev/null +++ b/commands/eval/index.md @@ -0,0 +1,12 @@ +--- +layout: default +title: 'wp eval' +--- + +`wp eval` - Execute arbitrary PHP code after loading WordPress. + +### EXAMPLES + + wp eval 'echo WP_CONTENT_DIR;' + + diff --git a/commands/export/index.md b/commands/export/index.md new file mode 100644 index 00000000..575d7825 --- /dev/null +++ b/commands/export/index.md @@ -0,0 +1,52 @@ +--- +layout: default +title: 'wp export' +--- + +`wp export` - Export content to a WXR file. + +### OPTIONS + + --dir= + Full path to directory where WXR export files should be stored. Defaults +to current working directory. + + --skip_comments + Don't export comments. + + --file_item_count= + Break export into files with N posts. + + --verbose + Show more information about the process on STDOUT. + +### FILTERS + + --start_date= + Export only posts newer than this date, in format YYYY-MM-DD. + + --end_date= + Export only posts older than this date, in format YYYY-MM-DD. + + --post_type= + Export only posts with this post_type. + + --post__in= + Export all posts specified as a comma-separated list of IDs. + + --author= + Export only posts by this author. + + --category= + Export only posts in this category. + + --post_status= + Export only posts with this status. + +### EXAMPLES + + wp export --dir=/tmp/ --user=admin --post_type=post --start_date=2011-01-01 --end_date=2011-12-31 + + wp export --dir=/tmp/ --post__in=123,124,125 + + diff --git a/commands/help/index.md b/commands/help/index.md new file mode 100644 index 00000000..22b8e35c --- /dev/null +++ b/commands/help/index.md @@ -0,0 +1,19 @@ +--- +layout: default +title: 'wp help' +--- + +`wp help` - Get help on a certain topic. + +### EXAMPLES + + # (re)generates all man pages + wp help --gen + + # (re)generate man pages for the `core` command + wp help --gen core + + # (re)generate man page only for the `core download` subcommand + wp help --gen core download + + diff --git a/commands/media/import/index.md b/commands/media/import/index.md new file mode 100644 index 00000000..8b2c1add --- /dev/null +++ b/commands/media/import/index.md @@ -0,0 +1,53 @@ +--- +layout: default +title: 'wp media import' +--- + +`wp media import` - Create attachments from local files or from URLs. + +### OPTIONS + + + Path to file or files to be imported. Supports the glob(3) capabilities of the current shell. + If file is recognized as a URL (for example, with a scheme of http or ftp), the file will be + downloaded to a temp file before being sideloaded. + +* `--post_id=` + + ID of the post to attach the imported files to + +* `--title=` + + Attachment title (post title field) + +* `--caption=<caption>` + + Caption for attachent (post excerpt field) + +* `--alt=<alt_text>` + + Alt text for image (saved as post meta) + +* `--desc=<description>` + + "Description" field (post content) of attachment post + +* `--featured_image` + + If set, set the imported image as the Featured Image of the post its attached to. + + +### EXAMPLES + + # Import all jpgs in the current user's "Pictures" directory, not attached to any post + wp media import ~/Pictures/**/*.jpg + + # Import a local image and set it to be the post thumbnail for a post + wp media import ~/Downloads/image.png --post_id=123 --title="A downloaded picture" --featured_image + + # Import an image from the web + wp media import http://s.wordpress.org/style/images/wp-header-logo.png --title='The WordPress logo' --alt="Semantic personal publishing" + + + + diff --git a/commands/media/index.md b/commands/media/index.md new file mode 100644 index 00000000..d37167b1 --- /dev/null +++ b/commands/media/index.md @@ -0,0 +1,29 @@ +--- +layout: default +title: 'wp media' +--- + +`wp media` - Control the media library and its attachments. + + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/media/import">import</a></td> + <td>Create attachments from local files or from URLs.</td> + </tr> + <tr> + <td><a href="/commands/media/regenerate">regenerate</a></td> + <td>Regenerate thumbnail(s).</td> + </tr> + </tbody> +</table> diff --git a/commands/media/regenerate/index.md b/commands/media/regenerate/index.md new file mode 100644 index 00000000..8bef11e6 --- /dev/null +++ b/commands/media/regenerate/index.md @@ -0,0 +1,21 @@ +--- +layout: default +title: 'wp media regenerate' +--- + +`wp media regenerate` - Regenerate thumbnail(s). + +### OPTIONS + + --yes + Answer yes to the confirmation message. + + <attachment-id> + One or more IDs of the attachments to regenerate. + +### EXAMPLES + + wp media regenerate 123 1337 + + wp media regenerate --yes + diff --git a/commands/option/add/index.md b/commands/option/add/index.md new file mode 100644 index 00000000..515e6b5d --- /dev/null +++ b/commands/option/add/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp option add' +--- + +`wp option add` - Add an option. + + + diff --git a/commands/option/delete/index.md b/commands/option/delete/index.md new file mode 100644 index 00000000..ca3a9458 --- /dev/null +++ b/commands/option/delete/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp option delete' +--- + +`wp option delete` - Delete an option. + + + diff --git a/commands/option/get/index.md b/commands/option/get/index.md new file mode 100644 index 00000000..04b75f14 --- /dev/null +++ b/commands/option/get/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp option get' +--- + +`wp option get` - Get an option. + + + diff --git a/commands/option/index.md b/commands/option/index.md new file mode 100644 index 00000000..92fa7936 --- /dev/null +++ b/commands/option/index.md @@ -0,0 +1,51 @@ +--- +layout: default +title: 'wp option' +--- + +`wp option` - Manage WordPress options. + +### OPTIONS + + --format=json + Encode/decode values as JSON. + +### EXAMPLES + + wp option get siteurl + + wp option add my_option foobar + + wp option update my_option '{"foo": "bar"}' --format=json + + wp option delete my_option + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/option/add">add</a></td> + <td>Add an option.</td> + </tr> + <tr> + <td><a href="/commands/option/delete">delete</a></td> + <td>Delete an option.</td> + </tr> + <tr> + <td><a href="/commands/option/get">get</a></td> + <td>Get an option.</td> + </tr> + <tr> + <td><a href="/commands/option/update">update</a></td> + <td>Update an option.</td> + </tr> + </tbody> +</table> diff --git a/commands/option/update/index.md b/commands/option/update/index.md new file mode 100644 index 00000000..dcbea6d2 --- /dev/null +++ b/commands/option/update/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp option update' +--- + +`wp option update` - Update an option. + + + diff --git a/commands/plugin/activate/index.md b/commands/plugin/activate/index.md new file mode 100644 index 00000000..d610be6c --- /dev/null +++ b/commands/plugin/activate/index.md @@ -0,0 +1,16 @@ +--- +layout: default +title: 'wp plugin activate' +--- + +`wp plugin activate` - Activate a plugin. + +### OPTIONS + + <plugin> + The plugin to activate. + + --network + If set, the plugin will be activated for the entire multisite network. + + diff --git a/commands/plugin/deactivate/index.md b/commands/plugin/deactivate/index.md new file mode 100644 index 00000000..435bac5e --- /dev/null +++ b/commands/plugin/deactivate/index.md @@ -0,0 +1,16 @@ +--- +layout: default +title: 'wp plugin deactivate' +--- + +`wp plugin deactivate` - Deactivate a plugin. + +### OPTIONS + + <plugin> + The plugin to deactivate. + + --network + If set, the plugin will be deactivated for the entire multisite network. + + diff --git a/commands/plugin/delete/index.md b/commands/plugin/delete/index.md new file mode 100644 index 00000000..530a12c2 --- /dev/null +++ b/commands/plugin/delete/index.md @@ -0,0 +1,18 @@ +--- +layout: default +title: 'wp plugin delete' +--- + +`wp plugin delete` - Delete plugin files. + +### OPTIONS + +* <plugin>: + + The plugin to delete. + +### EXAMPLES + + wp plugin delete hello + + diff --git a/commands/plugin/index.md b/commands/plugin/index.md new file mode 100644 index 00000000..954c9456 --- /dev/null +++ b/commands/plugin/index.md @@ -0,0 +1,65 @@ +--- +layout: default +title: 'wp plugin' +--- + +`wp plugin` - Manage plugins. + + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/plugin/activate">activate</a></td> + <td>Activate a plugin.</td> + </tr> + <tr> + <td><a href="/commands/plugin/deactivate">deactivate</a></td> + <td>Deactivate a plugin.</td> + </tr> + <tr> + <td><a href="/commands/plugin/delete">delete</a></td> + <td>Delete plugin files.</td> + </tr> + <tr> + <td><a href="/commands/plugin/install">install</a></td> + <td>Install a plugin.</td> + </tr> + <tr> + <td><a href="/commands/plugin/list">list</a></td> + <td>Get a list of plugins.</td> + </tr> + <tr> + <td><a href="/commands/plugin/path">path</a></td> + <td>Get the path to a plugin or to the plugin directory.</td> + </tr> + <tr> + <td><a href="/commands/plugin/status">status</a></td> + <td>See the status of one or all plugins.</td> + </tr> + <tr> + <td><a href="/commands/plugin/toggle">toggle</a></td> + <td>Toggle a plugin's activation state.</td> + </tr> + <tr> + <td><a href="/commands/plugin/uninstall">uninstall</a></td> + <td>Uninstall a plugin.</td> + </tr> + <tr> + <td><a href="/commands/plugin/update">update</a></td> + <td>Update a plugin.</td> + </tr> + <tr> + <td><a href="/commands/plugin/update-all">update-all</a></td> + <td>Update all plugins.</td> + </tr> + </tbody> +</table> diff --git a/commands/plugin/install/index.md b/commands/plugin/install/index.md new file mode 100644 index 00000000..42bafc53 --- /dev/null +++ b/commands/plugin/install/index.md @@ -0,0 +1,29 @@ +--- +layout: default +title: 'wp plugin install' +--- + +`wp plugin install` - Install a plugin. + +### OPTIONS + +* <plugin>: + + A plugin slug or the path to a zip file. + + --version=<version> + If set, get that particular version from wordpress.org, instead of the +stable version. + + --activate + If set, the plugin will be activated immediately after install. + +### EXAMPLES + + wp plugin install bbpress --version=2.1 --activate + + wp plugin install bbpress --version=dev + + wp plugin install ../my-plugin.zip + + diff --git a/commands/plugin/list/index.md b/commands/plugin/list/index.md new file mode 100644 index 00000000..6baa4f5c --- /dev/null +++ b/commands/plugin/list/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp plugin list' +--- + +`wp plugin list` - Get a list of plugins. + +### OPTIONS + + --format=<format> + Output list as table, CSV or JSON. Defaults to table. + +### EXAMPLES + + wp plugin list --format=json + + diff --git a/commands/plugin/path/index.md b/commands/plugin/path/index.md new file mode 100644 index 00000000..7d565d9e --- /dev/null +++ b/commands/plugin/path/index.md @@ -0,0 +1,22 @@ +--- +layout: default +title: 'wp plugin path' +--- + +`wp plugin path` - Get the path to a plugin or to the plugin directory. + +### OPTIONS + + <plugin> + The plugin to get the path to. If not set, will return the path to the +plugins directory. + + --dir + If set, get the path to the closest parent directory, instead of the +plugin file. + +### EXAMPLES + + cd $(wp theme path) + + diff --git a/commands/plugin/status/index.md b/commands/plugin/status/index.md new file mode 100644 index 00000000..876f761c --- /dev/null +++ b/commands/plugin/status/index.md @@ -0,0 +1,12 @@ +--- +layout: default +title: 'wp plugin status' +--- + +`wp plugin status` - See the status of one or all plugins. + +### OPTIONS + + <plugin> + A particular plugin to show the status for. + diff --git a/commands/plugin/toggle/index.md b/commands/plugin/toggle/index.md new file mode 100644 index 00000000..0be68b51 --- /dev/null +++ b/commands/plugin/toggle/index.md @@ -0,0 +1,16 @@ +--- +layout: default +title: 'wp plugin toggle' +--- + +`wp plugin toggle` - Toggle a plugin's activation state. + +### OPTIONS + + <plugin> + The plugin to toggle. + + --network + If set, the plugin will be toggled for the entire multisite network. + + diff --git a/commands/plugin/uninstall/index.md b/commands/plugin/uninstall/index.md new file mode 100644 index 00000000..bbe072bd --- /dev/null +++ b/commands/plugin/uninstall/index.md @@ -0,0 +1,22 @@ +--- +layout: default +title: 'wp plugin uninstall' +--- + +`wp plugin uninstall` - Uninstall a plugin. + +### OPTIONS + +* <plugin>: + + The plugin to uninstall. + + --no-delete + If set, the plugin files will not be deleted. Only the uninstall procedure +will be run. + +### EXAMPLES + + wp plugin uninstall hello + + diff --git a/commands/plugin/update-all/index.md b/commands/plugin/update-all/index.md new file mode 100644 index 00000000..ca5a5f7b --- /dev/null +++ b/commands/plugin/update-all/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp plugin update-all' +--- + +`wp plugin update-all` - Update all plugins. + +### OPTIONS + + --dry-run + Pretend to do the updates, to see what would happen. + +### EXAMPLES + + wp plugin update-all + + diff --git a/commands/plugin/update/index.md b/commands/plugin/update/index.md new file mode 100644 index 00000000..856b340c --- /dev/null +++ b/commands/plugin/update/index.md @@ -0,0 +1,22 @@ +--- +layout: default +title: 'wp plugin update' +--- + +`wp plugin update` - Update a plugin. + +### OPTIONS + +* <plugin>: + + The plugin to update. + + --version=dev + If set, the plugin will be updated to the latest development version, +regardless of what version is currently installed. + +### EXAMPLES + + wp plugin update bbpress --version=dev + + diff --git a/commands/post-meta/add/index.md b/commands/post-meta/add/index.md new file mode 100644 index 00000000..23b5af47 --- /dev/null +++ b/commands/post-meta/add/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp post-meta add' +--- + +`wp post-meta add` - Add a meta field. + + + diff --git a/commands/post-meta/delete/index.md b/commands/post-meta/delete/index.md new file mode 100644 index 00000000..04ca97df --- /dev/null +++ b/commands/post-meta/delete/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp post-meta delete' +--- + +`wp post-meta delete` - Delete a meta field. + + + diff --git a/commands/post-meta/get/index.md b/commands/post-meta/get/index.md new file mode 100644 index 00000000..a35a6072 --- /dev/null +++ b/commands/post-meta/get/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp post-meta get' +--- + +`wp post-meta get` - Get meta field value. + + + diff --git a/commands/post-meta/index.md b/commands/post-meta/index.md new file mode 100644 index 00000000..430e86a7 --- /dev/null +++ b/commands/post-meta/index.md @@ -0,0 +1,45 @@ +--- +layout: default +title: 'wp post-meta' +--- + +`wp post-meta` - Manage post custom fields. + +### OPTIONS + + --format=json + Encode/decode values as JSON. + +### EXAMPLES + + wp post-meta set 123 _wp_page_template about.php + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/post-meta/add">add</a></td> + <td>Add a meta field.</td> + </tr> + <tr> + <td><a href="/commands/post-meta/delete">delete</a></td> + <td>Delete a meta field.</td> + </tr> + <tr> + <td><a href="/commands/post-meta/get">get</a></td> + <td>Get meta field value.</td> + </tr> + <tr> + <td><a href="/commands/post-meta/update">update</a></td> + <td>Update a meta field.</td> + </tr> + </tbody> +</table> diff --git a/commands/post-meta/update/index.md b/commands/post-meta/update/index.md new file mode 100644 index 00000000..03e26c17 --- /dev/null +++ b/commands/post-meta/update/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp post-meta update' +--- + +`wp post-meta update` - Update a meta field. + + + diff --git a/commands/post/create/index.md b/commands/post/create/index.md new file mode 100644 index 00000000..9920ef90 --- /dev/null +++ b/commands/post/create/index.md @@ -0,0 +1,36 @@ +--- +layout: default +title: 'wp post create' +--- + +`wp post create` - Create a post. + +### OPTIONS + + <filename> + Read post content from <filename>. If this value is present, the + `--post_content` argument will be ignored. + + Passing `-` as the filename will cause post content to + be read from STDIN. + + --<field>=<value> + Field values for the new post. See wp_insert_post(). + + --edit + Immediately open system's editor to write or edit post content. + + (If content is read from a file, from STDIN, or from the `--post_content` + argument, that text will be loaded into the editor; otherwise, an empty + file will be opened.) + + --porcelain + Output just the new post id. + +### EXAMPLES + + wp post create --post_type=page --post_status=publish --post_title='A future post' --post-status=future --post_date='2020-12-01 07:00:00' + + wp post create page.txt --post_type=page --post_title='Page from file' + + diff --git a/commands/post/delete/index.md b/commands/post/delete/index.md new file mode 100644 index 00000000..a5adb821 --- /dev/null +++ b/commands/post/delete/index.md @@ -0,0 +1,22 @@ +--- +layout: default +title: 'wp post delete' +--- + +`wp post delete` - Delete a post by ID. + +### OPTIONS + + <ID> + The ID of the post to delete. + + --force + Skip the trash bin. + +### EXAMPLES + + wp post delete 123 --force + + wp post delete $(wp post list --post_type='page' --format=ids) + + diff --git a/commands/post/edit/index.md b/commands/post/edit/index.md new file mode 100644 index 00000000..b6d1ea67 --- /dev/null +++ b/commands/post/edit/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp post edit' +--- + +`wp post edit` - Launch system editor to edit post content. + +### OPTIONS + + <id> + The ID of the post to edit. + +### EXAMPLES + + wp post edit 123 + + diff --git a/commands/post/generate/index.md b/commands/post/generate/index.md new file mode 100644 index 00000000..b93d5b8c --- /dev/null +++ b/commands/post/generate/index.md @@ -0,0 +1,32 @@ +--- +layout: default +title: 'wp post generate' +--- + +`wp post generate` - Generate some posts. + +### OPTIONS + + --count=<number> + How many posts to generate. Default: 100 + + --post_type=<type> + The type of the generated posts. Default: 'post' + + --post_status=<status> + The status of the generated posts. Default: 'publish' + + --post_author=<login> + The author of the generated posts. Default: none + + --post_date=<yyyy-mm-dd> + The date of the generated posts. Default: current date + + --max_depth=<number> + For hierarchical post types, generate child posts down to a certain depth. Default: 1 + +### EXAMPLES + + wp post generate --count=10 --post_type=page --post_date=1999-01-04 + + diff --git a/commands/post/get/index.md b/commands/post/get/index.md new file mode 100644 index 00000000..806832fb --- /dev/null +++ b/commands/post/get/index.md @@ -0,0 +1,29 @@ +--- +layout: default +title: 'wp post get' +--- + +`wp post get` - Get a post's content by ID. + +### OPTIONS + + [--format=<format>] + The format to use when printing the post, acceptable values: + + **content**: Outputs only the post's content. + + **table**: Outputs all fields of the post as a table. Note that the + post_content field is omitted so that the table is readable. + + **json**: Outputs all fields in JSON format. + + <id> + The ID of the post to get. + +### EXAMPLES + + wp post get 12 --format=content + + wp post get 12 > file.txt + + diff --git a/commands/post/index.md b/commands/post/index.md new file mode 100644 index 00000000..a30139bd --- /dev/null +++ b/commands/post/index.md @@ -0,0 +1,49 @@ +--- +layout: default +title: 'wp post' +--- + +`wp post` - Manage posts. + + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/post/create">create</a></td> + <td>Create a post.</td> + </tr> + <tr> + <td><a href="/commands/post/delete">delete</a></td> + <td>Delete a post by ID.</td> + </tr> + <tr> + <td><a href="/commands/post/edit">edit</a></td> + <td>Launch system editor to edit post content.</td> + </tr> + <tr> + <td><a href="/commands/post/generate">generate</a></td> + <td>Generate some posts.</td> + </tr> + <tr> + <td><a href="/commands/post/get">get</a></td> + <td>Get a post's content by ID.</td> + </tr> + <tr> + <td><a href="/commands/post/list">list</a></td> + <td>Get a list of posts.</td> + </tr> + <tr> + <td><a href="/commands/post/update">update</a></td> + <td>Update one or more posts.</td> + </tr> + </tbody> +</table> diff --git a/commands/post/list/index.md b/commands/post/list/index.md new file mode 100644 index 00000000..4abe8401 --- /dev/null +++ b/commands/post/list/index.md @@ -0,0 +1,27 @@ +--- +layout: default +title: 'wp post list' +--- + +`wp post list` - Get a list of posts. + +### OPTIONS + + --<field>=<value> + One or more args to pass to WP_Query. + + --fields=<fields> + Limit the output to specific object fields. Defaults to ID,post_title,post_name,post_date,post_status. + + --format=<format> + Output list as table, CSV, JSON, or simply IDs. Defaults to table. + +### EXAMPLES + + wp post list --format=ids + + wp post list --post_type=post --posts_per_page=5 --format=json + + wp post list --post_type=page --fields=post_title,post_status + + diff --git a/commands/post/update/index.md b/commands/post/update/index.md new file mode 100644 index 00000000..661a96cd --- /dev/null +++ b/commands/post/update/index.md @@ -0,0 +1,20 @@ +--- +layout: default +title: 'wp post update' +--- + +`wp post update` - Update one or more posts. + +### OPTIONS + + <ID> + The ID of the post to update. + + --<field>=<value> + One or more fields to update. See wp_update_post(). + +### EXAMPLES + + wp post update 123 --post_name=something --post_status=draft + + diff --git a/commands/rewrite/dump/index.md b/commands/rewrite/dump/index.md new file mode 100644 index 00000000..417c8c3e --- /dev/null +++ b/commands/rewrite/dump/index.md @@ -0,0 +1,13 @@ +--- +layout: default +title: 'wp rewrite dump' +--- + +`wp rewrite dump` - Print current rewrite rules. + +### OPTIONS + + --format=json + Output rules in JSON format. + + diff --git a/commands/rewrite/flush/index.md b/commands/rewrite/flush/index.md new file mode 100644 index 00000000..fad2c806 --- /dev/null +++ b/commands/rewrite/flush/index.md @@ -0,0 +1,15 @@ +--- +layout: default +title: 'wp rewrite flush' +--- + +`wp rewrite flush` - Flush rewrite rules. + +### OPTIONS + + --soft + Perform a soft flush - do not overwrite `.htaccess`. The default is to update + `.htaccess` rules as well as rewrite rules in database. + + + diff --git a/commands/rewrite/index.md b/commands/rewrite/index.md new file mode 100644 index 00000000..b538ee1b --- /dev/null +++ b/commands/rewrite/index.md @@ -0,0 +1,33 @@ +--- +layout: default +title: 'wp rewrite' +--- + +`wp rewrite` - Manage rewrite rules. + + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/rewrite/dump">dump</a></td> + <td>Print current rewrite rules.</td> + </tr> + <tr> + <td><a href="/commands/rewrite/flush">flush</a></td> + <td>Flush rewrite rules.</td> + </tr> + <tr> + <td><a href="/commands/rewrite/structure">structure</a></td> + <td>Update the permalink structure.</td> + </tr> + </tbody> +</table> diff --git a/commands/rewrite/structure/index.md b/commands/rewrite/structure/index.md new file mode 100644 index 00000000..4e6d37c2 --- /dev/null +++ b/commands/rewrite/structure/index.md @@ -0,0 +1,21 @@ +--- +layout: default +title: 'wp rewrite structure' +--- + +`wp rewrite structure` - Update the permalink structure. + +### OPTIONS + +* <permastruct>: + + The new permalink structure to apply; like "/%year%/%monthnum%/%postname%". + + --category-base=<categorybase> + Set the base for category permalinks, ie '/category/'. + + --tag-base=<tagbase> + Set the base for tag permalinks, ie '/tag/'. + + + diff --git a/commands/role/create/index.md b/commands/role/create/index.md new file mode 100644 index 00000000..3f724d3b --- /dev/null +++ b/commands/role/create/index.md @@ -0,0 +1,24 @@ +--- +layout: default +title: 'wp role create' +--- + +`wp role create` - Create a new role. + +### OPTIONS + +* <role-key>: + + The internal name of the role, e.g. editor + +* <role-name>: + + The publically visible name of the role, e.g. Editor + +### EXAMPLES + + wp role create approver Approver + + wp role create productadmin "Product Administrator" + + diff --git a/commands/role/delete/index.md b/commands/role/delete/index.md new file mode 100644 index 00000000..c2dcc0a5 --- /dev/null +++ b/commands/role/delete/index.md @@ -0,0 +1,21 @@ +--- +layout: default +title: 'wp role delete' +--- + +`wp role delete` - Delete an existing role. + +### OPTIONS + +* <role-key>: + + The internal name of the role, e.g. editor + +### EXAMPLES + + wp role delete approver + + wp role delete productadmin + + + diff --git a/commands/role/exists/index.md b/commands/role/exists/index.md new file mode 100644 index 00000000..6a3375fc --- /dev/null +++ b/commands/role/exists/index.md @@ -0,0 +1,25 @@ +--- +layout: default +title: 'wp role exists' +--- + +`wp role exists` - Check if a role exists. + +### OPTIONS + +* <role-key>: + + The internal name of the role, e.g. editor + + +##DESCRIPTION + +Will exit with status 0 if the role exists, 1 if it does not. + + +### EXAMPLES + + wp role exists editor + + + diff --git a/commands/role/index.md b/commands/role/index.md new file mode 100644 index 00000000..628eb4de --- /dev/null +++ b/commands/role/index.md @@ -0,0 +1,37 @@ +--- +layout: default +title: 'wp role' +--- + +`wp role` - Manage user roles. + + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/role/create">create</a></td> + <td>Create a new role.</td> + </tr> + <tr> + <td><a href="/commands/role/delete">delete</a></td> + <td>Delete an existing role.</td> + </tr> + <tr> + <td><a href="/commands/role/exists">exists</a></td> + <td>Check if a role exists.</td> + </tr> + <tr> + <td><a href="/commands/role/list">list</a></td> + <td>List all roles.</td> + </tr> + </tbody> +</table> diff --git a/commands/role/list/index.md b/commands/role/list/index.md new file mode 100644 index 00000000..720277e8 --- /dev/null +++ b/commands/role/list/index.md @@ -0,0 +1,20 @@ +--- +layout: default +title: 'wp role list' +--- + +`wp role list` - List all roles. + +### OPTIONS + + --fields=<fields> + Limit the output to specific object fields. Defaults to name,role. + + --format=<format> + Output list as table, CSV or JSON. Defaults to table. + +### EXAMPLES + + wp role list --fields=role --format=csv + + diff --git a/commands/scaffold/_s/index.md b/commands/scaffold/_s/index.md new file mode 100644 index 00000000..a57fab78 --- /dev/null +++ b/commands/scaffold/_s/index.md @@ -0,0 +1,25 @@ +--- +layout: default +title: 'wp scaffold _s' +--- + +`wp scaffold _s` - Generate starter code for a theme. + +### OPTIONS + +* <slug>: + + The slug for the new theme, used for prefixing functions. + + --activate + Activate the newly downloaded theme. + + --theme_name=<title> + What to put in the 'Theme Name:' header in style.css + + --author=<full name> + What to put in the 'Author:' header in style.css + + --author_uri=<http url> + What to put in the 'Author URI:' header in style.css + diff --git a/commands/scaffold/child-theme/index.md b/commands/scaffold/child-theme/index.md new file mode 100644 index 00000000..718460fa --- /dev/null +++ b/commands/scaffold/child-theme/index.md @@ -0,0 +1,32 @@ +--- +layout: default +title: 'wp scaffold child-theme' +--- + +`wp scaffold child-theme` - Generate empty child theme. + +### OPTIONS + +* <slug>: + + The slug for the new child theme. + + --parent_theme=<slug> + What to put in the 'Template:' header in style.css + + --theme_name=<title> + What to put in the 'Theme Name:' header in style.css + + --author=<full name> + What to put in the 'Author:' header in style.css + + --author_uri=<http url> + What to put in the 'Author URI:' header in style.css + + --theme_uri=<http url> + What to put in the 'Theme URI:' header in style.css + + --activate + Activate the newly created child theme. + + diff --git a/commands/scaffold/index.md b/commands/scaffold/index.md new file mode 100644 index 00000000..1f9f175f --- /dev/null +++ b/commands/scaffold/index.md @@ -0,0 +1,45 @@ +--- +layout: default +title: 'wp scaffold' +--- + +`wp scaffold` - Generate code for post types, taxonomies, etc. + + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/scaffold/_s">_s</a></td> + <td>Generate starter code for a theme.</td> + </tr> + <tr> + <td><a href="/commands/scaffold/child-theme">child-theme</a></td> + <td>Generate empty child theme.</td> + </tr> + <tr> + <td><a href="/commands/scaffold/plugin">plugin</a></td> + <td>Generate starter code for a plugin.</td> + </tr> + <tr> + <td><a href="/commands/scaffold/plugin-tests">plugin-tests</a></td> + <td>Generate files needed for running PHPUnit tests.</td> + </tr> + <tr> + <td><a href="/commands/scaffold/post-type">post-type</a></td> + <td>Generate PHP code for registering a custom post type.</td> + </tr> + <tr> + <td><a href="/commands/scaffold/taxonomy">taxonomy</a></td> + <td>Generate PHP code for registering a custom taxonomy.</td> + </tr> + </tbody> +</table> diff --git a/commands/scaffold/plugin-tests/index.md b/commands/scaffold/plugin-tests/index.md new file mode 100644 index 00000000..e67d2e61 --- /dev/null +++ b/commands/scaffold/plugin-tests/index.md @@ -0,0 +1,26 @@ +--- +layout: default +title: 'wp scaffold plugin-tests' +--- + +`wp scaffold plugin-tests` - Generate files needed for running PHPUnit tests. + +### DESCRIPTION + +These are the files that are generated: + +* `phpunit.xml` is the configuration file for PHPUnit +* `.travis.yml` is the configuration file for Travis CI +* `tests/bootstrap.php` is the file that makes the current plugin active when running the test suite +* `tests/test-sample.php` is a sample file containing the actual tests + +### ENVIRONMENT + +The `tests/bootstrap.php` file looks for the WP_TESTS_DIR environment +variable. + +### EXAMPLE + + wp scaffold plugin-tests hello + + diff --git a/commands/scaffold/plugin/index.md b/commands/scaffold/plugin/index.md new file mode 100644 index 00000000..a863ef83 --- /dev/null +++ b/commands/scaffold/plugin/index.md @@ -0,0 +1,16 @@ +--- +layout: default +title: 'wp scaffold plugin' +--- + +`wp scaffold plugin` - Generate starter code for a plugin. + +### OPTIONS + + --activate + Activate the newly generated plugin. + + --plugin_name=<title> + What to put in the 'Plugin Name:' header + + diff --git a/commands/scaffold/post-type/index.md b/commands/scaffold/post-type/index.md new file mode 100644 index 00000000..035323a5 --- /dev/null +++ b/commands/scaffold/post-type/index.md @@ -0,0 +1,27 @@ +--- +layout: default +title: 'wp scaffold post-type' +--- + +`wp scaffold post-type` - Generate PHP code for registering a custom post type. + +### OPTIONS + + --label=<label> + The text used to translate the update messages + + --textdomain=<textdomain> + The textdomain to use for the labels. + + --theme + Create a file in the current theme directory, instead of sending to +STDOUT. + + --plugin=<plugin> + Create a file in the given plugin's directory, instead of sending to +STDOUT. + + --raw + Just generate the `register_post_type()` call and nothing else. + + diff --git a/commands/scaffold/taxonomy/index.md b/commands/scaffold/taxonomy/index.md new file mode 100644 index 00000000..856fd0fe --- /dev/null +++ b/commands/scaffold/taxonomy/index.md @@ -0,0 +1,34 @@ +--- +layout: default +title: 'wp scaffold taxonomy' +--- + +`wp scaffold taxonomy` - Generate PHP code for registering a custom taxonomy. + +### OPTIONS + + --post_types=<post_types> + Post types to register for use with the taxonomy. + + --label=<label> + The text used to translate the update messages + + --textdomain=<textdomain> + The textdomain to use for the labels. + + --theme + Create a file in the current theme directory, instead of sending to +STDOUT. + + --plugin=<plugin> + Create a file in the given plugin's directory, instead of sending to +STDOUT. + + --raw + Just generate the `register_taxonomy()` call and nothing else. + +### EXAMPLES + + wp scaffold taxonomy venue --post_types=event,presentation + + diff --git a/commands/search-replace/index.md b/commands/search-replace/index.md new file mode 100644 index 00000000..9276615f --- /dev/null +++ b/commands/search-replace/index.md @@ -0,0 +1,31 @@ +--- +layout: default +title: 'wp search-replace' +--- + +`wp search-replace` - Search/replace strings in the database. + +### DESCRIPTION + +This command will go through all rows in all tables and will replace all appearances of the old string with the new one. + +It will correctly handle serialized values, and will not change primary key values. + +### OPTIONS + + --network + Search/replace through all the tables in a multisite install. + + --skip-columns=<columns> + Do not perform the replacement in the comma-separated columns. + + --dry-run + Show report, but don't perform the changes. + +### EXAMPLES + + wp search-replace 'http://example.dev' 'http://example.com' --skip-columns=guid + + wp search-replace 'foo' 'bar' wp_posts wp_postmeta wp_terms --dry-run + + diff --git a/commands/shell/index.md b/commands/shell/index.md new file mode 100644 index 00000000..1582d694 --- /dev/null +++ b/commands/shell/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp shell' +--- + +`wp shell` - Interactive PHP console. + +### DESCRIPTION + +`wp shell` allows you to evaluate PHP statements and expressions interactively, from within a WordPress environment. This means that you have access to all the functions, classes and globals that you would have access to from inside a WordPress plugin, for example. + +### OPTIONS + + --basic + Start in fail-safe mode, even if Boris is available. + + diff --git a/commands/term/create/index.md b/commands/term/create/index.md new file mode 100644 index 00000000..f7f5ae31 --- /dev/null +++ b/commands/term/create/index.md @@ -0,0 +1,32 @@ +--- +layout: default +title: 'wp term create' +--- + +`wp term create` - Create a term. + +### OPTIONS + + <term> + A name for the new term. + + <taxonomy> + Taxonomy for the new term. + + --slug=<slug> + A unique slug for the new term. Defaults to sanitized version of name. + + --description=<description> + A description for the new term. + + --parent=<term-id> + A parent for the new term. + + --porcelain + Output just the new term id. + +### EXAMPLES + + wp term create Apple category --description="A type of fruit" + + diff --git a/commands/term/delete/index.md b/commands/term/delete/index.md new file mode 100644 index 00000000..bcbee301 --- /dev/null +++ b/commands/term/delete/index.md @@ -0,0 +1,19 @@ +--- +layout: default +title: 'wp term delete' +--- + +`wp term delete` - Delete a term. + +### OPTIONS + + <term-id> + ID for the term to delete. + + <taxonomy> + Taxonomy of the term to delete. + +### EXAMPLES + + wp term delete 15 category + diff --git a/commands/term/index.md b/commands/term/index.md new file mode 100644 index 00000000..0cd27a28 --- /dev/null +++ b/commands/term/index.md @@ -0,0 +1,37 @@ +--- +layout: default +title: 'wp term' +--- + +`wp term` - Manage terms. + + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/term/create">create</a></td> + <td>Create a term.</td> + </tr> + <tr> + <td><a href="/commands/term/delete">delete</a></td> + <td>Delete a term.</td> + </tr> + <tr> + <td><a href="/commands/term/list">list</a></td> + <td>List terms in a taxonomy.</td> + </tr> + <tr> + <td><a href="/commands/term/update">update</a></td> + <td>Update a term.</td> + </tr> + </tbody> +</table> diff --git a/commands/term/list/index.md b/commands/term/list/index.md new file mode 100644 index 00000000..0292dd84 --- /dev/null +++ b/commands/term/list/index.md @@ -0,0 +1,25 @@ +--- +layout: default +title: 'wp term list' +--- + +`wp term list` - List terms in a taxonomy. + +### OPTIONS + + <taxonomy> + List terms of a given taxonomy. + + --fields=<fields> + Limit the output to specific object fields. Defaults to all of the term object fields. + + --format=<format> + Output list as table, CSV, JSON, or simply IDs. Defaults to table. + +### EXAMPLES + + wp term list category --format=csv + + wp term list post_tag --fields=name,slug + + diff --git a/commands/term/update/index.md b/commands/term/update/index.md new file mode 100644 index 00000000..1cb306eb --- /dev/null +++ b/commands/term/update/index.md @@ -0,0 +1,32 @@ +--- +layout: default +title: 'wp term update' +--- + +`wp term update` - Update a term. + +### OPTIONS + + <term-id> + ID for the term to update. + + <taxonomy> + Taxonomy of the term to update. + + --name=<name> + A new name for the term. + + --slug=<slug> + A new slug for the term. + + --description=<description> + A new description for the term. + + --parent=<term-id> + A new parent for the term. + +### EXAMPLES + + wp term update 15 category --name=Apple + + diff --git a/commands/theme/activate/index.md b/commands/theme/activate/index.md new file mode 100644 index 00000000..f57fec24 --- /dev/null +++ b/commands/theme/activate/index.md @@ -0,0 +1,13 @@ +--- +layout: default +title: 'wp theme activate' +--- + +`wp theme activate` - Activate a theme. + +### OPTIONS + + <theme> + The theme to activate. + + diff --git a/commands/theme/delete/index.md b/commands/theme/delete/index.md new file mode 100644 index 00000000..85dff142 --- /dev/null +++ b/commands/theme/delete/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp theme delete' +--- + +`wp theme delete` - Delete a theme. + +### OPTIONS + + <theme> + The theme to delete. + +### EXAMPLES + + wp theme delete twentyeleven + + diff --git a/commands/theme/index.md b/commands/theme/index.md new file mode 100644 index 00000000..7f62fcdf --- /dev/null +++ b/commands/theme/index.md @@ -0,0 +1,53 @@ +--- +layout: default +title: 'wp theme' +--- + +`wp theme` - Manage themes. + + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/theme/activate">activate</a></td> + <td>Activate a theme.</td> + </tr> + <tr> + <td><a href="/commands/theme/delete">delete</a></td> + <td>Delete a theme.</td> + </tr> + <tr> + <td><a href="/commands/theme/install">install</a></td> + <td>Install a theme.</td> + </tr> + <tr> + <td><a href="/commands/theme/list">list</a></td> + <td>Get a list of themes.</td> + </tr> + <tr> + <td><a href="/commands/theme/path">path</a></td> + <td>Get the path to a theme or to the theme directory.</td> + </tr> + <tr> + <td><a href="/commands/theme/status">status</a></td> + <td>See the status of one or all themes.</td> + </tr> + <tr> + <td><a href="/commands/theme/update">update</a></td> + <td>Update a theme.</td> + </tr> + <tr> + <td><a href="/commands/theme/update-all">update-all</a></td> + <td>Update all themes.</td> + </tr> + </tbody> +</table> diff --git a/commands/theme/install/index.md b/commands/theme/install/index.md new file mode 100644 index 00000000..20cec17f --- /dev/null +++ b/commands/theme/install/index.md @@ -0,0 +1,22 @@ +--- +layout: default +title: 'wp theme install' +--- + +`wp theme install` - Install a theme. + +### OPTIONS + + <theme> + A theme slug or the path to a zip file. + + --activate + If set, the theme will be activated immediately after install. + +### EXAMPLES + + wp theme install twentytwelve --activate + + wp theme install ../my-theme.zip + + diff --git a/commands/theme/list/index.md b/commands/theme/list/index.md new file mode 100644 index 00000000..40816044 --- /dev/null +++ b/commands/theme/list/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp theme list' +--- + +`wp theme list` - Get a list of themes. + +### OPTIONS + + --format=<format> + Output list as table, CSV or JSON. Defaults to table. + +### EXAMPLES + + wp theme list --format=csv + + diff --git a/commands/theme/path/index.md b/commands/theme/path/index.md new file mode 100644 index 00000000..6308fd9b --- /dev/null +++ b/commands/theme/path/index.md @@ -0,0 +1,22 @@ +--- +layout: default +title: 'wp theme path' +--- + +`wp theme path` - Get the path to a theme or to the theme directory. + +### OPTIONS + + <theme> + The theme to get the path to. If not set, will return the path to the +themes directory. + + --dir + If set, get the path to the closest parent directory, instead of the +theme file. + +### EXAMPLES + + cd $(wp theme path) + + diff --git a/commands/theme/status/index.md b/commands/theme/status/index.md new file mode 100644 index 00000000..be030faf --- /dev/null +++ b/commands/theme/status/index.md @@ -0,0 +1,13 @@ +--- +layout: default +title: 'wp theme status' +--- + +`wp theme status` - See the status of one or all themes. + +### OPTIONS + + <theme> + A particular theme to show the status for. + + diff --git a/commands/theme/update-all/index.md b/commands/theme/update-all/index.md new file mode 100644 index 00000000..73bff567 --- /dev/null +++ b/commands/theme/update-all/index.md @@ -0,0 +1,17 @@ +--- +layout: default +title: 'wp theme update-all' +--- + +`wp theme update-all` - Update all themes. + +### OPTIONS + + --dry-run + Pretend to do the updates, to see what would happen. + +### EXAMPLES + + wp theme update-all + + diff --git a/commands/theme/update/index.md b/commands/theme/update/index.md new file mode 100644 index 00000000..efa5b344 --- /dev/null +++ b/commands/theme/update/index.md @@ -0,0 +1,21 @@ +--- +layout: default +title: 'wp theme update' +--- + +`wp theme update` - Update a theme. + +### OPTIONS + + <theme> + The theme to update. + + --version=dev + If set, the theme will be updated to the latest development version, +regardless of what version is currently installed. + +### EXAMPLES + + wp theme update twentytwelve + + diff --git a/commands/transient/delete/index.md b/commands/transient/delete/index.md new file mode 100644 index 00000000..7a96fa5a --- /dev/null +++ b/commands/transient/delete/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp transient delete' +--- + +`wp transient delete` - Delete a transient value. + + + diff --git a/commands/transient/get/index.md b/commands/transient/get/index.md new file mode 100644 index 00000000..2cfa2ec1 --- /dev/null +++ b/commands/transient/get/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp transient get' +--- + +`wp transient get` - Get a transient value. + + + diff --git a/commands/transient/index.md b/commands/transient/index.md new file mode 100644 index 00000000..ff8b511b --- /dev/null +++ b/commands/transient/index.md @@ -0,0 +1,40 @@ +--- +layout: default +title: 'wp transient' +--- + +`wp transient` - Manage WordPress transients. + +### EXAMPLES + + wp transient set my_key my_value 300 + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/transient/delete">delete</a></td> + <td>Delete a transient value.</td> + </tr> + <tr> + <td><a href="/commands/transient/get">get</a></td> + <td>Get a transient value.</td> + </tr> + <tr> + <td><a href="/commands/transient/set">set</a></td> + <td>Set a transient value. <expiration> is the time until expiration, in seconds.</td> + </tr> + <tr> + <td><a href="/commands/transient/type">type</a></td> + <td>See wether the transients API is using an object cache or the options table.</td> + </tr> + </tbody> +</table> diff --git a/commands/transient/set/index.md b/commands/transient/set/index.md new file mode 100644 index 00000000..4b2f5df0 --- /dev/null +++ b/commands/transient/set/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp transient set' +--- + +`wp transient set` - Set a transient value. <expiration> is the time until expiration, in seconds. + + + diff --git a/commands/transient/type/index.md b/commands/transient/type/index.md new file mode 100644 index 00000000..08faf848 --- /dev/null +++ b/commands/transient/type/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp transient type' +--- + +`wp transient type` - See wether the transients API is using an object cache or the options table. + + + diff --git a/commands/user-meta/add/index.md b/commands/user-meta/add/index.md new file mode 100644 index 00000000..01e80205 --- /dev/null +++ b/commands/user-meta/add/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp user-meta add' +--- + +`wp user-meta add` - Add a meta field. + + + diff --git a/commands/user-meta/delete/index.md b/commands/user-meta/delete/index.md new file mode 100644 index 00000000..0f5f2ee1 --- /dev/null +++ b/commands/user-meta/delete/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp user-meta delete' +--- + +`wp user-meta delete` - Delete a meta field. + + + diff --git a/commands/user-meta/get/index.md b/commands/user-meta/get/index.md new file mode 100644 index 00000000..67163631 --- /dev/null +++ b/commands/user-meta/get/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp user-meta get' +--- + +`wp user-meta get` - Get meta field value. + + + diff --git a/commands/user-meta/index.md b/commands/user-meta/index.md new file mode 100644 index 00000000..c7d49a18 --- /dev/null +++ b/commands/user-meta/index.md @@ -0,0 +1,45 @@ +--- +layout: default +title: 'wp user-meta' +--- + +`wp user-meta` - Manage user custom fields. + +### OPTIONS + + --format=json + Encode/decode values as JSON. + +### EXAMPLES + + wp user-meta set 123 description "Mary is a WordPress developer." + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/user-meta/add">add</a></td> + <td>Add a meta field.</td> + </tr> + <tr> + <td><a href="/commands/user-meta/delete">delete</a></td> + <td>Delete a meta field.</td> + </tr> + <tr> + <td><a href="/commands/user-meta/get">get</a></td> + <td>Get meta field value.</td> + </tr> + <tr> + <td><a href="/commands/user-meta/update">update</a></td> + <td>Update a meta field.</td> + </tr> + </tbody> +</table> diff --git a/commands/user-meta/update/index.md b/commands/user-meta/update/index.md new file mode 100644 index 00000000..f51dc10c --- /dev/null +++ b/commands/user-meta/update/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp user-meta update' +--- + +`wp user-meta update` - Update a meta field. + + + diff --git a/commands/user/add-role/index.md b/commands/user/add-role/index.md new file mode 100644 index 00000000..52391398 --- /dev/null +++ b/commands/user/add-role/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp user add-role' +--- + +`wp user add-role` - Add a role for a user. + + + diff --git a/commands/user/create/index.md b/commands/user/create/index.md new file mode 100644 index 00000000..b1ab1209 --- /dev/null +++ b/commands/user/create/index.md @@ -0,0 +1,35 @@ +--- +layout: default +title: 'wp user create' +--- + +`wp user create` - Create a user. + +### OPTIONS + + <user-login> + The login of the user to create. + + <user-email> + The email address of the user to create. + + --role=<role> + The role of the user to create. Default: default role + + --user_pass=<password> + The user password. Default: randomly generated + + --user_registered=<yyyy-mm-dd> + The date the user registered. Default: current date + + --display_name=<name> + The display name. + + --porcelain + Output just the new user id. + +### EXAMPLES + + wp user create bob bob@example.com --role=author + + diff --git a/commands/user/delete/index.md b/commands/user/delete/index.md new file mode 100644 index 00000000..e0a002e1 --- /dev/null +++ b/commands/user/delete/index.md @@ -0,0 +1,20 @@ +--- +layout: default +title: 'wp user delete' +--- + +`wp user delete` - Delete one or more users. + +### OPTIONS + + <ID> + The ID of the user to delete. + + --reassign=<ID> + User to reassign the posts to. + +### EXAMPLES + + wp user delete 123 --reassign=567 + + diff --git a/commands/user/generate/index.md b/commands/user/generate/index.md new file mode 100644 index 00000000..5aa6c21c --- /dev/null +++ b/commands/user/generate/index.md @@ -0,0 +1,16 @@ +--- +layout: default +title: 'wp user generate' +--- + +`wp user generate` - Generate users. + +### OPTIONS + + --count=<number> + How many users to generate. Default: 100 + + --role=<role> + The role of the generated users. Default: default role from WP + + diff --git a/commands/user/import-csv/index.md b/commands/user/import-csv/index.md new file mode 100644 index 00000000..7f019adb --- /dev/null +++ b/commands/user/import-csv/index.md @@ -0,0 +1,24 @@ +--- +layout: default +title: 'wp user import-csv' +--- + +`wp user import-csv` - Import users from a CSV file. + +### OPTIONS + + <file> + The CSV file of users to import. + +### EXAMPLES + + wp user import-csv /path/to/users.csv + + Sample users.csv file: + + user_login,user_email,display_name,role + bobjones,bobjones@domain.com,Bob Jones,contributor + newuser1,newuser1@domain.com,New User,author + existinguser,existinguser@domain.com,Existing User,administrator + + diff --git a/commands/user/index.md b/commands/user/index.md new file mode 100644 index 00000000..703c1a88 --- /dev/null +++ b/commands/user/index.md @@ -0,0 +1,57 @@ +--- +layout: default +title: 'wp user' +--- + +`wp user` - Manage users. + + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/user/add-role">add-role</a></td> + <td>Add a role for a user.</td> + </tr> + <tr> + <td><a href="/commands/user/create">create</a></td> + <td>Create a user.</td> + </tr> + <tr> + <td><a href="/commands/user/delete">delete</a></td> + <td>Delete one or more users.</td> + </tr> + <tr> + <td><a href="/commands/user/generate">generate</a></td> + <td>Generate users.</td> + </tr> + <tr> + <td><a href="/commands/user/import-csv">import-csv</a></td> + <td>Import users from a CSV file.</td> + </tr> + <tr> + <td><a href="/commands/user/list">list</a></td> + <td>List users.</td> + </tr> + <tr> + <td><a href="/commands/user/remove-role">remove-role</a></td> + <td>Remove a user's role.</td> + </tr> + <tr> + <td><a href="/commands/user/set-role">set-role</a></td> + <td>Set the user role (for a particular blog).</td> + </tr> + <tr> + <td><a href="/commands/user/update">update</a></td> + <td>Update a user.</td> + </tr> + </tbody> +</table> diff --git a/commands/user/list/index.md b/commands/user/list/index.md new file mode 100644 index 00000000..b3678bce --- /dev/null +++ b/commands/user/list/index.md @@ -0,0 +1,27 @@ +--- +layout: default +title: 'wp user list' +--- + +`wp user list` - List users. + +### OPTIONS + + --role=<role> + Only display users with a certain role. + + --fields=<fields> + Limit the output to specific object fields. Defaults to ID,user_login,display_name,user_email,user_registered,roles + + --format=<format> + Output list as table, CSV, JSON, or simply IDs. Defaults to table. + +### EXAMPLES + + wp user list --format=ids + + wp user list --role=administrator --format=csv + + wp user list --fields=display_name,user_email + + diff --git a/commands/user/remove-role/index.md b/commands/user/remove-role/index.md new file mode 100644 index 00000000..77d3d66a --- /dev/null +++ b/commands/user/remove-role/index.md @@ -0,0 +1,18 @@ +--- +layout: default +title: 'wp user remove-role' +--- + +`wp user remove-role` - Remove a user's role. + +### OPTIONS + + <user-login> + User ID or user login. + +### EXAMPLES + + wp user remove-role bob + wp user remove-role 12 + + diff --git a/commands/user/set-role/index.md b/commands/user/set-role/index.md new file mode 100644 index 00000000..c876970b --- /dev/null +++ b/commands/user/set-role/index.md @@ -0,0 +1,21 @@ +--- +layout: default +title: 'wp user set-role' +--- + +`wp user set-role` - Set the user role (for a particular blog). + +### OPTIONS + + <user-login> + User ID or user login. + + [<role>] + Add the user with the specified role. Defaults to blog default. + +### EXAMPLES + + wp user set-role bob author + wp user set-role 12 author + + diff --git a/commands/user/update/index.md b/commands/user/update/index.md new file mode 100644 index 00000000..24ab278b --- /dev/null +++ b/commands/user/update/index.md @@ -0,0 +1,20 @@ +--- +layout: default +title: 'wp user update' +--- + +`wp user update` - Update a user. + +### OPTIONS + + <ID> + The ID of the user to update. + + --<field>=<value> + One or more fields to update. For accepted fields, see wp_update_user(). + +### EXAMPLES + + wp user update 123 --user_login=mary --display_name=Mary + + From efdb8299b1c730aaf9cb101bdf6586dabc38e988 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Wed, 24 Jul 2013 16:13:27 +0300 Subject: [PATCH 173/194] remove unnecessary --path from invoke_wp_cli() --- Phakefile.php | 2 -- 1 file changed, 2 deletions(-) diff --git a/Phakefile.php b/Phakefile.php index 2fe0fbb1..bfb1d425 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -2,8 +2,6 @@ require __DIR__ . '/vendor/autoload.php'; function invoke_wp_cli( $cmd, $app ) { - $cmd .= ' --path=' . escapeshellarg( $app['path'] ); - ob_start(); system( $cmd, $return_code ); $json = ob_get_clean(); From ab62fe0b48b599fcfbc84979d2673967e30a2816 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Sat, 20 Jul 2013 23:07:49 +0300 Subject: [PATCH 174/194] use new `wp cli` command --- Phakefile.php | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Phakefile.php b/Phakefile.php index bfb1d425..782a4264 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -34,7 +34,7 @@ function generate_synopsis( $command, $path = '' ) { } } - generate_synopsis( invoke_wp_cli( 'wp --cmd-dump', $app ) ); + generate_synopsis( invoke_wp_cli( 'wp cli cmd-dump', $app ) ); }); function gen_cmd_pages( $wp_cli_path, $cmd, $parent = array() ) { @@ -67,7 +67,7 @@ function gen_cmd_pages( $wp_cli_path, $cmd, $parent = array() ) { desc( 'Update the /commands/ page.' ); task( 'cmd-list', function( $app ) { - $wp = invoke_wp_cli( 'wp --cmd-dump', $app ); + $wp = invoke_wp_cli( 'wp cli cmd-dump', $app ); // generate main page file_put_contents( '_includes/cmd-list.html', render( 'cmd-list.mustache', $wp ) ); @@ -81,7 +81,7 @@ function gen_cmd_pages( $wp_cli_path, $cmd, $parent = array() ) { desc( 'Update the /config/ page.' ); task( 'param-list', function( $app ) { - $config_spec = invoke_wp_cli( 'wp --param-dump', $app ); + $config_spec = invoke_wp_cli( 'wp cli param-dump', $app ); $out = ''; From 3168af2ea615de851e44ebc318753b1ba3dd1508 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Thu, 25 Jul 2013 14:57:38 +0300 Subject: [PATCH 175/194] add trailing slash for command URLs; fixes wp-cli/wp-cli#609 --- _templates/subcmd-list.mustache | 2 +- commands/blog/index.md | 6 +++--- commands/cache/index.md | 18 +++++++++--------- commands/cap/index.md | 6 +++--- commands/comment/index.md | 22 +++++++++++----------- commands/core/index.md | 18 +++++++++--------- commands/db/index.md | 18 +++++++++--------- commands/media/index.md | 4 ++-- commands/option/index.md | 8 ++++---- commands/plugin/index.md | 22 +++++++++++----------- commands/post-meta/index.md | 8 ++++---- commands/post/index.md | 14 +++++++------- commands/rewrite/index.md | 6 +++--- commands/role/index.md | 8 ++++---- commands/scaffold/index.md | 12 ++++++------ commands/term/index.md | 8 ++++---- commands/theme/index.md | 16 ++++++++-------- commands/transient/index.md | 8 ++++---- commands/user-meta/index.md | 8 ++++---- commands/user/index.md | 18 +++++++++--------- 20 files changed, 115 insertions(+), 115 deletions(-) diff --git a/_templates/subcmd-list.mustache b/_templates/subcmd-list.mustache index d051a272..92a1d969 100644 --- a/_templates/subcmd-list.mustache +++ b/_templates/subcmd-list.mustache @@ -20,7 +20,7 @@ title: 'wp {{synopsis}}' <tbody> {{#subcommands}} <tr> - <td><a href="/commands/{{path}}/{{name}}">{{name}}</a></td> + <td><a href="/commands/{{path}}/{{name}}/">{{name}}</a></td> <td>{{description}}</td> </tr> {{/subcommands}} diff --git a/commands/blog/index.md b/commands/blog/index.md index efb060bf..e36fc616 100644 --- a/commands/blog/index.md +++ b/commands/blog/index.md @@ -18,15 +18,15 @@ title: 'wp blog' </thead> <tbody> <tr> - <td><a href="/commands/blog/create">create</a></td> + <td><a href="/commands/blog/create/">create</a></td> <td>Create a blog in a multisite install.</td> </tr> <tr> - <td><a href="/commands/blog/delete">delete</a></td> + <td><a href="/commands/blog/delete/">delete</a></td> <td>Delete a blog in a multisite install.</td> </tr> <tr> - <td><a href="/commands/blog/empty">empty</a></td> + <td><a href="/commands/blog/empty/">empty</a></td> <td>Empty a blog of its content.</td> </tr> </tbody> diff --git a/commands/cache/index.md b/commands/cache/index.md index 4599ae37..d0690f91 100644 --- a/commands/cache/index.md +++ b/commands/cache/index.md @@ -23,39 +23,39 @@ title: 'wp cache' </thead> <tbody> <tr> - <td><a href="/commands/cache/add">add</a></td> + <td><a href="/commands/cache/add/">add</a></td> <td>Add a value to the object cache.</td> </tr> <tr> - <td><a href="/commands/cache/decr">decr</a></td> + <td><a href="/commands/cache/decr/">decr</a></td> <td>Decrement a value in the object cache.</td> </tr> <tr> - <td><a href="/commands/cache/delete">delete</a></td> + <td><a href="/commands/cache/delete/">delete</a></td> <td>Remove a value from the object cache.</td> </tr> <tr> - <td><a href="/commands/cache/flush">flush</a></td> + <td><a href="/commands/cache/flush/">flush</a></td> <td>Flush the object cache.</td> </tr> <tr> - <td><a href="/commands/cache/get">get</a></td> + <td><a href="/commands/cache/get/">get</a></td> <td>Get a value from the object cache.</td> </tr> <tr> - <td><a href="/commands/cache/incr">incr</a></td> + <td><a href="/commands/cache/incr/">incr</a></td> <td>Increment a value in the object cache.</td> </tr> <tr> - <td><a href="/commands/cache/replace">replace</a></td> + <td><a href="/commands/cache/replace/">replace</a></td> <td>Replace an existing value in the object cache.</td> </tr> <tr> - <td><a href="/commands/cache/set">set</a></td> + <td><a href="/commands/cache/set/">set</a></td> <td>Set a value to the object cache.</td> </tr> <tr> - <td><a href="/commands/cache/type">type</a></td> + <td><a href="/commands/cache/type/">type</a></td> <td>Attempts to determine which object cache is being used.</td> </tr> </tbody> diff --git a/commands/cap/index.md b/commands/cap/index.md index 7e69b337..2563c823 100644 --- a/commands/cap/index.md +++ b/commands/cap/index.md @@ -28,15 +28,15 @@ title: 'wp cap' </thead> <tbody> <tr> - <td><a href="/commands/cap/add">add</a></td> + <td><a href="/commands/cap/add/">add</a></td> <td>Add capabilities to a given role.</td> </tr> <tr> - <td><a href="/commands/cap/list">list</a></td> + <td><a href="/commands/cap/list/">list</a></td> <td>List capabilities for a given role.</td> </tr> <tr> - <td><a href="/commands/cap/remove">remove</a></td> + <td><a href="/commands/cap/remove/">remove</a></td> <td>Remove capabilities from a given role.</td> </tr> </tbody> diff --git a/commands/comment/index.md b/commands/comment/index.md index 112f3c56..7cd6183c 100644 --- a/commands/comment/index.md +++ b/commands/comment/index.md @@ -18,47 +18,47 @@ title: 'wp comment' </thead> <tbody> <tr> - <td><a href="/commands/comment/approve">approve</a></td> + <td><a href="/commands/comment/approve/">approve</a></td> <td>Approve a comment.</td> </tr> <tr> - <td><a href="/commands/comment/count">count</a></td> + <td><a href="/commands/comment/count/">count</a></td> <td>Count comments, on whole blog or on a given post.</td> </tr> <tr> - <td><a href="/commands/comment/create">create</a></td> + <td><a href="/commands/comment/create/">create</a></td> <td>Insert a comment.</td> </tr> <tr> - <td><a href="/commands/comment/delete">delete</a></td> + <td><a href="/commands/comment/delete/">delete</a></td> <td>Delete a comment.</td> </tr> <tr> - <td><a href="/commands/comment/last">last</a></td> + <td><a href="/commands/comment/last/">last</a></td> <td>Get last approved comment.</td> </tr> <tr> - <td><a href="/commands/comment/spam">spam</a></td> + <td><a href="/commands/comment/spam/">spam</a></td> <td>Spam a comment.</td> </tr> <tr> - <td><a href="/commands/comment/status">status</a></td> + <td><a href="/commands/comment/status/">status</a></td> <td>Get status of a comment.</td> </tr> <tr> - <td><a href="/commands/comment/trash">trash</a></td> + <td><a href="/commands/comment/trash/">trash</a></td> <td>Trash a comment.</td> </tr> <tr> - <td><a href="/commands/comment/unapprove">unapprove</a></td> + <td><a href="/commands/comment/unapprove/">unapprove</a></td> <td>Unapprove a comment.</td> </tr> <tr> - <td><a href="/commands/comment/unspam">unspam</a></td> + <td><a href="/commands/comment/unspam/">unspam</a></td> <td>Unspam a comment.</td> </tr> <tr> - <td><a href="/commands/comment/untrash">untrash</a></td> + <td><a href="/commands/comment/untrash/">untrash</a></td> <td>Untrash a comment.</td> </tr> </tbody> diff --git a/commands/core/index.md b/commands/core/index.md index 6531fcf5..cecaa84b 100644 --- a/commands/core/index.md +++ b/commands/core/index.md @@ -18,39 +18,39 @@ title: 'wp core' </thead> <tbody> <tr> - <td><a href="/commands/core/config">config</a></td> + <td><a href="/commands/core/config/">config</a></td> <td>Set up a wp-config.php file.</td> </tr> <tr> - <td><a href="/commands/core/download">download</a></td> + <td><a href="/commands/core/download/">download</a></td> <td>Download core WordPress files.</td> </tr> <tr> - <td><a href="/commands/core/init-tests">init-tests</a></td> + <td><a href="/commands/core/init-tests/">init-tests</a></td> <td>Set up the official test suite using the current WordPress instance.</td> </tr> <tr> - <td><a href="/commands/core/install">install</a></td> + <td><a href="/commands/core/install/">install</a></td> <td>Create the WordPress tables in the database.</td> </tr> <tr> - <td><a href="/commands/core/install-network">install-network</a></td> + <td><a href="/commands/core/install-network/">install-network</a></td> <td>Transform a single-site install into a multi-site install.</td> </tr> <tr> - <td><a href="/commands/core/is-installed">is-installed</a></td> + <td><a href="/commands/core/is-installed/">is-installed</a></td> <td>Determine if the WordPress tables are installed.</td> </tr> <tr> - <td><a href="/commands/core/update">update</a></td> + <td><a href="/commands/core/update/">update</a></td> <td>Update WordPress.</td> </tr> <tr> - <td><a href="/commands/core/update-db">update-db</a></td> + <td><a href="/commands/core/update-db/">update-db</a></td> <td>Update the WordPress database.</td> </tr> <tr> - <td><a href="/commands/core/version">version</a></td> + <td><a href="/commands/core/version/">version</a></td> <td>Display the WordPress version.</td> </tr> </tbody> diff --git a/commands/db/index.md b/commands/db/index.md index 7355e21b..a03a2c3c 100644 --- a/commands/db/index.md +++ b/commands/db/index.md @@ -33,39 +33,39 @@ title: 'wp db' </thead> <tbody> <tr> - <td><a href="/commands/db/cli">cli</a></td> + <td><a href="/commands/db/cli/">cli</a></td> <td>Open a mysql console using the WordPress credentials.</td> </tr> <tr> - <td><a href="/commands/db/create">create</a></td> + <td><a href="/commands/db/create/">create</a></td> <td>Create the database, as specified in wp-config.php</td> </tr> <tr> - <td><a href="/commands/db/drop">drop</a></td> + <td><a href="/commands/db/drop/">drop</a></td> <td>Delete the database.</td> </tr> <tr> - <td><a href="/commands/db/export">export</a></td> + <td><a href="/commands/db/export/">export</a></td> <td>Exports the database using mysqldump.</td> </tr> <tr> - <td><a href="/commands/db/import">import</a></td> + <td><a href="/commands/db/import/">import</a></td> <td>Import database from a file.</td> </tr> <tr> - <td><a href="/commands/db/optimize">optimize</a></td> + <td><a href="/commands/db/optimize/">optimize</a></td> <td>Optimize the database.</td> </tr> <tr> - <td><a href="/commands/db/query">query</a></td> + <td><a href="/commands/db/query/">query</a></td> <td>Execute a query against the database.</td> </tr> <tr> - <td><a href="/commands/db/repair">repair</a></td> + <td><a href="/commands/db/repair/">repair</a></td> <td>Repair the database.</td> </tr> <tr> - <td><a href="/commands/db/reset">reset</a></td> + <td><a href="/commands/db/reset/">reset</a></td> <td>Remove all tables from the database.</td> </tr> </tbody> diff --git a/commands/media/index.md b/commands/media/index.md index d37167b1..09e45e40 100644 --- a/commands/media/index.md +++ b/commands/media/index.md @@ -18,11 +18,11 @@ title: 'wp media' </thead> <tbody> <tr> - <td><a href="/commands/media/import">import</a></td> + <td><a href="/commands/media/import/">import</a></td> <td>Create attachments from local files or from URLs.</td> </tr> <tr> - <td><a href="/commands/media/regenerate">regenerate</a></td> + <td><a href="/commands/media/regenerate/">regenerate</a></td> <td>Regenerate thumbnail(s).</td> </tr> </tbody> diff --git a/commands/option/index.md b/commands/option/index.md index 92fa7936..90b2f6a6 100644 --- a/commands/option/index.md +++ b/commands/option/index.md @@ -32,19 +32,19 @@ title: 'wp option' </thead> <tbody> <tr> - <td><a href="/commands/option/add">add</a></td> + <td><a href="/commands/option/add/">add</a></td> <td>Add an option.</td> </tr> <tr> - <td><a href="/commands/option/delete">delete</a></td> + <td><a href="/commands/option/delete/">delete</a></td> <td>Delete an option.</td> </tr> <tr> - <td><a href="/commands/option/get">get</a></td> + <td><a href="/commands/option/get/">get</a></td> <td>Get an option.</td> </tr> <tr> - <td><a href="/commands/option/update">update</a></td> + <td><a href="/commands/option/update/">update</a></td> <td>Update an option.</td> </tr> </tbody> diff --git a/commands/plugin/index.md b/commands/plugin/index.md index 954c9456..a3649f28 100644 --- a/commands/plugin/index.md +++ b/commands/plugin/index.md @@ -18,47 +18,47 @@ title: 'wp plugin' </thead> <tbody> <tr> - <td><a href="/commands/plugin/activate">activate</a></td> + <td><a href="/commands/plugin/activate/">activate</a></td> <td>Activate a plugin.</td> </tr> <tr> - <td><a href="/commands/plugin/deactivate">deactivate</a></td> + <td><a href="/commands/plugin/deactivate/">deactivate</a></td> <td>Deactivate a plugin.</td> </tr> <tr> - <td><a href="/commands/plugin/delete">delete</a></td> + <td><a href="/commands/plugin/delete/">delete</a></td> <td>Delete plugin files.</td> </tr> <tr> - <td><a href="/commands/plugin/install">install</a></td> + <td><a href="/commands/plugin/install/">install</a></td> <td>Install a plugin.</td> </tr> <tr> - <td><a href="/commands/plugin/list">list</a></td> + <td><a href="/commands/plugin/list/">list</a></td> <td>Get a list of plugins.</td> </tr> <tr> - <td><a href="/commands/plugin/path">path</a></td> + <td><a href="/commands/plugin/path/">path</a></td> <td>Get the path to a plugin or to the plugin directory.</td> </tr> <tr> - <td><a href="/commands/plugin/status">status</a></td> + <td><a href="/commands/plugin/status/">status</a></td> <td>See the status of one or all plugins.</td> </tr> <tr> - <td><a href="/commands/plugin/toggle">toggle</a></td> + <td><a href="/commands/plugin/toggle/">toggle</a></td> <td>Toggle a plugin's activation state.</td> </tr> <tr> - <td><a href="/commands/plugin/uninstall">uninstall</a></td> + <td><a href="/commands/plugin/uninstall/">uninstall</a></td> <td>Uninstall a plugin.</td> </tr> <tr> - <td><a href="/commands/plugin/update">update</a></td> + <td><a href="/commands/plugin/update/">update</a></td> <td>Update a plugin.</td> </tr> <tr> - <td><a href="/commands/plugin/update-all">update-all</a></td> + <td><a href="/commands/plugin/update-all/">update-all</a></td> <td>Update all plugins.</td> </tr> </tbody> diff --git a/commands/post-meta/index.md b/commands/post-meta/index.md index 430e86a7..7ca8fc2c 100644 --- a/commands/post-meta/index.md +++ b/commands/post-meta/index.md @@ -26,19 +26,19 @@ title: 'wp post-meta' </thead> <tbody> <tr> - <td><a href="/commands/post-meta/add">add</a></td> + <td><a href="/commands/post-meta/add/">add</a></td> <td>Add a meta field.</td> </tr> <tr> - <td><a href="/commands/post-meta/delete">delete</a></td> + <td><a href="/commands/post-meta/delete/">delete</a></td> <td>Delete a meta field.</td> </tr> <tr> - <td><a href="/commands/post-meta/get">get</a></td> + <td><a href="/commands/post-meta/get/">get</a></td> <td>Get meta field value.</td> </tr> <tr> - <td><a href="/commands/post-meta/update">update</a></td> + <td><a href="/commands/post-meta/update/">update</a></td> <td>Update a meta field.</td> </tr> </tbody> diff --git a/commands/post/index.md b/commands/post/index.md index a30139bd..311f7128 100644 --- a/commands/post/index.md +++ b/commands/post/index.md @@ -18,31 +18,31 @@ title: 'wp post' </thead> <tbody> <tr> - <td><a href="/commands/post/create">create</a></td> + <td><a href="/commands/post/create/">create</a></td> <td>Create a post.</td> </tr> <tr> - <td><a href="/commands/post/delete">delete</a></td> + <td><a href="/commands/post/delete/">delete</a></td> <td>Delete a post by ID.</td> </tr> <tr> - <td><a href="/commands/post/edit">edit</a></td> + <td><a href="/commands/post/edit/">edit</a></td> <td>Launch system editor to edit post content.</td> </tr> <tr> - <td><a href="/commands/post/generate">generate</a></td> + <td><a href="/commands/post/generate/">generate</a></td> <td>Generate some posts.</td> </tr> <tr> - <td><a href="/commands/post/get">get</a></td> + <td><a href="/commands/post/get/">get</a></td> <td>Get a post's content by ID.</td> </tr> <tr> - <td><a href="/commands/post/list">list</a></td> + <td><a href="/commands/post/list/">list</a></td> <td>Get a list of posts.</td> </tr> <tr> - <td><a href="/commands/post/update">update</a></td> + <td><a href="/commands/post/update/">update</a></td> <td>Update one or more posts.</td> </tr> </tbody> diff --git a/commands/rewrite/index.md b/commands/rewrite/index.md index b538ee1b..19a65b84 100644 --- a/commands/rewrite/index.md +++ b/commands/rewrite/index.md @@ -18,15 +18,15 @@ title: 'wp rewrite' </thead> <tbody> <tr> - <td><a href="/commands/rewrite/dump">dump</a></td> + <td><a href="/commands/rewrite/dump/">dump</a></td> <td>Print current rewrite rules.</td> </tr> <tr> - <td><a href="/commands/rewrite/flush">flush</a></td> + <td><a href="/commands/rewrite/flush/">flush</a></td> <td>Flush rewrite rules.</td> </tr> <tr> - <td><a href="/commands/rewrite/structure">structure</a></td> + <td><a href="/commands/rewrite/structure/">structure</a></td> <td>Update the permalink structure.</td> </tr> </tbody> diff --git a/commands/role/index.md b/commands/role/index.md index 628eb4de..a4ddb5b2 100644 --- a/commands/role/index.md +++ b/commands/role/index.md @@ -18,19 +18,19 @@ title: 'wp role' </thead> <tbody> <tr> - <td><a href="/commands/role/create">create</a></td> + <td><a href="/commands/role/create/">create</a></td> <td>Create a new role.</td> </tr> <tr> - <td><a href="/commands/role/delete">delete</a></td> + <td><a href="/commands/role/delete/">delete</a></td> <td>Delete an existing role.</td> </tr> <tr> - <td><a href="/commands/role/exists">exists</a></td> + <td><a href="/commands/role/exists/">exists</a></td> <td>Check if a role exists.</td> </tr> <tr> - <td><a href="/commands/role/list">list</a></td> + <td><a href="/commands/role/list/">list</a></td> <td>List all roles.</td> </tr> </tbody> diff --git a/commands/scaffold/index.md b/commands/scaffold/index.md index 1f9f175f..ca133658 100644 --- a/commands/scaffold/index.md +++ b/commands/scaffold/index.md @@ -18,27 +18,27 @@ title: 'wp scaffold' </thead> <tbody> <tr> - <td><a href="/commands/scaffold/_s">_s</a></td> + <td><a href="/commands/scaffold/_s/">_s</a></td> <td>Generate starter code for a theme.</td> </tr> <tr> - <td><a href="/commands/scaffold/child-theme">child-theme</a></td> + <td><a href="/commands/scaffold/child-theme/">child-theme</a></td> <td>Generate empty child theme.</td> </tr> <tr> - <td><a href="/commands/scaffold/plugin">plugin</a></td> + <td><a href="/commands/scaffold/plugin/">plugin</a></td> <td>Generate starter code for a plugin.</td> </tr> <tr> - <td><a href="/commands/scaffold/plugin-tests">plugin-tests</a></td> + <td><a href="/commands/scaffold/plugin-tests/">plugin-tests</a></td> <td>Generate files needed for running PHPUnit tests.</td> </tr> <tr> - <td><a href="/commands/scaffold/post-type">post-type</a></td> + <td><a href="/commands/scaffold/post-type/">post-type</a></td> <td>Generate PHP code for registering a custom post type.</td> </tr> <tr> - <td><a href="/commands/scaffold/taxonomy">taxonomy</a></td> + <td><a href="/commands/scaffold/taxonomy/">taxonomy</a></td> <td>Generate PHP code for registering a custom taxonomy.</td> </tr> </tbody> diff --git a/commands/term/index.md b/commands/term/index.md index 0cd27a28..50d34890 100644 --- a/commands/term/index.md +++ b/commands/term/index.md @@ -18,19 +18,19 @@ title: 'wp term' </thead> <tbody> <tr> - <td><a href="/commands/term/create">create</a></td> + <td><a href="/commands/term/create/">create</a></td> <td>Create a term.</td> </tr> <tr> - <td><a href="/commands/term/delete">delete</a></td> + <td><a href="/commands/term/delete/">delete</a></td> <td>Delete a term.</td> </tr> <tr> - <td><a href="/commands/term/list">list</a></td> + <td><a href="/commands/term/list/">list</a></td> <td>List terms in a taxonomy.</td> </tr> <tr> - <td><a href="/commands/term/update">update</a></td> + <td><a href="/commands/term/update/">update</a></td> <td>Update a term.</td> </tr> </tbody> diff --git a/commands/theme/index.md b/commands/theme/index.md index 7f62fcdf..e8cfa5bf 100644 --- a/commands/theme/index.md +++ b/commands/theme/index.md @@ -18,35 +18,35 @@ title: 'wp theme' </thead> <tbody> <tr> - <td><a href="/commands/theme/activate">activate</a></td> + <td><a href="/commands/theme/activate/">activate</a></td> <td>Activate a theme.</td> </tr> <tr> - <td><a href="/commands/theme/delete">delete</a></td> + <td><a href="/commands/theme/delete/">delete</a></td> <td>Delete a theme.</td> </tr> <tr> - <td><a href="/commands/theme/install">install</a></td> + <td><a href="/commands/theme/install/">install</a></td> <td>Install a theme.</td> </tr> <tr> - <td><a href="/commands/theme/list">list</a></td> + <td><a href="/commands/theme/list/">list</a></td> <td>Get a list of themes.</td> </tr> <tr> - <td><a href="/commands/theme/path">path</a></td> + <td><a href="/commands/theme/path/">path</a></td> <td>Get the path to a theme or to the theme directory.</td> </tr> <tr> - <td><a href="/commands/theme/status">status</a></td> + <td><a href="/commands/theme/status/">status</a></td> <td>See the status of one or all themes.</td> </tr> <tr> - <td><a href="/commands/theme/update">update</a></td> + <td><a href="/commands/theme/update/">update</a></td> <td>Update a theme.</td> </tr> <tr> - <td><a href="/commands/theme/update-all">update-all</a></td> + <td><a href="/commands/theme/update-all/">update-all</a></td> <td>Update all themes.</td> </tr> </tbody> diff --git a/commands/transient/index.md b/commands/transient/index.md index ff8b511b..d1d51091 100644 --- a/commands/transient/index.md +++ b/commands/transient/index.md @@ -21,19 +21,19 @@ title: 'wp transient' </thead> <tbody> <tr> - <td><a href="/commands/transient/delete">delete</a></td> + <td><a href="/commands/transient/delete/">delete</a></td> <td>Delete a transient value.</td> </tr> <tr> - <td><a href="/commands/transient/get">get</a></td> + <td><a href="/commands/transient/get/">get</a></td> <td>Get a transient value.</td> </tr> <tr> - <td><a href="/commands/transient/set">set</a></td> + <td><a href="/commands/transient/set/">set</a></td> <td>Set a transient value. <expiration> is the time until expiration, in seconds.</td> </tr> <tr> - <td><a href="/commands/transient/type">type</a></td> + <td><a href="/commands/transient/type/">type</a></td> <td>See wether the transients API is using an object cache or the options table.</td> </tr> </tbody> diff --git a/commands/user-meta/index.md b/commands/user-meta/index.md index c7d49a18..341b4f35 100644 --- a/commands/user-meta/index.md +++ b/commands/user-meta/index.md @@ -26,19 +26,19 @@ title: 'wp user-meta' </thead> <tbody> <tr> - <td><a href="/commands/user-meta/add">add</a></td> + <td><a href="/commands/user-meta/add/">add</a></td> <td>Add a meta field.</td> </tr> <tr> - <td><a href="/commands/user-meta/delete">delete</a></td> + <td><a href="/commands/user-meta/delete/">delete</a></td> <td>Delete a meta field.</td> </tr> <tr> - <td><a href="/commands/user-meta/get">get</a></td> + <td><a href="/commands/user-meta/get/">get</a></td> <td>Get meta field value.</td> </tr> <tr> - <td><a href="/commands/user-meta/update">update</a></td> + <td><a href="/commands/user-meta/update/">update</a></td> <td>Update a meta field.</td> </tr> </tbody> diff --git a/commands/user/index.md b/commands/user/index.md index 703c1a88..7e706a4c 100644 --- a/commands/user/index.md +++ b/commands/user/index.md @@ -18,39 +18,39 @@ title: 'wp user' </thead> <tbody> <tr> - <td><a href="/commands/user/add-role">add-role</a></td> + <td><a href="/commands/user/add-role/">add-role</a></td> <td>Add a role for a user.</td> </tr> <tr> - <td><a href="/commands/user/create">create</a></td> + <td><a href="/commands/user/create/">create</a></td> <td>Create a user.</td> </tr> <tr> - <td><a href="/commands/user/delete">delete</a></td> + <td><a href="/commands/user/delete/">delete</a></td> <td>Delete one or more users.</td> </tr> <tr> - <td><a href="/commands/user/generate">generate</a></td> + <td><a href="/commands/user/generate/">generate</a></td> <td>Generate users.</td> </tr> <tr> - <td><a href="/commands/user/import-csv">import-csv</a></td> + <td><a href="/commands/user/import-csv/">import-csv</a></td> <td>Import users from a CSV file.</td> </tr> <tr> - <td><a href="/commands/user/list">list</a></td> + <td><a href="/commands/user/list/">list</a></td> <td>List users.</td> </tr> <tr> - <td><a href="/commands/user/remove-role">remove-role</a></td> + <td><a href="/commands/user/remove-role/">remove-role</a></td> <td>Remove a user's role.</td> </tr> <tr> - <td><a href="/commands/user/set-role">set-role</a></td> + <td><a href="/commands/user/set-role/">set-role</a></td> <td>Set the user role (for a particular blog).</td> </tr> <tr> - <td><a href="/commands/user/update">update</a></td> + <td><a href="/commands/user/update/">update</a></td> <td>Update a user.</td> </tr> </tbody> From d45e5c1f6985ede139001ee61d5cbcba33dd91c7 Mon Sep 17 00:00:00 2001 From: Graham Christensen <graham@grahamc.com> Date: Fri, 26 Jul 2013 11:20:28 -0500 Subject: [PATCH 176/194] Resolve horrific installation-based security issue Expecting HTTP traffic to not be mangled, especially when a potential attacker knows users are planning on piping it directly to bash, is a horrifying idea. Instead, link to the HTTPS version hosted on github.com. Same outcome, less horribleness. --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index f767cb63..84080793 100644 --- a/index.md +++ b/index.md @@ -15,7 +15,7 @@ title: Command line interface for WordPress Just execute the following command in your terminal: ``` -curl http://wp-cli.org/installer.sh | bash +curl https://raw.github.com/wp-cli/wp-cli.github.com/master/installer.sh | bash ``` Make sure to read the instructions. From 15f086e7f5a04041e23b49f89f5dd94805f302f1 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Sun, 4 Aug 2013 16:04:56 +0300 Subject: [PATCH 177/194] adapt template for new docs format Kramdown is needed for definition lists. see wp-cli/wp-cli#551 --- Phakefile.php | 1 - _config.yml | 2 +- _templates/subcmd-list.mustache | 2 +- 3 files changed, 2 insertions(+), 3 deletions(-) diff --git a/Phakefile.php b/Phakefile.php index 782a4264..0d49b288 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -49,7 +49,6 @@ function gen_cmd_pages( $wp_cli_path, $cmd, $parent = array() ) { if ( is_readable( $docs_path ) ) { $docs = file_get_contents( $docs_path ); $docs = preg_replace( '/^## /m', '### ', $docs ); - $docs = preg_replace( '/\n\* `(.+)`([^\n]*):\n\n/', "\n\t\\1\\2\n\t\t", $docs ); $binding['docs'] = $docs; } diff --git a/_config.yml b/_config.yml index 63e78d97..678a7fba 100644 --- a/_config.yml +++ b/_config.yml @@ -1,7 +1,7 @@ safe: true lsi: false pygments: true -markdown: redcarpet +markdown: kramdown url: http://wp-cli.org permalink: /blog/:title.html paginate: 10 diff --git a/_templates/subcmd-list.mustache b/_templates/subcmd-list.mustache index d051a272..f60693bc 100644 --- a/_templates/subcmd-list.mustache +++ b/_templates/subcmd-list.mustache @@ -5,7 +5,7 @@ title: 'wp {{synopsis}}' `wp {{synopsis}}` - {{description}} -{{{docs}}} +{{docs}} {{#has-subcommands}} ### SUBCOMMANDS From e092d99628ce3d6fda2faeab4e81811296d897bd Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Sun, 4 Aug 2013 22:18:31 +0300 Subject: [PATCH 178/194] read docs from 'longdesc' property, instead of looking for doc files --- Phakefile.php | 11 +++++------ README.md | 2 +- 2 files changed, 6 insertions(+), 7 deletions(-) diff --git a/Phakefile.php b/Phakefile.php index 0d49b288..9fa584d9 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -37,7 +37,7 @@ function generate_synopsis( $command, $path = '' ) { generate_synopsis( invoke_wp_cli( 'wp cli cmd-dump', $app ) ); }); -function gen_cmd_pages( $wp_cli_path, $cmd, $parent = array() ) { +function gen_cmd_pages( $cmd, $parent = array() ) { $parent[] = $cmd['name']; $binding = $cmd; @@ -45,9 +45,8 @@ function gen_cmd_pages( $wp_cli_path, $cmd, $parent = array() ) { $binding['path'] = implode( '/', $parent ); $binding['has-subcommands'] = isset( $cmd['subcommands'] ) ? array(true) : false; - $docs_path = $wp_cli_path . '/man-src/' . implode( '-', $parent ) . '.txt'; - if ( is_readable( $docs_path ) ) { - $docs = file_get_contents( $docs_path ); + if ( $cmd['longdesc'] ) { + $docs = $cmd['longdesc']; $docs = preg_replace( '/^## /m', '### ', $docs ); $binding['docs'] = $docs; } @@ -60,7 +59,7 @@ function gen_cmd_pages( $wp_cli_path, $cmd, $parent = array() ) { return; foreach ( $cmd['subcommands'] as $subcmd ) { - gen_cmd_pages( $wp_cli_path, $subcmd, $parent ); + gen_cmd_pages( $subcmd, $parent ); } } @@ -74,7 +73,7 @@ function gen_cmd_pages( $wp_cli_path, $cmd, $parent = array() ) { system( sprintf( 'rm -rf %s/commands/*/', escapeshellarg( __DIR__ ) ) ); foreach ( $wp['subcommands'] as $cmd ) { - gen_cmd_pages( $app['path'], $cmd ); + gen_cmd_pages( $cmd ); } }); diff --git a/README.md b/README.md index 244632d5..54415ab1 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ 3. Build: ```bash -vendor/bin/phake path=/path/to/wp-cli-dir +vendor/bin/phake ``` ### Preview locally From 6a64082a7036f4ac82e4b4b60ee8d9f5ed901bd5 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Sun, 4 Aug 2013 23:04:13 +0300 Subject: [PATCH 179/194] build for 0.11-beta --- _includes/cmd-list.html | 28 ++++++++---- _includes/param-list.html | 10 ++++- commands/cache/index.md | 5 +-- commands/cache/type/index.md | 4 +- commands/cap/index.md | 13 +++--- commands/cli/cmd-dump/index.md | 9 ++++ commands/cli/completions/index.md | 9 ++++ commands/cli/index.md | 41 ++++++++++++++++++ commands/cli/info/index.md | 9 ++++ commands/cli/param-dump/index.md | 9 ++++ commands/cli/version/index.md | 9 ++++ commands/comment/approve/index.md | 7 ++- commands/comment/count/index.md | 9 ++-- commands/comment/create/index.md | 12 +++--- commands/comment/delete/index.md | 11 +++-- commands/comment/last/index.md | 11 +++-- commands/comment/spam/index.md | 7 ++- commands/comment/status/index.md | 7 ++- commands/comment/trash/index.md | 7 ++- commands/comment/unapprove/index.md | 7 ++- commands/comment/unspam/index.md | 7 ++- commands/comment/untrash/index.md | 7 ++- commands/core/config/index.md | 42 +++++++++--------- commands/core/download/index.md | 15 +++---- commands/core/index.md | 10 +++-- commands/core/init-tests/index.md | 18 -------- commands/core/install/index.md | 21 +++++---- commands/core/is-installed/index.md | 7 ++- commands/core/multisite-convert/index.md | 19 +++++++++ commands/core/multisite-install/index.md | 31 ++++++++++++++ commands/core/update/index.md | 16 +++---- commands/core/version/index.md | 5 +-- commands/db/index.md | 17 ++++---- commands/eval-file/index.md | 3 +- commands/eval/index.md | 3 +- commands/export/index.md | 49 +++++++++++---------- commands/help/index.md | 14 +++--- commands/import/index.md | 18 ++++++++ commands/media/import/index.md | 54 ++++++++++-------------- commands/media/index.md | 2 +- commands/media/regenerate/index.md | 12 +++--- commands/network-meta/add/index.md | 9 ++++ commands/network-meta/delete/index.md | 9 ++++ commands/network-meta/get/index.md | 9 ++++ commands/network-meta/index.md | 48 +++++++++++++++++++++ commands/network-meta/update/index.md | 9 ++++ commands/option/index.md | 15 +++---- commands/plugin/activate/index.md | 9 ++-- commands/plugin/deactivate/index.md | 9 ++-- commands/plugin/delete/index.md | 8 ++-- commands/plugin/install/index.md | 28 +++++++----- commands/plugin/list/index.md | 8 ++-- commands/plugin/path/index.md | 11 +++-- commands/plugin/status/index.md | 4 +- commands/plugin/toggle/index.md | 9 ++-- commands/plugin/uninstall/index.md | 12 +++--- commands/plugin/update-all/index.md | 7 ++- commands/plugin/update/index.md | 12 +++--- commands/post-meta/index.md | 7 ++- commands/post/create/index.md | 34 +++++++-------- commands/post/delete/index.md | 13 +++--- commands/post/edit/index.md | 7 ++- commands/post/generate/index.md | 27 ++++++------ commands/post/get/index.md | 21 +++++---- commands/post/list/index.md | 19 ++++----- commands/post/update/index.md | 11 +++-- commands/rewrite/dump/index.md | 5 +-- commands/rewrite/flush/index.md | 7 +-- commands/rewrite/structure/index.md | 15 ++++--- commands/role/create/index.md | 7 ++- commands/role/delete/index.md | 4 +- commands/role/exists/index.md | 14 +++--- commands/role/list/index.md | 9 ++-- commands/scaffold/_s/index.md | 21 +++++---- commands/scaffold/child-theme/index.md | 30 ++++++------- commands/scaffold/plugin-tests/index.md | 3 +- commands/scaffold/plugin/index.md | 9 ++-- commands/scaffold/post-type/index.md | 23 +++++----- commands/scaffold/taxonomy/index.md | 29 ++++++------- commands/search-replace/index.md | 17 ++++---- commands/shell/index.md | 5 +-- commands/site/create/index.md | 27 ++++++++++++ commands/site/delete/index.md | 21 +++++++++ commands/site/empty/index.md | 12 ++++++ commands/site/index.md | 33 +++++++++++++++ commands/term/create/index.md | 27 ++++++------ commands/term/delete/index.md | 10 ++--- commands/term/list/index.md | 17 ++++---- commands/term/update/index.md | 27 ++++++------ commands/theme/activate/index.md | 5 +-- commands/theme/delete/index.md | 7 ++- commands/theme/install/index.md | 20 ++++++--- commands/theme/list/index.md | 8 ++-- commands/theme/path/index.md | 11 +++-- commands/theme/status/index.md | 5 +-- commands/theme/update-all/index.md | 7 ++- commands/theme/update/index.md | 11 +++-- commands/transient/index.md | 5 +-- commands/user-meta/index.md | 7 ++- commands/user/add-role/index.md | 11 +++++ commands/user/create/index.md | 31 +++++++------- commands/user/delete/index.md | 11 +++-- commands/user/generate/index.md | 9 ++-- commands/user/get/index.md | 25 +++++++++++ commands/user/import-csv/index.md | 17 ++++---- commands/user/index.md | 4 ++ commands/user/list/index.md | 19 ++++----- commands/user/remove-role/index.md | 9 ++-- commands/user/set-role/index.md | 14 +++--- commands/user/update/index.md | 11 ++--- 110 files changed, 934 insertions(+), 634 deletions(-) create mode 100644 commands/cli/cmd-dump/index.md create mode 100644 commands/cli/completions/index.md create mode 100644 commands/cli/index.md create mode 100644 commands/cli/info/index.md create mode 100644 commands/cli/param-dump/index.md create mode 100644 commands/cli/version/index.md create mode 100644 commands/core/multisite-convert/index.md create mode 100644 commands/core/multisite-install/index.md create mode 100644 commands/import/index.md create mode 100644 commands/network-meta/add/index.md create mode 100644 commands/network-meta/delete/index.md create mode 100644 commands/network-meta/get/index.md create mode 100644 commands/network-meta/index.md create mode 100644 commands/network-meta/update/index.md create mode 100644 commands/site/create/index.md create mode 100644 commands/site/delete/index.md create mode 100644 commands/site/empty/index.md create mode 100644 commands/site/index.md create mode 100644 commands/user/get/index.md diff --git a/_includes/cmd-list.html b/_includes/cmd-list.html index d62d1a07..4c35fa41 100644 --- a/_includes/cmd-list.html +++ b/_includes/cmd-list.html @@ -1,7 +1,3 @@ - <tr> - <td><a href="/commands/blog/">blog</a></td> - <td>Manage blogs in a multisite install.</td> - </tr> <tr> <td><a href="/commands/cache/">cache</a></td> <td>Manage the object cache.</td> @@ -10,6 +6,10 @@ <td><a href="/commands/cap/">cap</a></td> <td>Manage user capabilities.</td> </tr> + <tr> + <td><a href="/commands/cli/">cli</a></td> + <td>Get information about WP-CLI itself.</td> + </tr> <tr> <td><a href="/commands/comment/">comment</a></td> <td>Manage comments.</td> @@ -36,15 +36,23 @@ </tr> <tr> <td><a href="/commands/help/">help</a></td> - <td>Get help on a certain topic.</td> + <td>Get help on a certain command.</td> + </tr> + <tr> + <td><a href="/commands/import/">import</a></td> + <td>Import content from a WXR file.</td> </tr> <tr> <td><a href="/commands/media/">media</a></td> - <td>Control the media library and its attachments.</td> + <td>Manage attachments.</td> + </tr> + <tr> + <td><a href="/commands/network-meta/">network-meta</a></td> + <td>Manage network custom fields.</td> </tr> <tr> <td><a href="/commands/option/">option</a></td> - <td>Manage WordPress options.</td> + <td>Manage options.</td> </tr> <tr> <td><a href="/commands/plugin/">plugin</a></td> @@ -78,6 +86,10 @@ <td><a href="/commands/shell/">shell</a></td> <td>Interactive PHP console.</td> </tr> + <tr> + <td><a href="/commands/site/">site</a></td> + <td>Perform site-wide operations.</td> + </tr> <tr> <td><a href="/commands/term/">term</a></td> <td>Manage terms.</td> @@ -88,7 +100,7 @@ </tr> <tr> <td><a href="/commands/transient/">transient</a></td> - <td>Manage WordPress transients.</td> + <td>Manage transients.</td> </tr> <tr> <td><a href="/commands/user/">user</a></td> diff --git a/_includes/param-list.html b/_includes/param-list.html index a908825c..7df74212 100644 --- a/_includes/param-list.html +++ b/_includes/param-list.html @@ -25,8 +25,8 @@ <tr> <td><code>require: <path></code></td> <td><code>--require=<path></code></td> - <td><code>null</code></td> - <td>Load given PHP file before running the command</td> + <td><code>[]</code></td> + <td>Load PHP file before running the command (may be used more than once)</td> </tr> <tr> <td><code>disabled_commands: <list></code></td> @@ -52,3 +52,9 @@ <td><code>false</code></td> <td>Suppress informational messages</td> </tr> + <tr> + <td><code>apache_modules: <list></code></td> + <td><code></code></td> + <td><code>[]</code></td> + <td>List of Apache Modules that are to be reported as loaded</td> + </tr> diff --git a/commands/cache/index.md b/commands/cache/index.md index 4599ae37..c944f34f 100644 --- a/commands/cache/index.md +++ b/commands/cache/index.md @@ -7,10 +7,9 @@ title: 'wp cache' ### EXAMPLES - wp cache set my_key my_value my_group 300 - - wp cache get my_key my_group + wp cache set my_key my_value my_group 300 + wp cache get my_key my_group ### SUBCOMMANDS diff --git a/commands/cache/type/index.md b/commands/cache/type/index.md index 2e256840..bcebd50e 100644 --- a/commands/cache/type/index.md +++ b/commands/cache/type/index.md @@ -5,5 +5,7 @@ title: 'wp cache type' `wp cache type` - Attempts to determine which object cache is being used. - +Note that the guesses made by this function are based on the WP_Object_Cache classes +that define the 3rd party object cache extension. Changes to those classes could render +problems with this function's ability to determine which object cache is being used. diff --git a/commands/cap/index.md b/commands/cap/index.md index 7e69b337..402ebf28 100644 --- a/commands/cap/index.md +++ b/commands/cap/index.md @@ -7,15 +7,14 @@ title: 'wp cap' ### EXAMPLES - # Add 'spectate' capability to 'author' role - wp cap add 'author' 'spectate' + # Add 'spectate' capability to 'author' role + wp cap add 'author' 'spectate' - # Add all caps from 'editor' role to 'author' role - wp cap list 'editor' | xargs wp cap add 'author' - - # Remove all caps from 'editor' role that also appear in 'author' role - wp cap list 'author' | xargs wp cap remove 'editor' + # Add all caps from 'editor' role to 'author' role + wp cap list 'editor' | xargs wp cap add 'author' + # Remove all caps from 'editor' role that also appear in 'author' role + wp cap list 'author' | xargs wp cap remove 'editor' ### SUBCOMMANDS diff --git a/commands/cli/cmd-dump/index.md b/commands/cli/cmd-dump/index.md new file mode 100644 index 00000000..a802f09f --- /dev/null +++ b/commands/cli/cmd-dump/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cli cmd-dump' +--- + +`wp cli cmd-dump` - + + + diff --git a/commands/cli/completions/index.md b/commands/cli/completions/index.md new file mode 100644 index 00000000..5d11a782 --- /dev/null +++ b/commands/cli/completions/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cli completions' +--- + +`wp cli completions` - + + + diff --git a/commands/cli/index.md b/commands/cli/index.md new file mode 100644 index 00000000..68f91e72 --- /dev/null +++ b/commands/cli/index.md @@ -0,0 +1,41 @@ +--- +layout: default +title: 'wp cli' +--- + +`wp cli` - Get information about WP-CLI itself. + + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/cli/cmd-dump">cmd-dump</a></td> + <td></td> + </tr> + <tr> + <td><a href="/commands/cli/completions">completions</a></td> + <td></td> + </tr> + <tr> + <td><a href="/commands/cli/info">info</a></td> + <td></td> + </tr> + <tr> + <td><a href="/commands/cli/param-dump">param-dump</a></td> + <td></td> + </tr> + <tr> + <td><a href="/commands/cli/version">version</a></td> + <td></td> + </tr> + </tbody> +</table> diff --git a/commands/cli/info/index.md b/commands/cli/info/index.md new file mode 100644 index 00000000..01c6a67b --- /dev/null +++ b/commands/cli/info/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cli info' +--- + +`wp cli info` - + + + diff --git a/commands/cli/param-dump/index.md b/commands/cli/param-dump/index.md new file mode 100644 index 00000000..23095928 --- /dev/null +++ b/commands/cli/param-dump/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cli param-dump' +--- + +`wp cli param-dump` - + + + diff --git a/commands/cli/version/index.md b/commands/cli/version/index.md new file mode 100644 index 00000000..33743da4 --- /dev/null +++ b/commands/cli/version/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp cli version' +--- + +`wp cli version` - + + + diff --git a/commands/comment/approve/index.md b/commands/comment/approve/index.md index ca426161..0394e920 100644 --- a/commands/comment/approve/index.md +++ b/commands/comment/approve/index.md @@ -7,11 +7,10 @@ title: 'wp comment approve' ### OPTIONS - <ID> - The ID of the comment to approve. +<ID> +: The ID of the comment to approve. ### EXAMPLES - wp comment approve 1337 - + wp comment approve 1337 diff --git a/commands/comment/count/index.md b/commands/comment/count/index.md index 07c62641..0d9bed06 100644 --- a/commands/comment/count/index.md +++ b/commands/comment/count/index.md @@ -7,12 +7,11 @@ title: 'wp comment count' ### OPTIONS - <ID> - The ID of the post to count comments in +<ID> +: The ID of the post to count comments in ### EXAMPLES - wp comment count - wp comment count 42 - + wp comment count + wp comment count 42 diff --git a/commands/comment/create/index.md b/commands/comment/create/index.md index c35249ea..73f2b4ff 100644 --- a/commands/comment/create/index.md +++ b/commands/comment/create/index.md @@ -7,15 +7,13 @@ title: 'wp comment create' ### OPTIONS - --<field>=<value> - Field values for the new comment. See wp_insert_comment(). +--<field>=<value> +: Field values for the new comment. See wp_insert_comment(). - --porcelain - Output just the new comment id. +--porcelain +: Output just the new comment id. ### EXAMPLES - wp comment create --comment_post_ID=15 --comment_content="hello blog" ---comment_author="wp-cli" - + wp comment create --comment_post_ID=15 --comment_content="hello blog" --comment_author="wp-cli" diff --git a/commands/comment/delete/index.md b/commands/comment/delete/index.md index d8ef9764..656b18b1 100644 --- a/commands/comment/delete/index.md +++ b/commands/comment/delete/index.md @@ -7,14 +7,13 @@ title: 'wp comment delete' ### OPTIONS - <ID> - The ID of the comment to delete. +<ID> +: The ID of the comment to delete. - --force - Skip the trash bin. +--force +: Skip the trash bin. ### EXAMPLES - wp comment delete 1337 --force - + wp comment delete 1337 --force diff --git a/commands/comment/last/index.md b/commands/comment/last/index.md index 1c9a1fff..74e12ca8 100644 --- a/commands/comment/last/index.md +++ b/commands/comment/last/index.md @@ -7,14 +7,13 @@ title: 'wp comment last' ### OPTIONS - --id - Output just the last comment id. +--id +: Output just the last comment id. - --full - Output complete comment information. +--full +: Output complete comment information. ### EXAMPLES - wp comment last --full - + wp comment last --full diff --git a/commands/comment/spam/index.md b/commands/comment/spam/index.md index 674cbd47..c28b1271 100644 --- a/commands/comment/spam/index.md +++ b/commands/comment/spam/index.md @@ -7,11 +7,10 @@ title: 'wp comment spam' ### OPTIONS - <ID> - The ID of the comment to mark as spam. +<ID> +: The ID of the comment to mark as spam. ### EXAMPLES - wp comment spam 1337 - + wp comment spam 1337 diff --git a/commands/comment/status/index.md b/commands/comment/status/index.md index e20d02c9..90343837 100644 --- a/commands/comment/status/index.md +++ b/commands/comment/status/index.md @@ -7,11 +7,10 @@ title: 'wp comment status' ### OPTIONS - <ID> - The ID of the comment to check +<ID> +: The ID of the comment to check ### EXAMPLES - wp comment status 1337 - + wp comment status 1337 diff --git a/commands/comment/trash/index.md b/commands/comment/trash/index.md index ac254279..58aab614 100644 --- a/commands/comment/trash/index.md +++ b/commands/comment/trash/index.md @@ -7,11 +7,10 @@ title: 'wp comment trash' ### OPTIONS - <ID> - The ID of the comment to trash. +<ID> +: The ID of the comment to trash. ### EXAMPLES - wp comment trash 1337 - + wp comment trash 1337 diff --git a/commands/comment/unapprove/index.md b/commands/comment/unapprove/index.md index c227f530..4d4725be 100644 --- a/commands/comment/unapprove/index.md +++ b/commands/comment/unapprove/index.md @@ -7,11 +7,10 @@ title: 'wp comment unapprove' ### OPTIONS - <ID> - The ID of the comment to unapprove. +<ID> +: The ID of the comment to unapprove. ### EXAMPLES - wp comment unapprove 1337 - + wp comment unapprove 1337 diff --git a/commands/comment/unspam/index.md b/commands/comment/unspam/index.md index 9db3027a..583503cb 100644 --- a/commands/comment/unspam/index.md +++ b/commands/comment/unspam/index.md @@ -7,11 +7,10 @@ title: 'wp comment unspam' ### OPTIONS - <ID> - The ID of the comment to unmark as spam. +<ID> +: The ID of the comment to unmark as spam. ### EXAMPLES - wp comment unspam 1337 - + wp comment unspam 1337 diff --git a/commands/comment/untrash/index.md b/commands/comment/untrash/index.md index a9ba56c1..448c5c35 100644 --- a/commands/comment/untrash/index.md +++ b/commands/comment/untrash/index.md @@ -7,11 +7,10 @@ title: 'wp comment untrash' ### OPTIONS - <ID> - The ID of the comment to untrash. +<ID> +: The ID of the comment to untrash. ### EXAMPLES - wp comment untrash 1337 - + wp comment untrash 1337 diff --git a/commands/core/config/index.md b/commands/core/config/index.md index 23d2cc3b..39120298 100644 --- a/commands/core/config/index.md +++ b/commands/core/config/index.md @@ -7,33 +7,35 @@ title: 'wp core config' ### OPTIONS - --dbname=<dbname> - Set the database name. +--dbname=<dbname> +: Set the database name. - --dbuser=<dbuser> - Set the database user. +--dbuser=<dbuser> +: Set the database user. - --dbpass=<dbpass> - Set the database user password. +--dbpass=<dbpass> +: Set the database user password. - --dbhost=<dbhost> - Set the database host. Default: 'localhost' +--dbhost=<dbhost> +: Set the database host. Default: 'localhost' - --dbprefix=<dbprefix> - Set the database table prefix. Default: 'wp_' +--dbprefix=<dbprefix> +: Set the database table prefix. Default: 'wp_' - --extra-php - If set, the command reads additional PHP code from STDIN. +--locale=<locale> +: Set the WPLANG constant. Defaults to $wp_local_package variable. -### EXAMPLES +--extra-php +: If set, the command reads additional PHP code from STDIN. - # Standard wp-config.php file - wp core config --dbname=testing --dbuser=wp --dbpass=securepswd +### EXAMPLES - # Enable WP_DEBUG and WP_DEBUG_LOG - wp core config --dbname=testing --dbuser=wp --dbpass=securepswd --extra-php <<PHP - define( 'WP_DEBUG', true ); - define( 'WP_DEBUG_LOG', true ); - PHP + # Standard wp-config.php file + wp core config --dbname=testing --dbuser=wp --dbpass=securepswd --locale=ro_RO + # Enable WP_DEBUG and WP_DEBUG_LOG + wp core config --dbname=testing --dbuser=wp --dbpass=securepswd --extra-php <<PHP + define( 'WP_DEBUG', true ); + define( 'WP_DEBUG_LOG', true ); + PHP diff --git a/commands/core/download/index.md b/commands/core/download/index.md index 41be7212..dac4e04f 100644 --- a/commands/core/download/index.md +++ b/commands/core/download/index.md @@ -7,18 +7,17 @@ title: 'wp core download' ### OPTIONS - --locale=<locale> - Select which language you want to download. The --version parameter is +--locale=<locale> +: Select which language you want to download. The --version parameter is ignored in this case. - --version=<version> - Select which version you want to download. +--version=<version> +: Select which version you want to download. - --force - Overwrites existing files, if present. +--force +: Overwrites existing files, if present. ### EXAMPLES - wp core download --version=3.3 - + wp core download --version=3.3 diff --git a/commands/core/index.md b/commands/core/index.md index 6531fcf5..5274c586 100644 --- a/commands/core/index.md +++ b/commands/core/index.md @@ -34,12 +34,16 @@ title: 'wp core' <td>Create the WordPress tables in the database.</td> </tr> <tr> - <td><a href="/commands/core/install-network">install-network</a></td> + <td><a href="/commands/core/is-installed">is-installed</a></td> + <td>Determine if the WordPress tables are installed.</td> + </tr> + <tr> + <td><a href="/commands/core/multisite-convert">multisite-convert</a></td> <td>Transform a single-site install into a multi-site install.</td> </tr> <tr> - <td><a href="/commands/core/is-installed">is-installed</a></td> - <td>Determine if the WordPress tables are installed.</td> + <td><a href="/commands/core/multisite-install">multisite-install</a></td> + <td>Install multisite from scratch.</td> </tr> <tr> <td><a href="/commands/core/update">update</a></td> diff --git a/commands/core/init-tests/index.md b/commands/core/init-tests/index.md index efcc33b7..24699a7a 100644 --- a/commands/core/init-tests/index.md +++ b/commands/core/init-tests/index.md @@ -5,23 +5,5 @@ title: 'wp core init-tests' `wp core init-tests` - Set up the official test suite using the current WordPress instance. -### OPTIONS - - <path> - The directory in which to download the testing suite files. (Optional) - - --dbname=<dbname> - Set the database name. **WARNING**: The database will be whipped every time -you run the tests. - - --dbuser=<dbuser> - Set the database user. - - --dbpass=<dbpass> - Set the database user password. - -### EXAMPLE - - wp core init-tests ~/svn/wp-tests --dbname=wp_test --dbuser=wp_test diff --git a/commands/core/install/index.md b/commands/core/install/index.md index ad84fe56..7832807f 100644 --- a/commands/core/install/index.md +++ b/commands/core/install/index.md @@ -7,19 +7,18 @@ title: 'wp core install' ### OPTIONS - --url=<url> - The address of the new site. +--url=<url> +: The address of the new site. - --title=<site-title> - The title of the new site. +--title=<site-title> +: The title of the new site. - --admin_name=<username> - The name of the admin user. Default: 'admin' +--admin_name=<username> +: The name of the admin user. Default: 'admin' - --admin_password=<password> - The password for the admin user. - - --admin_email=<email> - The email address for the admin user. +--admin_password=<password> +: The password for the admin user. +--admin_email=<email> +: The email address for the admin user. diff --git a/commands/core/is-installed/index.md b/commands/core/is-installed/index.md index 062bd672..b1343c65 100644 --- a/commands/core/is-installed/index.md +++ b/commands/core/is-installed/index.md @@ -7,8 +7,7 @@ title: 'wp core is-installed' ### EXAMPLES - if ! $(wp core is-installed); then - wp core install - fi - + if ! $(wp core is-installed); then + wp core install + fi diff --git a/commands/core/multisite-convert/index.md b/commands/core/multisite-convert/index.md new file mode 100644 index 00000000..f68c3acd --- /dev/null +++ b/commands/core/multisite-convert/index.md @@ -0,0 +1,19 @@ +--- +layout: default +title: 'wp core multisite-convert' +--- + +`wp core multisite-convert` - Transform a single-site install into a multi-site install. + +### OPTIONS + +--title=<site-title> +: The title of the new network. + +--base=<url-path> +: Base path after the domain name that each site url will start with. +Default: '/' + +--subdomains +: If passed, the network will use subdomains, instead of subdirectories. + diff --git a/commands/core/multisite-install/index.md b/commands/core/multisite-install/index.md new file mode 100644 index 00000000..d12bdce8 --- /dev/null +++ b/commands/core/multisite-install/index.md @@ -0,0 +1,31 @@ +--- +layout: default +title: 'wp core multisite-install' +--- + +`wp core multisite-install` - Install multisite from scratch. + +### OPTIONS + +--url=<url> +: The address of the new site. + +--base=<url-path> +: Base path after the domain name that each site url in the network will start with. +Default: '/' + +--subdomains +: If passed, the network will use subdomains, instead of subdirectories. + +--title=<site-title> +: The title of the new site. + +--admin_name=<username> +: The name of the admin user. Default: 'admin' + +--admin_password=<password> +: The password for the admin user. + +--admin_email=<email> +: The email address for the admin user. + diff --git a/commands/core/update/index.md b/commands/core/update/index.md index 86ee58e3..496b5de1 100644 --- a/commands/core/update/index.md +++ b/commands/core/update/index.md @@ -7,21 +7,19 @@ title: 'wp core update' ### OPTIONS - --version=<new_version> [package/zip] - When passed, updates to new_version, optionally using package/zip as +--version=<new_version> [package/zip] +: When passed, updates to new_version, optionally using package/zip as input. -* `--force`: - - Will update even when current WP version < passed version. Use with +--force +: Will update even when current WP version < passed version. Use with caution. ### EXAMPLES - wp core update + wp core update - wp core update --version=3.4 ../latest.zip - - wp core update --version=3.1 --force + wp core update --version=3.4 ../latest.zip + wp core update --version=3.1 --force diff --git a/commands/core/version/index.md b/commands/core/version/index.md index 0226b87a..5407ef0a 100644 --- a/commands/core/version/index.md +++ b/commands/core/version/index.md @@ -7,7 +7,6 @@ title: 'wp core version' ### OPTIONS - --extra - Show extended version information. - +--extra +: Show extended version information. diff --git a/commands/db/index.md b/commands/db/index.md index 7355e21b..548d3a81 100644 --- a/commands/db/index.md +++ b/commands/db/index.md @@ -7,20 +7,19 @@ title: 'wp db' ### OPTIONS - --yes - Answer yes to the confirmation message. +--yes +: Answer yes to the confirmation message. - <file> - The name of the export file. If omitted, it will be '{dbname}.sql' +<file> +: The name of the export file. If omitted, it will be '{dbname}.sql' - <SQL> - A SQL query. +<SQL> +: A SQL query. ### EXAMPLES - # execute a query stored in a file - wp db query < debug.sql - + # execute a query stored in a file + wp db query < debug.sql ### SUBCOMMANDS diff --git a/commands/eval-file/index.md b/commands/eval-file/index.md index 3b7cf30c..6f337bde 100644 --- a/commands/eval-file/index.md +++ b/commands/eval-file/index.md @@ -7,6 +7,5 @@ title: 'wp eval-file' ### EXAMPLES - wp eval-file my-code.php - + wp eval-file my-code.php diff --git a/commands/eval/index.md b/commands/eval/index.md index f102a435..ddc41027 100644 --- a/commands/eval/index.md +++ b/commands/eval/index.md @@ -7,6 +7,5 @@ title: 'wp eval' ### EXAMPLES - wp eval 'echo WP_CONTENT_DIR;' - + wp eval 'echo WP_CONTENT_DIR;' diff --git a/commands/export/index.md b/commands/export/index.md index 575d7825..750d923d 100644 --- a/commands/export/index.md +++ b/commands/export/index.md @@ -7,46 +7,45 @@ title: 'wp export' ### OPTIONS - --dir=<dirname> - Full path to directory where WXR export files should be stored. Defaults +--dir=<dirname> +: Full path to directory where WXR export files should be stored. Defaults to current working directory. - --skip_comments - Don't export comments. +--skip_comments +: Don't export comments. - --file_item_count=<count> - Break export into files with N posts. +--file_item_count=<count> +: Break export into files with N posts. - --verbose - Show more information about the process on STDOUT. +--verbose +: Show more information about the process on STDOUT. ### FILTERS - --start_date=<date> - Export only posts newer than this date, in format YYYY-MM-DD. +--start_date=<date> +: Export only posts newer than this date, in format YYYY-MM-DD. - --end_date=<date> - Export only posts older than this date, in format YYYY-MM-DD. +--end_date=<date> +: Export only posts older than this date, in format YYYY-MM-DD. - --post_type=<post_type> - Export only posts with this post_type. +--post_type=<post_type> +: Export only posts with this post_type. - --post__in=<pid> - Export all posts specified as a comma-separated list of IDs. +--post__in=<pid> +: Export all posts specified as a comma-separated list of IDs. - --author=<login/id> - Export only posts by this author. +--author=<login/id> +: Export only posts by this author. - --category=<category-id> - Export only posts in this category. +--category=<category-id> +: Export only posts in this category. - --post_status=<status> - Export only posts with this status. +--post_status=<status> +: Export only posts with this status. ### EXAMPLES - wp export --dir=/tmp/ --user=admin --post_type=post --start_date=2011-01-01 --end_date=2011-12-31 - - wp export --dir=/tmp/ --post__in=123,124,125 + wp export --dir=/tmp/ --user=admin --post_type=post --start_date=2011-01-01 --end_date=2011-12-31 + wp export --dir=/tmp/ --post__in=123,124,125 diff --git a/commands/help/index.md b/commands/help/index.md index 22b8e35c..5d97db4f 100644 --- a/commands/help/index.md +++ b/commands/help/index.md @@ -3,17 +3,13 @@ layout: default title: 'wp help' --- -`wp help` - Get help on a certain topic. +`wp help` - Get help on a certain command. ### EXAMPLES - # (re)generates all man pages - wp help --gen - - # (re)generate man pages for the `core` command - wp help --gen core - - # (re)generate man page only for the `core download` subcommand - wp help --gen core download + # get help for `core` command + wp help core + # get help for `core download` subcommand + wp help core download diff --git a/commands/import/index.md b/commands/import/index.md new file mode 100644 index 00000000..9d2cbbd3 --- /dev/null +++ b/commands/import/index.md @@ -0,0 +1,18 @@ +--- +layout: default +title: 'wp import' +--- + +`wp import` - Import content from a WXR file. + +### OPTIONS + +<file> +: Path to a valid WXR file for importing. + +--authors=<authors> +: How the author mapping should be handled. Options are 'create', 'mapping.csv', or 'skip'. The first will create any non-existent users from the WXR file. The second will read author mapping associations from a CSV, or create a CSV for editing if the file path doesn't exist. The last option will skip any author mapping. + +--skip=<data-type> +: Skip importing specific data. Supported option is 'attachment'. + diff --git a/commands/media/import/index.md b/commands/media/import/index.md index 8b2c1add..7e966538 100644 --- a/commands/media/import/index.md +++ b/commands/media/import/index.md @@ -7,47 +7,37 @@ title: 'wp media import' ### OPTIONS - <file> - Path to file or files to be imported. Supports the glob(3) capabilities of the current shell. - If file is recognized as a URL (for example, with a scheme of http or ftp), the file will be - downloaded to a temp file before being sideloaded. +<file> +: Path to file or files to be imported. Supports the glob(3) capabilities of the current shell. + If file is recognized as a URL (for example, with a scheme of http or ftp), the file will be + downloaded to a temp file before being sideloaded. -* `--post_id=<post_id>` +--post_id=<post_id> +: ID of the post to attach the imported files to - ID of the post to attach the imported files to +--title=<title> +: Attachment title (post title field) -* `--title=<title>` +--caption=<caption> +: Caption for attachent (post excerpt field) - Attachment title (post title field) +--alt=<alt_text> +: Alt text for image (saved as post meta) -* `--caption=<caption>` - - Caption for attachent (post excerpt field) - -* `--alt=<alt_text>` - - Alt text for image (saved as post meta) - -* `--desc=<description>` - - "Description" field (post content) of attachment post - -* `--featured_image` - - If set, set the imported image as the Featured Image of the post its attached to. +--desc=<description> +: "Description" field (post content) of attachment post +--featured_image +: If set, set the imported image as the Featured Image of the post its attached to. ### EXAMPLES - # Import all jpgs in the current user's "Pictures" directory, not attached to any post - wp media import ~/Pictures/**/*.jpg - - # Import a local image and set it to be the post thumbnail for a post - wp media import ~/Downloads/image.png --post_id=123 --title="A downloaded picture" --featured_image - - # Import an image from the web - wp media import http://s.wordpress.org/style/images/wp-header-logo.png --title='The WordPress logo' --alt="Semantic personal publishing" - + # Import all jpgs in the current user's "Pictures" directory, not attached to any post + wp media import ~/Pictures/**\/*.jpg + # Import a local image and set it to be the post thumbnail for a post + wp media import ~/Downloads/image.png --post_id=123 --title="A downloaded picture" --featured_image + # Import an image from the web + wp media import http://s.wordpress.org/style/images/wp-header-logo.png --title='The WordPress logo' --alt="Semantic personal publishing" diff --git a/commands/media/index.md b/commands/media/index.md index d37167b1..6392d5ba 100644 --- a/commands/media/index.md +++ b/commands/media/index.md @@ -3,7 +3,7 @@ layout: default title: 'wp media' --- -`wp media` - Control the media library and its attachments. +`wp media` - Manage attachments. diff --git a/commands/media/regenerate/index.md b/commands/media/regenerate/index.md index 8bef11e6..88446540 100644 --- a/commands/media/regenerate/index.md +++ b/commands/media/regenerate/index.md @@ -7,15 +7,15 @@ title: 'wp media regenerate' ### OPTIONS - --yes - Answer yes to the confirmation message. +--yes +: Answer yes to the confirmation message. - <attachment-id> - One or more IDs of the attachments to regenerate. +<attachment-id> +: One or more IDs of the attachments to regenerate. ### EXAMPLES - wp media regenerate 123 1337 + wp media regenerate 123 1337 - wp media regenerate --yes + wp media regenerate --yes diff --git a/commands/network-meta/add/index.md b/commands/network-meta/add/index.md new file mode 100644 index 00000000..a0225964 --- /dev/null +++ b/commands/network-meta/add/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp network-meta add' +--- + +`wp network-meta add` - Add a meta field. + + + diff --git a/commands/network-meta/delete/index.md b/commands/network-meta/delete/index.md new file mode 100644 index 00000000..10002022 --- /dev/null +++ b/commands/network-meta/delete/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp network-meta delete' +--- + +`wp network-meta delete` - Delete a meta field. + + + diff --git a/commands/network-meta/get/index.md b/commands/network-meta/get/index.md new file mode 100644 index 00000000..e75e9f04 --- /dev/null +++ b/commands/network-meta/get/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp network-meta get' +--- + +`wp network-meta get` - Get meta field value. + + + diff --git a/commands/network-meta/index.md b/commands/network-meta/index.md new file mode 100644 index 00000000..5de73714 --- /dev/null +++ b/commands/network-meta/index.md @@ -0,0 +1,48 @@ +--- +layout: default +title: 'wp network-meta' +--- + +`wp network-meta` - Manage network custom fields. + +### OPTIONS + +<id> +: The network id (usually 1). + +--format=json +: Encode/decode values as JSON. + +### EXAMPLES + + # get a list of super-admins + wp network-meta get 1 site_admins + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/network-meta/add">add</a></td> + <td>Add a meta field.</td> + </tr> + <tr> + <td><a href="/commands/network-meta/delete">delete</a></td> + <td>Delete a meta field.</td> + </tr> + <tr> + <td><a href="/commands/network-meta/get">get</a></td> + <td>Get meta field value.</td> + </tr> + <tr> + <td><a href="/commands/network-meta/update">update</a></td> + <td>Update a meta field.</td> + </tr> + </tbody> +</table> diff --git a/commands/network-meta/update/index.md b/commands/network-meta/update/index.md new file mode 100644 index 00000000..83cacc61 --- /dev/null +++ b/commands/network-meta/update/index.md @@ -0,0 +1,9 @@ +--- +layout: default +title: 'wp network-meta update' +--- + +`wp network-meta update` - Update a meta field. + + + diff --git a/commands/option/index.md b/commands/option/index.md index 92fa7936..fcd6741e 100644 --- a/commands/option/index.md +++ b/commands/option/index.md @@ -3,23 +3,22 @@ layout: default title: 'wp option' --- -`wp option` - Manage WordPress options. +`wp option` - Manage options. ### OPTIONS - --format=json - Encode/decode values as JSON. +--format=json +: Encode/decode values as JSON. ### EXAMPLES - wp option get siteurl + wp option get siteurl - wp option add my_option foobar + wp option add my_option foobar - wp option update my_option '{"foo": "bar"}' --format=json - - wp option delete my_option + wp option update my_option '{"foo": "bar"}' --format=json + wp option delete my_option ### SUBCOMMANDS diff --git a/commands/plugin/activate/index.md b/commands/plugin/activate/index.md index d610be6c..431edf9d 100644 --- a/commands/plugin/activate/index.md +++ b/commands/plugin/activate/index.md @@ -7,10 +7,9 @@ title: 'wp plugin activate' ### OPTIONS - <plugin> - The plugin to activate. - - --network - If set, the plugin will be activated for the entire multisite network. +<plugin> +: The plugin to activate. +--network +: If set, the plugin will be activated for the entire multisite network. diff --git a/commands/plugin/deactivate/index.md b/commands/plugin/deactivate/index.md index 435bac5e..ef48b678 100644 --- a/commands/plugin/deactivate/index.md +++ b/commands/plugin/deactivate/index.md @@ -7,10 +7,9 @@ title: 'wp plugin deactivate' ### OPTIONS - <plugin> - The plugin to deactivate. - - --network - If set, the plugin will be deactivated for the entire multisite network. +<plugin> +: The plugin to deactivate. +--network +: If set, the plugin will be deactivated for the entire multisite network. diff --git a/commands/plugin/delete/index.md b/commands/plugin/delete/index.md index 530a12c2..9ccffc42 100644 --- a/commands/plugin/delete/index.md +++ b/commands/plugin/delete/index.md @@ -7,12 +7,10 @@ title: 'wp plugin delete' ### OPTIONS -* <plugin>: - - The plugin to delete. +<plugin> +: The plugin to delete. ### EXAMPLES - wp plugin delete hello - + wp plugin delete hello diff --git a/commands/plugin/install/index.md b/commands/plugin/install/index.md index 42bafc53..799a6b6d 100644 --- a/commands/plugin/install/index.md +++ b/commands/plugin/install/index.md @@ -7,23 +7,31 @@ title: 'wp plugin install' ### OPTIONS -* <plugin>: +<plugin|zip|url> +: A plugin slug, the path to a local zip file, or URL to a remote zip file. - A plugin slug or the path to a zip file. - - --version=<version> - If set, get that particular version from wordpress.org, instead of the +--version=<version> +: If set, get that particular version from wordpress.org, instead of the stable version. - --activate - If set, the plugin will be activated immediately after install. +--force +: If set, the command will overwrite any installed version of the plugin, without prompting +for confirmation. + +--activate +: If set, the plugin will be activated immediately after install. ### EXAMPLES - wp plugin install bbpress --version=2.1 --activate + # Install the latest version from wordpress.org and activate + wp plugin install bbpress --activate - wp plugin install bbpress --version=dev + # Install the development version from wordpress.org + wp plugin install bbpress --version=dev - wp plugin install ../my-plugin.zip + # Install from a local zip file + wp plugin install ../my-plugin.zip + # Install from a remote zip file + wp plugin install http://s3.amazonaws.com/bucketname/my-plugin.zip?AWSAccessKeyId=123&Expires=456&Signature=abcdef diff --git a/commands/plugin/list/index.md b/commands/plugin/list/index.md index 6baa4f5c..ab64c09c 100644 --- a/commands/plugin/list/index.md +++ b/commands/plugin/list/index.md @@ -7,11 +7,11 @@ title: 'wp plugin list' ### OPTIONS - --format=<format> - Output list as table, CSV or JSON. Defaults to table. +* `--format`=<format>: -### EXAMPLES + Output list as table, CSV or JSON. Defaults to table. - wp plugin list --format=json +### EXAMPLES + wp plugin list --format=json diff --git a/commands/plugin/path/index.md b/commands/plugin/path/index.md index 7d565d9e..95d092c2 100644 --- a/commands/plugin/path/index.md +++ b/commands/plugin/path/index.md @@ -7,16 +7,15 @@ title: 'wp plugin path' ### OPTIONS - <plugin> - The plugin to get the path to. If not set, will return the path to the +<plugin> +: The plugin to get the path to. If not set, will return the path to the plugins directory. - --dir - If set, get the path to the closest parent directory, instead of the +--dir +: If set, get the path to the closest parent directory, instead of the plugin file. ### EXAMPLES - cd $(wp theme path) - + cd $(wp theme path) diff --git a/commands/plugin/status/index.md b/commands/plugin/status/index.md index 876f761c..c7410f37 100644 --- a/commands/plugin/status/index.md +++ b/commands/plugin/status/index.md @@ -7,6 +7,6 @@ title: 'wp plugin status' ### OPTIONS - <plugin> - A particular plugin to show the status for. +<plugin> +: A particular plugin to show the status for. diff --git a/commands/plugin/toggle/index.md b/commands/plugin/toggle/index.md index 0be68b51..d7e6d4b9 100644 --- a/commands/plugin/toggle/index.md +++ b/commands/plugin/toggle/index.md @@ -7,10 +7,9 @@ title: 'wp plugin toggle' ### OPTIONS - <plugin> - The plugin to toggle. - - --network - If set, the plugin will be toggled for the entire multisite network. +<plugin> +: The plugin to toggle. +--network +: If set, the plugin will be toggled for the entire multisite network. diff --git a/commands/plugin/uninstall/index.md b/commands/plugin/uninstall/index.md index bbe072bd..83653a81 100644 --- a/commands/plugin/uninstall/index.md +++ b/commands/plugin/uninstall/index.md @@ -7,16 +7,14 @@ title: 'wp plugin uninstall' ### OPTIONS -* <plugin>: +<plugin> +: The plugin to uninstall. - The plugin to uninstall. - - --no-delete - If set, the plugin files will not be deleted. Only the uninstall procedure +--no-delete +: If set, the plugin files will not be deleted. Only the uninstall procedure will be run. ### EXAMPLES - wp plugin uninstall hello - + wp plugin uninstall hello diff --git a/commands/plugin/update-all/index.md b/commands/plugin/update-all/index.md index ca5a5f7b..4c89060c 100644 --- a/commands/plugin/update-all/index.md +++ b/commands/plugin/update-all/index.md @@ -7,11 +7,10 @@ title: 'wp plugin update-all' ### OPTIONS - --dry-run - Pretend to do the updates, to see what would happen. +--dry-run +: Pretend to do the updates, to see what would happen. ### EXAMPLES - wp plugin update-all - + wp plugin update-all diff --git a/commands/plugin/update/index.md b/commands/plugin/update/index.md index 856b340c..baab39f7 100644 --- a/commands/plugin/update/index.md +++ b/commands/plugin/update/index.md @@ -7,16 +7,14 @@ title: 'wp plugin update' ### OPTIONS -* <plugin>: +<plugin> +: The plugin to update. - The plugin to update. - - --version=dev - If set, the plugin will be updated to the latest development version, +--version=dev +: If set, the plugin will be updated to the latest development version, regardless of what version is currently installed. ### EXAMPLES - wp plugin update bbpress --version=dev - + wp plugin update bbpress --version=dev diff --git a/commands/post-meta/index.md b/commands/post-meta/index.md index 430e86a7..ac5d1c59 100644 --- a/commands/post-meta/index.md +++ b/commands/post-meta/index.md @@ -7,13 +7,12 @@ title: 'wp post-meta' ### OPTIONS - --format=json - Encode/decode values as JSON. +--format=json +: Encode/decode values as JSON. ### EXAMPLES - wp post-meta set 123 _wp_page_template about.php - + wp post-meta set 123 _wp_page_template about.php ### SUBCOMMANDS diff --git a/commands/post/create/index.md b/commands/post/create/index.md index 9920ef90..55a06129 100644 --- a/commands/post/create/index.md +++ b/commands/post/create/index.md @@ -7,30 +7,28 @@ title: 'wp post create' ### OPTIONS - <filename> - Read post content from <filename>. If this value is present, the - `--post_content` argument will be ignored. +<filename> +: Read post content from <filename>. If this value is present, the + `--post_content` argument will be ignored. - Passing `-` as the filename will cause post content to - be read from STDIN. + Passing `-` as the filename will cause post content to + be read from STDIN. - --<field>=<value> - Field values for the new post. See wp_insert_post(). +--<field>=<value> +: Field values for the new post. See wp_insert_post(). - --edit - Immediately open system's editor to write or edit post content. - - (If content is read from a file, from STDIN, or from the `--post_content` - argument, that text will be loaded into the editor; otherwise, an empty - file will be opened.) +--edit +: Immediately open system's editor to write or edit post content. - --porcelain - Output just the new post id. + If content is read from a file, from STDIN, or from the `--post_content` + argument, that text will be loaded into the editor. -### EXAMPLES +--porcelain +: Output just the new post id. - wp post create --post_type=page --post_status=publish --post_title='A future post' --post-status=future --post_date='2020-12-01 07:00:00' +### EXAMPLES - wp post create page.txt --post_type=page --post_title='Page from file' + wp post create --post_type=page --post_status=publish --post_title='A future post' --post-status=future --post_date='2020-12-01 07:00:00' + wp post create page.txt --post_type=page --post_title='Page from file' diff --git a/commands/post/delete/index.md b/commands/post/delete/index.md index a5adb821..f964b6dc 100644 --- a/commands/post/delete/index.md +++ b/commands/post/delete/index.md @@ -7,16 +7,15 @@ title: 'wp post delete' ### OPTIONS - <ID> - The ID of the post to delete. +<ID> +: The ID of the post to delete. - --force - Skip the trash bin. +--force +: Skip the trash bin. ### EXAMPLES - wp post delete 123 --force - - wp post delete $(wp post list --post_type='page' --format=ids) + wp post delete 123 --force + wp post delete $(wp post list --post_type='page' --format=ids) diff --git a/commands/post/edit/index.md b/commands/post/edit/index.md index b6d1ea67..58e62ffd 100644 --- a/commands/post/edit/index.md +++ b/commands/post/edit/index.md @@ -7,11 +7,10 @@ title: 'wp post edit' ### OPTIONS - <id> - The ID of the post to edit. +<id> +: The ID of the post to edit. ### EXAMPLES - wp post edit 123 - + wp post edit 123 diff --git a/commands/post/generate/index.md b/commands/post/generate/index.md index b93d5b8c..11c86301 100644 --- a/commands/post/generate/index.md +++ b/commands/post/generate/index.md @@ -7,26 +7,25 @@ title: 'wp post generate' ### OPTIONS - --count=<number> - How many posts to generate. Default: 100 +--count=<number> +: How many posts to generate. Default: 100 - --post_type=<type> - The type of the generated posts. Default: 'post' +--post_type=<type> +: The type of the generated posts. Default: 'post' - --post_status=<status> - The status of the generated posts. Default: 'publish' +--post_status=<status> +: The status of the generated posts. Default: 'publish' - --post_author=<login> - The author of the generated posts. Default: none +--post_author=<login> +: The author of the generated posts. Default: none - --post_date=<yyyy-mm-dd> - The date of the generated posts. Default: current date +--post_date=<yyyy-mm-dd> +: The date of the generated posts. Default: current date - --max_depth=<number> - For hierarchical post types, generate child posts down to a certain depth. Default: 1 +--max_depth=<number> +: For hierarchical post types, generate child posts down to a certain depth. Default: 1 ### EXAMPLES - wp post generate --count=10 --post_type=page --post_date=1999-01-04 - + wp post generate --count=10 --post_type=page --post_date=1999-01-04 diff --git a/commands/post/get/index.md b/commands/post/get/index.md index 806832fb..d2d820e7 100644 --- a/commands/post/get/index.md +++ b/commands/post/get/index.md @@ -7,23 +7,22 @@ title: 'wp post get' ### OPTIONS - [--format=<format>] - The format to use when printing the post, acceptable values: +<ID> +: The ID of the post to get. - **content**: Outputs only the post's content. +--format=<format> +: The format to use when printing the post, acceptable values: - **table**: Outputs all fields of the post as a table. Note that the - post_content field is omitted so that the table is readable. + - **content**: Outputs only the post's content. - **json**: Outputs all fields in JSON format. + - **table**: Outputs all fields of the post as a table. Note that the + post_content field is omitted so that the table is readable. - <id> - The ID of the post to get. + - **json**: Outputs all fields in JSON format. ### EXAMPLES - wp post get 12 --format=content - - wp post get 12 > file.txt + wp post get 12 --format=content + wp post get 12 > file.txt diff --git a/commands/post/list/index.md b/commands/post/list/index.md index 4abe8401..6ce0a3a5 100644 --- a/commands/post/list/index.md +++ b/commands/post/list/index.md @@ -7,21 +7,20 @@ title: 'wp post list' ### OPTIONS - --<field>=<value> - One or more args to pass to WP_Query. +--<field>=<value> +: One or more args to pass to WP_Query. - --fields=<fields> - Limit the output to specific object fields. Defaults to ID,post_title,post_name,post_date,post_status. +--fields=<fields> +: Limit the output to specific object fields. Defaults to ID,post_title,post_name,post_date,post_status. - --format=<format> - Output list as table, CSV, JSON, or simply IDs. Defaults to table. +--format=<format> +: Output list as table, CSV, JSON, or simply IDs. Defaults to table. ### EXAMPLES - wp post list --format=ids + wp post list --format=ids - wp post list --post_type=post --posts_per_page=5 --format=json - - wp post list --post_type=page --fields=post_title,post_status + wp post list --post_type=post --posts_per_page=5 --format=json + wp post list --post_type=page --fields=post_title,post_status diff --git a/commands/post/update/index.md b/commands/post/update/index.md index 661a96cd..9d3c6fab 100644 --- a/commands/post/update/index.md +++ b/commands/post/update/index.md @@ -7,14 +7,13 @@ title: 'wp post update' ### OPTIONS - <ID> - The ID of the post to update. +<ID> +: The ID of the post to update. - --<field>=<value> - One or more fields to update. See wp_update_post(). +--<field>=<value> +: One or more fields to update. See wp_update_post(). ### EXAMPLES - wp post update 123 --post_name=something --post_status=draft - + wp post update 123 --post_name=something --post_status=draft diff --git a/commands/rewrite/dump/index.md b/commands/rewrite/dump/index.md index 417c8c3e..523d25b6 100644 --- a/commands/rewrite/dump/index.md +++ b/commands/rewrite/dump/index.md @@ -7,7 +7,6 @@ title: 'wp rewrite dump' ### OPTIONS - --format=json - Output rules in JSON format. - +--format=json +: Output rules in JSON format. diff --git a/commands/rewrite/flush/index.md b/commands/rewrite/flush/index.md index fad2c806..357f185b 100644 --- a/commands/rewrite/flush/index.md +++ b/commands/rewrite/flush/index.md @@ -7,9 +7,6 @@ title: 'wp rewrite flush' ### OPTIONS - --soft - Perform a soft flush - do not overwrite `.htaccess`. The default is to update - `.htaccess` rules as well as rewrite rules in database. - - +--hard +: Perform a hard flush - do not overwrite `.htaccess`. The default is to update `.htaccess` rules as well as rewrite rules in database. diff --git a/commands/rewrite/structure/index.md b/commands/rewrite/structure/index.md index 4e6d37c2..f06ac193 100644 --- a/commands/rewrite/structure/index.md +++ b/commands/rewrite/structure/index.md @@ -7,15 +7,16 @@ title: 'wp rewrite structure' ### OPTIONS -* <permastruct>: +<permastruct> +: The new permalink structure to apply. - The new permalink structure to apply; like "/%year%/%monthnum%/%postname%". +--category-base=<categorybase> +: Set the base for category permalinks, i.e. '/category/'. - --category-base=<categorybase> - Set the base for category permalinks, ie '/category/'. - - --tag-base=<tagbase> - Set the base for tag permalinks, ie '/tag/'. +--tag-base=<tagbase> +: Set the base for tag permalinks, i.e. '/tag/'. +### EXAMPLES + wp rewrite structure '/%year%/%monthnum%/%postname%' diff --git a/commands/role/create/index.md b/commands/role/create/index.md index 3f724d3b..e236a6d7 100644 --- a/commands/role/create/index.md +++ b/commands/role/create/index.md @@ -7,11 +7,11 @@ title: 'wp role create' ### OPTIONS -* <role-key>: +* <role-key>: The internal name of the role, e.g. editor -* <role-name>: +* <role-name>: The publically visible name of the role, e.g. Editor @@ -19,6 +19,5 @@ title: 'wp role create' wp role create approver Approver - wp role create productadmin "Product Administrator" - + wp role create productadmin "Product Administrator" diff --git a/commands/role/delete/index.md b/commands/role/delete/index.md index c2dcc0a5..b89388b9 100644 --- a/commands/role/delete/index.md +++ b/commands/role/delete/index.md @@ -7,7 +7,7 @@ title: 'wp role delete' ### OPTIONS -* <role-key>: +* <role-key>: The internal name of the role, e.g. editor @@ -17,5 +17,3 @@ title: 'wp role delete' wp role delete productadmin - - diff --git a/commands/role/exists/index.md b/commands/role/exists/index.md index 6a3375fc..7c4ace7f 100644 --- a/commands/role/exists/index.md +++ b/commands/role/exists/index.md @@ -5,21 +5,17 @@ title: 'wp role exists' `wp role exists` - Check if a role exists. -### OPTIONS - -* <role-key>: - - The internal name of the role, e.g. editor - - ##DESCRIPTION Will exit with status 0 if the role exists, 1 if it does not. +### OPTIONS -### EXAMPLES +* <role-key>: - wp role exists editor + The internal name of the role, e.g. editor +### EXAMPLES + wp role exists editor diff --git a/commands/role/list/index.md b/commands/role/list/index.md index 720277e8..fdcdf4f0 100644 --- a/commands/role/list/index.md +++ b/commands/role/list/index.md @@ -7,14 +7,13 @@ title: 'wp role list' ### OPTIONS - --fields=<fields> - Limit the output to specific object fields. Defaults to name,role. +--fields=<fields> +: Limit the output to specific object fields. Defaults to name,role. - --format=<format> - Output list as table, CSV or JSON. Defaults to table. +--format=<format> +: Output list as table, CSV or JSON. Defaults to table. ### EXAMPLES wp role list --fields=role --format=csv - diff --git a/commands/scaffold/_s/index.md b/commands/scaffold/_s/index.md index a57fab78..c40c14dd 100644 --- a/commands/scaffold/_s/index.md +++ b/commands/scaffold/_s/index.md @@ -7,19 +7,18 @@ title: 'wp scaffold _s' ### OPTIONS -* <slug>: +<slug> +: The slug for the new theme, used for prefixing functions. - The slug for the new theme, used for prefixing functions. +--activate +: Activate the newly downloaded theme. - --activate - Activate the newly downloaded theme. +--theme_name=<title> +: What to put in the 'Theme Name:' header in style.css - --theme_name=<title> - What to put in the 'Theme Name:' header in style.css +--author=<full name> +: What to put in the 'Author:' header in style.css - --author=<full name> - What to put in the 'Author:' header in style.css - - --author_uri=<http url> - What to put in the 'Author URI:' header in style.css +--author_uri=<http url> +: What to put in the 'Author URI:' header in style.css diff --git a/commands/scaffold/child-theme/index.md b/commands/scaffold/child-theme/index.md index 718460fa..6087c6ea 100644 --- a/commands/scaffold/child-theme/index.md +++ b/commands/scaffold/child-theme/index.md @@ -7,26 +7,24 @@ title: 'wp scaffold child-theme' ### OPTIONS -* <slug>: +<slug> +: The slug for the new child theme. - The slug for the new child theme. +--parent_theme=<slug> +: What to put in the 'Template:' header in style.css - --parent_theme=<slug> - What to put in the 'Template:' header in style.css +--theme_name=<title> +: What to put in the 'Theme Name:' header in style.css - --theme_name=<title> - What to put in the 'Theme Name:' header in style.css +--author=<full name> +: What to put in the 'Author:' header in style.css - --author=<full name> - What to put in the 'Author:' header in style.css +--author_uri=<http url> +: What to put in the 'Author URI:' header in style.css - --author_uri=<http url> - What to put in the 'Author URI:' header in style.css - - --theme_uri=<http url> - What to put in the 'Theme URI:' header in style.css - - --activate - Activate the newly created child theme. +--theme_uri=<http url> +: What to put in the 'Theme URI:' header in style.css +--activate +: Activate the newly created child theme. diff --git a/commands/scaffold/plugin-tests/index.md b/commands/scaffold/plugin-tests/index.md index e67d2e61..75304668 100644 --- a/commands/scaffold/plugin-tests/index.md +++ b/commands/scaffold/plugin-tests/index.md @@ -21,6 +21,5 @@ variable. ### EXAMPLE - wp scaffold plugin-tests hello - + wp scaffold plugin-tests hello diff --git a/commands/scaffold/plugin/index.md b/commands/scaffold/plugin/index.md index a863ef83..b7c4e9bf 100644 --- a/commands/scaffold/plugin/index.md +++ b/commands/scaffold/plugin/index.md @@ -7,10 +7,9 @@ title: 'wp scaffold plugin' ### OPTIONS - --activate - Activate the newly generated plugin. - - --plugin_name=<title> - What to put in the 'Plugin Name:' header +--activate +: Activate the newly generated plugin. +--plugin_name=<title> +: What to put in the 'Plugin Name:' header diff --git a/commands/scaffold/post-type/index.md b/commands/scaffold/post-type/index.md index 035323a5..573fb11d 100644 --- a/commands/scaffold/post-type/index.md +++ b/commands/scaffold/post-type/index.md @@ -7,21 +7,20 @@ title: 'wp scaffold post-type' ### OPTIONS - --label=<label> - The text used to translate the update messages +--label=<label> +: The text used to translate the update messages - --textdomain=<textdomain> - The textdomain to use for the labels. +--textdomain=<textdomain> +: The textdomain to use for the labels. - --theme - Create a file in the current theme directory, instead of sending to -STDOUT. +--theme +: Create a file in the active theme directory, instead of sending to +STDOUT. Specify a theme with `--theme=<theme>` to have the file placed in that theme. - --plugin=<plugin> - Create a file in the given plugin's directory, instead of sending to +--plugin=<plugin> +: Create a file in the given plugin's directory, instead of sending to STDOUT. - --raw - Just generate the `register_post_type()` call and nothing else. - +--raw +: Just generate the `register_post_type()` call and nothing else. diff --git a/commands/scaffold/taxonomy/index.md b/commands/scaffold/taxonomy/index.md index 856fd0fe..48444ebd 100644 --- a/commands/scaffold/taxonomy/index.md +++ b/commands/scaffold/taxonomy/index.md @@ -7,28 +7,27 @@ title: 'wp scaffold taxonomy' ### OPTIONS - --post_types=<post_types> - Post types to register for use with the taxonomy. +--post_types=<post_types> +: Post types to register for use with the taxonomy. - --label=<label> - The text used to translate the update messages +--label=<label> +: The text used to translate the update messages - --textdomain=<textdomain> - The textdomain to use for the labels. +--textdomain=<textdomain> +: The textdomain to use for the labels. - --theme - Create a file in the current theme directory, instead of sending to -STDOUT. +--theme +: Create a file in the active theme directory, instead of sending to +STDOUT. Specify a theme with `--theme=<theme>` to have the file placed in that theme. - --plugin=<plugin> - Create a file in the given plugin's directory, instead of sending to +--plugin=<plugin> +: Create a file in the given plugin's directory, instead of sending to STDOUT. - --raw - Just generate the `register_taxonomy()` call and nothing else. +--raw +: Just generate the `register_taxonomy()` call and nothing else. ### EXAMPLES - wp scaffold taxonomy venue --post_types=event,presentation - + wp scaffold taxonomy venue --post_types=event,presentation diff --git a/commands/search-replace/index.md b/commands/search-replace/index.md index 9276615f..d58a3c78 100644 --- a/commands/search-replace/index.md +++ b/commands/search-replace/index.md @@ -13,19 +13,18 @@ It will correctly handle serialized values, and will not change primary key valu ### OPTIONS - --network - Search/replace through all the tables in a multisite install. +--network +: Search/replace through all the tables in a multisite install. - --skip-columns=<columns> - Do not perform the replacement in the comma-separated columns. +--skip-columns=<columns> +: Do not perform the replacement in the comma-separated columns. - --dry-run - Show report, but don't perform the changes. +--dry-run +: Show report, but don't perform the changes. ### EXAMPLES - wp search-replace 'http://example.dev' 'http://example.com' --skip-columns=guid - - wp search-replace 'foo' 'bar' wp_posts wp_postmeta wp_terms --dry-run + wp search-replace 'http://example.dev' 'http://example.com' --skip-columns=guid + wp search-replace 'foo' 'bar' wp_posts wp_postmeta wp_terms --dry-run diff --git a/commands/shell/index.md b/commands/shell/index.md index 1582d694..aab80098 100644 --- a/commands/shell/index.md +++ b/commands/shell/index.md @@ -11,7 +11,6 @@ title: 'wp shell' ### OPTIONS - --basic - Start in fail-safe mode, even if Boris is available. - +--basic +: Start in fail-safe mode, even if Boris is available. diff --git a/commands/site/create/index.md b/commands/site/create/index.md new file mode 100644 index 00000000..b9791ed4 --- /dev/null +++ b/commands/site/create/index.md @@ -0,0 +1,27 @@ +--- +layout: default +title: 'wp site create' +--- + +`wp site create` - Create a site in a multisite install. + +### OPTIONS + +--slug=<slug> +: Path for the new site. Subdomain on subdomain installs, directory on subdirectory installs. + +--title=<title&gt; +: Title of the new site. Default: prettified slug. + +--email=<email> +: Email for Admin user. User will be created if none exists. Assignement to Super Admin if not included. + +--network_id=<network-id> +: Network to associate new site with. Defaults to current network (typically 1). + +--private +: If set, the new site will be non-public (not indexed) + +--porcelain +: If set, only the site id will be output on success. + diff --git a/commands/site/delete/index.md b/commands/site/delete/index.md new file mode 100644 index 00000000..4330f0e5 --- /dev/null +++ b/commands/site/delete/index.md @@ -0,0 +1,21 @@ +--- +layout: default +title: 'wp site delete' +--- + +`wp site delete` - Delete a site in a multisite install. + +### OPTIONS + +<blog-id> +: The id of the blog to delete. If not provided, you must set the --slug parameter. + +--slug=<slug> +: Path of the blog to be deleted. Subdomain on subdomain installs, directory on subdirectory installs. + +--yes +: Answer yes to the confirmation message. + +--keep-tables +: Delete the blog from the list, but don't drop it's tables. + diff --git a/commands/site/empty/index.md b/commands/site/empty/index.md new file mode 100644 index 00000000..3542bb95 --- /dev/null +++ b/commands/site/empty/index.md @@ -0,0 +1,12 @@ +--- +layout: default +title: 'wp site empty' +--- + +`wp site empty` - Empty a site of its content (posts, comments, and terms). + +### OPTIONS + +--yes +: Proceed to empty the site without a confirmation prompt. + diff --git a/commands/site/index.md b/commands/site/index.md new file mode 100644 index 00000000..a4de79b0 --- /dev/null +++ b/commands/site/index.md @@ -0,0 +1,33 @@ +--- +layout: default +title: 'wp site' +--- + +`wp site` - Perform site-wide operations. + + + +### SUBCOMMANDS + +<table> + <thead> + <tr> + <th>Name</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><a href="/commands/site/create">create</a></td> + <td>Create a site in a multisite install.</td> + </tr> + <tr> + <td><a href="/commands/site/delete">delete</a></td> + <td>Delete a site in a multisite install.</td> + </tr> + <tr> + <td><a href="/commands/site/empty">empty</a></td> + <td>Empty a site of its content (posts, comments, and terms).</td> + </tr> + </tbody> +</table> diff --git a/commands/term/create/index.md b/commands/term/create/index.md index f7f5ae31..299900d4 100644 --- a/commands/term/create/index.md +++ b/commands/term/create/index.md @@ -7,26 +7,25 @@ title: 'wp term create' ### OPTIONS - <term> - A name for the new term. +<term> +: A name for the new term. - <taxonomy> - Taxonomy for the new term. +<taxonomy> +: Taxonomy for the new term. - --slug=<slug> - A unique slug for the new term. Defaults to sanitized version of name. +--slug=<slug> +: A unique slug for the new term. Defaults to sanitized version of name. - --description=<description> - A description for the new term. +--description=<description> +: A description for the new term. - --parent=<term-id> - A parent for the new term. +--parent=<term-id> +: A parent for the new term. - --porcelain - Output just the new term id. +--porcelain +: Output just the new term id. ### EXAMPLES - wp term create Apple category --description="A type of fruit" - + wp term create Apple category --description="A type of fruit" diff --git a/commands/term/delete/index.md b/commands/term/delete/index.md index bcbee301..2b2a7fea 100644 --- a/commands/term/delete/index.md +++ b/commands/term/delete/index.md @@ -7,13 +7,13 @@ title: 'wp term delete' ### OPTIONS - <term-id> - ID for the term to delete. +<term-id> +: ID for the term to delete. - <taxonomy> - Taxonomy of the term to delete. +<taxonomy> +: Taxonomy of the term to delete. ### EXAMPLES - wp term delete 15 category + wp term delete 15 category diff --git a/commands/term/list/index.md b/commands/term/list/index.md index 0292dd84..37948359 100644 --- a/commands/term/list/index.md +++ b/commands/term/list/index.md @@ -7,19 +7,18 @@ title: 'wp term list' ### OPTIONS - <taxonomy> - List terms of a given taxonomy. +<taxonomy> +: List terms of a given taxonomy. - --fields=<fields> - Limit the output to specific object fields. Defaults to all of the term object fields. +--fields=<fields> +: Limit the output to specific object fields. Defaults to all of the term object fields. - --format=<format> - Output list as table, CSV, JSON, or simply IDs. Defaults to table. +--format=<format> +: Output list as table, CSV, JSON, or simply IDs. Defaults to table. ### EXAMPLES - wp term list category --format=csv - - wp term list post_tag --fields=name,slug + wp term list category --format=csv + wp term list post_tag --fields=name,slug diff --git a/commands/term/update/index.md b/commands/term/update/index.md index 1cb306eb..b9dc3fc7 100644 --- a/commands/term/update/index.md +++ b/commands/term/update/index.md @@ -7,26 +7,25 @@ title: 'wp term update' ### OPTIONS - <term-id> - ID for the term to update. +<term-id> +: ID for the term to update. - <taxonomy> - Taxonomy of the term to update. +<taxonomy> +: Taxonomy of the term to update. - --name=<name> - A new name for the term. +--name=<name> +: A new name for the term. - --slug=<slug> - A new slug for the term. +--slug=<slug> +: A new slug for the term. - --description=<description> - A new description for the term. +--description=<description> +: A new description for the term. - --parent=<term-id> - A new parent for the term. +--parent=<term-id> +: A new parent for the term. ### EXAMPLES - wp term update 15 category --name=Apple - + wp term update 15 category --name=Apple diff --git a/commands/theme/activate/index.md b/commands/theme/activate/index.md index f57fec24..181296ec 100644 --- a/commands/theme/activate/index.md +++ b/commands/theme/activate/index.md @@ -7,7 +7,6 @@ title: 'wp theme activate' ### OPTIONS - <theme> - The theme to activate. - +<theme> +: The theme to activate. diff --git a/commands/theme/delete/index.md b/commands/theme/delete/index.md index 85dff142..942745f4 100644 --- a/commands/theme/delete/index.md +++ b/commands/theme/delete/index.md @@ -7,11 +7,10 @@ title: 'wp theme delete' ### OPTIONS - <theme> - The theme to delete. +<theme> +: The theme to delete. ### EXAMPLES - wp theme delete twentyeleven - + wp theme delete twentyeleven diff --git a/commands/theme/install/index.md b/commands/theme/install/index.md index 20cec17f..10f53907 100644 --- a/commands/theme/install/index.md +++ b/commands/theme/install/index.md @@ -7,16 +7,24 @@ title: 'wp theme install' ### OPTIONS - <theme> - A theme slug or the path to a zip file. +<theme|zip|url> +: A theme slug, the path to a local zip file, or URL to a remote zip file. - --activate - If set, the theme will be activated immediately after install. +--force +: If set, the command will overwrite any installed version of the theme, without prompting +for confirmation. + +--activate +: If set, the theme will be activated immediately after install. ### EXAMPLES - wp theme install twentytwelve --activate + # Install the latest version from wordpress.org and activate + wp theme install twentytwelve --activate - wp theme install ../my-theme.zip + # Install from a local zip file + wp theme install ../my-theme.zip + # Install from a remote zip file + wp theme install http://s3.amazonaws.com/bucketname/my-theme.zip?AWSAccessKeyId=123&Expires=456&Signature=abcdef diff --git a/commands/theme/list/index.md b/commands/theme/list/index.md index 40816044..5d7990ad 100644 --- a/commands/theme/list/index.md +++ b/commands/theme/list/index.md @@ -7,11 +7,11 @@ title: 'wp theme list' ### OPTIONS - --format=<format> - Output list as table, CSV or JSON. Defaults to table. +* `--format`=<format>: -### EXAMPLES + Output list as table, CSV or JSON. Defaults to table. - wp theme list --format=csv +### EXAMPLES + wp theme list --format=csv diff --git a/commands/theme/path/index.md b/commands/theme/path/index.md index 6308fd9b..541b9c75 100644 --- a/commands/theme/path/index.md +++ b/commands/theme/path/index.md @@ -7,16 +7,15 @@ title: 'wp theme path' ### OPTIONS - <theme> - The theme to get the path to. If not set, will return the path to the +<theme> +: The theme to get the path to. If not set, will return the path to the themes directory. - --dir - If set, get the path to the closest parent directory, instead of the +--dir +: If set, get the path to the closest parent directory, instead of the theme file. ### EXAMPLES - cd $(wp theme path) - + cd $(wp theme path) diff --git a/commands/theme/status/index.md b/commands/theme/status/index.md index be030faf..b583b8c3 100644 --- a/commands/theme/status/index.md +++ b/commands/theme/status/index.md @@ -7,7 +7,6 @@ title: 'wp theme status' ### OPTIONS - <theme> - A particular theme to show the status for. - +<theme> +: A particular theme to show the status for. diff --git a/commands/theme/update-all/index.md b/commands/theme/update-all/index.md index 73bff567..f301cb03 100644 --- a/commands/theme/update-all/index.md +++ b/commands/theme/update-all/index.md @@ -7,11 +7,10 @@ title: 'wp theme update-all' ### OPTIONS - --dry-run - Pretend to do the updates, to see what would happen. +--dry-run +: Pretend to do the updates, to see what would happen. ### EXAMPLES - wp theme update-all - + wp theme update-all diff --git a/commands/theme/update/index.md b/commands/theme/update/index.md index efa5b344..66bcf442 100644 --- a/commands/theme/update/index.md +++ b/commands/theme/update/index.md @@ -7,15 +7,14 @@ title: 'wp theme update' ### OPTIONS - <theme> - The theme to update. +<theme> +: The theme to update. - --version=dev - If set, the theme will be updated to the latest development version, +--version=dev +: If set, the theme will be updated to the latest development version, regardless of what version is currently installed. ### EXAMPLES - wp theme update twentytwelve - + wp theme update twentytwelve diff --git a/commands/transient/index.md b/commands/transient/index.md index ff8b511b..5ff8709d 100644 --- a/commands/transient/index.md +++ b/commands/transient/index.md @@ -3,12 +3,11 @@ layout: default title: 'wp transient' --- -`wp transient` - Manage WordPress transients. +`wp transient` - Manage transients. ### EXAMPLES - wp transient set my_key my_value 300 - + wp transient set my_key my_value 300 ### SUBCOMMANDS diff --git a/commands/user-meta/index.md b/commands/user-meta/index.md index c7d49a18..c0ffce92 100644 --- a/commands/user-meta/index.md +++ b/commands/user-meta/index.md @@ -7,13 +7,12 @@ title: 'wp user-meta' ### OPTIONS - --format=json - Encode/decode values as JSON. +--format=json +: Encode/decode values as JSON. ### EXAMPLES - wp user-meta set 123 description "Mary is a WordPress developer." - + wp user-meta set 123 description "Mary is a WordPress developer." ### SUBCOMMANDS diff --git a/commands/user/add-role/index.md b/commands/user/add-role/index.md index 52391398..79e104a6 100644 --- a/commands/user/add-role/index.md +++ b/commands/user/add-role/index.md @@ -5,5 +5,16 @@ title: 'wp user add-role' `wp user add-role` - Add a role for a user. +### OPTIONS +<user> +: User ID or user login. + +<role> +: Add the specified role to the user. + +### EXAMPLES + + wp user set-role bob author + wp user set-role 12 author diff --git a/commands/user/create/index.md b/commands/user/create/index.md index b1ab1209..ed41ae76 100644 --- a/commands/user/create/index.md +++ b/commands/user/create/index.md @@ -7,29 +7,28 @@ title: 'wp user create' ### OPTIONS - <user-login> - The login of the user to create. +<user-login> +: The login of the user to create. - <user-email> - The email address of the user to create. +<user-email> +: The email address of the user to create. - --role=<role> - The role of the user to create. Default: default role +--role=<role> +: The role of the user to create. Default: default role - --user_pass=<password> - The user password. Default: randomly generated +--user_pass=<password> +: The user password. Default: randomly generated - --user_registered=<yyyy-mm-dd> - The date the user registered. Default: current date +--user_registered=<yyyy-mm-dd> +: The date the user registered. Default: current date - --display_name=<name> - The display name. +--display_name=<name> +: The display name. - --porcelain - Output just the new user id. +--porcelain +: Output just the new user id. ### EXAMPLES - wp user create bob bob@example.com --role=author - + wp user create bob bob@example.com --role=author diff --git a/commands/user/delete/index.md b/commands/user/delete/index.md index e0a002e1..7579a328 100644 --- a/commands/user/delete/index.md +++ b/commands/user/delete/index.md @@ -7,14 +7,13 @@ title: 'wp user delete' ### OPTIONS - <ID> - The ID of the user to delete. +<user> +: The user login or ID of the user to delete. - --reassign=<ID> - User to reassign the posts to. +--reassign=<ID> +: User to reassign the posts to. ### EXAMPLES - wp user delete 123 --reassign=567 - + wp user delete 123 --reassign=567 diff --git a/commands/user/generate/index.md b/commands/user/generate/index.md index 5aa6c21c..b65b43db 100644 --- a/commands/user/generate/index.md +++ b/commands/user/generate/index.md @@ -7,10 +7,9 @@ title: 'wp user generate' ### OPTIONS - --count=<number> - How many users to generate. Default: 100 - - --role=<role> - The role of the generated users. Default: default role from WP +--count=<number> +: How many users to generate. Default: 100 +--role=<role> +: The role of the generated users. Default: default role from WP diff --git a/commands/user/get/index.md b/commands/user/get/index.md new file mode 100644 index 00000000..d5a75a70 --- /dev/null +++ b/commands/user/get/index.md @@ -0,0 +1,25 @@ +--- +layout: default +title: 'wp user get' +--- + +`wp user get` - Get a single user. + +### OPTIONS + +<user> +: User ID or user login. + +--format=<format> +: The format to use when printing the user; acceptable values: + + **table**: Outputs all fields of the user as a table. + + **json**: Outputs all fields in JSON format. + +### EXAMPLES + + wp user get 12 + + wp user get bob --format=json > bob.json + diff --git a/commands/user/import-csv/index.md b/commands/user/import-csv/index.md index 7f019adb..37bba9fb 100644 --- a/commands/user/import-csv/index.md +++ b/commands/user/import-csv/index.md @@ -7,18 +7,17 @@ title: 'wp user import-csv' ### OPTIONS - <file> - The CSV file of users to import. +<file> +: The CSV file of users to import. ### EXAMPLES - wp user import-csv /path/to/users.csv + wp user import-csv /path/to/users.csv - Sample users.csv file: - - user_login,user_email,display_name,role - bobjones,bobjones@domain.com,Bob Jones,contributor - newuser1,newuser1@domain.com,New User,author - existinguser,existinguser@domain.com,Existing User,administrator + Sample users.csv file: + user_login,user_email,display_name,role + bobjones,bobjones@domain.com,Bob Jones,contributor + newuser1,newuser1@domain.com,New User,author + existinguser,existinguser@domain.com,Existing User,administrator diff --git a/commands/user/index.md b/commands/user/index.md index 703c1a88..bf27b68b 100644 --- a/commands/user/index.md +++ b/commands/user/index.md @@ -33,6 +33,10 @@ title: 'wp user' <td><a href="/commands/user/generate">generate</a></td> <td>Generate users.</td> </tr> + <tr> + <td><a href="/commands/user/get">get</a></td> + <td>Get a single user.</td> + </tr> <tr> <td><a href="/commands/user/import-csv">import-csv</a></td> <td>Import users from a CSV file.</td> diff --git a/commands/user/list/index.md b/commands/user/list/index.md index b3678bce..33b3237e 100644 --- a/commands/user/list/index.md +++ b/commands/user/list/index.md @@ -7,21 +7,20 @@ title: 'wp user list' ### OPTIONS - --role=<role> - Only display users with a certain role. +--role=<role> +: Only display users with a certain role. - --fields=<fields> - Limit the output to specific object fields. Defaults to ID,user_login,display_name,user_email,user_registered,roles +--fields=<fields> +: Limit the output to specific object fields. Defaults to ID,user_login,display_name,user_email,user_registered,roles - --format=<format> - Output list as table, CSV, JSON, or simply IDs. Defaults to table. +--format=<format> +: Output list as table, CSV, JSON, or simply IDs. Defaults to table. ### EXAMPLES - wp user list --format=ids + wp user list --format=ids - wp user list --role=administrator --format=csv - - wp user list --fields=display_name,user_email + wp user list --role=administrator --format=csv + wp user list --fields=display_name,user_email diff --git a/commands/user/remove-role/index.md b/commands/user/remove-role/index.md index 77d3d66a..d0a5f57b 100644 --- a/commands/user/remove-role/index.md +++ b/commands/user/remove-role/index.md @@ -7,12 +7,11 @@ title: 'wp user remove-role' ### OPTIONS - <user-login> - User ID or user login. +<user> +: User ID or user login. ### EXAMPLES - wp user remove-role bob - wp user remove-role 12 - + wp user remove-role bob + wp user remove-role 12 diff --git a/commands/user/set-role/index.md b/commands/user/set-role/index.md index c876970b..f1447ed9 100644 --- a/commands/user/set-role/index.md +++ b/commands/user/set-role/index.md @@ -7,15 +7,15 @@ title: 'wp user set-role' ### OPTIONS - <user-login> - User ID or user login. +<user> +: User ID or user login. - [<role>] - Add the user with the specified role. Defaults to blog default. +[<role>] +: Make the user have the specified role. If not passed, the default role is +used. ### EXAMPLES - wp user set-role bob author - wp user set-role 12 author - + wp user set-role bob author + wp user set-role 12 author diff --git a/commands/user/update/index.md b/commands/user/update/index.md index 24ab278b..72d18c60 100644 --- a/commands/user/update/index.md +++ b/commands/user/update/index.md @@ -7,14 +7,15 @@ title: 'wp user update' ### OPTIONS - <ID> - The ID of the user to update. +<user> +: The user login or ID of the user to update. - --<field>=<value> - One or more fields to update. For accepted fields, see wp_update_user(). +--<field>=<value> +: One or more fields to update. For accepted fields, see wp_update_user(). ### EXAMPLES - wp user update 123 --user_login=mary --display_name=Mary + wp user update 123 --user_login=mary --display_name=Mary + wp user update mary --user_pass=marypass From 69537daaec8e37b95b1619b71a399ca5f8b22efd Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Sun, 4 Aug 2013 23:17:42 +0300 Subject: [PATCH 180/194] point old commands to new commands --- commands/blog/create/index.md | 25 +-------------------- commands/blog/delete/index.md | 19 +--------------- commands/blog/empty/index.md | 8 +------ commands/blog/index.md | 30 +------------------------- commands/core/install-network/index.md | 17 +-------------- 5 files changed, 5 insertions(+), 94 deletions(-) diff --git a/commands/blog/create/index.md b/commands/blog/create/index.md index 9d69fa15..6309a190 100644 --- a/commands/blog/create/index.md +++ b/commands/blog/create/index.md @@ -2,27 +2,4 @@ layout: default title: 'wp blog create' --- - -`wp blog create` - Create a blog in a multisite install. - -### OPTIONS - - --slug=<slug> - Path for the new blog. Subdomain on subdomain installs, directory on subdirectory installs. - - --title=<title> - Title of the new blog. Default: prettified slug. - - --email=<email> - Email for Admin user. User will be created if none exists. Assignement to Super Admin if not included. - - --site_id=<site-id> - Site (network) to associate new blog with. Defaults to current site (typically 1). - - --private - If set, the new blog will be non-public (not indexed) - - --porcelain - If set, only the blog id will be output on success. - - +The `wp blog create` command has been renamed to [wp site create](/commands/site/create) in WP-CLI 0.11. diff --git a/commands/blog/delete/index.md b/commands/blog/delete/index.md index c57a5919..e0bd27f4 100644 --- a/commands/blog/delete/index.md +++ b/commands/blog/delete/index.md @@ -2,21 +2,4 @@ layout: default title: 'wp blog delete' --- - -`wp blog delete` - Delete a blog in a multisite install. - -### OPTIONS - - <blog-id> - The id of the blog to delete. If not provided, you must set the --slug parameter. - - --slug=<slug> - Path of the blog to be deleted. Subdomain on subdomain installs, directory on subdirectory installs. - - --yes - Answer yes to the confirmation message. - - --keep-tables - Delete the blog from the list, but don't drop it's tables. - - +The `wp blog delete` command has been renamed to [wp site delete](/commands/site/delete) in WP-CLI 0.11. diff --git a/commands/blog/empty/index.md b/commands/blog/empty/index.md index ec4cc797..e6219d29 100644 --- a/commands/blog/empty/index.md +++ b/commands/blog/empty/index.md @@ -2,10 +2,4 @@ layout: default title: 'wp blog empty' --- - -`wp blog empty` - Empty a blog of its content. - -### EXAMPLES - - wp blog empty - +The `wp blog empty` command has been renamed to [wp site empty](/commands/site/empty) in WP-CLI 0.11. diff --git a/commands/blog/index.md b/commands/blog/index.md index efb060bf..eaf889a0 100644 --- a/commands/blog/index.md +++ b/commands/blog/index.md @@ -2,32 +2,4 @@ layout: default title: 'wp blog' --- - -`wp blog` - Manage blogs in a multisite install. - - - -### SUBCOMMANDS - -<table> - <thead> - <tr> - <th>Name</th> - <th>Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><a href="/commands/blog/create">create</a></td> - <td>Create a blog in a multisite install.</td> - </tr> - <tr> - <td><a href="/commands/blog/delete">delete</a></td> - <td>Delete a blog in a multisite install.</td> - </tr> - <tr> - <td><a href="/commands/blog/empty">empty</a></td> - <td>Empty a blog of its content.</td> - </tr> - </tbody> -</table> +The `wp blog` command has been renamed to [wp site](/commands/site) in WP-CLI 0.11. diff --git a/commands/core/install-network/index.md b/commands/core/install-network/index.md index 45dc3617..14d8ec06 100644 --- a/commands/core/install-network/index.md +++ b/commands/core/install-network/index.md @@ -2,19 +2,4 @@ layout: default title: 'wp core install-network' --- - -`wp core install-network` - Transform a single-site install into a multi-site install. - -### OPTIONS - - --title=<site-title> - The title of the new network. - - --base=<url-path> - Base path after the domain name that each site url will start with. -Default: '/' - - --subdomains - If passed, the network will use subdomains, instead of subdirectories. - - +The `wp core install-network` command has been renamed to [wp core multisite-convert](/commands/core/multisite-convert) in WP-CLI 0.11. From 9f627ca86592cfc50d263ccf329695534ad59d25 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Sun, 4 Aug 2013 23:25:38 +0300 Subject: [PATCH 181/194] don't clear /commands/ directory when generating --- Phakefile.php | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Phakefile.php b/Phakefile.php index 9fa584d9..384065cf 100644 --- a/Phakefile.php +++ b/Phakefile.php @@ -52,7 +52,9 @@ function gen_cmd_pages( $cmd, $parent = array() ) { } $path = __DIR__ . "/commands/" . $binding['path']; - mkdir( $path ); + if ( !is_dir( $path ) ) { + mkdir( $path ); + } file_put_contents( "$path/index.md", render( 'subcmd-list.mustache', $binding ) ); if ( !isset( $cmd['subcommands'] ) ) @@ -70,8 +72,6 @@ function gen_cmd_pages( $cmd, $parent = array() ) { // generate main page file_put_contents( '_includes/cmd-list.html', render( 'cmd-list.mustache', $wp ) ); - system( sprintf( 'rm -rf %s/commands/*/', escapeshellarg( __DIR__ ) ) ); - foreach ( $wp['subcommands'] as $cmd ) { gen_cmd_pages( $cmd ); } From d8a831c6490f07ae137dcc6d517325a71eb845bb Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Sun, 4 Aug 2013 23:31:28 +0300 Subject: [PATCH 182/194] update docs for 'wp cli' --- commands/cli/cmd-dump/index.md | 2 +- commands/cli/completions/index.md | 2 +- commands/cli/index.md | 10 +++++----- commands/cli/info/index.md | 2 +- commands/cli/param-dump/index.md | 2 +- commands/cli/version/index.md | 2 +- 6 files changed, 10 insertions(+), 10 deletions(-) diff --git a/commands/cli/cmd-dump/index.md b/commands/cli/cmd-dump/index.md index a802f09f..b9057949 100644 --- a/commands/cli/cmd-dump/index.md +++ b/commands/cli/cmd-dump/index.md @@ -3,7 +3,7 @@ layout: default title: 'wp cli cmd-dump' --- -`wp cli cmd-dump` - +`wp cli cmd-dump` - Dump the list of installed commands, as JSON. diff --git a/commands/cli/completions/index.md b/commands/cli/completions/index.md index 5d11a782..19dadd80 100644 --- a/commands/cli/completions/index.md +++ b/commands/cli/completions/index.md @@ -3,7 +3,7 @@ layout: default title: 'wp cli completions' --- -`wp cli completions` - +`wp cli completions` - Generate tab completion strings. diff --git a/commands/cli/index.md b/commands/cli/index.md index 68f91e72..9d116d02 100644 --- a/commands/cli/index.md +++ b/commands/cli/index.md @@ -19,23 +19,23 @@ title: 'wp cli' <tbody> <tr> <td><a href="/commands/cli/cmd-dump">cmd-dump</a></td> - <td></td> + <td>Dump the list of installed commands, as JSON.</td> </tr> <tr> <td><a href="/commands/cli/completions">completions</a></td> - <td></td> + <td>Generate tab completion strings.</td> </tr> <tr> <td><a href="/commands/cli/info">info</a></td> - <td></td> + <td>Print various data about the CLI environment.</td> </tr> <tr> <td><a href="/commands/cli/param-dump">param-dump</a></td> - <td></td> + <td>Dump the list of global parameters, as JSON.</td> </tr> <tr> <td><a href="/commands/cli/version">version</a></td> - <td></td> + <td>Print WP-CLI version.</td> </tr> </tbody> </table> diff --git a/commands/cli/info/index.md b/commands/cli/info/index.md index 01c6a67b..dad4889b 100644 --- a/commands/cli/info/index.md +++ b/commands/cli/info/index.md @@ -3,7 +3,7 @@ layout: default title: 'wp cli info' --- -`wp cli info` - +`wp cli info` - Print various data about the CLI environment. diff --git a/commands/cli/param-dump/index.md b/commands/cli/param-dump/index.md index 23095928..3956280c 100644 --- a/commands/cli/param-dump/index.md +++ b/commands/cli/param-dump/index.md @@ -3,7 +3,7 @@ layout: default title: 'wp cli param-dump' --- -`wp cli param-dump` - +`wp cli param-dump` - Dump the list of global parameters, as JSON. diff --git a/commands/cli/version/index.md b/commands/cli/version/index.md index 33743da4..e109a7da 100644 --- a/commands/cli/version/index.md +++ b/commands/cli/version/index.md @@ -3,7 +3,7 @@ layout: default title: 'wp cli version' --- -`wp cli version` - +`wp cli version` - Print WP-CLI version. From 3f54275265e7c772d005fb932e5cf39ab1e4604c Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Mon, 5 Aug 2013 01:05:52 +0300 Subject: [PATCH 183/194] space out the definition lists a little --- assets/css/stylesheet.css | 1 + 1 file changed, 1 insertion(+) diff --git a/assets/css/stylesheet.css b/assets/css/stylesheet.css index 8fa212fd..0c2fad44 100644 --- a/assets/css/stylesheet.css +++ b/assets/css/stylesheet.css @@ -142,6 +142,7 @@ h1, h2, h3, h4, h5, h6 { dt { font-style: italic; font-weight: bold; + margin-top: 20px; } ul li { From 33c7d4898c70ea6241ce0cd9b80461b53521f058 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Mon, 5 Aug 2013 01:12:24 +0300 Subject: [PATCH 184/194] switch to Kramdown syntax for fenced code blocks --- _posts/2013-03-16-editing-posts.md | 4 +- ...olding-custom-post-types-and-taxonomies.md | 28 +++++----- index.md | 56 +++++++++---------- 3 files changed, 44 insertions(+), 44 deletions(-) diff --git a/_posts/2013-03-16-editing-posts.md b/_posts/2013-03-16-editing-posts.md index cbf1209d..ca82222e 100644 --- a/_posts/2013-03-16-editing-posts.md +++ b/_posts/2013-03-16-editing-posts.md @@ -7,9 +7,9 @@ A few years ago, I came across a very interesting project by Joseph Scott, calle With [WP-CLI](/) 0.9.0-beta, you can do the same thing: -```bash +~~~bash wp post edit 123 -``` +~~~ Once you run that command, your `$EDITOR` will open up, pre-filled with the content of the post with ID 123. After you've made your changes and quit the editor, WP-CLI will update the post in the database. diff --git a/_posts/2013-03-29-scaffolding-custom-post-types-and-taxonomies.md b/_posts/2013-03-29-scaffolding-custom-post-types-and-taxonomies.md index f7c38e73..2ad0bf25 100644 --- a/_posts/2013-03-29-scaffolding-custom-post-types-and-taxonomies.md +++ b/_posts/2013-03-29-scaffolding-custom-post-types-and-taxonomies.md @@ -11,25 +11,25 @@ Now you can do this with WP-CLI, using the `wp scaffold` command. The following command generates the code for registering the post type and also for customizing the update messages: -```bash +~~~bash wp scaffold post-type zombie -``` +~~~ ### Scaffold a taxonomy The following command generates the code for registering the taxonomy to the zombie post type: -```bash +~~~bash wp scaffold taxonomy zombie-speed --post-type=zombie -``` +~~~ ### But I only want the registration of the post-type... Then you can add the `--raw` flag: -```bash +~~~bash wp scaffold post-type zombie --raw -``` +~~~ This will only output the code that will `register_post_type()` without the `init` action and the update messages. @@ -37,31 +37,31 @@ This will only output the code that will `register_post_type()` without the `ini This is a personal preference. Some ship it within a theme, while others will save it within a plugin. That's why we have these two flags: -```bash +~~~bash wp scaffold post-type zombie --theme -``` +~~~ `--theme` stores the generated code within your current active theme under a `/post-types` directory and names a file name `zombie.php` -```bash +~~~bash wp scaffold post-type zombie --plugin=pluginname -``` +~~~ `--plugin=plugin-dir-name` stores the generated code within the given plugin name. By default, the code will be output to your terminal (STDOUT) so you could write it to your file of choice: -```bash +~~~bash wp scaffold post-type zombie > ~/project/foo/bar.php -``` +~~~ ### And what about I18n? Internationalization by gettext can be achieved through the `--textdomain` parameter: -```bash +~~~bash wp scaffold post-type zombie --textdomain=my-textdomain -``` +~~~ By default when using the `--theme`, the textdomain will be that of your active theme, and if using the `--plugin` flag, the textdomain will be your plugin name. diff --git a/index.md b/index.md index f767cb63..623422bb 100644 --- a/index.md +++ b/index.md @@ -14,9 +14,9 @@ title: Command line interface for WordPress Just execute the following command in your terminal: -``` +~~~ curl http://wp-cli.org/installer.sh | bash -``` +~~~ Make sure to read the instructions. @@ -27,40 +27,40 @@ WP-CLI comes with a tab completion script for command, subcommand and flag names If you're using **Bash**, add the following lines to `~/.bash_profile`: -``` +~~~ # WP-CLI Bash completions source $HOME/.wp-cli/vendor/wp-cli/wp-cli/utils/wp-completion.bash -``` +~~~ And re-load the file: -``` +~~~ source ~/.bash_profile -``` +~~~ If you're using **Zsh**, add the following lines to `~/.zprofile`: -``` +~~~ # WP-CLI Bash completions autoload bashcompinit bashcompinit source $HOME/.wp-cli/vendor/wp-cli/wp-cli/utils/wp-completion.bash -``` +~~~ And re-load the file: -``` +~~~ source ~/.zprofile -``` +~~~ <h3 id="update">Updating</h3> If you installed WP-CLI using the method above, you can also easily update it: -``` +~~~ cd ~/.wp-cli php composer.phar update -``` +~~~ Also see [Alternative Install Methods](https://github.com/wp-cli/wp-cli/wiki/Alternative-Install-Methods). @@ -68,13 +68,13 @@ Also see [Alternative Install Methods](https://github.com/wp-cli/wp-cli/wiki/Alt Go into a WordPress root folder: -``` +~~~ cd /var/www/wp/ -``` +~~~ Typing `wp` should show you output similar to this: -``` +~~~ Available commands: wp blog create|delete wp cache add|decr|delete|flush|get|incr|replace|set|type @@ -85,50 +85,50 @@ Available commands: ... See 'wp help <command>' for more information on a specific command. -``` +~~~ Let's try to install the Hello Dolly plugin from wordpress.org: -``` +~~~ wp plugin install hello-dolly -``` +~~~ Output: -``` +~~~ Installing Hello Dolly (1.5) Downloading install package from http://downloads.WordPress.org/plugin/hello-dolly.1.5.zip ... Unpacking the package ... Installing the plugin ... Plugin installed successfully. -``` +~~~ <h3 id="multisite">Multisite</h3> On a multisite installation, you need to pass a `--url` parameter, so that WP-CLI knows which site it's supposed to be operating on: -``` +~~~ wp theme status --url=localhost/wp/test -``` +~~~ If you have a subdomain installation, it would look like this: -``` +~~~ wp theme status --url=test.example.com -``` +~~~ If you're usually working on the same site most of the time, you can create a `wp-cli.yml` file in the root directory: -``` +~~~ url: test.example.com -``` +~~~ Then, you can call `wp` without the `--url` parameter again: -``` +~~~ wp theme status -``` +~~~ <h2>Adding commands</h2> From 6b6dc0ebc09b0ec604553d74af33d75490cfc795 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Mon, 5 Aug 2013 03:04:35 +0300 Subject: [PATCH 185/194] add release post for 0.11 --- _posts/2013-08-05-version-0.11.md | 56 +++++++++++++++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 _posts/2013-08-05-version-0.11.md diff --git a/_posts/2013-08-05-version-0.11.md b/_posts/2013-08-05-version-0.11.md new file mode 100644 index 00000000..3499643a --- /dev/null +++ b/_posts/2013-08-05-version-0.11.md @@ -0,0 +1,56 @@ +--- +layout: post +author: scribu +title: Version 0.11 has arrived. +--- +It's been two months since the [last major release](/blog/version-0.10.html). We didn't want to wait any longer to show you all the goodies that we packed into this version. + +### Import content from WXR files + +A significant addition in this release is the [wp import](/commands/import/) command, which is the yin to [wp export](/commands/export/)'s yang. + +It's an iteration on Automattic's [WordPress-CLI-Importer](https://github.com/Automattic/WordPress-CLI-Importer). + +### Install multisite from scratch + +Here's a little puzzle: How do you spin up a multisite install, when you already have a `wp-config.php` file with all the settings? + +Run `wp core install` and then `wp core install-network`? No. Use a dummy `wp-config.php` file and then swap in the real one? Probably not. Learn to play jazz, impress Matt and then ask him to fix the multisite install process? Maybe later. + +To trick WordPress into submission, you have to do a zillion little hacks, strewn throughout the loading process. We took care of this dirty work for you. Just run `wp core multisite-install`. + +### Inline help + +In previous versions, `wp help` called `man` internally. Besides not working on Windows, it also had the significant drawback that you had to use a separate tool to compile man pages. + +In WP-CLI 0.11, we generate the docs on the fly, using the information from the [command PHPDoc](https://github.com/wp-cli/wp-cli/wiki/Commands-Cookbook#longdesc). + +### Support for community packages + +Remember how in the previous release we suggested using [the installer](/#install)? If you followed that recommendation, it should be very easy to install [community packages](https://github.com/wp-cli/wp-cli/wiki/Community-Packages) now. + +### Changelog + +Commands: + +* added [wp import](/commands/import/) command +* added [wp core multisite-install](/commands/core/multisite-install/) command +* renamed `wp core install-network` to `wp core multisite-convert` +* added [wp network-meta](/commands/network-meta/) command +* renamed `wp blog` to `wp site` +* added `--force` flag to `wp plugin install` and `wp theme install` +* added `wp user get` subcommand +* added `--format=count` to `list` subcommands +* made `wp user` commands accept both user logins or user IDs. + +Internals: + +* added support for `@when before_wp_load` annotation +* added support for `apache_modules` config key +* show warning if WordPress version is too old +* support passing `--require=` multiple times +* deprecated `WP_CLI::add_man_dir()` + +You can also browse the full list of [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=10&state=closed) on Github. + +Contributors to this release: [dangardner](https://github.com/dangardner), [danielbachhuber](https://github.com/danielbachhuber), [eugeneware](https://github.com/eugeneware), [jmslbam](https://github.com/jmslbam), [johnbillion](https://github.com/johnbillion), [MiteshShah](https://github.com/MiteshShah), [om4james](https://github.com/om4james), [scribu](https://github.com/scribu), [twratajczak](https://github.com/twratajczak), [Veered](https://github.com/Veered). From 03cf529934c4fdea1a5f46bb2e29c674a20f33fc Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Mon, 5 Aug 2013 21:09:26 +0300 Subject: [PATCH 186/194] add --no-dev flag to 'composer update' command --- index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.md b/index.md index 1fd18a39..077b032d 100644 --- a/index.md +++ b/index.md @@ -59,7 +59,7 @@ If you installed WP-CLI using the method above, you can also easily update it: ~~~ cd ~/.wp-cli -php composer.phar update +php composer.phar update --no-dev ~~~ Also see [Alternative Install Methods](https://github.com/wp-cli/wp-cli/wiki/Alternative-Install-Methods). From 34ce5ad8537bbe9cd2b7b4ea968be3b7b11a5ca6 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Mon, 5 Aug 2013 21:33:51 +0300 Subject: [PATCH 187/194] add 'composer self-update' step ... in case the user has a very old version without a --no-dev flag. (see parent commit) --- index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/index.md b/index.md index 077b032d..a3bce3dc 100644 --- a/index.md +++ b/index.md @@ -59,6 +59,7 @@ If you installed WP-CLI using the method above, you can also easily update it: ~~~ cd ~/.wp-cli +php composer.phar self-update php composer.phar update --no-dev ~~~ From a28aa906781dde5d9a423e07babe1713d5bed206 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Tue, 6 Aug 2013 21:53:36 +0300 Subject: [PATCH 188/194] remove old 'autocomplete' anchor; messes with Kramdown fixes wp-cli/wp-cli#644 --- index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/index.md b/index.md index a3bce3dc..01431e5a 100644 --- a/index.md +++ b/index.md @@ -20,7 +20,6 @@ curl https://raw.github.com/wp-cli/wp-cli.github.com/master/installer.sh | bash Make sure to read the instructions. -<a name="autocomplete"></a> <h3 id="complete">Tab completions</h3> WP-CLI comes with a tab completion script for command, subcommand and flag names. From 5c19660167157841b2b52941d426122a0f1f8ffe Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Wed, 7 Aug 2013 23:47:50 +0300 Subject: [PATCH 189/194] add missing trailing slashes --- commands/cli/index.md | 10 +++++----- commands/core/index.md | 20 ++++++++++---------- commands/network-meta/index.md | 8 ++++---- commands/site/index.md | 6 +++--- commands/user/index.md | 20 ++++++++++---------- 5 files changed, 32 insertions(+), 32 deletions(-) diff --git a/commands/cli/index.md b/commands/cli/index.md index 9d116d02..7d3d43f5 100644 --- a/commands/cli/index.md +++ b/commands/cli/index.md @@ -18,23 +18,23 @@ title: 'wp cli' </thead> <tbody> <tr> - <td><a href="/commands/cli/cmd-dump">cmd-dump</a></td> + <td><a href="/commands/cli/cmd-dump/">cmd-dump</a></td> <td>Dump the list of installed commands, as JSON.</td> </tr> <tr> - <td><a href="/commands/cli/completions">completions</a></td> + <td><a href="/commands/cli/completions/">completions</a></td> <td>Generate tab completion strings.</td> </tr> <tr> - <td><a href="/commands/cli/info">info</a></td> + <td><a href="/commands/cli/info/">info</a></td> <td>Print various data about the CLI environment.</td> </tr> <tr> - <td><a href="/commands/cli/param-dump">param-dump</a></td> + <td><a href="/commands/cli/param-dump/">param-dump</a></td> <td>Dump the list of global parameters, as JSON.</td> </tr> <tr> - <td><a href="/commands/cli/version">version</a></td> + <td><a href="/commands/cli/version/">version</a></td> <td>Print WP-CLI version.</td> </tr> </tbody> diff --git a/commands/core/index.md b/commands/core/index.md index 5274c586..9a9b6e64 100644 --- a/commands/core/index.md +++ b/commands/core/index.md @@ -18,43 +18,43 @@ title: 'wp core' </thead> <tbody> <tr> - <td><a href="/commands/core/config">config</a></td> + <td><a href="/commands/core/config/">config</a></td> <td>Set up a wp-config.php file.</td> </tr> <tr> - <td><a href="/commands/core/download">download</a></td> + <td><a href="/commands/core/download/">download</a></td> <td>Download core WordPress files.</td> </tr> <tr> - <td><a href="/commands/core/init-tests">init-tests</a></td> + <td><a href="/commands/core/init-tests/">init-tests</a></td> <td>Set up the official test suite using the current WordPress instance.</td> </tr> <tr> - <td><a href="/commands/core/install">install</a></td> + <td><a href="/commands/core/install/">install</a></td> <td>Create the WordPress tables in the database.</td> </tr> <tr> - <td><a href="/commands/core/is-installed">is-installed</a></td> + <td><a href="/commands/core/is-installed/">is-installed</a></td> <td>Determine if the WordPress tables are installed.</td> </tr> <tr> - <td><a href="/commands/core/multisite-convert">multisite-convert</a></td> + <td><a href="/commands/core/multisite-convert/">multisite-convert</a></td> <td>Transform a single-site install into a multi-site install.</td> </tr> <tr> - <td><a href="/commands/core/multisite-install">multisite-install</a></td> + <td><a href="/commands/core/multisite-install/">multisite-install</a></td> <td>Install multisite from scratch.</td> </tr> <tr> - <td><a href="/commands/core/update">update</a></td> + <td><a href="/commands/core/update/">update</a></td> <td>Update WordPress.</td> </tr> <tr> - <td><a href="/commands/core/update-db">update-db</a></td> + <td><a href="/commands/core/update-db/">update-db</a></td> <td>Update the WordPress database.</td> </tr> <tr> - <td><a href="/commands/core/version">version</a></td> + <td><a href="/commands/core/version/">version</a></td> <td>Display the WordPress version.</td> </tr> </tbody> diff --git a/commands/network-meta/index.md b/commands/network-meta/index.md index 5de73714..780c5e96 100644 --- a/commands/network-meta/index.md +++ b/commands/network-meta/index.md @@ -29,19 +29,19 @@ title: 'wp network-meta' </thead> <tbody> <tr> - <td><a href="/commands/network-meta/add">add</a></td> + <td><a href="/commands/network-meta/add/">add</a></td> <td>Add a meta field.</td> </tr> <tr> - <td><a href="/commands/network-meta/delete">delete</a></td> + <td><a href="/commands/network-meta/delete/">delete</a></td> <td>Delete a meta field.</td> </tr> <tr> - <td><a href="/commands/network-meta/get">get</a></td> + <td><a href="/commands/network-meta/get/">get</a></td> <td>Get meta field value.</td> </tr> <tr> - <td><a href="/commands/network-meta/update">update</a></td> + <td><a href="/commands/network-meta/update/">update</a></td> <td>Update a meta field.</td> </tr> </tbody> diff --git a/commands/site/index.md b/commands/site/index.md index a4de79b0..62eb7460 100644 --- a/commands/site/index.md +++ b/commands/site/index.md @@ -18,15 +18,15 @@ title: 'wp site' </thead> <tbody> <tr> - <td><a href="/commands/site/create">create</a></td> + <td><a href="/commands/site/create/">create</a></td> <td>Create a site in a multisite install.</td> </tr> <tr> - <td><a href="/commands/site/delete">delete</a></td> + <td><a href="/commands/site/delete/">delete</a></td> <td>Delete a site in a multisite install.</td> </tr> <tr> - <td><a href="/commands/site/empty">empty</a></td> + <td><a href="/commands/site/empty/">empty</a></td> <td>Empty a site of its content (posts, comments, and terms).</td> </tr> </tbody> diff --git a/commands/user/index.md b/commands/user/index.md index bf27b68b..c684b6e3 100644 --- a/commands/user/index.md +++ b/commands/user/index.md @@ -18,43 +18,43 @@ title: 'wp user' </thead> <tbody> <tr> - <td><a href="/commands/user/add-role">add-role</a></td> + <td><a href="/commands/user/add-role/">add-role</a></td> <td>Add a role for a user.</td> </tr> <tr> - <td><a href="/commands/user/create">create</a></td> + <td><a href="/commands/user/create/">create</a></td> <td>Create a user.</td> </tr> <tr> - <td><a href="/commands/user/delete">delete</a></td> + <td><a href="/commands/user/delete/">delete</a></td> <td>Delete one or more users.</td> </tr> <tr> - <td><a href="/commands/user/generate">generate</a></td> + <td><a href="/commands/user/generate/">generate</a></td> <td>Generate users.</td> </tr> <tr> - <td><a href="/commands/user/get">get</a></td> + <td><a href="/commands/user/get/">get</a></td> <td>Get a single user.</td> </tr> <tr> - <td><a href="/commands/user/import-csv">import-csv</a></td> + <td><a href="/commands/user/import-csv/">import-csv</a></td> <td>Import users from a CSV file.</td> </tr> <tr> - <td><a href="/commands/user/list">list</a></td> + <td><a href="/commands/user/list/">list</a></td> <td>List users.</td> </tr> <tr> - <td><a href="/commands/user/remove-role">remove-role</a></td> + <td><a href="/commands/user/remove-role/">remove-role</a></td> <td>Remove a user's role.</td> </tr> <tr> - <td><a href="/commands/user/set-role">set-role</a></td> + <td><a href="/commands/user/set-role/">set-role</a></td> <td>Set the user role (for a particular blog).</td> </tr> <tr> - <td><a href="/commands/user/update">update</a></td> + <td><a href="/commands/user/update/">update</a></td> <td>Update a user.</td> </tr> </tbody> From 10153b7acd44392cd09164cd9d840dc68c4853b2 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Thu, 8 Aug 2013 16:18:53 +0300 Subject: [PATCH 190/194] add release post for 0.11.1 --- _posts/2013-08-08-version-0.11.1.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 _posts/2013-08-08-version-0.11.1.md diff --git a/_posts/2013-08-08-version-0.11.1.md b/_posts/2013-08-08-version-0.11.1.md new file mode 100644 index 00000000..31bbd994 --- /dev/null +++ b/_posts/2013-08-08-version-0.11.1.md @@ -0,0 +1,25 @@ +--- +layout: post +author: scribu +title: Version 0.11.1 released +--- +This is a minor release, which fixes a few regressions. + +### Changelog + +Commands: + +* made `search-replace` work with tables that have reserved column names, such as 'default' +* made `option update` work correctly for `blog_public` +* fixed notice in `scaffold post-type` +* fixed colorization on `wp plugin update-all --dry-run` + +Internals: + +* fixed bug where `wp help` would not display commands defined in plugins +* fixed synopsis parser bug where arguments with vertical bars would be ignored +* added support for `WP_CLI_PHP_INI` environment variable + +You can also browse the list of [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=15&state=closed) on Github. + +Contributors to this release: [c10b10](https://github.com/c10b10), [jmslbam](https://github.com/jmslbam), [scribu](https://github.com/scribu). From 3c49e989243323c15d7b21fff8f0bd6f818204a9 Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Thu, 8 Aug 2013 17:57:55 +0300 Subject: [PATCH 191/194] WP_CLI_PHP_ARGS not WP_CLI_PHP_INI fixes wp-cli/wp-cli#651 --- _posts/2013-08-08-version-0.11.1.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_posts/2013-08-08-version-0.11.1.md b/_posts/2013-08-08-version-0.11.1.md index 31bbd994..a85f8253 100644 --- a/_posts/2013-08-08-version-0.11.1.md +++ b/_posts/2013-08-08-version-0.11.1.md @@ -18,7 +18,7 @@ Internals: * fixed bug where `wp help` would not display commands defined in plugins * fixed synopsis parser bug where arguments with vertical bars would be ignored -* added support for `WP_CLI_PHP_INI` environment variable +* added support for `WP_CLI_PHP_ARGS` environment variable You can also browse the list of [resolved issues](https://github.com/wp-cli/wp-cli/issues?milestone=15&state=closed) on Github. From bdc1c80a706eb6d161374db2ff9adc23601390cc Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Fri, 9 Aug 2013 15:23:43 +0300 Subject: [PATCH 192/194] stop trying to install Boris automatically It frequently fails because it depends on several PHP extensions, scaring off new users. Related: wp-cli/wp-cli#640 --- installer.sh | 11 ----------- 1 file changed, 11 deletions(-) diff --git a/installer.sh b/installer.sh index 7c8772eb..09f0254f 100755 --- a/installer.sh +++ b/installer.sh @@ -75,17 +75,6 @@ command -v bin/wp > /dev/null || { echo "WP-CLI files have been succesfully installed." } -command -v bin/boris > /dev/null || { - echo - printf "Trying to install the optional Boris package... " - $COMPOSER --quiet require --prefer-source 'd11wtq/boris=@stable' - if [ $? -gt 0 ]; then - echo "failed." - else - echo "done." - fi -} - cat <<EOB To test WP-CLI, run: From 0be9501d5c2c1e1140d09437bd88d355ed6ee51b Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Mon, 12 Aug 2013 17:50:26 +0300 Subject: [PATCH 193/194] installer: export PATH --- installer.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installer.sh b/installer.sh index 09f0254f..30d45cfb 100755 --- a/installer.sh +++ b/installer.sh @@ -84,7 +84,7 @@ To test WP-CLI, run: Make sure you have the following line in your .bashrc file: # WP-CLI directory - PATH=$INSTALL_DIR/bin:\$PATH + export PATH=$INSTALL_DIR/bin:\$PATH EOB if [ "$WP_CLI_PHP" != "$(which php)" ]; then From f1b2646298e036a697aec70c7fb0bb858e4a21db Mon Sep 17 00:00:00 2001 From: scribu <mail@scribu.net> Date: Wed, 14 Aug 2013 15:59:13 +0300 Subject: [PATCH 194/194] installer: s/.bashrc/.bash_profile/ to match the home page instructions see wp-cli/wp-cli#676 --- installer.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/installer.sh b/installer.sh index 30d45cfb..5ac8bc07 100755 --- a/installer.sh +++ b/installer.sh @@ -81,7 +81,7 @@ To test WP-CLI, run: $INSTALL_DIR/bin/wp --info -Make sure you have the following line in your .bashrc file: +Make sure you have the following line in your .bash_profile file: # WP-CLI directory export PATH=$INSTALL_DIR/bin:\$PATH