EXT: E&E Library¶

Wozu dient die Erweiterung?¶

Diese Erweiterung dient zur Verwaltung von Bibliotheksbeständen, vornehmlich in Firmen. Dazu können Bücher, Zeitschriften und Studien in definierbaren Kategorien eingeordnet und mit Metadaten versehen werden.

Entleihungen und Rückgaben werden im Backend verwaltet, Frontend- Benutzer können nach Medien suchen, diese vormerken oder sich in Verteilerlisten für Zeitschriften eintragen bzw. sich aus diesen löschen.

Voraussetzungen¶

Der volle Funktionsumfang der Erweiterung kann nur genutzt werden, wenn sich Frontend-Benutzer anmelden müssen.

Wenn das Plugin “new_loginbox” installiert und aktiviert ist, können Benutzernamen (beispielsweise des Entleihers) mit der verlinkt werden. Der Klick auf den Benutzernamen führt dann zu den Detaildaten des Benutzers.

Entwicklung und Sponsoring¶

Die Erweiterung wurde speziell für die Berliner Unternehmensberatung E&E information consultants entwickelt und wird nun als Open Source zur Verfügung gestellt. Aufgrund der Herkunft, sind die Leistungsmerkmale recht speziell, können aber leicht an individuelle Bedürfnisse angepasst werden.

Screenshots¶

Einbinden des Plugins¶

Normale Seite (“Bibliothek”) für die personalisierte Übersicht anlegen.

Unterhalb der Bibliotheksseite eine normale Seite (“Suche”) zur Detaildarstellung eines einzelnen Mediums anlegen.

Unterhalb der Bibliotheksseite eine normale Seite (“Buch anzeigen”) zur Detaildarstellung eines einzelnen Mediums anlegen.

Unterhalb der Suchseite einen SysFolder anlegen, in welchem die Medien, Kategorien etc. abgelegt werden.

Auf der Bibliotehksseite einen neuen Seiteninhalt vom Typ “Plugin einfügen” anlegen, als Erweiterung “E&E Bibliothek” wählen und speichern. Danch in der darunterliegenden Auswahl “FE-Benutzer ...” einstellen. Als Ausgangspunkt den SysFolder mit den Medien auswählen. Der Benutzer erhält eine Übersicht über entliehene und vorgemerkte Bücher, sowie Verteilerlisten.

Auf der Suchseite einen neuen Seiteninhalt vom Typ “Plugin einfügen” anlegen, als Erweiterung “E&E Bibliothek” wählen und speichern. Danch in der darunterliegenden Auswahl “Suche” einstellen. Als Ausgangspunkt den SysFolder mit den Medien auswählen.

Auf der Detailseite einen neuen Seiteninhalt vom Typ “Plugin einfügen” anlegen, als Erweiterung “E&E Bibliothek” wählen und in der darunterliegenden Auswahl “Detailansicht” einstellen. Als Ausgangspunkt den SysFolder mit den Medien auswählen.

Seitenvorlage¶

Neue Erweiterungsvorlage für die Suchseite anlegen.

Vorlage anpassen: “Constant Editor” wählen, als Kategorie “PLUGIN.TX_EELIBRARY_PI1” wählen und die Werte für die Konstanten eintragen. Wenn bei Klick auf einen Benutzernamen (z.B. Des Entleihers) die Daten des FE-Benutzers angezeigt werden sollen, so muss die Erweiterung “new_loginbox” installiert und aktiviert sein.

Das Datumsformat (entliehen von Max Mustermann bis 15. August 2003) kann im Setup-Feld der Vorlage geändert werden:plugin.tx_eelibrary_pi1 {displayList.date_stdWrap.strftime= %d. %B %YdisplaySingle.date_stdWrap.strftime= %A, den %d. %B %Y}

Bevor Medien angelegt werden können, müssen Arten, Marktkontexte, Themenbereiche, Erscheinungsweisen und Stati definiert werden. Dazu werden diese als neue Elemente im SysFolder angelegt.

Einrichtung¶

Dazu wird per Zeitsteuerung (UNIX/Linux Cron-Job, Windows Taskplaner) die Datei “eelibrary_reminder.php” ausgeführt:

php <Pfad>/typo3conf/ext/ee_library/pi1/eelibrary_reminder.php

Damit der Aufruf funktioniert, muss allerdings noch eine TYPO3-Bibliothek geändert werden. In “<Pfad>/typo3/t3lib/class.t3lib_extmgm” muss eine Zeile in der Funktion “extPath” wie folgt auskommentiert werden, da beim Aufruf via Cron o.ä. die Backend-Module nicht geladen werden können:

function extPath($key,$script="") {

global $TYPO3_LOADED_EXT;

# if (!isset($TYPO3_LOADED_EXT[$key]))

die("Typo3 Fatal Error: Extension key '".$key."' was NOT loaded!");

return PATH_site.$TYPO3_LOADED_EXT[$key]["siteRelPath"].$script;

}

Anpassung¶

Die Konfiguration der versandten e-Mail erfolgt direkt in der php- Datei (“eelibrary_reminder.php”):

$reminder_offset = 3; #Offset [days] between conferred_end and reminder

$m_subject = "Mahnung";

$m_header = "Die folgenden Buecher sind faellig:".chr(10).chr(10);

$m_name = "Bibliothek Mahnwesen";

$m_from = "bibliothek@eumedia.de";

$m_cc = " bibliothek@eumedia.de ";

[...]

$m_msg = $m_header.formatStr($row["callnumber"], 10).formatStr($row["title"], 30).formatStr($row["author"], 20).chr(10);

Die Funktion “formatStr” füllt eine Zeichenfolge linksbündig mit Leerzeichen auf die angegebene Länge auf. Dadurch stehen die Angaben zu jedem Buch korrekt untereinander.

Die einzelnen Datenfelder werden mittels $row[“<Feldname>”] eingebaut. Folgende häufig benutzte Datenfelder stehen zur Verfügung: