Obtaining support for Views issues
The Views issue queue is one of the larger queues within the Drupal Project (see the statistics page)
Make sure that your issue is a Views issue! Views provides the ability to list data - if your data is provided by a module other than Drupal Core, please enter your issue in that module's issue queue instead. If your problem deals exclusively with fields or filters provided by another module (CCK, Image, VotingAPI are common) please post the issue under the queue for that module first; all modules are responsible for telling Views about their own fields. It's possible Views IS at fault, but the module maintainers are the best people to make that determination, and they can kick the issue into the Views queue with an explanation of what's wrong if that is the case. If there is a more recent version of Views that is supported, please try that version if at all possible.
Before you open a new or add to an existing issue, please follow these guidelines:
- Search for duplicate issues.
- Do not hijack issues. It's confusing to everyone involved in the original issue, to other people who might have the same issue as you, and it's rude.
- Support requests should be very specific, narrow scope items. Broad or vague support requests or general pleas for help are best left to the forums, where you will get more eyes.
- Take the time to detail steps to reproduce the issue. If you cannot take the time to do this, then clearly the issue is not important enough for the maintainers to take the time to address.
When opening a new issue, failure to completely fill out all fields may result in the immediate closure of your issue due to lack of information.
Reasons your issue may be summarily closed:
- Your issue has been left marked "Postponed, maintainer needs more info" for more than 30 days.
- You have failed to provide enough information to begin to even guess what the problem may be. The Views queue is hugely active, and there are not enough individuals helping to maintain it at a sustainable level. Issues that can be summarized as "it's broken. Fix it." will be closed with a pointer to this page.
- You are combatative or argumentative in the queue. Yes, problems are frustrating. Dealing with a queue the size of Views is also frustrating.
How you can help:
Provide details. Pay it forward (if you've asked a few questions and gotten help, take one of the hours you saved and help close out a few other issues. Every bit counts.) Write a tutorial and submit it as a patch/issue to be integrated into Advanced Help.
Please read the following information for help in providing the most data in order to solve your issue quickly.
- Version: The exact version of Views being used.
- Component: Which piece of Views is the center of the issue.
- Code: Problems with actual Views code.
- Documentation: Problems with documentation (see also Advanced Help)
- Miscellaneous: Issues which do not fit into any other component category
- User interface: Problems with the Administrative interface.
- Views data: Problems with data being displayed by the Views module.
- Node data: Issues with data specifically supplied by the core node fields.
- User data: Issues with data specifically provided by the core user fields.
- Profile data: Issues with data specifically provided by the core profile.
- Comment data: Issues with data specifically provided by core's comments.
- Taxonomy data: For issues with using core taxonomy data.
- Statistics data: For core statistics issues.
- Files/upload data: For problems with integrating file or upload information.
- Search data: For issues with core search. Note: this is core search with Views2. Apache/Solr search is not available until Views 3. Please mark your issues accordingly.
- Book data: Issues with data from book module.
- Aggregator data: Problems with data from Aggregator
- Poll data: Problems with poll integration.
- Page displays: Issues dealing with the creation and use of Page displays within Views.
- Block displays: Issues dealing with the creation and use of Block displays within Views.
- Feed displays: Problems dealing with the creation and use of RSS/feed displays.
- Table Style: Issues dealing with the Table style plugin.
- Exposed filters: Problems with exposing filters in your views.
- Category: bug report, task, support request, feature request.
- Priority: Critical, normal, minor. There is no such thing as a critical support request. Critical issues are bugs where the application crashes or is otherwise completely unusable. For all other issues where a feature does not work properly, please use "Normal".
- Status: Where the issue stands. If an issue is closed or marked "Won't fix", seriously consider if you really want to re-open the issue. If you are experiencing the same problem in a different release of Views, open a new issue for that version, and link to the previous issue. The statuses "Needs review" and "Needs work" should be reserved for issues with patches attached.
- Title: Please provide a descriptive title. "error message during creation" is not specific. "Undefined variable error during creation of default display" is significantly more specific.
- Description: This is critical. Be as specific as possible.
- If your issue report is about a view that provides unexpected results, or about a SQL error, PLEASE export the entire view and paste it between tags. Please also paste the query from the live preview; you can put the query between
<?php
?><code>tags to preserve formatting. - If you are getting a crash bug, please explain precisely what you were trying to do/accomplish with the View at the time.
- If you are getting a white screen while installing Views, please be sure you have at least 32MB memory available for PHP (google search can easily tell you how); and this can go up if you have a lot of modules. There is extra memory processing on the modules screen due to menu rebuilds and Views will build its first data cache on that page as well, so lots of things will come together to use memory.
- If your issue report is about a view that provides unexpected results, or about a SQL error, PLEASE export the entire view and paste it between
- Questions you should be able to answer:
- How often does this happen?
- What is the exact, complete error message? Copy and paste it into the issue.
- List every step you took to create the problem. Each click, each menu item. Reproducability is the key to solving issues.
- Other modules that may be interacting.
- Completely describe exactly what you are attempting to accomplish. If your issue is only one or two sentences long, you have almost certainly not described the problem in enough detail.
If there's a crash of some kind and you don't get any kind of error message, be sure to check your apache/php error log. (The location varies from server to server but every server should have one).