Pinakes v0.3.0
What's New in v0.3.0
Completely Redesigned Dewey Classification System
The Dewey Decimal Classification system has been completely rewritten. Data is no longer stored in the database but loaded from JSON files, enabling more flexible and collaborative management.
Key features:
- Automatic import from SBN: When querying books via the SBN API (Italian National Library Service), if the record contains a Dewey classification it is automatically imported
- Dewey Editor Plugin: A dedicated plugin for visual classification management — tree view, manual code addition per language (IT/EN), inline name editing, search, and delete functionality
- JSON Import/Export: Classification files can be exported and imported, enabling collaborative sharing between Pinakes installations
- Multi-language support: Separate JSON files for Italian and English with automatic locale detection
Built-in Auto-Updater
Starting from this version, Pinakes includes an integrated update system. Administrators can check, download, and install new versions directly from the control panel.
Note: Since this is the first version with the updater, v0.3.0 must be installed manually. Future releases can be updated automatically from the admin interface.
Features: Requirements check, automatic database backup, secure download from GitHub Releases, application file backup for rollback, file installation respecting protected paths (.env, uploads, storage), orphan file cleanup, automatic database migrations, OpCache reset.
Database Backup System
New comprehensive backup management:
- Automatic pre-update backup
- Manual on-demand backup from admin panel
- Backup list with creation date and size
- Download backups for disaster recovery
- Delete old backups to free disk space
Author Normalization
Intelligent system to prevent duplicate authors:
- Automatic format conversion: "Levi, Primo" and "Primo Levi" are recognized as the same author
- Source normalization during SBN import
- Fuzzy matching finds existing authors regardless of name format
Author/Publisher Merge
New feature to unify duplicate records:
- Bulk selection of authors or publishers to merge
- Automatic reassignment of all books to the primary record
- Deletion of duplicate records
Database Changes
This version includes database migrations. The updater will automatically:
- Rename column
classificazione_dowey→classificazione_dewey(typo fix) - Remove table
classificazione(data now in JSON files) - Add table
migrationsfor tracking applied migrations - Add table
update_logsfor update history
Breaking Changes
v0.3.0 is NOT compatible with previous versions without manual migration.
If upgrading from v0.2.x or earlier:
# 1. BACKUP YOUR DATABASE FIRST!
mysqldump -u USER -p DATABASE > backup_before_0.3.0.sql
# 2. Run the migration
mysql -u USER -p DATABASE < installer/database/migrations/migrate_0.3.0.sql
# 3. Then replace the application filesFor new installations: No action needed — the installer handles everything automatically.
Upgrade Notes
- Backup your database before updating (done automatically by updater)
- Clear browser cache after update
- If using opcache, restart PHP-FPM
- Future updates can be performed automatically from Admin → Updates