احجز استشارتك

Filter Hook

خطّاف التصفية

يُكتب أيضاً: add_filter, Filter

نوع من الهوكات يمرر قيمة إلى دالتك عبر add_filter لتعدّلها ثم تعيدها، وأي إضافة تستبدل القيمة كلها بدل الإضافة إليها قد تمحو تعديلات إضافات أخرى قبلها.

خطّاف التصفية (Filter Hook) نقطة يمرر عندها ووردبريس قيمة ما عبر الدوال المربوطة بها قبل استخدامها، فتستطيع كل دالة تعديلها. عنوان المقالة ومحتواها وطول المقتطف ونص زر، كلها تمر بفلاتر.

تربط دالتك بـ add_filter()، فتستقبل القيمة وتعيدها بعد التعديل. القاعدة الذهبية أن تعيد قيمة دائمًا، فنسيان return يجعل القيمة فارغة، وهو سبب شائع لاختفاء المحتوى فجأة.

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

مقالات بتستخدم المصطلح