مشاكل التثبيت أو التفعيل

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

#السبب الأول: إصدار PHP قديم جداً

العرض: يرفض WordPress تفعيل الإضافة برسالة مثل "تتطلب الإضافة PHP 7.2 أو أحدث" أو تظهر شاشة بيضاء مباشرة بعد التفعيل.

لماذا: يتطلب TTSWP إصدار PHP 7.2 أو أحدث. لا يزال كثير من مزودي الاستضافة يشغّلون PHP 7.0 أو 7.1 افتراضياً على الحسابات القديمة.

الحل:

1. افتح لوحة تحكم الاستضافة (cPanel أو Plesk أو SiteGround أو Kinsta أو WP Engine وغيرها).
2. ابحث عن محدد إصدار PHP (غالباً ضمن "PHP Selector" أو "Site Tools - PHP Manager").
3. انتقل إلى PHP 8.0 أو أحدث. PHP 8.2 هو الإصدار الموصى به حالياً.
4. حاول تفعيل الإضافة مجدداً.

إذا لم تتمكن من تغيير PHP من لوحة التحكم، تواصل مع مزود الاستضافة. تقريباً كل مزود استضافة يدعم PHP 8.x في عام 2026.

#السبب الثاني: صلاحيات الملفات تحجب الرفع

العرض: "فشل تثبيت الإضافة" أو "تعذّر إنشاء المجلد" عند رفع ملف zip أو التثبيت من الدليل.

لماذا: مجلد wp-content/plugins/ غير قابل للكتابة من قِبَل خادم الويب.

الحل:

1. اتصل بموقعك عبر SFTP أو مدير الملفات الخاص بمزود الاستضافة.
2. اضبط صلاحيات wp-content/plugins/ على 755 (أو 775 على بعض مزودي الاستضافة).
3. اضبط الملفات بداخله على 644.
4. أعد محاولة التثبيت.

في كثير من مزودي الاستضافة المُدارة (Kinsta وWP Engine وPressable) يتولى مدير الملفات هذا تلقائياً. إذا واجهت صعوبة، اطلب من مزود الاستضافة إصلاح صلاحيات مجلد الإضافات.

#السبب الثالث: تعارض الإضافات عند التفعيل

العرض: يُلقي التفعيل خطأً فادحاً يذكر اسم دالة أو اسم فئة أو "Cannot redeclare". قد يتعطل الموقع حتى يتم إلغاء تفعيل الإضافة.

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

الحل:

1. أعد تسمية wp-content/plugins/text-to-speech-tts/ إلى text-to-speech-tts.off عبر SFTP. سيعود الموقع للعمل.
2. ألغِ تفعيل جميع الإضافات الأخرى من الإضافات - الإضافات المثبتة.
3. أعد تسمية مجلد TTSWP إلى اسمه الأصلي.
4. فعّل TTSWP أولاً، ثم أعد تفعيل إضافاتك الأخرى واحدة تلو الأخرى. الإضافة التي تفشل حين يكون TTSWP نشطاً هي مصدر التعارض.
5. تواصل مع الدعم مع اسم الإضافة المتعارضة. سنساعدك في إيجاد حل بديل.

#السبب الرابع: قائمة تحويل النص إلى كلام مفقودة بعد التفعيل

العرض: تظهر الإضافة كـ "نشطة" في الإضافات - الإضافات المثبتة، لكن لا يوجد إدخال تحويل النص إلى كلام في الشريط الجانبي للوحة التحكم.

لماذا: إما أن دور المستخدم يفتقر إلى صلاحية manage_options، أو أن إضافة أمان أزالت القائمة.

الحل:

• سجّل الدخول بوصفك مديراً. لا يرى المحررون والأدوار الأدنى قائمة TTSWP افتراضياً.
• إذا كنت مديراً بالفعل، تحقق من المستخدمون - الملف الشخصي وتأكد من أن دورك هو المدير.
• عطّل إضافات الأمان مثل iThemes Security أو إخفاء قائمة المدير في Wordfence أو Hide My WP واحدة تلو الأخرى، ثم أعد تحميل لوحة التحكم. إذا ظهرت القائمة، اضبط تلك الإضافة للسماح بـ text-to-speech-tts-settings.

#السبب الخامس: عمود TTS مفقود من قائمة المقالات

العرض: الإضافة تعمل، لكن عمود TTS لا يظهر في المقالات - جميع المقالات.

الحل:

1. افتح المقالات - جميع المقالات.
2. انقر على خيارات الشاشة في الزاوية العلوية اليمنى.
3. ضع علامة على مربع TTS.
4. سيظهر العمود.

إذا كان مربع الاختيار مفقوداً كلياً، فإن القالب أو إضافة أخرى تُرشّحه. انتقل إلى قالب افتراضي (Twenty Twenty-Five) للتأكد.

#السبب السادس: إصدار WordPress قديم جداً

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

لماذا: يتطلب TTSWP إصدار WordPress 6.0 أو أحدث.

الحل: حدّث WordPress من لوحة التحكم - التحديثات. إذا تعذّر عليك التحديث، قد يكون مزود الاستضافة يثبّتك على إصدار قديم - اطلب منه التحديث.

#السبب السابع: حجب طلبات HTTPS الصادرة

العرض: الإضافة تُثبَّت وتُفعَّل بشكل سليم، لكن صفحة النظرة العامة تعرض "تعذّر الوصول إلى خوادم TTSWP" أو زر الاتصال لا يستجيب.

لماذا: مزود الاستضافة يحجب طلبات HTTPS الصادرة من PHP إلى النطاقات الخارجية. هذا نادر على الاستضافات الحقيقية لكنه شائع في بيئات التطوير المحلية.

الحل:

• على الجهاز المحلي، تحقق من جدار الحماية أو VPN.
• على استضافة حقيقية، أضف app.ttswp.com و*.ttswp.com إلى قائمة السماح لـ HTTPS الصادر.
• راجع استكشاف أخطاء الاتصال لفحوصات شبكة أعمق.

#لا تزال عالقاً؟

إذا لم تنجح أيٌّ من هذه الحلول، اجمع هذه المعلومات وتواصل مع الدعم:

• إصدار WordPress (من لوحة التحكم - لمحة عامة)
• إصدار PHP (من الأدوات - صحة الموقع - معلومات - الخادم)
• اسم القالب النشط وإصداره
• قائمة بالإضافات الأخرى النشطة
• رسالة الخطأ بالضبط التي تراها، مع لقطة شاشة إن أمكن