zoph  v0.9.11
About: Zoph is a web based digital image presentation and management system (photo album). It is built with PHP, MySQL and Perl.
  Fossies Dox: zoph-v0.9.11.tar.bz2  ("unofficial" and yet experimental doxygen-generated source code documentation)  

zoph Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies
  4. zoph-v0.9.11.tar.bz2 contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
README.md

Zoph 0.9.11 Readme

http://www.zoph.org

Introduction

Zoph (Zoph Organizes Photos) is a web based digital image presentation and management system. In other words, a photo album. It is built with PHP and MySQL.

Many people store their photos in the digital equivalent of a shoe box: lots of directories with names like 'Holiday 2008', 'January 2005' or even 'Photos034'. Like shoe boxes, this is a great way to put your photos away, but not such a great way to find them back or even look at them. Zoph can help you to store your photos and keep them organized.

While most photo album projects are primarily targeted at showing your photos to others, Zoph is primarily targeted at keeping your photos organized for yourself, giving you granular control over what you'd like to show to others, on a per-album or even a per-photo basis.

If you just want to generate a gallery of thumbnails from a bunch of images, you may want to try one of the other numerous photo album projects. But if you want to also store additional information about your photos, search them, or control access to them, take a look at Zoph.

Installation

Read the the Requirements, Installation guide docs. In order to customize your Zoph installation, read the Configuration guide. If you are upgrading from a previous version, read the Upgrade Instructions document.

For full documentation, see the docs directory.

Copying

Zoph is free software. It is released under the GPL license. Please read the license file for more details

Feedback

Please report issues via https://github.com/jeroenrnl/zoph/issues

Thanks

Zoph makes use of the following packages, for which I thank their authors for making available:

For a list of individuals who have contributed fixes, improvements or translations, click on the 'about' tab within Zoph.

Troubleshooting

GD library missing

I'm trying to use the importer from the web but I get this error:

Fatal error: Call to undefined function: imagecreatefromjpeg()

To use the importer you need the GD 2 library for image creation support in PHP. See the REQUIREMENTS doc for more info.

Moving photos on disk

I moved my photos around after I loaded them and now I see broken images. How can I fix them?

If you move images to a different directory you'll start seeing broken images in Zoph unless you also update the 'path' field in the database.

If you edit a photo, at the bottom of the page you'll see a 'show additional attributes' link. That will let you edit the path for a photo.

If you're moving a bunch of photos, you may want to just create a list of their names as you are relocating them and then change all the paths at once from within MySQL:

mysql> update photos set path = 'new_path' where name in ('photo1.jpg', 'photo2.jpg');

Why do I see some English phrases when I'm using a translation:

[vo] that have been categorized

Some language files are missing a few translations. Many, but not all, are shown in italics and preceded by [vo]. To fix this simply open the correct language file in the lang/ directory and add a transltions of the missing string (the English string should already be present in the file). Please share your changes, through an issue or fork + pull request.

Change width of Zoph display

Can I get Zoph to take up my whole browser window rather than that little rectangle?

Try setting Screen width in the configuration screen (admin -> configuration) to "100%".

Can I customize the name/title used in the interface?

Change Title in the configuration screen (admin -> configuration) This is what appears on the logon page, on the home page, and in the title of every page.

Changing text

I don't like your welcome screen, your instructions on the import page, or your use of English in general.

You could edit the templates so that Zoph says just what you want. A better alternative is perhaps to create your own custom translation. Create a file in the lang/ directory that maps English to English and tweak whatever phrases you want. For example:

Welcome %s. %s currently contains=Go away %s. %s isn't for you.

Miscellaneous

How do you pronounce Zoph?

I say Zoph with an O like in photos, some say Zoph like software ("Zophtware"), but you can pronounce it however you like.

What license is Zoph released under?

Zoph used to be licensed under the modified BSD license. As of version 0.4 this has been changed to the GPL license. We have done our best to make sure all the code in Zoph could be changed to this license. If you feel your copyright has been violated with this change, please contact us a.s.a.p. Some included files have their own license because the license doen not allow us to change it to GPL.