<?php use NinjaForms\Includes\Abstracts\SotAction; use NinjaForms\Includes\Traits\SotGetActionProperties; use NinjaForms\Includes\Interfaces\SotAction as InterfacesSotAction; if (! defined('ABSPATH')) exit; /** * Class NF_Action_Email */ final class NF_Actions_Email extends SotAction implements InterfacesSotAction { use SotGetActionProperties; /** * @var array */ protected $_tags = array(); /** * Constructor */ public function __construct() { parent::__construct(); $this->_name = 'email'; $this->_timing = 'late'; $this->_priority = 10; $this->_documentation_url = 'https://ninjaforms.com/docs/email/'; $this->_group = 'core'; add_action('init', [$this, 'initHook']); } public function initHook() { $this->_nicename = esc_html__('Email', 'ninja-forms'); $settings = Ninja_Forms::config('ActionEmailSettings'); $this->_settings = array_merge($this->_settings, $settings); $this->_backwards_compatibility(); } /* * PUBLIC METHODS */ /** @inheritDoc */ public function process(array $action_settings, int $form_id, array $data): array { $action_settings = $this->sanitize_address_fields($action_settings); $errors = $this->check_for_errors($action_settings); $headers = $this->_get_headers($action_settings); if (has_filter('ninja_forms_get_fields_sorted')) { $fields_by_key = array(); foreach ($data['fields'] as $fieldId => $field) { if (is_null($field)) continue; if (is_array($field)) { if (! isset($field['key'])) continue; $key = $field['key']; // add field id if it isn't already set if (!isset($field['id'])) { $field['id'] = $fieldId; } } else { $key = $field->get_setting('key'); } $fields_by_key[$key] = $field; } $sorted = apply_filters('ninja_forms_get_fields_sorted', array(), $data['fields'], $fields_by_key, $form_id); if (! empty($sorted)) $data['fields'] = $sorted; } $attachments = $this->_get_attachments($action_settings, $data); if ('html' == $action_settings['email_format']) { $message = wpautop($action_settings['email_message']); } else { $message = $this->format_plain_text_message($action_settings['email_message_plain']); } $message = apply_filters('ninja_forms_action_email_message', $message, $data, $action_settings); try { /** * Hook into the email send to override functionality. * @return bool True if already sent. False to fallback to default behavior. Throw a new Exception if there is an error. */ if (! $sent = apply_filters('ninja_forms_action_email_send', false, $action_settings, $message, $headers, $attachments)) { $sent = wp_mail($action_settings['to'], strip_tags($action_settings['email_subject']), $message, $headers, $attachments); } } catch (Exception $e) { $sent = false; $errors['email_not_sent'] = $e->getMessage(); } if (is_user_logged_in() && current_user_can('manage_options')) { $data['actions']['email']['to'] = $action_settings['to']; $data['actions']['email']['headers'] = $headers; $data['actions']['email']['attachments'] = $attachments; } $data['actions']['email']['sent'] = $sent; // Only show errors to Administrators. if ($errors && current_user_can('manage_options')) { $data['errors']['form'] = $errors; } if (! empty($attachments)) { $this->_drop_csv(); } return $data; } /** * Sanitizes email address settings * @since 3.2.2 * * @param array $action_settings * @return array */ protected function sanitize_address_fields($action_settings) { // Build a look array to compare our email address settings to. $email_address_settings = array('to', 'from_address', 'reply_to', 'cc', 'bcc'); // Loop over the look up values. foreach ($email_address_settings as $setting) { // If the loop up values are not set in the action settings continue. if (! isset($action_settings[$setting])) continue; // If action settings do not match the look up values continue. if (! $action_settings[$setting]) continue; // This is the array that will contain the sanitized email address values. $sanitized_array = array(); /* * Checks to see action settings is array, * if not explodes to comma delimited array. */ if (is_array($action_settings[$setting])) { $email_addresses = $action_settings[$setting]; } else { $email_addresses = explode(',', $action_settings[$setting]); } // Loop over our email addresses. foreach ($email_addresses as $email) { // Updated to trim values in case there is a value with spaces/tabs/etc to remove whitespace $email = trim($email); if (empty($email)) continue; // Build our array of the email addresses. $sanitized_array[] = $email; } // Sanitized our array of settings. $action_settings[$setting] = implode(',', $sanitized_array); } return $action_settings; } protected function check_for_errors($action_settings) { $errors = array(); $email_address_settings = array('to', 'from_address', 'reply_to', 'cc', 'bcc'); foreach ($email_address_settings as $setting) { if (! isset($action_settings[$setting])) continue; if (! $action_settings[$setting]) continue; $email_addresses = is_array($action_settings[$setting]) ? $action_settings[$setting] : explode(',', $action_settings[$setting]); foreach ((array) $email_addresses as $email) { $email = trim($email); if (false !== strpos($email, '<') && false !== strpos($email, '>')) { preg_match('/(?:<)([^>]*)(?:>)/', $email, $email); $email = $email[1]; } if (! is_email($email)) { $errors['invalid_email'] = sprintf(esc_html__('Your email action "%s" has an invalid value for the "%s" setting. Please check this setting and try again.', 'ninja-forms'), $action_settings['label'], $setting); } } } return $errors; } private function _get_headers($settings) { $headers = array(); $headers[] = 'Content-Type: text/' . $settings['email_format']; $headers[] = 'charset=UTF-8'; $headers[] = 'X-Ninja-Forms:ninja-forms'; // Flag for transactional email. $headers[] = $this->_format_from($settings); $headers = array_merge($headers, $this->_format_recipients($settings)); return $headers; } private function _get_attachments($settings, $data) { $attachments = array(); if (isset($settings['attach_csv']) && 1 == $settings['attach_csv']) { $attachments[] = $this->_create_csv($data['fields']); } if (! isset($settings['id'])) $settings['id'] = ''; // Allow admins to attach files from media library if (isset($settings['file_attachment']) && 0 < strlen($settings['file_attachment'])) { $file_path = ''; $media_id = attachment_url_to_postid($settings['file_attachment']); if ($media_id !== 0) { $file_path = get_attached_file($media_id); if (0 < strlen($file_path)) { $attachments[] = $file_path; } } } $attachments = apply_filters('ninja_forms_action_email_attachments', $attachments, $data, $settings); return $attachments; } private function _format_from($settings) { $from_name = get_bloginfo('name', 'raw'); $from_name = apply_filters('ninja_forms_action_email_from_name', $from_name); $from_name = ($settings['from_name']) ? $settings['from_name'] : $from_name; $from_address = get_bloginfo('admin_email'); $from_address = apply_filters('ninja_forms_action_email_from_address', $from_address); $from_address = ($settings['from_address']) ? $settings['from_address'] : $from_address; return $this->_format_recipient('from', $from_address, $from_name); } private function _format_recipients($settings) { $headers = array(); $recipient_settings = array( 'Cc' => $settings['cc'], 'Bcc' => $settings['bcc'], 'Reply-to' => $settings['reply_to'], ); foreach ($recipient_settings as $type => $emails) { $emails = explode(',', $emails); foreach ($emails as $email) { if (! $email) continue; $matches = array(); if (preg_match('/^"?(?<name>[^<"]+)"? <(?<email>[^>]+)>$/', $email, $matches)) { $headers[] = $this->_format_recipient($type, $matches['email'], $matches['name']); } else { $headers[] = $this->_format_recipient($type, $email); } } } return $headers; } private function _format_recipient($type, $email, $name = '') { $type = ucfirst($type); if (! $name) $name = $email; $recipient = "$type: $name <$email>"; return $recipient; } private function _create_csv($fields) { $csv_array = array(); // Get our current date. $date_format = Ninja_Forms()->get_setting('date_format'); $today = date($date_format, current_time('timestamp')); $csv_array[0][] = 'Date Submitted'; $csv_array[1][] = $today; foreach ($fields as $field) { $ignore = array( 'hr', 'submit', 'html', 'creditcardcvc', 'creditcardexpiration', 'creditcardfullname', 'creditcardnumber', 'creditcardzip', ); $ignore = apply_filters('ninja_forms_csv_ignore_fields', $ignore); if (! isset($field['label'])) continue; if (in_array($field['type'], $ignore)) continue; $label = ('' != $field['admin_label']) ? $field['admin_label'] : $field['label']; // Escape labels. $label = WPN_Helper::maybe_escape_csv_column($label); if ($field["type"] === "repeater" && isset($field['fields'])) { $value = ""; foreach ($field['fields'] as $field_model) { foreach ($field['value'] as $in_field_value) { $matching_value = substr($in_field_value['id'], 0, strlen($field_model['id'])) === $field_model['id']; $index_found = substr($in_field_value['id'], strpos($in_field_value['id'], "_") + 1); if ($matching_value) { //Catch specific file uploeds data if (isset($in_field_value["files"])) { $field_files_names = []; foreach ($in_field_value["files"] as $file_data) { $field_files_names[] = $file_data["data"]["file_url"]; } $in_field_value['value'] = implode(" , ", $field_files_names); } $value .= $field_model['label'] . "#" . $index_found . " : " . WPN_Helper::stripslashes($in_field_value['value']) . " \n"; }; } } } else { $value = WPN_Helper::stripslashes($field['value']); if (empty($value) && ! isset($value)) { $value = ''; } if (is_array($value)) { $value = implode(',', $value); } } // add filter to add single quote if first character in value is '=' $value = apply_filters('ninja_forms_subs_export_field_value_' . $field['type'], $value, $field); $csv_array[0][] = $label; $csv_array[1][] = $value; } $csv_content = WPN_Helper::str_putcsv( $csv_array, apply_filters('ninja_forms_sub_csv_delimiter', ','), apply_filters('ninja_forms_sub_csv_enclosure', '"'), apply_filters('ninja_forms_sub_csv_terminator', "\n") ); $upload_dir = wp_upload_dir(); $path = trailingslashit($upload_dir['path']); // create temporary file $path = tempnam($path, 'Sub'); $temp_file = fopen($path, 'r+'); // write to temp file fwrite($temp_file, $csv_content); fclose($temp_file); // find the directory we will be using for the final file $path = pathinfo($path); $dir = $path['dirname']; $basename = $path['basename']; // create name for file $new_name = apply_filters('ninja_forms_submission_csv_name', 'ninja-forms-submission'); // remove a file if it already exists if (file_exists($dir . '/' . $new_name . '.csv')) { unlink($dir . '/' . $new_name . '.csv'); } // move file rename($dir . '/' . $basename, $dir . '/' . $new_name . '.csv'); return $dir . '/' . $new_name . '.csv'; } /** * Function to delete csv file from temp directory after Email Action has completed. */ private function _drop_csv() { $upload_dir = wp_upload_dir(); $path = trailingslashit($upload_dir['path']); // create name for file $new_name = apply_filters('ninja_forms_submission_csv_name', 'ninja-forms-submission'); // remove a file if it already exists if (file_exists($path . '/' . $new_name . '.csv')) { unlink($path . '/' . $new_name . '.csv'); } } /* * Backwards Compatibility */ private function _backwards_compatibility() { add_filter('ninja_forms_sub_csv_delimiter', array($this, 'ninja_forms_sub_csv_delimiter'), 10, 1); add_filter('ninja_sub_csv_enclosure', array($this, 'ninja_sub_csv_enclosure'), 10, 1); add_filter('ninja_sub_csv_terminator', array($this, 'ninja_sub_csv_terminator'), 10, 1); add_filter('ninja_forms_action_email_attachments', array($this, 'ninja_forms_action_email_attachments'), 10, 3); } public function ninja_forms_sub_csv_delimiter($delimiter) { return apply_filters('nf_sub_csv_delimiter', $delimiter); } public function ninja_sub_csv_enclosure($enclosure) { return apply_filters('nf_sub_csv_enclosure', $enclosure); } public function ninja_sub_csv_terminator($terminator) { return apply_filters('nf_sub_csv_terminator', $terminator); } public function ninja_forms_action_email_attachments($attachments, $form_data, $action_settings) { return apply_filters('nf_email_notification_attachments', $attachments, $action_settings['id']); } private function format_plain_text_message($message) { $message = str_replace(array('<table>', '</table>', '<tr><td>', ''), '', $message); $message = str_replace('</td><td>', ' ', $message); $message = str_replace('</td></tr>', "\r\n", $message); return strip_tags($message); } }

خدمة

الدفع بلمسه رز .. التحول الرقمي يغير سلوك المستهلك

مايو 23, 2025

8٬634 2 دقائق

كتبت ميرنا أشرف

التطور التكنولوجي بات ينتشر بسرعة كبيرة وانتشر مع تطور أنظمة الدفع وأصبح دفع إلكتروني مثل Apple pay والتطبيقات المصرفية، لم يعد الدفع مجرد عملية اقتصادية، بل أصبح تجربة نفسية مختلفه تمامًا عن الدفع النقدي. أحد أبرز التغيرات التي أحدثها الدفع الإلكتروني وهو لحد من الم الدفع، حيث لم يعد الشخص يشعر بانه يحمل المال أو ينفقه، بل تتم العملية لمسة زر واحدة.

أوضح احد الأطباء النفسيين، أن عملية الدفع الإلكترونية عبر منصات مختلفة و اشهرها في وقتنا هذا Apple pay، من الناحية النفسية فهي تقلل من ألم الدفع النقدي الملموس، وتابع فالشخص الذي يبادر بالدفع النقدي يمكن أن يري أمواله وهي تناقص مما يعزز من شعورك بخساره المال وألم الدفع، لاكن الدفع الإلكتروني في ظل طور التكنولوجيا جعل هذه العملية اسهل و اسرع حيث أن هذه المنصات حَدت من الشعور المباشر بالإنفاق.

مضيفا، أن المستهلكين الذين يستخدمون الدفع غير النقدي ينفقون أكثر مقارنة بمن يعتمدون على الدفع النقدي، لأنهم لا يشعرون بمدى الإنفاق بنفس الطريقة، ومع غياب الشعور الفوري بالخسارة، يصبح الشخص أكثر عرضة لشراء أشياء لم يكن يخطط لها او لمجرد الشراء، ومن ناحية أخري ارتفاع مستوي الإنفاق بمعني أن الأشخاص الذين يدفعون إلكترونيا يميلون إلى إنفاق أكثر من لذين يدفعون نقدًا.

تعزيز الأمان المالي

ومن جانبه أكد خالد الشافعي خبير اقتصادي، أن الدفع الإلكتروني يؤثر في الاقتصاد بشكل عام بالإيجاب من زاوية حصر كل التعاملات التي تتم داخل السوق المصرفية متابعا، أنه من الناحية المالية، تتيح له تجنب حمل النقود باستمرار، مما يقلل من مخاطر التعرض للسرقة، كما تعزز مستوى الأمان والاطمئنان في تعاملاته اليومية.

أوضح الشافعي، أن الدفع الإلكتروني من خلال “أبل باي” يعتمد بشكل أساسي على المحفظة المالية لشخصية، حيث يكون الفرد هو المسؤول عن إدارتها، سواء كان ذلك من خلال راتبه، مكافآته، أو أي صدر دخل آخر. ومع ذلك، من الضروري الانتباه إلى أن سهولة الدفع الإلكتروني قد تودي إلى الانفاق غير المحسوب، خاصة وأن العملية لا تتطلب سوى ضغطة زر على الهاتف لتحويل الأموال وإتمام المعاملات.

لذلك، من المهم توعية الأفراد بضرورة التحكم في نفقاتهم وعدم التسرع في الإنفاق لمجرد سهولة العملية.كما يجب إطلاق برامج توعية لحماية المستهلكين من خطر الإدمان على الدفع الإلكتروني، إلى جانب التحذير من آثاره السلبية على الإدارة المالية الشخصية والاستقرار الاقتصادي للفرد.

بينما قالت أحد مستخدمي نظام “Apple pay” أنه أصبح دفع النقود أسهل بكثير، ولم أعد شعر بأنني أنفق الكثير من المال على عكس الدفع النقدي، فعندما أخرج المال من محفظتي، أشعر أن المال يتناقص بشكل كبير و متزايد، مما جعلني أكثر حذر في الانفاق، وفي بعض الاوقات اشعر بالانزعاج لأنني قد لا اتمكن من شراء اشياء اخرى خلال اليوم.

لذلك، من المهم تعزيز الثقافة المالية وتوعية الأفراد بمخاطر الإنفاق المستمر بشكل مبالغ فيه، حتى لا تتحول سهولة الدفع الإلكتروني إلى عبء مالي. فالتكنولوجيا اداة قوية، لكن حسن استخدامها هو ما يحدد تأثيرها على الاستقرار المالي للفرد والمجتمع.

مايو 23, 2025

8٬634 2 دقائق