January 2022 - Koha-devel - lists.koha-community.org

Time to translate: string freeze to prepare Koha 20.11.14 has begun
by Victor Grousset/tuxayo 18 Jan '22

18 Jan '22

Hi, String freeze is into effect as of now for the 20.11.x maintenance branch. This means it's the right time to head over to the translation platform: https://translate.koha-community.org/projects/ Reminder: if you add or change a translation in version 20.11, then you must also copy it to 21.05 and 21.11. Otherwise your work will be lost for future versions. Happy translating :) -- Victor Grousset/tuxayo

1 0

Can't locate object method "output_with_http_headers" via package "CGI"
by Michael Kuhn 13 Jan '22

13 Jan '22

Hi Our library uses a non-Koha Perl script to authenticate with Divibib Onleihe (a digital distributor like Overdrive). The script worked with Koha 18.05 but after the update to Debian 11 with Perl 5.032001 und Koha 21.11.01 the following error appears: Can't locate object method "output_with_http_headers" via package "CGI" at /usr/share/koha/opac/cgi-bin/opac/onleihe_auth.pl line 91. The script file actually contains these lines (among others): use CGI; use XML::Simple; use Koha::Patrons; use Koha::AuthUtils qw(hash_password); use Digest::MD5 qw(md5_base64); use C4::Output; use C4::Context; my $query = new CGI; ... output_with_http_headers $query, undef, $xml, 'xml'; Can anyone please give me a hint how to solve this problem? Best wishes: Michael -- Geschäftsführer · Diplombibliothekar BBS, Informatiker eidg. Fachausweis Admin Kuhn GmbH · Pappelstrasse 20 · 4123 Allschwil · Schweiz T 0041 (0)61 261 55 61 · E mik(a)adminkuhn.ch · W www.adminkuhn.ch

3 3

Call for news - Newsletter January 2022
by Michael Kuhn 13 Jan '22

13 Jan '22

Hi I'm collecting news for the January 2022 Koha Community Newsletter. Please send anything noteworthy to: kohanews (at) gmail (dot) com News criteria: * News items can be of any length. * Images are fine. * Anything and everything Koha. * Submit by the 26th of the month. Text format criteria: * Just structured plain text, or * HTML text to include tables or similar For events: * Consider adding your event to the Koha Community calendar at https://koha-community.org/calendar/ Thank you! Michael Kuhn Editor, Koha Community Newsletter -- Geschäftsführer · Diplombibliothekar BBS, Informatiker eidg. Fachausweis Admin Kuhn GmbH · Pappelstrasse 20 · 4123 Allschwil · Schweiz T 0041 (0)61 261 55 61 · E mik(a)adminkuhn.ch · W www.adminkuhn.ch

1 0

Opening bids for KohaCon22
by Katrin Fischer 12 Jan '22

12 Jan '22

Hello dear Koha community, another year is coming to an end. It's time to turn our attention to the new year that's coming up, full of possibilities! If you or your organization would like to organize KohaCon22, please enter all relevant information on this wiki page: https://wiki.koha-community.org/wiki/KohaCon22_Proposals (if you do not already have an account to edit the wiki, you can request one, it is usually pretty fast to get access). The community has agreed that KohaCon conferences must be either hybrid with an in-person conference streamed online, or entirely online. Apart from keeping the community members safe, this will also allow for greater accessibility, so that everyone can attend and learn from each other no matter their availability, ability to travel, or budget. Know that the community stands behind anyone who volunteers to organize and that help is always available if you're unsure how to proceed. Call for proposals will end on January 8, 2022 at 23:59 UTC. If there is more than one proposal, we will organize a vote, which will be announced on this mailing list. Best regards, Katrin

2 1

General IRC Meeting 12 January 2022
by Fridolin SOMERS 12 Jan '22

12 Jan '22

See you at : https://wiki.koha-community.org/wiki/General_IRC_meeting_12_January_2022 -- Fridolin SOMERS <fridolin.somers(a)biblibre.com> Software and system maintainer 🦄 BibLibre, France

1 0

Reusable barcode?
by Waylon Robertson 11 Jan '22

11 Jan '22

Is there a way to use a barcode multiple times, as a category/tag on checkin/out? A toy library would like to just have categories like 'Game', 'vehicle', 'book', etc, and to scan those, instead of barcoding each item individually. How would this work?

3 2

Resultsets vs. list context
by Tomas Cohen Arazi 10 Jan '22

10 Jan '22

Hi, let me tell you a short and (technical but) interesting story. Most of you might know about this, but I found it could be useful to know and/or to refresh. DBIC has a nice property that our Koha::Objects inherited (obviously): you can chain calls like this: Koha::Patrons->search( $filter_1 )->search( $filter_2 )->search( $filter_3 )->...; We recently agreed (not sure there is a coding guideline) that if we wanted to provide high-level methods to encapsulate such filters, we would call those methods 'filter_by_*' unless the context suggests a better name. So we could, in theory do something like: my $cool_old_books = Koha::Biblios->search( $some_initial_filter ) ->filter_by_older_than({ years => 30 }) ->filter_by_coolness(); So far, so good :-D But then, we have another (cool) method in Koha::Objects: _new_from_dbic. This method allows us to, given a DBIC relationship, convert the linked resultset into the proper Koha::Object(s)-based class. For example: my $patron_checkouts = $patron->checkouts; in this case, the actual code is pretty simple thanks to _new_from_dbic: sub checkouts { my ($self) = @_; my $checkouts = $self->_result->issues; return Koha::Checkouts->_new_from_dbic( $checkouts ); } Methods like ->search behave consistently to what DBIC does, and as such, they honor list context. This is: my $scalar = Koha::Patrons->search(filter); my @list = Koha::Patrons->search($filter); will do what you think: $scalar will be an object, representing a resultset, and @list will be the actually fetched list of results from the search, as a list. But there's a catch. And we need to be aware of that and there is an ongoing discussion about it: _new_from_dbic doesn't honor list context [1]. This means when you code, you need to go look if the method you're calling is _new_from_dbic-based, or ->search based [2]. This is not cool. @checkouts = $patron->checkouts; # doesn't do what you expect! @checkouts = $patron->checkouts->filter_by_overdue; # this does if ->search based. Our codebase is full of places in which we either call ->as_list in our resultsets (because something exploded if we didn't, for example): my @checkouts = $patron->checkouts->as_list; or in which we explicitly call `scalar the_thing' so we are sure things are evaluated in scalar context because we want the resultset instead (for example, when passing params to a template): $template->param( checkouts => scalar $patron->checkouts ); I proposed we make ->_new_from_dbic and ->empty honor list context and hence making our methods consistent (can be seen by the referenced bugs). But we found a nasty problem: calling methods in Template::Toolkit internally assigns them to a global stash which is implemented as a hash (a.k.a. list context :-D). So, you will find that 'some' things are calculated on the controller (.pl) scripts and then passed to the templates (to overcome this), and some others are calculated directly in the templates. Now you know the reason we've introduced those things over the years in the codebase. So, making _new_from_dbic honor list context, opens a big can of worms in the template front. We explored the idea of using a different Template::Toolkit stash, that honors scalar context, but the author has marked it as experimental, and it would still require changing many things in the templates. The tradeoff doesn't lean towards that path. The conclusion so far is that we should drop support for list context. Hence, my suggestion as developer and QA team member is: TL;DR Make use of ->as_list when you have a resultset really need list context like in: foreach my $item ( @{$items->as_list} ) { ... } grep { filter($_) } @{@libraries->as_list} my @biblios = $biblios->as_list; and so on. This will save you some headaches (in some cases) and will make your code survive this upcoming change. We should start enforcing this in the QA step as well, so adjust your code for this. Once we remove wantarray, things will explode on their own. Best regards [1] https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28883 [2] There is also Koha::Objects->empty, actually. That presents the same problem as _new_from_dbic. https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28871 -- Tomás Cohen Arazi Theke Solutions (http://theke.io) ✆ +54 9351 3513384 GPG: B2F3C15F

2 1

New class: Koha::Result::Boolean
by Tomas Cohen Arazi 07 Jan '22

07 Jan '22

Hi all, happy 2022 :-D I wanted to mention that a bug that introduces Koha::Result::Boolean has been pushed [1]. This class provides a way to return an object, that evaluates to a boolean in (Perl's) bool context but also carries reasons for the result. It has been used in a couple places, like bug 29765 [2] and bug 29788 [3] (which still needs the QA step). [1] https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29746 [2] https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29765 [3] https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=29788 -- Tomás Cohen Arazi Theke Solutions (http://theke.io) ✆ +54 9351 3513384 GPG: B2F3C15F

2 1

Dev meeting 5 January 2022 report
by Fridolin SOMERS 06 Jan '22

06 Jan '22

Hi, Here is Dev meeting 5 January 2022 report : https://wiki.koha-community.org/wiki/Development_IRC_meeting_5_January_2022 Next dev meeting : https://wiki.koha-community.org/wiki/Development_IRC_meeting_19_January_2022 There is also a general meeting soon : https://wiki.koha-community.org/wiki/General_IRC_meeting_12_January_2022 See you around :D Best regards, -- Fridolin SOMERS <fridolin.somers(a)biblibre.com> Software and system maintainer 🦄 BibLibre, France

3 2

Koha 19.11.24 released
by Wainui Witika-Park 05 Jan '22

05 Jan '22

Hello everyone! The Koha community is proud to announce the release of version 19.11.24. The full release notes can be found at: https://koha-community.org/koha-19-11-24-released/ Thank you to everyone involved! Cheers, Wainui Witika-Park (she/her)

1 0