Skip to content

Commit 5708d05

Browse files
rogercguirogercgui
authored
Merge pull request #1 from ABCD-DEVCOM/update-blog
Update the blog to store the ABCD release log. During these almost 18 years, much information has been lost; this documentation aims to centralize all information relevant to the software's development. Older information will be retroactively added as it is found and compiled.
2 parents 457dfa8 + c605592 commit 5708d05

15 files changed

+350
-11
lines changed

‎blog/2010-02-01-isis-history.md‎

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,7 @@
11
---
22
slug: isis-history-and-technical-background
33
title: Some ISIS-Software History and Technical Background
4-
authors:
5-
- name: Egbert de Smet
6-
title: University of Antwerp
7-
url: https://github.com/ABCD-DEVCOM
8-
image_url: https://github.com/ABCD-DEVCOM.png
4+
authors: [edsz14]
95
tags: [history, architecture, cisis, nosql]
106
date: 2010-02-01
117
---
@@ -16,7 +12,7 @@ In this article, we describe the ISIS-software origins of the ABCD software. Man
1612

1713
**Editor's Note:** *This article was originally published in LIBER QUARTERLY 19 (3/4), February 2010. It serves as the foundational manifesto for the ABCD project.*
1814

19-
---
15+
{/* truncate */}
2016

2117
## The Origins of the ISIS Software
2218

‎blog/2025-09-06-release-v2.3.0.md‎

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,6 @@ authors: [fho4abcd]
55
tags: [release, v2.3.0]
66
---
77

8-
Overview of > 650 commits since version v2.2.0-beta-1
9-
10-
<!-- truncate -->
11-
128
### Overview of > 650 commits since version v2.2.0-beta-1
139

1410
Major functional improvements:
@@ -27,6 +23,8 @@ Other improvements:
2723
- Many small functional improvements in menus/buttons/layout
2824
- Improved generated HTML and solved small bugs
2925

26+
<!-- truncate -->
27+
3028
### Prerequisites
3129
This ABCD version is already tested on PHP 8.4. Will still run on PHP 7.4, recommendation is to upgrade to at least PHP 8.1.
3230
Note that Z3950 requires the YAZ extension for PHP. YAZ is not available for every PHP version.

‎blog/2025-09-15-release-2-3-2-status-2025-09-15-better.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
slug: release-2-3-2-status-2025-09-15-better
3+
title: Release 2.3.2 Status 2025-09-15 better
4+
authors: [fho4abcd]
5+
tags: [release, v2.3.2]
6+
---
7+
8+
### Major Changes
9+
- Corrections for PHP version in Site
10+
- Improve speed of version check in the upgrade process.
11+
- Improve editing of Opac facets
12+
- New look of screen "Configuration ABCD"
13+
- Improvement of OPAC in the back-end and front-end.
14+
15+
### Actions by database administrator
16+
- Check value of new parameter "Check version of ABCD?" (internal:CHECK_VERSION) in the ‘Other’ tab in the ABCD settings.
17+
18+
<!-- truncate -->
19+
20+
### Upgrading
21+
The new and modified files can overwrite existing files Note that some files can be deleted (See Pull Requests for details)
22+
23+
The new Upgrade tool is still in the development phase: Will become available in a next release.
24+
If you use it now: _Take sufficient precautions (e.g. backups). Data loss and/or code mismatches may occur by using it now._

‎blog/2025-09-16-release-2-3-3-status-2025-09-16.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
slug: release-2-3-3-status-2025-09-16
3+
title: Release 2.3.3 Status 2025-09-16
4+
authors: [fho4abcd]
5+
tags: [release, v2.3.3]
6+
---
7+
8+
This release improves the captcha on the login page.
9+
File version.php contains the correct tag for this release.
10+
11+
### Upgrade
12+
Copy the changed files over the existing files. No further action for this release.
13+
14+
The new Upgrade tool is still in the development phase: Will become available in a next release.
15+
If you use it now: _Take sufficient precautions (e.g. backups). Data loss and/or code mismatches may occur by using it now._

‎blog/2025-09-17-release-2-3-4-status-2025-09-17-update-manager-tool.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
---
2+
slug: release-2-3-4-status-2025-09-17-update-manager-tool
3+
title: "Release 2.3.4 Status 2025-09-17: Update Manager Tool"
4+
authors: [fho4abcd]
5+
tags: [release, v2.3.4]
6+
---
7+
8+
## What's Changed
9+
This update definitively implements the ABCD update system.
10+
Now, with this installation, you will see a yellow banner with each release.
11+
12+
The available options are:
13+
- Partial update: will only update the system, preserving your databases and local settings.
14+
- Full update: the entire system will be reset, including the model databases.
15+
More info in pull request Update manager by @rogercgui in https://github.com/ABCD-DEVCOM/ABCD/pull/567
16+
17+
<!-- truncate -->
18+
19+
### Upgrade
20+
21+
Copy the changed files over the existing files. No further action for this release.
22+
23+
The current Upgrade tool is still in the development phase: In a next release you can use the tool that is installed in this release.
24+
If you use it now: _Take sufficient precautions (e.g. backups). Data loss and/or code mismatches may occur by using it now._

‎blog/2025-09-24-release-2-3-5-new-option-to-sort-database-records.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
---
2+
slug: release-2-3-5-new-option-to-sort-database-records
3+
title: "Release 2.3.5 New option to sort database records"
4+
authors: [fho4abcd]
5+
tags: [release, v2.3.5]
6+
---
7+
8+
### Major changes
9+
Database records could be sorted with command line utility msrt.
10+
This improvement adds an interactive capability in menu Utilities -> DB Maintenance.
11+
Defaults can be set in the Advanced database settings (dr_path.def)
12+
13+
<!-- truncate -->
14+
15+
### Details
16+
- Best results are obtained by using the Principal entry tag as sort key. But this is not mandatory. Other tags will also work.
17+
- Existing batch scripts combined the sort with additional operations in order to get better results. This new option offers buttons for these operations. E.g.
18+
- Preparatory action _Unlock database_
19+
- Preparatory action _Clean/Compact DB_
20+
- Follow-up actions _Inverted file generation_. Note that **search** indexes will give **wrong results** when the inverted files are not regenerated.
21+
- The commandline utility does not perform an extensive error check. Major errors return sometimes an incomprehensible error code. Advice is to look at the formatting language.
22+
- The current source does NOT use parameter _-mfn_. Implies that the .xrf file and the .mst file are modified. See source code for details
23+
24+
### Actions by database administrator
25+
The new option works without any administrator actions.
26+
In order to avoid mistakes by the operators the administrator can set defaults for the entries of the Sort option by editing file **dr_path.def** for **each** database that might need it. This can be done interactively with via _Update database Definitions_ --> _Advanced database settings (dr_path.def)_. Check values of:
27+
28+
- Sort database records key length (_SORTLENGTH_)
29+
- Sort database records by (_SORTBY_)
30+
- Specification of the sort key (_SORTSPEC_)
31+
32+
### Upgrade
33+
The new and modified files can overwrite existing files.
34+
35+
Th Upgrade tool can be tested.

‎blog/2025-09-30-release-2-3-6-more-robust-upgrade-manager.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
slug: release-2-3-6-more-robust-upgrade-manager
3+
title: "Release 2.3.6 More robust upgrade manager"
4+
authors: [fho4abcd]
5+
tags: [release, v2.3.6]
6+
---
7+
8+
## Major changes
9+
The upgrade manager has now several checks to cope with error situations.
10+
11+
<!-- truncate -->
12+
13+
The search by A-Z list gives now information how to repair erroneous configuration
14+
### Details of upgrade manager checks
15+
- Added log file. Is overwritten on next run.
16+
- Activated check for admin rights: user must have profile "adm"
17+
- Check that php zip extension is loaded.
18+
- Check download and unzip result. Tested with insufficient disk quota
19+
- Check that all required sources are present in the package before actual update
20+
- Detect and log run-time errors in actual update. Tested with wrong permissions
21+
### Actions by database administrator
22+
None

‎blog/2025-10-06-release-2-4-0-major-changes-and-implementations-in-opac.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
slug: release-2-4-0-major-changes-and-implementations-in-opac
3+
title: "Release 2.4.0 Major changes and implementations in OPAC"
4+
authors: [fho4abcd,rogercgui]
5+
tags: [release, v2.4.0]
6+
---
7+
8+
## What's Changed
9+
**Description**: Major changes and implementations in OPAC by @rogercgui in https://github.com/ABCD-DEVCOM/ABCD/pull/570
10+
11+
<!-- truncate -->
12+
13+
**Full Changelog**: https://github.com/ABCD-DEVCOM/ABCD/compare/v2.3.6...v2.4.0
14+
15+
## Actions by database administrator
16+
The upgrade of the code can be done with the upgrade manager.
17+
18+
For Windows users: copy a new executable
19+
...\www\cgi-bin_Windows\utf8\bigisis\ifkeys.exe to
20+
...\www\cgi-bin\utf8\bigisis\\ifkeys.exe
21+
22+
There are also many updates in the database examples. See the Full Changelog. Copy as appropriate

‎blog/2025-10-09-release-2-4-1-improve-update-manager-and-solve-small-bugs.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
---
2+
slug: release-2-4-1-improve-update-manager-and-solve-small-bugs
3+
title: "Release 2.4.1 Improve update manager and solve small bugs"
4+
authors: [fho4abcd,rogercgui]
5+
tags: [release, v2.4.1]
6+
---
7+
8+
## What's Changed
9+
Update_manager:
10+
- Check that php curl extension is loaded.
11+
- Copy also cgi-bin subfolders ansi and utf8. Set executable permissions on executables
12+
- Print the log file timestamp in the server timezone (only on linux servers)
13+
Version_checker:
14+
- Moved json file to upgrade folder
15+
- Corrected repository name (ABCD2->ABCD)
16+
17+
<!-- truncate -->
18+
19+
See all changed files for more details
20+
21+
### Actions by database administrator
22+
23+
The upgrade of the code can be done with the upgrade manager.

‎blog/2025-11-25-v3-0-0-major-upgrade-for-opac.md‎

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
slug: v3-0-0-major-upgrade-for-opac
3+
title: "v3.0.0 Major upgrade for OPAC"
4+
authors: [fho4abcd,rogercgui]
5+
tags: [release, v3.0.0]
6+
---
7+
8+
## What's Changed
9+
**Description**: Major changes and implementations in OPAC by @rogercgui in
10+
- https://github.com/ABCD-DEVCOM/ABCD/pull/574
11+
- https://github.com/ABCD-DEVCOM/ABCD/pull/577
12+
13+
14+
<!-- truncate -->
15+
16+
17+
**Details**
18+
* Enhance session management & small bug by @fho4abcd in https://github.com/ABCD-DEVCOM/ABCD/pull/572
19+
* Update test/wxis.php by @fho4abcd in https://github.com/ABCD-DEVCOM/ABCD/pull/573
20+
* Opac v2 by @rogercgui in https://github.com/ABCD-DEVCOM/ABCD/pull/574
21+
* Improvements to dbadmin by @rogercgui in https://github.com/ABCD-DEVCOM/ABCD/pull/575
22+
* Update ABCD login/logout for OPAC directory structure by @fho4abcd in https://github.com/ABCD-DEVCOM/ABCD/pull/576
23+
* Opac v2 by @rogercgui in https://github.com/ABCD-DEVCOM/ABCD/pull/577
24+
* Plasters for annoying behavior by @fho4abcd in https://github.com/ABCD-DEVCOM/ABCD/pull/578
25+
* Update version.php by @fho4abcd in https://github.com/ABCD-DEVCOM/ABCD/pull/579
26+
* Fixes concatenation error for Linux. by @rogercgui in https://github.com/ABCD-DEVCOM/ABCD/pull/580
27+
28+
29+
**Full Changelog**: https://github.com/ABCD-DEVCOM/ABCD/compare/v2.4.1...v3.0.0
30+
31+
## Actions by database administrator
32+
The upgrade of the code can be done with the upgrade manager.
33+
34+
There are also many updates in the database examples. See the Full Changelog. Copy as appropriate
35+
36+
## Info for all users
37+
OPAC is now the application that opens if you enter the default URL.
38+
Open ABCD by the default URL + /admin
39+
You can add a button in OPAC to switch to ABCD.

0 commit comments

Comments
 (0)