Welcome to ILMO’s documentation!

Users guide

Registration

To register you have to visit the library. An administrator will then set up an account for you. You will need to provide an valid E-Mail Address and a password.

Lending

You can check the available books or material online with your account.

To lend any books or material you visit the library and search for the item you want to lend. The location can be found in ILMO.

An administrator will then check the code of the item. You will provide them with the user ID you got during the registration or your E-Mail Address. The item will then be marked as lent.

You have to return the item according to the rules of the library.

Login

After your Registration you are able to log into your account with your E-Mail Address or user-ID and your password.

You can then access:
  • your lendings
  • your profile data
  • the available books and items
  • the opening hours

If you want t make changes to your profile ask an Administrator.

E-Mail

With your Registration you provide a valid E-Mail address. For every lending you will be reminded via E-Mail. The interval of the reminder is defined by the library.

Administration

Create user

Users are created by the administrators manually. Select Create user from the navigation.

You will need to provide the following information:
  • E-Mail Address
  • Forename
  • Surname
  • Password
  • Admin [default = No]
  • Language [default = library default]
Optional fields:
  • UID (only needed for admins that want to track working hours)

After clicking Send you will be redirected to a list of all user, where you can check the user ID.

Lending

As a user wants to lend an item you need to know the following:
  • Item category [book or material]
  • Item ID [e.g. CH42 d]
  • User ID or e-mail address

As many users do not remember their user ID or which e-mail address they used there is the possibility to search for a user. Select Search user from the navigation and search e.g. for their forename and then use the found information to continue the lending.

Returning

To return an item either visit the page All loans and search for the loan there or you search for the user, click on Show loans a search the loan there.

If you found the loan, you can simply click on the button Return and you are finished.

Opening hours

The opening hours can be changed by selecting the page Change opening hours in the navigation menu.

Just type in your new opening hours and click send.

Note

It is advised to fill empty time cells with a “-“.

If you wand to change the opening day you can do so by changing the config/settings.ini.

Add Items to lend

In the current state ILMO only supports one indexing system for books and one for material. If you have an existing numbering system it is advised to reach out to a developer to see if the system can be added or to adapt the supported indexing system.

Books

ID System

As most libraries do often have multiple copies of the same book an identification system was found that accounts for that.

For books the ID format therefore consists of a stem of category and number and a numbering with characters of copies.

CC[number] [ii]

"CH42 c"    # Titel 42 in category Chemistry, copy number 3

"XY132 af"  # Titel 132 in category XY, copy number 33

"a16792 c"  # bad example as categories should be two capital letters and the
            # titel number should be ascending
  • CC:
    Category abbreviation e. CH for chemistry. It is advised to use a two letter abbreviation, but there is no technical limit.
  • Number:
    Indicates which title the book has. The number is ascending incremented for every title added to the category.
  • ii:
    index of the copy. For the first copy the index is a for the second it is b and for the 27th copy it is aa.
Adding books

When adding books to the library you have to provide the following:

  • Book-ID:
    • You add only one book to the library:
      Give a full ID e.g. CH4 a and no number or the number one.
    • You add multiple books to the library:
      Give only an ID stem. The index of the copy will be added automatically.
  • Number of copies
  • Title
  • Author [optional]
  • Location [optional]

Give all of that information and click send.

Material

ID System

Material has a different ID system. It consists of an abbreviation and an index.

AA [index]

"LC 42"           # Labcoat number 42
"SG 132"          # Safety glasses number 132

"Labcoat 16792"   # bad example as abbreviation should be two capital letters and index
                  # number should be ascending
  • AA:
    Abbreviation of the items name
  • Index:
    Ascending number. The highest index of an item is the number of items of this name.
Adding Material

To add material add provide the following:

  • Material abbreviation
  • Number of items to add
  • Name of the item type [e.g. Labcoat]
  • Location [optional]

Give all of that information and click send.

Installation, customization and contributing

Installation

Requirements

  • A webserver (tested on Nginx)

  • PHP version > 5.6.38

  • SQL database (tested with MariaDB)

    As many hosting providers restrict the number of databases you can have, it can be necessary to share a database with another project. To use this you have to set a table prefix during installation.

    Warning

    This is not recommended as other projects could influence your library!

Download the project

You can download the newest release at Github <https://github.com/GerJuli/ILMO/releases>.

As an alternative you can clone the complete project from GitHub using:

$ git clone https://github.com/GerJuli/ILMO/

Build the documentation

If you want to you can build the documentation. In order to do this navigate in the folder docs/ and execute

$ make

or on windows the make.bat file.

Move it to your server

Now move the project to the servers document root (or any other directory that can be accessed by your webserver).

Warning

Exclude the docs/ folder from the server copy. They are not needed for the project to work.

Basic configuration

The basic configuration can be done in the browser. Open https://yourdomain.com and follow the given instructions:

  1. Configure database
  2. Create first user
  3. Delete the install/ directory

Customization

Settings

When opening the file config/settings.ini with a text editor you can adjust the following:

  • timezone = 'Europe/Berlin'
    Timezone as supported by php see the PHP documentation e.g. ‘Europe/Berlin`
  • enable_status = 1
    enable/disable status bar that indicates if the library is open
  • enable_presence_API = 1
    enable/disable presence API (used for tracking working hours)
  • max_loan_time = 0
    Maximum time of loan: Set to 0 for infinite
  • mail_reminder_interval = 90
    Interval of the e-mail reminder: Days after the user is reminded of a loan which is not returned
  • default_langage = german
    Default language. Pick between german and english
  • log_mail = 0
    If the e-mails that are sent should be logged
  • path_to_mail_log = "log/mail.log
    The path to the logfile for sent mails
  • opening_days[] = monday
    For every day of the week where the library is open, add a line

Images

To customize the images just replace the images in images/.

E.g. if you want to replace the header image replace the file images/logo_library.png.

Contributing

Report a bug

To report a bug, file an issue on Github

Try to include the following information:

  • The information needed to reproduce the problem
  • What you would expect to happen
  • What did actually happen
  • Error messages

You are also invited to include:

  • Screenshots
  • Which browser you are using
  • The URL of the site
  • How urgent it is
  • Any additional information you consider useful

Get involved!

To contribute simply clone the directory, make your changes and file a pull request.

If you want to know what can be done, have a look at the current Issues.

Get in touch!

If you have questions, want to contribute or want to message me regarding something else you can find contact information at https://hyteck.de/about/ or directly write an E-Mail

API Documentation

ILMOs API serves two different purposes. The first is to make data available to the public. The seconde is to track working hours and opening status.

Make Data Publicly Available

Example Use-Case:

You have a department/club/etc.. homepage that is run by a Content Management System like Wordpress and want to show which books are in the library available. ILMO is hosted on a different Website. One line of plain html code is enough to do what you want!

Simply include <iframe>

Show all books

Show all material

Track Working Hours and Opening Status

This part of the API offers the possibility to track working hours via a suitable IoT Device (e.g. a Raspberry Pi with NFC Reader.

Hint

This part of the API has to be activated in the settings!

Example Use Case

You have a library in your that is run by two students that need to track the hours they worked. Writing this down is way too easy and you want a live update when they are present so ILMO shows that someone is there. ILMO offers the possibility to checkin someone via an API. You therefore adapt the provided example script, so the students can use their student ID and a NFC reader that is connected to a Raspberry Pi to identify and checkin themselves.