[[PageOutline]] == 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.''[[BR]] [[BR]] '''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 burden on us, we hereby ask you to test your issues always against the latest available version from [wiki:Dev_GIT git] or click this link directly [https://github.com/roundcube/roundcubemail/zipball/master Latest version from master] === Check list === * What's your PHP version? (Please make sure this is up to date!)[[BR]] * What's your mail server? (Please make sure this is up to date!)[[BR]] * 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.[[BR]] [[BR]] 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'' version of PHP 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).[[BR]] [[BR]] 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 [http://lists.roundcube.net mailing lists] and [http://roundcubeforum.net/ forums] where people may be able to help you especially when the issue is related to the configuration of your environment, rather than RoundCube itself. === Samples === 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 attach this email to a ticket in our bugtracker. === Patches === 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. :)[[BR]] [[BR]] If you'd like to contribute a patch, please create it against the latest source and send us the unified diff or create a pull request on github. === Translations === For translation updates or corrections please go directly to our [https://translations.launchpad.net/roundcubemail launchpad.net] page and correct them there. A launchpad login is required to make changes. === Debugging Roundcube === To debug Roundcube, we suggest you use [http://xdebug.org Xdebug]. Xdebug has the ability to profile PHP code. The profiler is very detailed and allows you to see how much time is spend in certain parts of the code. ==== Installation & Setup ==== {{{ pecl install xdebug echo "zend_extension=xdebug.so" >> /etc/php/php.ini }}} The second command is optional and depends on your PHP installation, etc.. If you do not have the {{{pecl}}} command available, you can get it by installing [http://pear.php.net/ PEAR]. For more notes on installing Xdebug, please check out [http://www.xdebug.org/docs/install the official documentation]. ==== Configure Xdebug ==== The following should be added to {{{php.ini}}} or your {{{xdebug.ini}}}: {{{ xdebug.profiler_enable=1 xdebug.profiler_output_dir=/tmp }}} Please be adviced, that the files Xdebug creates can eat a lot of disk space fast. So make sure to disable it when you're done debugging so you don't run out of disk space. ==== Analyze ==== Use the following tools to analyze your cachegrind files: * [http://kcachegrind.sf.net/ Kcachegrind] * [http://sourceforge.net/projects/wincachegrind/ Wincachegrind] * [http://code.google.com/p/webgrind/ Webgrind]