C4/VirtualShelves/Page.pm

   1 package C4::VirtualShelves::Page;
   2
   3 #
   4 # Copyright 2000-2002 Katipo Communications
   5 #
   6 # This file is part of Koha.
   7 #
   8 # Koha is free software; you can redistribute it and/or modify it under the
   9 # terms of the GNU General Public License as published by the Free Software
  10 # Foundation; either version 2 of the License, or (at your option) any later
  11 # version.
  12 #
  13 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
  14 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  15 # A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License along with
  18 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
  19 # Suite 330, Boston, MA  02111-1307 USA
  20
  21 # perldoc at the end of the file, per convention.
  22
  23 use strict;
  24 use warnings;
  25 use CGI;
  26 use C4::VirtualShelves qw/:DEFAULT RefreshShelvesSummary/;
  27 use C4::Biblio;
  28 use C4::Items;
  29 use C4::Koha;
  30 use C4::Auth qw/get_session/;
  31 use C4::Members;
  32 use C4::Output;
  33 use C4::Dates qw/format_date/;
  34 use Exporter;
  35 use Data::Dumper;
  36
  37 use vars qw($debug @EXPORT @ISA $VERSION);
  38
  39 BEGIN {
  40         $VERSION = 1.01;
  41         @ISA = qw(Exporter);
  42         @EXPORT = qw(&shelfpage);
  43     $debug = $ENV{DEBUG} || 0;
  44 }
  45
  46 our %pages = (
  47         intranet => {
  48                 redirect=>'/cgi-bin/koha/virtualshelves/shelves.pl',
  49         },
  50         opac => {
  51                 redirect=>'/cgi-bin/koha/opac-shelves.pl',
  52         },
  53 );
  54
  55 sub shelfpage ($$$$$) {
  56         my ($type, $query, $template, $loggedinuser, $cookie ) = @_;
  57         ($pages{$type}) or $type = 'opac';
  58         $query or die "No query";
  59         $template or die "No template";
  60         $template->param( { loggedinuser => $loggedinuser } );
  61         my @paramsloop;
  62         my $totitems;
  63         my $shelfoff = ($query->param('shelfoff') ? $query->param('shelfoff') : 1);
  64         my $itemoff = ($query->param('itemoff') ? $query->param('itemoff') : 1);
  65         my $displaymode = ($query->param('display') ? $query->param('display') : 'publicshelves');
  66         my ($shelflimit, $shelfoffset, $shelveslimit, $shelvesoffset);
  67         # FIXME: These limits should not be hardcoded...
  68         $shelflimit = 20;       # Limits number of items returned for a given query
  69         $shelfoffset = ($itemoff - 1) * 20;             # Sets the offset to begin retrieving items at
  70         $shelveslimit = 20;     # Limits number of shelves returned for a given query (row_count)
  71         $shelvesoffset = ($shelfoff - 1) * 20;          # Sets the offset to begin retrieving shelves at (offset)
  72         # getting the Shelves list
  73         my $category = (($displaymode eq 'privateshelves') ? 1 : 2);
  74         my ($shelflist, $totshelves) = GetShelves( $category, $shelveslimit, $shelvesoffset, $loggedinuser );
  75         #Get a list of private shelves for possible deletion. Only do this when we've defaulted to public shelves
  76     my ($privshelflist, $privtotshelves);
  77     if ($category == 2) {
  78         ($privshelflist, $privtotshelves) = GetShelves( 1, $shelveslimit, $shelvesoffset, $loggedinuser );
  79     }
  80         my $op = $query->param('op');
  81 #    my $imgdir = getitemtypeimagesrc();
  82 #    my $itemtypes = GetItemTypes();
  83
  84 # the format of this is unindented for ease of diff comparison to the old script
  85 # Note: do not mistake the assignment statements below for comparisons!
  86
  87 if ( $query->param('modifyshelfcontents') ) {
  88         my ($shelfnumber,$barcode,$item,$biblio);
  89     if ($shelfnumber = $query->param('viewshelf')) {
  90         if (ShelfPossibleAction($loggedinuser, $shelfnumber, 'manage')) {
  91                 if ($barcode = $query->param('addbarcode')) {
  92                         if ($item = GetItem( 0, $barcode )) {
  93                                 $biblio = GetBiblioFromItemNumber($item->{'itemnumber'});
  94                                 AddToShelf($biblio->{'biblionumber'}, $shelfnumber) or
  95                                                 push @paramsloop, {duplicatebiblio=>$barcode};
  96                                 } else { push @paramsloop, {failgetitem=>$barcode}; }
  97                 } else {
  98                                 (grep {/REM-(\d+)/} $query->param) or push @paramsloop, {nobarcode=>1};
  99                         foreach ($query->param) {
 100                                         /REM-(\d+)/ or next;
 101                                         $debug and warn
 102                                                 "SHELVES: user $loggedinuser removing item $1 from shelf $shelfnumber";
 103                                         DelFromShelf($1, $shelfnumber);  # $1 is biblionumber
 104                                 }
 105                         }
 106                 } else { push @paramsloop, {nopermission=>$shelfnumber}; }
 107     } else { push @paramsloop, {noshelfnumber=>1}; }
 108 }
 109
 110 my $showadd = 1;
 111 # set the default tab, etc. (for OPAC)
 112 my $shelf_type = ($query->param('display') ? $query->param('display') : 'publicshelves');
 113 if (defined $shelf_type) {
 114         if ($shelf_type eq 'privateshelves')  {
 115                 $template->param(showprivateshelves => 1);
 116         } elsif ($shelf_type eq 'publicshelves') {
 117                 $template->param(showpublicshelves => 1);
 118                 $showadd = 0;
 119         } else {
 120                 $debug and warn "Invalid 'display' param ($shelf_type)";
 121         }
 122 } elsif ($loggedinuser == -1) {
 123         $template->param(showpublicshelves => 1);
 124 } else {
 125         $template->param(showprivateshelves => 1);
 126 }
 127
 128 my($okmanage, $okview);
 129 my $shelfnumber = $query->param('shelfnumber') || $query->param('viewshelf');
 130 if ($shelfnumber) {
 131         $okmanage = ShelfPossibleAction( $loggedinuser, $shelfnumber, 'manage' );
 132         $okview   = ShelfPossibleAction( $loggedinuser, $shelfnumber, 'view' );
 133 }
 134
 135 my $delflag = 0;
 136
 137 SWITCH: {
 138         if ( $op ) {
 139                 unless ($okmanage) {
 140                         push @paramsloop, {nopermission=>$shelfnumber};
 141                         last SWITCH;
 142                 }
 143                 if ( $op eq 'modifsave' ) {
 144                         my $shelf = {
 145                         'shelfname'             => $query->param('shelfname'),
 146                                 'category'              => $query->param('category'),
 147                                 'sortfield'             => $query->param('sortfield'),
 148                         };
 149
 150                         ModShelf( $shelfnumber, $shelf );
 151
 152                 } elsif ( $op eq 'modif' ) {
 153                         my ( $shelfnumber2, $shelfname, $owner, $category, $sortfield ) =GetShelf( $shelfnumber );
 154                         my $member = GetMember($owner,'borrowernumber');
 155                         my $ownername = defined($member) ? $member->{firstname} . " " . $member->{surname} : '';
 156                         $template->param(
 157                                 edit                => 1,
 158                                 shelfnumber         => $shelfnumber2,
 159                                 shelfname           => $shelfname,
 160                                 owner               => $owner,
 161                                 ownername                       => $ownername,
 162                                 "category$category"     => 1,
 163                                 category                        => $category,
 164                                 "sort_$sortfield"   => 1,
 165                         );
 166                 }
 167                 last SWITCH;
 168         }
 169     if ($shelfnumber = $query->param('viewshelf') ) {
 170         #check that the user can view the shelf
 171                 if ( ShelfPossibleAction( $loggedinuser, $shelfnumber, 'view' ) ) {
 172                         my $items;
 173                         ($items, $totitems) = GetShelfContents($shelfnumber, $shelflimit, $shelfoffset);
 174                         for my $this_item (@$items) {
 175                                 # the virtualshelfcontents table does not store these columns nor are they retrieved from the items
 176                                 # and itemtypes tables, so I'm commenting them out for now to quiet the log -crn
 177                                 #$this_item->{imageurl} = $imgdir."/".$itemtypes->{ $this_item->{itemtype}  }->{'imageurl'};
 178                                 #$this_item->{'description'} = $itemtypes->{ $this_item->{itemtype} }->{'description'};
 179                                 $this_item->{'dateadded'} = format_date($this_item->{'dateadded'});
 180                 $this_item->{'imageurl'} = getitemtypeinfo($this_item->{'itemtype'})->{'imageurl'};
 181                 $this_item->{'coins'} = GetCOinSBiblio($this_item->{'biblionumber'});
 182                         }
 183                         push @paramsloop, {display => 'privateshelves'} if $category == 1;
 184                         $showadd = 1;
 185                         my $i = 0;
 186                         my $manageshelf = ShelfPossibleAction( $loggedinuser, $shelfnumber, 'manage' );
 187                         $template->param(
 188                                 shelfname   => $shelflist->{$shelfnumber}->{'shelfname'} || $privshelflist->{$shelfnumber}->{'shelfname'},
 189                                 shelfnumber => $shelfnumber,
 190                                 viewshelf   => $shelfnumber,
 191                                 manageshelf => $manageshelf,
 192                                 itemsloop => $items,
 193                         );
 194                 } else { push @paramsloop, {nopermission=>$shelfnumber} };
 195         last SWITCH;
 196     }
 197     if ( $query->param('shelves') ) {
 198                 my $stay = 1;
 199         if (my $newshelf = $query->param('addshelf')) {
 200                         # note: a user can always add a new shelf
 201             my $shelfnumber = AddShelf(
 202                 $newshelf,
 203                 $query->param('owner'),
 204                 $query->param('category'),
 205                 $query->param('sortfield')
 206             );
 207                         $stay = 1;
 208             if ( $shelfnumber == -1 ) {    #shelf already exists.
 209                                 $showadd = 1;
 210                                 push @paramsloop, { already => $newshelf };
 211                 $template->param(shelfnumber => $shelfnumber);
 212             } else {
 213                 print $query->redirect($pages{$type}->{redirect} . "?viewshelf=$shelfnumber");
 214                 exit;
 215                         }
 216         }
 217                 foreach ($query->param()) {
 218                         /DEL-(\d+)/ or next;
 219                         $delflag = 1;
 220                         my $number = $1;
 221                         unless (defined $shelflist->{$number} || defined $privshelflist->{$number}) {
 222                                 push(@paramsloop, {unrecognized=>$number}); last;
 223                         }
 224                         unless (ShelfPossibleAction($loggedinuser, $number, 'manage')) {
 225                                 push(@paramsloop, {nopermission=>$shelfnumber}); last;
 226                         }
 227                         my $contents;
 228                         ($contents, $totshelves) = GetShelfContents($number, $shelveslimit, $shelvesoffset);
 229                         if (my $count = scalar @$contents){
 230                                 unless (scalar grep {/^CONFIRM-$number$/} $query->param()) {
 231                                         if (defined $shelflist->{$number}) {
 232                                                 push(@paramsloop, {need_confirm=>$shelflist->{$number}->{shelfname}, count=>$count});
 233                                                 $shelflist->{$number}->{confirm} = $number;
 234                                         } else {
 235                                                 push(@paramsloop, {need_confirm=>$privshelflist->{$number}->{shelfname}, count=>$count});
 236                                                 $privshelflist->{$number}->{confirm} = $number;
 237                                         }
 238                                         $stay = 0;
 239                                         next;
 240                                 }
 241                         }
 242                         my $name;
 243                         if (defined $shelflist->{$number}) {
 244                                 $name = $shelflist->{$number}->{'shelfname'};
 245                                 delete $shelflist->{$number};
 246                         } else {
 247                                 $name = $privshelflist->{$number}->{'shelfname'};
 248                                 delete $privshelflist->{$number};
 249                         }
 250                         unless (DelShelf($number)) {
 251                                 push(@paramsloop, {delete_fail=>$name}); last;
 252                         }
 253                         push(@paramsloop, {delete_ok=>$name});
 254                         # print $query->redirect($pages{$type}->{redirect}); exit;
 255                         $stay = 0;
 256                 }
 257                 $showadd = 1;
 258                 $stay and $template->param(shelves => 1);
 259                 last SWITCH;
 260         }
 261 }
 262
 263 (@paramsloop) and $template->param(paramsloop => \@paramsloop);
 264 $showadd and $template->param(showadd => 1);
 265 my @shelvesloop;
 266 my @shelveslooppriv;
 267 my $numberCanManage = 0;
 268
 269 # rebuild shelflist in case a shelf has been added
 270 ($shelflist, $totshelves) = GetShelves( $category, $shelveslimit, $shelvesoffset, $loggedinuser ) unless $delflag;
 271 foreach my $element (sort { lc($shelflist->{$a}->{'shelfname'}) cmp lc($shelflist->{$b}->{'shelfname'}) } keys %$shelflist) {
 272         my %line;
 273         $shelflist->{$element}->{shelf} = $element;
 274         my $category = $shelflist->{$element}->{'category'};
 275         my $owner    = $shelflist->{$element}->{ 'owner'  };
 276         my $canmanage = ShelfPossibleAction( $loggedinuser, $element, 'manage' );
 277         $shelflist->{$element}->{"viewcategory$category"} = 1;
 278         $shelflist->{$element}->{manageshelf} = $canmanage;
 279         if ($owner eq $loggedinuser or $canmanage) {
 280                 $shelflist->{$element}->{'mine'} = 1;
 281         }
 282         my $member = GetMember($owner,'borrowernumber');
 283         $shelflist->{$element}->{ownername} = defined($member) ? $member->{firstname} . " " . $member->{surname} : '';
 284         $numberCanManage++ if $canmanage;       # possibly outmoded
 285         if ($shelflist->{$element}->{'category'} eq '1') {
 286                 push (@shelveslooppriv, $shelflist->{$element});
 287         } else {
 288                 push (@shelvesloop, $shelflist->{$element});
 289         }
 290 }
 291
 292 my $url = $type eq 'opac' ? "/cgi-bin/koha/opac-shelves.pl" : "/cgi-bin/koha/virtualshelves/shelves.pl";
 293 my %qhash = ();
 294 foreach (qw(display viewshelf)) {
 295     $qhash{$_} = $query->param($_) if $query->param($_);
 296 }
 297 (scalar keys %qhash) and $url .= '?' . join '&', map {"$_=$qhash{$_}"} keys %qhash;
 298 if ($query->param('viewshelf')) {
 299         $template->param( {pagination_bar => pagination_bar($url, (int($totitems/$shelflimit)) + (($totitems % $shelflimit) > 0 ? 1 : 0), $itemoff, "itemoff")} );
 300 } else {
 301         $template->param( {pagination_bar => pagination_bar($url, (int($totshelves/$shelveslimit)) + (($totshelves % $shelveslimit) > 0 ? 1 : 0), $shelfoff, "shelfoff")} );
 302 }
 303 $template->param(
 304     shelveslooppriv => \@shelveslooppriv,
 305     shelvesloop     => \@shelvesloop,
 306     shelvesloopall  => [(@shelvesloop, @shelveslooppriv)],
 307     numberCanManage => $numberCanManage,
 308         "BiblioDefaultView".C4::Context->preference("BiblioDefaultView") => 1,
 309 );
 310 if ($template->param('viewshelf') or
 311         $template->param( 'shelves' ) or
 312         $template->param(  'edit'   ) ) {
 313         $template->param(vseflag => 1);
 314 }
 315 if ($template->param( 'shelves' ) or    # note: this part looks duplicative, but is intentional
 316         $template->param(  'edit'   ) ) {
 317         $template->param( seflag => 1);
 318 }
 319
 320 #FIXME: This refresh really only needs to happen when there is a modification of some sort
 321 #               to the shelves, but the above code is so convoluted in its handling of the various
 322 #               options, it is easier to do this refresh every time C4::VirtualShelves::Page.pm is
 323 #               called
 324
 325 my ($total, $pubshelves, $barshelves) = RefreshShelvesSummary($query->cookie("CGISESSID"),$loggedinuser,($loggedinuser == -1 ? 20 : 10));
 326
 327 if (defined $barshelves) {
 328         $template->param(       barshelves      => scalar (@{$barshelves->[0]}),
 329                                                 barshelvesloop  => $barshelves->[0],
 330                                         );
 331         $template->param(       bartotal                => $total->{'bartotal'}, ) if ($total->{'bartotal'} > scalar (@{$barshelves->[0]}));
 332 }
 333
 334 if (defined $pubshelves) {
 335         $template->param(       pubshelves      => scalar (@{$pubshelves->[0]}),
 336                                                 pubshelvesloop  => $pubshelves->[0],
 337                                         );
 338         $template->param(       pubtotal                => $total->{'pubtotal'}, ) if ($total->{'pubtotal'} > scalar (@{$pubshelves->[0]}));
 339 }
 340
 341 output_html_with_http_headers $query, $cookie, $template->output;
 342 }
 343
 344 1;
 345 __END__
 346
 347 =head1 NAME
 348
 349     VirtualShelves/Page.pm
 350
 351 =head1 DESCRIPTION
 352
 353     Module used for both OPAC and intranet pages.
 354
 355 =head1 CGI PARAMETERS
 356
 357 =over 4
 358
 359 =item C<modifyshelfcontents>
 360
 361     If this script has to modify the shelf content.
 362
 363 =item C<shelfnumber>
 364
 365     To know on which shelf to work.
 366
 367 =item C<addbarcode>
 368
 369 =item C<op>
 370
 371     Op can be:
 372         * modif: show the template allowing modification of the shelves;
 373         * modifsave: save changes from modif mode.
 374
 375 =item C<viewshelf>
 376
 377     Load template with 'viewshelves param' displaying the shelf's information.
 378
 379 =item C<shelves>
 380
 381     If the param shelves == 1, then add or delete a shelf.
 382
 383 =item C<addshelf>
 384
 385     If the param shelves == 1, then addshelf is the name of the shelf to add.
 386
 387 =back
 388
 389 =cut