c4ef8aaead
(cherry picked from commit 65ac4e38ab)
Signed-off-by: Galen Charlton <gmcharlt@gmail.com>
439 lines
21 KiB
Text
439 lines
21 KiB
Text
==============================================================================
|
|
RELEASE NOTES FOR KOHA 3.0.2
|
|
==============================================================================
|
|
Koha 3 is the next-generation release of the award-winning Koha open-source
|
|
integrated library system.
|
|
|
|
You can obtain Koha 3.0.2 from the following URL:
|
|
|
|
http://download.koha.org/koha-3.00.02.tar.gz
|
|
|
|
These Release Notes cover What's New in Koha 3, information about the new
|
|
Revision control system (Git), and Version-release process, pointers to
|
|
Download, Installation, and Upgrade documentation, a brief introduction to the
|
|
new Templates, a call to Translation and Documentation writers, and finally,
|
|
Known Issues with this version.
|
|
|
|
==============================================================================
|
|
WHAT'S NEW IN KOHA 3?
|
|
==============================================================================
|
|
|
|
1. Zebra plugin - Zebra is a high-performance, general-purpose structured
|
|
text indexing and retrieval engine. It supports large data sets (tens of
|
|
millions of records) and includes support for SRU, Z39.50 and several query
|
|
languages: CCL, CQL, and PQF. For more information about Zebra, please see:
|
|
|
|
http://indexdata.dk/zebra
|
|
|
|
Koha's new search engine, built on top of Zebra, supports features such as
|
|
relevance ranking, field weighting, truncation, stemming, use of fuzzy
|
|
operators, language-specific indexing, sorting, etc.
|
|
|
|
Indexes are updated in real-time with circulation transactions, enabling
|
|
limits by availability and statuses.
|
|
|
|
Faceted refine-by limits are available from both staff and opac interfaces.
|
|
|
|
For libraries that don't want the overhead of maintaing Zebra, Koha 3 ships
|
|
with a NoZebra option, in which bibliographic and authority data is indexed
|
|
in the RDBMS.
|
|
|
|
2. New installer - based on the common Perl module ExtUtils::MakeMaker, the
|
|
new installer makes it a snap to get Koha running on just about any platform.
|
|
|
|
The installer comes complete with a Developer's Toolkit target ('dev') that
|
|
can be used to get a development environment linked directly to revision
|
|
control, to support rapid prototyping and an agile development process.
|
|
|
|
3. Standard APIs - Koha 3 supports a number of important library search and
|
|
retrieval standards and microformats, such as SRU/W, Z39.50
|
|
(http://www.loc.gov/standards/sru/), UnAPI (http://unapi.info/) and
|
|
COinS/OpenURL
|
|
(http://ocoins.info; http://www.niso.org/committees/committee_ax.html).
|
|
|
|
Also supported is the popular Internet standard: OpenSearch
|
|
(http://opensearch.a9.com/) created by Amazon's A9.
|
|
|
|
Records are stored internally in an SGML-like format and can be retrieved in
|
|
MARCXML, Dublin Core, MODS, RSS, Atom, RDF-DC, SRW-DC, OAI-DC, and EndNote;
|
|
and the OPAC can be used by citation tools such as Zotero. Creating new
|
|
export formats is a trivial exercise in writing XSLT; records can be passed
|
|
through XSLT transformations either directly out of the index, or via a
|
|
separate parsing function.
|
|
|
|
To retrieve and interact with Circulation and Patron data, Koha 3 includes
|
|
support for 3M's Standard Interchange Protocol (SIP2), using the OpenNCIP
|
|
libraries (http://openncip.org).
|
|
|
|
There are also an ever-expanding set of native REST APIs to handle
|
|
interoperability with external tools such as third-party cataloging clients.
|
|
These APIs provide authentication as well as add/edit/delete control over
|
|
bibliographic data within a Koha system. For more information, see:
|
|
|
|
http://wiki.koha.org/doku.php?id=en:development:web_services
|
|
|
|
Koha 3 also includes pluggable authentication - easy integration with LDAP and
|
|
Active Directory via the Auth_with_ldap module.
|
|
|
|
Enriched content web services, such as those offered by Amazon.com, Baker and
|
|
Taylor's Content Cafe, and the Google Book API can be enabled to enrich
|
|
bibliographic content with jacket covers, professional reviews, ratings and
|
|
comments from users, as well as point to 'Similar Items' within the catalog.
|
|
OCLC's xISBN, and LibraryThing's ThingISBN an likewise be enabled to provide
|
|
an 'Editions' tab, pulling together all the formats, languages, and editions
|
|
of a work into the item detail pages. New with Koha 3 is service throttling
|
|
for these services, to keep within subscription limits.
|
|
|
|
4. Cross-platform, multi-RDBMS, Web-server agnostic - Run Koha on the platform
|
|
of your choice: Linux, Windows, Mac OS X, FreeBSD, Solaris. Koha 3 also
|
|
includes better support for multi-RDBMS (MySQL 5.0 and PostgreSQL), and runs
|
|
under Apache2, IIS, or the web server of your choosing.
|
|
|
|
5. Multi-lingual support - Koha was designed from the ground up for multilingual
|
|
libraries. Koha 3 can handle Chinese, Japanese, and even right-to-left languages
|
|
such as Arabic and Hebrew with ease (BiDi).
|
|
|
|
Koha's index engine (Zebra) can handle record formats containing any UNICODE
|
|
compliant script, such as Arabic, Chinese, Hebrew, Japanese and Korean. Zebra
|
|
has this support via the ICU libraries created and maintained by IBM.
|
|
|
|
You can translate Koha into your language using the built-in translation tools,
|
|
or by visiting http://translate.koha.org.
|
|
|
|
6. New templates - Koha's staff and patron interfaces are developed with a
|
|
template system that's easy to theme. The default templates are composed of 100%
|
|
valid XHTML and CSS. Koha aims to meet or exceed U.S. Government Section 508 and
|
|
W3C's WAI-AA standards for sight and motor impaired individuals. All
|
|
Javascript usage comes with fallback modes that work in any web browser.
|
|
|
|
7. Koha 3 has quite a few new modules, as well as enhancements to existing
|
|
modules, including: news writer, label creator, calendar, OPAC comments, MARC
|
|
staging and overlay, notices, transaction logs, guided reports with a data
|
|
dictionary and task scheduler, classification sources/filing rules, and more!
|
|
|
|
==============================================================================
|
|
REVISION CONTROL
|
|
==============================================================================
|
|
|
|
With Koha 3, we've started using a new distributed revision control system
|
|
called Git; it's the same system in use by many other projects, including the
|
|
Linux Kernel. To learn more about how to develop Koha using Git, please see
|
|
the Wiki page:
|
|
|
|
http://wiki.koha.org/doku.php?id=en:development:git_usage
|
|
|
|
==============================================================================
|
|
VERSION NUMBERING
|
|
==============================================================================
|
|
|
|
With Koha 3, version numbering has been changed to use a method similar to
|
|
Perl's:
|
|
|
|
major.minor[.revision[.build]]
|
|
|
|
* major: one digit
|
|
* minor: two-digit
|
|
* revision: two-digit
|
|
* build: three-digit
|
|
|
|
This release of Koha 3.00.02 is versioned 3.00.02.012. Every database change
|
|
or significant enough code change requires an update to the 'build' number,
|
|
and developers will be able to easily upgrade their systems using the built-in
|
|
updater.
|
|
|
|
Koha 3.0.2 Release :
|
|
|
|
This release of Koha 3.0.2 includes the following general improvements over
|
|
the previous release:
|
|
|
|
xslt support for UNIMARC added
|
|
UNIMARC support for search available items only and weight field
|
|
better IE7 support for intranet
|
|
Show Summary in opac results
|
|
opac-browser
|
|
Serial subscription report
|
|
translations improved
|
|
|
|
|
|
Complete list follows :
|
|
Fixes Bug 3043: Followup.
|
|
Bug 3245: advancedMARCeditor syspref not returning to cataloguing tab
|
|
Bug 2266: Could not uncollapse a tag if you turn on advancedMARCeditor.
|
|
BUG FIXING : opac-browser wouldnot display anything.
|
|
Bug 3162 Fix only for [3.0.x]
|
|
bug 2908 followup - use "list", not "shelf"
|
|
(bug #3080) fix the acqui/spent.pl
|
|
(bug #3079) show summary in opac results
|
|
(bug #1578) fix a little error in code
|
|
bug 988 followup - tweak wording
|
|
bugfix stickyduedate more sticky - couple more forms in circulation.tmpl
|
|
bugfix stickyduedate more sticky - also patron search in quick search block
|
|
Bugfix 3176 - Browser selected languages are not use by OPAC
|
|
(bug #3196) fix itemlost.pl
|
|
Bug 1984 - added Javascript in the header to open, print, and close the slip window
|
|
bug 1907 Partial fix: prevent bad records from truncating output.
|
|
bug 3212: MARC21 bib leader plugin sets Leader/09 to 'a'
|
|
bug 3211: fix XHTML validation errors in MAR21 bib leader plugin
|
|
bug 3209: add 'p' (mixed materials) to MARC21 Leader/06 dropdown
|
|
(bug #3198) fix serial receive with autobarcode
|
|
Bug 3213 - UNIMARC/MARC21 selection
|
|
Bug 3213 - Add UNIMARC XSLT stylesheet
|
|
More fixes for Bug 2704, 440 Display Issues
|
|
bug 3195 : Item Transfers and Holds disrupted.
|
|
Revert "(bug #3025) multiple check-in of a multiple times reserved item go wrong"
|
|
(bug #3190) allow right truncation in lot of records
|
|
(bug #3174) show the member name in reports
|
|
bug 2287: handle case where autoMemberNum is off
|
|
Allow autogenerated cardnumbers again to solve http://bugs.koha.org/cgi-bin/bugzilla3/show_bug.cgi?id=2287
|
|
(bug #3183) fix the SetMarcUnicodeFlag function
|
|
Add system preference search to administration home page (Bug 3181)
|
|
Bugfix 3199 - batchRebuildBiblioTables.pl failed due to missing argument [3.0.x]
|
|
Bug 2944 fix courtesy of Amr Denni
|
|
(bug #3197) Subfield code box was not present on new subfield tab in Admin/Authority
|
|
Bug 3081 - The category code in the patron personal details page in opac showed the category code and not the description. This patch makes the description appear instead. Looking at both opac-userupdate.pl and opac-userupdate.tmpl, the actual value of this text box is not retrieved for any purpose.
|
|
(bug #3193) fix the comtd value in acqui-home.pl
|
|
Bug 3157: IE compatibility for label display
|
|
(bug #2750) Cannot return to another branch if the independantbranch option is set as ON
|
|
bug 2687 followup: Increase maxlength attribute to support 64 characters
|
|
Bug 3177 - haspermission offers bogus option
|
|
bug 3141: use quoted printable encoding in cart/list emails
|
|
bug 2908 followup - use "list", not "shelf"
|
|
Corrected: fix for Bug 3112, Emailed list contains too much whitespace
|
|
(bug #3187) authority search pagination doesn't work
|
|
(bug #3058) show items that are excluded of loan in search results
|
|
(bug #3057) mandatory subfield edition
|
|
(bug #3053) extract ISBD view generator, and permit to display valuecode in ISBD view
|
|
(bug #3051) bad support of pagination in auth_finder
|
|
(bug #3025) multiple check-in of a multiple times reserved item go wrong
|
|
(bug #3011) csv export doesn't fill all the fields
|
|
(bug #2939) delete a warning
|
|
(bug #2938) add a serials subscriptions report
|
|
(bug #2908) adding send shelf by e-mail feature
|
|
Bug fix to OPAC shelf browsing query statement
|
|
Adding warnings, fixing a bug that meant the title of an item that had a fine was never printed
|
|
Bug #2974 Adding category code to BorrowerMandatoryField produced a "The following fields are mandatory: categorycode"
|
|
(bug #3174) fill borrower number, and show author and creation date in saved reports
|
|
minPasswordLength not returning user back to systempreferences.pl?tab=Patrons. Incorrect reference MinPasswordLength fixed. Could not find bug report.
|
|
Bug 3126: remove comma for IE7
|
|
Bug 2505 adding warnings to opac-authorities-home and fixing warnings generated
|
|
Bugs 2822, 2551, 3163 fixes to XSLT
|
|
(bug #2750) Cannot return to another branch if the independantbranch option is set as ON
|
|
(bug #2961) change the workflow of the new issue
|
|
bug 2915 followup - small efficiency improvement
|
|
Bug 3114 - IE7 spacing needs width: 100% to avoid line collapse.
|
|
bug 3161: don't display blank language chooser
|
|
bug 2505: fix more warnings in opac-search.pl
|
|
Bug 2505 Adding use warnings, and fixing the warnings generated
|
|
Bug 2776 : emailPurchaseSuggestions syspref deprecated
|
|
BUG-3160: fixes 'itemlost' check on item return.
|
|
bug 3159: allow editing child patron that has no valid guarantor
|
|
bug 2505 followup: restored correct item type image display
|
|
Bug 2505: adding warnings to opac-detail.pl
|
|
Bug 3152 OPAC reading history column headers don't line up with text
|
|
Bug 3128 - followup and correction
|
|
Bug 3128: IE7 tweak
|
|
bug 1546 - replacing REPLACE statements
|
|
Bug 3118: Remove comment that perturbs IE
|
|
IE bugs 3124 and 3115: z3950 search and guided_reports
|
|
Fix for Bug 3119: Add due date to the patron circulation history window
|
|
Fix for Bug 1877, Link to patron record from manage suggestions
|
|
Bug #3101 - Changed the Print and Confirm button
|
|
Bug 2847 - Added url escaping for categorie.tmpl
|
|
Bug 2847 - Fix html escaping in categorie.tmpl (more needed)
|
|
Fix Bug #2925
|
|
Partial fix for Bug #3139
|
|
Modification on Bug # 3102 - "Location" instead of "Localization"
|
|
Update for bug 1545 allowing for the title to be edited
|
|
Change typo Localisation to Localization for Bug # 3102
|
|
Bug 3013 Fix for 007 value builder to include all material types
|
|
Allowing users to edit saved sql in guided reports. Bug 1545
|
|
Bug 3132: Reformatting guarantor entry based on C vs. P patron types
|
|
Bug 3133 - correct typos
|
|
Removing duplicate email form field. Fixes Bug 3010.
|
|
bug 2958: fix search results navigation for CCL, CQL, and PQF queries
|
|
bug 3100: increase width of alternate postal code
|
|
Multi-bug fix - SetMarcUnicodeFlag for records coming from Koha
|
|
bug: unescaped single-quote in french sys. prefs. sql file
|
|
bug 3110 - Move Serial Preferences to Serials Tab
|
|
bug 3049: display correct due date of renewed loans
|
|
Bug 2919 -- fix value_builder plugins for dateaccessioned, barcode
|
|
Partial fix for Bug 2655, "Items waiting on the hold shelf display as 'Available' in OPAC"
|
|
Bug 3090 - Add perldoc details
|
|
Fix for Bug 3095, Add to lists page doesn't redirect with no javascript
|
|
Another try at fixing Bug 2949.
|
|
Bug 3066 - Overhaul guided reports
|
|
Corrected: Hiding renew link in the OPAC for items which cannot be renewed. Fixes bug 3083.
|
|
(bug #3084) in baskets, change the isbn of column
|
|
Adding details to OPAC search results RSS, described in Bug 2973.
|
|
bug 3088: fix crash in opac-ISBDdetail.pl
|
|
Bug #3071 - Z39.50 search result highlights are mixed
|
|
BUG-1503: fixes broken matching for 'hidden' values.
|
|
(bug #3063) fix unimarc 4xx plugin with cloned field
|
|
Bug #3036 Avoid command-line installer blocking on opensolaris plateform
|
|
Minor bug fix Documentation update : 3039
|
|
Hiding labels for add to list options when user isn't logged in or options don't exist. Fixes Bug 3043.
|
|
quietens a noisy debug pop-up, when debugging
|
|
Bug 2958 - notforloan (8008) is a numeric field.
|
|
Second patch to address LL Bug 367 Titles without ISBNs display "no cover image available" while titles with ISBNS that don't match a Syndetics cover display nothing
|
|
Fix for LL bug 367 Titles without ISBNs display "no cover image available"
|
|
Bug Fix : weight field was broken in UNIMARC
|
|
bug 3028: remove reservefix.pl cronjob
|
|
Correcting delete patron button to use TMPL_VAR instead of DOM query. Fixes Bug 3014, Can't delete restricted patron from circulation screen.
|
|
Fix for Bug 3015: Check-in screen displays branch name inconsistently
|
|
Bug 2617: Add strict (and warnings), partial fix.
|
|
(bug #2863) add the borrowers branchcodes in suggestion list
|
|
(bug #2811)[3.2] fix opac-renew.pl part
|
|
bug 2904: fix display of URLs in UNIMARC
|
|
corrected patch for bug 2951
|
|
bug 2772: bad image location
|
|
Bug 2883 - longoverdue cronjob fails to implement required functionality.
|
|
Kohabug 2500 Fiction Call Number Splitting Enhancement/Bugfix
|
|
bug 2924 fixed rebuild_zebra.pl to work when export is skipped
|
|
bug 1546 - REPLACE statements
|
|
Fix for Bug 2984, Error when generating CSV output from "Generate labels for Batch" button
|
|
bug 2870, fixes non-populating of guarantor fields
|
|
Formatting changes for OPAC xslt and staff client catalog detail pages. Fixes Bug 2704, 440 Display Issues.
|
|
bug 2856 followup: remove unconditional warn
|
|
Bug 2868: fixing typo in NoZebraIndexes setting in sysprefs
|
|
bug 2860: allow setting of a syspref value to '0'
|
|
bug 2505: turn on warnings in admin/systemprefernces.pl
|
|
bug 2867 [1/2]: Move basic editing to main system preferences screen
|
|
bug 2505: enable warnings for opac/sco/sco-main.pl
|
|
bug 2857: fix UTF-8 conversion issues in web services
|
|
bug 2613: allow web self-check to accept patron ID
|
|
Some minor markup corrections to opac authorities pages. Some fixes to address Bug 2620.
|
|
Fixing a couple of bugs in the package
|
|
Revert "Fix the guided report export, bad check of errors(bug #2672)"
|
|
(bug #1758) change the position of GetCOinSBiblio()
|
|
(bug #2948) change the aqbudgetid column type
|
|
(bug #2938)[follow previous] Add new report in menus
|
|
(bug #2933) change popup names containing space chars
|
|
(bug #2929) permit to define "fine days" in issuing rules
|
|
(bug #2915) C4::Biblio::DelBiblio delete the serials
|
|
(bug #2856) Activate the duplicate patrons detection and check birthdate only if one is set
|
|
Fix the guided report export, bad check of errors(bug #2672)
|
|
bug 2540: allow download of report
|
|
(bug #2881) preselect default sorting
|
|
(bug #2996) update unimarc 105 plugin to the actual norm
|
|
(bug #2961) be xhtml valid
|
|
bug 2986: tweak authtype index for MARC21 (GRS-1)
|
|
(bug #3004) fix the opac authority search
|
|
(bug #2998) fix search sorting containing "="
|
|
(bug #2996) fix and improve 100 and 105 unimarc plugins
|
|
(bug #2995) Set a default encoding for e-mails
|
|
bug 2992: don't display MARC codes in search results
|
|
(bug #2978) fix differents bugs in marc editor
|
|
bug itemtype icons interfere with location text
|
|
bug 2971: Fixed leak by removing drop shadow instead of hiding it.
|
|
Bug 2968 - SIP ACS_STATUS message (98) misreported config.
|
|
URLs checker enhancement (bug #2959)
|
|
(bug #2962) escape searchbox, and change the search from tag clouds
|
|
(bug #2961) add a button to add manually the next issue
|
|
bug 2126: reduce round-off errors in fine balance
|
|
(bug #2957) import Date_to_Days
|
|
(bug #2956) fix 4xx plugin pagination
|
|
|
|
This release is bugfix only release, and doesnot include new
|
|
features which would require some database changes.
|
|
It does add some databases changes though but only to FIX bugs.
|
|
|
|
|
|
|
|
Note that Windows is not supported for this version as there are blockers.
|
|
|
|
Note that this version is still supporting only MySQL.
|
|
Support for PostgreSQL is still very experimental.
|
|
|
|
New features which have deep impact on code will be available in Koha 3.2
|
|
and subsequent releases.
|
|
|
|
==============================================================================
|
|
UPGRADING FROM A PREVIOUS VERSION OF KOHA
|
|
==============================================================================
|
|
|
|
The upgrade process from a previous version of Koha is documented on the Wiki
|
|
at the following page:
|
|
|
|
Upgrading from 2.2 or earlier version:
|
|
|
|
http://wiki.koha.org/doku.php?id=22_to_30
|
|
|
|
Upgrading from a previous version of 3.0:
|
|
|
|
Please consult INSTALL files for details on how to upgrade
|
|
|
|
==============================================================================
|
|
TEMPLATES
|
|
==============================================================================
|
|
|
|
You may have heard that the templates for Koha 3 have been re-skinned; there
|
|
is also the start of a template style guide on the Wiki:
|
|
|
|
http://wiki.koha.org/doku.php?id=en:documentation:templates_style_guide
|
|
|
|
Kudos to Owen Leonard and the Nelsonville Public Library for their
|
|
contributions!
|
|
|
|
==============================================================================
|
|
TRANSLATIONS
|
|
==============================================================================
|
|
|
|
Koha 3.0.2 (this release) currently has complete translations for the following
|
|
languages:
|
|
|
|
OPAC: ar-Arab (Arabic), da-DK (Danish), de-DE (German), el-GR (Greek), es-ES (Spanish), en (English),
|
|
en-NZ (New Zealand English), fr-FR (French),
|
|
hu-HU (Hungarian), it-IT (Italian), nn-NO - Norwegian Nynorsk, nb-NO Norwegian (Bokmål),
|
|
nl-NL (Dutch), pt-PT (Portuguese), tr-TR (Turkish),
|
|
ru-RU (Russian), uk-UA (Ukranian)
|
|
|
|
|
|
Staff Client: de-DE (German), el-EL (Greek), fr-FR (French), en (English),
|
|
es-ES (Spanish), it-IT (Italian), uk-UA (Ukranian),
|
|
|
|
|
|
Additionally, Koha 3.0.2 (this release) has partial translations for the following
|
|
languages:
|
|
|
|
OPAC: am-Ethi (Amharic), bg-Cyrl (Bulgarian), fa-Arab (Persian), fi-FI (Finnish)
|
|
gl (Galician), he-Hebr (Hebrew), hr-HR (Croatian), hu-HU (Hungarian), id-ID (Indonesian),
|
|
ja-Japn (Japanese), kn-Knda (kannada), ko-Kore (Korean), lo-Laoo (Laoo),
|
|
mi-NZ (Maori), pl-PL (Polish), pt-PT (Portuguese), sv-SE (Swedish),
|
|
tet (Tetum), zh-Hans-CN (Simplified Chinese in China), zh-Hans-TW (Simplified Chinese in Taiwan)
|
|
|
|
Staff Client: ar-Arab (Arabic), es-ES (Spanish), hu-HU (Hungarian),
|
|
hy-Armn (Armenian), ja-Japn (Japanese), nn-NO - Norwegian Nynorsk, nb-NO Norwegian (Bokmål),
|
|
ru-RU (Russian), tr-TR (Turkish),
|
|
zh-Hans-CN (Simplified Chinese in China), zh-Hans-TW (Simplified Chinese in Taiwan)
|
|
|
|
The Koha Team welcomes additional translations; please see
|
|
http://www.kohadocs.org/usersguide/apb.html for information about
|
|
translating Koha, and join the koha-translate list to volunteer:
|
|
|
|
http://lists.koha.org/mailman/listinfo/koha-translate
|
|
|
|
Note that I chose to release even though some words are still missing.
|
|
I apologize to translators.
|
|
I had proclaimed string freeze, but some strings were still untranslated.
|
|
You can find latest uptodate translations on Pootle : http://translate.koha.org/languages/
|
|
You can also ask for translation rights if you need.
|
|
Thank you for your patience and your work, translators.
|
|
|
|
==============================================================================
|
|
DOCUMENTATION
|
|
==============================================================================
|
|
|
|
User-contributed documentation for Koha 3 is available on the Koha Wiki
|
|
(http://wiki.koha.org). The Koha Team welcomes documentation contributions;
|
|
please join the Koha-devel list to volunteer:
|
|
|
|
http://lists.nongnu.org/mailman/listinfo/koha-devel
|
|
|
|
==============================================================================
|
|
KNOWN ISSUES
|
|
==============================================================================
|
|
|
|
Known bugs are documented on the Koha wiki: http://bugs.koha.org and at the
|
|
3.0 RM's QA notes Wiki page:
|
|
|
|
http://wiki.koha.org/doku.php?id=en:development:qanotes3.0
|