ووردبريس

استعراض حقول ACF المتكررة والمجمعة في ووردبريس

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

تفهم هيكل الحقول المتكررة في ACF

بدءًا في كيفية إعداد البيانات، لديك حقل متكرر يحمل اسم "locations"، والذي يحتوي على مجموعة من المدن والشركات التابعة لها. الهيكل الذي ترغب في تحقيقه يبدو كالتالي:

  • اسم البلد
    • اسم المدينة
    • اسم الشركة

حيث يتكون كل حقل متكرر من مجموعة من العناصر التي يمكن أن تتضمن عدة تفاصيل. لذلك، يصبح لديك تكرارات داخل الحقول، مما يتطلب كتابة حلقة (Loop) صحيحة لعرض البيانات.

كيفية كتابة الحلقة (Loop) بشكل صحيح

أول خطوة لعرض هذه البيانات هو التأكد من استخدام الدوال الصحيحة لـ ACF لسحب الحقول. عندما تتعامل مع الحقول المتكررة، يجب أن تستخدم الدالة have_rows() للتأكد من وجود بيانات داخل الحقل المتكرر. إليك نموذج كود يمكنك استخدامه:

if( have_rows('locations') ): 
    while( have_rows('locations') ): the_row(); 
        $country_name = get_sub_field('country_name'); 
        echo '<h2>' . esc_html($country_name) . '</h2>';
        if( have_rows('cities') ):
            while( have_rows('cities') ): the_row();
                $city_name = get_sub_field('city_name');
                $company_name = get_sub_field('company_name');
                echo '<p>' . esc_html($city_name) . '</p>';
                echo '<p>' . esc_html($company_name) . '</p>';
            endwhile;
        endif;
    endwhile; 
endif;

تفسير الكود أعلاه

في الكود السابق، نبدأ بتحقق من وجود صفوف حقل "locations" باستخدام have_rows('locations'). داخل الحلقة، نقوم بسحب اسم البلد (country_name) ونقوم بطباعته. بعد ذلك، يتحقق الكود من وجود مدن مرتبطة بنفس الحقل المتكرر، وإذا وجدت، فإننا ندخل في حلقة جديدة (while ثانية) للحصول على أسماء المدن والشركات.

التحديات الشائعة أثناء التعامل مع ACF

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

الخاتمة

استخدام ACF لعرض البيانات عبر الحقول المتكررة والمجموعات يعد أمرًا قويًا، لكنه قد يحتاج إلى بعض الوقت لفهمه بشكل كامل. باتباع الخطوات والنصائح المذكورة في هذه المقالة، يمكنك بسهولة إنشاء حلقة متكررة بشكل فعال. لا تنسَ دائمًا مراجعة الهيكل الذي قمت بإنشائه والتأكد من أن البيانات ظاهرة بشكل صحيح. سواء كنت مبتدئًا أو محترفاً في ووردبريس، التعامل المؤثر مع Loop Through Complex ACF Repeater and Group Fields in WordPress يمكن أن يعزز من تجربة المستخدم ويجعل موقعك أكثر تفاعلية.

احمد علي

متخصص في مجال تطوير وإدارة المواقع الإلكترونية، يتمتع بخبرة واسعة في التعامل مع منصات إدارة المحتوى، خاصة ووردبريس. يقدم أحمد حلولاً مبتكرة واستراتيجيات فعالة لتحسين أداء المواقع وتطوير تصميماتها بما يتناسب مع احتياجات المستخدمين. كما يتميز بقدرته على تبسيط المفاهيم التقنية وكتابة محتوى تعليمي يساعد الأفراد والشركات على تحسين تواجدهم الرقمي وتحقيق أهدافهم على الإنترنت.
زر الذهاب إلى الأعلى
Don`t copy text!