Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Pinakes v0.3.0

Choose a tag to compare

@fabiodalez-dev fabiodalez-dev released this 06 Dec 13:31
· 85 commits to main since this release

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_doweyclassificazione_dewey (typo fix)
  • Remove table classificazione (data now in JSON files)
  • Add table migrations for tracking applied migrations
  • Add table update_logs for 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 files

For 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

Full Changelog

v0.2.0...v0.3.0