<?php if ( ! defined( 'ABSPATH' ) ) exit; use NinjaForms\Includes\Admin\Processes\DeleteBatchFile; use NinjaForms\Includes\Contracts\SubmissionHandler; use NinjaForms\Includes\Entities\SingleSubmission; use NinjaForms\Includes\Entities\SubmissionExtraHandlerResponse; use NinjaForms\Includes\Factories\SubmissionAggregateFactory; use NinjaForms\Includes\Factories\SubmissionFilterFactory; /** * Class NF_Routes_SubmissionsActions */ final class NF_Routes_Submissions extends NF_Abstracts_Routes { /** * Register REST API routes related to submissions actions * * @since 3.4.33 * * @route "ninja-forms-submissions/export" * @route 'ninja-forms-submissions/email-action" */ function register_routes() { register_rest_route('ninja-forms-submissions', 'submissions/get', array( 'methods' => 'GET', 'args' => [ 'form_ids' => [ 'required' => true, 'description' => esc_attr__('Form IDs', 'ninja-forms'), 'type' => 'array', 'validate_callback' => 'rest_validate_request_arg', ] ], 'callback' => [ $this, 'get_submissions' ], 'permission_callback' => [ $this, 'get_submissions_permission_callback' ] )); register_rest_route('ninja-forms-submissions', 'submissions/delete', array( 'methods' => 'POST', 'args' => [ 'submissions' => [ 'required' => true, 'description' => esc_attr__('Submissions', 'ninja-forms'), 'type' => 'array', 'validate_callback' => 'rest_validate_request_arg', ] ], 'callback' => [ $this, 'delete_submissions' ], 'permission_callback' => [ $this, 'delete_submissions_permission_callback' ] )); register_rest_route('ninja-forms-submissions', 'submissions/update', array( 'methods' => 'POST', 'args' => [ 'singleSubmission' => [ 'required' => true, 'description' => esc_attr__('Update single Submission', 'ninja-forms'), 'type' => 'JSON encoded array', 'validate_callback' => 'rest_validate_request_arg', ] ], 'callback' => [ $this, 'update_submission' ], 'permission_callback' => [ $this, 'update_submission_permission_callback' ] )); register_rest_route('ninja-forms-submissions', 'submissions/restore', array( 'methods' => 'POST', 'args' => [ 'restore' => [ 'required' => true, 'description' => esc_attr__('Update Submission', 'ninja-forms'), 'type' => 'boolean', 'validate_callback' => 'rest_validate_request_arg', ], 'submissions' => [ 'required' => true, 'description' => esc_attr__('Array of Submissions', 'ninja-forms'), 'type' => 'array', 'validate_callback' => 'rest_validate_request_arg', ] ], 'callback' => [ $this, 'restore_submissions' ], 'permission_callback' => [ $this, 'update_submission_permission_callback' ] )); register_rest_route('ninja-forms-submissions', 'submissions/handle-extra', array( 'methods' => 'POST', 'args' => [ 'singleSubmission' => [ 'required' => true, 'description' => esc_attr__('Update Submission', 'ninja-forms'), 'type' => 'JSON encoded array', 'validate_callback' => 'rest_validate_request_arg', ], 'handleExtra' => [ 'required' => true, 'description' => esc_attr__('Extra Handler of Submission', 'ninja-forms'), 'type' => 'string', 'validate_callback' => 'rest_validate_request_arg', ] ], 'callback' => [ $this, 'handle_extra_submission' ], 'permission_callback' => [ $this, 'handle_extra_submission_permission_callback' ] )); register_rest_route('ninja-forms-submissions', 'export', array( 'methods' => 'POST', 'args' => [ 'form_ids' => [ 'required' => false, 'description' => esc_attr__('Array of Form IDs we want to get the submissions from.', 'ninja-forms'), 'type' => 'array', 'validate_callback' => 'rest_validate_request_arg', ], 'start_date' => [ 'required' => false, 'description' => esc_attr__('strtotime($date) that represents the start date we will retrieve submssions at.', 'ninja-forms'), 'type' => 'string', 'validate_callback' => 'rest_validate_request_arg', ], 'end_date' => [ 'required' => false, 'description' => esc_attr__('strtotime($date) that represents the end date we will retrieve submssions at.', 'ninja-forms'), 'type' => 'string', 'validate_callback' => 'rest_validate_request_arg', ], 'singleSubmission' => [ 'required' => false, 'description' => esc_attr__('Export single submission if a JSON encoded submission is passed', 'ninja-forms'), 'type' => 'JSON encoded array', 'validate_callback' => 'rest_validate_request_arg', ], 'submissions' => [ 'required' => false, 'description' => esc_attr__('Export submissions based on array of submissions IDs', 'ninja-forms'), 'type' => 'array', 'validate_callback' => 'rest_validate_request_arg', ] ], 'callback' => [ $this, 'bulk_export_submissions' ], 'permission_callback' => [ $this, 'get_submissions_permission_callback' ], )); register_rest_route('ninja-forms-submissions', 'download-all', array( 'methods' => 'POST', 'args' => [ 'form_ids' => [ 'required' => false, 'description' => esc_attr__('Array of Form IDs we want to get the submissions from.', 'ninja-forms'), 'type' => 'array', 'validate_callback' => 'rest_validate_request_arg', ], ], 'callback' => [ $this, 'download_all_submissions' ], 'permission_callback' => [ $this, 'get_submissions_permission_callback' ], )); /** * Delete the temp file created from the `download-all` request */ register_rest_route('ninja-forms-submissions', 'delete-download-file', array( 'methods' => 'POST', 'args' => [ 'file_path' => [ 'required' => true, 'description' => esc_attr__('File path of the file to delete', 'ninja-forms'), 'type' => 'string', 'validate_callback' => 'rest_validate_request_arg', ], ], 'callback' => [ $this, 'delete_download_file' ], // Uses the same permissions as the `download-all` request 'permission_callback' => [ $this, 'delete_submissions_files_permission_callback' ], )); register_rest_route('ninja-forms-submissions', 'set-submissions-settings', array( 'methods' => 'POST', 'args' => [ 'settingName' => [ 'required' => true, 'description' => esc_attr__('Setting name in the submissionsSettings array', 'ninja-forms'), 'type' => 'string', 'validate_callback' => 'rest_validate_request_arg', ], 'data' => [ 'required' => false, 'description' => esc_attr__('Settings data', 'ninja-forms'), 'type' => 'object', 'validate_callback' => 'rest_validate_request_arg', ], 'formID' => [ 'required' => false, 'description' => esc_attr__('Form ID of the setting saved', 'ninja-forms'), 'type' => 'string', 'validate_callback' => 'rest_validate_request_arg', ] ], 'callback' => [ $this, 'set_submissions_settings' ], 'permission_callback' => [ $this, 'get_submissions_permission_callback' ], )); register_rest_route('ninja-forms-submissions', 'get-submissions-settings', array( 'methods' => 'GET', 'callback' => [ $this, 'get_submissions_settings' ], 'permission_callback' => [ $this, 'get_submissions_permission_callback' ], )); register_rest_route('ninja-forms-submissions', 'email-action', array( 'methods' => 'POST', 'args' => [ 'submission' => [ 'required' => true, 'description' => esc_attr__('Submission ID', 'ninja-forms'), 'type' => 'int', 'validate_callback' => 'rest_validate_request_arg', ], 'action_settings' => [ 'required' => true, 'description' => esc_attr__('Email Action Settings', 'ninja-forms'), 'type' => 'object', 'validate_callback' => 'rest_validate_request_arg', ], ], 'callback' => [ $this, 'trigger_email_action' ], 'permission_callback' => [ $this, 'permission_callback' ], )); } /** * Secure endpoint to allow users to read submissions * * @since 3.5.8 * * Already passed Nonce validation via wp_rest and x_wp_nonce header checked against rest_cookie_check_errors() */ public function get_submissions_permission_callback(WP_REST_Request $request) { //Set default to false $allowed = false; // Allow only admin to export personally identifiable data $permissionLevel = 'manage_options'; $allowed= \current_user_can($permissionLevel); /** * Filter permissions for Reading Submissions * * @param bool $allowed Is request authorized? * @param WP_REST_Request $request The current request */ return apply_filters( 'ninja_forms_api_allow_get_submissions', $allowed, $request ); } /** * Secure endpoint to allow users to delete submissions * * @since 3.5.8 * * Already passed Nonce validation via wp_rest and x_wp_nonce header checked against rest_cookie_check_errors() */ public function delete_submissions_permission_callback(WP_REST_Request $request) { //Set default to false $allowed = false; // Allow only admin to export personally identifiable data $permissionLevel = 'manage_options'; $allowed= \current_user_can($permissionLevel); /** * Filter permissions for Reading Submissions * * @param bool $allowed Is request authorized? * @param WP_REST_Request $request The current request */ return apply_filters( 'ninja_forms_api_allow_delete_submissions', $allowed, $request ); } /** * Secure endpoint to allow users to update a submission * * @since 3.5.8 * * Already passed Nonce validation via wp_rest and x_wp_nonce header checked against rest_cookie_check_errors() */ public function update_submission_permission_callback(WP_REST_Request $request) { //Set default to false $allowed = false; // Allow only admin to export personally identifiable data $permissionLevel = 'manage_options'; $allowed= \current_user_can($permissionLevel); /** * Filter permissions for updating a submission * * @param bool $allowed Is request authorized? * @param WP_REST_Request $request The current request */ return apply_filters( 'ninja_forms_api_allow_update_submission', $allowed, $request ); } /** * Secure endpoint to allow users to perform extra handling * * @since 3.5.8 * * Already passed Nonce validation via wp_rest and x_wp_nonce header checked against rest_cookie_check_errors() */ public function handle_extra_submission_permission_callback(WP_REST_Request $request) { //Set default to false $allowed = false; // Allow only admin to export personally identifiable data $permissionLevel = 'manage_options'; $allowed= \current_user_can($permissionLevel); /** * Filter permissions for updating a submission * * @param bool $allowed Is request authorized? * @param WP_REST_Request $request The current request */ return apply_filters( 'ninja_forms_api_allow_handle_extra_submission', $allowed, $request ); } /** * Secure endpoint to allowed users and uploads folder * * Used to delete files from the uploads directory. Tmp file in our case * * @since 3.6.25 * * Already passed Nonce validation via wp_rest and x_wp_nonce header checked * against rest_cookie_check_errors() */ public function delete_submissions_files_permission_callback(WP_REST_Request $request) { //Set default to false $allowed = false; // Allow users with manage_options capability and only within wp_upload_dir $permissionLevel = 'manage_options'; $dir = wp_get_upload_dir(); $fileinfo = pathinfo(json_decode($request->get_body())->file_path); $allowed_dir = $dir['basedir'] . '/ninja-forms-tmp' === $fileinfo['dirname']; $allowed = \current_user_can($permissionLevel) && $allowed_dir; /** * Filter permissions for deleting files from the uploads directory. Tmp file in our case * * @param bool $allowed Is request authorized? * @param WP_REST_Request $request The current request */ return apply_filters( 'ninja_forms_api_allow_delete_current_uploads_file', $allowed, $request ); } /** * Secure endpoint to allowed users * * Security disclosure regarding <=3.5.7 showed that any logged in user * could export form data, possibly exposing personally identifiable * information. Permissions changed such that only admin can export * submission data; a filter enables one to override that permission if * desired. * * @since 3.4.33 * * Already passed Nonce validation via wp_rest and x_wp_nonce header checked * against rest_cookie_check_errors() */ public function permission_callback(WP_REST_Request $request) { //Set default to false $allowed = false; // Allow only admin to export personally identifiable data $permissionLevel = 'manage_options'; $allowed= \current_user_can($permissionLevel); /** * Filter permissions for Triggering Email Actions * * @param bool $allowed Is request authorized? * @param WP_REST_Request $request The current request */ return apply_filters( 'ninja_forms_api_allow_email_action', $allowed, $request ); } /** * Bulk_export_submissions * * @since 3.4.33 * * @return array of CSVs by form */ public function bulk_export_submissions(WP_REST_Request $request) { //Gather data from the request $data = json_decode($request->get_body()); //TODO organize queries to work with a single method instead of defining a method depending on the data received if (!empty($data->form_ids) && !empty($data->start_date) && !empty($data->end_date)) { // export by date from multiple forms $form_ids = explode(",", $data->form_ids); $start_date = $data->start_date; $end_date = $data->end_date; $requestType = 'filterByDates'; } elseif (!empty($data->singleSubmission)) { // export a single submission $singleSubmissionJson = $data->singleSubmission; $requestType = 'getSingleSubmission'; } else if (!empty($data->submissions) && !empty($data->form_ids)) { // export multiple submissions from a single form $form_ids = explode(",", $data->form_ids); $submissionsIDs = $data->submissions; $requestType = 'getSubmissions'; } else { return new WP_Error('malformed_request', __('This request is missing data', 'ninja-forms')); } if ('filterByDates' === $requestType) { foreach ($form_ids as $formId) { $params = (new SubmissionFilterFactory())->maybeLimitByLoggedInUser() ->setStartDate($start_date) ->setEndDate($end_date) ->setNfFormIds([$formId]) ->setStatus(['active', 'publish']); // construct aggregate within CSV adapter, applying filter to aggregate $submissionAggregateCsvExportAdapter = (new SubmissionAggregateFactory())->SubmissionAggregateCsvExportAdapter(); $submissionAggregateCsvExportAdapter->submissionAggregate->filterSubmissions($params); $csvObject = (new NF_Exports_SubmissionCsvExport())->setUseAdminLabels(true) ->setSubmissionAggregateCsvExportAdapter($submissionAggregateCsvExportAdapter); $csv[$formId] = $csvObject->handle(); } } elseif ('getSingleSubmission' === $requestType) { $singleSubmission = SingleSubmission::fromArray(json_decode($singleSubmissionJson, true)); $formId = $singleSubmission->getFormId(); // construct aggregate within CSV adapter, applying filter to aggregate $submissionAggregateCsvExportAdapter = (new SubmissionAggregateFactory())->SubmissionAggregateCsvExportAdapter(); $submissionAggregateCsvExportAdapter->submissionAggregate->requestSingleSubmission($singleSubmission); $csvObject = (new NF_Exports_SubmissionCsvExport())->setUseAdminLabels(true) ->setSubmissionAggregateCsvExportAdapter($submissionAggregateCsvExportAdapter); $csv[$formId] = $csvObject->handle(); } elseif ('getSubmissions' === $requestType) { $params = (new SubmissionFilterFactory())->maybeLimitByLoggedInUser() ->setNfFormIds($form_ids) ->setStartDate(0) ->setEndDate(time()) ->setSubmissionsIDs($submissionsIDs); $submissionAggregateCsvExportAdapter = (new SubmissionAggregateFactory())->SubmissionAggregateCsvExportAdapter(); $submissionAggregateCsvExportAdapter->submissionAggregate->filterSubmissions($params); $csvObject = (new NF_Exports_SubmissionCsvExport())->setUseAdminLabels(true)->setSubmissionAggregateCsvExportAdapter($submissionAggregateCsvExportAdapter); $csv[$form_ids[0]] = $csvObject->handle(); } // Return CSV objects return $csv; } /** * Download all submissions * * * @return array */ public function download_all_submissions(WP_REST_Request $request) { //Gather data from the request $data = json_decode($request->get_body()); if (!empty($data->form_ids)) { // download all submissions $form_ids = explode(",", $data->form_ids); $formId = $form_ids[0]; } else { return new WP_Error('malformed_request', __('This request is missing data', 'ninja-forms')); } $export = (new NF_Admin_Processes_ExportSubmissions($formId)); $downloadUrl = $export->getFileUrl(); $filePath = $export->getFilePath(); $response =[ 'formId'=>$formId, 'downloadUrl'=>$downloadUrl, 'filePath'=>$filePath ]; return $response; } /** * Delete a file when provided valid file path * * @param WP_REST_Request $request Object with `file_path` property * @return void */ public function delete_download_file(WP_REST_Request $request) { //Gather data from the request $data = json_decode($request->get_body()); if(!empty($data->file_path)){ $filePath = (string)$data->file_path; $deleteFile = (new DeleteBatchFile())->delete($filePath); $response=[ 'result'=>$deleteFile ]; return $response; }else{ return new WP_Error('malformed_request', __('This request is missing data for method delete_download_file', 'ninja-forms')); } } /** * Trigger Email Action endpoint callback * * @since 3.4.33 * * @return bool|int depending on the value returned by wp_mail */ public function trigger_email_action(WP_REST_Request $request) { //Extract required data $data = json_decode($request->get_body()); $form = Ninja_Forms()->form( $data->formID ); $sub = $form->get_sub( $data->submission ); $field_values = $sub->get_field_values(); //Throw error if we're missing data if( !isset($data) || empty($form) || empty($sub) ) { return new WP_Error( 'malformed_request', __('This request is missing data', 'ninja-forms') ); } $formSettings = Ninja_Forms()->form($data->formID)->get_settings(); $data_send = [ 'fields' => [], 'fields_by_key' => [], 'settings'=>$formSettings, 'form_id'=>$data->formID ]; foreach($field_values as $index => $field_value){ $id = str_replace('_field_', '', $index); $model = Ninja_Forms()->form($data->formID)->get_field( $id ); $settings = $model->get_settings(); if($id === $index){ $data_send['fields_by_key'][$id] = $settings; $data_send['fields_by_key'][$id]['settings'] = $settings; $data_send['fields_by_key'][$id]['value'] = $field_value; $data_send['fields_by_key'][$id]['settings']['value'] = $field_value; } else { $data_send['fields'][$id] = $settings; $data_send['fields'][$id]['settings'] = $settings; $data_send['fields'][$id]['value'] = $field_value; $data_send['fields'][$id]['settings']['value'] = $field_value; } } //Process Merge tags $action_settings = $this->process_merge_tags( $data->action_settings, $data->formID, $sub ); //Process Email Action $email_action = new NF_Actions_Email(); $result = $email_action->process( (array) $action_settings, $data->formID, $data_send ); //Return true if wp_mail returned true or the submission ID if it failed. $return = !empty($result['actions']['email']['sent']) && true === $result['actions']['email']['sent'] ? $result['actions']['email']['sent'] : $sub->get_seq_num(); return $return; } /** * Process Merge tags for a given Value * * @since 3.4.33 * * @return object of Email Action Model with merge tags settingsprocessed * */ public function process_merge_tags( $data, $form_id, $sub) { // Init Field Merge Tags. $fields_merge_tag_object = Ninja_Forms()->merge_tags[ 'fields' ]; $fields_merge_tag_object->set_form_id($form_id); //Process Fields Merge Tags $fields = Ninja_Forms()->form( $form_id )->get_fields(); $fields = new NF_Adapters_SubmissionsSubmission( $fields, $form_id, $sub ); foreach( $fields as $field ){ $fields_merge_tag_object->add_field( $field ); } //Add All Fields merge tags $fields_merge_tag_object->include_all_fields_merge_tags(); //include fields to the {all_fields_table} and {fields_table} mrerge tags foreach( $fields as $field ){ $fields_merge_tag_object->add_field( $field ); } //Loop through Action settings and apply merge tags $array_data = (array) $data; foreach( $array_data as $ind => $value ){ if( !empty($value) && is_string($value) ){ //Merge tag $data->$ind = apply_filters( 'ninja_forms_merge_tags', $value ); } } return $data; } /** * Get Submissions * * @since 3.5.8 * * @return array of submissions for a Form */ public function get_submissions(WP_REST_Request $request) { //Gather data from the request if( empty( $_GET["type"] ) || empty( $_GET["form_ids"] )){ return new WP_Error( 'malformed_request', __('This request is missing data', 'ninja-forms') ); } else { //Set Usefull data $type = $_GET["type"]; $form_ids = $_GET["form_ids"]; $page_size = !empty( $_GET["page_size"] ) ? $_GET["page_size"] : "10"; $current_page = !empty( $_GET["current_page"] ) ? $_GET["current_page"] : "1"; $start_date = $_GET["start_date"] != 0 ? $_GET["start_date"] : 378687600; // If no end date is specified, then use current time plus one day // to ensure it goes beyond all time zones $end_date = $_GET["end_date"] != 0 ? $_GET["end_date"] : time()+(60*60*24); $search_term = !empty($_GET["search_term"]) ? $_GET["search_term"] : null; $status = !empty($_GET["status"]) && $_GET["status"] === "trash" ? ["trash"] : ['active', 'publish']; } //Get aggregated submissions $params = (new SubmissionFilterFactory())->maybeLimitByLoggedInUser()->setNfFormIds([$form_ids]); if(!empty($start_date) && !empty($end_date)){ $params->setStartDate($start_date); $params->setEndDate($end_date); } if($search_term){ $params->setSearchString( $search_term ); } $params->setStatus( $status ); $submissionAggregate = (new SubmissionAggregateFactory())->submissionAggregate(); $filteredSubmissions = $submissionAggregate->filterSubmissions( $params ); //Get values of needed submissions if( $type === "columns" ){ $response = $submissionAggregate->getFieldDefinitionCollection(); } else if( $type === "data" ){ $response = []; $aggregatedSubmissions = $submissionAggregate->getAggregatedSubmissions(); $offset = ($current_page - 1) * $page_size; $submissions_needed = array_slice( $aggregatedSubmissions, $offset, $page_size ); foreach( $submissions_needed as $key => $params ){ $response['data'][$key] = $submissionAggregate->getSubmissionValuesByAggregatedKey( $key ); } $response['count'] = $submissionAggregate->getSubmissionCount(); } // Return submissions data from request return rest_ensure_response( $response ); } /** * Save submissions interface settings * * Data passes a json string * * @param WP_REST_Request $request * @return void */ public function set_submissions_settings(WP_REST_Request $request){ //Extract required data $data = $request->get_json_params(); $setting = $data['settingName']; $new_data = $data['data']; $form_id = $data['formID']; //Get data stored and create the new value for the correct setting $option = get_option( 'ninja_forms_submissions_settings' ); $current_setting_value = $option[$form_id][$setting]; $updated_option = $option; $updated_option[$form_id][$setting] = $new_data; $response = (object)[]; if ( false !== $option ) { // option exist if ( $current_setting_value === $new_data ) { $response->message = "unchanged"; $response->status = false; } else { $response->message = "update_option"; $response->status = update_option( 'ninja_forms_submissions_settings', $updated_option ); } } else { // option don't exist $response->message = "add_option"; $response->status = add_option( 'ninja_forms_submissions_settings', $updated_option ); } return rest_ensure_response( json_encode( $response ) ); } /** * Get submissions interface settings * * @param WP_REST_Request $request * @return array of settings */ public function get_submissions_settings(WP_REST_Request $request){ $settings = get_option( 'ninja_forms_submissions_settings' ); return rest_ensure_response( json_encode( $settings ) ); } /** * Request deletion of a collection of submissions * * Data passes as a collection of single submission entities keyed * under submissions * * {"submissions": SingleSubmission[]} * * @param WP_REST_Request $request * @return void */ public function delete_submissions(WP_REST_Request $request){ //Extract required data $data = json_decode($request->get_body()); $submissions = $data->submissions; $submissionAggregate = (new SubmissionAggregateFactory())->submissionAggregate(); foreach($submissions as $obj){ $singleSubmission = SingleSubmission::fromArray((array)$obj); $submissionAggregate->deleteSingleSubmission($singleSubmission); } return 'ok'; } /** * Request restoration of a collection of submissions * * Data passes as a collection of single submission entities keyed * under submissions * * {"submissions": SingleSubmission[]} * * @param WP_REST_Request $request * @return void */ public function restore_submissions(WP_REST_Request $request){ //Extract required data $data = json_decode($request->get_body()); $submissions = $data->submissions; $submissionAggregate = (new SubmissionAggregateFactory())->submissionAggregate(); foreach($submissions as $obj){ $singleSubmission = SingleSubmission::fromArray((array)$obj); $submissionAggregate->restoreSingleSubmission($singleSubmission); } return 'ok'; } /** * Request update of a single submission * * Data passes as a single submission entity keyed under submission * * {"submission": SingleSubmission} * * @param WP_REST_Request $request * @return void */ public function update_submission(WP_REST_Request $request){ //Extract required data $data = json_decode($request->get_body(),true); $singleSubmissionArray = $data['singleSubmission']; $singleSubmission = SingleSubmission::fromArray($singleSubmissionArray); $submissionAggregate = (new SubmissionAggregateFactory())->submissionAggregate(); $submissionAggregate->updateSingleSubmission($singleSubmission); return 'ok'; } /** * Handle extra request for submissions * * This is a starting proof of concept that triggers a download for the PDF submissions add-on * * Data passes as a single submission entity keyed under submission and a Class to call the handler under handleExtra key * * { * "submission": SingleSubmission, * "handleExtra": HandleExtraClassName * } * * @param WP_REST_Request $request * @return object with string of responseType, blob of PDF download and string of blobType */ public function handle_extra_submission(WP_REST_Request $request){ // set default response $response = [ ]; //Extract required data $data = json_decode($request->get_body(),true); $singleSubmissionArray = $data['singleSubmission']; $singleSubmission = SingleSubmission::fromArray($singleSubmissionArray); $submissionAggregate = (new SubmissionAggregateFactory())->submissionAggregate(); $populatedSubmission = $submissionAggregate->requestSingleSubmission($singleSubmission); $extraHandler = $data['handleExtra']; /** @var SubmissionHandler $object */ if(class_exists($extraHandler)){ $object = new $extraHandler; $response = $object->handle($populatedSubmission); } // Handlers using NinjaForms\Includes\Abstracts\SubmissionHandler // already pass through entity, but it is not guaranteed that all // handlers will use the abstract $arrayFromEntity = (SubmissionExtraHandlerResponse::fromArray($response))->toArray(); return $arrayFromEntity; } }

معرفة

ثورة في عالم التجميل …الثورة الصامتة في التجميل النسائي

مايو 20, 2025

8٬751 6 دقائق

كتبت : فرح سمير

في السنوات الأخيرة، احتلّ الذكاء الاصطناعي (AI) مكانة بارزة ضمن أدوات العناية والمكياج، لا سيما مع انتشار تطبيقات مثل ChatGPT. غير أن أولى خطوات دمج هذه التقنية بعالم التجميل انطلقت عام 2010، حين أطلقت شركة ModiFace خدمات تجربة مستحضرات التجميل افتراضيًا عبر الواقع المعزز (AR)

والذكاء الاصطناعي، بالتعاون مع علامات كبرى مثل Sephora و Estée Lauder و MAC Cosmetics.

•وفي 2018، استحوذت L’Oréal على ModiFace، فتوسّعت بذلك آفاق استخدام الذكاء الاصطناعي في التجميل لتشمل:

تجربة مستحضرات التجميل افتراضيًا / تشخيص الأمراض الجلدية / تحليل البشرة وتقديم توصيات شخصية / تخطيط وتصوّر العمليات الجراحية التجميلية / استخدام أجهزة تجميل ذكية مدعومة بتقنيات الذكاء الاصطناعي

انتشار التطبيقات التجميلية المدعومة بالذكاء الاصطناعي

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

UMLYR، TressAi، Ai Beauty، Chisw، Consult-port، Generation Beauty Ai، Cotyinc، YouCam Makeup، Beautiful Ai، Epigencare، Prefect Corp، SkinVision، SkinAI، CureSkin، YouCamSkin، Google DeepMind، IBM Watson، My beauty by YouCam Makeup، Design، RoboDerm، DermaA.I، DeepSkin، Trove-skin.

• ولم تقتصر الحركة على الشركات الناشئة؛ فقد طرحت Amazon عام 2019 خدمة تجربة مستحضرات التجميل افتراضيًا قبل الشراء باستخدام تقنيات الذكاء الاصطناعىشركات تقود التحول الرقمي في صناعة التجميل

إلى جانب ModiFace، برزت شركات مثل Banuba Technologies التي توفر منصات واقع معزز مدعومة بالذكاء الاصطناعي لتجربة الماكياج والعناية بالبشرة افتراضيًا. وعقب استحواذ L’Oréal على ModiFace، أطلقت الشركة مجموعة من التطبيقات والأجهزة الذكية:

: SkinConsultAI (2019)أداة تحليل بشرة تعتمد على الذكاء الاصطناعي

Skin Genius (2020): تحليل بشرة وتقديم توصيات شخصية.

: Beauty Genius (2024) مساعد تجميلي شخصي قائم على الذكاء الاصطناعي التوليدي.

كما طوّرت أجهزة مثل:

Perso (2020): جهاز صغير لتخصيص مستحضرات التجميل.

Cell BioPrint (2025): لتحليل بروتينات الجلد وتحديد عمر البشرة.

AirLight Pro مجفف شعر ذكي يقلّل التلف.

My Skin Track UV مستشعر للأشعة فوق البنفسجية.

L’Oréal Brow Magicجهاز مكياج حواجب بتقنية AR والطباعة.

HAPTA: جهاز مكياج لذوي الإعاقة الحركية.

Colorsonicجهاز ذكي لتلوين الشعر بعبوات قابلة لإعادة الاستخدام.

رافق ذلك بروز أنظمة الجراحة الروبوتية

مثل : ROSA . Da Vinci Surgical System,، وروبوتات الدردشة الطبية وأدوات مثلBuoy Health، Aysa، Neutrogena Skin360. وتطورّت برامج التصور المسبق للعمليات باستخدام FaceTouchUp، Vector 3D Imaging، Crisalix، Plastic Surgery Simulator، ومحاكي جراحات التجميلLite.

كما دخلت السوق أجهزة متقدمة أخرى، بينها:

Accure: لعلاج حب الشباب وتقدير درجة حرارة البشرة المثالية.

EXION AI يعالج لتجاعيد وندبات حب الشباب ويحفّز إنتاج الكولاجين بنسبة 224% بأمان ودون ألم أو نقاهة.

Prinkecr: شركة كورية للوشم المؤقت الذكي.

HiMirror: مرأة ذكية تحلل البشرة وتقيم التجاعيد والبقع الداكنة وحب الشباب.

الصندوق الأبيض: جهاز لتجميل الأظافر بالذكاء الاصطناعي، يزن 8 كجم، ويطلي الأظافر آليًا بأكثر من 30 لونًا في كبسولات.

تجميل أم رسوم مبرمجة ؟ هل تثق النساء في ادوات الذكاء الاصطناعي التجميلية ؟

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

32 مشاركة (53.3%) استخدمن هذه الأدوات فعليًا.

28 مشاركة (46.7%) لم يستخدمنها بعد.

الثقة في التوصيات التجميلية التي تقدمها أنظمة الذكاء الاصطناعي

32 مشاركة (53.3%) يثقن بها.

28 مشاركة (46.7%) يفضلن استشارة طبيب بشري.

الذكاء الاصطناعي والتجميل غير الجراحي

36 فتاة (60%) يثقن بإسهام الذكاء الاصطناعي في تحسين نتائج البوتكس والفيلر.

24 فتاة (40%) تحفّظن على الاعتماد الكامل على التقنية في الإجراءات الدقيقة.

بشرة مثالية بضغطة زر تحتاجين طبيبآ ام تطبيقآ؟

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

فلتر الواقع ….بين التقنية و الرأى الطبى .

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

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

تقنية الذكاء الاصطناعي: فوائد مذهلة أم معايير مزيفة؟

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

• ويشير إلى تطبيقات مثل “SkinVision” و“Derma Assist” و“VisualDX” في العيادات، وكذلك إلى تجربة “Surcast” التابعة لجمعية الصدفية الأمريكية التي ترصد تطور الحالة. ويشدّد على أن جودة الكاميرا والإضاءة تؤثر في دقة تحليلات التطبيقات الهاتفية، في حين تصل بعض الأنظمة إلى دقة 98% في توصية العلاجات البيولوجية، لكنها تحتاج إشرافًا بشريًا.

تحذير من الاعتماد الكامل على الذكاء الاصطناعي في تشخيص الأمراض الجلدية

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

“هبه ابو بكر” خبيرة التجميل :الذكاء الاصطناعي أداة مساعدة…لا بديل للمسة الإنسانية.

تؤكد خبيرة التجميل “هبة أبو بكر” أن التقنيات الحديثة غيّرت أدوات ومستحضرات التجميل وأداء الفتيات، خاصة منتجات تحضير البشرة والمصححات متعددة الألوان. وترى أن أجهزة مثل L’Oréal Brow Magic و HAPTA مفيدة للمبتدئين، لكن لا تضاهي براعة المحترفين. وفي تجربة المكياج الافتراضي، تعزز الثقة أولًا ثم يحتاج الأمر لتطبيق احترافي لاحقًا. وتضيف أن أدوات مثل Perso تساعد في اختيار اللون الأمثل، ما يقلل الخطأ ويحسّن النتائج. وقد لاحظت طلبات محددة من العملاء بعد تجربتهم الافتراضية، مما يدلّ على وعيٍ أكبر بنوع المكياج المناسب.

كيف يدعم الذكاء الاصطناعي عمل خبراء المكياج؟

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

الذكاء الاصطناعي فى التجميل يخدم الثقة ام يولد القلق النفسي ؟

ما وراء الرسالة النفسية حول تفاوت قبول الفتيات لتقنيات الذكاء الاصطناعي في التجميل

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

العوامل النفسية والاجتماعية المؤثرةً

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

مخاوف وهواجس متعلقة بالتكنولوجيا

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

الجانب الإيجابي والداعم نفسيًا

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

الإفراط في الاعتماد وتأثيره على التوازن النفسي

قد يخلق الاعتماد المفرط فجوة في الدعم النفسي بين المريضة والطبيب، بل ويؤدي إلى “إدمان تقني” يجعل قرارات الجمال مرهونة بالتكنولوجيا لا بالثقة الذاتية.

تعزيز معايير غير واقعية للجمال

من أبرز المخاطر أن ترسخ هذه التقنيات صورة مثالية مصطنعة عبر منصات التواصل، مما يرفع سقف التوقعات ويولّد شعورًا دائمًا بعدم الكمال.

التأهيل النفسي والتعامل المتوازن

تُعدّ برامج التوعية ضرورية لتعزيز تقدير الذات والجمال الطبيعي، وتشجيع الاستخدام المدروس للتقنيات دون اختزال قيمة الفرد في مظهره الخارجي.

الأساليب العلاجية والنفسية المقترحة

العلاج المعرفي السلوكي (CBT) من أبرز الوسائل لمساعدة الفتيات على تصحيح الأفكار السلبية المرتبطة بالمظهر، مع تشجيعهن على تقييم أنفسهن بشكل شامل ومتوازن واستخدام التقنية كدعم لا كتهديد.

خلاصة نفسية:

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

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