Bug 22905: (QA follow-up) remove bad warn
[koha.git] / 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
32 use Koha::DateUtils qw( dt_from_string );
33 use Koha::AuthorisedValues;
34 use Koha::Acquisition::Currencies;
35 use Koha::Libraries;
36 use Koha::Patrons;
37
38 use URI::Escape;
39
40 sub Init{
41     my $suggestion= shift @_;
42     # "Managed by" is used only when a suggestion is being edited (not when created)
43     if ($suggestion->{'suggesteddate'} eq "0000-00-00" ||$suggestion->{'suggesteddate'} eq "") {
44         # new suggestion
45         $suggestion->{suggesteddate} = dt_from_string;
46         $suggestion->{'suggestedby'} = C4::Context->userenv->{"number"} unless ($suggestion->{'suggestedby'});
47     }
48     else {
49         # editing of an existing suggestion
50         $suggestion->{manageddate} = dt_from_string;
51         $suggestion->{'managedby'} = C4::Context->userenv->{"number"} unless ($suggestion->{'managedby'});
52     }
53     $suggestion->{'branchcode'}=C4::Context->userenv->{"branch"} unless ($suggestion->{'branchcode'});
54 }
55
56 sub GetCriteriumDesc{
57     my ($criteriumvalue,$displayby)=@_;
58     if ($displayby =~ /status/i) {
59         unless ( grep { /$criteriumvalue/ } qw(ASKED ACCEPTED REJECTED CHECKED ORDERED AVAILABLE) ) {
60             my $av = Koha::AuthorisedValues->search({ category => 'SUGGEST_STATUS', authorised_value => $criteriumvalue });
61             return $av->count ? $av->next->lib : 'Unknown';
62         }
63         return ($criteriumvalue eq 'ASKED'?"Pending":ucfirst(lc( $criteriumvalue))) if ($displayby =~/status/i);
64     }
65     return Koha::Libraries->find($criteriumvalue)->branchname
66         if $displayby =~ /branchcode/;
67     if ( $displayby =~ /itemtype/ ) {
68         my $av = Koha::AuthorisedValues->search({ category => 'SUGGEST_FORMAT', authorised_value => $criteriumvalue });
69         return $av->count ? $av->next->lib : 'Unknown';
70     }
71     if ($displayby =~/suggestedby/||$displayby =~/managedby/||$displayby =~/acceptedby/){
72         my $patron = Koha::Patrons->find( $criteriumvalue );
73         return "" unless $patron;
74         return $patron->surname . ", " . $patron->firstname;
75     }
76     if ( $displayby =~ /budgetid/) {
77         my $budget = GetBudget($criteriumvalue);
78         return "" unless $budget;
79         return $$budget{budget_name};
80     }
81 }
82
83 my $input           = CGI->new;
84 my $redirect  = $input->param('redirect');
85 my $suggestedbyme   = (defined $input->param('suggestedbyme')? $input->param('suggestedbyme'):1);
86 my $op              = $input->param('op')||'else';
87 my @editsuggestions = $input->multi_param('edit_field');
88 my $suggestedby     = $input->param('suggestedby');
89 my $returnsuggestedby = $input->param('returnsuggestedby');
90 my $returnsuggested = $input->param('returnsuggested');
91 my $managedby       = $input->param('managedby');
92 my $displayby       = $input->param('displayby') || '';
93 my $tabcode         = $input->param('tabcode');
94 my $reasonsloop     = GetAuthorisedValues("SUGGEST");
95
96 # filter informations which are not suggestion related.
97 my $suggestion_ref  = $input->Vars;
98
99 # get only the columns of Suggestion
100 my $schema = Koha::Database->new()->schema;
101 my $columns = ' '.join(' ', $schema->source('Suggestion')->columns).' ';
102 my $suggestion_only = { map { $columns =~ / $_ / ? ($_ => $suggestion_ref->{$_}) : () } keys %$suggestion_ref };
103 $suggestion_only->{STATUS} = $suggestion_ref->{STATUS};
104
105 delete $$suggestion_ref{$_} foreach qw( suggestedbyme op displayby tabcode edit_field );
106 foreach (keys %$suggestion_ref){
107     delete $$suggestion_ref{$_} if (!$$suggestion_ref{$_} && ($op eq 'else' || $op eq 'change'));
108 }
109 my ( $template, $borrowernumber, $cookie, $userflags ) = get_template_and_user(
110         {
111             template_name   => "suggestion/suggestion.tt",
112             query           => $input,
113             type            => "intranet",
114             flagsrequired   => { acquisition => 'suggestions_manage' },
115         }
116     );
117
118 $borrowernumber = $input->param('borrowernumber') if ( $input->param('borrowernumber') );
119 $template->param('borrowernumber' => $borrowernumber);
120
121 #########################################
122 ##  Operations
123 ##
124 if ( $op =~ /save/i ) {
125     $suggestion_only->{suggesteddate} = dt_from_string( $suggestion_only->{suggesteddate} )
126         if $suggestion_only->{suggesteddate};
127
128     if ( $suggestion_only->{"STATUS"} ) {
129         if ( my $tmpstatus = lc( $suggestion_only->{"STATUS"} ) =~ /ACCEPTED|REJECTED/i ) {
130             $suggestion_only->{ lc( $suggestion_only->{"STATUS"}) . "date" } = dt_from_string;
131             $suggestion_only->{ lc( $suggestion_only->{"STATUS"}) . "by" }   = C4::Context->userenv->{number};
132         }
133         $suggestion_only->{manageddate} = dt_from_string;
134         $suggestion_only->{"managedby"}   = C4::Context->userenv->{number};
135     }
136
137     my $otherreason = $input->param('other_reason');
138     if ($suggestion_only->{reason} eq 'other' && $otherreason) {
139         $suggestion_only->{reason} = $otherreason;
140     }
141
142     if ( $suggestion_only->{'suggestionid'} > 0 ) {
143         &ModSuggestion($suggestion_only);
144     } else {
145         ###FIXME:Search here if suggestion already exists.
146         my $suggestions_loop =
147             SearchSuggestion( $suggestion_only );
148         if (@$suggestions_loop>=1){
149             #some suggestion are answering the request Donot Add
150             my @messages;
151             for my $suggestion ( @$suggestions_loop ) {
152                 push @messages, { type => 'error', code => 'already_exists', id => $suggestion->{suggestionid} };
153             }
154             $template->param( messages => \@messages );
155         } 
156         else {    
157             ## Adding some informations related to suggestion
158             &NewSuggestion($suggestion_only);
159         }
160         # empty fields, to avoid filter in "SearchSuggestion"
161     }  
162     map{delete $$suggestion_ref{$_}} keys %$suggestion_ref;
163     $op = 'else';
164
165     if( $redirect eq 'purchase_suggestions' ) {
166         print $input->redirect("/cgi-bin/koha/members/purchase-suggestions.pl?borrowernumber=$borrowernumber");
167     }
168
169 }
170 elsif ($op=~/add/) {
171     #Adds suggestion  
172     Init($suggestion_ref);
173     $op ='save';
174
175 elsif ($op=~/edit/) {
176     #Edit suggestion  
177     $suggestion_ref=&GetSuggestion($$suggestion_ref{'suggestionid'});
178     $suggestion_ref->{reasonsloop} = $reasonsloop;
179     my $other_reason = 1;
180     foreach my $reason ( @{ $reasonsloop } ) {
181         if ($suggestion_ref->{reason} eq $reason->{lib}) {
182             $other_reason = 0;
183         }
184     }
185     $other_reason = 0 unless $suggestion_ref->{reason};
186     $template->param(other_reason => $other_reason);
187     Init($suggestion_ref);
188     $op ='save';
189 }  
190 elsif ($op eq "change" ) {
191
192     my $suggestion;
193     # set accepted/rejected/managed informations if applicable
194     # ie= if the librarian has chosen some action on the suggestions
195     my $STATUS      = $input->param('STATUS');
196     my $accepted_by = $input->param('acceptedby');
197     if ( $STATUS eq "ACCEPTED" ) {
198         $suggestion = {
199             STATUS       => $STATUS,
200             accepteddate => dt_from_string,
201             acceptedby => C4::Context->userenv->{number},
202         };
203     }
204     elsif ( $STATUS eq "REJECTED" ) {
205         $suggestion = {
206
207             STATUS       => $STATUS,
208             rejecteddate => dt_from_string,
209             rejectedby   => C4::Context->userenv->{number},
210         };
211     }
212     if ($STATUS) {
213         $suggestion->{manageddate} = dt_from_string;
214         $suggestion->{managedby}   = C4::Context->userenv->{number};
215     }
216     if ( my $reason = $input->param("reason$tabcode") ) {
217         if ( $reason eq "other" ) {
218             $reason = $input->param("other_reason$tabcode");
219         }
220         $suggestion->{reason} = $reason;
221     }
222
223     foreach my $suggestionid (@editsuggestions) {
224         next unless $suggestionid;
225         $suggestion->{suggestionid} = $suggestionid;
226         &ModSuggestion($suggestion);
227     }
228     my $params = '';
229     foreach my $key (
230         qw(
231         displayby branchcode title author isbn publishercode copyrightdate
232         collectiontitle suggestedby suggesteddate_from suggesteddate_to
233         manageddate_from manageddate_to accepteddate_from
234         accepteddate_to budgetid
235         )
236       )
237     {
238         $params .= $key . '=' . uri_escape($input->param($key)) . '&'
239           if defined($input->param($key));
240     }
241     print $input->redirect("/cgi-bin/koha/suggestion/suggestion.pl?$params");
242 }elsif ($op eq "delete" ) {
243     foreach my $delete_field (@editsuggestions) {
244         &DelSuggestion( $borrowernumber, $delete_field,'intranet' );
245     }
246     $op = 'else';
247 }
248 elsif ( $op eq 'show' ) {
249     $suggestion_ref=&GetSuggestion($$suggestion_ref{'suggestionid'});
250     my $budget = GetBudget $$suggestion_ref{budgetid};
251     $$suggestion_ref{budgetname} = $$budget{budget_name};
252     Init($suggestion_ref);
253 }
254 if ($op=~/else/) {
255     $op='else';
256     
257     $displayby||="STATUS";
258     delete $$suggestion_ref{'branchcode'} if($displayby eq "branchcode");
259     # distinct values of display by
260     my $criteria_list=GetDistinctValues("suggestions.".$displayby);
261     my (@criteria_dv, $criteria_has_empty);
262     foreach (@$criteria_list) {
263         if ($_->{value}) {
264             push @criteria_dv, $_->{value};
265         } else {
266             $criteria_has_empty = 1;
267         }
268     }
269     # aggregate null and empty values under empty value
270     push @criteria_dv, '' if $criteria_has_empty;
271
272     my @allsuggestions;
273     foreach my $criteriumvalue ( @criteria_dv ) {
274         # By default, display suggestions from current working branch
275         unless ( exists $$suggestion_ref{'branchcode'} ) {
276             $$suggestion_ref{'branchcode'} = C4::Context->userenv->{'branch'};
277         }
278         my $definedvalue = defined $$suggestion_ref{$displayby} && $$suggestion_ref{$displayby} ne "";
279
280         next if ( $definedvalue && $$suggestion_ref{$displayby} ne $criteriumvalue );
281         $$suggestion_ref{$displayby} = $criteriumvalue;
282
283         my $suggestions = &SearchSuggestion($suggestion_ref);
284         foreach my $suggestion (@$suggestions) {
285             if ($suggestion->{budgetid}){
286                 my $bud = GetBudget( $suggestion->{budgetid} );
287                 $suggestion->{budget_name} = $bud->{budget_name} if $bud;
288             }
289         }
290         push @allsuggestions,{
291                             "suggestiontype"=>$criteriumvalue||"suggest",
292                             "suggestiontypelabel"=>GetCriteriumDesc($criteriumvalue,$displayby)||"",
293                             "suggestionscount"=>scalar(@$suggestions),             
294                             'suggestions_loop'=>$suggestions,
295                             'reasonsloop'     => $reasonsloop,
296                             };
297
298         delete $$suggestion_ref{$displayby} unless $definedvalue;
299     }
300
301     $template->param(
302         "displayby"=> $displayby,
303         "notabs"=> $displayby eq "",
304         suggestions       => \@allsuggestions,
305     );
306 }
307
308 foreach my $element ( qw(managedby suggestedby acceptedby) ) {
309 #    $debug || warn $$suggestion_ref{$element};
310     if ($$suggestion_ref{$element}){
311         my $patron = Koha::Patrons->find( $$suggestion_ref{$element} );
312         my $category = $patron->category;
313         $template->param(
314             $element."_borrowernumber"=>$patron->borrowernumber,
315             $element."_firstname"=>$patron->firstname,
316             $element."_surname"=>$patron->surname,
317             $element."_cardnumber"=>$patron->cardnumber,
318             $element."_branchcode"=>$patron->branchcode,
319             $element."_description"=>$category->description,
320             $element."_category_type"=>$category->category_type,
321         );
322     }
323 }
324 $template->param(
325     %$suggestion_ref,  
326     "op_$op"                => 1,
327     "op"             =>$op,
328 );
329
330 if(defined($returnsuggested) and $returnsuggested ne "noone")
331 {
332     print $input->redirect("/cgi-bin/koha/members/moremember.pl?borrowernumber=".$returnsuggested."#suggestions");
333 }
334
335 my $branchfilter = ($displayby ne "branchcode") ? $input->param('branchcode') : C4::Context->userenv->{'branch'};
336
337 $template->param(
338     branchfilter => $branchfilter,
339 );
340
341 $template->param( returnsuggestedby => $returnsuggestedby );
342
343 my $patron_reason_loop = GetAuthorisedValues("OPAC_SUG");
344 $template->param(patron_reason_loop=>$patron_reason_loop);
345
346 #Budgets management
347 my $budgets = [];
348 if ($branchfilter) {
349     my $searchbudgets = { budget_branchcode => $branchfilter };
350     $budgets = GetBudgets($searchbudgets);
351 } else {
352     $budgets = GetBudgets(undef);
353 }
354
355 my @budgets_loop;
356 foreach my $budget ( @{$budgets} ) {
357     next unless (CanUserUseBudget($borrowernumber, $budget, $userflags));
358
359     ## Please see file perltidy.ERR
360     $budget->{'selected'} = 1
361         if ($$suggestion_ref{'budgetid'}
362         && $budget->{'budget_id'} eq $$suggestion_ref{'budgetid'});
363
364     push @budgets_loop, $budget;
365 }
366
367 $template->param( budgetsloop => \@budgets_loop);
368 if( $suggestion_ref->{STATUS} ) {
369     $template->param(
370         "statusselected_".$suggestion_ref->{STATUS} => 1,
371         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
372     );
373 }
374
375 my @currencies = Koha::Acquisition::Currencies->search;
376 $template->param(
377     currencies   => \@currencies,
378     suggestion   => $suggestion_ref,
379     price        => sprintf("%.2f", $$suggestion_ref{'price'}||0),
380     total            => sprintf("%.2f", $$suggestion_ref{'total'}||0),
381 );
382
383 # lists of distinct values (without empty) for filters
384 my %hashlists;
385 foreach my $field ( qw(managedby acceptedby suggestedby budgetid) ) {
386     my $values_list;
387     $values_list = GetDistinctValues( "suggestions." . $field );
388     my @codes_list = map {
389         {   'code' => $$_{'value'},
390             'desc' => GetCriteriumDesc( $$_{'value'}, $field ) || $$_{'value'},
391             'selected' => ($$suggestion_ref{$field}) ? $$_{'value'} eq $$suggestion_ref{$field} : 0,
392         }
393     } grep {
394         $$_{'value'}
395     } @$values_list;
396     $hashlists{ lc($field) . "_loop" } = \@codes_list;
397 }
398
399 $template->param(
400     %hashlists,
401     borrowernumber           => ($input->param('borrowernumber') // undef),
402     SuggestionStatuses       => GetAuthorisedValues('SUGGEST_STATUS'),
403 );
404 output_html_with_http_headers $input, $cookie, $template->output;