			<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/">
				<channel>
					<title>Zenphoto - The simpler media website CMS -  (Latest news)</title>
					<link>http://www.zenphoto.org</link>
					<atom:link href="http://www.zenphoto.org/index.php?rss=news&amp;rss-news&amp;category=user-guide" rel="self"	type="application/rss+xml" />
					<description>Zenphoto is a standalone CMS for multimedia focused websites. Our focus lies on being easy to use and having all the features there when you need them (but out of the way if you do not.).</description>
					<language>en-US</language>
					<pubDate>Thu, 20 Jun 2013 00:59:23 -0400</pubDate>
					<lastBuildDate>Thu, 20 Jun 2013 00:59:23 -0400</lastBuildDate>
					<docs>http://blogs.law.harvard.edu/tech/rss</docs>
					<generator>Zenphoto RSS Generator</generator>
												<item>
								<title><![CDATA[Integration with existing sites and other CMS (CMS integration, Customizing, Development, FAQ, Theming & Templating, Troubleshooting, User Guide)]]></title>
								<link>http://www.zenphoto.org/news/integration-with-existing-sites-and-other-cms</link>
								<description><![CDATA[<div>This is not really possible as Zenphoto is actually a standalone CMS of its own. Technically, there are basically three recommended ways to "integrate" Zenphoto with another CMS:</div>
<div>
<h4>Match the look of your Zenphoto site to your existing site</h4>
<p>So this means basically to create a theme for your Zenphoto site to make it look like your existing site. For example by re-using HTML and CSS from it.</p>
<p>For Wordpress specifially there are techniques available collected here :<a href="http://www.zenphoto.org/news/integrating-zenphoto-into-wordpress-tutorials">http://www.zenphoto.org/2009/11/integrating-zenphoto-into-wordpress-tutorials/</a> Also please review our <a title="http://www.zenphoto.org/2009/03/theming-tutorial/" href="http://www.zenphoto.org/news/theming-tutorial">theming tutorial</a>. For Wordpress specifially there are some third party <a title="http://www.zenphoto.org/category/extensions/wordpress-tools/" href="http://www.zenphoto.org/category/extensions/wordpress-tools/">Wordpress tools</a> available.</p>
</div>
<div>Or maybe you want to run your entire site with Zenphoto using the <a title="http://www.zenphoto.org/2009/03/zenpage-a-cms-plugin-for-zenphoto/" href="http://www.zenphoto.org/2009/03/zenpage-a-cms-plugin-for-zenphoto/">CMS plugin Zenpage</a>.</div>
<h4>Zenphoto as a "plugin"</h4>
<p>This is a more advanced way to achieve that. You can use zenphoto features in your main web pages by including <tt>template-functions.php</tt> in your php pages. The following is an example of this technique. (The example assumes zenphoto is installed in a folder named <tt>zenphoto</tt>):</p>
<pre>&lt;?php <br />/* <br /> * This script is an example of how to use Zenphoto content from a Non-Zenphoto WEB page. <br /> * You must define SERVERPATH and WEBPATH to correctly point at the Zenphoto installation. <br /> * Here we are presuming that the running script is in the root of the WEBsite and the <br /> * Zenphoto installation is in a folder named "zenphoto" within that root folder. <br /> */ <br /> define('SERVERPATH',str_replace('\\','/',dirname(__FILE__)).'/zenphoto'); <br /> define('WEBPATH','/zenphoto'); <br /> /* <br /> * Now we "include" the Zenphoto template functions. This will instantiate the Zenphoto installation <br /> * and make all theme functions available to us. <br /> */ <br /> require_once(SERVERPATH.'/zp-core/template-functions.php'); ?&gt; <br /> &lt;!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd""&gt; <br /> &lt;head&gt; <br /> &lt;/head&gt; <br /> &lt;body&gt; <br /> &lt;p&gt;This example will show a pre-defined image. Really, almost any theme related actions could be done here.&lt;/p&gt; <br /> &lt;?php <br /> /* <br /> * Instantiate an image and make it the current image <br /> */ <br /> $albumName = 'test_album/lesser-three-gorges'; <br /> $imageName = '2007-05-03-182646_sjb.jpg'; <br /> $image = newImage(NULL, array('folder'=&gt;$albumName,'filename'=&gt;$imageName)); <br /> makeImageCurrent($image); <br /> /* <br /> * Show the image sized to "500" <br /> */ <br /> printCustomSizedImage(getImageTitle(), 500); ?&gt; <br /> &lt;!-- provide a link to the Zenphoto gallery --&gt; <br /> &lt;p&gt;&lt;a href="&lt;?php echo WEBPATH; ?&gt;"&gt;Visit the actual gallery from which this image was extracted.&lt;/a&gt;&lt;/p&gt; <br /> &lt;/body&gt; <br /> &lt;/html&gt;</pre>
<p><strong>Note: </strong>Zenphoto makes use of global variables that are setup by the template function load. This technique will NOT work if the <em>require_once</em> statement is done from within a function definition. Unfortunately Wordpress and perhaps other application invoke their plugins from within a functions, so invalidate this approach.</p>
<p>Many of the zenphoto template-functions operate on <tt>$_zp_current_album</tt>, <tt>$_zp_current_image</tt>, and <tt>$_zp_gallery</tt>. The latter are refered to as the <em>current album</em> and <em>current image</em> in the function documentation (see below.) These variables normally are setup by the process of loading the root <tt>index.php</tt> file and proceding to your theme php file. They will <strong>NOT</strong> be setup automatically for you when you use zenphoto as a plugin. You can use the functions <tt>zp_load_gallery()</tt>, <tt>zp_load_album($folder)</tt>, and <tt>zp_load_image($folder, $filename)</tt> to set these variables up. <tt>$folder </tt>is the path from the album folder to the album. <tt>$filename</tt> is the name of the image within <tt>$folder</tt>.<br /> <br /> For further details on the template functions visit the Zenphoto Functions Guide.<strong><br /></strong></p>]]></description>
																	<category><![CDATA[CMS integration, Customizing, Development, FAQ, Theming &amp; Templating, Troubleshooting, User Guide]]></category>
																	<guid>http://www.zenphoto.org/news/integration-with-existing-sites-and-other-cms</guid>
								<pubDate>Tue, 28 May 2013 14:05:04 -0400</pubDate>
							</item>
												<item>
								<title><![CDATA[Using Zenpage (FAQ, Troubleshooting, Tutorials, User Guide)]]></title>
								<link>http://www.zenphoto.org/news/using-zenpage</link>
								<description><![CDATA[<h4>Assigning a specific user to a page or article</h4>
<p>This is the way if you are the master admin and want to set up
something for users with lower rights:</p>
<div>
<div>
<ol>
<li>Create a user with rights for one album and Zenpage
rights.</li>
<li>Create a new page/article as master admin for that user.</li>
<li>Now select the user the page/article should belong to from the
author dropdown.</li>
<li>Now set the page/article to&nbsp;<em>locked for
changes</em>&nbsp;and save it. Then only admins with full admin
rights or that user will be able to edit or delete that page. For
all others the link and the icon buttons should be grayed out.</li>
</ol>
</div>
Note that every user with Zenpage rights can set every page or
article&nbsp;<em>locked for changes</em>himself that is not
already&nbsp;<em>locked for changes</em>. It does not matter if he
is the original author or not.</div>
<h4 id="how-do-i-get-images-into-my-pages-or-news-articles">How do
I get images into my pages or news articles?<a class="toc-top-link"
href=
"http://www.zenphoto.org/news/how-to-assign-a-user-to-a-specific-page-or-article-#top"><br></a></h4>
<p>There are now two ways:</p>
<div style="margin-left: 2em">
<ol>
<li>You can use&nbsp;<em>the file manager</em>&nbsp;that is
included as a TinyMCE plugin. That file manager is either
accessible via the "Manage files" button on the main pages or main
articles page or via the image button onTinyMCE tool bar.&nbsp;<br>
You can use this file manager to upload and manage many formats
that Zenphoto itself does not support. Note that files you upload
with this are placed within the uploaded folder and are independent
from the normal albums.&nbsp;</li>
<li>Also you can use&nbsp;<em>tinyZenpage</em>, a default plugin to
the by default enabled text editor TinyMCE<em>,</em>&nbsp;to access
images, albums as well as pages, articles or news cateogries for
including. Here are some&nbsp;<a title=
"http://www.zenphoto.org/zp/screenshots/zenpage-tinyzenpage" href=
"http://www.zenphoto.org/zp/screenshots/zenpage-tinyzenpage/start-page.jpg.php">tinyZenpage
screenshots</a>&nbsp;about it and there is also some general info
on the&nbsp;<a title=
"http://www.zenphoto.org/2009/03/zenpage-a-cms-plugin-for-zenphoto/"
href=
"http://www.zenphoto.org/2009/03/zenpage-a-cms-plugin-for-zenphoto/">Zenpage
plugin page</a>.</li>
</ol>
</div>
<h4>What is the CombiNews mode?</h4>
<p>This mode shows the lastest gallery items like images incl.
videos and audio or albums mixed within the news section as if
they&nbsp;<em>were</em>&nbsp;news articles. The image/album title
is shown as the title and the image/album description as the
article content. The CombiNews mode has basically three modes:</p>
<ol>
<li>Latest images: Entries for all images ever added</li>
<li>Latest albums: Entries for all albums ever created</li>
<li>Latest images by album: Entries for all images but grouped by
images that have been added within a day to each album (Scheme: 'x
new images in album y on date z')</li>
</ol>
<p>Here an example of the 3rd mode:</p>
<p><em><a class="zenpage_fullimagelink" title="combinews-example"
href=
"/albums/storage/troubleshooting/combinews-example.jpg"><img class=
"zenpage_customimage" src=
"http://www.zenphoto.org/zp-core/i.php?a=storage/troubleshooting&amp;i=combinews-example.jpg&amp;s=510&amp;wmk=!"
alt="combinews-example"></a><br></em></p>
<p>First entry is a real article, the second a gallery
one.&nbsp;</p>
<p>There is of course also a RSS mode available for CombiNews (see
the documentation).</p>
<p>Note since news articles are only sorted by date the CombiNews
might lead to unexpected results if you set the image sortorder to
"id". Try using "date" or "mtime".</p>
<p>Image and albums and articles are still independent and nothing
is changed on your site, except the display. You can use this to
easily setup a photoblog or audio/podcast blog for example.</p>
<p>The news section on zenphoto.org is an example usage of
this.</p>
<h4>The search does not work for pages and articles</h4>
<p>Zenphoto's search engine also includes articles and pages. If it
does not work and you are using none of the standard themes it
might not be implemented in your theme. See the&nbsp;<a title=
"http://www.zenphoto.org/2009/03/theming-tutorial/" href=
"http://www.zenphoto.org/2009/03/theming-tutorial/">theming
tutorial</a>&nbsp;how to implement this.</p>
<h4 class="entrytitle">Why is there a check box for editing the
Titlelink?</h4>
<p>In case you are not satisfied with the automatic generation of
the titlelink you can edit it. For example if you have a long title
you might want to have a shorter url name or maybe the seo friendly
generation cleared out something you want to be there, then you can
edit it. You can only edit it if you check the checkbox "edit
titlelink".This overrides the permaTitlelink option.&nbsp;</p>
<h4 class="entrytitle">What is a permaTitleLink?</h4>
<p>The&nbsp;<em>titlelink</em>&nbsp;is the URL name of a
page/article/category that is automatically generated seo friendly
when adding an item. This is basically the equivalent to Zenphoto's
album name and image file name and unique to that
page/article/category even if using Zenphoto's multilingual
mode.</p>
<p>If you don't check the&nbsp;<em>permaTitlelink</em>&nbsp;option
the&nbsp;<em>titlelink</em>&nbsp;will be newly generated everytime
you change the title of a page/article/category. This can lead to
broken links if someone or a search engine links to you. This
concept is taken from Wordpress where it is
called&nbsp;<em>permalink</em>&nbsp;(or&nbsp;<em>slug</em>). It is
referred to that as&nbsp;<em>titlelink</em>&nbsp;in all functions
so it is called that that here, too.</p>
<h4>I have added pages and articles but don't see them on my
site</h4>
<p>A theme with Zenpage support is required to see them. Some
themes with Zenpage support are currently:</p>
<ul>
<li>...</li>
</ul>]]></description>
																	<category><![CDATA[FAQ, Troubleshooting, Tutorials, User Guide]]></category>
																	<guid>http://www.zenphoto.org/news/using-zenpage</guid>
								<pubDate>Sun, 26 May 2013 12:57:14 -0400</pubDate>
							</item>
												<item>
								<title><![CDATA[Working with albums and images (FAQ, Troubleshooting, Tutorials, User Guide)]]></title>
								<link>http://www.zenphoto.org/news/working-with-albums-and-images</link>
								<description><![CDATA[<h4>Is there any limit to the number of images?</h4>
<p>There are no limits to the number of images Zenphoto can display
in a gallery or album. Zenphoto is file system based and unique in
that it scales relatively well due to its simple design. The speed
of the gallery is dependent on a few minor things, namely the
number of images in any given album.<br>
Zenphoto should be able to handle any number of images in the
entire gallery ”“ it will help greatly with performance if they are
separated into smaller albums. Even then, single albums with 2000+
photos are possible and will still be usable.<br>
<br>
If you're having trouble with the speed of large galleries, try
using the static_html_cache plugin to cache Zenphoto pages.
Frequently loaded pages will be much faster.</p>
<h4 class="entrytitle">Is it possible to remove the filename
extension from image names in the URL?</h4>
<p>No, the unique identifier to find the photo requested is the
actual filename, and the only way to get that is from the URL, so
it must contain the filename. That's just how ZP works, it's
filesystem-based. The titles are rather stored in the database as
metadata, which you can't use to get a photo and doesn't need to be
unique.</p>
<h4>Replacing default images</h4>
<p>Zenphoto uses various default images for display like default
thumbs for multimedia items if no video thumbnail is used or for
password protected albums.&nbsp;You can of course use your own
images instead.</p>
<p>Example:&nbsp;/zp-core/images/err-passwordprotected.png</p>
<p>To replace this place an image of the same name within one of
these places:</p>
<ol>
<li>/plugins/images/err-passwordprotected.png&nbsp;(globally)</li>
<li>
/themes/&lt;yourtheme&gt;/images/err-passwordprotected.png&nbsp;(only
for the theme)</li>
</ol>
<p>The same can be done with plugins. Replicate the plugin folder
structure in your theme and the files therein will override the
default ones. Or you can make "global" overrides of files by
placing the structure in the plugins folder.</p>
<h4>Where to upload images etc. via FTP?</h4>
<ol>
<li><strong>The main gallery part:</strong> Zenphoto is file system
based and stores its albums and images within the
root&nbsp;<tt>albums</tt>&nbsp;folder. This folder may not contain
images directly but organized in folders. These folders are
recognized as albums by Zenphoto and may contain images and further
sub folders in unlimited levels.</li>
<li><strong>Files outside the gallery:</strong>&nbsp;The files are
stored within the folder&nbsp;<tt>uploaded</tt>&nbsp;that is
located in the root folder of your Zenphoto installation and that
is created while running setup automatically.</li>
</ol>
<h4 class="entrytitle">Moving, copying and renaming images and
albums without loosing data entered</h4>
<p>First you need to understand that Zenphoto is file system based.
It recognizes albums and images on discovery. What is not found
there anymore is considered gone. What is found new is considered
new.</p>
<ol>
<li><strong>Images</strong>
<ol type="a">
<li><strong>Info embeded via image meta data
(EXIF/XMP):<br></strong>This is the way we recommend. On uploading
Zenphoto will read this data and add it to the database. If you you
now move, copy or rename image files via FTP the data will travel
with the images as it is embeded in them. However the images will
be recognized as new even if their data travels with them.</li>
<li><strong>Info added to the database on the backend:</strong><br>
If you have not embeded the data in the images and move, copy or
rename them via FTP the data will be lost. If you want to avoid
this you have to use the tools for "move, copy, rename" you find on
right side on each image's entry on the backend edit pages. Then
the data of the database is moved as well.</li>
</ol>
</li>
<li><strong>Albums</strong><br>
On the file system albums are just folders. Folders can't have meta
data so on moving, copying or renaming a folder all of the info
entered to the database on the backend will be lost. This counts of
course also to its images except you have embeded their info. If
you want to avoid this you have to use the tools for "move, copy,
rename" you find on right side on each album's entry on the backend
edit pages. Then the data of the database is moved as well.</li>
</ol>
<h4>Anyonymous uploads by unregistered users</h4>
<p>It is not possible to upload via the backend being unregistered
and it is really not recommended to lay your site open to the hacks
people could do to you with un-gated access.</p>
<p>If you really want to do this, setup an "unpublished, protected"
album . (Or leave the album published, but set the default for
albums and images images to be unpublished.) Create an anonymous
FTP account that allows write only access to this album folder.</p>
<p>Then your anonymous guests can FTP files and folders to with
that account until your server chokes with too much traffic or your
disk is filled to the brim. You can view this folder and
publish/move images you want to approve.</p>
...]]></description>
																	<category><![CDATA[FAQ, Troubleshooting, Tutorials, User Guide]]></category>
																	<guid>http://www.zenphoto.org/news/working-with-albums-and-images</guid>
								<pubDate>Sun, 26 May 2013 12:56:49 -0400</pubDate>
							</item>
												<item>
								<title><![CDATA[Problems with albums and images (FAQ, Troubleshooting, User Guide)]]></title>
								<link>http://www.zenphoto.org/news/problems-with-albums-and-images</link>
								<description><![CDATA[<h4>Thumbnails/sized images are not generated and/or the server
crashes</h4>
<h5 id="server-memory-issues">Server memory issues<a class=
"toc-top-link" href=
"http://www.zenphoto.org/news/why-are-some-of-my-thumbnails-sized-images-not-generated-why-does-zenphoto-make-my-server-crash-while-processing-images-%0A#top"><br></a></h5>
<div>If you're running a web server on a VPS or other
resource-limited environment, then you might not have enough memory
available to the server to process very large images. You can use
the following table as a guideline to see how much memory you need
available to process images of different sizes:</div>
<ul>
<li>VGA Image, 640 x 480 pixels =&gt; needs ~4.1 MB Memory</li>
<li>SVGA Image, 800 x 600 pixels =&gt; needs ~4.8 MB Memory</li>
<li>1 MP Image, 1024 x 798 pixels =&gt; needs ~6.3 MB Memory</li>
<li>2 MP Image, 1600 x 1200 pixels =&gt; needs ~11.7 MB Memory</li>
<li>6 MP Image, 2816 x 2112 pixels =&gt; needs ~22.6 MB Memory</li>
<li>8.2 MP Image, 3571 x 2302 pixels =&gt; needs ~41.7 MB
Memory</li>
</ul>
<div>As you can see, the 8.2-Megapixel 3571x2302 image requires a
very large amount of memory to process, and that's simply because
of the number of pixels. It doesn't matter if the image is only 2
or 3 megabytes when compressed in JPEG form, or what colors the
image contains or anything-- it's just how big it is, because all
of those pixels have to have a place in memory while the GD library
processes them. There's no way around it!</div>
<h5>Workaround 1: Re-configuring your server to work with large
image files (5MB to 10MB)</h5>
<p><em>Tutorial written by Aladio (<a href=
"https://github.com/zenphoto/zenphoto/issues/169">https://github.com/zenphoto/zenphoto/issues/169</a>)</em></p>
<div>
<p>The aim of this tutorial is to help the intermediate user
configure PHP and setup large image files so they may be uploaded
and displayed properly using Zenphoto.</p>
<h6 id="configuring-php">Configuring PHP</h6>
<p>The following 5 settings need to be verified or changed in the
php.ini file, found on your web server, in order to run Zenphoto
with large image files.</p>
<p class="articlebox-left"><strong>Note:</strong>&nbsp;You should
confirm with your web-host that these settings are supported and
how much server memory is available! If you are on a shared host
you probably might not be allowed/able to changes these.</p>
<ol>
<li>
<p>Find memory_limit around line 455 set it to 128M<br>
; Maximum amount of memory a script may consume (128MB)<br>
;&nbsp;<a href=
"http://php.net/memory-limit">http://php.net/memory-limit</a><br>
memory_limit = 128M</p>
</li>
<li>
<p>Find post_max_size around line 725 set it to a big number so you
can upload multiple large files.<br>
; Maximum size of POST data that PHP will accept.<br>
;&nbsp;<a href=
"http://php.net/post-max-size">http://php.net/post-max-size</a><br>
post_max_size = 1G</p>
</li>
<li>
<p>Find file_uploads around line 865 set it to On.<br>
; Whether to allow HTTP file uploads.<br>
;&nbsp;<a href=
"http://php.net/file-uploads">http://php.net/file-uploads</a><br>
file_uploads = On</p>
</li>
<li>
<p>Find upload_max_filesize around line 865 set it to a big number
so you can upload multiple large files.<br>
; Maximum allowed size for uploaded files.<br>
;&nbsp;<a href=
"http://php.net/upload-max-filesize">http://php.net/upload-max-filesize</a><br>
upload_max_filesize = 1G</p>
</li>
<li>
<p>Find max_file_uploads around line 865 set it to upload multiple
files at once.<br>
; Maximum number of files that can be uploaded via a single
request<br>
max_file_uploads = 20</p>
</li>
</ol>
<h6 id="setting-up-large-image-files-5mb-to-10mb">Setting up Large
Image Files (5MB to 10MB)</h6>
<p><em>Horizontal or Landscape Images (height &lt; width)</em></p>
<p>If you are able to make the above changes to your php.ini file,
large landscape image files should display fine when running
Zenphoto.</p>
<p><em>Vertical or Portrait Images (height &gt; width)</em></p>
<p>Large portrait image files must be rotated properly or PHP will
run out of memeory while Zenphoto is trying to rotate and resize
your image. You will see a box containing the name of the image
instead of the image itself if the error occurs. (See below for
directions on how to debug images).</p>
<p>Zenphoto reads the EXIF data contained in the image file to
determine the image orientation. If the EXIF orientation property
is set to anything but 1, Zenphoto will try to rotate your image.
If the image is a large one the process will fail.</p>
<h6 id="debugging-images">Debugging images</h6>
<p>There could be many reasons for this, so the best way to
diagnose this problem is to view the actual image error itself. You
can do this by adding '&amp;debug' to the image URL zenphoto uses
to process the image.</p>
<p>To do that, locate the failed image in your gallery (it should
show just the filename with a box around it, in place of the
image), then right-click it and choose 'Copy Image Location'
(Firefox; in IE, choose 'properties' and copy the image URL from
there).</p>
<p>Then, paste that URL into your address bar, and at the end of
it, type "&amp;debug" without quotes. Press enter to see the image
processor's error message. If you need help diagnosing it, feel
free to post on the support forums.</p>
</div>
<h5 id="workaround-2-use-imagick-instead-of-the-gd-libary">
Workaround 2: Use Imagick...</h5>]]></description>
																	<category><![CDATA[FAQ, Troubleshooting, User Guide]]></category>
																	<guid>http://www.zenphoto.org/news/problems-with-albums-and-images</guid>
								<pubDate>Sun, 26 May 2013 12:56:23 -0400</pubDate>
							</item>
												<item>
								<title><![CDATA[Using external sources (FAQ, Troubleshooting, User Guide)]]></title>
								<link>http://www.zenphoto.org/news/using-external-sources</link>
								<description><![CDATA[<h4>Administrating images hosted on another server</h4>
<p>Zenphoto unfortunately does not support this. Zenphoto must be installed on the same server as the photos it is hosting. This is what we recommend.<br />Even if this was possible, it would be very slow as Zenphoto is filesystem-based and uses many filesystem operations, and doing that over a network would slow things down significantly.</p>
<h4>Using videos from Youtube or other portals</h4>
<div>Zenphoto is actually meant to manage multimedia files on your own webspace but with Zenphoto 1.2.6 there is indeed a way:</div>
<ol>
<li>Enable the <tt>class-textobject</tt> plugin on the backend plugins page.</li>
<li>Upload a plain text file (.txt) with code to embed a specifc (video) file via ftp or the backend.</li>
<li>To use an thumbnail besides the default one follow the same <a title="Zenphoto video thumbnails" href="http://www.zenphoto.org/2009/03/troubleshooting-zenphoto/#19">instructions as for video thumbnails</a>.</li>
<li>That's all.</li>
</ol>
<p>So actually this does work with all kind of services that provide an embed code.</p>]]></description>
																	<category><![CDATA[FAQ, Troubleshooting, User Guide]]></category>
																	<guid>http://www.zenphoto.org/news/using-external-sources</guid>
								<pubDate>Sun, 26 May 2013 12:56:04 -0400</pubDate>
							</item>
												<item>
								<title><![CDATA[Caching (FAQ, Troubleshooting, User Guide)]]></title>
								<link>http://www.zenphoto.org/news/caching</link>
								<description><![CDATA[<h4>How caching works</h4>
<div> </div>
<div>There are several different caches:</div>
<ol>
<li><strong>Image cache</strong>: Zenphoto does not touch the original images you uploaded to the albums directory. But it does cache the resized images like thumbs, sized images or any other sized images so they don't have to be generated any time again. Zenphoto creates these cached files on the fly. This means they are not preliminary created but on request, e.g. if someone visits a page of your site. Depending on teh dimensions of your images and your server's power this might result in an initial delay once.Those images are stored in the root /cache folder. You can clear this cache manually on the backend. It is for obvious reasons not possible to delete this cache. Note Zenhoto can't create thumbs from multimedia files.<br /><br /><a class="zenpage_imagelink" title="zenphoto-12-image-discovery12" href="/storage/zenphoto-visualized/zenphoto-12-image-discovery12.jpg.php"><img class="zenpage_customimage" src="http://www.zenphoto.org/zp-core/i.php?a=storage/zenphoto-visualized&amp;i=zenphoto-12-image-discovery12.jpg&amp;s=510&amp;wmk=!" alt="zenphoto-12-image-discovery12" /></a></li>
<li><strong>RSS cache</strong>: Zenphoto caches the rss feeds provided as static .xml files in the root <em>/cache_html/rss/</em> folder. This can of course be disabled via an option.</li>
<li><strong>Static HTML cache</strong>: Optionally there is also the included static_html_cache plugin that caches all pages as static .html files in the same <em>/cache_html</em>. If you use the multilingual option a page for each language is generated automatically. Note that the cachce needs to be cleared if you change anything and want to to appear before the expire date set, it is not autocleared when saving an update.</li>
<li><strong>Sitemap cache</strong>:If you have eenabled the sitemap-extended plugin the sitemap is cached in <em>/cache_html/sitemap</em> as a static xml file as well. You can of course also disable this cache via the plugin's options.</li>
</ol>
<h4>Pre-caching images and why it is technically not necessary</h4>
<p>Zenphoto was designed to lazy-load images to allow a gallery of unlimited size while still allowing viewing any image at any time regardless of whether it has been processed or not. It does it on the fly. It was not designed to process them all at once, the pre-caching was a hack that was added on later. The diagram above shows the process.</p>
<p>Better to leave them be, let the gallery work as it is, and process them when they're first requested. For users, this will mean a very slight delay the first time an image is *ever* viewed, and absolutely none after that. This is how Zenphoto is designed to work, and we think how it works best. No need to pre-cache anything, just quit worrying about the initial lag from the first processing, it only happens once.</p>
<div>If you really need to precache image use the cache_manager plugin. But note that a theme may use special custom sizes that may not be covered by the plugin unless the theme properly registers the sizes. See the plugin documentation for details on that.</div>
<div> </div>
<h4 class="entrytitle">Why are images of the correct size still cached additionally?</h4>
<p>Once-upon-a-time the image was not cached for display on the single image display (<span class="inlinecode">image.php</span>) if the size is already the needed size. Remember Zenphoto's albums are file system based so there was a serious problem with that strategy. Caching an image happens only once per "size" and takes some disk space. Testing to see if the image should be cached happens every time the image is referenced for display in any way. </p>
<div>
<p>So the trade-off is storage space vs. processing overhead. With the cost of disk so low these days the choice is a no-brainer.</p>
<p>If you want no processiong/caching you need to modify your theme's <span class="inlinecode">image.php</span> to use the full image directly.</p>
</div>]]></description>
																	<category><![CDATA[FAQ, Troubleshooting, User Guide]]></category>
																	<guid>http://www.zenphoto.org/news/caching</guid>
								<pubDate>Sun, 26 May 2013 12:55:37 -0400</pubDate>
							</item>
												<item>
								<title><![CDATA[Meta data usage (FAQ, Troubleshooting, User Guide)]]></title>
								<link>http://www.zenphoto.org/news/meta-data-usage</link>
								<description><![CDATA[<p>Without metadata (EXIF, IPTC, XMP side car files) there is no title that is associated with the imagefile. The normal working of Zenphoto is to use metadata if it exists in the image. It will only use the filename if no other title is found.</p>
<p>Once a title is set, it is not changed unless you invoke a metadata refresh. So note that even if you changed the title or any other metadata based content it will be overridden on a metadata refresh.</p>
<p>It is possible to exclude certain metadata fields from importing via the backend options</p>]]></description>
																	<category><![CDATA[FAQ, Troubleshooting, User Guide]]></category>
																	<guid>http://www.zenphoto.org/news/meta-data-usage</guid>
								<pubDate>Sun, 26 May 2013 12:55:19 -0400</pubDate>
							</item>
												<item>
								<title><![CDATA[Problems with languages (FAQ, Internationalisation & localisation, Troubleshooting, User Guide)]]></title>
								<link>http://www.zenphoto.org/news/problems-with-languages</link>
								<description><![CDATA[<div>
<h4 class="entrytitle">Difficulties with zenphoto language translations</h4>
</div>
<p>There are several problems you might be having with language translations:</p>
<ol>
<li><strong>There is no language selection for my desired language</strong>.<br />Zenphoto relies on volunteers to translate each release. We have a large number of dedicated individuals making translations. There may be a translation for your language which was not avaiable in time for the zenphoto release. You can check by reviewing on<a title="GitHub" href="https://github.com/zenphoto/zenphoto">GItHub </a>the current master branch or the development branch for the next release. If you language does not exist there, consider volunteering to produce it. For details see our<a href="http://www.zenphoto.org/2008/05/translating-tutorial/">translation tutorial</a>.</li>
<li><strong>There are phrases which are displayed in English even though I have selected a different language</strong>.<br />Zenphoto is an ever evolving software. We will occasionally include a translation that is not 100% complete feeling that something is better than nothing. Check the curent <a title="master branch download" href="https://github.com/zenphoto/zenphoto/archive/master.zip">Zenphoto master</a> branch to see if there is an update for your language. If that does not resolve the issue, post a note on the issue report indicating what revision of zenphoto your are running and phrases which are displaying in English. (It will also help if you indicate where you see them, eg. the <em>Stopdesign</em> image page, the <em>admin</em> theme tab.)</li>
<li><strong>When I select my language I get an error saying that the locale is not supported on my server</strong>.<br />Language support requires two capabilities in addition to #1 above. First the server running your site must have support installed for the <em>locale</em> associated with your language. (See #4 for the second capability.) If you are getting an error when selecting a language saying that it is not supported on the server you will have to contact your provider to get the server updated with the necessary language support. You can get a list of <em>locales</em> your server supports by running the <a href="http://www.zenphoto.org/wp-content/uploads/2008/08/list_locales.zip">list_locales</a> script. For further information on <em>locales</em> see <a href="http://www.linux.com/feature/53781">Controlling your locale with environment variables</a> and <a href="http://herkules.oulu.fi/z3950/Locales">Locales mini-HOWTO.</a>You can also look at the output of the list_locales script to see if there is an alternative language that fits your needs. For instance, if Zenphoto supplies a Spanish (Latin America) tranlsation But your server does not support it. Maybe your server supports Spanish (Bolivia). You could rename the es_LA folder to es_BO and get the translations.</li>
<li><strong>Even though support for my language exists, I am getting only English text.</strong><br />Zenphoto uses a PHP feature named <em>gettext()</em> to support translations. If you are getting a notice from setup.php that PHP <em>gettext()</em> support is not installed all text will be displayed in English no matter which language you have selected. We hope in the future to have a replacement library to provide translations for installations with no <em>gettext()</em> support. Until then you will have to arrange with your ISP for gettext to be installed.</li>
<li><strong>I have selected HTTP Accept Language on the admin gallery configuration tab but I am not seeing text in my language.<br /></strong>Your browser must specify your preferred language. To see what is being reported as your preferred languages run the <a href="http://www.zenphoto.org/wp-content/uploads/2008/08/list_locales.zip">list_locales</a> script. (Also see #3 and #4 above.</li>
</ol>
<h4 class="entrytitle">TinyMCE is not translated</h4>
<p>TinyMCE is a third party solution that uses its own translation files and technique. There are already some languages preinstalled. These are bascially those that are currently completed or partly available for Zenphoto itself. But you might want to check its <a href="http://www.tinymce.com/i18n/index.php">own project site for more or also updated translations</a>.</p>]]></description>
																	<category><![CDATA[FAQ, Internationalisation &amp; localisation, Troubleshooting, User Guide]]></category>
																	<guid>http://www.zenphoto.org/news/problems-with-languages</guid>
								<pubDate>Sun, 26 May 2013 12:54:48 -0400</pubDate>
							</item>
												<item>
								<title><![CDATA[Using plugins and third party features (Customizing, Development, FAQ, Theming & Templating, Troubleshooting, User Guide)]]></title>
								<link>http://www.zenphoto.org/news/using-plugins-and-third-party-features</link>
								<description><![CDATA[<h4>Installing third party plugins</h4>
<h5>Installing</h5>
<p>Official plugin and extensions resided within
/zp-core/zp-extensions. You should <strong>never</strong> install
third party plugins there.&nbsp;Instead you need to install them
within the root /plugins folders.</p>
<p>Zenphoto plugins consist at least of one
file&nbsp;&nbsp;&lt;pluginname&gt;.php.&nbsp;It may optionally use
a folder of its same name within
the&nbsp;<em>plugins</em>&nbsp;folder that contains further files
like extra functions, css files or images. Example:</p>
<pre>
plugins/&lt;yourplugin&gt;.php
plugins/&lt;yourplugin&gt;/ (contains additional files needed by your plugin)
</pre>
<p>If you download a (third party) plugin and uncompress (unzip) it
you will often have the file or the file and folder within another
folder. <strong>Don't upload that folder</strong>&nbsp;but its
content as shown above&nbsp;to the&nbsp;/plugins
folder&nbsp;directly.&nbsp;The third party plugin should now show
up on the plugins tab on the backend.</p>
<h5>Usage</h5>
<p>Not all themes are already setup with all plugin features
because they are optional. On our themes page your can see what
standard theme supports which layout specific plugins.<br>
<br>
This means you have to add some of them to your theme files
yourself. This is generally very easy as it is mostly just adding
one extra function where you want the plugin's feature to be
visible. Please refer to the plugin's instruction. Please
additionally refer to these text to learn how to do that:</p>
<ul>
<li><a title="http://www.zenphoto.org/documentation/index.html"
href="http://www.zenphoto.org/documentation/index.html">Zenphoto
functions documentation</a></li>
<li><a title=
"http://www.zenphoto.org/2008/04/how-to-read-the-zenphoto-functions-guide/"
href=
"http://www.zenphoto.org/2008/04/how-to-read-the-zenphoto-functions-guide/">
How to read the functions guide</a></li>
<li><a title="http://www.zenphoto.org/2008/05/theming-tutorial/"
href="http://www.zenphoto.org/2008/05/theming-tutorial/">Theming
tutorial</a></li>
</ul>
<h4 class="entrytitle">Adding third party features to Zenphoto</h4>
<p>In addition to&nbsp;<a title="Zenphoto Theming tutorial" href=
"http://www.zenphoto.org/2009/03/theming-tutorial/">theming</a>,
Zenphoto has a&nbsp;<a title="Zenphoto Plugin Architecture" href=
"http://www.zenphoto.org/2008/04/zenphoto-plugin-architecture/">plugin
architecture&nbsp;</a>that lets third party developers add
capability to the Gallery. In addition many of the standard
features can be enhanced by the addition of specific files. As from
Zenphoto release 1.2.7 we have separated as much as possible the
standard Zenphoto files and scripts from ones that are otherwise
provided.<br>
<br>
As in the past, new themes can be added as folders in the
root&nbsp;<em>themes</em>&nbsp;folder. With release 1.2.7
the&nbsp;<em>plugins</em>&nbsp;folder has been moved into the root.
It is entirely for third party extensions to Zenphoto. Zenphoto
standard plugins now reside in
the&nbsp;<em>zp-core/zp-extensions</em>&nbsp;folder. You can now
remove a few root files, the&nbsp;<em>zp-core</em>&nbsp;folder, and
the theme folders of Zenphoto distributed themes prior to uploading
a new version and insure that your new install will not contain any
legacy Zenphoto scripts.<br>
<br>
There are several folders included in
the&nbsp;<em>plugins</em>&nbsp;folder for adding to Zenphoto
standard features. These are:</p>
<ul>
<li><em>effenberger_effects</em>&nbsp;-- the folder where the
effenberger_effects plugin effects scripts are stored. (We have not
provides these scripts based on licensing restrictions. You can
download them and place them in this folder and they will be
available to the plugin. See the plugin description for
details.)</li>
<li><em>flvplayer</em>&nbsp;-- Also due to licensing restrictions
you will have to download the flvplayer support files and place
them in this folder. (See the plugin description for details.)</li>
<li><em>gd_fonts</em>&nbsp;--&nbsp;<em>Captcha</em>&nbsp;and
the&nbsp;<em>text-watermark</em>&nbsp;plugin can make use of custom
fonts. You can add to the repetoir of fonts available by placing
them in this folder. You can download gd_fonts from&nbsp;<a href=
"http://www.devtrolls.com/gdf_fonts/fonts.html">http://www.devtrolls.com/gdf_fonts/fonts.html</a></li>
<li><em>watermarks</em>&nbsp;-- Place images you wish to use for
watermarking in this folder.</li>
</ul>
<h4>Setting up a theme for Colorbox</h4>
<p>If you wish to display the full image using the Colorbox plugin,
you probably need to modify your theme if it does not have support
for it already. Just enabling the plugin is not enough otherwise.
It is recommended to read the<a href=
"http://www.zenphoto.org/news/theming-tutorial">theming
tutorial</a>&nbsp;for theming basics.</p>
<h5 id="imagephp">image.php<a class="toc-top-link" href=
"http://www.zenphoto.org/news/how_to_setup_a_theme_for_colorbox#top"><br></a></h5>
<p>Generally all standard themes link the sized image to the full
image. To make it open in a Colorbox you need to add the javascript
jQuery definition to the page's header and add a class to the link
so Colorbox is assigned to it. If you set the full image to
protected you need to add to the jQuery js define
the&nbsp;<span class="inlinecode">photo:
true</span>&nbsp;option.</p>
<p>You can look at the Zenpage...</p>]]></description>
																	<category><![CDATA[Customizing, Development, FAQ, Theming &amp; Templating, Troubleshooting, User Guide]]></category>
																	<guid>http://www.zenphoto.org/news/using-plugins-and-third-party-features</guid>
								<pubDate>Sun, 26 May 2013 12:54:00 -0400</pubDate>
							</item>
												<item>
								<title><![CDATA[Login and password problems (FAQ, Troubleshooting, User Guide)]]></title>
								<link>http://www.zenphoto.org/news/login-and-password-problems</link>
								<description><![CDATA[<div>
<h4 class="entrytitle">Forgotten admin password</h4>
</div>
<ol>
<li>If you supplied an email address in the Admin options there should be a Captcha string image on the log-on page. Entering that string as the log-on password will email you a link to reset your password.</li>
<li>If the Captcha is not there, or if you don't get the email, you need to delete the Administrators table in your database and re-run setup.</li>
</ol>
<h4>Problems logging into the adminbackend</h4>
<p>First please review <em>"I forgot my admin password"</em> above. If you are still having problems after following that advice you will have to enable some debugging to allow the developers to observe what is happening when you attempt your login. Locate your site's global-definitions.php file. Using a text editor find the line which contains</p>
<p><code class="syntax highlighted">define('DEBUG_LOGIN', false); // set to true to log admin saves and login attempts</code></p>
<p>Change <em>false</em> to <em>true</em> and save the file. Now drop your <em>administrator</em>'s table as described in the referenced troubleshooting article above.</p>
<ol>
<li>Delete any <em>debug_log.txt</em> file in your <em>zp-data</em> folder</li>
<li>Run setup</li>
<li>Create a new user/password</li>
<li>then attempt to log in.</li>
</ol>
<p>A new debug log will be created containing infromation the developers will need to troubleshoot your problem.</p>
<div>
<h4 class="entrytitle">Password protected albums can be viewed without entering a password</h4>
<p>There are two things that might be happening here:</p>
</div>
<ol>
<li>You are logged in as the administrator. Administrators are allowed to view any album, password protected or not.</li>
<li>You have logged into the album at sometime in the past. Album passwords are remembered in cookies so that vieweres do not have to log in at each page display.</li>
</ol>]]></description>
																	<category><![CDATA[FAQ, Troubleshooting, User Guide]]></category>
																	<guid>http://www.zenphoto.org/news/login-and-password-problems</guid>
								<pubDate>Sun, 26 May 2013 12:53:28 -0400</pubDate>
							</item>
										</channel>
				</rss>
			