الرموز المختصرة

الرمز المختصر “عرض المقالات”

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

الأكواد القصيرة عبارة عن قصاصات صغيرة من أكواد مصمَّمة خصوصًا لوردبرس وتتيح لك إضافة ميزات مختلفة إلى موقعك أو مدونتك. يمكن إيجاد مزيد من المعلومات حول الأكواد القصيرة هنا.

جدول المحتويات

نظرة عامة على الكود القصير لعرض المقالات
إضافة الكود القصير
عرض الوسيطات
أمثلة التخصيص
محاذاة الصور
(متقدِّم) استعلامات التصنيف المتعددة
القيود

لن يعمل الكود القصير [display-posts] في المواقع التابعة لخطة الأعمال أو خطة أعلى على وردبرس.كوم باستخدام الإضافات. توفِّر المكوِّنات الإضافية المختلفة وظائفَ مماثلة.

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


نظرة عامة على الكود القصير لعرض المقالات

ثمَّة عدد من الأسباب وراء رغبتك في استخدام الكود القصير لعرض المقالات.

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

↑ جدول المحتويات ↑

إضافة الكود القصير

ستعمل الإرشادات التالية على تحرير صفحة أو مقالة أو مربع نص جانبي. عند إضافة الكود التالي، لن ترى سوى العنصر النائب عن الكود في المحرِّر. ولكن عندما تنشر صفحتك، سترى نتيجة الكود القصير.

  1. تحرير صفحة أو مقالة أو مربع نص جانبي.
  2. أضف الكود القصير [display-posts] في مقالة أو صفحة.
  3. انشر صفحتك/مقالتك أو حدِّثها.

إذا كنتَ تستخدم محرِّر مكوِّنات وردبرس، فيمكنك أيضًا إضافة مكوِّن الكود القصير لإضافة الكود القصير لعرض المقالات.

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

الكود القصير المباشر لعرض المقالات
هذه هي الطريقة التي يبدو عليها الكود القصير لعرض المقالات في الصفحة المباشرة باستخدام القالب “Twenty Seventeen”.

سيعرض الكود القصير لعرض المقالات قائمة نقطيَّة تضم أحدث 10 مقالات بصورة افتراضية. من الممكن تخصيص عدد المقالات إلى جانب الأسلوب وعناصر المقالات التي تظهر في القائمة (العنوان، والصور المميزة، والمقتطفات، إلخ).


↑ جدول المحتويات ↑

عرض الوسيطات

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

المؤلف
حدِّد مؤلف المقالة
الافتراضي: فارغ
مثال: [display-posts author="bill"]

التصنيف
حدِّد حقل التصنيف الاحتياطي (أو القائمة المفصولة بفواصل من حقول التصنيف الاحتياطية). اطَّلع على هذا الكود القصير وهو يعمل على هذا الموقع المُتَّخَذ كمثال.
افتراضي: فارغ
مثال: [display-posts category="fishing,hiking"]

date_format
حدِّد تنسيق التاريخ المستخدم عندما يكون include_date صحيحًا. اطَّلع على تنسيق التاريخ والوقت في المخطوطة للحصول على مزيد من المعلومات.
افتراضي: “(n/j/Y)”
مثال: [display-posts include_date="true" date_format="F j, Y"]

id
حدِّد معرِّف مقالة معيَّنة (أو معرِّفات مقالات متعددة) للعرض.
افتراضي: فارغ
مثال: [display-posts id="9, 10"]

image_size
حدِّد حجم الصورة اللازم لعرض الصورة المميزة، إذا كانت المقالة تحتوي على واحدة. يمكن تعيين image_size على صورة مُصغَّرة أو متوسطة أو كبيرة (يتم التحكم في كل ذلك من الإعدادات > الوسائط).
افتراضي: فارغ
مثال: [display-posts image_size="thumbnail"]

إذا كنتَ تستخدم قالبًا يدعم خيارات المحتوى، وقمتَ بتعيينه على عدم عرض الصور المميزة على الصفحات، فلن يكون للوسيطة image_size أيضًا أي تأثير في الأكواد القصيرة المستخدمة على إحدى الصفحات على الموقع – لن تُعرض الصور المميزة لأي مقالات تمت إضافتها عبر الكود القصير حتى إذا كان الكود القصير ينص على ضرورة عرضها.

include_content
يمكنك تضمين محتوى المقالة بالكامل بعد العنوان.
افتراضي: فارغ
مثال: [display-posts include_content="true"]

include_date
يمكنك تضمين تاريخ المقالة بعد عنوان المقالة. التنسيق الافتراضي هو (7/30/12)، لكن يمكن تخصيص ذلك باستخدام معيار “date_format”.
افتراضي: فارغ
مثال [display-posts include_date="true"]

include_excerpt
يمكنك تضمين مقتطف المقالة بعد العنوان (والتاريخ في حالة وجوده).
افتراضي: فارغ
مثال: [display-posts include_excerpt="true"]

الإزاحة
عدد المقالات اللازمة للمرور
افتراضي: 0
مثال: [display-posts offset="3"]

الترتيب
حدِّد ما إذا كانت المقالات تُرتَّب ترتيبًا تنازليًّا أم تصاعديًّا.
افتراضي: ترتيب تنازلي
مثال: [display-posts order="ASC"]

الترتيب حسب
حدِّد ترتيب المقالات. اطِّلع على المعايير المتاحة من هنا.
افتراضي: التاريخ
مثال: [display-posts orderby="title"]

portfolio_type
إذا كنتَ تستخدم نوع مقالة معرض الأعمال، فاستخدم هذا للحصول على العناصر من نوع معيِّن من معرض الأعمال.

post_parent
عرض الصفحات التي تُعد تابعة لصفحة معيَّنة. يمكنك إما تحديد معرِّف أو “حاليّ”، وهذا يعرض الصفحات التابعة للصفحة الحالية.
افتراضي: فارغ
مثال: [display-posts post_type="page" post_parent="8"]

post_status
عرض المقالات المرتبطة بحالة مقالة معيَّنة
افتراضي: نشر
مثال: [display-posts post_status="publish, future"]

post_type
حدِّد نوع المقالة المطلوب استخدامه. يمكنك استخدام نوع افتراضي (مقالة أو صفحة). بالنسبة إلى قوائم المشروعات، استخدم ” قائمة مشروعات jetpack”.  وبالمثل، بالنسبة إلى الشهادات، استخدم “jetpack-testimonial”.
افتراضي: مقالة
مثال: [display-posts post_type="page"]

posts_per_page
كم عدد المقالات المطلوب عرضها.
افتراضي: 10
مثال: [display-posts posts_per_page="5"]

وسم
حدِّد حقل الوسم الاحتياطي  (أو قائمة مفصولة بفاصلة من حقول  الوسوم الاحتياطية)
افتراضي: فارغ
مثال: [display-posts tag="tag1, tag2"]

التصنيف وtax_term وtax_operator
استخدم هذه المعايير للقيام باستعلامات التصنيف المتقدِّمة. استخدم “التصنيف” للحصول على التصنيف الذي ترغب في الاستعلام عنه، و”tax_term” لحقل المصطلح (أو المصطلحات) الذي تريد تضمينه، و”مشغِّل” لتغيير كيفية استخدام الاستعلام لتلك المصطلحات (على الأرجح لن تكون هناك حاجة إلى هذا الحقل).
افتراضي: “التصنيف” = فارغ، “tax_term” = فارغ، “tax_operator” = “IN”
مثال: [display-posts taxonomy="color" tax_term="blue, green"]

الغلاف
ما نوع HTML الذي ينبغي استخدامه لعرض القوائم؟ يمكن أن تكون قائمة غير مُرتَّبة أو قائمة مُرتَّبة أو قائمة متنوعة يمكنك تصميم نمطها بنفسك.
افتراضي: غير المُرتَّبة
مثال: [display-posts wrapper="ol"]


↑ جدول المحتويات ↑

أمثلة التخصيص

فيما يلي بعض أمثلة الأكواد القصيرة التي تجمع بين وسيطات متعددة لعرض قائمة مقالات معيَّنة.

[display-posts tag="advanced" posts_per_page="20"]

سيسرد هذا آخر 20 مقالة موسومة بالعلامة “متقدِّم”.

[display-posts tag="advanced" image_size="thumbnail"]

سيسرد هذا أحدث 10 مقالات موسومة بعلامة “مُتقدِّم” ويعرض صورة مقالة باستخدام حجم “الصورة المصغَّرة”.

[display-posts category="must-read" posts_per_page="-1" include_date="true" order="ASC" orderby="title"]

سيسرد هذا كل مقالة في فئة “يجب قراءتها”، بالترتيب الأبجدي، مع كتابة التاريخ في النهاية.

[display-posts wrapper="ol"]

سيعرض هذا المقالات كقائمة مرتَّبة. الخيارات هي قائمة غير مرتَّبة للقوائم غير المرتَّبة (افتراضي) أو قائمة مرتَّبة للقوائم المرتَّبة أو قائمة متنوعة للقوائم المتنوعة.

[display-posts id="14,3"]

سيعرض هذا فقط المقالات التي تحتوي على المعرّفين 14 و3.


↑ جدول المحتويات ↑

محاذاة الصورة

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

[display-posts include_excerpt="true" image_size="thumbnail" wrapper="div"]

يتضمن هذا المقتطف ويضيف صورة بحجم “الصورة المصغَّرة” (يمكنك تخصيص أحجام الصور من الإدارة → الإعدادات → الوسائط)، ويطلب عرض القائمة من دون رموز نقطية.

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

‎.display-posts-listing .alignleft {
    العائم: اليمين؛
     الهامش: 0 0 5px 5px؛
}


↑ جدول المحتويات ↑

(مُتقدِّم) استعلامات التصنيف المتعددة

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

[display-posts taxonomy="category" tax_term="featured" taxonomy_2="post_tag" tax_2_term="homepage"]

يمكنك إدخال أي عدد تريده من تلك الرموز المختصرة في سلسلة، ابدأ فقط بالعد عند الرقم 2. في الحقل المذكور أدناه، استبدل عددًا فعليًّا (بالعدد).

فيما يلي الحقول المتاحة:

taxonomy_(count)
التصنيف المطلوب الاستعلام عنه
افتراضي: فارغ

tax_(count)_term
المصطلحات المطلوب تضمينها (افصل بين المصطلحات بفواصل إذا كان ثمَّة أكثر من مصطلح)
افتراضي: فارغ

tax_(count)_operator
كيفية الاستعلام عن المصطلحات (“في” أو “ليس في” أو “و”)
افتراضي: في

tax_relation
صِف العلاقة بين استعلامات التصنيف المتعددة (هل يجب أن تتطابق النتائج مع جميع الاستعلامات أم مع استعلام واحد فقط؟). الخيارات المتوفّرة: “و” و”أو”
افتراضي: و


↑ جدول المحتويات ↑

القيود

يصل  حد الرمز المختصر “عرض المقالات” إلى 100 مقالة معروضة.