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

في المقال السابق، ناقشنا أساسيات تخطيط الأكواد القصيرة (shortcodes) وكيف يمكنك الاستفادة من مزاياها الرائعة. لقد قررنا تقسيم المقال الذي يتناول إصدار Page Builder Sandwich من ميزة تخطيط الأكواد القصيرة، نظراً لأن الشرح التالي قد يصبح أكثر تقنية.

فيما يلي وصف أكثر تعمقاً للآلية الداخلية لميزة تخطيط الأكواد القصيرة لدينا، وكيف جعلناها تعمل.

عملية مؤتمتة

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

• ضمن أكثر 1,000 إضافة شائعة، وأعلى تقييماً ومُحدَّثة، وبما لا يقل عن 4,000 عملية تثبيت نشطة،
• بما لا يقل عن 4,000 عملية تثبيت نشطة،
• بما لا يقل عن 20 تقييماً، و؛
• بمتوسط تقييم لا يقل عن 3 نجوم

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

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

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

عملية يدوية

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

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

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

وعلى الرغم من أن هذا الأمر مرهق ومضنٍ للغاية، إلا أن هناك بعض الجوانب الإيجابية لوجود عملية مؤتمتة:

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

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

استدعاء واجهة برمجة تطبيقات REST API

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

المستقبل: التعهيد الجماعي

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

قد تتساءل قائلاً: “لماذا قد أساعد في تخطيط الأكواد القصيرة؟ وما الفائدة التي ستعود عليّ؟” حسناً، هناك عدة أسباب تجعل الناس يرغبون في تقديم المساعدة:

1. إذا كنت قد أنشأت إضافة، ولم نكتشفها بعد بسبب المعايير المذكورة أعلاه، (وكانت موجودة في دليل إضافات WordPress)، فيمكنك إضافة التعيينات بنفسك. وستصبح إضافتك مدعومة بالكامل من قِبل PBS!
2. نظراً لأننا سنتعامل فقط مع الإضافات الموجودة في دليل إضافات WordPress في العملية المؤتمتة، فلن يتم تضمين مؤلفي الإضافات والقوالب المدفوعة. لذا إذا كنت تمتلك واحدة منها، فيمكنك أيضاً إضافة تعيينات الأكواد القصيرة الخاصة بها.
3. وبالنسبة لمن لا ينشئون إضافات، يمكننا مكافأة أولئك الذين يقدمون المساعدة. ولجعل تخطيط الأكواد القصيرة مسعى جذاباً، يمكننا مكافأة المساعدين بترخيص شخصي، أو ترقية إلى ترخيص مدفوع من PBS!

اشترك في نشرتنا الإخبارية

ستتوفر ميزة تخطيط الأكواد القصيرة لعملائنا مبدئياً في 12 أغسطس  15 أغسطس  16 أغسطس 2016. لن يتم تخطيط جميع الأكواد القصيرة بحلول هذا الوقت (تقديرنا هو ربما 100 إضافة)، ولكن عملية التخطيط ستستمر بشكل متواصل وسيحصل العملاء عليها بمجرد إطلاق إضافات جديدة.

اشترك في نشرتنا الإخبارية للحصول على آخر الأخبار حول تخطيط الأكواد القصيرة، وموعد إطلاقها، وموعد إتاحتها للجمهور!