# Web http://www.lx-office.org
#
#=====================================================================
-# SQL-Ledger Accounting
-# Copyright (C) 2001
-#
-# Author: Dieter Simader
-# Email: dsimader@sql-ledger.org
-# Web: http://www.sql-ledger.org
-#
-# Contributors:
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# GNU General Public License for more details.
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
-# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
+# MA 02110-1335, USA.
#======================================================================
package Mailer;
use Email::Address;
+use Email::MIME::Creator;
+use Encode;
+use File::MimeInfo::Magic;
+use File::Slurp;
+use List::UtilsBy qw(bundle_by);
use SL::Common;
-use SL::MIME;
+use SL::DB::EmailJournal;
+use SL::DB::EmailJournalAttachment;
+use SL::DB::Employee;
use SL::Template;
+use SL::Version;
+
+use strict;
my $num_sent = 0;
+my %mail_delivery_modules = (
+ sendmail => 'SL::Mailer::Sendmail',
+ smtp => 'SL::Mailer::SMTP',
+);
+
+my %type_to_table = (
+ sales_quotation => 'oe',
+ request_quotation => 'oe',
+ sales_order => 'oe',
+ purchase_order => 'oe',
+ invoice => 'ar',
+ credit_note => 'ar',
+ purchase_invoice => 'ap',
+ letter => 'letter',
+ purchase_delivery_order => 'delivery_orders',
+ sales_delivery_order => 'delivery_orders',
+);
+
sub new {
- $main::lxdebug->enter_sub();
+ my ($type, %params) = @_;
+ my $self = { %params };
+
+ bless $self, $type;
+}
- my ($type) = @_;
- my $self = {};
+sub _create_driver {
+ my ($self) = @_;
- $main::lxdebug->leave_sub();
+ my %params = (
+ mailer => $self,
+ form => $::form,
+ myconfig => \%::myconfig,
+ );
- bless $self, $type;
+ my $module = $mail_delivery_modules{ $::lx_office_conf{mail_delivery}->{method} };
+ eval "require $module" or return undef;
+
+ return $module->new(%params);
}
-sub mime_quote_text {
- $main::lxdebug->enter_sub();
+sub _cleanup_addresses {
+ my ($self) = @_;
- my ($self, $text, $chars_left) = @_;
+ foreach my $item (qw(to cc bcc)) {
+ next unless $self->{$item};
- my $q_start = "=?$self->{charset}?Q?";
- my $l_start = length($q_start);
+ $self->{$item} =~ s/\</</g;
+ $self->{$item} =~ s/\$<\$/</g;
+ $self->{$item} =~ s/\>/>/g;
+ $self->{$item} =~ s/\$>\$/>/g;
+ }
+}
- my $new_text = "$q_start";
- $chars_left -= $l_start if (defined $chars_left);
+sub _create_message_id {
+ my ($self) = @_;
- for (my $i = 0; $i < length($text); $i++) {
- my $char = ord(substr($text, $i, 1));
+ $num_sent += 1;
+ my $domain = $self->{from};
+ $domain =~ s/.*\@//;
+ $domain =~ s/>.*//;
- if (($char < 32) || ($char > 127) || ($char == ord('?')) || ($char == ord('_'))) {
- if ((defined $chars_left) && ($chars_left < 5)) {
- $new_text .= "?=\n $q_start";
- $chars_left = 75 - $l_start;
- }
+ return "kivitendo-" . SL::Version->get_version . "-" . time() . "-${$}-${num_sent}\@$domain";
+}
+
+sub _create_address_headers {
+ my ($self) = @_;
+
+ # $self->{addresses} collects the recipients for use in e.g. the
+ # SMTP 'RCPT TO:' envelope command. $self->{headers} collects the
+ # headers that make up the actual email. 'BCC' should not be
+ # included there for certain transportation methods (SMTP).
+
+ $self->{addresses} = {};
+
+ foreach my $item (qw(from to cc bcc)) {
+ $self->{addresses}->{$item} = [];
+ next if !$self->{$item};
- $new_text .= sprintf("=%02X", $char);
- $chars_left -= 3 if (defined $chars_left);
+ my @header_addresses;
- } else {
- $char = ord('_') if ($char == ord(' '));
- if ((defined $chars_left) && ($chars_left < 5)) {
- $new_text .= "?=\n $q_start";
- $chars_left = 75 - $l_start;
+ foreach my $addr_obj (Email::Address->parse($self->{$item})) {
+ push @{ $self->{addresses}->{$item} }, $addr_obj->address;
+ next if $self->{driver}->keep_from_header($item);
+
+ my $phrase = $addr_obj->phrase();
+ if ($phrase) {
+ $phrase =~ s/^\"//;
+ $phrase =~ s/\"$//;
+ $addr_obj->phrase($phrase);
}
- $new_text .= chr($char);
- $chars_left-- if (defined $chars_left);
+ push @header_addresses, $addr_obj->format;
}
+
+ push @{ $self->{headers} }, ( ucfirst($item) => join(', ', @header_addresses) ) if @header_addresses;
}
+}
- $new_text .= "?=";
+sub _create_attachment_part {
+ my ($self, $attachment) = @_;
- $main::lxdebug->leave_sub();
+ my %attributes = (
+ disposition => 'attachment',
+ encoding => 'base64',
+ );
- return $new_text;
-}
+ my $attachment_content;
+ my $file_id = 0;
+ my $email_journal = $::instance_conf->get_email_journal;
-sub send {
- $main::lxdebug->enter_sub();
+ if (ref($attachment) eq "HASH") {
+ $attributes{filename} = $attachment->{name};
+ $file_id = $attachment->{id} || '0';
+ $attributes{content_type} = $attachment->{type} || 'application/pdf';
+ $attachment_content = $attachment->{content};
+ $attachment_content = eval { read_file($attachment->{path}) } if !$attachment_content;
- my ($self) = @_;
+ } else {
+ $attributes{filename} = $attachment;
+ $attributes{filename} =~ s:.*\Q$self->{fileid}\E:: if $self->{fileid};
+ $attributes{filename} =~ s:.*/::g;
+
+ my $application = ($attachment =~ /(^\w+$)|\.(html|text|txt|sql)$/) ? 'text' : 'application';
+ $attributes{content_type} = File::MimeInfo::Magic::magic($attachment);
+ $attributes{content_type} ||= "${application}/$self->{format}" if $self->{format};
+ $attributes{content_type} ||= 'application/octet-stream';
+ $attachment_content = eval { read_file($attachment) };
+ }
- local (*IN, *OUT);
+ return undef if $email_journal > 1 && !defined $attachment_content;
- $num_sent++;
- my $boundary = time() . "-$$-${num_sent}";
- $boundary = "LxOffice-$self->{version}-$boundary";
- my $domain = $self->{from};
- $domain =~ s/(.*?\@|>)//g;
- my $msgid = "$boundary\@$domain";
+ $attachment_content ||= ' ';
+ $attributes{charset} = $self->{charset} if $self->{charset} && ($attributes{content_type} =~ m{^text/});
- my $form = $main::form;
- my $myconfig = \%main::myconfig;
+ my $ent;
+ if ( $attributes{content_type} eq 'message/rfc822' ) {
+ $ent = Email::MIME->new($attachment_content);
+ } else {
+ $ent = Email::MIME->create(
+ attributes => \%attributes,
+ body => $attachment_content,
+ );
+ }
- my $email = $myconfig->{email};
- $email =~ s/[^\w\.\-\+=@]//ig;
+ # Due to a bug in Email::MIME it's not enough to hand over the encoded file name in the "attributes" hash in the
+ # "create" call. Email::MIME iterates over the keys in the hash, and depending on which key it has already seen during
+ # the iteration it might revert the encoding. As Perl's hash key order is randomized for each Perl run, this means
+ # that the file name stays unencoded sometimes.
+ # Setting the header manually after the "create" call circumvents this problem.
+ $ent->header_set('Content-disposition' => 'attachment; filename="' . encode('MIME-Q', $attributes{filename}) . '"');
+
+ push @{ $self->{mail_attachments}} , SL::DB::EmailJournalAttachment->new(
+ name => $attributes{filename},
+ mime_type => $attributes{content_type},
+ content => ( $email_journal > 1 ? $attachment_content : ' '),
+ file_id => $file_id,
+ );
+
+ return $ent;
+}
+
+sub _create_message {
+ my ($self) = @_;
+
+ my @parts;
- my %temp_form = ( %{ $form }, 'myconfig_email' => $email );
- my $template = PlainTextTemplate->new(undef, \%temp_form, $myconfig);
- my $sendmail = $template->parse_block($main::sendmail);
+ push @{ $self->{headers} }, (Type => "multipart/mixed");
- if (!open(OUT, $sendmail)) {
- $main::lxdebug->leave_sub();
- return "$sendmail : $!";
+ if ($self->{message}) {
+ push @parts, Email::MIME->create(
+ attributes => {
+ content_type => $self->{content_type},
+ charset => $self->{charset},
+ encoding => 'quoted-printable',
+ },
+ body_str => $self->{message},
+ );
+
+ push @{ $self->{headers} }, (
+ 'Content-Type' => qq|$self->{content_type}; charset="$self->{charset}"|,
+ );
}
- $self->{charset} ||= Common::DEFAULT_CHARSET;
- $self->{contenttype} ||= "text/plain";
+ push @parts, grep { $_ } map { $self->_create_attachment_part($_) } @{ $self->{attachments} || [] };
- foreach my $item (qw(to cc bcc)) {
- next unless ($self->{$item});
- $self->{$item} =~ s/\</</g;
- $self->{$item} =~ s/\$<\$/</g;
- $self->{$item} =~ s/\>/>/g;
- $self->{$item} =~ s/\$>\$/>/g;
+ return Email::MIME->create(
+ header_str => $self->{headers},
+ parts => \@parts,
+ );
+}
+
+sub send {
+ my ($self) = @_;
+
+ # Create driver for delivery method (sendmail/SMTP)
+ $self->{driver} = eval { $self->_create_driver };
+ if (!$self->{driver}) {
+ my $error = $@;
+ $self->_store_in_journal('failed', 'driver could not be created; check your configuration & log files');
+ $::lxdebug->message(LXDebug::WARN(), "Mailer error during 'send': $error");
+
+ return $error;
}
- my $headers = '';
- foreach my $item (qw(from to cc bcc)) {
- next unless ($self->{$item});
- my (@addr_objects) = Email::Address->parse($self->{$item});
- next unless (scalar @addr_objects);
+ # Set defaults & headers
+ $self->{charset} = 'UTF-8';
+ $self->{content_type} ||= "text/plain";
+ $self->{headers} ||= [];
+ push @{ $self->{headers} }, (
+ Subject => $self->{subject},
+ 'Message-ID' => '<' . $self->_create_message_id . '>',
+ 'X-Mailer' => "kivitendo " . SL::Version->get_version,
+ );
+ $self->{mail_attachments} = [];
+ $self->{content_by_name} = $::instance_conf->get_email_journal == 1 && $::instance_conf->get_doc_files;
- foreach my $addr_obj (@addr_objects) {
- my $phrase = $addr_obj->phrase();
- if ($phrase) {
- $phrase =~ s/^\"//;
- $phrase =~ s/\"$//;
- $addr_obj->phrase($self->mime_quote_text($phrase));
- }
+ my $error;
+ my $ok = eval {
+ # Clean up To/Cc/Bcc address fields
+ $self->_cleanup_addresses;
+ $self->_create_address_headers;
- $headers .= sprintf("%s: %s\n", ucfirst($item), $addr_obj->format());
- }
+ my $email = $self->_create_message;
+
+ my $from_obj = (Email::Address->parse($self->{from}))[0];
+
+ $self->{driver}->start_mail(from => $from_obj->address, to => [ $self->_all_recipients ]);
+ $self->{driver}->print($email->as_string);
+ $self->{driver}->send;
+
+ 1;
+ };
+
+ $error = $@ if !$ok;
+
+ # create journal and link to record
+ $self->{journalentry} = $self->_store_in_journal;
+ $self->_create_record_link if $self->{journalentry};
+
+ return $ok ? '' : ($error || "undefined error");
+}
+
+sub _all_recipients {
+ my ($self) = @_;
+ $self->{addresses} ||= {};
+ return map { @{ $self->{addresses}->{$_} || [] } } qw(to cc bcc);
+}
+
+sub _store_in_journal {
+ my ($self, $status, $extended_status) = @_;
+
+ my $journal_enable = $::instance_conf->get_email_journal;
+
+ return if $journal_enable == 0;
+
+ $status //= $self->{driver}->status if $self->{driver};
+ $status //= 'failed';
+ $extended_status //= $self->{driver}->extended_status if $self->{driver};
+ $extended_status //= 'unknown error';
+
+ my $headers = join "\r\n", (bundle_by { join(': ', @_) } 2, @{ $self->{headers} || [] });
+
+ my $jentry = SL::DB::EmailJournal->new(
+ sender => SL::DB::Manager::Employee->current,
+ from => $self->{from} // '',
+ recipients => join(', ', $self->_all_recipients),
+ subject => $self->{subject} // '',
+ headers => $headers,
+ body => $self->{message} // '',
+ sent_on => DateTime->now_local,
+ attachments => \@{ $self->{mail_attachments} },
+ status => $status,
+ extended_status => $extended_status,
+ )->save;
+ return $jentry->id;
+}
+
+
+sub _create_record_link {
+ my ($self) = @_;
+
+ # check for custom/overloaded types and ids (form != controller)
+ my $record_type = $self->{record_type} || $::form->{type};
+ my $record_id = $self->{record_id} || $::form->{id};
+
+ # you may send mails for unsaved objects (no record_id => unlinkable case)
+ if ($self->{journalentry} && $record_id && exists($type_to_table{$record_type})) {
+ RecordLinks->create_links(
+ mode => 'ids',
+ from_table => $type_to_table{$record_type},
+ from_ids => $record_id,
+ to_table => 'email_journal',
+ to_id => $self->{journalentry},
+ );
}
+}
- $headers .= sprintf("Subject: %s\n", $self->mime_quote_text($self->{subject}, 60));
+1;
- print OUT qq|${headers}Message-ID: <$msgid>
-X-Mailer: Lx-Office $self->{version}
-MIME-Version: 1.0
-|;
- if ($self->{attachments}) {
- print OUT qq|Content-Type: multipart/mixed; boundary="$boundary"
+__END__
-|;
- if ($self->{message}) {
- print OUT qq|--${boundary}
-Content-Type: $self->{contenttype}; charset="$self->{charset}"
+=pod
-$self->{message}
+=encoding utf8
-|;
- }
+=head1 NAME
- foreach my $attachment (@{ $self->{attachments} }) {
+SL::Mailer - Base class for sending mails from kivitendo
- my $filename;
+=head1 SYNOPSIS
- if (ref($attachment) eq "HASH") {
- $filename = $attachment->{"name"};
- $attachment = $attachment->{"filename"};
- } else {
- $filename = $attachment;
- # strip path
- $filename =~ s/(.*\/|\Q$self->{fileid}\E)//g;
- }
+ package SL::BackgroundJob::CreatePeriodicInvoices;
- my $application = ($attachment =~ /(^\w+$)|\.(html|text|txt|sql)$/) ? "text" : "application";
- my $content_type = SL::MIME->mime_type_from_ext($filename);
- $content_type = "${application}/$self->{format}" if (!$content_type && $self->{format});
- $content_type ||= 'application/octet-stream';
+ use SL::Mailer;
- open(IN, $attachment);
- if ($?) {
- close(OUT);
- $main::lxdebug->leave_sub();
- return "$attachment : $!";
- }
+ my $mail = Mailer->new;
+ $mail->{from} = $config{periodic_invoices}->{email_from};
+ $mail->{to} = $email;
+ $mail->{subject} = $config{periodic_invoices}->{email_subject};
+ $mail->{content_type} = $filename =~ m/.html$/ ? 'text/html' : 'text/plain';
+ $mail->{message} = $output;
- # only set charset for attachements of type text. every other type should not have this field
- # refer to bug 883 for detailed information
- my $attachment_charset;
- if (lc $application eq 'text' && $self->{charset}) {
- $attachment_charset = qq|; charset="$self->{charset}" |;
- }
+ $mail->send;
- print OUT qq|--${boundary}
-Content-Type: ${content_type}; name="$filename"$attachment_charset
-Content-Transfer-Encoding: BASE64
-Content-Disposition: attachment; filename="$filename"\n\n|;
+=head1 OVERVIEW
- my $msg = "";
- while (<IN>) {
- ;
- $msg .= $_;
- }
- print OUT &encode_base64($msg);
+Mail can be sent from kivitendo via the sendmail command or the smtp protocol.
- close(IN);
- }
- print OUT qq|--${boundary}--\n|;
+=head1 INTERNAL DATA TYPES
- } else {
- print OUT qq|Content-Type: $self->{contenttype}; charset="$self->{charset}"
-$self->{message}
-|;
- }
+=over 2
- close(OUT);
+=item C<%mail_delivery_modules>
- $main::lxdebug->leave_sub();
+ Currently two modules are supported: smtp or sendmail.
- return "";
-}
+=item C<%type_to_table>
-sub encode_base64 ($;$) {
- $main::lxdebug->enter_sub();
+ Due to the lack of a single global mapping for $form->{type},
+ type is mapped to the corresponding database table. All types which
+ implement a mail action are currently mapped and should be mapped.
+ Type is either the value of the old form or the newer controller
+ based object type.
- # this code is from the MIME-Base64-2.12 package
- # Copyright 1995-1999,2001 Gisle Aas <gisle@ActiveState.com>
+=back
- my $res = "";
- my $eol = $_[1];
- $eol = "\n" unless defined $eol;
- pos($_[0]) = 0; # ensure start at the beginning
+=head1 FUNCTIONS
- $res = join '', map(pack('u', $_) =~ /^.(\S*)/, ($_[0] =~ /(.{1,45})/gs));
+=over 4
- $res =~ tr|` -_|AA-Za-z0-9+/|; # `# help emacs
- # fix padding at the end
- my $padding = (3 - length($_[0]) % 3) % 3;
- $res =~ s/.{$padding}$/'=' x $padding/e if $padding;
+=item C<new>
- # break encoded string into lines of no more than 60 characters each
- if (length $eol) {
- $res =~ s/(.{1,60})/$1$eol/g;
- }
+=item C<_create_driver>
- $main::lxdebug->leave_sub();
+=item C<_cleanup_addresses>
- return $res;
-}
+=item C<_create_address_headers>
-1;
+=item C<_create_message_id>
+
+=item C<_create_attachment_part>
+
+=item C<_create_message>
+
+=item C<send>
+
+ If a mail was sent successfully the internal function _store_in_journal
+ is called if email journaling is enabled. If _store_in_journal was executed
+ successfully and the calling form is already persistent (database id) a
+ record_link will be created.
+
+=item C<_all_recipients>
+
+=item C<_store_in_journal>
+
+=item C<_create_record_link $self->{journalentry}, $::form->{id}, $self->{record_id}>
+
+
+ If $self->{journalentry} and either $self->{record_id} or $::form->{id} (checked in
+ this order) exist a record link from record to email journal is created.
+ Will fail silently if record_link creation wasn't successful (same behaviour as
+ _store_in_journal).
+
+=item C<validate>
+
+=back
+
+=head1 BUGS
+
+Nothing here yet.
+
+=head1 AUTHOR
+=cut