كتب متقلّبة رائعة
على موقع WordPress الخاص بك

ما تضيفه الإضافة إلى موقعك — وما لا تضيفه

الإضافة شيء تسمح له بدخول تثبيتك الخاص، فمن الإنصاف أن تسأل عمّا يجلبه معه. هذه الإضافة صغيرة عن قصد. في الواجهة تُخرج <div> واحدًا بداخله <iframe> واحد موسومًا بـloading="lazy": فالكتاب المتقلّب الموجود أسفل صفحة طويلة لا يُجلب إلا حين يصل إليه القارئ.

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

التعطيل هادئ بالقدر نفسه: يتوقّف التعرّف على الكود المختصر، فيظهر [toombler id="…"] نصًّا عاديًّا في مقالك إلى أن تحذفه. ولا يبقى شيء في قاعدة البيانات، لأنّه لم يُوضع فيها شيء أصلًا.

النسخة النصّية، ولماذا يستحقّ تشغيلها

الكتاب المتقلّب صورة لصفحاتك. هذا جيّد لقارئ يرى ويملك فأرة، وعديم الفائدة لقارئ الشاشة الذي يجد إطارًا ولا يجد ما يقرأه. بإضافة text="1" إلى الكود المختصر تظهر تحت الكتاب لوحة قابلة للطيّ باسم Read the text version، مملوءة بطبقة النصّ الحقيقية من ملف PDF الخاصّ بك.

الجلب يحدث على خادمك، لا في متصفّح الزائر، وتُحفظ النتيجة في transient خاصّ بووردبريس: اثنتا عشرة ساعة إن وُجد نصّ، وساعة واحدة إن لم يوجد — حتى يلتقطه بعد قليل كتابٌ ما زال نصّه قيد الاستخراج، لا في اليوم التالي. ويُخزَّن 60000 حرف على الأكثر، وهو أكثر من كتيّب عادي، ويكفي لمنع دليل من أربعمئة صفحة من ملء جدول الخيارات عندك.

وهناك سبب ثانٍ، أقلّ نُبلًا لكنّه حقيقي: ذلك النصّ موجود على صفحتك أنت، في HTML الخاصّ بك، تحت نطاقك. فمحرّك البحث الذي يقرأ المقال يرى ما يقوله المستند فعلًا بدل إطار لا يستطيع الدخول إليه. وإن كنت تنشر كتالوجات أو نشرات تريد أن يعثر عليها الناس، فهذه السمة وحدها تفعل أكثر من كلّ ما في هذه الصفحة.

وهي تعمل فقط مع ملفّات PDF التي تحتوي نصًّا حقيقيًّا. أمّا المسح الضوئي بلا تعرّف ضوئي على الحروف فلا طبقة نصّ فيه، وعندئذ لا تظهر اللوحة أصلًا بدل أن تُفتح فارغة.

المتطلّبات والإصدارات والرخصة

تحتاج الإضافة إلى ووردبريس 5.8 أو أحدث وPHP 7.4 أو أحدث، وتُختبر مع الإصدار الحالي من ووردبريس. وهذه عتبات منخفضة عن قصد: الشيفرة لا تستعمل شيئًا غريبًا، فتظلّ تعمل على استضافة متأخّرة ببضع سنوات.

ولأنّه كود مختصر عاديّ، فهو يعمل في محرّر الكتل، وفي المحرّر الكلاسيكي، وفي ودجة نصّية، وفي بُناة الصفحات مثل Elementor وDivi وBeaver Builder وBricks — في كلّ مكان تُنفَّذ فيه الأكواد المختصرة. أمّا كتلة Gutenberg فهي راحة إضافية، لا شرط.

هي برمجية حرّة تحت رخصة GPL، الإصدار 2 أو ما بعده، وهي رخصة ووردبريس نفسها. لك أن تقرأها وتغيّرها وتشغّل نسختك الخاصّة على مواقعك.

كيف تتعامل مع ما تكتبه

كلّ ما ينتهي به المطاف في HTML الصفحة يستحقّ نظرة مرتابة، وهذا ما يحدث لسماتك. مُعرّف الملف يجب أن يطابق [A-Za-z0-9_-] وأن يتراوح طوله بين عشرة وستين حرفًا؛ وما عدا ذلك يُرفض برسالة ظاهرة بدل أن يُلصق في رابط. أمّا العرض والارتفاع فيمرّان عبر absint()، فيعطي الحرفُ الشارد القيمةَ الافتراضية بدل أن يُفسد التخطيط. والرابط المركّب يُهرَّب قبل أن يصل إلى src.

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

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

كتلة أم كود مختصر؟

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

وإن كنت تدير الموقع لشخص آخر، فللكود المختصر ميزة عملية واحدة: ينجو من تغيير القالب، ومن تبديل المحرّر، ومن الانتقال إلى باني صفحات، دون حاجة إلى إعادة بنائه. ولمقارنة الإضافة بالطرق الثلاث الأخرى للتضمين — الإطار المجرّد، ومقتطف جافاسكربت، وoEmbed — انظر دليل تضمين ملف PDF في ووردبريس.