slp/po
1
0
Fork 0
Code Issues 2 Pull requests Projects Releases Wiki Activity

PO 2.32

Browse source
This commit is contained in:
Solomon Peachy 2008-08-17 10:54:09 -04:00
parent bff5cd9cf2
commit d573874647
239 changed files with 3209 additions and 3640 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

453
CHANGES Normal file
View file

@ -0,0 +1,453 @@
==========================================================================
Copyright (C) 2002-2006 Balint Kis (balint@k-i-s.net)
Copyright (C) 2005-2006 Solomon Peachy (pizza@shaftnet.org)
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
==========================================================================
For further information about Photo Organizer, see its web site at:
http://po.shaftnet.org/
==========================================================================
2.32 (xxxx)
- Don't display trash and orphanage folders if they're empty.
- Don't let EXIF data overwrite XML-specified image titles.
- We were inadvertantly striping the time (HH:MM) off of images when
editing them.
- If we fail to copy an image to the repository, don't try to process
it further.
- Eliminate references to jpegtran as it's obselete.
- Support ExifTool for purposes of EXIF extraction.
- Site configuration is now kept in a separate file.
- Convert focal length and aperture to numeric types in the database.
- Properly detect Canon CR2 RAW files.
- Code cleanups in the RAW import code.
- Minor tweaks here and there.
- Supports dcraw v8.18+
- Bulk Update overhauled; should be much more usable now.
- Automagically detect and try to turn off magic_quotes.
- Installer rewritten. It's now web-based, and considerably nicer
and much less brittle.
2.31b (September 4, 2006)
- Fixed a bug in the installer that prevented new installations from
being able to add folders/albums without modifying the configuration
file.
2.31a (June 29, 2006)
- Fixed a bunch of bugs in exifer that were resulting in garbled parse
trees
2.31 (June 29, 2006)
- Fixed an erroneous error display when manually rotating RAW images
- Fixed a typo in admin.user.edit.php
- Stop using predictable filenames for imports and exports
- Sort files/directories, as off the disk there’s no guarantee of order
- "Folder" search is now a "Folder/Album" search, and now searches
descriptions as well as captions
- Improvements in the EXIF import, especially for Nikon-specific tags
- Cleanups and speedups for general/advanced searching
- Consistently use site_prolog() and site_epilog() to open/close database
- Fix typos in installer that prevented v2.29->v2.30 database update.
- Bulk import from filesystem
(disabled by default due to security implications)
- Bulk import now imports folder hierarchies
- Default sort order is now globally configurable
- Fix a couple of SQL errors triggered by printing when using
PostgreSQL >= 8.0
- Fix blank output when printing using the "creation date" sort order
- Allow admins to print/export from albums that they don't own
- Display the location in the tooltip (or 'Unknown')
- Admin users can directly add users
- Add 'location' to available fields when printing
- Tweaked default sharpening settings
- EXIF strings weren't being properly escaped in the database
2.30 (June 3, 2006)
**** Photo Organizer has a new maintainer, Solomon Peachy ****
- Fixed a bug where certian image orientations were mis-detected.
- Better handling of import errors.
- Allow admin users to create other admin users, and related fixes.
- Fixed search engine type not being displayed.
- Fixed a bug when viewing clients' albums.
- Remember offset into albums/folders when performing actions.
- Some HTML validation cleanups.
- Customizable, site-wide page titles.
- Suggest a default for 'copyright' and 'author' tags when adding photos.
- Ignore 'thumbs.db' file during imports.
- Upated to work with more modern dcraw releases. (tested with v8.15)
- Fixed a bug where 'orientation' and 'colorspace' would get swapped in the database on imports.
- Added an 'order added' sort order.
- Improved the now-unmaintained <i>Exifer</i> EXIF parser to properly
handle TIFF and Nikon RAW files, and include colorspace details.
- Improved keyword-based searches when quoted strings are used.
- Improved searching when numerical arguments are specified.
- Fixed bug with moving subalbums.
- Fixed album hierarchy not showing up on search results pages.
- Eliminated old, dead search code.
**** 2.29 and older were published by Balint Kis ****
2.29
- Install script platformization.
- Separate ICC Profiles for each camera.
- Sub Albums.
- Extended ImageMagic sharpening options.
- Introduced the Orphanage - to store photos that are no longer needed
but referenced in a shop transaction.
- Fixed the Shop Item Generator to allow the removal of shop items
that were referenced in a shop transaction.
- Some Shop Module bug fixes - including the Download Expiry Date date fix.
2.28
- Rating bug fixed.
- Photo version upload bug fixed.
2.27
- Watermakring bug fixed.
- ISO 64 added.
- Next-Previous navigator buttons fixed.
- Storage Location Field is fixed.
- IPTC DateCreated Field is fixed.
2.26
- The rule based shop item creator tool.
- Content Based Image Retrieval search engine interface.
- Use Photo Organizer's old EXIF parser for TIFF files; (Exifer works
only for JPEG images).
- Colorspace management; AdobeRGB and sRGB in particular, with
embedded profiles. [Solomon Peachy]
- Long description for folders and albums. [Solomon Peachy]
- Take advantage of browsers which support transparent [de]compression.
[Solomon Peachy]
- Keep track of image orientation so that thumbnail regenerations do
the right thing, and tie image rotation into this. [Solomon Peachy]
- Bufgixes and enhancements to the embedded Exifer EXIF library.
[Solomon Peachy]
- Use persistent database connections. [Solomon Peachy]
- Added photo sort order options: caption, title. [Solomon Peachy]
- Don't strip the time of day from the dates we store. [Solomon Peachy]
2.25
- Jake Olefsky's Exifier library integrated for better EXIF metadata
extraction.
- Original photo download fixed (it trucated photos larger than 2M).
2.24
- The rule based bulk update fixed - some fields were erased while
performing bulk updates.
- Photo metadata edit fixed for the Transmission Reference.
- The install script will backup the previous PHP files before installation.
2.23
- Side bar search.
- Rule based bulk update.
- Dates are entered via jscalendar.
- The XML generator is fixed.
- Removed the obsolete -g option for DCRAW.
- Updated wz_tooltip package to the latest version.
- Photos are auto-rotated in both directions.
- Photos with spaces in the original file name can be exported now.
2.22
- Allow to search for photos of a dedicated user or all users.
- Search for exact matches - excluding embedded matches.
- Search on a combination of keywords.
- Perform operations on serarch results (move, print).
- Photos are auto rotated based on the EXIF metadata.
- Folders are listed hirerarchically in every control.
- Display the photo dimensions and size in the version control tab.
2.21
- Watermarking. Works only with ImageMagick 6.0.6 or better.
- Full dcraw option support.
- Fuji RAF (RAW) file previews and thumbnails are turned 45 degrees,
you must have the fujiturn utility (part of dcraw) to enable this feature.
- Browser cache control works properly - thanks to Thomas Wenrich.
- Additional fields were added to the brochure printer.
2.20
- Sorting order of Folders and Albums are saved.
- Photo Display error traces removed - which were displayed if no user
was logged in.
- IPTC special character conversion table created.
- End of line truncation error fixed - that occured sometimes with
IPTC and XMP fields.
- Keyword list fixed - if keywords contained spaces, they were
tokenized into separate keywords.
- Fix regarding the Hide Original flag.
- The install script won't clean up the target directory - to prevent
accidental deletion of other non Photo organizer related data.
2.19
- Shop Module Extension to allow the sale of rights and prints. The
shop categories and shop items are user defineable.
- Upon purchase the high resolution master version can be downloaded
by the clients once their order was aprooved. There is a donwload
controller/monitor so that clients can download an image only the
specified times for a limited period.
- Trusted Client Feature - trusted clients can download the originals
after they submitted their orders, whithout the need to wait for
orders aprooval.
- Photos can be ordered based on their original file name.
- Default search operator changed to AND.
- Multiple NEF (RAW) file upload failed.
- Images were not displayed when the PHP was running Solaris.
- When uploading files with no dot in the file name all photos were
added as versions of the first one.
- XML Generator and Converter Bug Fixed.
- XML DTD updated.
- Company field bug fixed in the Contact Info section of the My
Settings tab.
- IPTC timestamp validation bug fixed.
- ImageMagick interface bug fixed.
2.18
- PHP-5.0.0 compatibility issues solved.
- Shared user accounts - allowing multiple users to be logged into the
same account simultaneously.
- Client Albums.
- Multiple Photo Version upload at once, allowing to create two or
more version of the same photo during upload, useful when uploading
the same photo in multiple formats.
- As a complementary feature the photo versions are also exportable.
- "Go to folder" buttons added to the photo and the folder view to
ease navigation.
- Folders in all combo boxes are displayed hierarchically.
- During a bulk upload, in the XMP parser, the keyword field accumated
all keywords assigned to already uploaded photos. This bug is fixed.
2.17
- RDF-XMP metadata import for any image file, making Photo Organizer
fully compatible with the Extensible Metadata Platform of Adobe Photoshop CS.
- Versatile selector that allows the user to specify the order in
which the IPTC, EXIF and XMP metadata is extracted. This is useful
because some fields are shared between the mentionned metadata
formats which are overwritten, and so the user can specify the
priority among metadata formats.
- MS IE rendering problems fixed in the My Settings tab, in the Folder
View and some other pages. You should be using Mozilla. :)
2.16
- Advanced Search Engine - that allows field specific queries, while
providing the usual logic operators.
- The General Search Engine has been fixed - the AND operator was not
working properly when searching on sql fields belonging to different
tables.
- The SQL code was optimized for faster display of the folder, album
and search views.
- The Inline Styles were replaced by a global CSS file that should be
specified in each theme. This way the PHP code got simpler,
furthermore theme developers have better control over the styles
used by the interface.
- EXIF Timestamp validator was dropping dates where no time was supplied.
- When displaying photos from an album view, the parent folder is
displayed only if the viewer has the rights to visit that folder.
This was a security discrepancy, as it disclosed the names of a
hidden folder.
- Calendar paging problem for December fixed.
- Original file names are now poperly imported - in the 2.15 version
when performing single photo uploads, the first character of the
original file name was truncated.
- The controls at the bottom of the folder and album view were misaligned.
2.15
- New photo related data fields were added (Author, Title, Keywords)
as a result of the improved IPTC data import. In earlier versions, we
assumed that the Author of the photos is the owner of the PO account,
however this is rarely the case. The Title field was added to
complement the existing Caption filed, and the Keyword field will
allow you to create photo categories.
- When uploading photos the software will try to determine the kind of
equipment used from the IPTC and EXIF data and will create undefined
locations all by itself. This means that you don't have to create
your shooting locations, but you still have to define your equipment
prior uploading your photos into the system.
- The big feature in this release is the photo export. You can export
original photos, or the original photos accompanied by their shooting
data, described via an XML photo description file. In this release
only the master version can be exported. After export, the system
will provide a link to tar ball, containing the photos with their
original file names and the data description file (if this option is
selected). These tarballs are not yet compressed.
2.14
- This version features a new Image Repository layout that is needed
by the next release to implement removable media support. The new
Image Repository stores each photo format (original, preview,
thumbnail) in so called sub-volumes, that can be backed-up or moved
to removable medias like DVD.
- The search engine will ignore all single letter and most two letter
keywords. The forbidden keyword set is customizable through a PHP
variable. By using quotation marks the user can force the search
engine to search on a forbidden keyword.
- Registration is completely inhibited if the New User Type is set to
Disabled in the Admin Tab.
- A shop module error is fixed. If the shop module option was disabled
for a user or client, errors appeared at the bottom of the "My Date
Book" page.
- A second shop module bug was fixed. If a photo was available in
multiple formats, one could select the photo from the folder view and
try to put it into the basket, but since no explicit format can be
specified from the folder view, this operation failed. The only way a
customer could purchase a photo was via the photo view, clicking on
the shop tab and selecting the desired format.<br>The current
implementation will allow shopping from the folder view by selecting
automatically an explicit format, while keeping the photo view
shopping features unchanged. The customer can change the format from
through his/her baskset - a feature that was not available earlier.
- Next|Previous browsing error fixed. This bug occured when a client
was browsing with the Next|Previous buttons a folder that contained
private photos. The software tried to load the private photos
therefore the client was redirected to the login.
- Technical Info Tab was unaccessible for administrators. Now the
administrator can see all details of all photos in the system.
- Yet an other installer bug fixed - the image repository path wasn't
set if no password was specified.
2.13
- User quotas. The Administrator can impose upper limits for the
number of photos and the storage space assigned to a user. By default
quotas are turned off.
- The system stores the original filenames and supplies them when
retrieving the original photos. For the thumbnail and preview,
automatically generated filenames are returned.
- Imagemagick can be replaced with JpegTRAN when rotating and flipping
images, since JpegTRAN is lossless. This feature is not enabled
because JpegTRAN is making some odd shifts with certain file sizes.
- Photo upload failure fixed when sharpening with factor 0x0.
- Lower photo navigator history fixed in the folder, album views.
- User deletion fixed (dependency on photo ratings failed the removal).
2.12
- The integration of <a href="http://www.cybercom.net/~dcoffin/">Dave
Coffin</a>'s RAW image decoder allows the preview and storage of RAW
images.
- The database error that was introduced in 2.11 is now fixed.
2.11
- Number of supported image formats extended to 107, including
multi-page formats.
- Photo Upload control improvement - user can specify the gamma
correction, compression level, color space, sharpening factors and
matting options for the thumbnail and preview generation.
- Unified file uploading.
- Owner can hide the high resolution original from the public.
- Shading fixed in the photo display.
- Equipment identifiers are displayed in the profile to help compile
XML files manually.
- Some navigation bugs fixed.
- XML bulk upload documentation added.
2.10
- Photos can be rotated and flipped
- Photo upload security leak fixed, many thanks for Thomas's
(www.reeler.org) patch.
- Bulk upload mime type addtions and fixes.
- All external utility paths are configurable.
- Photo Ratings tab fixed.
- Shaded frame in photo view is fixed.
- Selected photo version highlight fixed.
- OpenBSD document added, lot's of thanks to Matt (www.underdogma.net)
- Configuration directions added.
2.9
- IPTC support
- EXIF support - the presence of the EXIF extension is detected
therefore PO is functional with or whitout the EXIF extension.
- Active Tab is preseved in photo view while browsing photos with the
previous | next buttons
- Slide display fixed (slides were shrinked sometimes, now they are
square all the time; thumbnail was misaligned in Konqueror and in
Opera 6.x, now it's all centered)
- Bug fixed in the search engine which omitted protected photos. This
is fixed so that clients can search over protected photos of users
they registerd with.
- Second bug is fixed in the search engine that generated an error
trace at the bottom of the search page whenever a user, that wasn't
logged in, made a search.
- Some installer bugs fixed, postgresql password support added.
2.8
- Shop module
- Navigation added to the photo view
- Navigation fixed in the album viewer
- Bulk upload extended to handle .zip .bzip2 and tar files along gzip
and tgz files.
- Customizable javascript popup tips in the folder, album and search
browser for registered users.
- Folder path is displayed properly in the photo viewer
- Client settings & preferences fixed
- Adding custom label fix
- User & Client delete fix
- Installer script detects previous PO installations
2.7
- Image repository management with volume auto fill
- Photo version control
- Subfolders
2.6
- Bulk Upload with XML shooting data import
- Shooting data converters from NKN, TXT and SDF into XML
- Search engine now includes stemming
- Search results can be saved into albums
- New PS printer module which includes photos into the PS files themselves
- The brochure printer was redesigned, so photos are proprely scaled
and aligned
- Printed files are automatically opened with helper applications
(like Ghostview or Acrobat Reader) if they are installed and
configured for the browser.
- Images aren't located or linked into the HTTP server's
document_root, but in the image repository.
- Improved admin tools
- The administrator can edit and delete most data belonging to other
users (except the user's databook, profile and settings)
- Automatic login
- Comments were added to the rating system
- Exposure compensation values: +0.3, +0.5, +0.7, +1.0, where missing
from the 2 database, so they were added in 2.6
- Photo copyright tab added
- The install and configuration script can upgrade existing systems or
install new ones
2.5
- Photo albums
- Photos can be ordered order by different criterias in folders and
albums
- View the photos as a list (rather than slides) in albums and folders
- Yellow popups for basic photo information in folder and album view
- Printing in PS and PDF formats
- Databook with calendar and client management
- Submission history
- Rating system
- Access control
- Extensible help system
- Install and configuration script
1.0
- Multi user support with basic access control
- Single photo upload with albums and folders
- Equipment management
- Basic serach engine
- Help

0
doc/COPYING → COPYING
View file

31
README Normal file
View file

@ -0,0 +1,31 @@
==========================================================================
Copyright (C) 2002-2006 Balint Kis (balint@k-i-s.net)
Copyright (C) 2005-2006 Solomon Peachy (pizza@shaftnet.org)
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
==========================================================================
The documentation in the doc/ subdirectory is increasingly out-of-date.
Work is underway to rewrite the relevant bits. Photo Organizer's web
site is the most up-to-date source.
http://po.shaftnet.org/
We recommend you follow the installation instructions on the web site.
==========================================================================

458
doc/change.log.html
View file

@ -1,458 +0,0 @@
<!--
Copyright (C) 2002, 2003, 2004, 2005, 2006 Balint Kis (balint@k-i-s.net)
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
-->
<html>
<head>
<title>Photo Organizer - Change Log</title>
<link rel="shortcut icon" href="images/icon.jpg">
<link rel="stylesheet" type="text/css" media="screen" href="css/screen.css">
<link rel="stylesheet" type="text/css" media="print" href="css/screen.css">
</head>
<body background="images/background.png">
<table align="center" valign="top" cellspacing="0" cellpadding="0" border="0" width="640" height="100%">
<tr>
<td>
<table align="center" valign="top" cellpadding="0" cellspacing="0" width="100%" border="0">
<tr>
<td align="right" valign="bottom"> <img src="images/box.top.left.gif" width="8" height="8"></td>
<td align="center" valign="center" width="100%" background="images/box.top.gif" ></td>
<td align="left" valign="bottom"> <img src="images/box.top.right.gif" width="8" height="8"></td>
</tr>
<tr>
<td align="right" valign="center" width="8" background="images/box.left.gif"></td>
<td align="left" valign="center" background="images/white.pixel.png">
<table><tr><td width="5%"></td><td width="90%">
<div align="center">
<a href="http://www.k-i-s.net/sw/po"><img src="images/logo.gif" border="0"></a>
</div>
<p>&nbsp;</p>
<div align="center">
<b><font style="font-size: 14px;" color="#000000">PHOTO ORGANIZER CHANGE LOG</font></b>
</div>
<p>&nbsp;</p>
<div align="center">
<a href="index.html">Introduction</a> |
<a href="install.html">Install</a> |
<a href="uninstall.html">Uninstall</a> |
<a href="configure.html">Configure</a> |
<a href="openbsd.html">OpenBSD</a> |
<a href="migration.html">Migration</a> |
Change Log |
<a href="license.html">License</a>
</div>
<p>&nbsp;</p>
<p>
This file describes the features added in each version of
Photo Organizer.
</p>
<p>&nbsp;</p>
<p><b>PHP.2.31.A-SQL.2.31.A - 2.31</b></p>
<ol>
<li>Fixed an erroneous error display when manually rotating RAW images</li>
<li>Fixed a typo in admin.user.edit.php</li>
<li>Stop using predictable filenames for imports and exports</li>
<li>Sort files/directories, as off the disk there&rsquo;s no guarantee of order</li>
<li>&ldquo;Folder&rdquo; search is now a &ldquo;Folder/Album&rdquo; search, and now searches descriptions as well as captions</li>
<li>Improvements in the EXIF import, especially for Nikon-specific tags</li>
<li>Cleanups and speedups for general/advanced searching</li>
<li>Consistently use site_prolog() and site_epilog() to open/close database</li>
<li>Fix typos in installer that prevented v2.29&rarr;v2.30 database update.</li>
<li>Bulk import from filesystem <em>(disabled by default due to security implications)</em></li>
<li>Bulk import now imports folder hierarchies</li>
<li>Default sort order is now globally configurable</li>
<li>Fix a couple of SQL errors triggered by printing when using PostgreSQL &gt;= 8.0</li>
<li>Fix blank output when printing using the "creation date" sort order</li>
<li>Allow admins to print/export from albums that they don't own</li>
<li>Display the location in the tooltip (or 'Unknown')</li>
<li>Admin users can directly add users</li>
<li>Add 'location' to available fields when printing</li>
<li>Tweaked default sharpening settings</li>
<li>EXIF strings weren't being properly escaped in the database</li>
<li>Fixed a bunch of bugs in exifer that were resulting in garbled parse trees</li>
<li>Fixed a bug in the installer that left out the $default_order_by parameter</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.30.B-SQL.2.30.B - 2.30</b></p>
<ol>
<li>Fixed a bug where certian image orientations were mis-detected.</li>
<li>Better handling of import errors.</li>
<li>Allow admin users to create other admin users, and related fixes.</li>
<li>Fixed search engine type not being displayed.</li>
<li>Fixed a bug when viewing clients' albums.</li>
<li>Remember offset into albums/folders when performing actions.</li>
<li>Some HTML validation cleanups.</li>
<li>Customizable, site-wide page titles.</li>
<li>Suggest a default for 'copyright' and 'author' tags when adding photos.</li>
<li>Ignore 'thumbs.db' file during imports.</li>
<li>Upated to work with more modern dcraw releases. (tested with v8.15)</li>
<li>Fixed a bug where 'orientation' and 'colorspace' would get swapped in the database on imports.</li>
<li>Added an 'order added' sort order.</li>
<li>Improved the now-unmaintained <i>Exifer</i> EXIF parser to properly
handle TIFF and Nikon RAW files, and include colorspace details.</li>
<li>Improved keyword-based searches when quoted strings are used.</li>
<li>Improved searching when numerical arguments are specified.</li>
<li>Fixed bug with moving subalbums.</li>
<li>Fixed album hierarchy not showing up on search results pages.</li>
<li>Eliminated old, dead search code.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.29.B-SQL.2.29.B - 2.29</b></p>
<ol>
<li>Install script platformization.</li>
<li>Separate ICC Profiles for each camera.</li>
<li>Sub Albums.</li>
<li>Extended ImageMagic sharpening options.</li>
<li>Introduced the Orphanage - to store photos that are no longer needed but referenced in a shop transaction.</li>
<li>Fixed the Shop Item Generator to allow the removal of shop items that were referenced in a shop transaction.</li>
<li>Some Shop Module bug fixes - including the Download Expiry Date date fix.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.28.C-SQL.2.28.C - 2.28</b></p>
<ol>
<li>Rating bug fixed.</li>
<li>Photo version upload bug fixed.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.27.B-SQL.2.27.B - 2.27</b></p>
<ol>
<li>Watermakring bug fixed.</li>
<li>ISO 64 added.</li>
<li>Next-Previous navigator buttons fixed.</li>
<li>Storage Location Field is fixed.</li>
<li>IPTC DateCreated Field is fixed.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.26.B-SQL.2.26.B - 2.26</b></p>
<ol>
<li>The rule based shop item creator tool.</li>
<li>Content Based Image Retrieval search engine interface.</li>
<li>Use Photo Organizer's old EXIF parser for TIFF files; (the <a href="http://www.jakeo.com/software/exif/index.php">exifer</a> works only for JPEG images).</li>
<li>Colorspace management; AdobeRGB and sRGB in particular, with embedded profiles. [<a href="http://www.shaftnet.org/~pizza/">Solomon</a>]</li>
<li><i>Long description</i> for folders and albums. [<a href="http://www.shaftnet.org/~pizza/">Solomon</a>]</li>
<li>Take advantage of browsers which support transparent [de]compression. [<a href="http://www.shaftnet.org/~pizza/">Solomon</a>]</li>
<li>Keep track of image orientation so that thumbnail regenerations do the right thing, and tie image rotation into this. [<a href="http://www.shaftnet.org/~pizza/">Solomon</a>]</li>
<li>Bufgixes and enhancements to the embedded <a href="http://www.jakeo.com/software/exif/index.php">exifer</a> EXIF library. [<a href="http://www.shaftnet.org/~pizza/">Solomon</a>]</li>
<li>Use persistent database connections. [<a href="http://www.shaftnet.org/~pizza/">Solomon</a>]</li>
<li>Added photo sort order options: caption, title. [<a href="http://www.shaftnet.org/~pizza/">Solomon</a>]</li>
<li>Don not strip the time of day from the dates we store. [<a href="http://www.shaftnet.org/~pizza/">Solomon</a>]</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.25.C-SQL.2.25.C - 2.25</b></p>
<ol>
<li>Jake Olefsky's Exifier library integrated for better EXIF metadata extraction.</li>
<li>Original photo download fixed (it trucated photos larger than 2M).</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.24.C-SQL.2.24.C - 2.24</b></p>
<ol>
<li>The rule based bulk update fixed - some fields were erased while performing bulk updates.</li>
<li>Photo metadata edit fixed for the Transmission Reference.</li>
<li>The install script will backup the previous PHP files before installation.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.23.C-SQL.2.23.C - 2.23</b></p>
<ol>
<li>Side bar search.</li>
<li>Rule based bulk update.</li>
<li>Dates are entered via <a href="http://www.dynarch.com/projects/calendar/">Java Script Calendar</a>.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=194">Bug 194</a> fixed. The XML generator is fixed.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=193">Bug 193</a> fixed. Removed the obsolete -g option for DCRAW.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=192">Bug 192</a> fixed. Updated wz_tooltip package to the latest version.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=184">Bug 184</a> fixed. Photos are auto-rotated in both directions.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=183">Bug 183</a> fixed. Photos with spaces in the original file name can be exported now.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.22.C-SQL.2.22.C - 2.22</b></p>
<ol>
<li>Allow to search for photos of a dedicated user or all users.</li>
<li>Search for exact matches - excluding embedded matches.</li>
<li>Search on a combination of keywords.</li>
<li>Perform operations on serarch results (move, print).</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=172">Wanted feature 172</a> implemented. Photos are auto rotated based on the EXIF metadata.</li>
<li>Folders are listed hirerarchically in every control.</li>
<li>Display the photo dimensions and size in the version control tab.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.21.C-SQL.2.21.C - 2.21</b></p>
<ol>
<li>Watermarking. Works only with ImageMagick 6.0.6 or better.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=163">Wanted feature 163</a> implemented. Full dcraw option support.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=167">BUG 167</a> fixed. Fuji RAF (RAW) file previews and thumbnails are turned 45 degrees, you must have the fujiturn utility (part of dcraw) to enable this feature.</li>
<li>Browser cache control works properly - thanks to Thomas Wenrich.</li>
<li>Additional fields were added to the brochure printer.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.20.C-SQL.2.20.C - 2.20</b></p>
<ol>
<li>Sorting order of Folders and Albums are saved.</li>
<li>Photo Display error traces removed - which were displayed if no user was logged in.</li>
<li>IPTC special character conversion table created.</li>
<li>End of line truncation error fixed - that occured sometimes with IPTC and XMP fields.</li>
<li>Keyword list fixed - if keywords contained spaces, they were tokenized into separate keywords.</li>
<li>Fix regarding the Hide Original flag.</li>
<li>The install script won't clean up the target directory - to prevent accidental deletion of other non Photo organizer related data.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.19.C-SQL.2.19.C - 2.19</b></p>
<ol>
<li>Shop Module Extension to allow the sale of rights and prints. The shop categories and shop items are user defineable.</li>
<li>Upon purchase the high resolution master version can be downloaded by the clients once their order was aprooved. There is a donwload controller/monitor so that clients can download an image only the specified times for a limited period.</li>
<li>Trusted Client Feature - trusted clients can download the originals after they submitted their orders, whithout the need to wait for orders aprooval.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=131">Wanted feature 131</a> implemented. Photos can be ordered based on their original file name.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=133">Change 133</a> implemented. Default search operator changed to AND.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=136">Bug 136</a> fixed. Multiple NEF (RAW) file upload failed.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=134">Bug 134</a> fixed. Images were not displayed when the PHP was running Solaris.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=127">Bug 127</a> fixed. When uploading files with no dot in the file name all photos were added as versions of the first one.</li>
<li>XML Generator and Converter Bug Fixed.</li>
<li>XML DTD updated.</li>
<li>Company field bug fixed in the Contact Info section of the My Settings tab.</li>
<li>IPTC timestamp validation bug fixed.</li>
<li>ImageMagick interface bug fixed.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.18.C-SQL.2.18.C - 2.18</b></p>
<ol>
<li>PHP-5.0.0 compatibility issues solved.</li>
<li>Shared user accounts - allowing multiple users to be logged into the same account simultaneously.</li>
<li>Client Albums.</li>
<li>Multiple Photo Version upload at once, allowing to create two or more version of the same photo during upload, useful when uploading the same photo in multiple formats.</li>
<li>As a complementary feature the photo versions are also exportable.</li>
<li>"Go to folder" buttons added to the photo and the folder view to ease navigation.</li>
<li>Folders in all combo boxes are displayed hierarchically.</li>
<li>During a bulk upload, in the XMP parser, the keyword field accumated all keywords assigned to already uploaded photos. This bug is fixed.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.17.C-SQL.2.17.C - 2.17</b></p>
<ol>
<li>RDF-XMP metadata import for any image file, making Photo Organizer fully compatible with the Extensible Metadata Platform of Adobe Photoshop CS.</li>
<li>Versatile selector that allows the user to specify the order in which the IPTC, EXIF and XMP metadata is extracted. This is useful because some fields are shared between the mentionned metadata formats which are overwritten, and so the user can specify the priority among metadata formats.</li>
<li>MS IE rendering problems fixed in the My Settings tab, in the Folder View and some other pages. You should be using <a href="http://www.mozilla.org">Mozilla</a>.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.16.C-SQL.2.16.C - 2.16</b></p>
<ol>
<li>Advanced Search Engine - that allows field specific queries, while providing the usual logic operators.</li>
<li>The General Search Engine has been fixed - the AND operator was not working properly when searching on sql fields belonging to different tables.</li>
<li>The SQL code was optimized for faster display of the folder, album and search views.</li>
<li>The Inline Styles were replaced by a global CSS file that should be specified in each theme. This way the PHP code got simpler, furthermore theme developers have better control over the styles used by the interface.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=104">Bug 104</a> fixed. EXIF Timestamp validator was dropping dates where no time was supplied.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=101">Bug 101</a> fixed. When displaying photos from an album view, the parent folder is displayed only if the viewer has the rights to visit that folder. This was a security discrepancy, as it disclosed the names of a hidden folder.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=100">Bug 100</a> fixed. Calendar paging problem for December fixed.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=99">Bug 99</a> fixed. Original file names are now poperly imported - in the 2.15 version when performing single photo uploads, the first character of the original file name was truncated.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=95">Bug 95</a> fixed. The controls at the bottom of the folder and album view were misaligned.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.15.C-SQL.2.15.C - 2.15</b></p>
<ol>
<li>New photo related data fields were added (Author, Title, Keywords) as a result of the improved IPTC data import. In earlier versions, we assumed that the Author of the photos is the owner of the PO account, however this is rarely the case. The Title field was added to complement the existing Caption filed, and the Keyword field will allow you to create photo categories.</li>
<li>When uploading photos the software will try to determine the kind of equipment used from the IPTC and EXIF data and will create undefined locations all by itself. This means that you don't have to create your shooting locations, but you still have to define your equipment prior uploading your photos into the system.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=82">Feature 82</a> completed. The big feature in this release is the photo export. You can export original photos, or the original photos accompanied by their shooting data, described via an XML photo description file. In this release only the master version can be exported. After export, the system will provide a link to tar ball, containing the photos with their original file names and the data description file (if this option is selected). These tarballs are not yet compressed.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.14.C-SQL.2.14.C - 2.14</b></p>
<ol>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=43">Feature 43</a> completed. This version features a new Image Repository layout that is needed by the next release to implement removable media support. The new Image Repository stores each photo format (original, preview, thumbnail) in so called sub-volumes, that can be backed-up or moved to removable medias like DVD.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=81">Bug 81</a> fixed. The search engine will ignore all single letter and most two letter keywords. The forbidden keyword set is customizable through a PHP variable. By using quotation marks the user can force the search engine to search on a forbidden keyword.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=82">Feature 82</a> completed. Registration is completely inhibited if the New User Type is set to Disabled in the Admin Tab.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=75">Bug 75</a> fixed. A shop module error is fixed. If the shop module option was disabled for a user or client, errors appeared at the bottom of the "My Date Book" page.</li>
<li>A second shop module bug was fixed. If a photo was available in multiple formats, one could select the photo from the folder view and try to put it into the basket, but since no explicit format can be specified from the folder view, this operation failed. The only way a customer could purchase a photo was via the photo view, clicking on the shop tab and selecting the desired format.<br>The current implementation will allow shopping from the folder view by selecting automatically an explicit format, while keeping the photo view shopping features unchanged. The customer can change the format from through his/her baskset - a feature that was not available earlier.</li>
<li>Next|Previous browsing error fixed. This bug occured when a client was browsing with the Next|Previous buttons a folder that contained private photos. The software tried to load the private photos therefore the client was redirected to the login.</li>
<li>Technical Info Tab was unaccessible for administrators. Now the administrator can see all details of all photos in the system.</li>
<li>Yet an other installer bug fixed - the image repository path wasn't set if no password was specified.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.13.C-SQL.2.13.C - 2.13</b></p>
<ol>
<li>User quotas. The Administrator can impose upper limits for the number of photos and the storage space assigned to a user. By default quotas are turned off.</li>
<li>The system stores the original filenames and supplies them when retrieving the original photos. For the thumbnail and preview, automatically generated filenames are returned.</li>
<li>Imagemagick can be replaced with JpegTRAN when rotating and flipping images, since JpegTRAN is lossless. This feature is not enabled because JpegTRAN is making some odd shifts with certain file sizes.</li>
<li>Photo upload failure fixed when sharpening with factor 0x0.</li>
<li>Lower photo navigator history fixed in the folder, album views.</li>
<li>User deletion fixed (dependency on photo ratings failed the removal).</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.12.C-SQL.2.12.C - 2.12</b></p>
<ol>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=37">Feature 37</a> completed. The integration of <a href="http://www.cybercom.net/~dcoffin/">Dave Coffin</a>'s RAW image decoder allows the preview and storage of RAW images.</li>
<li>The database error that was introduced in 2.11 is now fixed.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.11.C-SQL.2.11.C - 2.11</b></p>
<ol>
<li>Number of supported image formats extended to 107, including multi-page formats.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=32">Feature 32</a> completed. Photo Upload control improvement - user can specify the gamma correction, compression level, color space, sharpening factors and matting options for the thumbnail and preview generation.</li>
<li>Unified file uploading.</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=31">Feature 31</a> completed. Owner can hide the high resolution original from the public.</li>
<li>Shading fixed in the photo display.</li>
<li>Equipment identifiers are displayed in the profile to help compile XML files manually.</li>
<li>Some navigation bugs fixed.</li>
<li>XML bulk upload documentation added.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.10.C-SQL.2.10.C - 2.10</b></p>
<ol>
<li>Photos can be rotated and flipped</li>
<li>Photo upload security leak fixed, many thanks for <a href="http://www.reeler.org">Thomas</a>' patch.</li>
<li>Bulk upload mime type addtions and fixes.</li>
<li>All external utility paths are configurable.</li>
<li>Photo Ratings tab fixed.</li>
<li>Shaded frame in photo view is fixed.</li>
<li>Selected photo version highlight fixed.</li>
<li>OpenBSD document added, lot's of thanks to <a href="http://www.underdogma.net">Matt</a>.</li>
<li>Configuration directions added.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.9.C-SQL.2.9.C - 2.9</b></p>
<ol>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=20">Feature 20</a> completed. IPTC support</li>
<li>EXIF support - the presence of the EXIF extension is detected therefore PO is functional with or whitout the EXIF extension.</li>
<li>Active Tab is preseved in photo view while browsing photos with the previous | next buttons</li>
<li>slide display fixed (slides were shrinked sometimes, now they are square all the time; thumbnail was misaligned in Konqueror and in Opera 6.x, now it's all centered)</li>
<li><a href="http://www.k-i-s.net/bboard.thread.php?thread=25">Bug 25</a> fixed. Bug fixed in the search engine which omitted protected photos. This is fixed so that clients can search over protected photos of users they registerd with.</li>
<li>Second bug is fixed in the search engine that generated an error trace at the bottom of the search page whenever a user, that wasn't logged in, made a search.</li>
<li>Some installer bugs fixed, postgresql password support added.</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.8.C-SQL.2.8.C - 2.8</b></p>
<ol>
<li>Shop module</li>
<li>Navigation added to the photo view</li>
<li>Navigation fixed in the album viewer</li>
<li>Bulk upload extended to handle .zip .bzip2 and tar files along gzip and tgz files.</li>
<li>Customizable javascript popup tips in the folder, album and search browser for registered users.</li>
<li>Folder path is displayed properly in the photo viewer</li>
<li>Client settings & preferences fixed</li>
<li>Adding custom label fix</li>
<li>User & Client delete fix</li>
<li>Installer script detects previous PO installations</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.7.C-SQL.2.7.C - 2.7</b></p>
<ol>
<li>Image repository management with volume auto fill</li>
<li>Photo version control</li>
<li>Subfolders</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.6.C-SQL.2.6.C - 2.6</b></p>
<ol>
<li>Bulk Upload with XML shooting data import</li>
<li>Shooting data converters from NKN, TXT and SDF into XML</li>
<li>Search engine now includes stemming</li>
<li>Search results can be saved into albums</li>
<li>New PS printer module which includes photos into the PS files themselves</li>
<li>The brochure printer was redesigned, so photos are proprely scaled and aligned</li>
<li>Printed files are automatically opened with helper applications (like Ghostview or Acrobat Reader) if they are installed and configured for the browser.</li>
<li>Images aren't located or linked into the HTTP server's document_root, but in the image repository.</li>
<li>Improved admin tools</li>
<li>The administrator can edit and delete most data belonging to other users (except the user's databook, profile and settings)</li>
<li>Automatic login</li>
<li>Comments were added to the rating system</li>
<li>Exposure compensation values: +0.3, +0.5, +0.7, +1.0, where missing from the 2 database, so they were added in 2.6</li>
<li>Photo copyright tab added</li>
<li>The install and configuration script can upgrade existing systems or install new ones</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.2.5.C-SQL.2.5.C - 2.00</b></p>
<ol>
<li>Photo albums</li>
<li>Photos can be ordered order by different criterias in folders and albums</li>
<li>View the photos as a list (rather than slides) in albums and folders</li>
<li>Yellow popups for basic photo information in folder and album view</li>
<li>Printing in PS and PDF formats</li>
<li>Databook with calendar and client management</li>
<li>Submission history</li>
<li>Rating system</li>
<li>Access control</li>
<li>Extensible help system</li>
<li>Install and configuration script</li>
</ol>
<p>&nbsp;</p>
<p><b>PHP.1.0.C-SQL.1.0.C - 1.00</b></p>
<ol>
<li>Multi user support with basic access control</li>
<li>Single photo upload with albums and folders</li>
<li>Equipment management</li>
<li>Basic serach engine</li>
<li>Help</li>
</ol>
<div align="center">
Comments and corrections are welcome at <a href="mailto:balint@k-i-s.net">balint@k-i-s.net</a>.
</div>
</td><td width="5%"></td></tr></table>
</td>
<td align="left" valign="center" width="8" background="images/box.right.gif"></td>
</tr>
<tr>
<td align="right" valign="top"> <img src="images/box.bottom.left.gif" width="8" height="8"></td>
<td align="center" valign="top" width="100%"><img src="images/box.bottom.gif" width="100%" height="8"></td>
<td align="left" valign="top"> <img src="images/box.bottom.right.gif" width="8" height="8"></td>
</tr>
</table>
</td>
</tr>
</table>
<p>&nbsp;</p>
</body></html>

24
doc/configure.html
View file

@ -61,7 +61,6 @@
Configure |
<a href="openbsd.html">OpenBSD</a> |
<a href="migration.html">Migration</a> |
<a href="change.log.html">Change Log</a> |
<a href="license.html">License</a>
</div>
</p>
@ -252,29 +251,6 @@ $sys_convert&nbsp;=&nbsp;"/usr/bin/convert";
</p><p>
</li>
<li><b>JPEGTRAN</b> - This utility program is used to rotate
and flip images because it works by rearranging the compressed
data (DCT coefficients), without ever fully decoding the image,
therefore, its transformations are lossless. If you leave this
directive unset ImageMagick will be used instead.
</p><p>
There is a good reason to leave this directive unset.
Unfortunately JpegTRAN cannot transform images
perfectly. As a workaround I tried to generate images of
dimensions multiple of 16 and 8, but the result was always the same.
The image was shifted in one or both directions and the overflow appeared on
the other side of the image. If you have a newer version
of JpegTRAN, that fixes this issue you should use it
instead of ImageMagick.
</p><p>
<table width="100%" bgcolor="#ff9f63" cellspacing="1" cellpadding="3" border="0">
<tbody><tr><td style="font-size: 12px;" bgcolor="#ffe9c8"><code>
$sys_jpegtran&nbsp;=&nbsp;"/usr/bin/jpegtran";<br>
$sys_jpegtran&nbsp;=&nbsp;""; // if you want to use ImageMagick instead
</code></td></tr></tbody></table>
</p><p>
</li>
<li><b>DCRAW</b> - This utility program is used to convert RAW image files (produced
by digital cameras) into temporary PPM files that are scaled afterwards with ImageMagick
to produce a thumbnail and a preview. This is new software so you will have to compile

12
doc/index.html
View file

@ -62,7 +62,6 @@ Introduction |
<a href="configure.html">Configure</a> |
<a href="openbsd.html">OpenBSD</a> |
<a href="migration.html">Migration</a> |
<a href="change.log.html">Change Log</a> |
<a href="license.html">License</a>
</div>
</div>
@ -78,19 +77,18 @@ requirements and briefly presents the installation process.
</p><p>
Mandatory requirements (PO might work with older software versions than specified inhere):
<ol>
<li>An <a href="http://httpd.apache.org">Apache 2.0.40 HTTP</a> server with <a href="http://www.php.net">PHP 5.0.0</a> compiled with support for PGSQL, SOCKETS and EXIF.</li>
<li>A <a href="http://www.postgresql.org">PostgreSQL 7.4.1</a> database server that accepts TCP/IP connections even if the database
<li>An <a href="http://httpd.apache.org">Apache 2.0.40+ HTTP</a> server with <a href="http://www.php.net">PHP 4.3.10+</a> compiled with support for PGSQL, BCMATH,, and SOCKETS.</li>
<li>A <a href="http://www.postgresql.org">PostgreSQL 7.4.1+</a> database server that accepts TCP/IP connections even if the database
server and the HTTP server are located on the same computer.</li>
<li><a href="http://www.imagemagick.org">ImageMagick 5.4.7</a></li>
<li><a href="http://www.imagemagick.org">ImageMagick 5.4.7+</a></li>
</ol>
Optional requirements:
<ol>
<li>If PHP is comipled with EXIF support PO will support EXIF extensions.</li>
<li>If <i>ExifTool</i> is installed, PO will use it for EXIF extraction.</li>
<li>An mail transfer agent is needed and PHP must be configured to use this mail transfer agent if you wish to use e-mail notifications.</li>
<li>If <code>gtar</code> and <code>unzip</code> is available PO will support bulk upload.</li>
<li>If <code>tar</code> and/or <code>unzip</code> is available PO will support bulk upload.</li>
<li><a href="http://www.ps2pdf.org">ps2pdf</a> must be installed in order to enable printing in PDF format.</li>
<li><a href="http://www.cybercom.net/~dcoffin/dcraw/">dcraw</a> must be installed in order to support raw image formats.</li>
<li>JpegTRAN - is used to rotate and flip images. If not specified ImageMagick is used instead.</li>
</ol>
Additionally, to complete the installation you will also have to:
<ol>

211
doc/install.html
View file

@ -50,7 +50,7 @@
<p>&nbsp;</p>
<p>
<div align="center">
<b><font style="font-size: 14px;" color="#000000">INSTALLATION INSTRUCTIONS FOR NERDS</font></b>
<b><font style="font-size: 14px;" color="#000000">INSTALLATION INSTRUCTIONS</font></b>
</div>
</p>
<p>&nbsp;</p><p>
@ -61,7 +61,6 @@ Install |
<a href="configure.html">Configure</a> |
<a href="openbsd.html">OpenBSD</a> |
<a href="migration.html">Migration</a> |
<a href="change.log.html">Change Log</a> |
<a href="license.html">License</a>
</div>
</p>
@ -72,35 +71,35 @@ First, read the <a href=index.html>Introduction</a>, that contains
some important information I don't want to repeat once
more.
</p><p>
If you don't want to run the install script, there is an
easy way to install the software manually. You have to
complete two tasks:
There are three basic tasks necessary to install Photo Organizer:
<ol>
<li><a href="#install">Install the new PO version.</a></li>
<li><a href="#repository">Create or migrate the image repository.</a></li>
<li><a href="#database">Prepare the database.</a></li>
<li><a href="#install">Install the PO source files.</a></li>
<li><a href="#repository">Create the image repository.</a></li>
<li><a href="#webinstall">Run the web install tool.</a></li>
</ol>
</p><p><a name="install">&nbsp;</a></p><p>
<b><font style="font-size: 14px;" color="#000000">Install or Upgrade Photo Organizer</font></b>
</p><p><a name="database">&nbsp;</a></p><p>
<b><font style="font-size: 14px;" color="#000000">New Installations -- Database Preparation</font></b>
</p>
Follow these step by step instructions to install or upgrade the software:
<ol>
<li>
Create a postgresql user and postgresql database. You will need to have access
to a postgresql user account that is allowed to create new users.
to a postgresql user account that is allowed to create new users.
In case you are upgrading skip this step and use the exisiting
database and database user. We will refer to the database as <i>po_database</i> and to
the database user as <i>po_user</i> in the future.</li>
<p>
<table width="100%" bgcolor="#ff9f63" cellspacing="1" cellpadding="3" border="0">
<tbody><tr><td style="font-size: 12px;" bgcolor="#ffe9c8"><code>
[balint@apollo ~]$ createuser -U pg_superuser po_user<br>
Shall the new user be allowed to create databases? (y/n) y<br>
Shall the new user be allowed to create more new users? (y/n) n<br>
[balint@apollo ~]$ createuser -A -D -U pg_superuser po_user<br>
CREATE USER<br>
[balint@apollo ~]$ createdb -U po_user po_database<br>
[balint@apollo ~]$ createdb -U po_superuser -O po_user po_database<br>
CREATE DATABASE<br>
</code></td></tr></tbody></table>
</p>
</li>
@ -115,137 +114,59 @@ newly created database.</li>
</p>
</li>
</ol>
<b><font style="font-size: 14px;" color="#000000">New Installation or Upgrades</font></b>
<a name="install"> </a>
<br/>
<ol>
<li>
Untar the distribution po.2.18.tar.gz. Change directory
into po.2.18 (the directory created upon untar). Actually if you can
read this file you already completed this step. Anyway, all
Untar the distribution file (eg po.2.32.tar.bz2). Change directory
into the directory it creates (eg po 2.32). (If you can
read this file you already completed this step) All
directories in this document are relative to this one,
except when indicated otherwise.
<p>
<table width="100%" bgcolor="#ff9f63" cellspacing="1" cellpadding="3" border="0">
<tbody><tr><td style="font-size: 12px;" bgcolor="#ffe9c8"><code>
[balint@apollo ~]$ tar xvzf po.2.18.tar.gz<br>
[balint@apollo ~]$ cd po.2.18<br>
[balint@apollo po.2.18]$ ls<br>
doc install mkconfig src<br>
[balint@apollo ~]$ tar xvzf po.2.32.tar.gz<br>
[balint@apollo ~]$ cd po.2.32<br>
[balint@apollo po.2.32]$ ls<br>
COPYING doc src<br>
</code></td></tr></tbody></table>
</p>
</li>
<li>
Go into the src/sql directory where you will find the sql files:
<p>
<table width="100%" bgcolor="#ff9f63" cellspacing="1" cellpadding="3" border="0">
<tbody><tr><td style="font-size: 12px;" bgcolor="#ffe9c8"><code>
[balint@apollo po.2.18]$ cd src/sql<br>
[balint@apollo sql]$ ls<br>
photo.organizer.data.2.5.C.sql <br>
photo.organizer.db.2.5.C.sql<br>
...<br>
photo.organizer.data.2.17.C.patch.2.18.C.sql<br>
photo.organizer.db.2.17.C.patch.2.18.C.sql<br>
</code></td></tr></tbody></table>
</p>
</li>
<li>
Log into the po_database as po_user.
<p>
<table width="100%" bgcolor="#ff9f63" cellspacing="1" cellpadding="3" border="0">
<tbody><tr><td style="font-size: 12px;" bgcolor="#ffe9c8"><code>
[balint@apollo sql]$ psql -U po_user po_database<br>
Welcome to psql 7.3.2, the PostgreSQL interactive terminal.<br>
photo=#<br>
</code></td></tr></tbody></table>
</p>
<ol>
<li type="a">If your database is not older than 2.5 you can
upgrade it by applying the apropriate patch files.
Say you have a 2.15 database, you can upgrade it to
2.18 by applying the following files (order
does matter):
<p>
<table width="100%" bgcolor="#ff9f63" cellspacing="1" cellpadding="3" border="0">
<tbody><tr><td style="font-size: 12px;" bgcolor="#ffe9c8"><code>
photo=# begin;<br>
BEGIN<br>
photo=# \i photo.organizer.db.2.15.C.patch.2.16.C.sql<br>
photo=# \i photo.organizer.data.2.15.C.patch.2.16.C.sql<br>
photo=# \i photo.organizer.db.2.17.C.patch.2.18.C.sql<br>
photo=# \i photo.organizer.data.2.17.C.patch.2.18.C.sql<br>
photo=# commit;<br>
COMMIT<br>
photo=# \q<br>
[balint@apollo sql]$ <br>
</code></td></tr></tbody></table>
</p>
Just like in this example, make sure to start a transaction
before loading the files - should anything go wrong you have a
chance to restore the database with a <i>rollback</i> command
<p></p>
</li>
<li type="a">If you have just created an empty database, load
the files in the following order (order does
matter):
<p>
<table width="100%" bgcolor="#ff9f63" cellspacing="1" cellpadding="3" border="0">
<tbody><tr><td style="font-size: 12px;" bgcolor="#ffe9c8"><code>
photo=# \i photo.organizer.db.2.5.C.sql<br>
photo=# \i photo.organizer.data.2.5.C.sql<br>
photo=# \i photo.organizer.db.2.5.C.patch.2.6.C.sql<br>
photo=# \i photo.organizer.data.2.5.C.patch.2.6.C.sql<br>
...<br>
photo=# \i photo.organizer.db.2.17.C.patch.2.18.C.sql<br>
photo=# \i photo.organizer.data.2.17.C.patch.2.18.C.sql<br>
photo=# \q<br>
[balint@apollo sql]$ <br>
</code></td></tr></tbody></table>
</p>
</li>
</ol>
</li>
<p>
<li>
Go to the <i>src</i> directory where you will find
the php files. If you are upgrading merge your exisiting
configuration file into <i>src/include/config.php</i>.
</p><p>
If you are installing a new system the <i>src/include/config.php</i>
file and fill in the database connection information.
You have to change the the <i>$image_repository_path</i> variable
to point to your image repository. By default the system uses
the <i>/tmp</i> directory to store temporary files. You can specify
a different directory by overloading the <i>$tmp_volume_path</i> variable.
</li>
</p>
<ol>
<li type="a">
If you have a previous PO installation, remove the old php files.
<p>
<table width="100%" bgcolor="#ff9f63" cellspacing="1" cellpadding="3" border="0">
<tbody><tr><td style="font-size: 12px;" bgcolor="#ffe9c8"><code>
[balint@apollo sql]$ cd ..<br>
[balint@apollo src]$ rm -rf /var/www/html/po/*<br>
</code></td></tr></tbody></table>
</p>
</li>
<li type="a">
Copy the whole <i>src</i> subtree into a location of your choice whitin the HTTP
server's document_root directory, or into the location of the old php files.
<p>
In the <i>src</i> directory, you will find the php files. You must copy these
over to a place accessible by your web server.
</p>
<p>
Copy the whole <i>src</i> subtree into a location of your choice within the HTTP
server's document_root directory, or into the location of the old php files. You may need root permissions to do this.
</p>
<p>
<table width="100%" bgcolor="#ff9f63" cellspacing="1" cellpadding="3" border="0">
<tbody><tr><td style="font-size: 12px;" bgcolor="#ffe9c8"><code>
[balint@apollo po.2.32]$ cd src<br>
[balint@apollo src]$ cp -R * /var/www/html/po<br>
</code></td></tr></tbody></table>
</p>
</li>
</ol>
<li><p>If this is a new installation (or you are upgrading from PO 2.31a or older) you will need to back up and copy over your site-specific configuration.
</p>
<p>
<table width="100%" bgcolor="#ff9f63" cellspacing="1" cellpadding="3" border="0">
<tbody><tr><td style="font-size: 12px;" bgcolor="#ffe9c8"><code>
[balint@apollo src]$ cp include/config_site.php.dist /var/www/html/po/include/config_site.php<br>
</code></td></tr></tbody></table>
</p>
<p>Edit the newly-copied <i>/var/www/html/po/include/config_site.php</i> file and ensure that all settings are correct. This file is not overwritten by upgrades, so you should only have to do this once.</p>
</li>
<li>
@ -284,23 +205,8 @@ directory as your image repository
</p>
</li>
<li>
Create a volume (preferably v0000) in this directory. Afterward create
sub-volumes - they must be named as 00000, 00001, and 00002.
If you already have a 2.13 system read the <a href="migration.html">Migration</a>
section for more details.
<p>
<table width="100%" bgcolor="#ff9f63" cellspacing="1" cellpadding="3" border="0">
<tbody><tr><td style="font-size: 12px;" bgcolor="#ffe9c8"><code>
[root@apollo export]$ mkdir my.repository/v0000<br>
[root@apollo export]$ mkdir my.repository/v0000/00000<br>
[root@apollo export]$ mkdir my.repository/v0000/00001<br>
[root@apollo export]$ mkdir my.repository/v0000/00002<br>
</code></td></tr></tbody></table>
</p>
</li>
<li>
Check for the <i>include/config.php</i> file in your
PO installation directory, and edit the variables
Check for the <i>include/config_site.php</i> file in your
PO installation directory, and edit the variable
<i>$image_repository_path</i> to point to your image
repository, than in the Photo Organizer administrator
interface, select the current volume.
@ -318,18 +224,21 @@ the user can read and write the repository.
</code></td></tr></tbody></table>
</p>
</li>
<li>
Finally, log into Photo Organizer's administrator account and visit the Admin tab.
In the Image Repository section you should see your first volume v0000, which
you have to set as the current volume. If the Image Repository view displays
no volumes that means that the <i>$image_repository_path</i> was not
set up properly.
</ol>
</p><p><a name="webinstall">&nbsp;</a></p><p>
<b><font style="font-size: 14px;" color="#000000">Run the web installer</font></b>
</p>
<ol>
<li type="1">Now that the database is created, visit <i>http://yourserver/path_to_po/install.php</i>. This script will perform any necessary database upgrades and sanity-check the installation. Please follow any instructions it gives.
</li>
<li>Once the installer is finished, it will tell you to erase <i>install.php</i>. We highly recommend you do this to help keep your installation secure.
</li>
</ol>
</p><p>
<div align="center">
Comments and corrections are welcome at <a href="mailto:balint@k-i-s.net">balint@k-i-s.net</a>.
Comments and corrections are welcome at <a href="mailto:po-devel@shaftnet.org">po-devel@shaftnet.org</a>.
</div>
</p>

1
doc/license.html
View file

@ -63,7 +63,6 @@
<a href="configure.html">Configure</a> |
<a href="openbsd.html">OpenBSD</a> |
<a href="migration.html">Migration</a> |
<a href="change.log.html">Change Log</a> |
License
</div>
</p><p>&nbsp;</p><p>

3
doc/migration.html
View file

@ -59,9 +59,8 @@
<a href="install.html">Install</a> |
<a href="uninstall.html">Uninstall</a> |
<a href="configure.html">Configure</a> |
<a href="openbsd.html">OpenBSD</a> |
Migration |
<a href="change.log.html">Change Log</a> |
<a href="openbsd.html">OpenBSD</a>
<a href="license.html">License</a>
</div>
</p>

1
doc/test.html
View file

@ -63,7 +63,6 @@
<a href="configure.html">Configure</a> |
<a href="openbsd.html">OpenBSD</a> |
<a href="migration.html">Migration</a> |
<a href="change.log.html">Change Log</a> |
<a href="license.html">License</a>
</div>
</p>

1
doc/uninstall.html
View file

@ -61,7 +61,6 @@ Uninstall |
<a href="configure.html">Configure</a> |
<a href="openbsd.html">OpenBSD</a> |
<a href="migration.html">Migration</a> |
<a href="change.log.html">Change Log</a> |
<a href="license.html">License</a>
</div>
</p>

1611
install
View file

File diff suppressed because it is too large Load diff

160
mkconfig
View file

@ -1,160 +0,0 @@
#!/bin/sh
# Copyright (C) 2002, 2003, 2004, 2005, 2006 Balint Kis (balint@k-i-s.net)
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
echo "<?php
// Copyright (C) 2002, 2003, 2004, 2005, 2006 Balint Kis (balint@k-i-s.net)
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation; either version 2 of the License, or
// (at your option) any later version.
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.