دليل لاستخدام الخطافات في الوظائف المخصصة

نشرت: 2013-03-29

قد تعتقد أن الخطافات معقدة وهو أمر مفهوم لأن هذا ما فكرت به عندما نظرت إليها لأول مرة!

الحقيقة هي أن الخطافات سهلة الفهم.

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

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

ما هي الخطافات؟

الخطافات هي مجرد نقطة أو موقع في ملفات قالب السمات.

يتم إعطاؤهم أسماء وصفية بناءً على الموضوع الذي يتم استخدامه فيه مثل:

  • woo_post_after - خطاف محدد لمواضيع Woo والذي يتم تنفيذه بعد كل المنشورات الفردية
  • genesis_after_header - خطاف موضوع محدد من Genesis يتم تنفيذه بعد مشاركات فردية
  • wp_footer - خطاف WordPress يتم تنفيذه بعد التذييل في جميع السمات.

أسهل طريقة لفهم مكان وجود الخطافات المختلفة في Genesis ، هي عرض دليل ربط مرئي يحتوي على جميع مواقع الخطافات.

genesis_after_header عبارة عن خطاف يستخدم في سمات Genesis الفرعية (StudioPress) والتي يتم تنفيذها بعد العنوان في جميع الصفحات.

بدلاً من إضافة المحتوى الخاص بك إلى ملف header.php الخاص بالسمات الرئيسية والذي يتم استخدامه لعرض الرأس الخاص بك ، يمكنك ببساطة إضافة المحتوى في وظيفة مخصصة في ملفات السمات التابعة لك.

woo_before_header عبارة عن خطاف يعمل في سمات Woo ويقع في رأس السمات الرئيسية.

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

خطافات ووردبريس

wp_footer عبارة عن خطاف WordPress يعمل في أي سمة بدلاً من السنانير الخاصة بالموضوع مثل genesis_after_post و woo_header.

بدلاً من تحرير ملف footer.php في ملفات WordPress الأساسية ، يمكنك ببساطة استخدام ربط wp_footer في وظيفة مخصصة لربط (عرض) المحتوى في الموقع الذي يوجد به رابط wp_footer في ملف قالب footer.php.

خرائط الخطاف المرئية

يوفر كل مطور سمة عادةً خريطة للمكان الذي يتم فيه تنفيذ كل خطاف بالضبط جنبًا إلى جنب مع قائمة الخطافات ووصفًا للمكان الذي يتم تنفيذه في السمة الخاصة بك.

  • Woo Themes Visual Hook Map
  • دليل جينيسيس المرئي هوك
  • مرجع الخطاف المرئي للأطروحة

تحتوي ملفات قالب القالب الرئيسي وملفات قالب WordPress على الخطافات التي أضافها مطورو السمات المختلفون في مواقع مختلفة لكل ملف قالب.

ثم يقدمون قائمة بهذه الخطافات التي يمكنك إضافتها إلى وظيفة مخصصة لعرض المحتوى في موقع الخطاف المحدد هذا في قالبك.

الخطافات في ملفات القوالب

تقليديًا ، إذا كنت ترغب في عرض المحتوى في مكان معين على موقع الويب الخاص بك ، فستحتاج إلى إضافة المحتوى باستخدام HTML أو Text أو PHP مباشرةً إلى ملفات قوالب السمات الرئيسية. (وما زال بعض الناس يفعلون!)

باستخدام الخطافات ، لن تحتاج إلى إضافة المحتوى الخاص بك في أي من ملفات القالب.

والسبب في ذلك هو أن كل ملف قالب يحتوي على العديد من الروابط التي يمكنك ببساطة الرجوع إليها في ملف وظائف السمات الفرعية بدلاً من قرصنة ملفات السمات الرئيسية.

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

خطافات في ملفات التكوين

ملاحظة: لا يجب عليك تعديل ملفات Genesis الأساسية ولا يجب عليك ذلك.

دعنا نلقي نظرة على مكان وجود خطافات الإجراءات في ملفات قالب السمات الأصلية.

يوجد أدناه صورة لملف قالب Genesis header.php الموجود في ملفات السمات الأساسية الأساسية.

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

ستلاحظ أيضًا أن هناك بعض روابط التكوين الأخرى هناك وأيضًا خطاف WordPress مطلوب لتوصيل بعض المكونات الإضافية.

يمكنك استخدام خطاف WordPress في وظيفة إذا أردت وستعمل الوظيفة على جميع السمات لأنها تحتوي جميعها على خطافات WordPress.

وظائف مع خطاف العمل #

لنلقِ نظرة على وظيفة مخصصة أساسية جدًا تعرض نصًا في أي موقع ربط في سمات Genesis الفرعية.

الخطاف الذي نستخدمه لعرض النص قبل تسمية المحتوى بـ genesis_after_header hook.

نقوم بتضمينها مع وظيفة أساسية أنشأناها تصف ما تفعله الوظيفة والتي تسمى في هذه الحالة content_after_header

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

وفي ملف style.css الخاص بالمواضيع الفرعية ، يمكننا استخدام هذه الفئة الجديدة لتصميم المحتوى في موقع الخطاف هذا على النحو التالي:

 .after-header { background: grey; border: solid 3px #222; padding: 10px; }

تكوين بسيط هوكس البرنامج المساعد

إليك طريقة أخرى لإلقاء نظرة على خطافات الرؤوس عبر حقول الخطاف الموجودة في المكون الإضافي Genesis Simple Hooks.

خطاف رأس جينيسيس

نقطة انطلاق جيدة جدًا لتعلم كيفية استخدام الخطافات في Genesis هي البدء في استخدام المكون الإضافي Genesis Simple Hooks.

يمكّنك هذا المكون الإضافي من لصق HTML أو نص أو رموز قصيرة أو كود PHP بسهولة والتي سيتم تنفيذها في موقع ربط محدد.

هذه طريقة ممتازة لمعرفة المزيد حول مكان وجود كل خطاف في Genesis وكيفية عرض أنواع مختلفة من المحتوى في تلك المواقع.

يمكنك أيضًا تنفيذ تعليمات PHP البرمجية في أي من مواقع الخطافات باستخدام خطافات بسيطة طالما أنك تلف كود PHP في علامات PHP:

الكود أعلاه ، بمجرد لصقه في حقل genesis_hook باستخدام البرنامج المساعد Simple Hooks ، سيخرج منزلق صورة على الصفحة الرئيسية فقط.

استخدام الخطافات ذات الوظائف المخصصة والعلامات الشرطية

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

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

لن يعرض النص في صفحات الأرشيف مثل أرشيفات المدونة أو الصفحة الرئيسية أو الفئة ولن يعرض النص على الصفحات الثابتة.

المزيد من الوظائف المخصصة مع الخطافات

  • خطافات العمل لتطوير موضوع الوالدين
  • دليل الخطافات والفلاتر للمبتدئين