Extending your WordPress Toolbelt with WP-CLI presentation from WordCamp Austin 2014. March 27, 2014.

1. ExtendingYour
WordPress Toolbelt
with WP-CLI
WordCamp Austin 2014
Ryan Duff

2. # whoami
• WordPress Developer
• Open Source Contributor
• Sysadmin (sort of)

3. What is WP-CLI?

4. WP-CLI is a set of command-line tools
for managing WordPress installations.

6. WP-CLI is a set of command-line tools
for managing WordPress installations.

7. So Let’s Get Started

8. Requirements

9. • UNIX-like environment (OS X, Linux,
FreeBSD, Cygwin)
• PHP 5.3.2 or later
• WordPress 3.5.2 or later
!
• Basic knowledge of the command line

10. What Does It Do?

11. What Does It Do?
Everything... almost
!
!
!
!
!

12. What Does It Do?
Everything... almost
!
!
!
!
Sorry… it won’t make you coffee.

13. Top Level Commands

14. Download, Configure,
Install

15. wp core download!
!
!
!

16. wp core config !
! --dbname=wcatx !
! --dbuser=wcatx !
! --dbpass=wcatx!
!
wp core install !
! --url=“http://wcatx.dev” !
! --title="Site Name" !
! --admin_user=notadmin !
! --admin_password=somethingstrong !
! --admin_email="user@site.com"

17. wp option update timezone_string “America/
New_York"!
!
wp rewrite structure ‘/%year%/%monthnum%/
%postname%/‘ --hard

18. Install and Manage
Plugins

22. Install and Manage
Themes

24. Import / Export
wp import!
!
wp export

25. Managing the Database
wp db export!
wp db import!
!
!
wp db cli!
!
!
wp site empty

26. Search and Replace
wp search-replace!
!
wp search-replace “oldsite.dev” “newsite.com”!
!
!
--network!
--dry-run

27. Posts

28. Comments

29. Media
wp media regenerate --yes

30. Users
Roles
Capabilities

31. Multisite
Rewrites
Options

32. Terms
Menus
Sidebars
Widgets

33. Plugin or Theme
developer?

35. English please?

36. Community Commands

37. Community Commands
http://wp-cli.org/package-index/

38. Dictator

39. Dictator

40. Your Own Commands

43. WP-CLI API
https://github.com/wp-cli/wp-cli/wiki/API

44. How to Install

45. The Quick Lazy
Easy Way™

46. # mkdir -p ~/.wp-cli/bin !
!
# cd ~/.wp-cli!
!
# curl -L https://raw.github.com/wp-cli/
builds/gh-pages/phar/wp-cli.phar > bin/wp!
!
# chmod +x bin/wp!
!
!
# curl -LO https://github.com/wp-cli/wp-cli/
raw/master/utils/wp-completion.bash

48. Almost ready…
Add to ~/.bash_profile, .zshrc, etc
!
# add to $PATH
export PATH=$HOME/.wp-cli/bin:$PATH
!
# autocomplete
source $HOME/.wp-cli/wp-completion.bash

49. Using ZSH?
# autocomplete
autoload bashcompinit
bashcompinit
source $HOME/.wp-cli/wp-completion.bash

50. MAMP or other
custom PHP
export PATH=/Applications/MAMP/bin/php/
php5.4.10/bin:$PATH

52. Installing the
Better Way™

53. (so you can contribute,
of course)

54. # git clone git@github.com:ryanduff/wp-
cli.git ~/.wp-cli!
!
# cd wp-cli!
!
# git remote add upstream git@github.com:wp-
cli/wp-cli.git!
!
# composer install

56. Almost ready…
Add to ~/.bash_profile, .zshrc, etc
!
# add to $PATH
export PATH=$HOME/.wp-cli/wp-cli/bin:$PATH
!
# autocomplete
source $HOME/.wp-cli/wp-cli/utils/wp-completion.bash

57. More Info
Web: http://wp-cli.org/
!
Core Commands: http://wp-cli.org/
commands/
!
Cookbook: https://github.com/wp-cli/wp-
cli/wiki/Commands-Cookbook
!
Github: https://github.com/wp-cli/wp-cli

58. Contributing
https://github.com/wp-cli/wp-cli/blob/master/
CONTRIBUTING.md
!
https://help.github.com/articles/fork-a-repo

59. Questions?

60. Ryan Duff
!
!
email: ryan@fusionized.com
!
web: http://fusionized.com
!
twitter: @ryancduff
!
github: https://github.com/ryanduff