Coppermine Photo Gallery v1.5.x: Documentation and Manual

Table of Contents

Testing Coppermine

This section of the documentation has been created while the package was in alpha stage. It remained in the package and applied as well when the package reached beta stage. When cpg1.5.3 came out as a release candidate, this part of the documentation remained inside the package and still was valid. Finally when cpg1.5.4 was released as stable release the testing document still remained, as it partly still applies: cpg1.5.x now is in a state where it can be recommended for production use, yet there probably still are a lot of bugs in it (this is the case for every piece of non-trivial software), so if you think that you have found a genuine bug, please read this section thoroughly, especially to find out how to create a valid testing/bug report. When in doubt, don't post a bug report, but post a "regular" support request on the corresponding support board.

While testing cpg1.5.x, please make certain to note any odd behavior you encounter. This could include typographical errors, misleading instructions, or any other out-right error. If you encounter a major error, please switch the debug mode to "on" in the configuration panel and copy the text from the debug window of Coppermine into your posting if a supporter or developer explicitely asks for it. This will greatly aid the development team in hunting down the problem.

No support for alpha and beta versions

The coppermine group is readily supplying support on the official Coppermine forum for versions that have officially been released. However, there is no support for versions that are in alpha or beta stage, i.e. under development. Only stable releases are being supported.

If you need support, you should use the most recent stable release.

Of course you're welcome to post your test report when using a version that is still under development. However, it's a thin line between a valid test report and asking for support: if you post something in relation to a development version and your posting clearly shows that you haven't even bothered to read the provided documentation and search the board first, you will get a harsh answer or no answer at all.

Areas to be particularly mindful of

Please report your test results to the testing board, but before starting a new thread please make sure that the potential bug you're going to report hasn't been posted before.

Feature list

This is an incomplete list of features (taken from the changelog) that are new or have been changed dramatically in cpg1.5.x and therefore need close reviewing. You don't have to review all of them (of course, the more reviews the better). There is another list of new features in cpg1.5.x that you might want to browse as well.

Major new features

The report format should include

If you can and your testbed can be accessed publicly, provide a link to your testbed. If you can't, do that, it usually helps to attach screenshots to your report. It's much better though to provide a link to your testbed.

Your test results will not merely be used to fix problems but will also be used to tout the compatibility of Coppermine with multiple browsers and operating systems. That is why this information is important even if you find that nothing is wrong - we'd love to hear your success stories as well.

Thanks for your participation and your time in making Coppermine the premiere open-source photo gallery!

One issue per thread!

We have a strict "one issue per thread" policy on the entire coppermine forum that applies for the test board even more than for the support board: to enable the dev team to track each potential bug thoroughly it's absolutely mandatory that you only post one issue (potential bug) per thread. If you should find multiple potential bugs, then it's perfectly OK to start multiple threads.

Example test reports

To give you an idea how your test report could look like, here's an example (make sure that you populated the stuff in red with actual content from your case):

When testing cpg1.5.4 on my testbed at http://example.com/my_coppermine_folder/ using a subversion checkout from 2009-07-13 (revision 1234) I noticed that whenever I'm logged in as admin and click on the admin menu item "export" I get the error message "foo bar blah".
My server testbed runs on Ubuntu Linux 9.04 and Apache 2.2.10 with GD2 as image library under PHP 5.3.0. I don't use bridging and have only tested using this the curve theme. I have performed a fresh install. I get the above mentioned error message no matter what browser I use (I have tested with IE7 and FF3.5 on Windows XP Home SP3 English). The default language in my browsers is set to English.

Here's another example of the same test report:

Coppermine version: cpg1.5.4
Testbed URL: http://example.com/my_coppermine_folder/
Server OS: Ubuntu Linux 9.04
Web Server: Apache 2.2.10
PHP Version: 5.3.0
Image library used: GD2
Bridging: none
Themes tested: curve
Client OS: Windows XP Home SP3 English
Client Browser: IE7 and FF3.5
Install type: fresh install
Source: subversion checkout from 2009-07-13 (revision 1234)
Browser language: English
Coppermine language: English
What happened (potential bug): I get the error message "foo bar blah"
How to replicate (what I did when the problem showed up): I'm logged in as admin and click on the admin menu item "export"

Above mentioned examples are meant to give you an idea how your report could look like - you should provide more data depending on the type of issue you report:

Invalid test reports

We'd really see your test report for the brand new version, so don't get discouraged if there are some rules to follow. What we certainly don't need are reports like this:

I have downloaded the new version. It doesn't work.

Please do yourself and us a favor: don't file such silly reports, as they will only lead to frustration and will be ignored or deleted, and of course you will be laughed at.

If you have no idea why this example report is bad, then you should not even consider testing the new version in the first place. Instead, you should use the stable release.

For all who have read on to this point, here are some more hints for you: released packages have version numbers. Files have revision numbers. There's a reason for that. Don't post crap like "I have the latest version". Post the actual version or revision number. And don't just post that something "doesn't work". We need to know what actually happened ("after doing X, Y happens"), as detailed as possible.

If you think that the rules here are totally obvious, then think again: we wouldn't be writing them down if they were obvious for everyone. In fact, we used to have a hard time in the past when we were flooded with invalid test reports. That's why we needed to clarify the rules.

Availability

When testing, make sure that your SVN checkout is up-to-date.