توثيق مترجم المقالات والمنتجات بالذكاء الاصطناعي لووردبريس وووكومرس
دليل مترجم المقالات والمنتجات بالذكاء الاصطناعي: وصل حساب الذكاء الاصطناعي، واللغات والمسرد، وترجمة عنصر أو عدة عناصر، والمراجعة جنبًا إلى جنب، والترجمات القديمة، ومنتجات ووكومرس، والمبدّل وروابط hreflang، وWPML وPolylang، والتكلفة.
يشرح الإصدار 1.0.0حُدّث في 29 أكتوبر 2026
ابدأ من هنا
ماذا تحصل عليه
| الميزة | ما تفعله |
|---|---|
| مسودات مرتبطة | كل ترجمة مسودة جديدة مرتبطة بالأصل بمعرّف مجموعة ولغة. ولا تنشر الإضافة أي شيء أبدًا. |
| ما يُترجم | العنوان والمحتوى والمقتطف (الوصف المختصر للمنتج) وعنوان السيو ووصفه في Yoast SEO وRank Math وSEOPress ومولّد ميتا السيو، والخصائص المخصصة للمنتج، و(بمفاتيح) سمات alt وtitle وaria-label وplaceholder. |
| آمنة للكتل | يُرسل النص فقط؛ وتبقى تعليقات الكتل وJSON والروابط والأكواد المختصرة والشيفرة كما هي. وتحفظ العناصر النائبة التنسيق داخل السطر. |
| المسرد وقائمة «لا تترجم» | تُطبَّق ترجماتك للمصطلحات دائمًا؛ ولا تُترجم أبدًا أسماء العلامات ورموز المنتجات والروابط وعناوين البريد. |
| التحقق | تُفحص كل إجابة: العناصر النائبة نفسها مرة واحدة لكل منها، بلا ترميز أو روابط أو أكواد مختصرة جديدة، وبنية الكتل والروابط والوسوم نفسها كالأصل. وإلا تُرفض. |
| اكتشاف الترجمات القديمة | حين يتغير الأصل تُعلَّم ترجماته قديمة. ونقرة واحدة تترجم مجددًا؛ ولا تتغير الترجمة المنشورة، بل ينتظر النص الجديد مراجعتك. |
| الترجمة الجماعية | اختر العناصر واللغات، وشاهد تقدير التكلفة، وابدأ: تشغيل في الخلفية بشريط تقدم وإيقاف مؤقت واستئناف وإلغاء. |
| المراجعة جنبًا إلى جنب | الأصل والترجمة متجاوران، كل الحقول، ومن اليمين إلى اليسار حين يلزم. |
| في الموقع | مبدّل اللغات (كتلة وكود مختصر وودجت)، وروابط hreflang البديلة مع x-default، وسمة lang للصفحات المترجمة. |
| لكل لغة | الاسم والمحلية والاتجاه والرسمية والنبرة وسياسة الاسم اللطيف (حروف لاتينية أو العنوان المترجم أو الاسم الأصلي + الرمز). |
| المنتجات | نسخة ووكومرس من المنتج (السعر والصور والتنوعات)، مع ترجمة النصوص والخصائص المخصصة، وربط التصنيفات بترجماتها. |
| العربية | العربية لغة مصدر ولغة هدف، وشاشات من اليمين إلى اليسار، والإضافة مترجمة إلى العربية. |
المتطلبات
| البند | التفاصيل |
|---|---|
| ووردبريس | 6.0 أو أحدث |
| PHP | 7.4 أو أحدث |
| أيضًا | اختياري: ووكومرس 8.0+ للمنتجات؛ وYoast SEO أو Rank Math أو SEOPress أو مولّد ميتا السيو لحقول السيو |
| مزوّد ذكاء اصطناعي | حساب ومفتاح واجهة لدى خدمة متوافقة مع OpenAI (OpenAI أو OpenRouter أو Azure أو خادم محلي مثل Ollama...) أو لدى أنثروبيك. تدفع لمزوّدك مقابل ما تستخدمه؛ ولا رسوم استخدام في الإضافة. |
| الرخصة | GPL-2.0-or-later |
التثبيت
- فُكّ ضغط الحزمة التي نزّلتها. بداخلها
ai-post-and-product-translator.zip(لا تفكّ هذا الملف). - في ووردبريس افتح الإضافات ← أضف جديدًا ← رفع إضافة واختر
ai-post-and-product-translator.zipواضغط التثبيت الآن. - اضغط تفعيل الإضافة.
- افتح الإعدادات ← المترجم بالذكاء الاصطناعي ← الاتصال بالذكاء الاصطناعي واختر المزوّد والصق مفتاح الواجهة واضغط اختبر الاتصال.
صِل الذكاء الاصطناعي
| الحقل | المعنى |
|---|---|
| المزوّد | متوافق مع OpenAI (OpenAI وOpenRouter وAzure وGroq وOllama وLM Studio...) أو أنثروبيك. |
| عنوان الواجهة | اتركه فارغًا للعنوان الرسمي. ولخدمة أخرى اكتب عنوانها، مثلًا http://localhost:11434/v1. |
| مفتاح الواجهة | يُحفظ في قاعدة بياناتك (ولا يظهر ثانية). ويمكنك تعريفه في wp-config.php فيختفي الحقل. |
| النموذج | اسم النموذج لدى مزوّدك. يكفي نموذج صغير رخيص لأغلب المهام. |
| أقصى طول للإجابة | يحدّ رموز الإجابة الواحدة فلا يكلّف الطلب أكثر مما تتوقع. |
| الحد اليومي | عدد الطلبات التي تجريها الإضافة في اليوم (0 = بلا حد). وعند بلوغه تتوقف الإضافة عن الطلب حتى الغد. |
| الخصوصية | يخفي عناوين البريد وأرقام الهاتف والأرقام الشبيهة ببطاقات الدفع قبل إرسال النص. |
اللغات والمسرد
| الخيار | المعنى |
|---|---|
| الرسمية | افتراضي أو رسمية (صيغ مخاطبة مهذبة) أو غير رسمية. |
| النبرة | كلمات قليلة تُضاف إلى التعليمات، مثل «دافئة وبسيطة». |
| الاسم اللطيف للترجمات الجديدة | حروف لاتينية للعنوان المترجم (مناسب للعربية)، أو العنوان المترجم، أو الاسم الأصلي مع رمز اللغة (oak-table-fr). |
| المسرد | قاعدة في كل سطر: free delivery = توصيل مجاني | ar. ومن دون «| رمز» تسري القاعدة على كل اللغات. ويُحفظ الحرف الكبير في بداية الجملة. |
| لا تترجم | كلمة أو عبارة في كل سطر، حساسة لحالة الأحرف: أسماء العلامة والمنتجات. |
ترجم عنصرًا واحدًا
المراجعة جنبًا إلى جنب
حين يتغير الأصل
الترجمة الجماعية
ما يُحمى ويُفحص
| يبقى كما هو | كيف |
|---|---|
| ترميز الكتل | تعليقات الكتل مع إعدادات JSON، وكل وسم على مستوى الكتلة بسماته (class وstyle وid وdata-* وdir)، فيفتح محرر المكوّنات الترجمة دون رسائل «كتلة غير صالحة». |
| الروابط والوسائط | يبقى كل href وsrc وsrcset كما هو حرفًا بحرف؛ وتُترجم نصوص الروابط لا عناوينها. |
| التنسيق داخل السطر | يصبح الخط العريض والمائل والروابط والوسوم span عناصر نائبة مزدوجة مثل <g1>…</g1>، فيحرّكها الذكاء الاصطناعي مع الكلمات لكنه لا يحذفها ولا يخترعها. |
| الأكواد المختصرة والشيفرة والسكربتات | لا تُرسل أبدًا الأكواد المختصرة و<code> و<pre> والسكربتات والأنماط وSVG والتضمينات. |
| كلماتك | قائمة «لا تترجم» (أسماء العلامة والمنتجات)، ورمز المنتج SKU، ورموز المنتجات مثل AB-1200 (مفتاح)، وعناوين البريد، وأرقام الهاتف، ومتغيرات السيو مثل %%sitename%%. |
| مسردك | يُستبدل مصطلح المسرد بترجمتك له دائمًا. |
| ما يُترجم | النص بين الوسوم، ونصوص العناوين، وتسميات الأزرار والروابط، وعناصر القوائم، و(بمفاتيح) سمات alt وtitle وaria-label وplaceholder. |
منتجات ووكومرس
| الجزء | السلوك |
|---|---|
| الخصائص المخصصة | تُترجم الأسماء والقيم (مفتاح). وتبقى الخصائص المستخدمة للتنوعات كما هي لتستمر التنوعات في العمل. |
| الخصائص العامة والتصنيفات | يُستخدم المصطلح المترجم حين تربط واحدًا (حرّر التصنيف أو الوسم أو مصطلح الخاصية: حقل لكل لغة)؛ وإلا المصطلح الأصلي أو لا شيء (إعداد). |
| الصور | ملفات الوسائط نفسها؛ والنص البديل لعنصر مكتبة الوسائط مشترك بين كل اللغات ولا يتغير. |
| الأسعار والمخزون | تُنسخ مرة واحدة؛ ولا تُزامَن التغييرات اللاحقة. |
في الموقع: المبدّل وhreflang
[tqtr_switcher] (style="inline" أو "list"، وcurrent="0" لإخفاء اللغة الحالية) أو ودجت ترجمات هذه الصفحة. ولا يربط إلا الترجمات المنشورة للصفحة المعروضة. وفي رأس الصفحة تطبع الإضافة روابط hreflang البديلة للأعضاء المنشورين في المجموعة، مع x-default إلى الأصل (والاثنان بمفتاحين في الإعدادات)، وتضبط سمة lang للصفحة المترجمة.مع WPML أو Polylang
الإعدادات
| الخيار | المعنى |
|---|---|
| لغة المحتوى الأصلي | لغة مقالاتك (ويمكن أن تكون لمقالة لغتها الخاصة). |
| أنواع المحتوى | المقالات والصفحات والمنتجات والأنواع العامة الأخرى. |
| ما يُترجم | حقول السيو والنصوص البديلة للصور والسمات الأخرى وخصائص المنتج وحماية رموز المنتجات. |
| التصنيفات والوسوم | استخدم المصطلحات المترجمة المربوطة وإلا الأصلية؛ أو المترجمة فقط. |
| في الموقع | الروابط البديلة وx-default ولغة الصفحة. |
| حين يكون WPML أو Polylang مفعّلًا | النسخ والتصدير فقط، أو وضع الواجهة البرمجية. |
| النص في كل طلب | حروف كل طلب؛ وتُرسل المقالات الطويلة على عدة طلبات. |
| أطول عنصر | تُرفض العناصر ذات النص الأطول. |
| أكبر ترجمة جماعية | عدد الترجمات التي ينشئها تشغيل جماعي واحد. |
| من يبدأ الترجمة الجماعية | المحررون والمسؤولون، أو المسؤولون فقط. |
| أسعار الرموز | للتقدير فقط. |
أبقِ التكلفة منخفضة
| نصيحة | لماذا |
|---|---|
| جرّب عنصرًا واحدًا أولًا | افحص الأسلوب والمسرد قبل الترجمة الجماعية. |
| استخدم نموذجًا متوسطًا | النماذج الصغيرة جدًا تُفسد العناصر النائبة أكثر؛ والإجابة المرفوضة تكلّف طلبًا. |
| أبقِ الحد اليومي | يتوقف التشغيل وحده ويستمر حين تستأنفه. |
| ترجم القديمة فقط | تُتخطى العناصر التي لها ترجمة محدّثة. |
الخصوصية
من يفعل ماذا
| من | يستطيع |
|---|---|
| المسؤولون | الإعدادات والاتصال بالذكاء الاصطناعي واللغات والمسرد. |
| المحررون والمسؤولون (إعداد) | الترجمة الجماعية. |
| مستخدم يستطيع تحرير الأصل وإنشاء عناصر من نوعه | ترجمته وإعادة ترجمته ومراجعته. |
| مستخدم يستطيع نشر الترجمة | تطبيق تحديث منتظر على ترجمة منشورة. |
| غيرهم | لا شيء: يتحقق كل إجراء من رمز أمان ومن هذه الصلاحيات. |
العربية ومن اليمين إلى اليسار
الحدود
| الحد | التفصيل |
|---|---|
| الدقة | قد يخطئ الذكاء الاصطناعي أو يفوّت الفروق الدقيقة أو يترجم معلومات المنتج خطأ. كل ترجمة مسودة ليقرأها إنسان. |
| ليست نظامًا متعدد اللغات كاملًا | لا بادئات لغات في الروابط، ولا ترجمة للقوائم أو نصوص القالب أو الودجات، ولا تحويل تلقائي حسب اللغة. |
| JSON الكتل | لا يُترجم النص المحفوظ داخل إعدادات الكتل (JSON). |
| الوسائط | النص البديل لعنصر مكتبة الوسائط مشترك ولا يُترجم؛ أما النصوص البديلة المكتوبة داخل المحتوى فتُترجم. |
| التنوعات | لا تُترجم خصائص التنوعات وقيمها. |
| المزامنة | تُنسخ الأسعار والمخزون والصور مرة واحدة ولا تُزامَن. |
| إضافات السيو | تُترجم فقط مفاتيح عنوان السيو والوصف والكلمة المفتاحية والعنوان والوصف الاجتماعيين المذكورة في الدليل؛ ويحفظ All in One SEO بياناته في جدوله الخاص فلا يُدعم. |
| WPML وPolylang | تحققنا من الواجهات في توثيقهما، ولم نشغّلهما على موقع الاختبار. |
| التشغيل في الخلفية | يستخدم WP-Cron؛ وفي موقع بلا زوار أبقِ الصفحة مفتوحة. |
| اتجاه الصفحة | تُضبط سمة lang للصفحة المترجمة، لكن الصفحة تبقى باتجاه الموقع: فالترجمة العربية في موقع إنجليزي تُعرض من اليسار إلى اليمين ما لم يتولَّ قالبك ذلك. |
| العناصر الطويلة | يُترجم العنصر في طلب واحد من المتصفح (5 دقائق على الأكثر) أو في خطوة واحدة في الخلفية. والعنصر الطويل جدًا يحتاج إلى طلبات ذكاء اصطناعي كثيرة وقد يتجاوز هذا الحد؛ والعنصر الذي يفشل أو يُرفض لا يُحفظ منه شيء، فتضيع طلباته. أبقِ حد أطول عنصر منخفضًا (60,000 حرف افتراضيًا). |
للمطورين
// Translate one item into one language (a linked draft; nothing is published)
$res = TQTR_Translator::instance()->translate( $post_id, 'ar' ); // array( id, status ) or WP_Error
// Find the translations of an item
$all = TQTR_Links::members( $post_id ); // array( 'en' => 12, 'ar' => 57 )
$ar = TQTR_Links::translation( $post_id, 'ar' ); // 57, or 0
$old = TQTR_Links::is_outdated( $ar ); // true when the original changed since
// The language switcher in a template
echo TQTR_Frontend::switcher( 0, array( 'style' => 'list' ) ); // or the shortcode [tqtr_switcher style="inline"]
// Filters
add_filter( 'tqtr_post_types', function ( $types ) { $types[] = 'event'; return $types; } );
add_filter( 'tqtr_fields', function ( $fields, $post ) {
$fields['meta:_subtitle'] = array( 'value' => get_post_meta( $post->ID, '_subtitle', true ), 'html' => false );
return $fields;
}, 10, 2 );
add_filter( 'tqtr_system_prompt', function ( $prompt, $from, $to ) { return $prompt . "\nUse British spelling."; }, 10, 3 );
add_filter( 'tqtr_copy_meta_keys', function ( $keys ) { $keys[] = '_my_layout'; return $keys; } );
// The key can live in wp-config.php
define( 'TQTR_AI_KEY', 'sk-...' );استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| رُفضت إجابة الذكاء الاصطناعي | أفسد النموذج العناصر النائبة أو أضاف ترميزًا. حاول مجددًا أو استخدم نموذجًا أقوى أو قسّم الفقرات الطويلة جدًا. |
| أجابت الخدمة بالرمز 401 | المفتاح خاطئ أو بلا صلاحية على النموذج. |
| بلغت الحد اليومي | ارفعه في تبويب الاتصال أو انتظر حتى الغد؛ ويستأنف التشغيل الجماعي من حيث توقف. |
| في العنصر حروف أكثر من الحد | ارفع «أطول عنصر» في الإعدادات. |
| لا يظهر المبدّل | لا تُربط إلا الترجمات المنشورة، وفقط حين لا يكون WPML أو Polylang مفعّلًا. |
| التصنيف هو الأصلي | اربط التصنيف بترجمته من شاشة تحرير التصنيف. |
| التشغيل الجماعي لا يتقدم | يعمل WP-Cron مع الزيارات: أبقِ الصفحة مفتوحة أو استدعِ wp-cron.php من مهمة cron حقيقية. |
التحديث والإزالة
ثبّت ملف الإصدار الجديد فوق القديم من الإضافات ← أضف جديدًا ← رفع إضافة (يعرض ووردبريس استبدال النسخة الحالية)، أو استبدل المجلد ai-post-and-product-translator عبر FTP. تبقى إعداداتك ولغاتك ومسردك والروابط بين الترجمات. ولإزالة الإضافة عطّلها ثم احذفها: تُحذف إعداداتها معها.
حذف الإضافة يزيل إعداداتها ولغاتها ومسردها والمهمة الجماعية والروابط بين الترجمات (بيانات المقالات والمصطلحات). وتبقى المقالات المترجمة مقالات عادية.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الإضافة أو راسل support@taqnix.com مع إصدار ووردبريس وإصدار الإضافة ولقطة شاشة.