يفتح Vendix Theme مواضعه للإضافات والقوالب الفرعية. يسرد هذا المرجع الخطافات الموثّقة. وتشرح الأسئلة الشائعة في ملف readme الخاص بالقالب والملاحظات في شيفرته كل خطاف بتفصيل أكبر.
عرض تخطيط في موضع من القالب
يستقبل المرشّح vendix_theme/location أسماء مواضع Elementor Theme Builder وهي: header وfooter وsingle وarchive. الإضافة التي تعرض تخطيطها الخاص للموضع تُرجع true، وعندها لا يرسم القالب شيئًا من عنده هناك.
add_filter( 'vendix_theme/location', function ( $printed, $location ) {
if ( 'header' !== $location ) {
return $printed;
}
// Print your header here.
echo '<header class="my-header">…</header>';
return true;
}, 10, 2 );
- يعمل
headerوfooterفي كل صفحة. - يعمل
singleللمقالة والصفحة (بما فيها صفحات السلة وإتمام الطلب والحساب) والمرفق وأي عنصر من نوع محتوى آخر والمنتج وصفحة 404. - يعمل
archiveلصفحة المقالات وأرشيفات المقالات ونتائج البحث والمتجر وتصنيفات المنتجات ووسومها. - اسم الموضع لا يحدد نوع الصفحة المعروضة. اختر قالبك بناءً على الطلب (نوع المحتوى و
is_404()وis_cart()وما شابه) وأرجِعfalseفي الحالات الأخرى. - عند عرض
singleأوarchive، لا يعرض القالب حوله سوى ترويسته وتذييله. - تدلّ
current_theme_supports( 'vendix-templates' )على أن القالب يعمل بهذه الطريقة.
يأتي تخطيط الإضافة أولًا، ثم Elementor Theme Builder، ثم الجزء الخاص بالقالب.
الإجراءات
| الإجراء | مكان التنفيذ |
|---|---|
vendix_theme/header_before | قبل ترويسة القالب، خارجها |
vendix_theme/header_after_branding | في صف الترويسة، مباشرة بعد الشعار أو عنوان الموقع |
vendix_theme/header_actions | في نهاية صف الترويسة؛ تتجمّع الأجزاء داخل المجموعة .vt-header-actions |
vendix_theme/header_after | بعد ترويسة القالب، خارجها |
vendix_theme/footer_before | بعد المحتوى وقبل التذييل، أيًّا كان من يرسم التذييل |
vendix_theme/single_before_content | فوق نص المقالة مباشرة، مع معرّف المقالة |
vendix_theme/single_after_content | أسفل نص المقالة مباشرة، مع معرّف المقالة |
vendix_theme/post_meta | نهاية سطر بيانات المقالة، مع معرّف المقالة |
vendix_theme/card_meta | نهاية سطر بيانات بطاقة المقالة، مع معرّف المقالة |
vendix_theme/news_* | مواضع الأخبار في مواقع الأخبار / المجلات: news_top_bar وnews_ticker وnews_post_meta وnews_card_meta وnews_before_content وnews_after_content |
لا تعمل إجراءات الترويسة إلا عندما يرسم القالب ترويسته الخاصة. الترويسة المبسّطة، كما في صفحة إتمام الطلب البسيطة، لا تعرض إجراءات صف الترويسة. وتمتد الترويسة الشفافة فوق أعلى الصفحة فتغطي أي جزء معروض قبلها أو بعدها؛ لذا تحقّق أولًا من vendix_theme_header_transparent() واستبعد الجزء، كما يفعل القالب مع الشريط العلوي للأخبار.
تعمل إجراءات المقالات في جميع أنواع المواقع. في مواقع الأخبار تبقى إجراءات vendix_theme/news_* في مكانها، وتأتي الإجراءات العامة بعدها، باستثناء vendix_theme/single_after_content الذي يأتي قبل vendix_theme/news_after_content.
المرشّحات
| المرشّح | ما يغيّره |
|---|---|
vendix_theme/site_type | نوع الموقع: business أو store أو news |
vendix_theme/defaults | القيمة الافتراضية لكل خيار من خيارات القالب، مع نوع الموقع |
vendix_theme/header_minimal | ما إذا كانت ترويسة القالب تعرض الشعار أو عنوان الموقع فقط |
vendix_theme/footer_minimal | ما إذا كان تذييل القالب يعرض نص التذييل فقط |
vendix_theme/page_options_post_id | المقالة التي تُطبَّق خيارات تخطيط الصفحة الخاصة بها، للعروض التي تمثّلها صفحة، مثل المتجر |
vendix_theme/palette | ألوان نظام التصميم في لوحة ألوان محرّر المكوّنات |
vendix_theme/setup_url | عنوان الإعداد الموجَّه لإضافة ما، لصفحة الترحيب |
vendix_theme/setup_complete | ما إذا اكتمل الإعداد الموجَّه للإضافة، مما يُخفي تنبيه الإعداد |
يمكن للإضافات أيضًا قراءة نوع الموقع عبر vendix_theme_site_type().
زوّد القالب بألوانك وخطوطك
- الألوان: يستقبل المرشّح
vendix_theme/paletteمصفوفة فارغة. أرجِع ألوان نظام التصميم على شكل مفتاح ولون hex، بالمفاتيحprimaryوsecondaryوaccentوheadingوtextوmutedوborderوbg_lightوbg_dark. يأخذ القالب كل لون hex صالح للوحة ألوان محرّر المكوّنات، ويحتفظ بلوحته الخاصة إذا لم تُقدَّم أي ألوان. أما الموقع نفسه فيقرأ متغيرات CSS--vendix-color-*. - الخطوط: اضبط متغيرات CSS على العنصر الجذر،
--vendix-type-{body|h1|h2|h3|h4|h5|h6|menu}-{family|size|size-tablet|size-mobile|weight|line-height|letter-spacing|transform}، كلًّا منها فقط عندما تكون له قيمة. يقرؤها القالب لنص المحتوى والعناوين وقائمة القالب ونص مقالات الأخبار وعنوانها وعناوينها الفرعية، مع قيمه الخاصة كبديل. تُطبَّق أحجام الأجهزة اللوحية حتى 1024 بكسل وأحجام الهواتف حتى 767 بكسل.
خطافات CSS
| الخطاف | ما يدل عليه |
|---|---|
الفئة vt-sticky-header على <html> | تُعرض ترويسة قالب ثابتة |
المتغير --vt-sticky-header-height على <html> | ارتفاع الترويسة الثابتة المغلقة، للأجزاء التي تثبت أسفلها |
الفئة vt-menu-open على <html> | قائمة الهاتف مفتوحة |
الفئة vt-header-slot | منطقة بجانب الشعار: على سطح المكتب تنتقل القائمة إلى صف خاص بها، وعلى الأجهزة اللوحية والهواتف تأخذ المنطقة صفًا كاملًا |
المتغير --vt-back-to-top-offset | يرفع زر العودة إلى الأعلى، لأجزاء الإضافات المثبتة أسفل الشاشة |
الفئات vt-type-business وvt-type-store وvt-type-news على <body> | نوع الموقع |
تغيب فئة الترويسة الثابتة ومتغيرها عندما لا تكون الترويسة ثابتة، وعندما ترسم إضافة أو Elementor Theme Builder الترويسة، وعندما تكون الترويسة مخفية.