Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Growing open source communities on GitHub around your WordPress plugin or theme

Growing open source communities on GitHub around your WordPress plugin or theme

A talk presented at WordCamp DC.

Ben Balter

July 15, 2017

More Decks by Ben Balter

Other Decks in Technology


  1. • CamelCase domain name • Lots of WordPress users •

    Famous one-click installs™ • Support forums • Marketing material WordPress.org GitHub.com • CamelCase domain name • Lots of WordPress developers • Famous three-click contributions™ • Bug/project tracker • Technical documentation
  2. Five minute documentation 1. Add Markdown files to your repository's

    docs/ folder 2. Activate GitHub Pages 3. (Optional) choose a theme
  3. How to set up automated tests 1. Install WP-CLI and

    PHP Unit 2. wp scaffold plugin-tests [your-plugin-name] 3. Write tests 4. Login to travis-ci.org and enable your project 5. Push https://make.wordpress.org/cli/handbook/plugin-unit-tests/
  4. 9. Deploy to WordPress.org • Convert GitHub-flavored Markdown to WordPress

    readme.txt format • Push Git master to SVN trunk • Create a Git tag • Create a SVN tag • Create a GitHub release (optional)
  5. *Why add a code of conduct? • Reasonable people disagree

    on the internet • Establishes expectations for community norms • Signals that your project is a welcoming community • Better to have before something happens, not after • It's the right thing to do
  6. 10 ways to grow communities 
 around your Wordpress theme

    or plugin 0. Solve a shared problem 1. Choose an open source license 2. Link to the repository from wp.org 3. Publish technical documentation 4. Document how to contribute 5. Clarify support v. development 6. Welcome new contributors 7. Set up automated tests 8. Enforce WP code standards 9. Deploy to WordPress.org 10. Adopt a code of conduct