إنشاء ملفات JavaScript المعتمدة على اللغة لوحدات CMS

ملفات JavaScript المعتمدة على اللغة

يمكن لـ bluetronix CMS إنشاء ملفات JavaScript خاصة لكل لغة مفعلة في موقعك. وبهذا تكون النصوص والوظائف المعتمدة على اللغة متاحة مباشرة ضمن ملف JavaScript المعني.

يتم إنشاء الملفات المطلوبة تلقائيًا بمجرد حفظ تكوين الوحدة. يأخذ CMS في الاعتبار كل من الملفات القياسية وتعديلاتك الفردية.

يبني هذا البرنامج التعليمي على الوثائق "إدماج وتعديل وحدات CMS". يجب أن تكون بالفعل على دراية بمجلد المطور bx_Mod واستخدام ملفات _own الخاصة.

1. إنشاء ملفات JavaScript تلقائيًا

عند حفظ تكوين وحدة، يقوم CMS تلقائيًا بإعادة إنشاء جميع ملفات JavaScript المعتمدة على اللغة المطلوبة.

يتم إنشاء نسخ اللغة فقط التي قمت بتمكينها عبر الوحدة Lang.

تحدد التكوينات العامة للوحدة اللغات المفعلة:

bx_Mod/config_own.php

إذا كنت قد قمت بتمكين الألمانية والإنجليزية والإسبانية، فإن CMS يقوم بإنشاء ملفات JavaScript المناسبة لهذه اللغات الثلاث.

تغيير مجموعة الألوان أو التخطيطات لن يؤثر بعد الآن على ملفات JavaScript. يتم إنشاءها تلقائياً عند حفظ تكوين وحدة.

2. إنشاء ملفات JavaScript يدويًا

بالإضافة إلى التوليد التلقائي، يمكنك إنشاء ملفات JavaScript التي تعتمد على اللغة يدويًا.

لذلك، قم كمسؤول بفتح العنوان التالي. استبدل نطاق المثال بعنوان CMS الخاص بك:

https://xxxx.bxserver.net/bx_Mod/BxScript.php

من خلال هذا الاستدعاء، يمكنك إعادة توليد ملفات JavaScript بغض النظر عن حفظ تكوين الوحدة.

3. تكوين الوحدة العامة

توجد إعدادات الوحدة العالمية تحت:

bx_Mod/config_own.php

تحتوي هذه الملف على الإعدادات الفردية لمشروعك. سيتم إعداده بعد التثبيت وفقًا لمتطلبات المستخدم.

هنا يتم تحديد، من بين أمور أخرى، ما هي الوحدات والمناطق التي يجب استخدامها، مثل المتجر أو المدونة. كما تؤخذ اللغات المفعلة في الاعتبار.

تشكّل التكوين بذلك أساسًا مهمًا لتوليد ملفات JavaScript التي تعتمد على اللغة.

4. تكوينات الوحدة وملفات اللغة

عند التوليد، يأخذ CMS في الاعتبار ملفات تكوين الوحدات المعنية. تشمل هذه التكوين القياسي، التعديلات الفردية، والنصوص المعتمدة على اللغة.

كمثال على وحدة المتجر، تشمل هذه:

bx_Mod/Shop/config.php
bx_Mod/Shop/config_own.php
bx_Mod/Shop/config_text_de.php
bx_Mod/Shop/config_text_de_own.php

تفي الملفات بمهام مختلفة:

config.php: يحتوي على التكوين القياسي لوحدة المتجر.

config_own.php: يحتوي على إعدادات التكوين الفردية الخاصة بك.

config_text_de.php: يحتوي على النصوص الألمانية القياسية لوحدة المتجر.

config_text_de_own.php: يحتوي على التعديلات الفردية الخاصة بك على النصوص الألمانية.

بالنسبة للغات المفعلة الأخرى، تؤخذ ملفات اللغة المناسبة في الاعتبار.

حاول ألا تغير الملفات القياسية مباشرة. استخدم ملفات _own المخصصة للتعديلات الفردية، حتى تظل تغييراتك محفوظة أثناء التحديثات العادية لـ CMS.

5. JavaScript القياسي والتعديلات الخاصة

تقع ملفات JavaScript العامة في مجلد المطور bx_script.

للفfunctions الأساسية لJavaScript، تؤخذ الملفات التالية في الاعتبار:

/bx_script/BxScript_own_min.js
/bx_script/BxScript_own.js
/bx_script/BxScript_own_min.js

BxScript.js هي الملف القياسي لـ bluetronix CMS. يمكن استبدالها أثناء تحديث النظام.

الملفات BxScript_own.js و BxScript_own_min.js مخصصة للتعديلات الفردية.

يمكن أخذ هذه الملفات في الاعتبار عند توليد ملفات JavaScript المعتمدة على اللغة.

6. JavaScript الرأس والتعديلات الخاصة

بجانب ملفات JavaScript العامة، هناك ملفات منفصلة لرأس موقع الويب الخاص بك.

/bx_script/BxHeadScript_own_min.js
/bx_script/BxHeadScript_own.js
/bx_script/BxHeadScript_own_min.js

BxHeadScript.js يحتوي على وظائف JavaScript الخاصة بالهيدر التي يوفرها CMS. يمكن استبدال هذه الملف القياسي أثناء تحديث النظام.

للتعديلات الخاصة، لديك BxHeadScript_own.js و BxHeadScript_own_min.js متاحة.

تُنتج النسخ المعتمدة على اللغة أيضًا من هذه الملفات.

7. ملفات JavaScript المُنتَجة

يولد نظام إدارة المحتوى (CMS) ملفات منفصلة لكل لغة مفعلة من ملفات التكوين واللغة وJavaScript المتاحة.

على سبيل المثال، يتم إنشاء ملفات JavaScript العامة التالية:

/bx_script/BxScript_de.js
/bx_script/BxScript_en.js
/bx_script/BxScript_ru.js
/bx_script/BxScript_es.js

بالإضافة إلى ذلك، يتم إنشاء ملفات JavaScript لرؤوس الصفحات المعنية:

/bx_script/BxHeadScript_de.js
/bx_script/BxHeadScript_en.js
/bx_script/BxHeadScript_ru.js
/bx_script/BxHeadScript_es.js

تشير اختصارات اللغات إلى اللغة المحددة. على سبيل المثال، تشير de إلى الألمانية، en إلى الإنجليزية، ru إلى الروسية وes إلى الإسبانية.

ينشئ نظام إدارة المحتوى فقط الملفات للغات المفعلة فعلاً.

8. تحسين ملفات JavaScript المُنتَجة

خلال عملية الإنشاء، يتم تحسين ملفات JavaScript أيضاً. مما يسمح بإزالة التعليقات غير الضرورية والمساحات الفارغة الزائدة.

تشمل عملية التحسين البسيطة الخطوات التالية:

1. تتم إزالة الأسطر التي تبدأ بـ //.

2. تتم إزالة الأسطر التي تحتوي فقط على مسافات فارغة.

3. يمكن استبدال المساحات الفارغة المتعددة بمسافة فارغة واحدة.

لا تحتاج عملية التخفيف الكاملة حالياً إلى التنفيذ بشكل إلزامي.

يقلل التحسين من المحتويات غير الضرورية داخل ملفات JavaScript المولدة.

9. إدراج ملفات JavaScript المعتمدة على اللغة تلقائيًا

يتحقق نظام إدارة المحتوى bluetronix عند إنشاء موقع الويب الخاص بك مما إذا كانت هناك ملف JavaScript مناسب للغة المختارة حالياً.

في تخطيط HTML، يمكن مثلاً إدراج ملف JavaScript العام من خلال التعليمات البرمجية التالية للنظام:

__FV_/bx_script/BxScript_own_min.js__

عندما يقوم الزائر بفتح النسخة الألمانية من موقع الويب الخاص بك ويتوفر ملف اللغة المعني، يستبدل النظام التعليمات البرمجية تلقائياً بـ:

__FV_/bx_script/BxScript_de.js__

تنطبق نفس المبادئ على ملف JavaScript الخاص بالرؤوس.

من:

__FV_/bx_script/BxHeadScript_own_min.js__

سيصبح على سبيل المثال:

__FV_/bx_script/BxHeadScript_de.js__

لا يحتاج الربط الحالي في HTML إلى تعديل لكل لغة بشكل منفصل.

إذا لم يكن هناك ملف لغة مناسب متوفر، يبقى ملف JavaScript العام مدرجاً.

10. تحديث ذاكرة التخزين المؤقت للمتصفح وفقًا لتاريخ تغيير الملف

لكي لا يقوم المتصفح بتحميل ملف JavaScript قديم من الذاكرة المؤقتة بعد التغيير، يمكن للنظام استخدام تاريخ تغيير الملف المعني.

يحصل ملف JavaScript المدخل على معامل إصدار لذلك.

مثال:

BxScript_de.js?v=DATEI_AENDERUNGS_DATUM

إذا تغير الملف، يمكن أن يتغير أيضاً معامل الإصدار. وهذا يسمح للمتصفح بالتعرف على إصدار الملف المعدل وإعادة تحميله.

يمكن استخدام هذه الخطوات لكل من ملفات JavaScript العامة وملفات JavaScript الخاصة بالرؤوس.

11. ملخص

ينشئ نظام إدارة المحتوى bluetronix تلقائياً ملفات JavaScript منفصلة لكل لغة مفعلة على موقع الويب الخاص بك.

تتم عملية الإنشاء عند كل حفظ لتكوين الوحدة. بالإضافة إلى ذلك، يمكنك بدء العملية يدوياً عبر bx_Mod/BxScript.php.

أثناء الإنشاء، يتم أخذ تكوين الوحدة العالمي وملفات التكوين واللغة الخاصة بالوحدات بعين الاعتبار، بالإضافة إلى ملفات JavaScript القياسية والخاصة.

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

استخدم ملفات _own المخصصة للتعديلات الفردية حتى تبقى تغييراتك محفوظة عند التحديثات العادية للنظام.