* @copyright Copyright (c) Alex Tselegidis * @license https://opensource.org/licenses/GPL-3.0 - GPLv3 * @link https://easyappointments.org * @since v1.4.0 * ---------------------------------------------------------------------------- */ /** * Notifications library. * * Handles the notifications related functionality. * * @package Libraries */ class Notifications { /** * @var EA_Controller|CI_Controller */ protected EA_Controller|CI_Controller $CI; /** * Notifications constructor. */ public function __construct() { $this->CI = &get_instance(); $this->CI->load->model('admins_model'); $this->CI->load->model('appointments_model'); $this->CI->load->model('providers_model'); $this->CI->load->model('secretaries_model'); $this->CI->load->model('secretaries_model'); $this->CI->load->model('settings_model'); $this->CI->load->library('email_messages'); $this->CI->load->library('ics_file'); $this->CI->load->library('timezones'); } /** * Send the required notifications, related to an appointment creation/modification. * * @param array $appointment Appointment data. * @param array $service Service data. * @param array $provider Provider data. * @param array $customer Customer data. * @param array $settings Required settings. * @param bool|false $manage_mode Manage mode. */ public function notify_appointment_saved( array $appointment, array $service, array $provider, array $customer, array $settings, bool $manage_mode = false ): void { try { $current_language = config('english'); $customer_link = site_url('booking/reschedule/' . $appointment['hash']); $provider_link = site_url('calendar/reschedule/' . $appointment['hash']); $ics_stream = $this->CI->ics_file->get_stream($appointment, $service, $provider, $customer); // Notify customer. $send_customer = !empty($customer['email']) && filter_var(setting('customer_notifications'), FILTER_VALIDATE_BOOLEAN); if ($send_customer === true) { config(['language' => $customer['language']]); $this->CI->lang->load('translations'); $subject = $manage_mode ? lang('appointment_details_changed') : lang('appointment_booked'); $message = $manage_mode ? '' : lang('thank_you_for_appointment'); $this->CI->email_messages->send_appointment_saved( $appointment, $provider, $service, $customer, $settings, $subject, $message, $customer_link, $customer['email'], $ics_stream, $customer['timezone'] ); } // Notify provider. $send_provider = filter_var( $this->CI->providers_model->get_setting($provider['id'], 'notifications'), FILTER_VALIDATE_BOOLEAN ); if ($send_provider === true) { config(['language' => $provider['language']]); $this->CI->lang->load('translations'); $subject = $manage_mode ? lang('appointment_details_changed') : lang('appointment_added_to_your_plan'); $message = $manage_mode ? '' : lang('appointment_link_description'); $this->CI->email_messages->send_appointment_saved( $appointment, $provider, $service, $customer, $settings, $subject, $message, $provider_link, $provider['email'], $ics_stream, $provider['timezone'] ); } // Notify admins. $admins = $this->CI->admins_model->get(); foreach ($admins as $admin) { if ($admin['settings']['notifications'] === '0') { continue; } config(['language' => $admin['language']]); $this->CI->lang->load('translations'); $subject = $manage_mode ? lang('appointment_details_changed') : lang('appointment_added_to_your_plan'); $message = $manage_mode ? '' : lang('appointment_link_description'); $this->CI->email_messages->send_appointment_saved( $appointment, $provider, $service, $customer, $settings, $subject, $message, $provider_link, $admin['email'], $ics_stream, $admin['timezone'] ); } // Notify secretaries. $secretaries = $this->CI->secretaries_model->get(); foreach ($secretaries as $secretary) { if ($secretary['settings']['notifications'] === '0') { continue; } if (!in_array($provider['id'], $secretary['providers'])) { continue; } config(['language' => $secretary['language']]); $this->CI->lang->load('translations'); $subject = $manage_mode ? lang('appointment_details_changed') : lang('appointment_added_to_your_plan'); $message = $manage_mode ? '' : lang('appointment_link_description'); $this->CI->email_messages->send_appointment_saved( $appointment, $provider, $service, $customer, $settings, $subject, $message, $provider_link, $secretary['email'], $ics_stream, $secretary['timezone'] ); } } catch (Throwable $e) { log_message( 'error', 'Notifications - Could not email confirmation details of appointment (' . ($appointment['id'] ?? '-') . ') : ' . $e->getMessage() ); log_message('error', $e->getTraceAsString()); } finally { config(['language' => $current_language ?? 'english']); $this->CI->lang->load('translations'); } } /** * Send the required notifications, related to an appointment removal. * * @param array $appointment Appointment data. * @param array $service Service data. * @param array $provider Provider data. * @param array $customer Customer data. * @param array $settings Required settings. */ public function notify_appointment_deleted( array $appointment, array $service, array $provider, array $customer, array $settings, string $cancellation_reason = '' ): void { try { $current_language = config('language'); // Notify provider. $send_provider = filter_var( $this->CI->providers_model->get_setting($provider['id'], 'notifications'), FILTER_VALIDATE_BOOLEAN ); if ($send_provider === true) { config(['language' => $provider['language']]); $this->CI->lang->load('translations'); $this->CI->email_messages->send_appointment_deleted( $appointment, $provider, $service, $customer, $settings, $provider['email'], $cancellation_reason, $provider['timezone'] ); } // Notify customer. $send_customer = !empty($customer['email']) && filter_var(setting('customer_notifications'), FILTER_VALIDATE_BOOLEAN); if ($send_customer === true) { config(['language' => $customer['language']]); $this->CI->lang->load('translations'); $this->CI->email_messages->send_appointment_deleted( $appointment, $provider, $service, $customer, $settings, $customer['email'], $cancellation_reason, $customer['timezone'] ); } // Notify admins. $admins = $this->CI->admins_model->get(); foreach ($admins as $admin) { if ($admin['settings']['notifications'] === '0') { continue; } config(['language' => $admin['language']]); $this->CI->lang->load('translations'); $this->CI->email_messages->send_appointment_deleted( $appointment, $provider, $service, $customer, $settings, $admin['email'], $cancellation_reason, $admin['timezone'] ); } // Notify secretaries. $secretaries = $this->CI->secretaries_model->get(); foreach ($secretaries as $secretary) { if ($secretary['settings']['notifications'] === '0') { continue; } if (!in_array($provider['id'], $secretary['providers'])) { continue; } config(['language' => $secretary['language']]); $this->CI->lang->load('translations'); $this->CI->email_messages->send_appointment_deleted( $appointment, $provider, $service, $customer, $settings, $secretary['email'], $cancellation_reason, $secretary['timezone'] ); } } catch (Throwable $e) { log_message( 'error', 'Notifications - Could not email cancellation details of appointment (' . ($appointment['id'] ?? '-') . ') : ' . $e->getMessage() ); log_message('error', $e->getTraceAsString()); } finally { config(['language' => $current_language ?? 'english']); $this->CI->lang->load('translations'); } } }