General contributor guidelines Nov 29, 2009 / Updated: May 22, 2013
You can help by answering general questions of users the developers do not have the time to answer. If we see you helping a lot you may even be provided with moderator status and so to speak part of the "support team".
Zenphoto is constantly developed and sometimes new bugs sneak in without being noticed while fixing other things. By testing the development version from GitHub you help finding these.
Report any bugs you find via the bugtracker and provide detailed information what you did and what setup you use (Zenphoto version, theme, server configuration etc.). Some guidelines to help us to help you:
- Disable all third party plugins and if using a third party or custom theme try to reproduce the issue with an official one
- Always use the latest Zenphoto release
- If you can try the support build to see if the issue meanwhile has been fixed
- Review the Zenphoto debug log and your server error logs for errors (if you get blank pages this is the first you should do)
- If the issue persists, provide detailed information like Zenphoto version, theme used, server configuration etc.
Providing bug fixes and patches
You can also provide bug fixes or patches via GitHub we may choose or not choose to include after reviewing them. Note that by doing so you agree to release them under the GPL v2 license Zenphoto is released under if they are included.
Be sure to use at least the latest Zenphoto release or even better the current support release.
Zenphoto ist used internationally and although we have regualr team of translators a lot of languages are of course still missing.
Before starting an translation you should have read our translating tutorial that has detailed info how Zenphoto's translation works and what tools you need to provide a translation.
By submitting a translation you agree that it may be distributed with the Zenphoto download package. Your translation should be provided under a open license compatible to Zenphoto's GPL v2 license. If no special license note is attached, we will assume GPL.
We try hard to document everything Zenphoto related but there might be things that are missing. You can suggest things on the forum or you can register on Trac and use the somewhat unused Wiki as a sandbox (you may need to be approved by us to be allowed to do this. Let us know on the forum). If your tutorial is good to go we may move it to the real user guide section or provide a link.
Our documentation is released under a Creative Commons Attribution Share Alike license. By submitting anything for inclusion you agree to this license.
Or if you have written on your blog or found something useful elsewhere let us know via the forum. We then either add a link to your site and/or post it on our news sections.
We welcome any third party theme. Of course it is assumed that you have some knowledge of general web techniques and have read specifically theming tutorial, developer coding guidelines and other related articles on our user guide section.
- Be sure to use the most recent Zenphoto release. Best test also the current development build to be safe for the next release, too..
- Provide a read me file and list if your theme or plugin requires anything specific. Also if your theme supports specific plugins or requires special settings to run as expected.
- If you took over or modified an existing theme that has been abandoned beware of its licence. While the code may be under a GPL open source license, the design may not and released under a specific license (like the stopdesign themes that are not free for commercial use!)
Licences: You may choose any licence or usage condition you wish for your theme. The Creative Commons licenses variants are very suitable for this. Note that this only covers the design part of a theme. (HTML/CSS is mostly not considered protected as it is mostly too general a technique.) Plugins and their code as well as the PHP code of your theme will most likely be GPL v2 like Zenphoto as well since the GPL licenses demands that derived code must be distributed under the same terms.
However individual parts of the code may very well be protected under another license.
If your theme or plugin uses 3rd party tools that are not GPL v2 or do not allow for example commercial use please state this explicitly. You agree that we use text excerpts for the entry from your site/page and/or in case of a theme screenshots to create an entry on our site.
- Create a page for the plugin or theme on your website that we can link to from our themes section as we generally don't host third party themes or plugins as we have no resources to maintain them (except for some very old ones we do). A project page on code hosting services like Google Code, GitHub or the like is of course fine.
- Let us know on the forum what you did so we can add it to the related sections. You may also use the Zenphoto forum to provide free support for your theme or plugin.
This work by www.zenphoto.org is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.