كيفية استخدام نموذج ACF ضمن كود قصير

تُعتبر نماذج ACF (Advanced Custom Fields) أداة قوية لتخصيص عناصر المحتوى في ووردبريس، وتسهيل عملية إدخال البيانات من قبل المستخدمين. في هذا المقال، سنستعرض كيفية استخدام نموذج ACF داخل شفرة مختصرة (shortcode)، مما يتيح لك دمج النموذج في أي مكان تريده دون الحاجة للاعتماد على قالب صفحة محددة.

إعداد نموذج ACF لاستخدامه في شفرة مختصرة

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

إنشاء دالة لتعريف النموذج

يمكنك استخدام الدالة التالية لتعريف نموذج ACF في شفرة مختصرة:

function toyw_gallery_item_form_handler() {
    // تحميل رأس نموذج ACF
    acf_form_head();
    ob_start();
    // إعدادات نموذج ACF
    $settings = array(
        'id' => 'gallery_form',
        'post_id' => 'new_post',
        'post_title' => false,
        'new_post' => array('post_type' => 'gallery-item', 'post_status' => 'pending'),
        'field_groups' => array('group_66acdfbecde2d'),
        'submit_value' => __("Submit", 'acf'),
        'form_attributes' => array('class' => 'gallery_form'),
        'html_submit_button' => '',
    );
    // عرض النموذج
    acf_form($settings);
    return ob_get_clean();
}

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

عرض رسالة النجاح بعد الإرسال

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

للقيام بذلك بشكل صحيح، يمكنك استخدام الكود التالي:

add_action('acf/save_post', 'my_acf_save_post', 20);
function my_acf_save_post($post_id) {
    // تحقق من نوع المشاركة
    if (get_post_type($post_id) == 'gallery-item') {
        // عرض رسالة النجاح
        add_settings_error('my_settings', 'msg', 'تم إرسال النموذج بنجاح!', 'updated');
    }
}

تأكد من استبدال gallery-item بنوع المشاركة المناسب إذا كان مختلفًا.

إضافة النموذج باستخدام الشفرة المختصرة

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

[gallery_form_shortcode]

التعامل مع الأخطاء الشائعة

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

خاتمة

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

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