Skip to content

Configuration

Jason Pell edited this page Jun 21, 2013 · 1 revision

The System Admin Configuration tool allows quite a few settings to be tweaked for each individual site. The configuration tool is separated into several different sections.

Table of Contents

OpenDb Site

Session Duration

The ability to configure the duration of sessions is a basic requirement of any secure system. However OpenDb has been rather limited in its functionality in this area.

The ability to configure both a maximum idle time and maximum session time has been requested to provide much more control over session durations.

The opendb configuration provides for the setting of several configuration parameters.

  • Idle Timeout
  • Login Timeout
The 'Login Timeout' variable if configured (to a numeric value) configures how many seconds the session can remain active total. This value ignores any activity against the session, and will expire the session once the session has been active for the duration specified.

The 'Idle Timeout' is a little more flexible. This value will expire the session if it has been _inactive_ for the specified duration. Everytime OpenDb is successfully accessed the counter for this variable is reset.

Public Access Configuration

You can configure OpenDb to be publicly accessible, but also allow users to login so they can perform updates, reserves, etc.

Enable public access

The opendb configuration 'OpenDb Site' / 'Public Access' section 'Enable' entry must be checked.

Configuring public access permissions

The site will be enabled with access rights configured according to the PUBLICACCESS role. If you want to grant / revoke privileges you can do so by modifying the permissions of the PUBLICACCESS role.

Logging

Http

Email

Widgets

Login

User Administration

Item Listings

Item Display

Item Input

Item Review

Item Borrow

Item Search

Import

Statistics

This section describes the configuration of the statistics page, in relation to how the various graphs are to be generated.

Look and Feel Parameters

There are four separate configuration variables for customizing the generation of the statistics images.

1. Category Barchart

If checked, produce a bar chart instead of a pie graph. Items that do not fit in the chart will be omitted.

Configuration Parameters

1. Image Type [png]

Defines the output format of the images. This will often depend on what kind of GD library configuration you have available.

Note: In somes cases 'gif' may not be available due to copyright restrictions.

2. Chart Library

Which chartlib implementation to use, options include:

  • Libchart (1.1 for php4, 1.2 for php5)
  • PhpPlot
  • JPGraph (for php5.1)
  • Legacy (1.0 stats functionality - not supported anymore provided as a convenience only)

GD Library issues

Several people have reported issues with getting GD to work with various configurations.

The configuration variable gd.library is provided for systems where the GD extension is not enabled in php.ini. However another user has reported a problem with loading the GD extension using the dl(...) command, when running OpenDb on a Multitreaded Web server. (IIS 5.0 for instance). You need to enable this configuration option in the include/local.config.php - it is not available in the GUI configuration tool. The following line should be added:

 $CONFIG_VARS['site.gd']['library'] = 'gd.so';

In this case, you have no choice but to enable the GD extension in the php.in file. If you do not have access to this file (a hosted service), and GD is not enabled, and you are using a Multitreaded Web server such as IIS 5.0, which does not support dl(...), then you may not be able to generate the stats charts.

Configuration

1. Windows - IIS 5.0 (may also be applicable for Apache as well)

You have to configure PHP to use php_gd.dll. This is done be finding the following line in your php.ini and uncomment it ( remove the ";" ).

;extension=php_gd.dll

Thanks to Agner Ringsborg Madsen for this information

Announcements

The wiki migration is a work in progress. I am aware that some images don't currently work.

Clone this wiki locally