WordPress.org Plugin Directory Guidelines
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore Initial commit Jul 29, 2016
CHANGELOG.md Updating readme on Github Jan 11, 2018
LICENSE Initial commit Jul 29, 2016
README.md Updating readme on Github Jan 11, 2018
guideline-01.md Some grammar cleanup and clarifications Nov 22, 2017
guideline-02.md Connecting 2 and 9 Nov 22, 2017
guideline-03.md Update guideline-03.md Dec 5, 2017
guideline-04.md Clarify human readability Aug 9, 2018
guideline-05.md Tweaking Guideline 5 to explain about sandbox access May 8, 2018
guideline-06.md Removing duplicated content (it was on the previous page) Dec 28, 2017
guideline-07.md Language clarificaition I hope... Dec 28, 2017
guideline-08.md Removing duplicated content (it was on the previous page) Dec 28, 2017
guideline-09.md Update guideline-09.md Apr 2, 2018
guideline-10.md Removing duplicated content (it was on the previous page) Dec 28, 2017
guideline-11.md Language clarificaition I hope... Dec 28, 2017
guideline-12.md Changing header to h4 which will allow linking. Nov 16, 2017
guideline-13.md Removing duplicated content (it was on the previous page) Dec 28, 2017
guideline-14.md Some grammar cleanup and clarifications Nov 22, 2017
guideline-15.md Removing duplicated content (it was on the previous page) Dec 28, 2017
guideline-16.md Some grammar cleanup and clarifications Nov 22, 2017
guideline-17.md Removing duplicated content (it was on the previous page) Dec 28, 2017
guideline-18.md Removing duplicated content (it was on the previous page) Dec 28, 2017
introduction.md Minor Change Jan 11, 2018

README.md

WordPress Plugin Directory Guidelines

This is the online repository for the rewrite of the WordPress.org Plugin Guidelines.

As of January 11, 2018, these guidelines match the ones on WordPress.org.

Introduction

In 2016, an attempt was begun to clean up the Detailed Plugin Guidelines and make them easier to understand, while retaining the heart of their intent. While one might wish we could say "Don't be a gosh darn bad person or spammer!" the reality is that some people need things spelled out. But also a great many situations are difficult to summarize.

The Plugin Review Team made the first pass, followed by many volunteers at WordCamps around the world, and finally a public posting here for anyone in the community.

Since then, we have used this repository to track changes and discuss major issues and amendments to the guidelines.

Feedback

If you feel a guideline’s explanation is unclear, please create an issue or a pull request with what you feel should be changed and why. All grammar/spelling corrections are greatly welcome. We’re trying to write these for all levels of developers, as well as people who may not speak English proficiently. Using words like ‘obsequious’ should be avoided (nb: That’s mostly to Mika who uses those words regularly).

Table of Contents

Introduction

  1. Plugins must be compatible with the GNU General Public License v2
  2. Developers are responsible for the contents and actions of their plugins.
  3. A stable version of a plugin must be available from its WordPress Plugin Directory page.
  4. Code must be (mostly) human readable.
  5. Trialware is not permitted.
  6. Software as a Service is permitted.
  7. Plugins may not track users without their consent.
  8. Plugins may not send executable code via third-party systems.
  9. Developers and their plugins must not do anything illegal, dishonest, or morally offensive.
  10. Plugins may not embed external links or credits on the public site without explicitly asking the user’s permission.
  11. Plugins should not hijack the admin dashboard.
  12. Public facing pages on WordPress.org (readmes) must not spam.
  13. Plugins must use WordPress’ default libraries.
  14. Frequent commits to a plugin should be avoided.
  15. Plugin version numbers must be incremented for each new release.
  16. A complete plugin must be available at the time of submission.
  17. Plugins must respect trademarks, copyrights, and project names.
  18. We reserve the right to maintain the Plugin Directory to the best of our ability.

License

The content has two licenses:

Just like WordPress, you are free to read, share, distribute, and modify the content however you want, passing on those freedoms to everyone else. Cool!