PostTypes mission is to create advanced WordPress custom post types easily.
Its focus is on the creation of custom post types, specifically around the admin interface, providing methods to create advanced post tables, columns, filters and more.
It also makes it easy to create taxonomies and assign them to post types.
Although its focus is on the admin interface, PostTypes is not for custom fields. There are plenty of solutions for creating custom fields in WordPress. PostTypes has no intention of being one.
Please keep this in mind when contributing to the project.
Create an Issue
If you would like to report a bug, feature request, documentation improvement or question please create an issue. Before creating a new issue please check it has not already been raised by searching issues on GitHub.
When creating an issue it is best to provide as much information as possible in order to help the discussion move quickly and efficiently.
Bug reports highlight an error or unexpected behaviour when using the code. In order to resolve the issue, enough detail must be provided in order to recreate the problem so it can be investigated and fixed.
Tips on creating bug reports:
Provide as much detail about the problem.
Give steps to help reproduce the problem.
Code examples and error messages are useful.
Version numbers (PHP, PostTypes, WordPress) are useful.
🚀 Feature Request
Feature requests suggest an idea for an improvement or additional functionality. Feature requests should be raised before submitting a pull request. This provides an opportunity for discussion and help prevent unnecessary work from being carried out.
Tips on creating feature requests:
Provide a description of the change you want to make.
Highlight the problem it attempts to solve.
Offer examples of how it would be used.
Provide links to WordPress documentation where relevant.
📖 Documentation Improvements
Documentation improvements suggest ways to enhance the documentation. This could be anything from fixing spelling errors to adding new sections.
Tips on creating documentation improvements:
Provide links to the pages you're referring to.
Offer an explanation on how this is an improvement.
🎈 Support Questions
For general questions and support. This is also a catch-all for anything that doesn't fit in the categories above.
Labels are used to help organise different types of issues. Labels are prefixed with their group, which currently are type and status. Maintainers will apply the correct labels to an issue when they are reviewed.
Bug reports and issues with unexpected behaviour
Feature requests and ideas
Improvements and fixes around documentation
General support and questions
An issue that needs discussion before it can be worked on.
An issue that is ready to be picked up.
Status: In Progress
An issue that is currently being worked.
An issue that is finished and ready to be reviewed and merged.
An issue that is finished and merged into master.
This is not an exhaustive list. Labels may be changed and new ones created over time. For a complete list, see the GitHub repo.
Submit a Pull Request
Before submitting a Pull Request it is recommended you create an issue first. This provides an opportunity to open up a discussion before any work takes place.
Commit little and often, smaller commits make it easier to review code.
Do not include issue numbers in the title of your pull request.
Please provide a description with your pull request with details about the change you are trying to make.
Please link to any issues the pull request is related.
Branch prefixes are used to help categorise the working branches by type.
An attempt to fix a bug
A new feature being worked on
Documentation fix, addition or improvement
A release branch to create a new release.
The release/ prefix is to be used by maintainers only.
The docs/ prefix is used alongside Gitbook where the docs are hosted. Branches with this prefix will be automatically generated and made available as a version on the documentation site. This provides an opportunity to preview changes and approve them before being merged.
PostTypes is open source and free to use. It was created to solve a problem while giving something back to the community. There are many ways to show your support, some ideas include: