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                         }
 182                         push @paramsloop, {display => 'privateshelves'} if $category == 1;
 183                         $showadd = 1;
 184                         my $i = 0;
 185                         foreach (grep {$i++ % 2} @$items) {     # every other item
 186                                 $_->{toggle} = 1;
 187                         }
 188                         my $manageshelf = ShelfPossibleAction( $loggedinuser, $shelfnumber, 'manage' );
 189                         $template->param(
 190                                 shelfname   => $shelflist->{$shelfnumber}->{'shelfname'} || $privshelflist->{$shelfnumber}->{'shelfname'},
 191                                 shelfnumber => $shelfnumber,
 192                                 viewshelf   => $shelfnumber,
 193                                 manageshelf => $manageshelf,
 194                                 itemsloop => $items,
 195                         );
 196                 } else { push @paramsloop, {nopermission=>$shelfnumber} };
 197         last SWITCH;
 198     }
 199     if ( $query->param('shelves') ) {
 200                 my $stay = 1;
 201         if (my $newshelf = $query->param('addshelf')) {
 202                         # note: a user can always add a new shelf
 203             my $shelfnumber = AddShelf(
 204                 $newshelf,
 205                 $query->param('owner'),
 206                 $query->param('category'),
 207                 $query->param('sortfield')
 208             );
 209                         $stay = 1;
 210             if ( $shelfnumber == -1 ) {    #shelf already exists.
 211                                 $showadd = 1;
 212                                 push @paramsloop, { already => $newshelf };
 213                 $template->param(shelfnumber => $shelfnumber);
 214             } else {
 215                 print $query->redirect($pages{$type}->{redirect} . "?viewshelf=$shelfnumber");
 216                 exit;
 217                         }
 218         }
 219                 foreach ($query->param()) {
 220                         /DEL-(\d+)/ or next;
 221                         $delflag = 1;
 222                         my $number = $1;
 223                         unless (defined $shelflist->{$number} || defined $privshelflist->{$number}) {
 224                                 push(@paramsloop, {unrecognized=>$number}); last;
 225                         }
 226                         unless (ShelfPossibleAction($loggedinuser, $number, 'manage')) {
 227                                 push(@paramsloop, {nopermission=>$shelfnumber}); last;
 228                         }
 229                         my $contents;
 230                         ($contents, $totshelves) = GetShelfContents($number, $shelveslimit, $shelvesoffset);
 231                         if (my $count = scalar @$contents){
 232                                 unless (scalar grep {/^CONFIRM-$number$/} $query->param()) {
 233                                         if (defined $shelflist->{$number}) {
 234                                                 push(@paramsloop, {need_confirm=>$shelflist->{$number}->{shelfname}, count=>$count});
 235                                                 $shelflist->{$number}->{confirm} = $number;
 236                                         } else {
 237                                                 push(@paramsloop, {need_confirm=>$privshelflist->{$number}->{shelfname}, count=>$count});
 238                                                 $privshelflist->{$number}->{confirm} = $number;
 239                                         }
 240                                         $stay = 0;
 241                                         next;
 242                                 }
 243                         }
 244                         my $name;
 245                         if (defined $shelflist->{$number}) {
 246                                 $name = $shelflist->{$number}->{'shelfname'};
 247                                 delete $shelflist->{$number};
 248                         } else {
 249                                 $name = $privshelflist->{$number}->{'shelfname'};
 250                                 delete $privshelflist->{$number};
 251                         }
 252                         unless (DelShelf($number)) {
 253                                 push(@paramsloop, {delete_fail=>$name}); last;
 254                         }
 255                         push(@paramsloop, {delete_ok=>$name});
 256                         # print $query->redirect($pages{$type}->{redirect}); exit;
 257                         $stay = 0;
 258                 }
 259                 $showadd = 1;
 260                 $stay and $template->param(shelves => 1);
 261                 last SWITCH;
 262         }
 263 }
 264
 265 (@paramsloop) and $template->param(paramsloop => \@paramsloop);
 266 $showadd and $template->param(showadd => 1);
 267 my @shelvesloop;
 268 my @shelveslooppriv;
 269 my $numberCanManage = 0;
 270
 271 # rebuild shelflist in case a shelf has been added
 272 ($shelflist, $totshelves) = GetShelves( $category, $shelveslimit, $shelvesoffset, $loggedinuser ) unless $delflag;
 273 foreach my $element (sort { lc($shelflist->{$a}->{'shelfname'}) cmp lc($shelflist->{$b}->{'shelfname'}) } keys %$shelflist) {
 274         my %line;
 275         $shelflist->{$element}->{shelf} = $element;
 276         my $category = $shelflist->{$element}->{'category'};
 277         my $owner    = $shelflist->{$element}->{ 'owner'  };
 278         my $canmanage = ShelfPossibleAction( $loggedinuser, $element, 'manage' );
 279         $shelflist->{$element}->{"viewcategory$category"} = 1;
 280         $shelflist->{$element}->{manageshelf} = $canmanage;
 281         if ($owner eq $loggedinuser or $canmanage) {
 282                 $shelflist->{$element}->{'mine'} = 1;
 283         }
 284         my $member = GetMember($owner,'borrowernumber');
 285         $shelflist->{$element}->{ownername} = defined($member) ? $member->{firstname} . " " . $member->{surname} : '';
 286         $numberCanManage++ if $canmanage;       # possibly outmoded
 287         if ($shelflist->{$element}->{'category'} eq '1') {
 288                 (scalar(@shelveslooppriv) % 2) and $shelflist->{$element}->{toggle} = 1;
 289                 push (@shelveslooppriv, $shelflist->{$element});
 290         } else {
 291                 (scalar(@shelvesloop)     % 2) and $shelflist->{$element}->{toggle} = 1;
 292                 push (@shelvesloop, $shelflist->{$element});
 293         }
 294 }
 295
 296 my $url = $type eq 'opac' ? "/cgi-bin/koha/opac-shelves.pl" : "/cgi-bin/koha/virtualshelves/shelves.pl";
 297 my %qhash = ();
 298 foreach (qw(display viewshelf)) {
 299     $qhash{$_} = $query->param($_) if $query->param($_);
 300 }
 301 (scalar keys %qhash) and $url .= '?' . join '&', map {"$_=$qhash{$_}"} keys %qhash;
 302 if ($query->param('viewshelf')) {
 303         $template->param( {pagination_bar => pagination_bar($url, (int($totitems/$shelflimit)) + (($totitems % $shelflimit) > 0 ? 1 : 0), $itemoff, "itemoff")} );
 304 } else {
 305         $template->param( {pagination_bar => pagination_bar($url, (int($totshelves/$shelveslimit)) + (($totshelves % $shelveslimit) > 0 ? 1 : 0), $shelfoff, "shelfoff")} );
 306 }
 307 $template->param(
 308     shelveslooppriv => \@shelveslooppriv,
 309     shelvesloop     => \@shelvesloop,
 310     shelvesloopall  => [(@shelvesloop, @shelveslooppriv)],
 311     numberCanManage => $numberCanManage,
 312         "BiblioDefaultView".C4::Context->preference("BiblioDefaultView") => 1,
 313 );
 314 if ($template->param('viewshelf') or
 315         $template->param( 'shelves' ) or
 316         $template->param(  'edit'   ) ) {
 317         $template->param(vseflag => 1);
 318 }
 319 if ($template->param( 'shelves' ) or    # note: this part looks duplicative, but is intentional
 320         $template->param(  'edit'   ) ) {
 321         $template->param( seflag => 1);
 322 }
 323
 324 #FIXME: This refresh really only needs to happen when there is a modification of some sort
 325 #               to the shelves, but the above code is so convoluted in its handling of the various
 326 #               options, it is easier to do this refresh every time C4::VirtualShelves::Page.pm is
 327 #               called
 328
 329 my ($total, $pubshelves, $barshelves) = RefreshShelvesSummary($query->cookie("CGISESSID"),$loggedinuser,($loggedinuser == -1 ? 20 : 10));
 330
 331 if (defined $barshelves) {
 332         $template->param(       barshelves      => scalar (@{$barshelves->[0]}),
 333                                                 barshelvesloop  => $barshelves->[0],
 334                                         );
 335         $template->param(       bartotal                => $total->{'bartotal'}, ) if ($total->{'bartotal'} > scalar (@{$barshelves->[0]}));
 336 }
 337
 338 if (defined $pubshelves) {
 339         $template->param(       pubshelves      => scalar (@{$pubshelves->[0]}),
 340                                                 pubshelvesloop  => $pubshelves->[0],
 341                                         );
 342         $template->param(       pubtotal                => $total->{'pubtotal'}, ) if ($total->{'pubtotal'} > scalar (@{$pubshelves->[0]}));
 343 }
 344
 345 output_html_with_http_headers $query, $cookie, $template->output;
 346 }
 347
 348 1;
 349 __END__
 350
 351 =head1 NAME
 352
 353     VirtualShelves/Page.pm
 354
 355 =head1 DESCRIPTION
 356
 357     Module used for both OPAC and intranet pages.
 358
 359 =head1 CGI PARAMETERS
 360
 361 =over 4
 362
 363 =item C<modifyshelfcontents>
 364
 365     If this script has to modify the shelf content.
 366
 367 =item C<shelfnumber>
 368
 369     To know on which shelf to work.
 370
 371 =item C<addbarcode>
 372
 373 =item C<op>
 374
 375     Op can be:
 376         * modif: show the template allowing modification of the shelves;
 377         * modifsave: save changes from modif mode.
 378
 379 =item C<viewshelf>
 380
 381     Load template with 'viewshelves param' displaying the shelf's information.
 382
 383 =item C<shelves>
 384
 385     If the param shelves == 1, then add or delete a shelf.
 386
 387 =item C<addshelf>
 388
 389     If the param shelves == 1, then addshelf is the name of the shelf to add.
 390
 391 =back
 392
 393 =cut