كيفية إنشاء قوالب جوتنبرج

نشرت: 2018-12-14

تتمثل إحدى مزايا إنشاء الصفحات والمنشورات باستخدام Gutenberg Blocks في القدرة على حفظها كقوالب. يعد إنشاء قوالب لـ Gutenberg طريقة رائعة للمساعدة في تسريع عملية النشر. هناك عدة طرق لإنشائها. في هذه المقالة ، سنرى كيفية إنشاء قوالب جوتنبرج.

سنغطي ثلاث طرق لإنشائها:

  1. إنشاء تخطيط لإضافته إلى مكتبة Gutenberg للتصدير أو الاستنساخ.
  2. إنشاء تخطيط لنسخه ولصقه عندما تريد استخدامه.
  3. إنشاء تخطيط لإضافته كتخطيط افتراضي للصفحات أو المنشورات أو أنواع المنشورات المخصصة.

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

لماذا إنشاء قوالب جوتنبرج

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

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

الطريقة الأولى: إنشاء قالب تخطيط

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

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

مثال على قالب التخطيط

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

ضع المؤشر على الكتلة الأولى التي تريد تضمينها واسحب الماوس إلى آخر كتلة لتمييزها.

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

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

ستظهر الرسالة في الشريط الأخضر أنه تم تحديث الكتلة. لقد قمت بإنشاء التخطيط!

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

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

مشاركات مكررة

لحسن الحظ ، لدينا خيار آخر. يضيف مكون إضافي يسمى Duplicate Post ميزة استنساخ لكتل ​​Gutenberg.

في إعدادات Duplicate Posts ، قم بتمكين Blocks .

لدي الآن خيار استنساخ في مكتبة Blocks. استنساخ التخطيط الذي تريده ثم قم بتحريره. كل تخطيط عالمي ، لذلك سيتعين عليك النسخ والتعديل في كل مرة تريد فيها استخدام التخطيط.

الطريقة الثانية: طريقة بديلة سهلة لإنشاء قالب جوتنبرج

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

بعد ذلك ، قم بالتبديل إلى محرر التعليمات البرمجية. للقيام بذلك ، حدد النقاط الثلاث في الزاوية اليمنى العليا. ضمن Editor ، حدد Code Editor .

قم بتمييز الرمز وانسخه.

الصق الكود في محرر نصوص واحفظه لإعادة استخدامه.

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

لدي الآن منشور جديد يمكنني البدء في إضافة محتوى إليه.

الطريقة الثالثة: إنشاء نوع منشور مخصص

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

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

يتضمن إنشاء النموذج ما يلي:

  • ضبط الحالة الافتراضية ديناميكيًا.
  • تسجيله كتخطيط افتراضي لنوع منشور معين.

إعلان النموذج

سيتم الإعلان عن القالب نفسه كمصفوفة من blockTypes. يتم ذلك في JavaScript أو في PHP. كما يوضح كتيب مطور جوتنبرج ، سيبدو الأمر كما يلي:

const template = [

[ 'block/name', {} ], // [ blockName, attributes ]

];

أو هذا:

'template' => array(

array( 'block/name' ),

),

تسجيل النموذج في أنواع المنشورات المخصصة

يمكن لنوع المنشور المخصص أيضًا تسجيل القالب. يمكن أن يبدو كالتالي:

function myplugin_register_book_post_type() {

$args = array(

'public' => true,

'label'  => 'Books',

'show_in_rest' => true,

'template' => array(

array( 'core/image', array(

'align' => 'left',

) ),

array( 'core/heading', array(

'placeholder' => 'Add Author...',

) ),

array( 'core/paragraph', array(

'placeholder' => 'Add Description...',

) ),

),

);

register_post_type( 'book', $args );

}

add_action( 'init', 'myplugin_register_book_post_type' );

تحدد المصفوفة مصدر الكتلة واسم الكتلة. في هذا المثال ، تستخدم المصفوفة "core / paragraph". هذا يعني أن الكتلة تأتي من نواة WordPress (على عكس المكون الإضافي) واسمها فقرة (تحديد الكتلة التي يجب استخدامها).

تسجيل النموذج في الصفحات والمنشورات

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

إذا قررت إضافتها إلى صفحات أو منشورات ، فيمكنك استخدام هذا الرمز:

function my_add_template_to_posts() {

$post_type_object = get_post_type_object( 'post' );

$post_type_object->template = array(

array( 'core/paragraph', array(

'placeholder' => 'Add Description...',

) ),

);

$post_type_object->template_lock = 'all';

}

add_action( 'init', 'my_add_template_to_posts' );

قوالب التعشيش

يمكنك حتى تداخل القوالب داخل كتل الحاوية (على سبيل المثال ، كتل الأعمدة). يتم ذلك عن طريق تعيين قالب متداخل للكتلة نفسها. على سبيل المثال:

$template = array(

array( 'core/paragraph', array(

'placeholder' => 'Add a root-level paragraph',

) ),

array( 'core/columns', array(), array(

array( 'core/column', array(), array(

array( 'core/image', array() ),

) ),

array( 'core/column', array(), array(

array( 'core/paragraph', array(

'placeholder' => 'Add a inner paragraph'

) ),

) ),

) )

);

قفل القالب

يمكنك قفل القالب باستخدام هذا الرمز:

'template_lock' => 'all', // or 'insert' to allow moving

نموذج نموذج مع نوع منشور مخصص

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

سيتم لصق الكود في ملف function.php. استخدم دائمًا سمة فرعية عند إضافة رمز إلى ملفات PHP. إذا لم تقم بذلك ، فسيتم استبدال الرمز عند تحديث السمة.

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

انتقل إلى Theme Functions (function.php) والصق الكود. لقد قمت بلصق الكود في الأسفل. هذا موقع اختبار ولا أخطط للاحتفاظ بالشفرة ، لذلك لم أستخدم سمة فرعية.

تمت إضافة نوع منشور جديد إلى قائمة لوحة المعلومات يسمى الكتب. يتضمن قائمة ورابط إضافة جديد . لقد قمت بالنقر فوق " إضافة جديد" وتمت إضافة القالب الجديد إلى المحرر حيث يمكنني ببساطة البدء في إضافة المحتوى.

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

خواطر ختامية

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

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

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

نريد أن نسمع منك. هل قمت بإنشاء قوالب جوتنبرج؟ أخبرنا عن تجربتك في التعليقات أدناه.

صورة مميزة عبر Nadia Snopek / shutterstock.com