<?php use NF_Exports_Interfaces_SubmissionCsvExportInterface As SubmissionCsvExportInterface; use NF_Exports_Interfaces_SubmissionCollectionInterface As SubmissionCollectionInterface; use NinjaForms\Includes\Entities\SubmissionField; use NinjaForms\Includes\Entities\SingleSubmission; use NinjaForms\Includes\Handlers\SubmissionAggregateCsvExportAdapter; use NinjaForms\Includes\Handlers\SubmissionAggregate; /** * */ class NF_Exports_SubmissionCsvExport implements SubmissionCsvExportInterface { /** * Submission Collection * @var SubmissionCollectionInterface */ public $submissionCollection; /** @var SubmissionAggregate */ protected $submissionAggregate; /** @var SubmissionAggregateCsvExportAdapter */ protected $submissionAggregateCsvExportAdapter; /** * Use admin labels boolean * @var bool */ protected $useAdminLabels = false; /** * Date format * @var string */ protected $dateFormat = 'm/d/Y'; /** * Array of submission ids contained in collection * * @var array */ protected $submissionIds; /** * Lookup of NF submission SeqNum by collection Index * * @var array */ protected $seqNumLookup; /** * Field labels keyed on field key * @var array */ protected $fieldLabels = []; /** * Field types keyed on field key * @var array */ protected $fieldTypes = []; /** * Field Ids keyed on field key * @var array */ protected $fieldIds = []; /** * Labels row for CSV * @var array */ protected $csvLabels = []; /** * Complete array for CSV, including labels row * @var array */ protected $csvValuesCollection = []; /** * Generate CSV output and return * @return string */ public function handle(): string { $this->constructLabels(); $this->csvValuesCollection[0][0] = $this->csvLabels; $this->appendRows(); $returned = $this->prepareCsv(); return $returned; } /** * Append each submission from the collection as a row */ protected function appendRows() { $indices = $this->reverseSubmissionOrder(); // populate submission values for each submission in the collection, then append foreach ($indices as $index) { $row = $this->constructRow($index); //Catch reference to an array or repeated fieldsets of repeater field to display each entry as a row if (array_key_exists('repeater', $row) && is_array($row['repeater'])) { foreach ($row['repeater'] as $eachRow) { $this->csvValuesCollection[1][0][] = $eachRow; } } else { $this->csvValuesCollection[1][0][] = $row; } } } /** @inheritDoc */ public function reverseSubmissionOrder(): array { $submissionCollection = $this->submissionAggregateCsvExportAdapter->submissionAggregate->getAggregatedSubmissions(); $indicesOriginalOrder= array_keys($submissionCollection); $return = array_reverse($indicesOriginalOrder); return $return; } /** @inheritDoc */ public function constructRow( $aggregatedKey):array { $singleSubmission = $this->submissionAggregateCsvExportAdapter->submissionAggregate->getSubmissionValuesByAggregatedKey($aggregatedKey); $this->constructSeqNumLookup($aggregatedKey, $singleSubmission); $row = $this->constructSubmissionRow($aggregatedKey, $singleSubmission); //Can be array of $rows since repeaters are divided by rows for each fieldset return $row; } /** * Construct string output from previously set params, mark submissions read * @return string */ protected function prepareCsv() { $nfSubs = []; foreach($this->submissionIds as $submissionId){ $nfSubs[]=Ninja_Forms()->form( )->get_sub( $submissionId ); $subIds[]=$submissionId; } $reversedOrderNfSubs = \array_reverse($nfSubs); // Get any extra data from our other plugins... $csv_array = apply_filters( 'nf_subs_csv_extra_values', $this->csvValuesCollection, $reversedOrderNfSubs, $this->submissionAggregateCsvExportAdapter->submissionAggregate->getMasterFormId() ); $output = WPN_Helper::str_putcsv( $csv_array, apply_filters( 'nf_sub_csv_delimiter', ',' ), apply_filters( 'nf_sub_csv_enclosure', '"' ), apply_filters( 'nf_sub_csv_terminator', "\n" ) ); return $output; } /** * For NF CPT, construct lookup from index for SeqNum * * @param string $aggregatedKey * @param SingleSubmission $singleSubmission * @return void */ protected function constructSeqNumLookup(string $aggregatedKey, SingleSubmission $singleSubmission): void { $dataSource = $singleSubmission->getDataSource(); // only add seq number for NF CPT if('nf_post'!== $dataSource){ return; } $this->seqNumLookup[$aggregatedKey]= get_post_meta($singleSubmission->getSubmissionRecordId(), '_seq_num', TRUE); } /** * Construct a single row in the CSV from a submission * * @todo Refactor to remove DB call for NF()->form()->field() on each iteration * @param SingleSubmission $submission * @return array */ protected function constructSubmissionRow(string $aggregatedKey, SingleSubmission $submission)/* :array */ { // Add the standard fields $seqNum = ''; if(isset($this->seqNumLookup[$aggregatedKey])){ $seqNum = $this->seqNumLookup[$aggregatedKey]; } $row['_seq_num'] = $seqNum; $row['_date_submitted'] = $this->formatTimestamp($submission->getTimestamp()); $columnValues = $this->submissionAggregateCsvExportAdapter->getColumnValuesByAggregatedKey($aggregatedKey); if( array_key_exists('repeater', $columnValues) ){ $strippedRows = []; $newColumnValues = $columnValues; $repeaterValuesArray = []; unset($newColumnValues['repeater']); $row = array_merge($row, $newColumnValues); //Extract Repeater rows foreach($columnValues['repeater'] as $repeaterFieldID => $repeaterFieldsetRowValue){ foreach($repeaterFieldsetRowValue as $index => $fieldsetValue){ $repeaterValuesArray[$index][$repeaterFieldID] = $fieldsetValue; } } //insert global row data in repeater rows foreach($repeaterValuesArray as $rowIncludingRepeaterData){ $row = array_merge($row, $rowIncludingRepeaterData); $strippedRows["repeater"][] = WPN_Helper::stripslashes($row); } return $strippedRows; } else { $row = array_merge($row,$columnValues); $strippedRow = WPN_Helper::stripslashes($row); return $strippedRow; } } /** * Format timestamp for output * * @param string $timestamp * @return string */ protected function formatTimestamp(string $timestamp): string { $dt = DateTime::createFromFormat('Y-m-d H:i:s',$timestamp); $return = $dt->format($this->dateFormat); return $return; } /** * Construct labels array * * Indexed array of labels, which serves as the column headers */ protected function constructLabels() { $this->csvLabels = array_merge($this->getFieldLabelsBeforeFields(), array_values($this->fieldLabels)); } /** * Return labels for the CSV, including SeqNum and Date * * @return array */ public function getLabels( ): array { if(empty($this->csvLabels)){ $this->constructLabels(); } return $this->csvLabels; } /** * Return array of labels preceding fields * * @return array */ protected function getFieldLabelsBeforeFields()/* :array */ { $labels = array( '_seq_num' => '#', '_date_submitted' => esc_html__('Date Submitted', 'ninja-forms') ); return $labels; } /** * Set submission collection used in generating the CSV * * @todo Investigate reason for commented out type declarations * @param SubmissionCollectionInterface $submissionCollection * @return SubmissionCsvExportInterface */ public function setSubmissionCollection(SubmissionCollectionInterface $submissionCollection): SubmissionCsvExportInterface { return $this; } /** * Set SubmissionAggregateCsvExport Adapter used in generating the CSV * * @param SubmissionAggregateCsvExportAdapter $submissionAggregateCsvExportAdapter * @return SubmissionCsvExportInterface */ public function setSubmissionAggregateCsvExportAdapter(SubmissionAggregateCsvExportAdapter $submissionAggregateCsvExportAdapter) :SubmissionCsvExportInterface { $this->setDateFormat(); $this->submissionAggregateCsvExportAdapter = $submissionAggregateCsvExportAdapter; $this->submissionAggregateCsvExportAdapter->setHiddenFieldTypes([ 'html', 'submit', 'divider', 'hr', 'note', 'unknown', 'button', 'confirm' ]); $this->fieldLabels = $this->submissionAggregateCsvExportAdapter->getLabels($this->useAdminLabels); $this->fieldTypes = $this->submissionAggregateCsvExportAdapter->getFieldTypes(); $this->fieldIds = $this->submissionAggregateCsvExportAdapter->getFieldIds(); $this->submissionIds = $this->submissionAggregateCsvExportAdapter->getSubmissionIds(); return $this; } /** * Set boolean useAdminLabels * * @param bool $useAdminLabels * @return SubmissionCsvExportInterface */ public function setUseAdminLabels($useAdminLabels) :SubmissionCsvExportInterface { $this->useAdminLabels = $useAdminLabels; return $this; } /** * Set date format * * @param string $dateFormat * @return SubmissionCsvExportInterface */ public function setDateFormat(string $dateFormat = null): SubmissionCsvExportInterface { if(!empty($dateFormat)) { //Set new date format $date_format = $dateFormat; } else if( !empty( Ninja_Forms()->get_setting( 'date_format' ) ) ) { //Or get NF Date format set $date_format = Ninja_Forms()->get_setting( 'date_format' ); } else if(!empty( get_option('date_format'))) { //Or get WP date format set $date_format = get_option('date_format'); } else { //Or leave default $date_format = $this->dateFormat; } $this->dateFormat = $date_format; return $this; } }

خدمة

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

مايو 23, 2025

8٬658 2 دقائق

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

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

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

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

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

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

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

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

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

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

مايو 23, 2025

8٬658 2 دقائق