Reporting Security Issues #
While we try to be proactive in preventing security problems, we do not assume they’ll never come up. If you believe you’ve found a security problem in a release of WordPress please see the Security FAQ for information on how to report the problem.
It is standard practice to notify the vendor (the WordPress security team, in this case) of a security problem before publicizing so a fix can be prepared and public damage due to the vulnerability minimized.
Overview of Bug Reporting and Resolution #
There are many steps in the process of reporting and resolving a bug in WordPress. Here is an overview:
- A user finds a bug that appears to be in the core of WordPress (not a theme or a plugin).
- The user confirms it it actually a bug, which has not yet been reported.
- The user submits a bug report, called a ticket, to Trac, the WordPress Bug Tracker.
- A WordPress developer (who is a volunteer like you) confirms that the bug does actually exist, and that it should be fixed, and comments as such.
- A WordPress developer (which could be you) decides to fix the bug. The developer figures out how to fix the bug, create a patch, and uploads the patch to Trac.
- Members of the WordPress development community test the patch, to see if it fixes the bug and doesn’t break anything else. They may also run Automated Tests against the bug and patch, and write new tests (or suggest new tests be written).
- One of the WordPress developers with authority to modify the official WordPress source code commits the patch to the core code in the SVN repository. They are more likely to do this if the bug and patch has been verified by someone they trust – WordPress development operates largely on a system of trust and merit.
- The person who commits the patch closes the bug as fixed.
Before You Report a Bug #
With large projects like WordPress, so many users report bugs that there’s a good chance your bug has already been reported. Because of this, it’s very important to check to be sure it’s not already in the system before you submit it. If you are new to reporting bugs in WordPress, it is also a good idea to discuss the issue with more experienced developers before reporting it.
1. Make sure the bug is actually caused by WordPress core.
Just because an error message points to a core file, doesn’t mean that’s where the problem is. You may want to use a plugin like Debug Bar to track down the problem. A simple script like this debugging file could help you see where exactly the error is coming from. (You can place this file in your wp-content/mu-plugins directory; create it if it doesn’t exist.)
Another key strategy is to try and replicate the bug in a fresh WordPress install with no extra plugins or themes. While this may not always be possible, if you can find it in a fresh install, the issue is much more likely to be in core.
2. Search for your bug or enhancement request.
- If your issue has already been reported, please do not report a duplicate bug. If you have further information to contribute, add a note to the existing bug.
- If your issue is similar, but not quite the same as another issue, you may decide whether to add a note to the similar issue, or report a new one. In general, if you just have more information to contribute to a current, open issue, simply add a note to that issue. If you have a different enough issue, or if you are experiencing a recurrence of an issue that was previously resolved, report a new bug. Either way, core contributors will offer you guidance once you’ve posted about your issue.
- If your issue was recently reported and then closed, and you do not agree with the resolution, you can still post comments as to your reasoning.
- It is best not to re-open bugs that have been closed for some time. If the bug was closed as fixed for a version of WordPress that has been released already (see the Milestone field), open a new ticket.
- The Version field relates to the version in which the bug was originally discovered. If you’re seeing the same bug in a newer version, mention so in a comment, but please do not change the version number.
3. Consider discussing a possible bug before reporting it.
- If you aren’t sure that you’ve found a bug, you should aim to discuss it with a developer before reporting it. You can discuss your issue on the #wordpress-dev IRC channel, post a question on the WordPress Support Forum, or start an email discussion on the testers or hackers mailing lists.
Reporting a Bug #
Trac is the name of the offcial WordPress bug tracker. It uses the open source bug tracking software Trac, by Edgewall Software. For more on Trac, see The Bug Tracker (Trac). To create a good bug report:
- Read the section above on before reporting a bug.
- Log onto WordPress Trac using your support forum username and password. If you don’t have an account at the support forums, you can register.
- Click New Ticket in Trac to reach the bug reporting page.
- Fill in the title, summary, and other fields. For more, see the section on Ticket Properties.
- Click Submit Ticket after previewing it.
Your involvement doesn’t end after you’ve submitted a ticket. Developers may need more information as they review the ticket (and may specifically request more information from you by tagging the ticket with reporter-feedback).
You can also help by verifying that proposed fixes solve the problem you were experiencing. The processing of your bug may require your participation, so please be willing and prepared to aid the developers in resolving the issue. If you’d like to help fix the bug, see the section on Fixing Bugs.
You will be automatically emailed when your tickets are updated if you’ve entered your email address in your Trac preferences.