EN
01

ما الذي تقدمه

تحصي Read Time Machine كلمات المقال، وتقسمها على سرعة القراءة (200 كلمة في الدقيقة ما لم تغيّرها)، وتقرّب الناتج إلى أعلى عدد صحيح من الدقائق، بحد أدنى دقيقة واحدة. ثم تضيف عنوانًا قصيرًا مثل 3 min read قبل محتوى المقال مباشرة أو بعده.

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

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

  • المقالات · الصفحات · أنواع المحتوى المخصصة
  • قبل المحتوى أو بعده
  • 9 أنماط جاهزة
  • كود مختصر
  • دون طلبات خارجية
02

التثبيت

  1. حمّل ملف ZIP.
  2. من لوحة ووردبريس افتح Plugins ← Add Plugin (اسمها Add New Plugin أو Add New في الإصدارات الأقدم)، واضغط Upload Plugin، واختر الملف، ثم Install Now ثم Activate Plugin.
  3. افتح أي مقال أو صفحة مفردة، وستجد العنوان قبل المحتوى بالإعدادات الافتراضية دون أي ضبط مسبق.
  4. لتغيير الإعدادات اضغط Settings أسفل اسم الإضافة في شاشة الإضافات، أو افتح Read Time Machine في أسفل قائمة لوحة التحكم.
03

طريقة الاستخدام

للإضافة عنصر مستقل في القائمة باسم Read Time Machine بأيقونة ساعة في أسفل قائمة لوحة التحكم (admin.php?page=read-time-machine). وهو ليس ضمن Settings، ولا يفتحه إلا المديرون (المستخدمون الذين يملكون صلاحية manage_options). وتضم الصفحة تبويبين:

  • Settings: سرعة القراءة، والموضع، ونص العنوان، وعدد الكلمات، والنمط الجاهز، وخيارات الجوال، والحركة، وأنواع المحتوى، والاستثناءات.
  • Styles: أداة اختيارية لبناء النمط (Style Builder) فيها أدوات للألوان والهوامش الداخلية والخط والحدود، مع معاينة مباشرة ومربع للقراءة فقط يعرض كود CSS الناتج عن الإعدادات الحالية.

خطوة بخطوة

  1. افتح Read Time Machine، وسيظهر تبويب Settings أولًا.
  2. اضبط Words Per Minute وDisplay Position (قبل المحتوى أو بعده).
  3. عدّل Label Template، مثل Reading time: {minutes} min. وفعّل Show Word Count ليظهر عنوان مثل «3 min read • 512 words».
  4. اختر Style Preset وEnabled Post Types (المقالات والصفحات مفعّلة افتراضيًا) وأي استثناءات، ثم اضغط Save Changes.
  5. لاختيار ألوانك ومسافاتك الخاصة افتح تبويب Styles، وفعّل Enable Style Builder، واضبط الأدوات وأنت تتابع المعاينة المباشرة، ثم اضغط Save Changes في التبويب نفسه. فكل تبويب يحفظ حقوله وحدها، لذا احفظ قبل الانتقال إلى التبويب الآخر.

إيقافها في مقال واحد

في الشريط الجانبي لمحرر المقال صندوق باسم Read Time Machine فيه خانة Disable reading time for this content. فعّلها وحدّث المقال، فيختفي العنوان التلقائي والكود المختصر معًا في ذلك المقال. والصندوق مجرد مفتاح تشغيل وإيقاف، ولا يتيح كتابة مدة القراءة يدويًا.

الكود المختصر

[read_time_machine] يطبع العنوان نفسه للمقال الحالي في الموضع الذي تضعه فيه، ولا يأخذ أي خصائص. وليس للإضافة مكوّن (block) ولا ودجت، لذا ضع الكود المختصر في محرر المكوّنات داخل مكوّن Shortcode.

يظل العنوان التلقائي يُضاف في العرض المفرد لأنواع المحتوى المفعّلة، فإن وضعت الكود المختصر داخل مقال منها ظهر عنوانان. ولا يوجد في الإعدادات مفتاح لإيقاف العنوان التلقائي، لكن المطور يستطيع إزالته بالفلتر rtm_output_html (راجع للمطورين). وخارج العرض المفرد لأنواع المحتوى المفعّلة لا يُحمَّل ملف التنسيق الخاص بالإضافة، فيظهر عنوان الكود المختصر هناك دون تنسيق النمط الجاهز.

04

الإعدادات

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

تبويب Settingsالافتراضي · المسموح · الأثر

Words Per Minute
‏200. أعداد صحيحة من 50 إلى 1,000، وترك الخانة فارغة يحفظ 50 لا القيمة الافتراضية. مدة القراءة هي عدد الكلمات مقسومًا على هذا الرقم ومقرّبًا إلى أعلى، بحد أدنى دقيقة واحدة. والأعداد المحفوظة مرتبطة بالسرعة التي حُسبت بها، فإذا غيّرتها أُعيد حساب المقالات.
Display Position
Before Content، والخيار الآخر After Content.
Label Template
{minutes} min read. نص عادي: تُزال وسوم HTML عند الحفظ، وترك الخانة فارغة يعيد القيمة الافتراضية. ويُستبدل {minutes} و{words} بالأرقام.
Show Word Count
معطّل. عند تفعيله يُضاف بعد العنوان «• 512 words» بعدد كلمات المقال نفسه.
Style Preset
Minimal. الأنماط الأساسية: Minimal وBadge وPill وInline، والإضافية: Marker وUnderline وOutline وLeft Bar وGradient. ولا يُستخدم ما دامت أداة Style Builder مفعّلة.
Mobile Display
الخياران Hide on mobile وCompact style on mobile معطّلان. ويعمل كلاهما على الشاشات بعرض 600 بكسل فأقل، عبر الصنفين rtm-hide-mobile وrtm-compact-mobile على العنوان. Hide on mobile يخفي العنوان هناك. وCompact style on mobile يجعل نصه 12 بكسل ويقلّل الهوامش الداخلية لأنماط Minimal وBadge وPill وUnderline وLeft Bar؛ ومع تفعيل Style Builder يجعل نص الأداة 12 بكسل وهوامشها الداخلية 2 بكسل من أعلى وأسفل و6 بكسل من الجانبين. وبمعزل عن ذلك، تحصل أنماط Badge وPill وMinimal دائمًا على هوامش داخلية أقل قليلًا على الشاشات بعرض 600 بكسل فأقل.
Animated Numbers
معطّل. عند تفعيله تتصاعد الأرقام من الصفر، بمدة 900 ملّي ثانية وتأخير 0 (كل منهما من 0 إلى 20,000 ملّي ثانية). والخيار Start animation when the label becomes visible مفعّل افتراضيًا، فيبدأ العد حين يظهر 30% من العنوان على الشاشة، وإن عطّلته بدأ العد مع تحميل الصفحة.
Entrance Animation
معطّل، بمدة 350 ملّي ثانية وتأخير 0 (كل منهما من 0 إلى 20,000 ملّي ثانية). الخيار «Fade/slide in the label» يُظهر العنوان تدريجيًا مع انزلاق خفيف إلى أعلى (ونمط Inline يظهر تدريجيًا فقط) خلال المدة المحددة وبعد التأخير المحدد. العنوان الظاهر على الشاشة عند تحميل الصفحة يتحرك فورًا، أما العنوان الواقع أسفل الصفحة فينتظر حتى يصل إليه التمرير، ما لم يكن خيار Start animation when the label becomes visible معطّلًا، فيتحرك عندئذ مع تحميل الصفحة. ودون JavaScript يظل العنوان يظهر تدريجيًا مع تحميل الصفحة، ومن فعّل خيار تقليل الحركة في إعدادات نظامه يراه مباشرة دون أي تأثير. ويحمل العنوان data-rtm-entrance="1" ومتغيري CSS ‏--rtm-entrance-dur و--rtm-entrance-delay، ويضيف السكربت الصنف rtm-wait إلى العنوان الذي ينتظر خارج الشاشة، والصنف rtm-in حين يظهر العنوان (أو مع تحميل الصفحة إن كان ذلك الخيار معطّلًا). وتفعيله يحمّل سكربت الحركة أيضًا.
Enabled Post Types
المقالات والصفحات. يقبل أي نوع محتوى عام عدا الوسائط، ومنها أنواع المحتوى المخصصة. ويحدد المواضع التي يعمل فيها العنوان وصندوق المحرر والكود المختصر وملف التنسيق. وإن ألغيت تحديد كل الخانات عاد الإعداد إلى المقالات والصفحات.
Exclude Post IDs
فارغ. معرّفات مقالات مثل 12, 45, 78، وأي محرف غير رقمي يفصل بينها.
Exclude Categories
لا شيء. حدّد التصنيفات لتخطّي المقالات المدرجة فيها مباشرة، ولا تُضمَّن التصنيفات الفرعية تلقائيًا.
Exclude Tags
فارغ. أسماء لطيفة (slugs) أو معرّفات وسوم مفصولة بفواصل، مثل news, updates, 23. والمدخل المكوّن من أرقام فقط يُقرأ معرّفًا للوسم، وأي مدخل آخر يُحوَّل أولًا إلى صيغة الاسم اللطيف.

تبويب Stylesالافتراضي · المسموح · الأثر

Enable Style Builder
معطّل. عند تفعيله يُلَف نص العنوان بوسم span يحمل الصنف المستهدف، ويتوقف تطبيق النمط الجاهز من تبويب Settings، ويُضاف كود CSS المبني من الأدوات أدناه مضمّنًا في الصفحات التي تحمّل ملف تنسيق الإضافة.
Target CSS class
rtm-reading-time. حروف وأرقام وشرطات وشرطات سفلية، وتُحذف أي محارف أخرى. وإن أفرغته فقدت الأداة أثرها وعاد النمط الجاهز من تبويب Settings.
Style Preset
Pill. الأنماط التسعة نفسها، وتُستخدم هنا لاختيار الأساس الذي يُبنى عليه كود CSS.
Colors
Color 1 #FFF1BD وColor 2 #FFCA08 وText #111111. ألوان بصيغة hex فقط، والقيمة غير الصالحة تحفظ الافتراضي. Color 1 هو لون الخلفية أو الحد أو الخط السفلي أو الشريط بحسب النمط، وColor 2 هو خلفية Badge ولون التمييز والأرقام في Minimal ونهاية التدرج في Gradient.
Padding
أفقي 10 بكسل (من 0 إلى 80)، ورأسي 4 بكسل (من 0 إلى 40). لكل منهما شريط تمرير وخانة رقم، والرقم الخارج عن النطاق يُصحَّح عند مغادرة الخانة.
Typography
حجم الخط 14 بكسل (من 10 إلى 28)، وسُمكه 600 (من 100 إلى 900 بخطوات قدرها 50).
Radius
‏10 بكسل (من 0 إلى 60)، وتستخدمه أنماط Minimal وBadge وPill وOutline وGradient.
Border width
‏2 بكسل (من 0 إلى 10): خط التمييز في Minimal وحد Outline.
Underline thickness
‏4 بكسل (من 1 إلى 20): لنمطي Inline وUnderline.
Bar thickness
‏6 بكسل (من 1 إلى 20): لنمط Left Bar.
Display
inline، والخيار الآخر inline-block. ونمط Minimal يستخدم inline-flex دائمًا.
05

آلية العمل

  • موضع العنوان. يُضاف عبر الفلتر the_content في ووردبريس بأولوية متأخرة (999)، وفي العرض المفرد لأنواع المحتوى المفعّلة فقط. ولا يحصل عليه إلا المقال الرئيسي في الصفحة، مرة واحدة في كل تحميل. ولا يظهر في صفحة المدونة الرئيسية ولا الأرشيفات ولا نتائج البحث ولا الخلاصات (feeds).
  • ما الذي يُحسب كلمة. يُعرض المقال أولًا بمكوّناته وأكواده المختصرة، ومعه مخرجات Elementor إن كان مفعّلًا وكان للمقال بيانات Elementor. ثم يُزال كود HTML بما فيه السكربتات والتنسيقات، وتُحصى سلاسل الحروف والأرقام بأي أبجدية. والكلمة التي في داخلها فاصلة عليا أو شرطة، مثل don't أو well-known، تُحسب مرة واحدة. ولا تضيف الصور والفيديو أي وقت.
  • الحساب. الدقائق = الكلمات ÷ الكلمات في الدقيقة، مقرّبة إلى أعلى ولا تقل عن 1، ولا تُعرض الثواني. وإن لم توجد كلمات لا يظهر أي عنوان.
  • الأعداد المحفوظة. عند حفظ المقال تُخزَّن دقائقه وعدد كلماته وسرعة القراءة المستخدمة في بيانات المقال الوصفية (post meta)، وتعيد مرات العرض استخدامها ما دامت السرعة لم تتغير. والمقال الذي ليس له عدد محفوظ، كالمنشور قبل تفعيل الإضافة، يُحسب في كل عرض حتى يُحفظ مرة أخرى أو يفتحه مستخدم يملك صلاحية تحريره. ومشاهدات الزوار لا تكتب في قاعدة البيانات أبدًا.
  • ملفات الواجهة. لا يُحمَّل ملف التنسيق (نحو 6 كيلوبايت) إلا في العرض المفرد لأنواع المحتوى المفعّلة. ويُحمَّل سكربت الحركة (أقل من 3 كيلوبايت، دون jQuery) في تذييل الصفحة، وفقط عند تفعيل حركة الأرقام أو حركة الظهور. ويُضاف كود CSS الخاص بأداة Style Builder مضمّنًا لا ملفًا إضافيًا.
  • الحركة. يتصاعد كل رقم من الصفر إلى قيمته بإيقاع ثابت خلال المدة المحددة، بعد التأخير المحدد.
  • الوضع الداكن. لا تتغير ألوان العنوان مع نظام الألوان في جهاز الزائر. أنماط Minimal وInline وMarker وUnderline وOutline وLeft Bar تستخدم لون نص القالب، فتتبع القالب الفاتح أو الداكن. ورقم Minimal يمزج لون التمييز بلون النص ذاك، وتظليل Marker شفاف، فيبقى فاتحًا على القالب الفاتح وداكنًا على الداكن. ويحتفظ Pill بنص داكن على خلفيته الصفراء، ويعرض Badge نصًا أبيض على لون التمييز (الأزرق الداكن افتراضيًا)، ويعرض Gradient نصًا أبيض على تدرج من ذلك اللون إلى مزيج داكن من لوني التمييز. ومع تفعيل Style Builder تُطبَّق ألوانه هو.
06

كيف تحافظ على الأمان

  • للمديرين فقط. تتطلب صفحة الإعدادات صلاحية manage_options، ويُحفظ التبويبان عبر Settings API في ووردبريس (options.php)، التي تتحقق من تلك الصلاحية ومن رمز nonce.
  • تحقق عند حفظ المقال. لا تُحفظ خانة المحرر إلا مع رمز nonce صالح، ولا تُحفظ أبدًا في الحفظ التلقائي أو المراجعات، ولا يحفظها إلا من يملك صلاحية تحرير ذلك المقال.
  • مدخلات منقّاة. الأرقام أعداد صحيحة تبقى ضمن نطاقاتها، والخيارات تُطابق بقوائم ثابتة، والنصوص تُنقّى، وأنواع المحتوى يجب أن تكون عامة، والألوان بصيغة hex، واسم الصنف لا يقبل إلا محارف آمنة.
  • مخرجات مُهرَّبة. تُهرَّب القيم والخصائص (escaping)، ويمر العنوان عبر wp_kses الذي يحذف كل وسم عدا span وكل خاصية عدا class وdata-rtm-number.
  • CSS مخصص وآمن. لا تكتب أداة Style Builder كود CSS إلا من قيم منقّاة: ألوان hex وأعداد صحيحة وخيارات ثابتة.
  • لا كتابة من الزوار. لا تُخزَّن الأعداد إلا عند حفظ المقال أو عرضه من مستخدم يملك صلاحية تحريره.
  • لا شيء يغادر موقعك. لا طلبات خارجية، ولا تتبع، ولا مكتبات من أطراف ثالثة، ولا استعلامات SQL مباشرة. ويستخدم الحذف دوال ووردبريس نفسها.
  • لا وصول مباشر. كل ملف PHP يحتوي على كود يتوقف ما لم يحمّله ووردبريس.
07

للمطورين

الفلترالمعاملات · الاستخدام

rtm_enabled_post_types
$types. يغيّر أنواع المحتوى التي تحصل على العنوان وصندوق المحرر وملفات الواجهة. وإعادة قائمة فارغة، أو أي قيمة ليست مصفوفة، توقف العنوان في كل مكان، لكن إن كانت أداة Style Builder مفعّلة فسيُحمَّل كودها وملف تنسيق الإضافة عندئذ في كل صفحات الواجهة.
rtm_wpm
$wpm, $post_id. يغيّر سرعة القراءة، لكل مقال مثلًا. ويعمل بعد تطبيق حد 50 إلى 1,000، فلا تخضع القيمة المعادة لذلك النطاق.
rtm_word_count
$count, $text, $post_id. يغيّر عدد الكلمات، و$text هو النص المنقّى الذي جرى إحصاؤه. والنتائج السالبة تصبح 0.
rtm_read_time_minutes
$minutes, $word_count, $wpm, $post_id. يستبدل عدد الدقائق، والنتائج الأقل من 1 تصبح 1.
rtm_output_html
$html, $minutes, $word_count, $post_id, $context. يغيّر الكود النهائي أو يحذفه، وقيمة $context إما content أو shortcode. وما تعيده يُطبع كما هو، فهرّب قيمك بنفسك.

للإبقاء على عنوان الكود المختصر وحده وإسقاط العنوان التلقائي:

add_filter( 'rtm_output_html', function ( $html, $minutes, $words, $post_id, $context ) { return 'content' === $context ? '' : $html; }, 10, 5 );

  • الكود الناتج بالإعدادات الافتراضية: <p class="rtm-read-time rtm-style--minimal" data-rtm-minutes="3" data-rtm-words="512" data-rtm-animate="0" …><span class="rtm-num" data-rtm-number="3">3</span> min read</p>.
  • تأتي معظم ألوان الأنماط من متغيرات CSS على .rtm-read-time: ‏--rtm-accent و--rtm-accent-2 و--rtm-text (نص Pill) و--rtm-muted (نص Minimal وInline، وهو لون نص القالب ما لم تحدده) و--rtm-soft و--rtm-border. أعد تعريفها في قالبك لتطابق هويتك. وبعض الألوان ثابتة، مثل النص الأبيض في Badge وGradient وبداية التدرج الفاتحة في Pill.
  • معرّفات ملفات الواجهة: ملف التنسيق rtm-frontend والسكربت rtm-animate.
  • لا تطلق الإضافة أي إجراءات (actions) خاصة بها. وهي ترتبط بـplugins_loaded (للبدء)، وthe_content وelementor/frontend/the_content (كلاهما بأولوية 999)، وsave_post (‏10 و20)، وwp_enqueue_scripts (‏10، و99 لكود Style Builder)، وadd_meta_boxes وadmin_init وadmin_menu وadmin_enqueue_scripts، وcustom_menu_order وmenu_order (لنقل قائمتها إلى الأسفل)، وفي شاشة الإضافات plugin_action_links_read-time-machine/read-time-machine.php وplugin_row_meta.
  • التخزين: الخياران rtm_settings وrtm_style_options (لا يُخزَّن شيء لأي تبويب حتى يُحفظ، وتسري القيم الافتراضية حتى ذلك الحين)، ومفاتيح بيانات المقال _rtm_disable و_rtm_read_time_minutes و_rtm_word_count و_rtm_wpm_used. دون جداول مخصصة أو transients أو مهام cron أو ملفات.
  • إلغاء التفعيل يُبقي كل شيء، والحذف يزيل الخيارين ومفاتيح البيانات الأربعة. وفي الشبكات المتعددة (multisite)، حيث تُحذف الإضافات من لوحة إدارة الشبكة، لا يُنظَّف إلا الموقع الرئيسي، وتحتفظ بقية المواقع بخياراتها وبيانات مقالاتها.
08

أسئلة شائعة

لماذا تظهر مدة القراءة في الصفحة الرئيسية أو صفحة التواصل؟

لأن الصفحات مفعّلة افتراضيًا، والصفحة الرئيسية الثابتة صفحة أيضًا. ألغِ تحديد Page في Enabled Post Types، أو أضف تلك الصفحات إلى Exclude Post IDs، أو فعّل Disable reading time for this content في محرر كل صفحة.

لماذا لا يظهر العنوان في أحد المقالات؟

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

هل تعمل مع Elementor؟

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

هل تحسب كلمات العربية واللغات الأخرى؟

في الغالب نعم. فهي تحصي سلاسل الحروف بأي أبجدية، لذا تُحسب اللغات التي تفصل الكلمات بمسافات، والعربية منها، حسابًا جيدًا، مع استثناءين: اللغات التي تُكتب دون مسافات، مثل الصينية واليابانية، يُحسب عدد أقل من كلماتها. وعلامات التشكيل المركّبة تقسم الكلمات، فيُحسب عدد أكبر من كلمات الهندية والعربية المشكولة (ولو بشدّة واحدة). أما التايلاندية التي تجمع الحالتين فنتائجها غير موثوقة.

هل تبطئ موقعي؟

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

تحميل Read Time Machine الإصدار 1.2.5