كيفية استخدام فئة WP_Query في ووردبريس؟

كيف يمكنك الاستفادة من WP_Query؟

الآن أنت تعرف ما هو WP_Query وما يفعله بالضبط. دعونا نتحقق من سيناريوهات الحالة المختلفة التي يمكنك من خلالها الاستفادة من هذه الأداة القوية.

1. قم بإنشاء حلقة في WP_Query

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

ما الذي يمكن أن تظهره الحلقة على الموقع؟

اعتمادًا على الإعدادات التي تختارها، يمكن أن تعرض الحلقة ما يلي:

• أنواع المنشورات المخصصة والحقول المخصصة
• نشر العناوين والأوصاف القصيرة على صفحتك الرئيسية
• محتوى المنشور الواحد والتعليقات
• محتوى الصفحات الفردية باستخدام علامات القالب

لفهم أفضل، فيما يلي بنية بسيطة للحلقة.

مثال الحلقة الأساسية

<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
// Display post content
endwhile;
endif;
?>

• هنا، تتحقق الدالة have_posts() من وجود أي منشورات متاحة.
• while ( have_posts() ) : the_post(); : إذا كانت هناك مشاركات، فسيتم تشغيل هذه الحلقة لكل مشاركة وعرض محتواها.

تخصيص الحلقة باستخدام WP_Query

في بعض الأحيان، لا ترغب في عرض جميع مشاركاتك. يمكنك استخدام WP_Query لتخصيص ما يتم عرضه:

<?php
// The Query
$the_query = new WP_Query( $args );

// The Loop
if ( $the_query->have_posts() ) {
echo '<ul>';
while ( $the_query->have_posts() ) {
$the_query->the_post();
echo '<li>' . get_the_title() . '</li>';
}
echo '</ul>';
} else {
// No posts found
}
/* Restore original Post Data */
wp_reset_postdata();
?>


كيف تعمل هذه الحلقة المخصصة

• إعداد الاستعلام : $the_query = new WP_Query( $args ); ينشئ استعلامًا مخصصًا بناءً على المعلمات التي قمت بتعيينها (مثل نوع المنشور والفئة وما إلى ذلك).
• تشغيل الحلقة : if ( $the_query->have_posts() ) { ... } يتحقق مما إذا كانت هناك منشورات تطابق استعلامك. إذا كان هناك، فإنه يعرض عنوان كل مشاركة في القائمة.
• إعادة ضبط بيانات النشر : wp_reset_postdata(); يضمن استعادة بيانات النشر الأصلية بعد تشغيل الحلقة المخصصة.

خيارات التخصيص

باستخدام WP_Query، يمكنك:

• إظهار المنشورات من فئة أو مؤلف أو نطاق زمني محدد
• عرض المنشورات بعلامات معينة أو حقول مخصصة

2. وسيطات WP_Query

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

• وسيطة الاستعلام : تخبر WordPress بالبيانات التي يجب استردادها.
• الاستعلام : يستخدم الوسيطة لجلب البيانات.
• الحلقة : تعالج كل مشاركة وتعرضها.
• إعادة تعيين بيانات النشر : إعادة تعيين البيانات بعد تشغيل الحلقة.

لكن أحد أهم مكونات WP_Query هو الوسيط (غالبًا ما يسمى WP_Query args) وهو المسؤول عن استخراج المنشور المحدد الذي تريد الحصول عليه من قاعدة البيانات.

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

مثال على حجة

• سطر $args : هذا هو المكان الذي تقوم فيه بتضمين وسيطة الاستعلام الخاصة بك.
• الهيكل : يمكنك وضع معلمات معينة في صفيف. إليك مثال أساسي،

$args = array(
'parameter1' => 'value',
'parameter2' => 'value',
'parameter3' => 'value'
);

مثال محدد

إذا كنت تريد عرض المشاركات التي تحمل العلامة "أخطاء WordPress"، فيمكنك إعداد وسيطة الاستعلام الخاصة بك على النحو التالي:

$query = new WP_Query( array( 'tag' => 'WordPress Errors' ) );

لماذا الحجة ضرورية

• بدون وسيطة، بدون محتوى : إذا لم تقم بتضمين وسيطة WP_Query، فلن يعرف WordPress المنشورات التي سيتم عرضها. لن يقوم استعلامك بجلب أي محتوى من قاعدة البيانات.

3. قم بتعيين معلمات WP_query

المعلمات هي ما يجعل WP_Query مفيدًا وقويًا. ومع تنوعها، أصبح من السهل على أي شخص تصفية عمليات البحث في قاعدة البيانات.

على سبيل المثال، عندما تريد عرض منشورات محددة على موقع WordPress الخاص بك، يمكنك استخدام WP_Query وللتأكد من حصولك على المنشور الصحيح، يمكنك تعيين المعلمات. ربما يدور في ذهنك سؤال آخر ما هي المعلمات؟

حسنًا، المعلمات تشبه تمامًا التعليمات التي تخبر WordPress بنوع المنشورات التي يجب الحصول عليها من قاعدة البيانات.

أمثلة على المعلمات المشتركة

فيما يلي بعض المعلمات الشائعة التي يمكنك استخدامها:

• القط : يعرض المشاركات من فئات محددة.
• المؤلف : يعرض المشاركات التي كتبها مؤلف واحد أو أكثر.
• post_status : يعرض المشاركات الجارية أو المجدولة أو المنشورة أو المحذوفة.
• orderby : فرز المشاركات حسب المؤلف، ونوع المنشور، والتاريخ، وما إلى ذلك.
• posts_per_page : يضبط عدد المشاركات التي سيتم عرضها.
• العلامة : إظهار المشاركات ذات العلامات المحددة.
• الترتيب : فرز المشاركات بترتيب تصاعدي أو تنازلي.
• post_type : يحدد ما إذا كان سيتم عرض المشاركات أو الصفحات أو أنواع المنشورات المخصصة.

كيفية استخدام المعلمات

إذا كنت تريد إظهار المشاركات من فئة معينة، فيمكنك استخدام معلمة category_name . هنا مثال:

$query = new WP_Query( array( 'category_name' => 'WordPress' ) );

سيُظهر هذا جميع المشاركات في فئة "الموظفين" وأي فئات فرعية.

مثال أكثر تعقيدا

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

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

$args = array(
'category__in' => array(5, 10), // Categories with IDs 5 and 10
'tag__in' => array('featured', 'popular'), // Posts tagged with 'featured' or 'popular'
'author__in' => array(1, 2), // Authors with IDs 1 and 2
'orderby' => 'date', // Order by date
'order' => 'DESC', // In descending order
'posts_per_page' => 10 // Limit to 10 posts
);

$query = new WP_Query($args);

// The Loop
if ($query->have_posts()) {
while ($query->have_posts()) {
$query->the_post();
// Display post content
the_title('<h2>', '</h2>');
the_excerpt();
}
} else {
// No posts found
echo 'No posts found';
}

// Restore original Post Data
wp_reset_postdata();


• Category__in : يساعد على تحديد أننا نريد مشاركات من الفئات ذات المعرفات 5 و10.
• tag__in : يحدد أننا نريد المشاركات الموسومة إما بـ "مميز" أو "شائع".
• Author__in : يحدد أننا نريد مشاركات للمؤلفين ذوي المعرفين 1 و2.
• orderby : يحدد أننا نريد ترتيب المنشورات حسب تاريخ نشرها.
• الترتيب : يحدد أننا نريد المنشورات بترتيب تنازلي (الأحدث أولاً).
• posts_per_page : يحد من عدد المشاركات التي تم استردادها إلى 10.

4. تعديل الكائنات باستخدام الأساليب وخصائص الفئة

في WordPress، WP_Query عبارة عن فئة PHP خاصة تُستخدم لاسترداد المنشورات من قاعدة البيانات. فكر في الأمر كأداة تساعدك في الحصول على المنشورات المحددة التي تريد عرضها على موقع الويب الخاص بك.

ما هي خصائص الطبقة والأساليب؟

في PHP، يمكن أن يكون للفئة خصائص (مثل المتغيرات) وأساليب (مثل الوظائف). إليك طريقة بسيطة لفهمهم:

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

هل يمكنك تغيير الخصائص مباشرة؟

لا، لا يمكنك تغيير الخصائص مباشرة، حتى المطورين لا يشجعون ذلك بشدة، ولكن يمكنك استخدام الأساليب بدلاً من ذلك.

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

مثال على استخدام الأساليب في WP_Query

في هذا المثال، يمكن أن تكون وظيفةset_postdata() خطوة حاسمة في كتابة WP_Query الخاص بك. ستعمل هذه الطريقة على إعادة تعيين خصائص $current_post و$post.

<?php
// Create a new query with specific arguments
$the_query = new WP_Query(array(
'post_type' => 'post',
'posts_per_page' => 5,
'category_name' => 'news',
));
?>

<?php if ($the_query->have_posts()) : ?>
<!-- Display the posts -->
<?php while ($the_query->have_posts()) : $the_query->the_post(); ?>
<h2><?php the_title(); ?></h2>
<p><?php the_excerpt(); ?></p>
<?php endwhile; ?>
<!-- Reset the post data to avoid conflicts -->
<?php wp_reset_postdata(); ?>
<?php else : ?>
<p><?php _e('Sorry, no posts matched your criteria.'); ?></p>
<?php endif; ?>


انفصال:

• إنشاء استعلام :
  • $the_query = new WP_Query($args); : يقوم بإنشاء كائن WP_Query جديد باستخدام الوسائط التي قدمتها.
• التحقق من المشاركات :
  • if ($the_query->have_posts()) : يتحقق مما إذا كان هناك أي منشورات لعرضها بناءً على استعلامك.
• حلقات من خلال المشاركات :
  • while ($the_query->have_posts()) : $the_query->the_post(); : يقوم بإعداد بيانات النشر حتى تتمكن من عرضها.
• عرض المشاركات :
  • the_title(); و the_excerpt(); : يعرض عنوان ومقتطف من المنشور الحالي.
• إعادة ضبط بيانات المشاركة :
  • wp_reset_postdata(); : يقوم بإعادة تعيين بيانات النشر العامة إلى منشور الاستعلام الرئيسي. يعد هذا أمرًا مهمًا لتجنب إتلاف أجزاء أخرى من صفحتك.

الطرق الشائعة التي يمكنك استخدامها

فيما يلي بعض الطرق الشائعة في WP_Query التي يمكنك استخدامها للتعامل مع استعلامك:

• get_posts :
  • ماذا يفعل : استرداد قائمة المشاركات.
  • مثال : كود phpCopy $posts = get_posts(array('category' => 'news'));
• have_posts :
  • ماذا يفعل : التحقق من وجود أي منشورات لعرضها.
  • مثال : كود phpCopy if ($the_query->have_posts()) { // There are posts to show }
• the_post :
  • ماذا يفعل : يقوم بإعداد بيانات النشر الحالية.
  • مثال : كود phpCopy $the_query->the_post();
• fill_query_vars :
  • ماذا يفعل : يكمل تفاصيل الاستعلام المفقودة.
  • مثال : كود phpCopy $the_query->fill_query_vars($args);

من خلال تزويد WP_Query بالمعلومات الصحيحة، يمكنك تخصيصها لأداء مهام مختلفة. تعتبر هذه الطريقة طريقة مرنة وآمنة لضبط خصائص الفصل.

WP_Query مقابل query_posts(): أيهما أفضل؟

يوجد أدناه جدول مقارنة تفصيلي بين WP_Query مقابل query_posts() في WordPress، بما في ذلك بعض النقاط الرئيسية التي يمكن أن تساعدك على فهم سبب تفضيل WP_Query بشكل عام على query_posts() :

بعض الأمثلة على استخدام WP_Query

لفهم WP_Query واستخدامه العملي بشكل أفضل، راجع بعض الأمثلة الواردة أدناه:

1. عرض أحدث المشاركات المنشورة هذا الأسبوع

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

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

<?php
$arguments = array(
"date_query" => array(
array(
"year" => date( "Y" ),
"week" => date( "W" ),
)
)
);
$posts = new WP_Query($arguments);
?>


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

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

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

2. عرض آخر منشور في فئة معينة

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

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

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

لذا، إذا كنت تريد جلب أحدث المنشورات في فئة معينة، فاستخدم WP_query هذا، وقم بإجراء تعديلات بسيطة تتضمن معلومات موقعك:

<?php

// Get the current post id.
$current_post_id = get_the_ID();

// Get the current post's category (first one if there's more than one).
$current_post_cats = get_the_category();
$current_post_first_cat_id = $current_post_cats[ 0 ]->term_id;

// Setup arguments.
$args = array(
// Get category's posts.
'cat' => $current_post_first_cat_id,
// Exclude current post.
'post__not_in' => array( $current_post_id )
);

// Instantiate new query instance.
$my_query = new WP_Query( $args );

?>

3. إظهار المشاركات لنفس المؤلف وفي نفس الفئة

من المحتمل جدًا أنه إذا استمتع الزائر بالمحتوى الخاص بك، فقد تعجبه آراء المؤلف وأسلوب كتابته وتصوره.

لهذا، يمكنك استخدام WP_Query لاقتراح القراء منشورات مماثلة كتبها نفس المؤلف. سيبحث الاستعلام عن المنشورات التي كتبها نفس المؤلف لنفس فئة المنشور الحالي.

لهذا، يتعين علينا إنشاء سلسلة WP_Query محددة، والتي ستبحث عن المنشورات ذات المؤلفين المتشابهين ونفس الفئة.

هنا هو الرمز:

<?php
$arguments = array(
"author_name" => "Rahul",
"category_name" => "WordPress",
"posts_per_page" => 3,
);
$posts = new WP_Query($arguments);
?>


في الكود أعلاه، تحتاج إلى استبدال "Rahul" باسم المؤلف و"WordPress" باسم الفئة.

4. عرض مشاركاتك الأكثر شعبية

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

<?php
$arguments = array(
"category_name" => "WordPress Errors",
"orderby" => "comment_count",
"posts_per_page" => 5,
);
$posts = new WP_Query($arguments);
?>

سيبحث WP_Query أعلاه عن المشاركات في فئة "أخطاء WordPress" وسيقوم بتصفية النتائج حسب عدد التعليقات الموجودة في كل مشاركة.

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

خاتمة

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

لاستخدام WP_Query، يمكنك:

• إنشاء حلقة: عرض مشاركاتك.
• استخدام وسيطات الاستعلام: قم بتخصيص عمليات البحث الخاصة بك.
• تعيين معلمات محددة: تصفية النتائج الخاصة بك.
• تعديل خصائص الفئة: ضبط نتائج الاستعلام باستخدام الأساليب.

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

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

إذا كانت لا تزال لديك شكوك بشأن WP_Query أو ترغب في إضافة المزيد من أجزاء المحتوى التي ربما فاتناها. يرجى إعلامنا بذلك في قسم التعليقات أدناه.

راهول

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