Skip to main content

ABCD v4.1.0

· 3 min read
Roger C. Guilherme
Programmer and librarian at ABCD

We are pleased to announce the release of ABCD v4.1.0. This version brings important improvements to stability, security, new data import features, plugin management, and general optimizations to the updater and user interface.


New Features and Highlights​

Header-Based Text Imports (#779)

  • Added support for loading CSV/TSV files with encoding selection.
  • Introduced a conversion-table mode that maps header names directly to fields, including support for repeated occurrences.
  • Implemented unmatched column reporting and added localized interface text.

Plugin Management and Compatibility (#782)

  • Added ABCD version compatibility checks for plugins.
  • The system now displays version requirements and compatibility warnings, blocking incompatible installations and activations.
  • Improved plugin manager error handling with new translated messages.

Data Entry Hooks (#781)

  • Exposed extension hooks for the data entry toolbar search area and the page footer.

Search Term Expansion (#780)

  • Multiword search terms are now split, applying the configured field prefix to each unqualified word and joining adjacent terms with the ISIS AND operator, while preserving explicit operators and existing prefixes.

Update System, Lifecycle, and Migration​

Updater Self-Update (#772)

  • Added a pre-download check that safely validates and replaces the update manager when a newer release is available.
  • Standardized batched update statuses and fixed migration script discovery.

Lifecycle and Migration (#771)

  • Prevented extract-loop hangs and restored the protected config across partial-update batches.
  • Improved v4 config migration checks and localized update-manager and migration messages (English, Spanish, French, and Portuguese).

Progress and Text Encoding (#775)

  • Normalized update logs and release notes for reliable UTF-8 display.
  • Capped progress below completion during source installation and added elapsed time tracking for slow requests.
  • Added a cleanup announcement before removing temporary files so the update remains visibly active.

Security and Fixes​

CloudAV False Positive Fix and API Hardening (#776, #777)

  • Refactored central/settings/api_manager.php to eliminate the SMW-INJ-CLOUDAV-php.dropper.content_include-PHPTRP2-4 heuristic false positive triggered by CloudAV / Imunify360 malware scanners on Linux hosting environments.
  • Strict Extension Whitelist: Added explicit validation using basename() and pathinfo(..., PATHINFO_EXTENSION) so file_put_contents() only writes .i2x and .pft files inside /resources/mappings/, preventing arbitrary file extensions.
  • Safe Config Generation: Refactored how API configuration files are written and loaded so the script no longer interpolates $_POST parameters into raw <?php strings.

General Adjustments

  • Removed the MAX_TMP_STRING parameter (#778): This parameter does not exist in the CISIS binary build. For UTF-8 binaries, its presence in .xis scripts caused errors. The buffersize parameter alone is sufficient.
  • Layout Fix (#773): Set a 350px maximum width for the database heading select, fixing layout breaks when a database has a very long name.
  • Preserve Return Script (#773): Added a hidden backtoscript field in the JSON export form so the configured return destination is properly submitted.

Important Update: ABCD v4.0.2 (Hotfix) Released – How to Update Safely

· 4 min read
Roger C. Guilherme
Programmer and librarian at ABCD

We are excited to announce the release of ABCD v4.0.2. This maintenance release is highly focused on correcting and stabilizing the Update Manager itself, addressing critical bottlenecks that affected users upgrading from versions 4.0.0 and 4.0.1.

🛠️ What’s New in v4.0.2?​

The transition to the ABCD 4 architecture introduced a new batched AJAX processing system to the Update Manager, preventing screen freezes and server timeouts. However, versions 4.0.0 and 4.0.1 encountered three unintended side effects:

  1. Extraction Infinite Loop: The extraction phase would hang in an infinite loop because the system failed to recognize the "success" string returned by the server, a problem exacerbated if your interface was not set to English.
  2. Aborted config.php Update: A premature shutdown hook falsely assumed the update process was incomplete (logging config.php v4 NOT applied), which aborted the new configuration merge.
  3. Fatal Error ("Main config not found"): During the replacement of the main core directory (central/), the configuration file was temporarily wiped from the disk and not restored in time for the next batch request, triggering a fatal error.

We have successfully resolved these issues in v4.0.2. Furthermore, we have introduced a "Pre-Download Self-Update" mechanism. Moving forward, the Update Manager will update itself before downloading and applying any core ABCD files, ensuring you always execute the safest and most recent update logic.

📖 How to Update to ABCD 4.0.2​

The path to update depends entirely on your current ABCD version.

➡️ For Users Upgrading from v3.9.x: You can proceed normally! The legacy Update Manager in the 3.9 series runs the installation in a single monolithic request, so you are not affected by the bugs mentioned above. You will transition smoothly into the v4 architecture.

➡️ For Users Currently on v4.0.0 or v4.0.1: Because your current Update Manager contains the extraction loop bug, you cannot update directly using the standard "Update" button.

However, thanks to ABCD 4's new modular architecture, you can apply this hotfix directly from your browser—no SSH or FTP access required!

To ensure a smooth process, we have created a quick step-by-step video tutorial. Please watch the tutorial before proceeding: 🔗 Watch the Update Tutorial Here

Step-by-Step Instructions:

  1. Go to Configuration ABCD -> Plugins.
  2. Locate the "ABCD Update Manager Hotfix" in the plugin list. (Note: The update notification is already visible at the bottom of the page, but do not click it yet).
  3. Click Install, wait a few seconds, and then click Activate.
  4. Click on Settings within the active plugin list (or click the link inside the green notification bar at the top of the screen).
  5. Your Update Manager is now patched! You can safely navigate to the Update Manager and proceed with the ABCD 4.0.2 update as usual.

(Please be patient during the final installation stage of the Update Manager, as the system takes a few moments to clear temporary files. Wait until the "Reload Page" button appears).

Once you have successfully updated to v4.0.2, the self-update system will be active, and the Hotfix plugin can be safely deactivated and removed.

Thank you for your continuous support. Be sure to subscribe to the ABCD YouTube channel for more tutorials and updates!

ABCD 4.0.1

· 2 min read
Roger C. Guilherme
Programmer and librarian at ABCD

ABCD 4.0.1​

This is a maintenance release that fixes a problem affecting everyday work in ABCD Central: users being signed out unexpectedly after viewing a report preview. It is recommended for all 4.0.0 installations.

What you may have noticed​

After generating a report (Reports, then a search, then Preview), the result opened correctly in a new window. But when you then clicked Home in the main window, ABCD showed "Session expired or you are not logged in" and sent you back to the sign-in page. Anything not yet saved at that moment was at risk. Your databases and records were not affected.

What was wrong​

Pages such as the report preview did not declare a site icon, so the browser asked the server for /favicon.ico on its own. That file did not exist, and the request ended up at the sign-in page, which clears the current session. The user was signed out without any warning.

What changed​

  • Pages such as the report preview now declare the ABCD icon (central/common/header_display.php), so the browser no longer asks for /favicon.ico.
  • A favicon.ico file is now included in the web root and served directly.
  • Requests for missing images, styles and scripts now return a normal "not found" (404) response instead of falling through to a PHP page (.htaccess).
  • Opening the sign-in page while already signed in now takes you straight to the system instead of showing the form again (login.php).

Upgrading​

Update as usual, or replace the files listed below. No database or configuration changes are required, and your own config.php is not touched.

Files changed:

  • central/common/header_display.php
  • login.php
  • .htaccess
  • favicon.ico (new)

If you cannot update right away, create a favicon.ico in the web root (the folder that contains login.php). This alone prevents the sign-out. For example, from that folder:

cp assets/images/favicons/favicon-32x32.png favicon.ico

Notes​

  • The Windows installer has been rebuilt with these fixes.
  • Details: #765 (issue) and #766 (pull request).

What's Changed​

Full Changelog: https://github.com/ABCD-DEVCOM/ABCD/compare/v4.0.0...v4.0.1

Thank you to everyone who reported and helped reproduce this problem.

ABCD 4.0.0

· 3 min read
Roger C. Guilherme
Programmer and librarian at ABCD

We are pleased to announce the release of ABCD version 4.0.0. This update represents a historic architectural leap, marking the transition of ABCD from a traditional ILS (Integrated Library System) to a true plugin-based LSP (Library Services Platform). The new version brings a modular approach, a native REST API, and expanded support for different types of collections.

Below, we highlight the main new features and structural improvements in this version:

🧩 Plugin-Based Modular Architecture​

  • Plugin System: The system core now operates with a robust plugin architecture, allowing the expansion of services without the need to modify the central code (core).
  • On-Demand Installation: Legacy or specific databases and modules (such as ODDS, SIP2, Projects, and Experts) have been removed from the default installation. These components can now be managed and installed remotely, ensuring a lighter system adaptable to the needs of each institution.

🔗 Interoperability and Data Export​

  • Native REST API: Implementation of a complete REST API for direct and secure access to databases, featuring centralized API key management, SHA256 encryption, and read/write scope control.
  • Batch JSON Export: New integrated workflow for exporting databases in JSON format, allowing extraction in the native ISIS format or with direct mapping to the Dublin Core standard.
  • Export Resilience and Management: The data conversion engine was restructured to process blocks individually, ensuring high tolerance against malformed markup, control characters, and UTF-8 encoding failures. The interface includes a real-time progress bar and a manager for secure downloading and deletion of generated files.

🏛️ Museum Management (SPECTRUM Standard)​

  • New Data Model: Initial implementation of an example database and management module tailored for museums, strictly structured based on the international SPECTRUM standard.
  • Museum OPAC: New public interfaces and display formats (PFTs) adapted for museum collections, featuring support for attachment metadata, inscription control, and multilingual support.
  • Expert Search: Introduction of a new direct boolean search interface in the OPAC, accompanied by results organized in collapsible panels to optimize the user experience.
  • Relevance Control and Performance: Addition of configurable controls for relevance ranking, increased search buffer, and refactoring of the integrated search logic, ensuring more speed and stability for large collections.
  • Metrics and Usability: Significant performance improvements in search log analysis (OPAC Analytics) and corrections in encoding handling for form submissions with accents.

🛠️ Cataloging and System Administration​

  • Language Management (LanguageManager): Implementation of a cascading translation system. Core files are now kept separate from institutions' local customizations (saved in the content folder), preventing data loss during updates.
  • Enhanced Data Entry: Support for a new HASH field type (generating cryptographic values for unique identifiers), improved handling of multi-select fields, and integration of a secure assistant for auto-increment (AI) numbering.
  • Security and Interface (UI): Complete redesign of the central topbar, addition of a native and secure interface for changing passwords (with CSRF protection), and rigorous sanitization of variables to prevent XSS vulnerabilities.
  • Maintenance and Synchronization: New automated routine for smart synchronization of the copies database with the loans database (loanobjects), and refactoring of the CrunchMF conversion utility for greater reliability on Linux systems.

ABCD 3.9.0

· 3 min read
Roger C. Guilherme
Programmer and librarian at ABCD

The ABCD Community is proud to announce the release of ABCD v3.9.0. This milestone brings substantial architecture modernization, enhanced file security, improved layout responsiveness, and localized data entry definitions.

Legacy dependencies have been streamlined, paving the way for a more robust and modular open-source ecosystem.


New Features & UI Enhancements​

File Upload & Media Flexbility​

  • Windows File Compatibility (#671): Sanitization regex rules have been updated to securely permit spaces in image filenames. This allows for user-friendly asset names while filtering dangerous terminal characters.
  • Custom Upload Subdirectories (#673): Introduced a destination subdirectory input field within the media upload modal, letting managers organize files dynamically. Built-in path deduplication prevents folder repetition errors.

Module Modernization​

Circulation Module Overhaul (#676)​

  • Legacy Grid Elimination: Replaced the heavy, third-party dhtmlXGrid implementation on administrative forms (typeofitems and typeofusers) with lightweight, native HTML tables and generic JavaScript controllers.
  • PRG Pattern Adoption: Form submission states now leverage the Post-Redirect-Get pattern, eliminating accidental duplicate submissions and integrating clean success notifications.
  • Font Awesome Integration: Cleaned up navigation blocks by migrating from hardcoded asset image tags to high-resolution Font Awesome typography (menuButton-fa).
  • Output Interface Decoupling: Repositioned footer allocations and disabled institutional site wraps on raw print/receiver frames (rs01.php, rsweb.php, estado_de_cuenta.php) to maximize printable screen areas.

OPAC Settings (#672)​

  • Visibility Adjustments: Corrected operational visibility blocks inside config_opac.php to ensure unrestricted search indexing matches standard local installation values.

Security & Performance Hardening​

Data Entry Integrity​

  • Injection Prevention (#673): Re-engineered multi-part modal upload payloads to handle parameters safely through json_encode() encapsulation for FormData parsing, moving away from vulnerable inline string concatenations.
  • Null-Safe UI Controls (#674): Rewrote the JavaScript validation tree inside copies_add.php with explicit element guards (middleForm, tag200, textarea, and input fields) to completely eradicate client-side runtime crashes when elements are absent.
  • File Management Blueprints (#674): Delivered standardized user asset blueprints via explicit dr_path.def mock configurations specifying UNICODE=0 limits and strict extension enforcement (DIRTREE_EXT) across user targets.
  • Asset Mapping (#673): Rectified relative path bindings for core interaction assets, pointing clear_field.js safely to its data-entry editor hub. Adjusted frame reload latency parameters to 800ms to guarantee server-side synchronization.

Repository Cleanup & Standardization​

  • File Purge (#675): Dropped non-functional and unreferenced historical scripts to reduce structural overhead.
  • Styling Hygiene (#676): Cleared obsolete .sectionIcon background definitions out of odds.css.
  • Documentation Alignment (#677): Fully revised the primary README.md layout, ensuring up-to-date documentation paths, corrected links, and an accurate project state definition.
  • Translation Maintenance: Continued translating code remarks and inline development logs from Spanish and Portuguese over to English for global open-source community alignment.

ABCD 3.8.4

· 3 min read
Roger C. Guilherme
Programmer and librarian at ABCD

ABCD v3.8.4 brings crucial improvements to system stability, PHP 8.x compatibility, and user experience. This release focuses on hardening input validation, fixing MARC database saving mechanisms, and refining OPAC functionalities.

Below is a detailed summary of the changes and enhancements included in this update:

Search & OPAC Enhancements​

  • Alphabetical Indexes & UX: Fixed bugs related to the "Alphabetical Indexes" button. Added a new UX feature allowing the index submenu to open by default via URL parameters (open_index=Y), ensuring integrated searches navigate correctly while preserving context (base, ctx).
  • Strict Mode Enforcement: Added a strict-mode guard in central/config_opac.php to explicitly deny access if opac_strict_mode is enabled and no database (?base) is provided.
  • Topbar Refactoring: Reorganized the OPAC topbar (topbar.php) to improve the HTML markup, simplify authentication logic (detecting online services, showing logged-in users, or the login modal), and consistently preserve context parameters when navigating to the home link.
  • Search Pagination Stability: Enhanced input validation in buscar_integrada.php to handle edge cases and prevent bot-induced runtime errors. Pagination parameters (desde and count) are now strictly validated and cast with numeric fallbacks.

Data Entry & MARC Handling​

  • MARC Indicators Fix: Resolved broken saving functions in MARC databases. The system now correctly respects MARC indicators by detecting definitions from the FDT, extracting/padding the first two characters, and separating implicit from explicit subfields during client-side assembly.
  • Picklist Selection Logic: Fixed picklist selection mismatches by properly casting and sanitizing option values to strings before comparison, preventing PHP numeric mismatch errors.
  • Editor Improvements: Updated the clear_field.js editor script to use English standard text ("Clear field" instead of "Limpar campo"). Added a new mover action.
  • Formatting Script (fmt.php) Cleanup: Streamlined record display logic, ensured PlantillaDeIngreso() and ColocarMfn() are called in the correct branches, and standardized the use of $arrHttp['login'] instead of maintaining separate login variables.

Security & PHP 8.1+ Compatibility​

  • Session & Redirect Hardening: Guarded access to session/login variables with isset() to prevent PHP 8.1+ undefined session errors. Added strict die; statements following header redirects to ensure script execution completely stops when $_SESSION["permiso"] is missing.
  • Undefined Variables & Array Keys: Resolved multiple PHP warnings across the system (e.g., undefined $hasta, undefined Diccio index, and foreach() null arguments in c_global_ex.php).
  • Expression Handling: Hardened logic in PresentarExpresion.php to handle missing expressions safely, defaulting to an empty string to avoid "Undefined array key" errors.
  • Input Whitelisting: Whitelisted the new open_index parameter in is_malicious.php to allow the URL-driven UX flag through security validations.

System & Maintenance​

  • Update Manager: Fixed the behavior of the "Update" button to ensure smooth upgrades.
  • File Cleanup: Removed misplaced duplicate files from the repository to keep the architecture clean.
  • Version Bump: Updated version.php to reflect version 3.8.4.

ABCD 3.8.3 – Bug fixes for this version

· 3 min read
Roger C. Guilherme
Programmer and librarian at ABCD

Version 3.8.3 brings a major overhaul to ABCD's cataloging capabilities, introducing full support for modern cataloging standards like RDA, alongside critical improvements to subfield data handling and system localizations.

Key Features & Updates​

1. Universal Fixed-Field Manager​

The legacy fixed-field engine has been completely refactored. Moving away from the hardcoded 008 field limitation, the system now features a dynamic, fully adaptable engine for handling multiple and repeatable fixed fields (such as 006 and 007).

  • Smart Cataloging Interface: Catalogers can now add multiple occurrences of fixed fields seamlessly within a single record—essential for mixed-material items (e.g., a book with a CD-ROM). The UI now intelligently reads routing files, automatically deduces material categories from the Leader, and safely parses line breaks.
  • Dynamic Administration Hub: A centralized hub dynamically scans the FDT for 'M' (Matrix) type fields. Administrators can now edit .tab routing files directly from the UI and automatically generate missing .fdt matrices, bypassing legacy restrictions.

2. Core Data Handling & Output Sanitization​

Rendering engines and subfield parsers have been hardened to improve data integrity and prevent encoding issues.

  • Subfield Helper & Implicit Support: Introduced a new SubfieldHelper to explicitly extract, decode, and manage the implicit _ subfield without losing data during rendering.
  • Custom Sanitization: Replaced standard htmlspecialchars calls with a robust, custom sanitization implementation across the Group, Table, and Text renderers. This ensures consistent escaping and preserves compatibility with legacy JavaScript dependencies.

3. Localization & i18n Improvements​

Extensive updates have been made to the system dictionaries to ensure a fully multilingual cataloging and administrative experience.

  • Fixed-Field Interface Translations: Hardcoded strings in the fixed-field UI have been replaced with dynamic $msgstr variables, with complete translations added for English, Spanish, and Portuguese across both Linux and Windows environments.
  • Comprehensive Spanish UI Update: The admin.tab file for Spanish users received a massive update. Typos and encoding issues were resolved, keys were harmonized, and numerous new UI messages were added covering modules like Z39.50, backups, the thesaurus, file uploads, and search functionalities.

ABCD 3.8.2 – Bug fixes for this version

· 2 min read
Roger C. Guilherme
Programmer and librarian at ABCD

What's Changed​

  • Rebuild SubC JS and handle picklists/indicators by @rogercgui in https://github.com/ABCD-DEVCOM/ABCD/pull/656

    • Refactor campos.php parsing to collect IND/S rows into a JS-friendly SubC string and simplify picklist/label population. The PHP now accumulates relevant rows into subc_js_array, handles both "S" and "IND" marker types (with a historical fallback), builds picklist/name entries with proper escaping, and emits SubC as a single \n-separated JS string. Update editarocurrencias.js to dynamically reconstruct the actual subfields (subc_reais) from SubCampos and inject them into Tx[5], ensuring the renderer sees indicators/subfields even when they were omitted from the main FDT. Improves compatibility with older DB formats and makes picklist/indicator handling more robust.
  • New layouts by @rogercgui in https://github.com/ABCD-DEVCOM/ABCD/pull/657

  • Fix browseby behavior and record checkbox by @rogercgui in https://github.com/ABCD-DEVCOM/ABCD/pull/658

    • Fix browseby behavior and record checkbox
    • menu_main.php: Prevent programmatic updates to the "browseby" select from triggering onButtonClick (avoids unintended recursive/user-action side effects), add logic to call top.Menu('same') when keeping the current record after changing browse mode, add error logging, and translate several comments to English. toolbar_record.php: Correct MFN handling (properly derive mfn_val), guard against missing DOM element before updating, and set the "Select Record" checkbox via the checked property so it accurately reflects selection state.

ABCD 3.8.0 Technical Release Notes

· 5 min read
Roger C. Guilherme
Programmer and librarian at ABCD

This release introduces deep structural updates to the core of ABCD, focusing heavily on modernizing the Data Entry (Cataloging) interface and ensuring compliance with international standards. ABCD v3.8 marks a significant milestone in transitioning from a traditional Integrated Library System (ILS) to a more modular Library Services Platform (LSP). The architecture has been refactored to be significantly more stable, developer-friendly, and fully prepared for future integrations via REST APIs.

🚀 Key Features​

Data Entry Interface Modernization (More)

  • Native TAB Support in FDT: Added support for the TAB field type to organize forms into distinct tabs. This enables the clean separation of form sections, completely replacing massive, single-page layouts that previously required gigantic accordions and endless vertical scrolling.

Native TAB Support in FDT

  • Removal of Legacy Dependencies: The heavy and rigid dependency on the legacy dhtmlX library has been completely removed. The interface was rebuilt using semantic HTML and CSS Flexbox, resulting in a lighter codebase and much faster browser rendering.
  • Responsive Toolbar: The global toolbar was redesigned into a responsive, two-tier layout. It maintains full support for core operations (including Quick Search, Formats, and Worksheets) while communicating seamlessly with the legacy iframe architecture.

New Toolbar

  • Database Lock Resolution: Resolved a critical, long-standing bug where database locks (lock_db) caused the global toolbar to freeze. Critical navigation functions—such as "Home" and "Admin/Config"—now remain accessible, allowing users to safely unlock databases without forced browser refreshes.
  • Dynamic Component Integration: Restored the critical logic for "New Record" generation, ensuring that the system correctly detects and triggers the typeofrecord.tab workflow.

MARC Standards & Interoperability

  • MARC Indicator Support: Added native support for the MARC Indicator (IND) field type within the FDT and validation engine. The system now permits having an Indicator 1 and a Subfield 1 within the same field, building fully MARC21-compliant strings.

MARC Indicator Support

  • Database Standardization: Template databases for MARC and RDA (across English, Spanish, and Portuguese locales) have been standardized to conform to the new tab-based layout system.
  • File Normalization: All .par and .fst configuration files have been standardized across example database models.

Modernized File Management & Uploads

  • AJAX-Driven Uploads: Introduced a centralized upload system via UploadRenderer featuring a drag-and-drop modal, background AJAX processing, a visual progress bar, and full localization support.

alt text alt text alt text

  • Directory Management: Users can now create target folders directly from the management interface, allowing files to be uploaded into exact subdirectories dynamically resolved by database paths. alt text

System Administration Enhancements

  • Profile Editor Refactoring: The user profile editor (profile_edit.php) was completely overhauled to modernize UI and JavaScript behaviors. The new layout incorporates tabbed navigation, dynamic accordions with real-time badge counts, and grouped checkbox grids for managing permissions across databases, formats, and worksheets.

alt text

  • Path Macros: Added native support for the %path_database% constant within .par files, allowing administrators to point to relative paths for external databases directly from the core configuration (e.g., rda.*=%path_database%rda/data/rda.*).

alt text

  • Inline Subfields Toggle: Introduced a new global configuration option SUBFIELDS_INLINE (Y/N) in the database settings to let administrators choose whether grouped subfields are displayed inline or managed via a pop-up window.

alt text

🛠 Technical Refactorings (Under the Hood)​

  • PFT Layout Modernization: Refactored pft.php to replace table-based formatting with modern div/flex structures, while standardizing and simplifying client-side JavaScript functions.
  • Code Modularization: Procedural field rendering logic in dibujarhojaentrada.php was completely replaced by a structured object-oriented architecture utilizing dedicated helper and renderer classes (CalendarHelper, SubfieldHelper, RepeatableRenderer, etc.).
  • Unified UI Indicators: Embedded CSS loaders were replaced by a centralized, universal loading spinner component (inc_wait.php), reducing code duplication across background operations.
  • Print-Media Queries: Implemented specialized CSS print-media queries for the statistics module, ensuring clean report generation by automatically hiding administrative panels during PDF export or printing.
  • Asset Integration: Included the Sortable.js library to support seamless client-side drag-and-drop row reordering within the data entry module.
  • PHP 8.2 Compatibility: Hardened array index validations and variable initializations across core scripts to ensure full compatibility with PHP 8.2 and prevent deprecation notices.
  • Atomic Concurrency Locks: Automated record increment routines were refactored to use exclusive, atomic flock() execution on control_number.cn, preventing data corruption from race conditions during concurrent cataloging.