BIBBNeo/README.md
2026-02-23 21:10:26 +01:00

100 lines
2.7 KiB
Markdown

# BIBBNeo Module für VuFind 10.2
Eigenes VuFind-Modul für das Bundesinstitut für Berufsbildung (BIBB).
Ersetzt die bisherigen Core-Modifikationen durch saubere Overrides.
## Architektur
```
VuFind\RecordDriver\SolrDefault (Core 10.2, unangetastet)
├── VuFind\RecordDriver\SolrMarc (Core 10.2)
│ │
│ └── BIBBNeo\RecordDriver\SolrMarc
│ BIBB-Felder + geänderte Core-Methoden (via Trait)
│ Für: Koha-MARC-Records (recordtype = "marc")
└── BIBBNeo\RecordDriver\SolrDspace
DSpace-spezifische Methoden + BIBB-Felder (via Trait)
Für: DSpace-Records (recordtype = "dspace")
```
### BIBBRecordTrait
Gemeinsamer PHP-Trait, der von beiden RecordDrivern verwendet wird:
- **BIBB-Solr-Felder**: citation, citationdr, extend, participation,
researchfocus, accompanyingmaterial, additionallinks, dissertationnote,
originalversion, reviewof, replaces, isreplacedby, classification,
voevzlink, ctrlnum
- **Core-Overrides**: getAllSubjectHeadings (nur topic), getFormats
(medium vor format), getSeries (series + series2), getContainerVolume
(Array-Handling), getSupportedCitationFormats (BIBB, BIBBBWP, APA)
### SolrDspace (zusätzlich zum Trait)
- Bitstream-URL-Handling mit VOE-VZ-Link-Zuordnung
- DOI/URN-Auflösung
- DSpace-Handle-Filterung
- Rechte/Embargo-Felder (license, rightslicense, rightsuri, etc.)
- getOnlineLinks(), getPids(), getFormatsFiltered()
## Installation
### 1. Modul kopieren
```bash
cp -r module/BIBBNeo /usr/local/vufind/module/
```
### 2. Modul aktivieren
In `/usr/local/vufind/local/httpd-vufind.conf` (oder `env.d/`) die
Umgebungsvariable VUFIND_LOCAL_MODULES ergänzen:
```apache
SetEnv VUFIND_LOCAL_MODULES "BIBBNeo"
```
Alternativ in `/usr/local/vufind/local/config/vufind/config.ini`:
```ini
[System]
; Falls bereits andere Module aktiv sind, kommasepariert:
local_modules = "BIBBNeo"
```
### 3. Cache leeren
```bash
rm -rf /usr/local/vufind/local/cache/configs/*
rm -rf /usr/local/vufind/local/cache/objects/*
```
### 4. Apache neustarten
```bash
systemctl restart apache2
```
## Voraussetzungen
- Solr-Feld `recordtype` muss für DSpace-Records den Wert `dspace` enthalten
- Alle BIBB-spezifischen Solr-Felder müssen im Schema definiert sein
## Noch zu migrieren
Die folgenden Dateien aus der alten Installation müssen noch
ins BIBBNeo-Modul überführt werden:
- [ ] Citation.php (BIBB/BWP-Zitierformat)
- [ ] KohaILSDI.php (Koha-Treiber-Anpassungen)
- [ ] RecordDataFormatterFactory.php (Detailanzeige)
- [ ] Export.php (RIS-Export-Anpassungen)
- [ ] BrowseController.php
- [ ] CartController.php
- [ ] CoverController.php
- [ ] FeedbackController.php
- [ ] AjaxController.php
- [ ] Theme BIBBNeo (Templates, CSS, JS)