المصدر: شرح تصميم قوالب ووردبريس -الجزء الحادي عشر- - مدونة المبرمج




فى الدرس السابق، كنا قد انتهينا من الجزء الخاص بعرض التعليقات، وفى هذا الدرس سننهي ما يتعلق بنموذج كتابة تعليق جديد، وفي هذا الدرس سنعتمد على دالتين، الأولي وهي لتعيين قيم افتراضية لحقول النموذج، والثانية لتعديل شكل النموذج، لذا فلنبدأ !
سنكمل مع ملف functions.php ، حيث سنقوم بعمل filter جديد وذلك عبر دالة add_filter، وتلك الدالة تأخذ بارامتران، الأول وهي قيمة محددة وهي comment_form_defaults، والثاني ستكون اسم الدالة التي ستقوم أنت بإنشاءها بعد ذلك لتغيير شكل نموذج وضع تعليق جديد، مثلاً سنقوم بتسميته PHPGeekArForm،
رمز PHP:


والآن سنقوم بإنشاء دالة بنفس الاسم الذي قمت بإدخاله فى البارامتر الثاني، وستأخذ الدالة Argument واحد عبارة عن مصفوفة وسنقوم بتسميته defaults رمز PHP:


اول ما سنقوم بتغييره هي الجملة التى تفيد بأن البريد الإلكتروني الذي سيقوم المستخدم إدخاله فى النموذج لن يتم عرضه، تلك الجملة الشهيرة الموجودة أعلى نموذج كتابة تعليق جديد، فيمكنك تحديدها وتغييرها عبر الـKey المسمى بـcomment_notes_before، وانا شخصيًا سأقوم بحذفها، وذلك كالتالي رمز PHP:


تستطيع تغيير الجملة إذا أردت، لكن لا تنس أن تقوم بإرجاع المصفوفة defaults عبر return فى آخر الدالة، والآن لتغيير شكل النموذج يمكنك تحديد الـid الذي قمت بتخصيصه للنموذج، وادخاله فى مصفوفة defaults عبر الـkey الذي يدعى id_form، فمثلاً انا فى ملف الـCSS قمت بعمل id يدعى comment-form، وانا الآن اريد وضع ذلك الـId للنموذج، يمكنني ذلك عبر اضافة هذا السطر فى الدالة:
رمز PHP:


قد تحتاج ايضًا إلى تغيير الـtextarea المخصص لكتابة محتوى التعليق، تستطيع ذلك عبر السطر التالي:
رمز PHP:


لاحظ اننا فى هذه الحالة قمنا بإدخال شيفرة HTML كاملة، ولم نقم بإدخال id معين للـTextarea، والآن انتهينا من الجزء الخاص بتغيير شكل وخواص النموذج، لننتقل الآن إلى طريقة معالجة النموذج، وفى تلك الخطوة سنقوم بإضافة filter جديد عبر add_filter، البارامتر الأول قيمته comment_form_default_fields، والثاني قيمته اسم الدالة التي ستقوم بإنشاءها لتلك العملية، انا سأقوم بتسميتها PHPGeekArFileds،
رمز PHP:


والآن سنقوم بإنشاء الدالة، رمز PHP:


ثم سنقوم بأخذ بعض البيانات، وأولها اسم صاحب التعليق، لذلك سنقوم بإنشاء متغير باسم commenter مثلاً ثم سنقوم بإسناد قيمة اسمه عن طريق دالة wp_get_current_commenter كالتالي: رمز PHP:


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


والآن سنقوم بوضع قيمة لمتغير سنقوم بتسميته aria_req، وهو مخصص لكي يظهر للمستخدم الحقول الإجبارية التي يجب عليه إدخال قيم فيها، وذلك عبر هذا السطر:
رمز PHP:


وقيمة هذا المتغير عبارة عن تحقق ما اذا كانت خاصية إجبار المستخدم على إدخال البريد الإلكتروني واسمه -فى متغير req- مفعلة أم لا، فإذا كانت مفعلة سيتم إدخال قيمة aria-required=true فى المتغير.
والآن سنقوم بإنشاء مصفوفة تحتوى على شيفرة HTML الخاصة بالحقول، كالتالي: رمز PHP:


أرجوا ان تكون الفكرة واضحة، ونلتقى فى الدرس القادم -بإذن الله-.

المصدر: شرح تصميم قوالب ووردبريس -الجزء الحادي عشر- - مدونة المبرمج