Configuring Paloose as a Server to Apache

Paloose configuration is done through a single file. This file can be called anything (in the current sites case it is paloose-ini.php in the root directory of the site). If you wish to change the name then this change must be reflected in the .htaccess file, We will look at this in more detail below.

Warning

This configuration information is only applicable to Paloose versions after 1.5.0. Earlier versions are no longer supported and are deprecated.

Configuration is basically a question of telling Paloose where everything is. There are a set of constant definitions which need setting for correct operation. If you leave them commented out Paloose will assign defaults, (see the lib/Paloose.php file to see default values.

Configuration Variables (you may need to change)

The following definitions can all be changed if required. The values shown below are those that I use in the Paloose site.

PALOOSE_DIRECTORY

Change the PALOOSE_DIRECTORY address here to indicate where you have put the main Paloose folder. It can be relative to your application site folder. It is possible to change between different versions of Paloose merely my changing this line.

define( 'PALOOSE_DIRECTORY', '../paloose' ); define( 'PALOOSE_LIB_DIRECTORY', PALOOSE_DIRECTORY . '/lib' );

PALOOSE_LOGGER_CONFIG

Where the main log4php logger configuration file is kept. You can use Paloose pseudo protocols here. In the example below the log file configuration file is in user's site in the sub-directory "configs/". Now that the logging code is separate from the main Paloose code the constant LOG4PHP_DIR points to where the root of the log4php code is held (relative to the site path).

define( 'PALOOSE_LOG4PHP_DIRECTORY', '../log4php' ); define( 'PALOOSE_LOGGER_CONFIGURATION_FILE', '../[site root directory]/configs/Paloose.xml' );

PALOOSE_CACHE_DIR

This is where the Paloose caches are held. It does not include the images cache directory. Paths are relative to the base directory of the Web site — where the paloose.php file is in your project. Make sure that this directory has the correct permissions — probably safe to allow write to all. In the following the cache is held relative to the Web site root.

define( 'PALOOSE_CACHE_DIR', 'resources/cache' );

PALOOSE_ROOT_SITEMAP

Normally should not have to change this. The directory is always the top level user directory. The site root directory is the location of your sites file and where the root sitemap sites (as well the configuration file that you are looking at).

define( 'PALOOSE_ROOT_SITEMAP', 'sitemap.xmap' ); define( 'PALOOSE_SITE_ROOT_DIRECTORY', '../pp' );

PALOOSE_USER_EXCEPTION_xxx

The error page to give back for User errors (errors in sitemap etc). They are not run time errors (such as missing page, 404). If you override these to your area make sure that you use an absolute directory path — you can use the 'context://' pseudo-protocol here.

Be careful of the path for USER_EXCEPTION_STYLE — it looks like an absolute one, but is actually relative to the Apache root document directory. It must always have a leading path separator.

define( 'PALOOSE_USER_EXCEPTION_PAGE', 'resource://resources/errorHandling/userError.html' ); define( 'PALOOSE_USER_EXCEPTION_TRANSFORM', 'resource://resources/transforms/errorPage2html.xsl' ); define( 'PALOOSE_USER_EXCEPTION_STYLE', '/paloose/resources/styles/userError.css' );

PALOOSE_GALLERY_INDEX, IMAGEMAGICK_BIN

The file that contains the gallery information in each gallery directory. See the examples page on the gallery for more information. The ImageMagick directory is there if the PATH on the server is not set to pick up correct ImageMagick binaries.

define( 'PALOOSE_GALLERY_INDEX', 'gallery.xml' ); define( 'IMAGEMAGICK_BIN', '/usr/local/bin/' );

PALOOSE_INTERNAL_EXCEPTION_xxx

The error page to give back for internal (programming) errors (errors in sitemap etc). These should not need to be overridden.

Be careful of the path for INTERNAL_EXCEPTION_STYLE — it looks like an absolute one, but is actually relative to the Apache root document directory. Must always have a leading path separator.

define( 'PALOOSE_INTERNAL_EXCEPTION_PAGE', 'resource://resources/errorHandling/internalError.html' ); define( 'PALOOSE_INTERNAL_EXCEPTION_TRANSFORM', 'resource://resources/transforms/errorPage2html.xsl' ); define( 'PALOOSE_INTERNAL_EXCEPTION_STYLE', '/paloose/resources/styles/internalError.css' );

Configuration Variables (you should not need to change)

The following definitions should not be changed unless you have a really good reason and are interested in Paloose deep-magic.

PALOOSE_SITEMAP_NAMESPACE, PALOOSE_SOURCE_NAMESPACE, PALOOSE_DIR_NAMESPACE

This should not need to be changed unless you plan to use another sitemap schema or want to change the source writing and directory results (DirectoryGenerator).

define( 'PALOOSE_SITEMAP_NAMESPACE', 'http://apache.org/cocoon/sitemap/1.0' ); define( 'PALOOSE_SOURCE_NAMESPACE', 'http://apache.org/cocoon/source/1.0' ); define( 'PALOOSE_DIR_NAMESPACE', 'http://apache.org/cocoon/directory/2.0' );

PALOOSE_I18N_NAMESPACE

Change these with caution — they should only be changed for a different translation mechanism. It requires deep understanding of Paloose internals.

define( 'PALOOSE_I18N_NAMESPACE', 'http://apache.org/cocoon/i18n/2.1' );

PAGE_HIT_TRANSFORM

Only change this if you want to replace the current page hit mechanism.

define( 'PALOOSE_PAGE_HIT_TRANSFORM', 'resource://resources/transforms/PageHit.xsl' );

PALOOSE_NAMESPACE

This is the Paloose namespace that will never need to change unless there is a very good reason — subtext for, it won't change.

define( 'PALOOSE_NAMESPACE', 'http://www.paloose.org/schemas/Paloose/1.0' );

Finally ...

Definitely do not change these lines unless you really, really know what you are doing. Users of versions 1.40 and earlier will note this as the most significant change in how Paloose is called.

ini_set( 'track_errors', '1' ); require_once( PALOOSE_DIRECTORY . '/lib/Paloose.php' ); $paloose = new Paloose(); $paloose->run( $_SERVER[ 'REQUEST_URI' ], $_SERVER[ 'QUERY_STRING' ] ); unset( $paloose );
Copyright 2006 – 2023 Hugh Field-Richards. All Rights Reserved.