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

Table of Contents


What are auto-installers?

There are many webhosting packages that offer pre-made scripts like Coppermine to be installed just with a single click in the webhosting control panel (usually cPanel). We can see that this is an easy and comfortable install method for newbies who have no experience in running and maintaining a website. In an ideal world, this would be the best method - end users wouldn't have to worry about database issues, FTP apps etc.

The sad story

The Coppermine team has made bad experiences with auto-installers in the past. The creators of the auto-installers have to adapt the original packages to make them work with their installers. In the past, the creators of Fantastico did so as well, but they introduced bugs into their re-made flavor of Coppermine, which resulted in strange behaviour. Sadly, the end users who encountered those flaws did not turn to Fantastico for help, but turned up on the Coppermine support board. The developers of those auto-installers are only human, and humans can make mistakes, so there's nothing wrong with the bug in itself. Subsequently, the Coppermine developers made the Fantastico staff aware of the bugs that they had introduced in the first place, asking them to fix them as soon as possible. However, they ignored the bugs for more than 18 months, during which the bug spread through the internet, resulting in even more frustrated end users seeking support from the coppermine staff on an issue that they have not been responsible for and that they could not fix themselves.

Why not use auto-installers

Using auto-installers of course has advantages. However, there are serious disadvantages as well:

No support

As a result of the sad story with Fantastico and taking into account the disadvantages of auto-installers, the Coppermine dev team has chosen not to support issues related to the fact that users have been using an auto-installer like Fantastico.

This means that the only supported install method is the one we describe in this documentation.

But do not worry: we won't leave you unsupported. Usually, you don't have to un-install your auto-installed Coppermine gallery and re-install our version; just perform an upgrade as suggested in the upgrade section of the documentation (even though the version number of your auto-installed gallery appears to be the same as they most recent "original" Coppermine package) and you should be fine.

This means that you can easily "convert" your auto-installed gallery into a "genuine" Coppermine-gallery just by performing the update/upgrade as suggested in our documentation. We will even support you performing that update in case you have issues. However, the Coppermine dev team is not ready to support you if you run a gallery that has been set up using an auto-installer. In case you're not happy with this policy, please seek support from your webhost of whoever provided the auto-installer to you.