* 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 * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.See the * 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, see . */ /** * Mail Transport * * @author f0o * @copyright 2014 f0o, LibreNMS * @license GPL */ namespace LibreNMS\Alert\Transport; use LibreNMS\Alert\AlertUtil; use LibreNMS\Alert\Transport; use LibreNMS\Config; class Mail extends Transport { public function deliverAlert(array $alert_data): bool { $emails = match ($this->config['mail-contact'] ?? '') { 'sysContact' => AlertUtil::findContactsSysContact($alert_data['faults']), 'owners' => AlertUtil::findContactsOwners($alert_data['faults']), 'role' => AlertUtil::findContactsRoles([$this->config['role']]), default => $this->config['email'], }; $html = Config::get('email_html'); if ($html && ! $this->isHtmlContent($alert_data['msg'])) { // if there are no html tags in the content, but we are sending an html email, use br for line returns instead $msg = preg_replace("/\r?\n/", "
\n", $alert_data['msg']); } else { // fix line returns for windows mail clients $msg = preg_replace("/(?config['bcc'] ?? false, $this->config['attach-graph'] ?? null); } public static function configTemplate(): array { $roles = array_merge(['None' => ''], \Bouncer::role()->pluck('name', 'title')->all()); return [ 'config' => [ [ 'title' => 'Contact Type', 'name' => 'mail-contact', 'descr' => 'Method for selecting contacts', 'type' => 'select', 'options' => [ 'Specified Email' => 'email', 'Device sysContact' => 'sysContact', 'Owner(s)' => 'owners', 'Role' => 'role', ], 'default' => 'email', ], [ 'title' => 'Email', 'name' => 'email', 'descr' => 'Email address of contact', 'type' => 'text', ], [ 'title' => 'Role', 'name' => 'role', 'descr' => 'Role of users to mail', 'type' => 'select', 'options' => $roles, ], [ 'title' => 'BCC', 'name' => 'bcc', 'descr' => 'Use BCC instead of TO', 'type' => 'checkbox', 'default' => false, ], [ 'title' => 'Include Graphs', 'name' => 'attach-graph', 'descr' => 'Include graph image data in the email. Will be embedded if html5, otherwise attached. Template must use @signedGraphTag', 'type' => 'checkbox', 'default' => true, ], ], 'validation' => [ 'mail-contact' => 'required|in:email,sysContact,owners,role', 'email' => 'required_if:mail-contact,email|prohibited_unless:mail-contact,email|email', 'role' => 'required_if:mail-contact,role|prohibited_unless:mail-contact,role|exists:roles,name', ], ]; } }