package C4::SMS;
# Copyright 2007 Liblime
+# Copyright 2015 Biblibre
+# Copyright 2016 Catalyst
#
# This file is part of Koha.
#
=head1 DESCRIPTION
+A wrapper for SMS::Send.
+Can use a yaml file for config, the path to which is in the koha-conf.xml
+<sms_send_config>__KOHA_CONF_DIR__/sms_send/</sms_send_config>
+
+Each file needs to be in the format of
+__KOHA_CONF_DIR__/sms_send/<driver>.yaml
+
+For example for SMS::Send::UK::Kapow the config would be
+
+/etc/koha/sites/instancename/sms_send/UK/Kapow.yaml for package install
+or
+/etc/koha/sms_send/UK/Kapow.yaml for tarball
+
+A underscore character is prepended to all parameter names so they are
+treated as driver-specific options (leading underscore must not appear
+in config file).
=cut
use warnings;
use C4::Context;
+use File::Spec;
-use vars qw( $VERSION );
-BEGIN {
- $VERSION = 3.07.00.049;
-}
=head1 METHODS
my $driver = exists $params->{'driver'} ? $params->{'driver'} : $self->driver();
return unless $driver;
- # warn "using driver: $driver to send message to $params->{'destination'}";
-
my ($sent, $sender);
+
+ my $subpath = $driver;
+ $subpath =~ s|::|/|g;
+
+ my $sms_send_config = C4::Context->config('sms_send_config');
+ my $conf_file = defined $sms_send_config
+ ? File::Spec->catfile( $sms_send_config, $subpath )
+ : $subpath;
+ $conf_file .= q{.yaml};
+
+ my %args;
+ if ( -f $conf_file ) {
+ require YAML;
+ my $conf = YAML::LoadFile( $conf_file );
+ %args = map { q{_} . $_ => $conf->{$_} } keys %$conf;
+ }
+
eval {
# Create a sender
- $sender = SMS::Send->new( $driver,
- _login => C4::Context->preference('SMSSendUsername'),
- _password => C4::Context->preference('SMSSendPassword'),
- );
-
+ $sender = SMS::Send->new(
+ $driver,
+ _login => C4::Context->preference('SMSSendUsername'),
+ _password => C4::Context->preference('SMSSendPassword'),
+ %args,
+ );
+
# Send a message
- $sent = $sender->send_sms( to => $params->{'destination'},
- text => $params->{'message'},
- );
+ $sent = $sender->send_sms(
+ to => $params->{destination},
+ text => $params->{message},
+ );
};
+
#We might die because SMS::Send $driver is not defined or the sms-number has a bad format
#Catch those errors and fail the sms-sending gracefully.
if ($@) {