C4/SMS.pm

   1 package C4::SMS;
   2
   3 # Copyright 2007 Liblime
   4 #
   5 # This file is part of Koha.
   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 =head1 NAME
  21
  22 C4::SMS - send SMS messages
  23
  24 =head1 SYNOPSIS
  25
  26 my $success = C4::SMS->send_sms({ message     => 'This is my text message',
  27                                   destination => '212-555-1212' });
  28
  29 =head1 DESCRIPTION
  30
  31
  32
  33 =cut
  34
  35 use strict;
  36 use warnings;
  37
  38 use C4::Context;
  39
  40 use vars qw( $VERSION );
  41
  42 BEGIN {
  43     $VERSION = 3.07.00.049;
  44 }
  45
  46 =head1 METHODS
  47
  48 =cut
  49
  50 # The previous implmentation used username and password.
  51 # our $user = C4::Context->config('smsuser');
  52 # our $pwd  = C4::Context->config('smspass');
  53
  54 =head2 send_sms
  55
  56 =cut
  57
  58 sub send_sms {
  59     my $self = shift;
  60     my $params= shift;
  61
  62     foreach my $required_parameter ( qw( message destination ) ) {
  63         # Should I warn in some way?
  64         return unless defined $params->{ $required_parameter };
  65     }
  66
  67     eval { require SMS::Send; };
  68     if ( $@ ) {
  69         # we apparently don't have SMS::Send. Return a failure.
  70         return;
  71     }
  72
  73     # This allows the user to override the driver. See SMS::Send::Test
  74     my $driver = exists $params->{'driver'} ? $params->{'driver'} : $self->driver();
  75     return unless $driver;
  76
  77     # warn "using driver: $driver to send message to $params->{'destination'}";
  78
  79     my ($sent, $sender);
  80     eval {
  81         # Create a sender
  82         $sender = SMS::Send->new( $driver,
  83                                  _login    => C4::Context->preference('SMSSendUsername'),
  84                                  _password => C4::Context->preference('SMSSendPassword'),
  85                             );
  86
  87         # Send a message
  88         $sent = $sender->send_sms( to   => $params->{'destination'},
  89                                   text => $params->{'message'},
  90                              );
  91     };
  92     #We might die because SMS::Send $driver is not defined or the sms-number has a bad format
  93     #Catch those errors and fail the sms-sending gracefully.
  94     if ($@) {
  95         warn $@;
  96         return;
  97     }
  98     # warn 'failure' unless $sent;
  99     return $sent;
 100 }
 101
 102 =head2 driver
 103
 104 =cut
 105
 106 sub driver {
 107     my $self = shift;
 108
 109     # return 'US::SprintPCS';
 110     return C4::Context->preference('SMSSendDriver');
 111
 112 }
 113
 114 1;
 115
 116 __END__
 117