3 # This file is part of Koha.
5 # Koha is free software; you can redistribute it and/or modify it under the
6 # terms of the GNU General Public License as published by the Free Software
7 # Foundation; either version 2 of the License, or (at your option) any later
10 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
11 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
12 # A PARTICULAR PURPOSE. See the GNU General Public License for more details.
14 # You should have received a copy of the GNU General Public License along with
15 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
16 # Suite 330, Boston, MA 02111-1307 USA
19 #use warnings; FIXME - Bug 2505
22 use C4::Biblio; # GetMarcFromKohaField, GetBiblioData
23 use C4::Koha; # getFacets
25 use C4::Search::PazPar2;
27 use C4::Dates qw(format_date);
28 use C4::Members qw(GetHideLostItemsPreference);
31 use C4::Reserves; # GetReserveStatus
40 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK %EXPORT_TAGS $DEBUG);
42 # set the version for version checking
44 $VERSION = 3.07.00.049;
45 $DEBUG = ($ENV{DEBUG}) ? 1 : 0;
50 C4::Search - Functions for searching the Koha catalog.
54 See opac/opac-search.pl or catalogue/search.pl for example of usage
58 This module provides searching functions for Koha's bibliographic databases
73 &enabled_staff_search_views
77 # make all your functions, whether exported or not;
81 ($biblionumber,$biblionumber,$title) = FindDuplicate($record);
83 This function attempts to find duplicate records using a hard-coded, fairly simplistic algorithm
89 my $dbh = C4::Context->dbh;
90 my $result = TransformMarcToKoha( $dbh, $record, '' );
95 my ( $biblionumber, $title );
97 # search duplicate on ISBN, easy and fast..
99 if ( $result->{isbn} ) {
100 $result->{isbn} =~ s/\(.*$//;
101 $result->{isbn} =~ s/\s+$//;
102 $query = "isbn:$result->{isbn}";
106 $QParser = C4::Context->queryparser if (C4::Context->preference('UseQueryParser'));
112 $titleindex = 'title|exact';
113 $authorindex = 'author|exact';
116 $titleindex = 'ti,ext';
117 $authorindex = 'au,ext';
121 $result->{title} =~ s /\\//g;
122 $result->{title} =~ s /\"//g;
123 $result->{title} =~ s /\(//g;
124 $result->{title} =~ s /\)//g;
126 # FIXME: instead of removing operators, could just do
127 # quotes around the value
128 $result->{title} =~ s/(and|or|not)//g;
129 $query = "$titleindex:\"$result->{title}\"";
130 if ( $result->{author} ) {
131 $result->{author} =~ s /\\//g;
132 $result->{author} =~ s /\"//g;
133 $result->{author} =~ s /\(//g;
134 $result->{author} =~ s /\)//g;
136 # remove valid operators
137 $result->{author} =~ s/(and|or|not)//g;
138 $query .= " $op $authorindex:\"$result->{author}\"";
142 my ( $error, $searchresults, undef ) = SimpleSearch($query); # FIXME :: hardcoded !
144 if (!defined $error) {
145 foreach my $possible_duplicate_record (@{$searchresults}) {
147 MARC::Record->new_from_usmarc($possible_duplicate_record);
148 my $result = TransformMarcToKoha( $dbh, $marcrecord, '' );
150 # FIXME :: why 2 $biblionumber ?
152 push @results, $result->{'biblionumber'};
153 push @results, $result->{'title'};
162 ( $error, $results, $total_hits ) = SimpleSearch( $query, $offset, $max_results, [@servers] );
164 This function provides a simple search API on the bibliographic catalog
170 * $query can be a simple keyword or a complete CCL query
171 * @servers is optional. Defaults to biblioserver as found in koha-conf.xml
172 * $offset - If present, represents the number of records at the beggining to omit. Defaults to 0
173 * $max_results - if present, determines the maximum number of records to fetch. undef is All. defaults to undef.
178 Returns an array consisting of three elements
179 * $error is undefined unless an error is detected
180 * $results is a reference to an array of records.
181 * $total_hits is the number of hits that would have been returned with no limit
183 If an error is returned the two other return elements are undefined. If error itself is undefined
184 the other two elements are always defined
186 =item C<usage in the script:>
190 my ( $error, $marcresults, $total_hits ) = SimpleSearch($query);
192 if (defined $error) {
193 $template->param(query_error => $error);
194 warn "error: ".$error;
195 output_html_with_http_headers $input, $cookie, $template->output;
199 my $hits = @{$marcresults};
202 for my $r ( @{$marcresults} ) {
203 my $marcrecord = MARC::File::USMARC::decode($r);
204 my $biblio = TransformMarcToKoha(C4::Context->dbh,$marcrecord,q{});
206 #build the iarray of hashs for the template.
208 title => $biblio->{'title'},
209 subtitle => $biblio->{'subtitle'},
210 biblionumber => $biblio->{'biblionumber'},
211 author => $biblio->{'author'},
212 publishercode => $biblio->{'publishercode'},
213 publicationyear => $biblio->{'publicationyear'},
218 $template->param(result=>\@results);
223 my ( $query, $offset, $max_results, $servers ) = @_;
225 return ( 'No query entered', undef, undef ) unless $query;
226 # FIXME hardcoded value. See catalog/search.pl & opac-search.pl too.
227 my @servers = defined ( $servers ) ? @$servers : ( 'biblioserver' );
235 $QParser = C4::Context->queryparser if (C4::Context->preference('UseQueryParser') && ! ($query =~ m/\w,\w|\w=\w/));
237 # Initialize & Search Zebra
238 for ( my $i = 0 ; $i < @servers ; $i++ ) {
240 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
243 $QParser->parse( $query );
244 $query = $QParser->target_syntax($servers[$i]);
245 $zoom_queries[$i] = new ZOOM::Query::PQF( $query, $zconns[$i]);
248 $zoom_queries[$i] = new ZOOM::Query::CCL2RPN( $query, $zconns[$i]);
250 $tmpresults[$i] = $zconns[$i]->search( $zoom_queries[$i] );
254 $zconns[$i]->errmsg() . " ("
255 . $zconns[$i]->errcode() . ") "
256 . $zconns[$i]->addinfo() . " "
257 . $zconns[$i]->diagset();
259 return ( $error, undef, undef ) if $zconns[$i]->errcode();
263 # caught a ZOOM::Exception
267 . $@->addinfo() . " "
269 warn $error." for query: $query";
270 return ( $error, undef, undef );
279 my $first_record = defined($offset) ? $offset + 1 : 1;
280 my $hits = $tmpresults[ $i - 1 ]->size();
281 $total_hits += $hits;
282 my $last_record = $hits;
283 if ( defined $max_results && $offset + $max_results < $hits ) {
284 $last_record = $offset + $max_results;
287 for my $j ( $first_record .. $last_record ) {
289 $tmpresults[ $i - 1 ]->record( $j - 1 )->raw()
291 push @{$results}, $record;
296 foreach my $zoom_query (@zoom_queries) {
297 $zoom_query->destroy();
300 return ( undef, $results, $total_hits );
305 ( undef, $results_hashref, \@facets_loop ) = getRecords (
307 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
308 $results_per_page, $offset, $expanded_facet, $branches,$itemtypes,
312 The all singing, all dancing, multi-server, asynchronous, scanning,
313 searching, record nabbing, facet-building
315 See verbse embedded documentation.
321 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
322 $results_per_page, $offset, $expanded_facet, $branches,
323 $itemtypes, $query_type, $scan, $opac
326 my @servers = @$servers_ref;
327 my @sort_by = @$sort_by_ref;
329 # Initialize variables for the ZOOM connection and results object
333 my $results_hashref = ();
335 # Initialize variables for the faceted results objects
336 my $facets_counter = ();
337 my $facets_info = ();
338 my $facets = getFacets();
339 my $facets_maxrecs = C4::Context->preference('maxRecordsForFacets')||20;
341 my @facets_loop; # stores the ref to array of hashes for template facets loop
343 ### LOOP THROUGH THE SERVERS
344 for ( my $i = 0 ; $i < @servers ; $i++ ) {
345 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
347 # perform the search, create the results objects
348 # if this is a local search, use the $koha-query, if it's a federated one, use the federated-query
349 my $query_to_use = ($servers[$i] =~ /biblioserver/) ? $koha_query : $simple_query;
351 #$query_to_use = $simple_query if $scan;
352 warn $simple_query if ( $scan and $DEBUG );
354 # Check if we've got a query_type defined, if so, use it
357 if ($query_type =~ /^ccl/) {
358 $query_to_use =~ s/\:/\=/g; # change : to = last minute (FIXME)
359 $results[$i] = $zconns[$i]->search(new ZOOM::Query::CCL2RPN($query_to_use, $zconns[$i]));
360 } elsif ($query_type =~ /^cql/) {
361 $results[$i] = $zconns[$i]->search(new ZOOM::Query::CQL($query_to_use, $zconns[$i]));
362 } elsif ($query_type =~ /^pqf/) {
363 $results[$i] = $zconns[$i]->search(new ZOOM::Query::PQF($query_to_use, $zconns[$i]));
365 warn "Unknown query_type '$query_type'. Results undetermined.";
368 $results[$i] = $zconns[$i]->scan( new ZOOM::Query::CCL2RPN($query_to_use, $zconns[$i]));
370 $results[$i] = $zconns[$i]->search(new ZOOM::Query::CCL2RPN($query_to_use, $zconns[$i]));
374 warn "WARNING: query problem with $query_to_use " . $@;
377 # Concatenate the sort_by limits and pass them to the results object
378 # Note: sort will override rank
380 foreach my $sort (@sort_by) {
381 if ( $sort eq "author_az" || $sort eq "author_asc" ) {
382 $sort_by .= "1=1003 <i ";
384 elsif ( $sort eq "author_za" || $sort eq "author_dsc" ) {
385 $sort_by .= "1=1003 >i ";
387 elsif ( $sort eq "popularity_asc" ) {
388 $sort_by .= "1=9003 <i ";
390 elsif ( $sort eq "popularity_dsc" ) {
391 $sort_by .= "1=9003 >i ";
393 elsif ( $sort eq "call_number_asc" ) {
394 $sort_by .= "1=8007 <i ";
396 elsif ( $sort eq "call_number_dsc" ) {
397 $sort_by .= "1=8007 >i ";
399 elsif ( $sort eq "pubdate_asc" ) {
400 $sort_by .= "1=31 <i ";
402 elsif ( $sort eq "pubdate_dsc" ) {
403 $sort_by .= "1=31 >i ";
405 elsif ( $sort eq "acqdate_asc" ) {
406 $sort_by .= "1=32 <i ";
408 elsif ( $sort eq "acqdate_dsc" ) {
409 $sort_by .= "1=32 >i ";
411 elsif ( $sort eq "title_az" || $sort eq "title_asc" ) {
412 $sort_by .= "1=4 <i ";
414 elsif ( $sort eq "title_za" || $sort eq "title_dsc" ) {
415 $sort_by .= "1=4 >i ";
418 warn "Ignoring unrecognized sort '$sort' requested" if $sort_by;
421 if ($sort_by && !$scan) {
422 if ( $results[$i]->sort( "yaz", $sort_by ) < 0 ) {
423 warn "WARNING sort $sort_by failed";
426 } # finished looping through servers
428 # The big moment: asynchronously retrieve results from all servers
433 my ( $i, $size ) = @_;
436 # loop through the results
437 $results_hash->{'hits'} = $size;
439 if ( $offset + $results_per_page <= $size ) {
440 $times = $offset + $results_per_page;
445 for ( my $j = $offset ; $j < $times ; $j++ ) {
449 ## Check if it's an index scan
451 my ( $term, $occ ) = $results[ $i - 1 ]->term($j);
453 # here we create a minimal MARC record and hand it off to the
454 # template just like a normal result ... perhaps not ideal, but
456 my $tmprecord = MARC::Record->new();
457 $tmprecord->encoding('UTF-8');
461 # the minimal record in author/title (depending on MARC flavour)
462 if ( C4::Context->preference("marcflavour") eq
465 $tmptitle = MARC::Field->new(
470 $tmprecord->append_fields($tmptitle);
474 MARC::Field->new( '245', ' ', ' ', a => $term, );
476 MARC::Field->new( '100', ' ', ' ', a => $occ, );
477 $tmprecord->append_fields($tmptitle);
478 $tmprecord->append_fields($tmpauthor);
480 $results_hash->{'RECORDS'}[$j] =
481 $tmprecord->as_usmarc();
486 $record = $results[ $i - 1 ]->record($j)->raw();
488 # warn "RECORD $j:".$record;
489 $results_hash->{'RECORDS'}[$j] = $record;
493 $results_hashref->{ $servers[ $i - 1 ] } = $results_hash;
495 # Fill the facets while we're looping, but only for the biblioserver and not for a scan
496 if ( !$scan && $servers[ $i - 1 ] =~ /biblioserver/ ) {
499 $size > $facets_maxrecs ? $facets_maxrecs : $size;
500 for my $facet (@$facets) {
501 for ( my $j = 0 ; $j < $jmax ; $j++ ) {
503 $results[ $i - 1 ]->record($j)->render();
505 foreach my $tag ( @{ $facet->{tags} } ) {
508 my $tag_num = substr( $tag, 0, 3 );
509 my $letters = substr( $tag, 3 );
511 '\n' . $tag_num . ' ([^z][^\n]+)';
512 $field_pattern = '\n' . $tag_num . ' ([^\n]+)'
513 if ( int($tag_num) < 10 );
515 ( $render_record =~ /$field_pattern/g );
516 foreach my $field_token (@field_tokens) {
517 my @subf = ( $field_token =~
518 /\$([a-zA-Z0-9]) ([^\$]+)/g );
520 for ( my $i = 0 ; $i < @subf ; $i += 2 ) {
521 if ( $letters =~ $subf[$i] ) {
522 my $value = $subf[ $i + 1 ];
525 push @values, $value;
528 my $data = join( $facet->{sep}, @values );
529 unless ( $data ~~ @used_datas ) {
530 $facets_counter->{ $facet->{idx} }
532 push @used_datas, $data;
537 $facets_info->{ $facet->{idx} }->{label_value} =
539 $facets_info->{ $facet->{idx} }->{expanded} =
544 # warn "connection ", $i-1, ": $size hits";
545 # warn $results[$i-1]->record(0)->render() if $size > 0;
548 if ( $servers[ $i - 1 ] =~ /biblioserver/ ) {
550 sort { $facets_counter->{$b} <=> $facets_counter->{$a} }
551 keys %$facets_counter
555 my $number_of_facets;
556 my @this_facets_array;
559 $facets_counter->{$link_value}
560 ->{$b} <=> $facets_counter->{$link_value}
562 } keys %{ $facets_counter->{$link_value} }
566 if ( ( $number_of_facets < 6 )
567 || ( $expanded_facet eq $link_value )
568 || ( $facets_info->{$link_value}->{'expanded'} )
572 # Sanitize the link value : parenthesis, question and exclamation mark will cause errors with CCL
573 my $facet_link_value = $one_facet;
574 $facet_link_value =~ s/[()!?¡¿؟]/ /g;
576 # fix the length that will display in the label,
577 my $facet_label_value = $one_facet;
578 my $facet_max_length = C4::Context->preference(
579 'FacetLabelTruncationLength')
582 substr( $one_facet, 0, $facet_max_length )
584 if length($facet_label_value) >
587 # if it's a branch, label by the name, not the code,
588 if ( $link_value =~ /branch/ ) {
589 if ( defined $branches
590 && ref($branches) eq "HASH"
591 && defined $branches->{$one_facet}
592 && ref( $branches->{$one_facet} ) eq
596 $branches->{$one_facet}
600 $facet_label_value = "*";
604 # if it's a itemtype, label by the name, not the code,
605 if ( $link_value =~ /itype/ ) {
606 if ( defined $itemtypes
607 && ref($itemtypes) eq "HASH"
608 && defined $itemtypes->{$one_facet}
609 && ref( $itemtypes->{$one_facet} ) eq
613 $itemtypes->{$one_facet}
618 # also, if it's a location code, use the name instead of the code
619 if ( $link_value =~ /location/ ) {
621 GetKohaAuthorisedValueLib( 'LOC',
625 # but we're down with the whole label being in the link's title.
626 push @this_facets_array,
629 $facets_counter->{$link_value}
631 facet_label_value => $facet_label_value,
632 facet_title_value => $one_facet,
633 facet_link_value => $facet_link_value,
634 type_link_value => $link_value,
636 if ($facet_label_value);
640 # handle expanded option
641 unless ( $facets_info->{$link_value}->{'expanded'} ) {
643 if ( ( $number_of_facets > 6 )
644 && ( $expanded_facet ne $link_value ) );
648 type_link_value => $link_value,
649 type_id => $link_value . "_id",
651 . $facets_info->{$link_value}->{'label_value'} =>
653 facets => \@this_facets_array,
654 expandable => $expandable,
655 expand => $link_value,
659 $facets_info->{$link_value}->{'label_value'} =~
662 and ( C4::Context->preference('singleBranchMode') )
668 return ( undef, $results_hashref, \@facets_loop );
673 $koha_query, $simple_query, $sort_by_ref, $servers_ref,
674 $results_per_page, $offset, $expanded_facet, $branches,
678 my $paz = C4::Search::PazPar2->new(C4::Context->config('pazpar2url'));
680 $paz->search($simple_query);
681 sleep 1; # FIXME: WHY?
684 my $results_hashref = {};
685 my $stats = XMLin($paz->stat);
686 my $results = XMLin($paz->show($offset, $results_per_page, 'work-title:1'), forcearray => 1);
688 # for a grouped search result, the number of hits
689 # is the number of groups returned; 'bib_hits' will have
690 # the total number of bibs.
691 $results_hashref->{'biblioserver'}->{'hits'} = $results->{'merged'}->[0];
692 $results_hashref->{'biblioserver'}->{'bib_hits'} = $stats->{'hits'};
694 HIT: foreach my $hit (@{ $results->{'hit'} }) {
695 my $recid = $hit->{recid}->[0];
697 my $work_title = $hit->{'md-work-title'}->[0];
699 if (exists $hit->{'md-work-author'}) {
700 $work_author = $hit->{'md-work-author'}->[0];
702 my $group_label = (defined $work_author) ? "$work_title / $work_author" : $work_title;
704 my $result_group = {};
705 $result_group->{'group_label'} = $group_label;
706 $result_group->{'group_merge_key'} = $recid;
709 if (exists $hit->{count}) {
710 $count = $hit->{count}->[0];
712 $result_group->{'group_count'} = $count;
714 for (my $i = 0; $i < $count; $i++) {
715 # FIXME -- may need to worry about diacritics here
716 my $rec = $paz->record($recid, $i);
717 push @{ $result_group->{'RECORDS'} }, $rec;
720 push @{ $results_hashref->{'biblioserver'}->{'GROUPS'} }, $result_group;
723 # pass through facets
724 my $termlist_xml = $paz->termlist('author,subject');
725 my $terms = XMLin($termlist_xml, forcearray => 1);
726 my @facets_loop = ();
727 #die Dumper($results);
728 # foreach my $list (sort keys %{ $terms->{'list'} }) {
730 # foreach my $facet (sort @{ $terms->{'list'}->{$list}->{'term'} } ) {
732 # facet_label_value => $facet->{'name'}->[0],
735 # push @facets_loop, ( {
736 # type_label => $list,
737 # facets => \@facets,
741 return ( undef, $results_hashref, \@facets_loop );
745 sub _remove_stopwords {
746 my ( $operand, $index ) = @_;
747 my @stopwords_removed;
749 # phrase and exact-qualified indexes shouldn't have stopwords removed
750 if ( $index !~ m/phr|ext/ ) {
752 # remove stopwords from operand : parse all stopwords & remove them (case insensitive)
753 # we use IsAlpha unicode definition, to deal correctly with diacritics.
754 # otherwise, a French word like "leçon" woudl be split into "le" "çon", "le"
755 # is a stopword, we'd get "çon" and wouldn't find anything...
757 foreach ( keys %{ C4::Context->stopwords } ) {
758 next if ( $_ =~ /(and|or|not)/ ); # don't remove operators
759 if ( my ($matched) = ($operand =~
760 /([^\X\p{isAlnum}]\Q$_\E[^\X\p{isAlnum}]|[^\X\p{isAlnum}]\Q$_\E$|^\Q$_\E[^\X\p{isAlnum}])/gi))
762 $operand =~ s/\Q$matched\E/ /gi;
763 push @stopwords_removed, $_;
767 return ( $operand, \@stopwords_removed );
771 sub _detect_truncation {
772 my ( $operand, $index ) = @_;
773 my ( @nontruncated, @righttruncated, @lefttruncated, @rightlefttruncated,
776 my @wordlist = split( /\s/, $operand );
777 foreach my $word (@wordlist) {
778 if ( $word =~ s/^\*([^\*]+)\*$/$1/ ) {
779 push @rightlefttruncated, $word;
781 elsif ( $word =~ s/^\*([^\*]+)$/$1/ ) {
782 push @lefttruncated, $word;
784 elsif ( $word =~ s/^([^\*]+)\*$/$1/ ) {
785 push @righttruncated, $word;
787 elsif ( index( $word, "*" ) < 0 ) {
788 push @nontruncated, $word;
791 push @regexpr, $word;
795 \@nontruncated, \@righttruncated, \@lefttruncated,
796 \@rightlefttruncated, \@regexpr
801 sub _build_stemmed_operand {
802 my ($operand,$lang) = @_;
803 require Lingua::Stem::Snowball ;
804 my $stemmed_operand=q{};
806 # If operand contains a digit, it is almost certainly an identifier, and should
807 # not be stemmed. This is particularly relevant for ISBNs and ISSNs, which
808 # can contain the letter "X" - for example, _build_stemmend_operand would reduce
809 # "014100018X" to "x ", which for a MARC21 database would bring up irrelevant
810 # results (e.g., "23 x 29 cm." from the 300$c). Bug 2098.
811 return $operand if $operand =~ /\d/;
813 # FIXME: the locale should be set based on the user's language and/or search choice
815 # Make sure we only use the first two letters from the language code
816 $lang = lc(substr($lang, 0, 2));
817 # The language codes for the two variants of Norwegian will now be "nb" and "nn",
818 # none of which Lingua::Stem::Snowball can use, so we need to "translate" them
819 if ($lang eq 'nb' || $lang eq 'nn') {
822 my $stemmer = Lingua::Stem::Snowball->new( lang => $lang,
823 encoding => "UTF-8" );
825 my @words = split( / /, $operand );
826 my @stems = $stemmer->stem(\@words);
827 for my $stem (@stems) {
828 $stemmed_operand .= "$stem";
829 $stemmed_operand .= "?"
830 unless ( $stem =~ /(and$|or$|not$)/ ) || ( length($stem) < 3 );
831 $stemmed_operand .= " ";
833 warn "STEMMED OPERAND: $stemmed_operand" if $DEBUG;
834 return $stemmed_operand;
838 sub _build_weighted_query {
840 # FIELD WEIGHTING - This is largely experimental stuff. What I'm committing works
841 # pretty well but could work much better if we had a smarter query parser
842 my ( $operand, $stemmed_operand, $index ) = @_;
843 my $stemming = C4::Context->preference("QueryStemming") || 0;
844 my $weight_fields = C4::Context->preference("QueryWeightFields") || 0;
845 my $fuzzy_enabled = C4::Context->preference("QueryFuzzy") || 0;
847 my $weighted_query .= "(rk=("; # Specifies that we're applying rank
849 # Keyword, or, no index specified
850 if ( ( $index eq 'kw' ) || ( !$index ) ) {
852 "Title-cover,ext,r1=\"$operand\""; # exact title-cover
853 $weighted_query .= " or ti,ext,r2=\"$operand\""; # exact title
854 $weighted_query .= " or Title-cover,phr,r3=\"$operand\""; # phrase title
855 #$weighted_query .= " or any,ext,r4=$operand"; # exact any
856 #$weighted_query .=" or kw,wrdl,r5=\"$operand\""; # word list any
857 $weighted_query .= " or wrdl,fuzzy,r8=\"$operand\""
858 if $fuzzy_enabled; # add fuzzy, word list
859 $weighted_query .= " or wrdl,right-Truncation,r9=\"$stemmed_operand\""
860 if ( $stemming and $stemmed_operand )
861 ; # add stemming, right truncation
862 $weighted_query .= " or wrdl,r9=\"$operand\"";
864 # embedded sorting: 0 a-z; 1 z-a
865 # $weighted_query .= ") or (sort1,aut=1";
868 # Barcode searches should skip this process
869 elsif ( $index eq 'bc' ) {
870 $weighted_query .= "bc=\"$operand\"";
873 # Authority-number searches should skip this process
874 elsif ( $index eq 'an' ) {
875 $weighted_query .= "an=\"$operand\"";
878 # If the index already has more than one qualifier, wrap the operand
879 # in quotes and pass it back (assumption is that the user knows what they
880 # are doing and won't appreciate us mucking up their query
881 elsif ( $index =~ ',' ) {
882 $weighted_query .= " $index=\"$operand\"";
885 #TODO: build better cases based on specific search indexes
887 $weighted_query .= " $index,ext,r1=\"$operand\""; # exact index
888 #$weighted_query .= " or (title-sort-az=0 or $index,startswithnt,st-word,r3=$operand #)";
889 $weighted_query .= " or $index,phr,r3=\"$operand\""; # phrase index
890 $weighted_query .= " or $index,wrdl,r6=\"$operand\""; # word list index
891 $weighted_query .= " or $index,wrdl,fuzzy,r8=\"$operand\""
892 if $fuzzy_enabled; # add fuzzy, word list
893 $weighted_query .= " or $index,wrdl,rt,r9=\"$stemmed_operand\""
894 if ( $stemming and $stemmed_operand ); # add stemming, right truncation
897 $weighted_query .= "))"; # close rank specification
898 return $weighted_query;
903 Return an array with available indexes.
925 'Author-personal-bibliography',
935 'Chronological-subdivision',
945 'Conference-name-heading',
946 'Conference-name-see',
947 'Conference-name-seealso',
952 'Corporate-name-heading',
953 'Corporate-name-see',
954 'Corporate-name-seealso',
956 'date-entered-on-file',
957 'Date-of-acquisition',
958 'Date-of-publication',
959 'Dewey-classification',
966 'Geographic-subdivision',
969 'Heading-use-main-or-added-entry',
970 'Heading-use-series-added-entry ',
971 'Heading-use-subject-added-entry',
989 'Local-classification',
992 'Match-heading-see-from',
1000 'Name-geographic-heading',
1001 'Name-geographic-see',
1002 'Name-geographic-seealso',
1010 'Personal-name-heading',
1011 'Personal-name-see',
1012 'Personal-name-seealso',
1014 'Place-publication',
1019 'Record-control-number',
1030 'Subject-heading-thesaurus',
1031 'Subject-name-personal',
1032 'Subject-subdivision',
1042 'Term-genre-form-heading',
1043 'Term-genre-form-see',
1044 'Term-genre-form-seealso',
1051 'Title-uniform-heading',
1052 'Title-uniform-see',
1053 'Title-uniform-seealso',
1063 'classification-source',
1065 'coded-location-qualifier',
1076 'Local-classification',
1079 'materials-specified',
1088 'replacementpricedate',
1103 =head2 _handle_exploding_index
1105 my $query = _handle_exploding_index($index, $term)
1107 Callback routine to generate the search for "exploding" indexes (i.e.
1108 those indexes which are turned into multiple or-connected searches based
1113 sub _handle_exploding_index {
1114 my ($QParser, $filter, $params, $negate, $server) = @_;
1115 my $index = $filter;
1116 my $term = join(' ', @$params);
1118 return unless ($index =~ m/(su-br|su-na|su-rl)/ && $term);
1120 my $marcflavour = C4::Context->preference('marcflavour');
1122 my $codesubfield = $marcflavour eq 'UNIMARC' ? '5' : 'w';
1123 my $wantedcodes = '';
1124 my @subqueries = ( "\@attr 1=Subject \@attr 4=1 \"$term\"");
1125 my ($error, $results, $total_hits) = SimpleSearch( "he:$term", undef, undef, [ "authorityserver" ] );
1126 foreach my $auth (@$results) {
1127 my $record = MARC::Record->new_from_usmarc($auth);
1128 my @references = $record->field('5..');
1130 if ($index eq 'su-br') {
1132 } elsif ($index eq 'su-na') {
1134 } elsif ($index eq 'su-rl') {
1137 foreach my $reference (@references) {
1138 my $codes = $reference->subfield($codesubfield);
1139 push @subqueries, '@attr 1=Subject @attr 4=1 "' . $reference->as_string('abcdefghijlmnopqrstuvxyz') . '"' if (($codes && $codes eq $wantedcodes) || !$wantedcodes);
1143 my $query = ' @or ' x (scalar(@subqueries) - 1) . join(' ', @subqueries);
1149 ( $operators, $operands, $indexes, $limits,
1150 $sort_by, $scan, $lang ) =
1151 buildQuery ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1153 Shim function to ease the transition from buildQuery to a new QueryParser.
1154 This function is called at the beginning of buildQuery, and modifies
1155 buildQuery's input. If it can handle the input, it returns a query that
1156 buildQuery will not try to parse.
1160 my ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang) = @_;
1162 my @operators = $operators ? @$operators : ();
1163 my @indexes = $indexes ? @$indexes : ();
1164 my @operands = $operands ? @$operands : ();
1165 my @limits = $limits ? @$limits : ();
1166 my @sort_by = $sort_by ? @$sort_by : ();
1168 my $query = $operands[0];
1174 $QParser = C4::Context->queryparser if (C4::Context->preference('UseQueryParser') || $query =~ s/^qp=//);
1175 undef $QParser if ($query =~ m/^(ccl=|pqf=|cql=)/ || grep (/\w,\w|\w=\w/, @operands, @indexes) );
1176 undef $QParser if (scalar @limits > 0);
1181 for ( my $ii = 0 ; $ii <= @operands ; $ii++ ) {
1182 next unless $operands[$ii];
1183 $query .= $operators[ $ii - 1 ] eq 'or' ? ' || ' : ' && '
1185 if ( $indexes[$ii] =~ m/su-/ ) {
1186 $query .= $indexes[$ii] . '(' . $operands[$ii] . ')';
1190 ( $indexes[$ii] ? "$indexes[$ii]:" : '' ) . $operands[$ii];
1193 foreach my $limit (@limits) {
1195 if ( scalar(@sort_by) > 0 ) {
1197 '#(' . join( '|', @{ $QParser->modifiers } ) . ')';
1198 $query =~ s/$modifier_re//g;
1199 foreach my $modifier (@sort_by) {
1200 $query .= " #$modifier";
1204 $query_desc = $query;
1205 $query_desc =~ s/\s+/ /g;
1206 if ( C4::Context->preference("QueryWeightFields") ) {
1208 $QParser->add_bib1_filter_map( 'su-br' => 'biblioserver' =>
1209 { 'target_syntax_callback' => \&_handle_exploding_index } );
1210 $QParser->add_bib1_filter_map( 'su-na' => 'biblioserver' =>
1211 { 'target_syntax_callback' => \&_handle_exploding_index } );
1212 $QParser->add_bib1_filter_map( 'su-rl' => 'biblioserver' =>
1213 { 'target_syntax_callback' => \&_handle_exploding_index } );
1214 $QParser->parse($query);
1215 $operands[0] = "pqf=" . $QParser->target_syntax('biblioserver');
1218 require Koha::QueryParser::Driver::PQF;
1219 my $modifier_re = '#(' . join( '|', @{Koha::QueryParser::Driver::PQF->modifiers}) . ')';
1220 s/$modifier_re//g for @operands;
1223 return ( $operators, \@operands, $indexes, $limits, $sort_by, $scan, $lang, $query_desc);
1229 $simple_query, $query_cgi,
1230 $query_desc, $limit,
1231 $limit_cgi, $limit_desc,
1232 $stopwords_removed, $query_type ) = buildQuery ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1234 Build queries and limits in CCL, CGI, Human,
1235 handle truncation, stemming, field weighting, stopwords, fuzziness, etc.
1237 See verbose embedded documentation.
1243 my ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang) = @_;
1245 warn "---------\nEnter buildQuery\n---------" if $DEBUG;
1248 ( $operators, $operands, $indexes, $limits, $sort_by, $scan, $lang, $query_desc) = parseQuery($operators, $operands, $indexes, $limits, $sort_by, $scan, $lang);
1251 my @operators = $operators ? @$operators : ();
1252 my @indexes = $indexes ? @$indexes : ();
1253 my @operands = $operands ? @$operands : ();
1254 my @limits = $limits ? @$limits : ();
1255 my @sort_by = $sort_by ? @$sort_by : ();
1257 my $stemming = C4::Context->preference("QueryStemming") || 0;
1258 my $auto_truncation = C4::Context->preference("QueryAutoTruncate") || 0;
1259 my $weight_fields = C4::Context->preference("QueryWeightFields") || 0;
1260 my $fuzzy_enabled = C4::Context->preference("QueryFuzzy") || 0;
1261 my $remove_stopwords = C4::Context->preference("QueryRemoveStopwords") || 0;
1263 my $query = $operands[0];
1264 my $simple_query = $operands[0];
1266 # initialize the variables we're passing back
1274 my $stopwords_removed; # flag to determine if stopwords have been removed
1277 my $cclindexes = getIndexes();
1278 if ( $query !~ /\s*ccl=/ ) {
1279 while ( !$cclq && $query =~ /(?:^|\W)([\w-]+)(,[\w-]+)*[:=]/g ) {
1281 $cclq = grep { lc($_) eq $dx } @$cclindexes;
1283 $query = "ccl=$query" if $cclq;
1286 # for handling ccl, cql, pqf queries in diagnostic mode, skip the rest of the steps
1288 if ( $query =~ /^ccl=/ ) {
1290 # This is needed otherwise ccl= and &limit won't work together, and
1291 # this happens when selecting a subject on the opac-detail page
1292 @limits = grep {!/^$/} @limits;
1294 $q .= ' and '.join(' and ', @limits);
1296 return ( undef, $q, $q, "q=ccl=".uri_escape($q), $q, '', '', '', '', 'ccl' );
1298 if ( $query =~ /^cql=/ ) {
1299 return ( undef, $', $', "q=cql=".uri_escape($'), $', '', '', '', '', 'cql' );
1301 if ( $query =~ /^pqf=/ ) {
1303 $query_cgi = "q=".uri_escape($query_desc);
1306 $query_cgi = "q=pqf=".uri_escape($');
1308 return ( undef, $', $', $query_cgi, $query_desc, '', '', '', '', 'pqf' );
1311 # pass nested queries directly
1312 # FIXME: need better handling of some of these variables in this case
1313 # Nested queries aren't handled well and this implementation is flawed and causes users to be
1314 # unable to search for anything containing () commenting out, will be rewritten for 3.4.0
1315 # if ( $query =~ /(\(|\))/ ) {
1317 # undef, $query, $simple_query, $query_cgi,
1318 # $query, $limit, $limit_cgi, $limit_desc,
1319 # $stopwords_removed, 'ccl'
1323 # Form-based queries are non-nested and fixed depth, so we can easily modify the incoming
1324 # query operands and indexes and add stemming, truncation, field weighting, etc.
1325 # Once we do so, we'll end up with a value in $query, just like if we had an
1326 # incoming $query from the user
1329 ; # clear it out so we can populate properly with field-weighted, stemmed, etc. query
1330 my $previous_operand
1331 ; # a flag used to keep track if there was a previous query
1332 # if there was, we can apply the current operator
1334 for ( my $i = 0 ; $i <= @operands ; $i++ ) {
1336 # COMBINE OPERANDS, INDEXES AND OPERATORS
1337 if ( $operands[$i] ) {
1338 $operands[$i]=~s/^\s+//;
1340 # A flag to determine whether or not to add the index to the query
1343 # If the user is sophisticated enough to specify an index, turn off field weighting, stemming, and stopword handling
1344 if ( $operands[$i] =~ /\w(:|=)/ || $scan ) {
1347 $remove_stopwords = 0;
1349 $operands[$i] =~ s/\?/{?}/g; # need to escape question marks
1351 my $operand = $operands[$i];
1352 my $index = $indexes[$i];
1354 # Add index-specific attributes
1355 # Date of Publication
1356 if ( $index eq 'yr' ) {
1357 $index .= ",st-numeric";
1359 $stemming = $auto_truncation = $weight_fields = $fuzzy_enabled = $remove_stopwords = 0;
1362 # Date of Acquisition
1363 elsif ( $index eq 'acqdate' ) {
1364 $index .= ",st-date-normalized";
1366 $stemming = $auto_truncation = $weight_fields = $fuzzy_enabled = $remove_stopwords = 0;
1368 # ISBN,ISSN,Standard Number, don't need special treatment
1369 elsif ( $index eq 'nb' || $index eq 'ns' ) {
1371 $stemming, $auto_truncation,
1372 $weight_fields, $fuzzy_enabled,
1374 ) = ( 0, 0, 0, 0, 0 );
1382 # Set default structure attribute (word list)
1383 my $struct_attr = q{};
1384 unless ( $indexes_set || !$index || $index =~ /(st-|phr|ext|wrdl|nb|ns)/ ) {
1385 $struct_attr = ",wrdl";
1388 # Some helpful index variants
1389 my $index_plus = $index . $struct_attr . ':';
1390 my $index_plus_comma = $index . $struct_attr . ',';
1393 if ($remove_stopwords) {
1394 ( $operand, $stopwords_removed ) =
1395 _remove_stopwords( $operand, $index );
1396 warn "OPERAND w/out STOPWORDS: >$operand<" if $DEBUG;
1397 warn "REMOVED STOPWORDS: @$stopwords_removed"
1398 if ( $stopwords_removed && $DEBUG );
1401 if ($auto_truncation){
1402 unless ( $index =~ /(st-|phr|ext)/ ) {
1403 #FIXME only valid with LTR scripts
1404 $operand=join(" ",map{
1405 (index($_,"*")>0?"$_":"$_*")
1406 }split (/\s+/,$operand));
1407 warn $operand if $DEBUG;
1412 my $truncated_operand;
1413 my( $nontruncated, $righttruncated, $lefttruncated,
1414 $rightlefttruncated, $regexpr
1415 ) = _detect_truncation( $operand, $index );
1417 "TRUNCATION: NON:>@$nontruncated< RIGHT:>@$righttruncated< LEFT:>@$lefttruncated< RIGHTLEFT:>@$rightlefttruncated< REGEX:>@$regexpr<"
1422 scalar(@$righttruncated) + scalar(@$lefttruncated) +
1423 scalar(@$rightlefttruncated) > 0 )
1426 # Don't field weight or add the index to the query, we do it here
1428 undef $weight_fields;
1429 my $previous_truncation_operand;
1430 if (scalar @$nontruncated) {
1431 $truncated_operand .= "$index_plus @$nontruncated ";
1432 $previous_truncation_operand = 1;
1434 if (scalar @$righttruncated) {
1435 $truncated_operand .= "and " if $previous_truncation_operand;
1436 $truncated_operand .= $index_plus_comma . "rtrn:@$righttruncated ";
1437 $previous_truncation_operand = 1;
1439 if (scalar @$lefttruncated) {
1440 $truncated_operand .= "and " if $previous_truncation_operand;
1441 $truncated_operand .= $index_plus_comma . "ltrn:@$lefttruncated ";
1442 $previous_truncation_operand = 1;
1444 if (scalar @$rightlefttruncated) {
1445 $truncated_operand .= "and " if $previous_truncation_operand;
1446 $truncated_operand .= $index_plus_comma . "rltrn:@$rightlefttruncated ";
1447 $previous_truncation_operand = 1;
1450 $operand = $truncated_operand if $truncated_operand;
1451 warn "TRUNCATED OPERAND: >$truncated_operand<" if $DEBUG;
1454 my $stemmed_operand;
1455 $stemmed_operand = _build_stemmed_operand($operand, $lang)
1458 warn "STEMMED OPERAND: >$stemmed_operand<" if $DEBUG;
1460 # Handle Field Weighting
1461 my $weighted_operand;
1462 if ($weight_fields) {
1463 $weighted_operand = _build_weighted_query( $operand, $stemmed_operand, $index );
1464 $operand = $weighted_operand;
1468 warn "FIELD WEIGHTED OPERAND: >$weighted_operand<" if $DEBUG;
1470 # If there's a previous operand, we need to add an operator
1471 if ($previous_operand) {
1473 # User-specified operator
1474 if ( $operators[ $i - 1 ] ) {
1475 $query .= " $operators[$i-1] ";
1476 $query .= " $index_plus " unless $indexes_set;
1477 $query .= " $operand";
1478 $query_cgi .= "&op=".uri_escape($operators[$i-1]);
1479 $query_cgi .= "&idx=".uri_escape($index) if $index;
1480 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1482 " $operators[$i-1] $index_plus $operands[$i]";
1485 # Default operator is and
1488 $query .= "$index_plus " unless $indexes_set;
1489 $query .= "$operand";
1490 $query_cgi .= "&op=and&idx=".uri_escape($index) if $index;
1491 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1492 $query_desc .= " and $index_plus $operands[$i]";
1496 # There isn't a pervious operand, don't need an operator
1499 # Field-weighted queries already have indexes set
1500 $query .= " $index_plus " unless $indexes_set;
1502 $query_desc .= " $index_plus $operands[$i]";
1503 $query_cgi .= "&idx=".uri_escape($index) if $index;
1504 $query_cgi .= "&q=".uri_escape($operands[$i]) if $operands[$i];
1505 $previous_operand = 1;
1510 warn "QUERY BEFORE LIMITS: >$query<" if $DEBUG;
1513 my %group_OR_limits;
1514 my $availability_limit;
1515 foreach my $this_limit (@limits) {
1516 next unless $this_limit;
1517 if ( $this_limit =~ /available/ ) {
1519 ## 'available' is defined as (items.onloan is NULL) and (items.itemlost = 0)
1521 ## all records not indexed in the onloan register (zebra) and all records with a value of lost equal to 0
1522 $availability_limit .=
1523 "( ( allrecords,AlwaysMatches='' not onloan,AlwaysMatches='') and (lost,st-numeric=0) )"; #or ( allrecords,AlwaysMatches='' not lost,AlwaysMatches='')) )";
1524 $limit_cgi .= "&limit=available";
1528 # group_OR_limits, prefixed by mc-
1529 # OR every member of the group
1530 elsif ( $this_limit =~ /mc/ ) {
1531 my ($k,$v) = split(/:/, $this_limit,2);
1532 if ( $k !~ /mc-i(tem)?type/ ) {
1533 # in case the mc-ccode value has complicating chars like ()'s inside it we wrap in quotes
1534 $this_limit =~ tr/"//d;
1535 $this_limit = $k.":\"".$v."\"";
1538 $group_OR_limits{$k} .= " or " if $group_OR_limits{$k};
1539 $limit_desc .= " or " if $group_OR_limits{$k};
1540 $group_OR_limits{$k} .= "$this_limit";
1541 $limit_cgi .= "&limit=$this_limit";
1542 $limit_desc .= " $this_limit";
1545 # Regular old limits
1547 $limit .= " and " if $limit || $query;
1548 $limit .= "$this_limit";
1549 $limit_cgi .= "&limit=$this_limit";
1550 if ($this_limit =~ /^branch:(.+)/) {
1551 my $branchcode = $1;
1552 my $branchname = GetBranchName($branchcode);
1553 if (defined $branchname) {
1554 $limit_desc .= " branch:$branchname";
1556 $limit_desc .= " $this_limit";
1559 $limit_desc .= " $this_limit";
1563 foreach my $k (keys (%group_OR_limits)) {
1564 $limit .= " and " if ( $query || $limit );
1565 $limit .= "($group_OR_limits{$k})";
1567 if ($availability_limit) {
1568 $limit .= " and " if ( $query || $limit );
1569 $limit .= "($availability_limit)";
1572 # Normalize the query and limit strings
1573 # This is flawed , means we can't search anything with : in it
1574 # if user wants to do ccl or cql, start the query with that
1575 # $query =~ s/:/=/g;
1576 $query =~ s/(?<=(ti|au|pb|su|an|kw|mc|nb|ns)):/=/g;
1577 $query =~ s/(?<=(wrdl)):/=/g;
1578 $query =~ s/(?<=(trn|phr)):/=/g;
1580 for ( $query, $query_desc, $limit, $limit_desc ) {
1581 s/ +/ /g; # remove extra spaces
1582 s/^ //g; # remove any beginning spaces
1583 s/ $//g; # remove any ending spaces
1584 s/==/=/g; # remove double == from query
1586 $query_cgi =~ s/^&//; # remove unnecessary & from beginning of the query cgi
1588 for ($query_cgi,$simple_query) {
1591 # append the limit to the query
1592 $query .= " " . $limit;
1596 warn "QUERY:" . $query;
1597 warn "QUERY CGI:" . $query_cgi;
1598 warn "QUERY DESC:" . $query_desc;
1599 warn "LIMIT:" . $limit;
1600 warn "LIMIT CGI:" . $limit_cgi;
1601 warn "LIMIT DESC:" . $limit_desc;
1602 warn "---------\nLeave buildQuery\n---------";
1605 undef, $query, $simple_query, $query_cgi,
1606 $query_desc, $limit, $limit_cgi, $limit_desc,
1607 $stopwords_removed, $query_type
1611 =head2 searchResults
1613 my @search_results = searchResults($search_context, $searchdesc, $hits,
1614 $results_per_page, $offset, $scan,
1617 Format results in a form suitable for passing to the template
1621 # IMO this subroutine is pretty messy still -- it's responsible for
1622 # building the HTML output for the template
1624 my ( $search_context, $searchdesc, $hits, $results_per_page, $offset, $scan, $marcresults ) = @_;
1625 my $dbh = C4::Context->dbh;
1630 $search_context = 'opac' if !$search_context || $search_context ne 'intranet';
1631 my ($is_opac, $hidelostitems);
1632 if ($search_context eq 'opac') {
1633 $hidelostitems = C4::Context->preference('hidelostitems');
1637 #Build branchnames hash
1639 #get branch information.....
1641 my $bsth =$dbh->prepare("SELECT branchcode,branchname FROM branches"); # FIXME : use C4::Branch::GetBranches
1643 while ( my $bdata = $bsth->fetchrow_hashref ) {
1644 $branches{ $bdata->{'branchcode'} } = $bdata->{'branchname'};
1646 # FIXME - We build an authorised values hash here, using the default framework
1647 # though it is possible to have different authvals for different fws.
1649 my $shelflocations =GetKohaAuthorisedValues('items.location','');
1651 # get notforloan authorised value list (see $shelflocations FIXME)
1652 my $notforloan_authorised_value = GetAuthValCode('items.notforloan','');
1654 #Build itemtype hash
1655 #find itemtype & itemtype image
1659 "SELECT itemtype,description,imageurl,summary,notforloan FROM itemtypes"
1662 while ( my $bdata = $bsth->fetchrow_hashref ) {
1663 foreach (qw(description imageurl summary notforloan)) {
1664 $itemtypes{ $bdata->{'itemtype'} }->{$_} = $bdata->{$_};
1668 #search item field code
1669 my ($itemtag, undef) = &GetMarcFromKohaField( "items.itemnumber", "" );
1671 ## find column names of items related to MARC
1672 my $sth2 = $dbh->prepare("SHOW COLUMNS FROM items");
1674 my %subfieldstosearch;
1675 while ( ( my $column ) = $sth2->fetchrow ) {
1676 my ( $tagfield, $tagsubfield ) =
1677 &GetMarcFromKohaField( "items." . $column, "" );
1678 $subfieldstosearch{$column} = $tagsubfield;
1681 # handle which records to actually retrieve
1683 if ( $hits && $offset + $results_per_page <= $hits ) {
1684 $times = $offset + $results_per_page;
1687 $times = $hits; # FIXME: if $hits is undefined, why do we want to equal it?
1690 my $marcflavour = C4::Context->preference("marcflavour");
1691 # We get the biblionumber position in MARC
1692 my ($bibliotag,$bibliosubf)=GetMarcFromKohaField('biblio.biblionumber','');
1694 # loop through all of the records we've retrieved
1695 for ( my $i = $offset ; $i <= $times - 1 ; $i++ ) {
1696 my $marcrecord = MARC::File::USMARC::decode( $marcresults->[$i] );
1700 ? GetFrameworkCode($marcrecord->field($bibliotag)->data)
1701 : GetFrameworkCode($marcrecord->subfield($bibliotag,$bibliosubf));
1702 my $oldbiblio = TransformMarcToKoha( $dbh, $marcrecord, $fw );
1703 $oldbiblio->{subtitle} = GetRecordValue('subtitle', $marcrecord, $fw);
1704 $oldbiblio->{result_number} = $i + 1;
1706 # add imageurl to itemtype if there is one
1707 $oldbiblio->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $oldbiblio->{itemtype} }->{imageurl} );
1709 $oldbiblio->{'authorised_value_images'} = ($search_context eq 'opac' && C4::Context->preference('AuthorisedValueImages')) || ($search_context eq 'intranet' && C4::Context->preference('StaffAuthorisedValueImages')) ? C4::Items::get_authorised_value_images( C4::Biblio::get_biblio_authorised_values( $oldbiblio->{'biblionumber'}, $marcrecord ) ) : [];
1710 $oldbiblio->{normalized_upc} = GetNormalizedUPC( $marcrecord,$marcflavour);
1711 $oldbiblio->{normalized_ean} = GetNormalizedEAN( $marcrecord,$marcflavour);
1712 $oldbiblio->{normalized_oclc} = GetNormalizedOCLCNumber($marcrecord,$marcflavour);
1713 $oldbiblio->{normalized_isbn} = GetNormalizedISBN(undef,$marcrecord,$marcflavour);
1714 $oldbiblio->{content_identifier_exists} = 1 if ($oldbiblio->{normalized_isbn} or $oldbiblio->{normalized_oclc} or $oldbiblio->{normalized_ean} or $oldbiblio->{normalized_upc});
1716 # edition information, if any
1717 $oldbiblio->{edition} = $oldbiblio->{editionstatement};
1718 $oldbiblio->{description} = $itemtypes{ $oldbiblio->{itemtype} }->{description};
1719 # Build summary if there is one (the summary is defined in the itemtypes table)
1720 # FIXME: is this used anywhere, I think it can be commented out? -- JF
1721 if ( $itemtypes{ $oldbiblio->{itemtype} }->{summary} ) {
1722 my $summary = $itemtypes{ $oldbiblio->{itemtype} }->{summary};
1723 my @fields = $marcrecord->fields();
1726 foreach my $line ( "$summary\n" =~ /(.*)\n/g ){
1728 foreach my $tag ( $line =~ /\[(\d{3}[\w|\d])\]/ ) {
1729 $tag =~ /(.{3})(.)/;
1730 if($marcrecord->field($1)){
1731 my @abc = $marcrecord->field($1)->subfield($2);
1732 $tags->{$tag} = $#abc + 1 ;
1736 # We catch how many times to repeat this line
1738 foreach my $tag (keys(%$tags)){
1739 $max = $tags->{$tag} if($tags->{$tag} > $max);
1742 # we replace, and repeat each line
1743 for (my $i = 0 ; $i < $max ; $i++){
1744 my $newline = $line;
1746 foreach my $tag ( $newline =~ /\[(\d{3}[\w|\d])\]/g ) {
1747 $tag =~ /(.{3})(.)/;
1749 if($marcrecord->field($1)){
1750 my @repl = $marcrecord->field($1)->subfield($2);
1751 my $subfieldvalue = $repl[$i];
1753 if (! utf8::is_utf8($subfieldvalue)) {
1754 utf8::decode($subfieldvalue);
1757 $newline =~ s/\[$tag\]/$subfieldvalue/g;
1760 $newsummary .= "$newline\n";
1764 $newsummary =~ s/\[(.*?)]//g;
1765 $newsummary =~ s/\n/<br\/>/g;
1766 $oldbiblio->{summary} = $newsummary;
1769 # Pull out the items fields
1770 my @fields = $marcrecord->field($itemtag);
1771 my $marcflavor = C4::Context->preference("marcflavour");
1772 # adding linked items that belong to host records
1773 my $analyticsfield = '773';
1774 if ($marcflavor eq 'MARC21' || $marcflavor eq 'NORMARC') {
1775 $analyticsfield = '773';
1776 } elsif ($marcflavor eq 'UNIMARC') {
1777 $analyticsfield = '461';
1779 foreach my $hostfield ( $marcrecord->field($analyticsfield)) {
1780 my $hostbiblionumber = $hostfield->subfield("0");
1781 my $linkeditemnumber = $hostfield->subfield("9");
1782 if(!$hostbiblionumber eq undef){
1783 my $hostbiblio = GetMarcBiblio($hostbiblionumber, 1);
1784 my ($itemfield, undef) = GetMarcFromKohaField( 'items.itemnumber', GetFrameworkCode($hostbiblionumber) );
1785 if(!$hostbiblio eq undef){
1786 my @hostitems = $hostbiblio->field($itemfield);
1787 foreach my $hostitem (@hostitems){
1788 if ($hostitem->subfield("9") eq $linkeditemnumber){
1789 my $linkeditem =$hostitem;
1790 # append linked items if they exist
1791 if (!$linkeditem eq undef){
1792 push (@fields, $linkeditem);}
1799 # Setting item statuses for display
1800 my @available_items_loop;
1801 my @onloan_items_loop;
1802 my @other_items_loop;
1804 my $available_items;
1808 my $ordered_count = 0;
1809 my $available_count = 0;
1810 my $onloan_count = 0;
1811 my $longoverdue_count = 0;
1812 my $other_count = 0;
1813 my $wthdrawn_count = 0;
1814 my $itemlost_count = 0;
1815 my $hideatopac_count = 0;
1816 my $itembinding_count = 0;
1817 my $itemdamaged_count = 0;
1818 my $item_in_transit_count = 0;
1819 my $can_place_holds = 0;
1820 my $item_onhold_count = 0;
1821 my $items_count = scalar(@fields);
1822 my $maxitems_pref = C4::Context->preference('maxItemsinSearchResults');
1823 my $maxitems = $maxitems_pref ? $maxitems_pref - 1 : 1;
1824 my @hiddenitems; # hidden itemnumbers based on OpacHiddenItems syspref
1826 # loop through every item
1827 foreach my $field (@fields) {
1830 # populate the items hash
1831 foreach my $code ( keys %subfieldstosearch ) {
1832 $item->{$code} = $field->subfield( $subfieldstosearch{$code} );
1834 $item->{description} = $itemtypes{ $item->{itype} }{description};
1838 # hidden because lost
1839 if ($hidelostitems && $item->{itemlost}) {
1840 $hideatopac_count++;
1843 # hidden based on OpacHiddenItems syspref
1844 my @hi = C4::Items::GetHiddenItemnumbers($item);
1846 push @hiddenitems, @hi;
1847 $hideatopac_count++;
1852 my $hbranch = C4::Context->preference('HomeOrHoldingBranch') eq 'homebranch' ? 'homebranch' : 'holdingbranch';
1853 my $otherbranch = C4::Context->preference('HomeOrHoldingBranch') eq 'homebranch' ? 'holdingbranch' : 'homebranch';
1855 # set item's branch name, use HomeOrHoldingBranch syspref first, fall back to the other one
1856 if ($item->{$hbranch}) {
1857 $item->{'branchname'} = $branches{$item->{$hbranch}};
1859 elsif ($item->{$otherbranch}) { # Last resort
1860 $item->{'branchname'} = $branches{$item->{$otherbranch}};
1863 my $prefix = $item->{$hbranch} . '--' . $item->{location} . $item->{itype} . $item->{itemcallnumber};
1864 # For each grouping of items (onloan, available, unavailable), we build a key to store relevant info about that item
1865 my $userenv = C4::Context->userenv;
1866 if ( $item->{onloan} && !(C4::Members::GetHideLostItemsPreference($userenv->{'number'}) && $item->{itemlost}) ) {
1868 my $key = $prefix . $item->{onloan} . $item->{barcode};
1869 $onloan_items->{$key}->{due_date} = format_date($item->{onloan});
1870 $onloan_items->{$key}->{count}++ if $item->{$hbranch};
1871 $onloan_items->{$key}->{branchname} = $item->{branchname};
1872 $onloan_items->{$key}->{location} = $shelflocations->{ $item->{location} };
1873 $onloan_items->{$key}->{itemcallnumber} = $item->{itemcallnumber};
1874 $onloan_items->{$key}->{description} = $item->{description};
1875 $onloan_items->{$key}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1876 # if something's checked out and lost, mark it as 'long overdue'
1877 if ( $item->{itemlost} ) {
1878 $onloan_items->{$prefix}->{longoverdue}++;
1879 $longoverdue_count++;
1880 } else { # can place holds as long as item isn't lost
1881 $can_place_holds = 1;
1885 # items not on loan, but still unavailable ( lost, withdrawn, damaged )
1889 if ( $item->{notforloan} < 0 ) {
1893 # is item in transit?
1894 my $transfertwhen = '';
1895 my ($transfertfrom, $transfertto);
1897 # is item on the reserve shelf?
1898 my $reservestatus = '';
1900 unless ($item->{wthdrawn}
1901 || $item->{itemlost}
1903 || $item->{notforloan}
1904 || $items_count > 20) {
1906 # A couple heuristics to limit how many times
1907 # we query the database for item transfer information, sacrificing
1908 # accuracy in some cases for speed;
1910 # 1. don't query if item has one of the other statuses
1911 # 2. don't check transit status if the bib has
1912 # more than 20 items
1914 # FIXME: to avoid having the query the database like this, and to make
1915 # the in transit status count as unavailable for search limiting,
1916 # should map transit status to record indexed in Zebra.
1918 ($transfertwhen, $transfertfrom, $transfertto) = C4::Circulation::GetTransfers($item->{itemnumber});
1919 $reservestatus = C4::Reserves::GetReserveStatus( $item->{itemnumber}, $oldbiblio->{biblionumber} );
1922 # item is withdrawn, lost, damaged, not for loan, reserved or in transit
1923 if ( $item->{wthdrawn}
1924 || $item->{itemlost}
1926 || $item->{notforloan}
1927 || $reservestatus eq 'Waiting'
1928 || ($transfertwhen ne ''))
1930 $wthdrawn_count++ if $item->{wthdrawn};
1931 $itemlost_count++ if $item->{itemlost};
1932 $itemdamaged_count++ if $item->{damaged};
1933 $item_in_transit_count++ if $transfertwhen ne '';
1934 $item_onhold_count++ if $reservestatus eq 'Waiting';
1935 $item->{status} = $item->{wthdrawn} . "-" . $item->{itemlost} . "-" . $item->{damaged} . "-" . $item->{notforloan};
1937 # can place hold on item ?
1938 if ( !$item->{itemlost} ) {
1939 if ( !$item->{wthdrawn} ){
1940 if ( $item->{damaged} ){
1941 if ( C4::Context->preference('AllowHoldsOnDamagedItems') ){
1942 # can place a hold on a damaged item if AllowHoldsOnDamagedItems is true
1943 if ( ( !$item->{notforloan} || $item->{notforloan} < 0 ) ){
1944 # item is either for loan or has notforloan < 0
1945 $can_place_holds = 1;
1948 } elsif ( $item->{notforloan} < 0 ) {
1949 # item is not damaged and notforloan is < 0
1950 $can_place_holds = 1;
1957 my $key = $prefix . $item->{status};
1958 foreach (qw(wthdrawn itemlost damaged branchname itemcallnumber)) {
1959 $other_items->{$key}->{$_} = $item->{$_};
1961 $other_items->{$key}->{intransit} = ( $transfertwhen ne '' ) ? 1 : 0;
1962 $other_items->{$key}->{onhold} = ($reservestatus) ? 1 : 0;
1963 $other_items->{$key}->{notforloan} = GetAuthorisedValueDesc('','',$item->{notforloan},'','',$notforloan_authorised_value) if $notforloan_authorised_value and $item->{notforloan};
1964 $other_items->{$key}->{count}++ if $item->{$hbranch};
1965 $other_items->{$key}->{location} = $shelflocations->{ $item->{location} };
1966 $other_items->{$key}->{description} = $item->{description};
1967 $other_items->{$key}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1971 $can_place_holds = 1;
1973 $available_items->{$prefix}->{count}++ if $item->{$hbranch};
1974 foreach (qw(branchname itemcallnumber description)) {
1975 $available_items->{$prefix}->{$_} = $item->{$_};
1977 $available_items->{$prefix}->{location} = $shelflocations->{ $item->{location} };
1978 $available_items->{$prefix}->{imageurl} = getitemtypeimagelocation( $search_context, $itemtypes{ $item->{itype} }->{imageurl} );
1981 } # notforloan, item level and biblioitem level
1983 # if all items are hidden, do not show the record
1984 if ($items_count > 0 && $hideatopac_count == $items_count) {
1988 my ( $availableitemscount, $onloanitemscount, $otheritemscount );
1989 for my $key ( sort keys %$onloan_items ) {
1990 (++$onloanitemscount > $maxitems) and last;
1991 push @onloan_items_loop, $onloan_items->{$key};
1993 for my $key ( sort keys %$other_items ) {
1994 (++$otheritemscount > $maxitems) and last;
1995 push @other_items_loop, $other_items->{$key};
1997 for my $key ( sort keys %$available_items ) {
1998 (++$availableitemscount > $maxitems) and last;
1999 push @available_items_loop, $available_items->{$key}
2002 # XSLT processing of some stuff
2004 SetUTF8Flag($marcrecord);
2005 warn $marcrecord->as_formatted if $DEBUG;
2006 my $interface = $search_context eq 'opac' ? 'OPAC' : '';
2007 if (!$scan && C4::Context->preference($interface . "XSLTResultsDisplay")) {
2008 $oldbiblio->{XSLTResultsRecord} = XSLTParse4Display($oldbiblio->{biblionumber}, $marcrecord, $interface."XSLTResultsDisplay", 1, \@hiddenitems);
2009 # the last parameter tells Koha to clean up the problematic ampersand entities that Zebra outputs
2012 # if biblio level itypes are used and itemtype is notforloan, it can't be reserved either
2013 if (!C4::Context->preference("item-level_itypes")) {
2014 if ($itemtypes{ $oldbiblio->{itemtype} }->{notforloan}) {
2015 $can_place_holds = 0;
2018 $oldbiblio->{norequests} = 1 unless $can_place_holds;
2019 $oldbiblio->{itemsplural} = 1 if $items_count > 1;
2020 $oldbiblio->{items_count} = $items_count;
2021 $oldbiblio->{available_items_loop} = \@available_items_loop;
2022 $oldbiblio->{onloan_items_loop} = \@onloan_items_loop;
2023 $oldbiblio->{other_items_loop} = \@other_items_loop;
2024 $oldbiblio->{availablecount} = $available_count;
2025 $oldbiblio->{availableplural} = 1 if $available_count > 1;
2026 $oldbiblio->{onloancount} = $onloan_count;
2027 $oldbiblio->{onloanplural} = 1 if $onloan_count > 1;
2028 $oldbiblio->{othercount} = $other_count;
2029 $oldbiblio->{otherplural} = 1 if $other_count > 1;
2030 $oldbiblio->{wthdrawncount} = $wthdrawn_count;
2031 $oldbiblio->{itemlostcount} = $itemlost_count;
2032 $oldbiblio->{damagedcount} = $itemdamaged_count;
2033 $oldbiblio->{intransitcount} = $item_in_transit_count;
2034 $oldbiblio->{onholdcount} = $item_onhold_count;
2035 $oldbiblio->{orderedcount} = $ordered_count;
2037 if (C4::Context->preference("AlternateHoldingsField") && $items_count == 0) {
2038 my $fieldspec = C4::Context->preference("AlternateHoldingsField");
2039 my $subfields = substr $fieldspec, 3;
2040 my $holdingsep = C4::Context->preference("AlternateHoldingsSeparator") || ' ';
2041 my @alternateholdingsinfo = ();
2042 my @holdingsfields = $marcrecord->field(substr $fieldspec, 0, 3);
2043 my $alternateholdingscount = 0;
2045 for my $field (@holdingsfields) {
2046 my %holding = ( holding => '' );
2047 my $havesubfield = 0;
2048 for my $subfield ($field->subfields()) {
2049 if ((index $subfields, $$subfield[0]) >= 0) {
2050 $holding{'holding'} .= $holdingsep if (length $holding{'holding'} > 0);
2051 $holding{'holding'} .= $$subfield[1];
2055 if ($havesubfield) {
2056 push(@alternateholdingsinfo, \%holding);
2057 $alternateholdingscount++;
2061 $oldbiblio->{'ALTERNATEHOLDINGS'} = \@alternateholdingsinfo;
2062 $oldbiblio->{'alternateholdings_count'} = $alternateholdingscount;
2065 push( @newresults, $oldbiblio );
2071 =head2 SearchAcquisitions
2072 Search for acquisitions
2075 sub SearchAcquisitions{
2076 my ($datebegin, $dateend, $itemtypes,$criteria, $orderby) = @_;
2078 my $dbh=C4::Context->dbh;
2079 # Variable initialization
2083 LEFT JOIN biblioitems ON biblioitems.biblionumber=biblio.biblionumber
2084 LEFT JOIN items ON items.biblionumber=biblio.biblionumber
2085 WHERE dateaccessioned BETWEEN ? AND ?
2088 my (@params,@loopcriteria);
2090 push @params, $datebegin->output("iso");
2091 push @params, $dateend->output("iso");
2093 if (scalar(@$itemtypes)>0 and $criteria ne "itemtype" ){
2094 if(C4::Context->preference("item-level_itypes")){
2095 $str .= "AND items.itype IN (?".( ',?' x scalar @$itemtypes - 1 ).") ";
2097 $str .= "AND biblioitems.itemtype IN (?".( ',?' x scalar @$itemtypes - 1 ).") ";
2099 push @params, @$itemtypes;
2102 if ($criteria =~/itemtype/){
2103 if(C4::Context->preference("item-level_itypes")){
2104 $str .= "AND items.itype=? ";
2106 $str .= "AND biblioitems.itemtype=? ";
2109 if(scalar(@$itemtypes) == 0){
2110 my $itypes = GetItemTypes();
2111 for my $key (keys %$itypes){
2112 push @$itemtypes, $key;
2116 @loopcriteria= @$itemtypes;
2117 }elsif ($criteria=~/itemcallnumber/){
2118 $str .= "AND (items.itemcallnumber LIKE CONCAT(?,'%')
2119 OR items.itemcallnumber is NULL
2120 OR items.itemcallnumber = '')";
2122 @loopcriteria = ("AA".."ZZ", "") unless (scalar(@loopcriteria)>0);
2124 $str .= "AND biblio.title LIKE CONCAT(?,'%') ";
2125 @loopcriteria = ("A".."z") unless (scalar(@loopcriteria)>0);
2128 if ($orderby =~ /date_desc/){
2129 $str.=" ORDER BY dateaccessioned DESC";
2131 $str.=" ORDER BY title";
2134 my $qdataacquisitions=$dbh->prepare($str);
2136 my @loopacquisitions;
2137 foreach my $value(@loopcriteria){
2138 push @params,$value;
2140 $cell{"title"}=$value;
2141 $cell{"titlecode"}=$value;
2143 eval{$qdataacquisitions->execute(@params);};
2145 if ($@){ warn "recentacquisitions Error :$@";}
2148 while (my $data=$qdataacquisitions->fetchrow_hashref){
2149 push @loopdata, {"summary"=>GetBiblioSummary( $data->{'marcxml'} ) };
2151 $cell{"loopdata"}=\@loopdata;
2153 push @loopacquisitions,\%cell if (scalar(@{$cell{loopdata}})>0);
2156 $qdataacquisitions->finish;
2157 return \@loopacquisitions;
2160 =head2 enabled_staff_search_views
2162 %hash = enabled_staff_search_views()
2164 This function returns a hash that contains three flags obtained from the system
2165 preferences, used to determine whether a particular staff search results view
2170 =item C<Output arg:>
2172 * $hash{can_view_MARC} is true only if the MARC view is enabled
2173 * $hash{can_view_ISBD} is true only if the ISBD view is enabled
2174 * $hash{can_view_labeledMARC} is true only if the Labeled MARC view is enabled
2176 =item C<usage in the script:>
2180 $template->param ( C4::Search::enabled_staff_search_views );
2184 sub enabled_staff_search_views
2187 can_view_MARC => C4::Context->preference('viewMARC'), # 1 if the staff search allows the MARC view
2188 can_view_ISBD => C4::Context->preference('viewISBD'), # 1 if the staff search allows the ISBD view
2189 can_view_labeledMARC => C4::Context->preference('viewLabeledMARC'), # 1 if the staff search allows the Labeled MARC view
2193 sub AddSearchHistory{
2194 my ($borrowernumber,$session,$query_desc,$query_cgi, $total)=@_;
2195 my $dbh = C4::Context->dbh;
2197 # Add the request the user just made
2198 my $sql = "INSERT INTO search_history(userid, sessionid, query_desc, query_cgi, total, time) VALUES(?, ?, ?, ?, ?, NOW())";
2199 my $sth = $dbh->prepare($sql);
2200 $sth->execute($borrowernumber, $session, $query_desc, $query_cgi, $total);
2201 return $dbh->last_insert_id(undef, 'search_history', undef,undef,undef);
2204 sub GetSearchHistory{
2205 my ($borrowernumber,$session)=@_;
2206 my $dbh = C4::Context->dbh;
2208 # Add the request the user just made
2209 my $query = "SELECT FROM search_history WHERE (userid=? OR sessionid=?)";
2210 my $sth = $dbh->prepare($query);
2211 $sth->execute($borrowernumber, $session);
2212 return $sth->fetchall_hashref({});
2215 =head2 z3950_search_args
2217 $arrayref = z3950_search_args($matchpoints)
2219 This function returns an array reference that contains the search parameters to be
2220 passed to the Z39.50 search script (z3950_search.pl). The array elements
2221 are hash refs whose keys are name, value and encvalue, and whose values are the
2222 name of a search parameter, the value of that search parameter and the URL encoded
2223 value of that parameter.
2225 The search parameter names are lccn, isbn, issn, title, author, dewey and subject.
2227 The search parameter values are obtained from the bibliographic record whose
2228 data is in a hash reference in $matchpoints, as returned by Biblio::GetBiblioData().
2230 If $matchpoints is a scalar, it is assumed to be an unnamed query descriptor, e.g.
2231 a general purpose search argument. In this case, the returned array contains only
2232 entry: the key is 'title' and the value and encvalue are derived from $matchpoints.
2234 If a search parameter value is undefined or empty, it is not included in the returned
2237 The returned array reference may be passed directly to the template parameters.
2241 =item C<Output arg:>
2243 * $array containing hash refs as described above
2245 =item C<usage in the script:>
2249 $data = Biblio::GetBiblioData($bibno);
2250 $template->param ( MYLOOP => C4::Search::z3950_search_args($data) )
2254 $template->param ( MYLOOP => C4::Search::z3950_search_args($searchscalar) )
2258 sub z3950_search_args {
2260 my $isbn = Business::ISBN->new($bibrec);
2262 if (defined $isbn && $isbn->is_valid)
2264 $bibrec = { isbn => $bibrec } if !ref $bibrec;
2267 $bibrec = { title => $bibrec } if !ref $bibrec;
2270 for my $field (qw/ lccn isbn issn title author dewey subject /)
2272 my $encvalue = URI::Escape::uri_escape_utf8($bibrec->{$field});
2273 push @$array, { name=>$field, value=>$bibrec->{$field}, encvalue=>$encvalue } if defined $bibrec->{$field};
2278 =head2 GetDistinctValues($field);
2280 C<$field> is a reference to the fields array
2284 sub GetDistinctValues {
2285 my ($fieldname,$string)=@_;
2286 # returns a reference to a hash of references to branches...
2287 if ($fieldname=~/\./){
2288 my ($table,$column)=split /\./, $fieldname;
2289 my $dbh = C4::Context->dbh;
2290 warn "select DISTINCT($column) as value, count(*) as cnt from $table group by lib order by $column " if $DEBUG;
2291 my $sth = $dbh->prepare("select DISTINCT($column) as value, count(*) as cnt from $table ".($string?" where $column like \"$string%\"":"")."group by value order by $column ");
2293 my $elements=$sth->fetchall_arrayref({});
2298 my @servers=qw<biblioserver authorityserver>;
2299 my (@zconns,@results);
2300 for ( my $i = 0 ; $i < @servers ; $i++ ) {
2301 $zconns[$i] = C4::Context->Zconn( $servers[$i], 1 );
2304 ZOOM::Query::CCL2RPN->new( qq"$fieldname $string", $zconns[$i])
2307 # The big moment: asynchronously retrieve results from all servers
2313 my ( $i, $size ) = @_;
2314 for ( my $j = 0 ; $j < $size ; $j++ ) {
2316 @hashscan{qw(value cnt)} =
2317 $results[ $i - 1 ]->display_term($j);
2318 push @elements, \%hashscan;
2326 =head2 _ZOOM_event_loop
2328 _ZOOM_event_loop(\@zconns, \@results, sub {
2329 my ( $i, $size ) = @_;
2333 Processes a ZOOM event loop and passes control to a closure for
2334 processing the results, and destroying the resultsets.
2338 sub _ZOOM_event_loop {
2339 my ($zconns, $results, $callback) = @_;
2340 while ( ( my $i = ZOOM::event( $zconns ) ) != 0 ) {
2341 my $ev = $zconns->[ $i - 1 ]->last_event();
2342 if ( $ev == ZOOM::Event::ZEND ) {
2343 next unless $results->[ $i - 1 ];
2344 my $size = $results->[ $i - 1 ]->size();
2346 $callback->($i, $size);
2351 foreach my $result (@$results) {
2357 END { } # module clean-up code here (global destructor)
2364 Koha Development Team <http://koha-community.org/>