יצירת קבצי JavaScript תלויי שפה עבור מודולי CMS

קבצי JavaScript תלויי שפה

ה-CMS של bluetronix יכול ליצור קבצי 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.

הקבצים המרכזיים לפונקציות JavaScript כוללים את הקבצים הבאים:

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

BxScript.js הוא הקובץ הסטנדרטי של ה-CMS של bluetronix. הוא עשוי להתחלף בעדכוני מערכת.

הקבצים 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 שנוצרו

מהקבצים הקיימים של קונפיגורציות, שפות ו-JavaScript ה-CMS יוצר קבצים נפרדים עבור כל שפה מופעלת.

למשל, ייווצרו קובצי 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 מסמן ספרדית.

ה-CMS יוצר רק את הקבצים עבור השפות שנכנסו לפועל.

8. אופטימיזציה של קבצי JavaScript שנוצרו

בעת היצירה, קובצי ה-JavaScript גם אומצו. כך ניתן להסיר הערות מיותרות ורווחים מיותרים.

האופטימיזציה הפשוטה כוללת את הצעדים הבאים:

1. שורות המתחילות ב-// יוסרו.

2. שורות המכילות רק רווחים יוסרו.

3. רווחים מרובים יוכלו להתחלף ברווח בודד.

מיניפיקציה מלאה אינה הכרחית בשלב זה.

האופטימיזציה מצמצמת תוכן מיותר בתוך קובצי ה-JavaScript המיוצרים.

9. קבצי JavaScript תלויי שפה משולבים אוטומטית

ה-CMS של bluetronix בודק בעת יצירת האתר שלך אם קיים קובץ JavaScript מתאים לשפה שנבחרה כעת.

בפריסת ה-HTML, למשל, הקובץ הכללי של ה-JavaScript עשוי לכלול את התיוג של ה-CMS הבא:

__FV_/bx_script/BxScript_own_min.js__

כאשר המבקר נכנס לגרסה הגרמנית של האתר שלך והקובץ התואם לשפה קיים, ה-CMS מחליף אוטומטית את התיוג:

__FV_/bx_script/BxScript_de.js__

אותה העיקרון חל על קובץ ה-JavaScript של הכותרת.

מ:

__FV_/bx_script/BxHeadScript_own_min.js__

יוצא לדוגמה:

__FV_/bx_script/BxHeadScript_de.js__

אין צורך להתאים את הכללת ה-HTML הקיימת עבור כל שפה בנפרד.

אם אין קובץ שפה מתאים, הקובץ הכללי של JavaScript נשאר משולב.

10. עדכון מטמון הדפדפן על ידי תאריך שינוי קובץ

כדי שבעלי הדפדפנים לא יטענו קובץ JavaScript מיושן מהמטמון אחרי שינוי, ה-CMS יכול להשתמש גם בתאריך השינוי של הקובץ.

לקובץ ה-JavaScript המשולב יינתן פרמטר גרסה.

דוגמה:

BxScript_de.js?v=DATEI_AENDERUNGS_DATUM

אם הקובץ משתנה, גם פרמטר הגרסה יכול להשתנות. כך הדפדפן מזהה את גרסת הקובץ הממומש ויכול לטעון אותו מחדש.

שיטה זו יכולה לשמש הן עבור קובצי JavaScript כלליים והן עבור קובצי JavaScript של הכותרת.

11. סיכום

ה-CMS של bluetronix יוצר אוטומטית קובצי JavaScript נפרדים לכל שפה שהופעלה באתר שלך.

ההפקה מתבצעת בכל שמירה של הגדרת מודול. בנוסף, תוכל להתחיל אותה באופן ידני דרך bx_Mod/BxScript.php.

בעת ההפקה מתחשבים בהגדרת המודול הגלובלית, קובצי ההגדרה וקובצי השפה של המודולים כמו גם קובצי JavaScript הסטנדרטיים והאישיים.

בפריסת האתר, ה-CMS מזהה אוטומטית אם יש קובץ שפה מתאים ומכניס אותו במקום קובץ ה-JavaScript הכללי.

בעיקרון, השתמש בקובצי _own המיועדים להתאמות אישיות, כך שהשינויים שלך יישמרו בעדכוני המערכת הרגילים.