FreERMS is an electronic resource management system for libraries. It is written in PHP using the symfony framework (1.4). It requires PHP 5.3, and has been tested on Ubuntu Linux systems.
symfony is very well documented; the project homepage is http://www.symfony-project.org/
Clone the FreERMS git repo
/home/fred$ git clone https://github.com/yitznewton/freerms.git
FreERMS requires a slightly modified version of symfony. It is registered as a submodule of the FreERMS git repo; if you are installing manually, the symfony 1.4 filesystem should be symlinked or added as
The modified repo is https://github.com/yitznewton/symfony1
Add a symlink in
/webpointing to the symfony assets directory, or copy it, e.g.:
/home/fred/freerms/web$ ln -s ../vendor/symfony-1.4/data/web/sf
Specify your database connection in
Add missing directories:
/home/fred/freerms$ mkdir cache log
Install sfGuardPlugin and publish plugin assets:
/home/fred/freerms$ ./symfony plugin:install sfDoctrineGuardPlugin /home/fred/freerms$ ./symfony plugin:publish-assets
Run a Doctrine build.
/home/fred/freerms$ ./symfony doctrine:build --all
Clear symfony's internal cache (incidentally, always a good idea if something looks inexplicably broken during installation or update):
/home/fred/freerms$ ./symfony cc
Create a superuser:
/home/fred/freerms$ ./symfony guard:create-user jimbo mypassword /home/fred/freerms$ ./symfony guard:promote jimbo
At this point, you will be able to set your web server's document root to
web directory, and connect to the
/backend.php app with the user
you have just created.
In order to use the public-facing app, you will need to associate your user with one or more libraries, by selecting them as "groups" in the user's record, which you can edit by clicking "Users" in the backend area. Libraries are added as groups when you create them. You can also add arbitrary groups (academic programs, for example) which are not libraries.
sfDoctrineGuardPlugin documentation is available at http://www.symfony-project.org/plugins/sfDoctrineGuardPlugin
In order to use the reports app, you must install the flot plotting library in
/web/js/vendor/flot, and the Bluff chart library in
They are available at the following addresses, respectively:
After accessing the
/backend.php admin area, you will need to define your
libraries and IP ranges. You can then add databases. You must specify an on-
and off-campus access action for each (see below).
After selecting subject for each database, you can choose specific databases
to feature on the homepage via
/backend.php/databases/featured, or on subject
pages via each subject's admin page.
You can support multiple templates for the frontend app ('layouts' in symfony
terms) by adding them to
apps/frontend/templates/. They can then be called
by one of the following methods:
- Passing the layout name in the URL as the
- Passing the layout name in the URL as the
- Using the layout name as the most specific segment of the server host name,
If you supply a mobile layout with the suffix
foo_mobile, mobile users under that layout will be shown that template. You
can allow them to select the non-mobile theme by sending them to a URL which
force-no-mobile parameter set to a true value, e.g.
http://erms.example.com/?force-no-mobile=1. It can then be reverted with e.g.
Fine-grained access control
In addition to the normal library-level filtering of access, you can impose
additional requirements; for example, if a given database is licenced only for
a specific acadmic program. Add this program as a group, and associate the
relevant users. Then add this group's name in the database's
field. If you need to require multiple groups in AND or OR logic, use
symfony's credential syntax, as described at
To allow all onsite users, add
onsite as a value.
A number of standard access actions are included with FreERMS, including one for ticket-based EZproxy authentication, and ebrary single sign-on. Inevitably, however, some resources will require local customization.
To add a custom access action, create a new PHP class at
baseAccessAction. FreERMS will call the
AccessHandler instance when a user requests the resource.
To use an authentication system other than sfDoctrineGuardPlugin, you will
need a customized class which implements
freermsSecurityUser. In doing
so, Touro College (the sponsor of FreERMS's development) extended the
sfDoctrineGuardPlugin user class, overriding certain key methods.
You may also want a customized DataService class to include local user data in the usage logs.
Because of security concerns, Touro is not including their customizations in the main repository. Please contact firstname.lastname@example.org if you wish to discuss the details.
Usage of databases and access of URLs are logged in the
url_usage tables of FreERMS's database. At present, these need to be queried
by hand. A reporting module is planned.