User guide
Help on the forum
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".
Test svn/nighty builds and report bugs/Providing bug fixes and patches
Zenphoto is constantly developed and sometimes new bugs sneak in without being noticed while fixing other things. By testing the nightly build or the svn you help finding these. Be aware that there are two builds done each night. One for the "Trunk" or current release and one for the development release. Testing on both is appreciated.
Report any bugs you find via the bugtracker (registration required) and provide detailed information what you did and what setup you use (Zenphoto version, theme, server configuration etc.).
You can also provide bug fixes or patches 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.
Provide translations
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.
Contribtute to documentations or write tutorials
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.
Themes and plugins
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.
http://en.wikipedia.org/wiki/GNU_General_Public_License
http://www.gnu.org/licenses/gpl.html
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 (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.
For questions and comments please use the forum or discuss on the social networks.
