Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Plugins] Update Plugins Handbook: Plugin Headers - tags (in readme.txt) #1533

Open
flexseth opened this issue Apr 12, 2024 · 2 comments
Open
Labels
developer documentation (DevHub) Improvements or additions to developer documentation plugins Issues for Plugin Developer Handbook [Status] To do Issue marked as Todo

Comments

@flexseth
Copy link
Collaborator

Plugin authors can provide tags as taxonomy for their plugins, but there is little to no information about how this actually works with the WordPress.org plugins repository or how it can be beneficial to plugin authors. The tags are a comma separated list of keywords one may use when searching for the plugin.

Here's how it's done in WooCommerce

URL of the Page with the Issue

https://developer.wordpress.org/plugins/

Section of Page with the issue

I'm not sure where you would include the info - best practices maybe?

Why is this a problem?

It's hard to understand why properly categorizing your plugin would be a benefit.

Makes it easy for plugin clearinghouses to game the system and show up first in search results.

Makes it tough on the new developer who may have a really solid plugin that does one thing well, but doesn't know how to get visibility.

Suggested Fix

Add the information about taxonomy for plugins as it relates to those hosted on WordPress.org, explain why this is important, add as a best practice for plugin authors.

Update docs to reflect!

@flexseth flexseth added developer documentation (DevHub) Improvements or additions to developer documentation plugins Issues for Plugin Developer Handbook [Status] To do Issue marked as Todo labels Apr 12, 2024
Copy link

Heads up @theMikeD - the "plugins" label was applied to this issue.

Copy link

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.

@estelaris estelaris changed the title Update Plugins Handbook: Plugin Headers - tags (in readme.txt) [Plugins] Update Plugins Handbook: Plugin Headers - tags (in readme.txt) Apr 18, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
developer documentation (DevHub) Improvements or additions to developer documentation plugins Issues for Plugin Developer Handbook [Status] To do Issue marked as Todo
Projects
None yet
Development

No branches or pull requests

1 participant