الگوهای ویرایش

الگوهای بلوک طرح های بلوک از پیش تعریف شده ، از برگه الگوهای درج بلوک موجود است. پس از وارد شدن به محتوا ، بلوک ها برای محتوای و پیکربندی اضافی یا اصلاح شده آماده هستند.

الگوهای بلوک

Register_Block_Patte

ویرایشگر دارای چندین الگوی بلوک اصلی است. نویسندگان موضوع و افزونه می توانند با استفاده از عملکرد یاور Register_Block_Patte ، الگوهای بلوک سفارشی اضافی را ثبت کنند.

تابع Helper Register_Block_Patte دو آرگومان دریافت می کند.-عنوان: یک عنوان قابل خواندن با دستگاه با یک کنوانسیون نامگذاری از فضای نام/عنوان.- خواص: آرایه ای که خصوصیات الگوی را توصیف می کند.

خواص موجود برای الگوهای بلوک عبارتند از:

• عنوان (مورد نیاز): یک عنوان قابل خواندن انسانی برای الگوی.
• محتوا (مورد نیاز): نشانه HTML را برای الگوی مسدود کنید.
• توضیحات (اختیاری): متنی پنهان بصری که برای توصیف الگوی موجود در درج استفاده می شود. توضیحات اختیاری است اما وقتی عنوان به طور کامل توصیف نمی کند که این الگوی انجام می دهد ، به شدت مورد تشویق قرار می گیرد. توضیحات به کاربران کمک می کند تا هنگام جستجو ، الگوی را کشف کنند.
• دسته بندی ها (اختیاری): مجموعه ای از دسته های الگوی ثبت شده که برای گروه های بلوک استفاده می شوند. الگوهای بلوک را می توان در چندین دسته نشان داد. برای استفاده در اینجا باید یک مقوله به طور جداگانه ثبت شود.
• کلمات کلیدی (اختیاری): مجموعه ای از نام مستعار یا کلمات کلیدی که به کاربران کمک می کند تا هنگام جستجو الگوی را کشف کنند.
• ViewPortWidth (اختیاری): یک عدد صحیح که عرض در نظر گرفته شده از الگوی را مشخص می کند تا پیش نمایش مقیاس یافته از الگوی موجود در قسمت را فراهم کند.
• blocktypes (اختیاری): مجموعه ای از انواع بلوک که این الگوی در نظر گرفته شده است. هر مقدار باید نام بلوک اعلام شده باشد.
• posttypes (اختیاری): مجموعه ای از انواع پست که از این الگوی محدود شده است. این الگوی فقط در هنگام ویرایش یکی از انواع پست های منتقل شده در آرایه در دسترس خواهد بود ، برای همه انواع پست دیگر این الگوی به هیچ وجه در دسترس نیست.
• TemplateTypes (اختیاری): مجموعه ای از انواع الگو که در آن الگوی حس می کند به عنوان مثال: 404 "اگر این الگوی برای صفحه 404 باشد ، اگر الگوی برای نشان دادن یک پست واحد باشد ، تک ارسال می شود.
• inserter (اختیاری): به طور پیش فرض ، تمام الگوهای در قسمت درج ظاهر می شوند. برای پنهان کردن یک الگوی به گونه ای که فقط به صورت برنامه ای درج شود ، درج را روی کاذب تنظیم کنید.

نمونه کد زیر یک الگوی بلوک به نام "My-Plugin/My-Awesome-Patte" را ثبت می کند:

Register_Block_Patte () باید از یک کنترل کننده متصل به قلاب اولیه فراخوانی شود.

الگوهای بلوک ثبت نشده

Unregister_block_patte

عملکرد یاور unregister_block_patte اجازه می دهد تا یک الگوی بلوک قبلاً ثبت شده از یک موضوع یا افزونه ثبت نشده و یک آرگومان را دریافت کند.- عنوان: نام الگوی بلوک که ثبت نشده است.

نمونه کد زیر الگوی بلوک با نام "My-Plugin/my-lesemes-patte" را ثبت نمی کند:

unregister_block_patte () را باید از یک کنترل کننده متصل به قلاب اولیه فراخوانی کرد.

دسته های الگوی بلوک

الگوهای بلوک را می توان با استفاده از دسته بندی ها گروه بندی کرد. ویرایشگر بلوک دارای دسته های بسته بندی شده است که می توانید در الگوهای بلوک سفارشی خود استفاده کنید. همچنین می توانید دسته های الگوی بلوک خود را ثبت کنید.

Register_Block_Patte_Category

تابع Helper Register_Block_Patte_Category دو آرگومان دریافت می کند.-عنوان: یک عنوان قابل خواندن با دستگاه برای دسته الگوی بلوک.- خواص: آرایه ای که خصوصیات دسته الگوی را توصیف می کند.

خواص دسته الگوی شامل موارد زیر است:

• برچسب (مورد نیاز): یک برچسب قابل خواندن انسانی برای دسته الگوی.

نمونه کد زیر مقوله ای به نام "قهرمان" را ثبت می کند:

Register_Block_Patte_Category () باید از یک کنترل کننده متصل به قلاب اولیه فراخوانی شود.

این گروه تحت الگوی نشان نمی دهد مگر اینکه الگویی به آن دسته اختصاص داده شود.

unregister_block_patte_category

unregister_block_patte_category اجازه می دهد تا یک دسته از الگوی را ثبت نکنید.

عملکرد یاور unregister_block_patte_category اجازه می دهد تا یک دسته از الگوی بلوک که قبلاً ثبت شده است از یک موضوع یا افزونه ثبت نشده و یک آرگومان را دریافت کند.- عنوان: نام گروه الگوی بلوک که ثبت نشده است.

نمونه کد زیر مقوله ای به نام "قهرمان" را ثبت نمی کند:

unregister_block_patte_categor () باید از یک کنترل کننده متصل به قلاب اولیه فراخوانی شود.

الگوهای متنی برای مسدود کردن انواع و تحولات الگوی

می توان یک الگوی بلوک را به یک یا چند نوع بلوک وصل کرد. این الگوی بلوک را به عنوان یک تبدیل در دسترس برای آن نوع بلوک اضافه می کند.

در حال حاضر این تحولات فقط در بلوک های ساده (بلوک های بدون بلوک داخلی) در دسترس هستند. برای اینکه یک الگوی پیشنهاد شود ، هر بلوک انتخاب شده باید در الگوی بلوک وجود داشته باشد.

کد فوق الگوی بلوک به نام "My-plugin/powered by-wordpress" را ثبت می کند و همچنین الگوی موجود در "منوی تبدیل" بلوک های پاراگراف را نشان می دهد. نتیجه تحول ، محتوای موجود پاراگراف را حفظ می کند و از سایر ویژگی ها نیز استفاده می کند - در این حالت پس زمینه و رنگ متن.

همانطور که در بالا ذکر شد ، تحولات الگوی برای بلوک های ساده نیز می تواند کار کند اگر ما چندین بلوک را انتخاب کرده ایم و الگوهای متنی متناسب با این بلوک ها وجود دارد. بیایید نمونه ای از الگویی را مشاهده کنیم که در آن دو نوع بلوک وصل شده اند.

در مثال بالا اگر یکی از دو نوع بلوک ، پاراگراف یا بلوک عنوان را انتخاب کنیم ، این الگوی با تبدیل بلوک انتخاب شده با استفاده از محتوای آن پیشنهاد می شود و همچنین بلوک های بازسازی را از این الگوی اضافه می کند. اگر از طرف دیگر چند پاراگراف و یک بلوک عنوان را انتخاب کنیم ، هر دو بلوک دگرگون می شوند.

بلوک ها همچنین می توانند از این الگوهای بلوک متنی در مکان های دیگر استفاده کنند. به عنوان مثال ، هنگام قرار دادن یک بلوک حلقه پرس و جو جدید ، به کاربر لیستی از تمام الگوهای متصل به بلوک ارائه می شود.

الگوهای بلوک معنایی

در مضامین بلوک ، شما همچنین می توانید الگوهای بلوک را به عنوان الگوهای "هدر" یا "پاورقی" (مناطق بخش الگو) علامت گذاری کنید. ما این "الگوهای بلوک معنایی" را می نامیم. این الگوهای هنگام قرار دادن یا تعویض قطعات هدر یا الگوی پاورقی به کاربر نشان داده شده است.