توثيق مولّد النص البديل بالذكاء الاصطناعي لووردبريس
دليل مولّد النص البديل بالذكاء الاصطناعي: وصل حساب الذكاء الاصطناعي، وكتابة النص البديل صورة صورة ودفعة واحدة وعند الرفع، ومراجعة الاقتراحات، والإعدادات، والتكلفة.
يشرح الإصدار 1.0.0حُدّث في 24 أكتوبر 2026
ابدأ من هنا
ببساطة: غياب النص البديل يضر إمكانية الوصول وسيو الصور، وكتابته يدويًا لمئات الصور لا يحدث أبدًا. تنظر إضافة مولّد النص البديل بالذكاء الاصطناعي إلى كل صورة مع عنوان الصفحة التي تنتمي إليها وتكتب النص البديل (وإن شئت العنوان والتعليق والوصف) باللغة التي تختارها. نفّذ ذلك صورة صورة، أو تلقائيًا لكل رفع جديد، أو دفعة واحدة بشريط تقدم؛ واحتفظ بالنتائج كاقتراحات للمراجعة إن فضّلت.
نصيحة: تستخدم حسابك الخاص للذكاء الاصطناعي (متوافق مع OpenAI أو أنثروبيك)، فتبقى متحكمًا في النموذج وفي التكلفة.
ماذا تحصل عليه
| الميزة | ما تفعله |
|---|---|
| تقرأ الصورة | تُصغَّر الصورة وتُرسل إلى نموذج رؤية؛ ويساعده اسم الملف وعنوان الصفحة التي تستخدمها على الدقة. |
| ثلاث طرق للعمل | زر على كل صورة، أو تشغيل جماعي على كل صورة بلا نص بديل، أو تلقائيًا في الخلفية عند كل رفع جديد. |
| مراجعة قبل الحفظ | اختياريًا تُحفظ النصوص كاقتراحات: عدّلها واقبلها أو تخطَّها. |
| تقرير التغطية | كم صورة لها نص بديل، وكم مفقودة أو للمراجعة أو فاشلة؛ وعمود في مكتبة الوسائط يعرض كل صورة. |
| لغتك وأسلوبك | اكتب بالعربية أو الفرنسية أو الإنجليزية... وأضف تعليماتك (اسم العلامة، ما يُذكر). |
| العنوان والتعليق والوصف أيضًا | تُملأ حين تكون فارغة فقط (والعنوان حين يكون اسم الملف فقط). |
| تحفظ ما كتبته | تُترك الصور التي لها نص بديل إلا إن طلبت استبداله. |
| ضبط التكلفة | حجم الصورة المرسلة، وحد لطول الإجابة، وحد يومي للطلبات، وجدول استخدام. |
| الخصوصية | تُخفى عناوين البريد وأرقام الهاتف في السياق؛ ويمكن حفظ المفتاح في wp-config.php. |
| العربية | الإضافة مترجمة إلى العربية وتعمل من اليمين إلى اليسار. |
المتطلبات
| البند | التفاصيل |
|---|---|
| ووردبريس | 6.0 أو أحدث |
| PHP | 7.4 أو أحدث |
| أيضًا | مكتبة الصور في PHP: GD أو Imagick (يحتاج ووردبريس إلى إحداهما أصلًا) |
| مزوّد ذكاء اصطناعي | حساب ومفتاح واجهة لدى خدمة متوافقة مع OpenAI (OpenAI أو OpenRouter أو Azure أو خادم محلي مثل Ollama...) أو لدى أنثروبيك. تدفع لمزوّدك مقابل ما تستخدمه؛ ولا رسوم استخدام في الإضافة. |
| الرخصة | GPL-2.0-or-later |
التثبيت
- فُكّ ضغط الحزمة التي نزّلتها. بداخلها
ai-alt-text-generator-for-wordpress.zip(لا تفكّ هذا الملف). - في ووردبريس افتح الإضافات ← أضف جديدًا ← رفع إضافة واختر
ai-alt-text-generator-for-wordpress.zipواضغط التثبيت الآن. - اضغط تفعيل الإضافة.
- افتح الإعدادات ← AI Alt Text Generator ← الاتصال بالذكاء الاصطناعي واختر المزوّد والصق مفتاح الواجهة واضغط اختبر الاتصال.
صِل الذكاء الاصطناعي
ببساطة: تعمل الإضافة بحساب الذكاء الاصطناعي الخاص بك. في الإعدادات ← (هذه الإضافة) ← الاتصال بالذكاء الاصطناعي اختر المزوّد والصق المفتاح واضغط اختبر الاتصال: تخبرك رسالة خضراء بأن النموذج أجاب.
| الحقل | المعنى |
|---|---|
| المزوّد | متوافق مع OpenAI (OpenAI وOpenRouter وAzure وGroq وOllama وLM Studio...) أو أنثروبيك. |
| عنوان الواجهة | اتركه فارغًا للعنوان الرسمي. ولخدمة أخرى اكتب عنوانها، مثلًا http://localhost:11434/v1. |
| مفتاح الواجهة | يُحفظ في قاعدة بياناتك (ولا يظهر ثانية). ويمكنك تعريفه في wp-config.php فيختفي الحقل. |
| النموذج | اسم النموذج لدى مزوّدك. يكفي نموذج صغير رخيص لأغلب المهام. |
| أقصى طول للإجابة | يحدّ رموز الإجابة الواحدة فلا يكلّف الطلب أكثر مما تتوقع. |
| الحد اليومي | عدد الطلبات التي تجريها الإضافة في اليوم (0 = بلا حد). وعند بلوغه تتوقف الإضافة عن الطلب حتى الغد. |
| الخصوصية | يخفي عناوين البريد وأرقام الهاتف والأرقام الشبيهة ببطاقات الدفع قبل إرسال النص. |
نصيحة: يعرض جدول الاستخدام الأخير أسفل التبويب الطلبات والأخطاء والرموز في الأيام الأخيرة.
نصيحة: اختر نموذجًا يقرأ الصور (نموذج رؤية). تقرؤها أغلب النماذج الحديثة من OpenAI وأنثروبيك.
اختر طريقة العمل
ببساطة: الإعدادات ← مولّد النص البديل بالذكاء الاصطناعي. الخيارات بكلمات بسيطة: متى يُكتب (الرفع الجديد)، وماذا يحدث للنتيجة (تُحفظ أو تبقى اقتراحًا)، وماذا يُفعل بالصور التي لها نص، وأي نصوص إضافية تُملأ، واللغة، والأسلوب، وأطول نص بديل، وحجم الصورة المرسلة، وتعليماتك.
| الخيار | المعنى |
|---|---|
| الرفع الجديد | يكتب النص البديل لكل صورة جديدة في الخلفية بعد الرفع بثوانٍ. |
| ماذا يحدث للنتيجة | تُحفظ على الصورة، أو تبقى اقتراحًا حتى تقبلها. |
| الصور التي لها نص بالفعل | تُترك، أو تُستبدل. |
| لغة النصوص | فارغ = لغة الموقع. أو اكتب العربية أو الفرنسية... |
| أطول نص بديل | بالحروف؛ ويُقصَّر النص عند حد كلمة. |
| السياق | يرسل اسم الملف وعنوان الصفحة التي تستخدم الصورة. |
| تعليماتك | مثلًا: اسم المتجر بلوم؛ اذكر اسم المنتج حين تتعرف عليه. |
صورة صورة
ببساطة: افتح صورة في مكتبة الوسائط (نافذة التفاصيل أو شاشة التعديل) واضغط اكتب بالذكاء الاصطناعي بجانب النص البديل. فيمتلئ الحقل فورًا. وحين تضغط الزر يُستبدل النص حتى لو كان للصورة نص.
عدة صور دفعة واحدة
ببساطة: تعرض الوسائط ← النص البديل بالذكاء الاصطناعي تغطية مكتبتك وزر اكتب النص البديل لـ N صورة. تُرسل الصور واحدة واحدة ويمكنك الإيقاف في أي لحظة؛ وما تم يبقى. وللعمل على بضع صور فقط حدّدها في قائمة مكتبة الوسائط واختر الإجراء الجماعي اكتب النص البديل بالذكاء الاصطناعي.
مراجعة قبل الحفظ
ببساطة: إن اخترت احتفظ به كاقتراح حتى أقبله تنتظر النتائج في صفحة الوسائط ← النص البديل بالذكاء الاصطناعي. غيّر النص إن شئت واضغط اقبل، أو تخطَّ لرميه. ولا يُحفظ شيء على الصورة قبل أن تقبل.
أبقِ التكلفة منخفضة
| نصيحة | لماذا |
|---|---|
| استخدم نموذج رؤية صغيرًا رخيصًا | النص البديل مهمة بسيطة. |
| اختر حجم الصورة الصغير | الصورة الأصغر رموز أقل. |
| أبقِ «اتركها كما هي» | لا تُرسل أبدًا الصور التي لها نص. |
| حدّد حدًّا يوميًا | تتوقف الإضافة وحدها عند بلوغه. |
| راجع أولًا على بضع صور | استخدم الإجراء الجماعي على تحديد، وافحص الأسلوب، ثم شغّل الباقي. |
الخصوصية
ببساطة: استخدام نموذج ذكاء اصطناعي يعني إرسال نص إلى مزوّدك. تُرسل الصورة (مُصغَّرة) واسم ملفها وعنوان الصفحة التي تستخدمها. وتُخفى عناوين البريد وأرقام الهاتف والأرقام الشبيهة ببطاقات الدفع أولًا (خيار مفعّل افتراضيًا). ولا يُرسل شيء إلى تقنكس. اذكر مزوّد الذكاء الاصطناعي في سياسة الخصوصية: تضيف الإضافة فقرة مقترحة في الإعدادات ← الخصوصية.
مهم: قد يخطئ الذكاء الاصطناعي. عامل ما يكتبه كمسودة واقرأه قبل نشره.
من يفعل ماذا
| من | يستطيع |
|---|---|
| المسؤولون | تغيير الإعدادات والاتصال بالذكاء الاصطناعي. |
| من يستطيع رفع الملفات (الكتّاب والمحررون...) | كتابة النص البديل للصور التي يستطيعون تعديلها، وتشغيل الأداة الجماعية، وقبول الاقتراحات أو تخطيها. |
| غيرهم | لا شيء: تتحقق إجراءات AJAX من الصلاحية ومن رمز أمان. |
العربية ومن اليمين إلى اليسار
الحدود
| الحد | التفصيل |
|---|---|
| أنواع الصور | JPEG وPNG وGIF (الإطار الأول) وWebP. لا تُوصف ملفات SVG وPDF. |
| الدقة | قد يخطئ النموذج في قراءة صورة. استخدم وضع المراجعة للصفحات المهمة. |
| النص داخل الصور | يقرؤه النموذج حين يستطيع، لكنها ليست أداة OCR. |
| النصوص البديلة الموجودة | لا تُترجم ولا تُعاد كتابتها إلا إن اخترت استبدالها. |
للمطورين
ببساطة: تخطَّ هذا الفصل إن كنت تستخدم الإضافة فقط.
// Describe one image (returns the texts, or a WP_Error)
$result = TQAL_Generator::instance()->generate( $attachment_id );
// Change what is sent to the model, and what is saved
add_filter( 'tqal_system_prompt', function ( $prompt, $id ) {
return $prompt . "\nThe images show furniture: name the material and the colour.";
}, 10, 2 );
add_filter( 'tqal_result', function ( $res, $id ) {
$res['alt'] = mb_substr( $res['alt'], 0, 100 );
return $res;
}, 10, 2 );
// The key can live in wp-config.php
define( 'TQAL_AI_KEY', 'sk-...' );استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| أضف مزوّد الذكاء الاصطناعي ومفتاح الواجهة | افتح تبويب الاتصال بالذكاء الاصطناعي، واختر المزوّد والصق المفتاح واضغط اختبر الاتصال. |
| أجابت الخدمة بالرمز 401 | المفتاح خاطئ أو بلا صلاحية على النموذج. |
| أجابت الخدمة بالرمز 404 أو 400 | اسم النموذج خاطئ، أو النموذج لا يقرأ الصور. |
| لا يحدث شيء عند الرفع | تُعالج الرفوعات الجديدة بواسطة WP-Cron بعد ثوانٍ: زر الموقع، أو شغّل WP-Cron من مهمة cron حقيقية. |
| تعذّر العثور على الصورة | الملف مفقود على الخادم (مثلًا بعد نقل الموقع). |
| النصوص بلغة خاطئة | حدّد لغة النصوص في الإعدادات. |
التحديث والإزالة
ثبّت ملف الإصدار الجديد فوق القديم من الإضافات ← أضف جديدًا ← رفع إضافة (يعرض ووردبريس استبدال النسخة الحالية)، أو استبدل المجلد ai-alt-text-generator-for-wordpress عبر FTP. تبقى إعداداتك والنصوص البديلة المكتوبة. ولإزالة الإضافة عطّلها ثم احذفها: تُحذف إعداداتها معها.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الإضافة أو راسل support@taqnix.com مع إصدار ووردبريس وإصدار الإضافة ولقطة شاشة.