suggestion/suggestion.pl

   1 #!/usr/bin/perl
   2
   3 # This file is part of Koha.
   4 # Copyright 2006-2010 BibLibre
   5
   6 #
   7 # Koha is free software; you can redistribute it and/or modify it
   8 # under the terms of the GNU General Public License as published by
   9 # the Free Software Foundation; either version 3 of the License, or
  10 # (at your option) any later version.
  11 #
  12 # Koha is distributed in the hope that it will be useful, but
  13 # WITHOUT ANY WARRANTY; without even the implied warranty of
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15 # GNU General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License
  18 # along with Koha; if not, see <http://www.gnu.org/licenses>.
  19
  20 use Modern::Perl;
  21 require Exporter;
  22 use CGI qw ( -utf8 );
  23 use C4::Auth;    # get_template_and_user
  24 use C4::Output;
  25 use C4::Suggestions;
  26 use C4::Koha;
  27 use C4::Budgets;
  28 use C4::Search;
  29 use C4::Members;
  30 use C4::Debug;
  31 use Koha::DateUtils qw( dt_from_string );
  32 use Koha::AuthorisedValues;
  33 use Koha::Acquisition::Currencies;
  34 use Koha::Libraries;
  35 use Koha::Patrons;
  36
  37 use URI::Escape;
  38
  39 sub Init{
  40     my $suggestion= shift @_;
  41     # "Managed by" is used only when a suggestion is being edited (not when created)
  42     if ($suggestion->{'suggesteddate'} eq "0000-00-00" ||$suggestion->{'suggesteddate'} eq "") {
  43         # new suggestion
  44         $suggestion->{suggesteddate} = dt_from_string;
  45         $suggestion->{'suggestedby'} = C4::Context->userenv->{"number"} unless ($suggestion->{'suggestedby'});
  46     }
  47     else {
  48         # editing of an existing suggestion
  49         $suggestion->{manageddate} = dt_from_string;
  50         $suggestion->{'managedby'} = C4::Context->userenv->{"number"} unless ($suggestion->{'managedby'});
  51     }
  52     $suggestion->{'branchcode'}=C4::Context->userenv->{"branch"} unless ($suggestion->{'branchcode'});
  53 }
  54
  55 sub GetCriteriumDesc{
  56     my ($criteriumvalue,$displayby)=@_;
  57     if ($displayby =~ /status/i) {
  58         unless ( grep { /$criteriumvalue/ } qw(ASKED ACCEPTED REJECTED CHECKED ORDERED AVAILABLE) ) {
  59             my $av = Koha::AuthorisedValues->search({ category => 'SUGGEST_STATUS', authorised_value => $criteriumvalue });
  60             return $av->count ? $av->next->lib : 'Unknown';
  61         }
  62         return ($criteriumvalue eq 'ASKED'?"Pending":ucfirst(lc( $criteriumvalue))) if ($displayby =~/status/i);
  63     }
  64     return Koha::Libraries->find($criteriumvalue)->branchname
  65         if $displayby =~ /branchcode/;
  66     if ( $displayby =~ /itemtype/ ) {
  67         my $av = Koha::AuthorisedValues->search({ category => 'SUGGEST_FORMAT', authorised_value => $criteriumvalue });
  68         return $av->count ? $av->next->lib : 'Unknown';
  69     }
  70     if ($displayby =~/suggestedby/||$displayby =~/managedby/||$displayby =~/acceptedby/){
  71         my $patron = Koha::Patrons->find( $criteriumvalue );
  72         return "" unless $patron;
  73         return $patron->surname . ", " . $patron->firstname;
  74     }
  75     if ( $displayby =~ /budgetid/) {
  76         my $budget = GetBudget($criteriumvalue);
  77         return "" unless $budget;
  78         return $$budget{budget_name};
  79     }
  80 }
  81
  82 my $input           = CGI->new;
  83 my $redirect  = $input->param('redirect');
  84 my $suggestedbyme   = (defined $input->param('suggestedbyme')? $input->param('suggestedbyme'):1);
  85 my $op              = $input->param('op')||'else';
  86 my @editsuggestions = $input->multi_param('suggestionid');
  87 my $suggestedby     = $input->param('suggestedby');
  88 my $returnsuggestedby = $input->param('returnsuggestedby');
  89 my $returnsuggested = $input->param('returnsuggested');
  90 my $managedby       = $input->param('managedby');
  91 my $displayby       = $input->param('displayby') || '';
  92 my $tabcode         = $input->param('tabcode');
  93 my $save_confirmed  = $input->param('save_confirmed') || 0;
  94 my $notify          = $input->param('notify');
  95
  96 my $reasonsloop     = GetAuthorisedValues("SUGGEST");
  97
  98 # filter informations which are not suggestion related.
  99 my $suggestion_ref  = $input->Vars;
 100
 101 # get only the columns of Suggestion
 102 my $schema = Koha::Database->new()->schema;
 103 my $columns = ' '.join(' ', $schema->source('Suggestion')->columns).' ';
 104 my $suggestion_only = { map { $columns =~ / $_ / ? ($_ => $suggestion_ref->{$_}) : () } keys %$suggestion_ref };
 105 $suggestion_only->{STATUS} = $suggestion_ref->{STATUS};
 106
 107 delete $$suggestion_ref{$_} foreach qw( suggestedbyme op displayby tabcode edit_field notify );
 108 foreach (keys %$suggestion_ref){
 109     delete $$suggestion_ref{$_} if (!$$suggestion_ref{$_} && ($op eq 'else' ));
 110 }
 111 my ( $template, $borrowernumber, $cookie, $userflags ) = get_template_and_user(
 112         {
 113             template_name   => "suggestion/suggestion.tt",
 114             query           => $input,
 115             type            => "intranet",
 116             flagsrequired   => { suggestions => 'suggestions_manage' },
 117         }
 118     );
 119
 120 $borrowernumber = $input->param('borrowernumber') if ( $input->param('borrowernumber') );
 121 $template->param('borrowernumber' => $borrowernumber);
 122 my $branchfilter = $input->param('branchcode') || C4::Context->userenv->{'branch'};
 123
 124 #########################################
 125 ##  Operations
 126 ##
 127
 128 if ( $op =~ /save/i ) {
 129     my @messages;
 130     my $biblio = MarcRecordFromNewSuggestion({
 131             title => $suggestion_only->{title},
 132             author => $suggestion_only->{author},
 133             itemtype => $suggestion_only->{itemtype},
 134     });
 135
 136     if ( !$suggestion_only->{suggestionid} && ( my ($duplicatebiblionumber, $duplicatetitle) = FindDuplicate($biblio) ) && !$save_confirmed ) {
 137         push @messages, { type => 'error', code => 'biblio_exists', id => $duplicatebiblionumber, title => $duplicatetitle };
 138         $template->param(
 139             messages => \@messages,
 140             need_confirm => 1
 141         );
 142         delete $suggestion_ref->{suggesteddate};
 143         Init($suggestion_ref);
 144     }
 145     else {
 146
 147         for my $date_key ( qw( suggesteddate manageddate accepteddate rejecteddate ) ) {
 148             $suggestion_only->{$date_key} = dt_from_string( $suggestion_only->{$date_key} )
 149                 if $suggestion_only->{$date_key};
 150         }
 151
 152         if ( $suggestion_only->{"STATUS"} ) {
 153             if ( my $tmpstatus = lc( $suggestion_only->{"STATUS"} ) =~ /ACCEPTED|REJECTED/i ) {
 154                 $suggestion_only->{ lc( $suggestion_only->{"STATUS"}) . "date" } = dt_from_string;
 155                 $suggestion_only->{ lc( $suggestion_only->{"STATUS"}) . "by" }   = C4::Context->userenv->{number};
 156             }
 157             $suggestion_only->{manageddate} = dt_from_string;
 158             $suggestion_only->{"managedby"} ||= C4::Context->userenv->{number};
 159         }
 160
 161         my $otherreason = $input->param('other_reason');
 162         if ($suggestion_only->{reason} eq 'other' && $otherreason) {
 163             $suggestion_only->{reason} = $otherreason;
 164         }
 165
 166         if ( $suggestion_only->{'suggestionid'} > 0 ) {
 167
 168             $suggestion_only->{lastmodificationdate} = dt_from_string;
 169             $suggestion_only->{lastmodificationby}   = C4::Context->userenv->{number};
 170
 171             &ModSuggestion($suggestion_only);
 172
 173             if ( $notify ) {
 174                 my $patron = Koha::Patrons->find( $suggestion_only->{managedby} );
 175                 my $email_address = $patron->notice_email_address;
 176                 if ($patron->notice_email_address) {
 177                     my $budget = C4::Budgets::GetBudget( $suggestion_only->{budgetid} );
 178                     my $library = $patron->library;
 179                     my $admin_email_address = $library->branchemail
 180                       || C4::Context->preference('KohaAdminEmailAddress');
 181
 182                     my $letter = C4::Letters::GetPreparedLetter(
 183                         module      => 'suggestions',
 184                         letter_code => 'TO_PROCESS',
 185                         branchcode  => $patron->branchcode,
 186                         lang        => $patron->lang,
 187                         tables      => {
 188                             suggestions => $suggestion_only->{suggestionid},
 189                             branches    => $patron->branchcode,
 190                             borrowers   => $patron->borrowernumber,
 191                         },
 192                     );
 193                     C4::Letters::EnqueueLetter(
 194                         {
 195                             letter                 => $letter,
 196                             borrowernumber         => $patron->borrowernumber,
 197                             message_transport_type => 'email',
 198                             from_address           => $admin_email_address,
 199                         }
 200                     );
 201                 }
 202             }
 203         } else {
 204             ###FIXME:Search here if suggestion already exists.
 205             my $suggestions_loop =
 206                 SearchSuggestion( $suggestion_only );
 207             if (@$suggestions_loop>=1){
 208                 #some suggestion are answering the request Donot Add
 209                 my @messages;
 210                 for my $suggestion ( @$suggestions_loop ) {
 211                     push @messages, { type => 'error', code => 'already_exists', id => $suggestion->{suggestionid} };
 212                 }
 213                 $template->param( messages => \@messages );
 214             }
 215             else {
 216                 ## Adding some informations related to suggestion
 217                 &NewSuggestion($suggestion_only);
 218             }
 219             # empty fields, to avoid filter in "SearchSuggestion"
 220         }
 221         map{delete $$suggestion_ref{$_}} keys %$suggestion_ref;
 222         $op = 'else';
 223
 224         if( $redirect eq 'purchase_suggestions' ) {
 225             print $input->redirect("/cgi-bin/koha/members/purchase-suggestions.pl?borrowernumber=$borrowernumber");
 226         }
 227     }
 228 }
 229 elsif ($op=~/add/) {
 230     #Adds suggestion
 231     Init($suggestion_ref);
 232     $op ='save';
 233 }
 234 elsif ($op=~/edit/) {
 235     #Edit suggestion
 236     $suggestion_ref=&GetSuggestion($$suggestion_ref{'suggestionid'});
 237     $suggestion_ref->{reasonsloop} = $reasonsloop;
 238     my $other_reason = 1;
 239     foreach my $reason ( @{ $reasonsloop } ) {
 240         if ($suggestion_ref->{reason} eq $reason->{lib}) {
 241             $other_reason = 0;
 242         }
 243     }
 244     $other_reason = 0 unless $suggestion_ref->{reason};
 245     $template->param(other_reason => $other_reason);
 246     Init($suggestion_ref);
 247     $op ='save';
 248 }
 249 elsif ($op eq "update_status" ) {
 250
 251     my $suggestion;
 252     # set accepted/rejected/managed informations if applicable
 253     # ie= if the librarian has chosen some action on the suggestions
 254     my $STATUS      = $input->param('STATUS');
 255     my $accepted_by = $input->param('acceptedby');
 256     if ( $STATUS eq "ACCEPTED" ) {
 257         $suggestion = {
 258             accepteddate => dt_from_string,
 259             acceptedby => C4::Context->userenv->{number},
 260         };
 261     }
 262     elsif ( $STATUS eq "REJECTED" ) {
 263         $suggestion = {
 264             rejecteddate => dt_from_string,
 265             rejectedby   => C4::Context->userenv->{number},
 266         };
 267     }
 268     if ($STATUS) {
 269         $suggestion->{manageddate} = dt_from_string;
 270         $suggestion->{managedby}   = C4::Context->userenv->{number};
 271         $suggestion->{STATUS}      = $STATUS;
 272     }
 273     if ( my $reason = $input->param("reason") ) {
 274         if ( $reason eq "other" ) {
 275             $reason = $input->param("other_reason");
 276         }
 277         $suggestion->{reason} = $reason;
 278     }
 279
 280     foreach my $suggestionid (@editsuggestions) {
 281         next unless $suggestionid;
 282         $suggestion->{suggestionid} = $suggestionid;
 283         &ModSuggestion($suggestion);
 284     }
 285     redirect_with_params($input);
 286 }elsif ($op eq "delete" ) {
 287     foreach my $delete_field (@editsuggestions) {
 288         &DelSuggestion( $borrowernumber, $delete_field,'intranet' );
 289     }
 290     redirect_with_params($input);
 291 }
 292 elsif ( $op eq 'update_itemtype' ) {
 293     my $new_itemtype = $input->param('suggestion_itemtype');
 294     foreach my $suggestionid (@editsuggestions) {
 295         next unless $suggestionid;
 296         &ModSuggestion({ suggestionid => $suggestionid, itemtype => $new_itemtype });
 297     }
 298     redirect_with_params($input);
 299 }
 300 elsif ( $op eq 'update_manager' ) {
 301     my $managedby = $input->param('suggestion_managedby');
 302     foreach my $suggestionid (@editsuggestions) {
 303         next unless $suggestionid;
 304         &ModSuggestion({ suggestionid => $suggestionid, managedby => $managedby });
 305     }
 306     redirect_with_params($input);
 307 }
 308 elsif ( $op eq 'show' ) {
 309     $suggestion_ref=&GetSuggestion($$suggestion_ref{'suggestionid'});
 310     my $budget = GetBudget $$suggestion_ref{budgetid};
 311     $$suggestion_ref{budgetname} = $$budget{budget_name};
 312     Init($suggestion_ref);
 313 }
 314 if ($op=~/else/) {
 315     $op='else';
 316
 317     $displayby||="STATUS";
 318     # distinct values of display by
 319     my $criteria_list=GetDistinctValues("suggestions.".$displayby);
 320     my (@criteria_dv, $criteria_has_empty);
 321     foreach (@$criteria_list) {
 322         if ($_->{value}) {
 323             push @criteria_dv, $_->{value};
 324         } else {
 325             $criteria_has_empty = 1;
 326         }
 327     }
 328     # aggregate null and empty values under empty value
 329     push @criteria_dv, '' if $criteria_has_empty;
 330
 331     # Hack to not modify GetDistinctValues for this specific case
 332     if (   $displayby eq 'branchcode'
 333         && C4::Context->preference('IndependentBranches')
 334         && not C4::Context->IsSuperLibrarian )
 335     {
 336         @criteria_dv = ( C4::Context->userenv->{'branch'} );
 337     }
 338
 339     my @allsuggestions;
 340     foreach my $criteriumvalue ( @criteria_dv ) {
 341         # By default, display suggestions from current working branch
 342         unless ( exists $$suggestion_ref{'branchcode'} ) {
 343             $$suggestion_ref{'branchcode'} = C4::Context->userenv->{'branch'};
 344         }
 345         my $definedvalue = defined $$suggestion_ref{$displayby} && $$suggestion_ref{$displayby} ne "";
 346
 347         next if ( $definedvalue && $$suggestion_ref{$displayby} ne $criteriumvalue ) and ($displayby ne 'branchcode' or $branchfilter ne '__ANY__' );
 348         $$suggestion_ref{$displayby} = $criteriumvalue;
 349
 350         my $suggestions = &SearchSuggestion($suggestion_ref);
 351         foreach my $suggestion (@$suggestions) {
 352             if ($suggestion->{budgetid}){
 353                 my $bud = GetBudget( $suggestion->{budgetid} );
 354                 $suggestion->{budget_name} = $bud->{budget_name} if $bud;
 355             }
 356         }
 357         push @allsuggestions,{
 358                             "suggestiontype"=>$criteriumvalue||"suggest",
 359                             "suggestiontypelabel"=>GetCriteriumDesc($criteriumvalue,$displayby)||"",
 360                             "suggestionscount"=>scalar(@$suggestions),
 361                             'suggestions_loop'=>$suggestions,
 362                             'reasonsloop'     => $reasonsloop,
 363                             };
 364
 365         delete $$suggestion_ref{$displayby} unless $definedvalue;
 366     }
 367
 368     $template->param(
 369         "displayby"=> $displayby,
 370         "notabs"=> $displayby eq "",
 371         suggestions       => \@allsuggestions,
 372     );
 373 }
 374
 375 $template->param(
 376     "${_}_patron" => scalar Koha::Patrons->find( $suggestion_ref->{$_} ) )
 377   for qw(managedby suggestedby acceptedby lastmodificationby);
 378
 379 $template->param(
 380     %$suggestion_ref,
 381     "op"             =>$op,
 382 );
 383
 384 if(defined($returnsuggested) and $returnsuggested ne "noone")
 385 {
 386     print $input->redirect("/cgi-bin/koha/members/moremember.pl?borrowernumber=".$returnsuggested."#suggestions");
 387 }
 388
 389 $template->param(
 390     branchfilter => $branchfilter,
 391 );
 392
 393 $template->param( returnsuggestedby => $returnsuggestedby );
 394
 395 my $patron_reason_loop = GetAuthorisedValues("OPAC_SUG");
 396 $template->param(patron_reason_loop=>$patron_reason_loop);
 397
 398 #Budgets management
 399 my $budgets = GetBudgets;
 400 my @budgets_loop;
 401 foreach my $budget ( @{$budgets} ) {
 402     next unless (CanUserUseBudget($borrowernumber, $budget, $userflags));
 403
 404     ## Please see file perltidy.ERR
 405     $budget->{'selected'} = 1
 406         if ($$suggestion_ref{'budgetid'}
 407         && $budget->{'budget_id'} eq $$suggestion_ref{'budgetid'});
 408
 409     push @budgets_loop, $budget;
 410 }
 411
 412 $template->param( budgetsloop => \@budgets_loop);
 413 if( $suggestion_ref->{STATUS} ) {
 414     $template->param(
 415         "statusselected_".$suggestion_ref->{STATUS} => 1,
 416         selected_status => $suggestion_ref->{STATUS}, # We need template var selected_status in the second part of the template where template var suggestion.STATUS is out of scope
 417     );
 418 }
 419
 420 my @currencies = Koha::Acquisition::Currencies->search;
 421 $template->param(
 422     currencies   => \@currencies,
 423     suggestion   => $suggestion_ref,
 424     price        => sprintf("%.2f", $$suggestion_ref{'price'}||0),
 425     total            => sprintf("%.2f", $$suggestion_ref{'total'}||0),
 426 );
 427
 428 # lists of distinct values (without empty) for filters
 429 my %hashlists;
 430 foreach my $field ( qw(managedby acceptedby suggestedby budgetid) ) {
 431     my $values_list;
 432     $values_list = GetDistinctValues( "suggestions." . $field );
 433     my @codes_list = map {
 434         {   'code' => $$_{'value'},
 435             'desc' => GetCriteriumDesc( $$_{'value'}, $field ) || $$_{'value'},
 436             'selected' => ($$suggestion_ref{$field}) ? $$_{'value'} eq $$suggestion_ref{$field} : 0,
 437         }
 438     } grep {
 439         $$_{'value'}
 440     } @$values_list;
 441     $hashlists{ lc($field) . "_loop" } = \@codes_list;
 442 }
 443
 444 $template->param(
 445     %hashlists,
 446     borrowernumber           => ($input->param('borrowernumber') // undef),
 447     SuggestionStatuses       => GetAuthorisedValues('SUGGEST_STATUS'),
 448 );
 449 output_html_with_http_headers $input, $cookie, $template->output;
 450
 451 sub redirect_with_params {
 452     my ( $input ) = @_;
 453     my $params = '';
 454     foreach my $key (
 455         qw(
 456         displayby branchcode title author isbn publishercode copyrightdate
 457         collectiontitle suggestedby suggesteddate_from suggesteddate_to
 458         manageddate_from manageddate_to accepteddate_from
 459         accepteddate_to budgetid
 460         )
 461       )
 462     {
 463         $params .= $key . '=' . uri_escape(scalar $input->param($key)) . '&'
 464           if defined($input->param($key));
 465     }
 466     print $input->redirect("/cgi-bin/koha/suggestion/suggestion.pl?$params");
 467 }