اللغات

كيف يعمل الموقع واللوحة بالإنجليزية والعربية، وكيف تغيّر أي نص، وما الذي يجب تغييره لإضافة لغة.

لحزمة الحزمة الكاملة

اللغات المتوفرة

الإنجليزية والعربية في التطبيقات الثلاثة. الاسم العربي للمنتج هو تيكيتوري. تُرتَّب الواجهة كلها في العربية من اليمين إلى اليسار، بخطوط عربية للنص والعناوين، وتبقى الأرقام والأسعار والتواريخ وأرقام المقاعد بالأرقام اللاتينية في اللغتين.

التطبيق	الإنجليزية	العربية
الموقع	`/en/…`	`/ar/…`
لوحة المنظّم	`/en/…`	`/ar/…`
API	`Accept-Language: en`	`Accept-Language: ar`

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

كيف تُختار اللغة

اللغة هي الجزء الأول من العنوان. المسار بدونها يذهب إلى /en (وجذر لوحة التحكم يذهب إلى /en/dashboard).
تبدّل قائمة اللغة ذلك الجزء من العنوان وتبقي الصفحة نفسها.
يرسل التطبيقان الأماميان لغة الصفحة إلى واجهة API، فتعود رسائلها باللغة نفسها. تُخزَّن قيمة Accept-Language في صفحة الدفع مع الطلب باسم locale (en أو ar)، وتُكتب بها رسائل التذكرة والاسترداد والإلغاء والتذكير الخاصة بذلك الطلب، مع عنوان الفعالية باللغة نفسها.
تسرد خريطة موقع الموقع كل صفحة عامة باللغتين، كلًّا مع بديلها، حتى تعرض محركات البحث الصحيحة.

غيّر نصًا

كل كلمة ظاهرة موجودة في messages/<namespace>/en.json وar.json، في مجلد كل واجهة أمامية. غيّر القيمة، وأبقِ المفتاح، وغيّرها في الملفين.

التطبيق	مساحات الأسماء
الموقع	`account`, `auth`, `checkout`, `common`, `contact`, `event`, `events`, `faq`, `home`, `layouts`, `legal`, `orders`, `organisers`, `pricing`, `saved`, `seats`, `venues`
لوحة المنظّم	`ai-assistant` و`auth` و`common` و`dashboard` (مع مجلد لكل صفحة: `attendees` و`check-in` و`domain` و`event-editor` و`events` و`leads` و`notifications` و`orders` و`overview` و`reports` و`roles` و`seating` و`settings` و`studio` و`team` و`venues`) و`demo-credentials` و`layouts`

المفتاح الناقص في ar.json يظهر كرسالة ناقصة في الجهة العربية، لذلك أبقِ الملفين متطابقين.
النص داخل الأقواس {curly} يملؤه التطبيق، مثل {count} أو {name}. أبقِ هذه الكلمات كما هي في اللغتين.
تسميات الحالات والأنواع والأدوار في اللوحة رسائل أيضًا، في messages/dashboard/domain وmessages/dashboard/roles.

ما تترجمه واجهة API

تعود رسائل الأخطاء وmessage الخاصة بعمليات الكتابة الناجحة بلغة الترويسة Accept-Language. تُعامَل ar-SA كعربية؛ وأي لغة لا تملكها واجهة API تعود إلى الإنجليزية.
نصوصها الخاصة ملفات JSON في back-end/src/i18n/translations/en/ وar/، واحد لكل قسم: admin وauth وcommon وlead وmail وroles وsettings وticketing. وصياغة الرسائل البريدية في mail.json.
تعود الفعاليات وأنواع التذاكر والأماكن باللغتين، بالشكل { "en": "…", "ar": "…" }، ويختار التطبيق الأمامي إحداهما.

أضف لغة إلى الموقع

اللغتان مكتوبتان في عدد قليل من الملفات، لذلك تتطلب إضافة لغة ثالثة تعديل كل منها. المسارات داخل storefront/.

أضف الرمز إلى locales في src/config/i18n.ts وفي src/proxy.ts.
انسخ كل messages/<namespace>/en.json إلى ملف يحمل رمز اللغة الجديدة، وترجم القيم، ومنها meta.siteName في messages/layouts.
إذا كانت اللغة تُكتب من اليمين إلى اليسار، فوسّع directionOf في src/config/i18n.ts الذي لا يعرف سوى ar.
أضف لها صيغة شعار في lockups داخل src/config/brand.config.ts.
الكود الذي يختار نصًّا مخزّنًا أو صيغة تاريخ بحسب اللغة، مثل src/lib/utils/pickLocalized.ts وsrc/lib/format/intlLocale.ts وsrc/lib/format/formatEventDate.ts، يختار بين en وar. ابحث في src/ عن "ar" وتعامل مع الرمز الجديد هناك أيضًا.

أضف لغة إلى لوحة التحكم

أضف الرمز إلى locales في src/config/locales.ts (وإلى RTL_LOCALES إذا كانت تُكتب من اليمين إلى اليسار) وفي src/proxy.ts. اللغة المضافة هناك تضيف أيضًا تبويبها إلى كل حقل يُحفظ بعدة لغات.
انسخ كل ملف messages/**/en.json إلى ملف باسم الرمز الجديد، وترجم القيم.
أضف كتابة الاسم بها إلى src/config/brand.config.ts وصيغة شعار إلى BRAND_LOCKUPS.
ابحث في src/ عن "ar" لتجد المواضع القليلة التي ما زالت تسمّي اللغتين مباشرة.
اللغة الثالثة في النصوص المخزنة تحتاج أيضًا إلى أن تقبلها واجهة API.

أضف لغة إلى واجهة API

تعرف واجهة API اللغتين en وar في back-end/src/i18n/i18n.service.ts. أضف الرمز الجديد هناك، وانسخ src/i18n/translations/en/ إلى مجلد يحمل اسمه، وترجم الملفات؛ وتختار خدمة البريد أيضًا بين en وar في src/modules/mail/mail.service.ts. والنصوص المخزّنة زوج { en, ar } يتحقق منه src/common/dto/localized.dto.ts، فإضافة لغة ثالثة في البيانات تعني تغيير تلك الفئات والكيانات والبيانات التجريبية.