3 # Copyright 2015 Koha Development team
5 # This file is part of Koha.
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.
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.
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>.
27 use Koha::StockRotationStages;
29 use base qw(Koha::Object);
33 Koha::Library - Koha Library Object class
39 =head3 stockrotationstages
41 my $stages = Koha::Library->stockrotationstages;
43 Returns the stockrotation stages associated with this Library.
47 sub stockrotationstages {
49 my $rs = $self->_result->stockrotationstages;
50 return Koha::StockRotationStages->_new_from_dbic( $rs );
53 =head3 get_effective_marcorgcode
55 my $marcorgcode = Koha::Libraries->find( $library_id )->get_effective_marcorgcode();
57 Returns the effective MARC organization code of the library. It falls back to the value
58 from the I<MARCOrgCode> syspref if undefined for the library.
62 sub get_effective_marcorgcode {
65 return $self->marcorgcode || C4::Context->preference("MARCOrgCode");
68 =head3 inbound_email_address
70 my $to_email = Koha::Library->inbound_email_address;
72 Returns an effective email address which should be accessible to librarians at the branch.
76 sub inbound_email_address {
82 || C4::Context->preference('ReplytoDefault')
83 || C4::Context->preference('KohaAdminEmailAddress')
89 Return the Library groups of this library
95 my $rs = $self->_result->library_groups;
96 return Koha::Library::Groups->_new_from_dbic( $rs );
101 Return Cash::Registers associated with this Library
107 my $rs = $self->_result->cash_registers;
108 return Koha::Cash::Registers->_new_from_dbic( $rs );
111 =head3 to_api_mapping
113 This method returns the mapping for representing a Koha::Library object
120 branchcode => 'library_id',
121 branchname => 'name',
122 branchaddress1 => 'address1',
123 branchaddress2 => 'address2',
124 branchaddress3 => 'address3',
125 branchzip => 'postal_code',
126 branchcity => 'city',
127 branchstate => 'state',
128 branchcountry => 'country',
129 branchphone => 'phone',
131 branchemail => 'email',
132 branchreplyto => 'reply_to_email',
133 branchreturnpath => 'return_path_email',
137 branchnotes => 'notes',
138 marcorgcode => 'marc_org_code',
142 =head3 get_hold_libraries
144 Return all libraries (including self) that belong to the same hold groups
148 sub get_hold_libraries {
150 my $library_groups = $self->library_groups;
152 while ( my $library_group = $library_groups->next ) {
153 my $root = Koha::Library::Groups->get_root_ancestor({id => $library_group->id});
154 if($root->ft_local_hold_group) {
155 push @hold_libraries, $root->all_libraries;
161 grep { !$seen{ $_->id }++ } @hold_libraries;
163 return @hold_libraries;
166 =head3 validate_hold_sibling
168 Return if given library is a valid hold group member
172 sub validate_hold_sibling {
173 my ( $self, $params ) = @_;
174 my @hold_libraries = $self->get_hold_libraries;
176 foreach (@hold_libraries) {
177 my $hold_library = $_;
179 foreach my $key (keys %$params) {
180 unless($hold_library->$key eq $params->{$key}) {
186 #Found one library that meets all search parameters
193 =head2 Internal methods