|Version 7 (modified by sweetpea, 6 years ago) (diff)|
How to report issues?
So you think you found an issue, huh? - First off, we really appreciate all feedback we get. To handle all the traffic, we ask you to setup a ticket on our trac (you are already on it, reading this) and take into account all of the following when you're creating it. You'll need to register for an account before you'll be able to create new tickets.
I know this is probably a pain to read, but please do it so we can straighten out all issues sooner than later.
Most current version
Please understand that RoundCube is a very young project. So because development never stops and in order to ease the burdon on us, we hereby ask you to test your issues always against the latest available version from Subversion.
- What's your PHP version? (Please make sure this is up to date!)
- What's your mail server? (Please make sure this is up to date!)
- What browser/operating system did you use, any special settings/plugins?
- What did the logs say? (see below, How to use the logs?)
- Is the behaviour reproducable? (see below, Samples)
Keeping your system up to date
RoundCube is tested in current environments, so if for example your mailserver has not been updated in over a year, please do this first to confirm your issue.
Mailserver issues are not the only thing to keep in mind - PHP updates are there for several reasons. Performance, security and features. We test against recent versions of PHP4 and 5, so please update it first and confirm your issue.
How to use the logs?
How to enable them?
RoundCube has a configuration option in config/main.inc.php which logs all errors to a log file located in "webmail/logs/" (assuming "webmail" is the directory of your Roundcube install).
So even though you might only see a blank page, chances are good that there is a more detailed explaination of what went wrong in the logs.
The debug_level in config/main.inc.php should look like this (1 = logging):
$rcmail_config['debug_level'] = 1;
How to read them?
The logs give you plenty of info when it comes to problems, please consider solving the problem first and then if all fails create a ticket. You may also use our mailinglists and forums where peope may be able to help you especially when the issue is related to the configuration of your environment, rather than RoundCube itself.
Even though there are tons of RFCs on email, it seems to be a rather 'lax standard by how different mailservers and mailclients interpret it. If you find out that a problem can be reproduced with a certain email, please share this email on Roundcube Testing and open a ticket accordingly.
Yes, we like patches - even if we may not apply them word by word they give us an idea and jumpstart us on your issue. We also credit accordingly. :)
If you'd like to contribute a patch, please create it against the latest source and send us the output of "svn diff".