fixing help feature with new template structure
[koha.git] / C4 / Maintainance.pm
1 package C4::Maintainance; #assumes C4/Maintainance
2
3 #package to deal with marking up output
4
5
6 # Copyright 2000-2002 Katipo Communications
7 #
8 # This file is part of Koha.
9 #
10 # Koha is free software; you can redistribute it and/or modify it under the
11 # terms of the GNU General Public License as published by the Free Software
12 # Foundation; either version 2 of the License, or (at your option) any later
13 # version.
14 #
15 # Koha is distributed in the hope that it will be useful, but WITHOUT ANY
16 # WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
17 # A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
18 #
19 # You should have received a copy of the GNU General Public License along with
20 # Koha; if not, write to the Free Software Foundation, Inc., 59 Temple Place,
21 # Suite 330, Boston, MA  02111-1307 USA
22
23 use strict;
24 use C4::Context;
25
26 require Exporter;
27
28 use vars qw($VERSION @ISA @EXPORT);
29
30 # set the version for version checking
31 $VERSION = 0.01;
32
33 =head1 NAME
34
35 C4::Maintenance - Koha catalog maintenance functions
36
37 =head1 SYNOPSIS
38
39   use C4::Maintenance;
40
41 =head1 DESCRIPTION
42
43 The functions in this module perform various catalog-maintenance
44 functions, including deleting and undeleting books, fixing
45 miscategorized items, etc.
46
47 =head1 FUNCTIONS
48
49 =over 2
50
51 =cut
52
53 @ISA = qw(Exporter);
54 @EXPORT = qw(&listsubjects &shiftgroup &deletedbib &undeletebib
55 &updatetype &logaction);
56
57 =item listsubjects
58
59   ($count, $results) = &listsubjects($subject, $n, $offset);
60
61 Finds the subjects that begin with C<$subject> in the bibliosubject
62 table of the Koha database.
63
64 C<&listsubjects> returns a two-element array. C<$results> is a
65 reference-to-array, in which each element is a reference-to-hash
66 giving information about the given subject. C<$count> is the number of
67 elements in C<@{$results}>.
68
69 Probably the only interesting field in C<$results->[$i]> is
70 C<subject>, the subject in question.
71
72 C<&listsubject> returns up to C<$n> items, starting at C<$offset>. If
73 C<$n> is 0, it will return all matching subjects.
74
75 =cut
76 #'
77 # FIXME - This API is bogus. The way it's currently used, it should
78 # just return a list of strings.
79 sub listsubjects {
80   my ($sub,$num,$offset)=@_;
81   my $dbh = C4::Context->dbh;
82   my $query="Select * from bibliosubject where subject like ? group by subject";
83   my @bind = ("$sub%");
84   # FIXME - Make $num and $offset optional.
85   # If $num was given, make sure $offset was, too.
86   if ($num != 0){
87     $query.=" limit ?,?";
88     push(@bind,$offset,$num);
89   }
90   my $sth=$dbh->prepare($query);
91 #  print $query;
92   $sth->execute(@bind);
93   my @results;
94   my $i=0;
95   while (my $data=$sth->fetchrow_hashref){
96     $results[$i]=$data;
97     $i++;
98   }
99   $sth->finish;
100   return($i,\@results);
101 }
102
103 =item shiftgroup
104
105   &shiftgroup($biblionumber, $biblioitemnumber);
106
107 Changes the biblionumber associated with a given biblioitem.
108 C<$biblioitemnumber> is the number of the biblioitem to change.
109 C<$biblionumber> is the biblionumber to associate it with.
110
111 =cut
112 #'
113 sub shiftgroup{
114   my ($biblionumber,$bi)=@_;
115   my $dbh = C4::Context->dbh;
116   my $sth=$dbh->prepare("update biblioitems set biblionumber=? where biblioitemnumber=?");
117   $sth->execute($biblionumber,$bi);
118   $sth->finish;
119   $sth=$dbh->prepare("update items set biblionumber=? where biblioitemnumber=?");
120   $sth->execute($biblionumber,$bi);
121   $sth->finish;
122 }
123
124 =item deletedbib
125
126   ($count, $results) = &deletedbib($title);
127
128 Looks up deleted books whose title begins with C<$title>.
129
130 C<&deletedbib> returns a two-element list. C<$results> is a
131 reference-to-array; each element is a reference-to-hash whose keys are
132 the fields of the deletedbiblio table in the Koha database. C<$count>
133 is the number of elements in C<$results>.
134
135 =cut
136 #'
137 sub deletedbib{
138   my ($title)=@_;
139   my $dbh = C4::Context->dbh;
140   my $sth=$dbh->prepare("Select * from deletedbiblio where title like ? order by title");
141   $sth->execute("$title%");
142   my @results;
143   my $i=0;
144   while (my $data=$sth->fetchrow_hashref){
145     $results[$i]=$data;
146     $i++;
147   }
148   $sth->finish;
149   return($i,\@results);
150 }
151
152 =item undeletebib
153
154   &undeletebib($biblionumber);
155
156 Undeletes a book. C<&undeletebib> looks up the book with the given
157 biblionumber in the deletedbiblio table of the Koha database, and
158 moves its entry to the biblio table.
159
160 =cut
161 #'
162 sub undeletebib{
163   my ($biblionumber)=@_;
164   my $dbh = C4::Context->dbh;
165   my $sth=$dbh->prepare("select * from deletedbiblio where biblionumber=?");
166   $sth->execute($biblionumber);
167   if (my @data=$sth->fetchrow_array){
168     $sth->finish;
169     # FIXME - Doesn't this keep the same biblionumber? Isn't this
170     # forbidden by the definition of 'biblio'? Or doesn't it matter?
171     my $query="INSERT INTO biblio VALUES (";
172    my $count = @data;
173     $query .= ("?," x $count);
174     $query=~ s/\,$/\)/;
175     #   print $query;
176     $sth=$dbh->prepare($query);
177     $sth->execute(@data);
178     $sth->finish;
179   }
180   $sth=$dbh->prepare("DELETE FROM deletedbiblio WHERE biblionumber=?");
181   $sth->execute($biblionumber);
182   $sth->finish;
183 }
184
185 =item updatetype
186
187   &updatetype($biblioitemnumber, $itemtype);
188
189 Changes the type of the item with the given biblioitemnumber to be
190 C<$itemtype>.
191
192 =cut
193 #'
194 sub updatetype{
195   my ($bi,$type)=@_;
196   my $dbh = C4::Context->dbh;
197   my $sth=$dbh->prepare("Update biblioitems set itemtype=? where biblioitemnumber=?");
198   $sth->execute($type,$bi);
199   $sth->finish;
200 }
201
202 END { }       # module clean-up code here (global destructor)
203
204 1;
205 __END__
206
207 =back
208
209 =head1 AUTHOR
210
211 Koha Developement team <info@koha.org>
212
213 =cut