ایجاد فایل‌های JavaScript وابسته به زبان برای ماژول‌های CMS

فایل‌های JavaScript وابسته به زبان

سیستم مدیریت محتوای bluetronix می‌تواند برای هر زبان فعال شده در وب‌سایت شما، فایل‌های جاوااسکریپت مخصوصی تولید کند. بدین ترتیب متن‌ها و عملکردهای وابسته به زبان به‌طور مستقیم در داخل فایل جاوااسکریپت مربوطه در دسترس خواهند بود.

فایل‌های مورد نیاز به‌طور خودکار ایجاد می‌شوند به‌محض اینکه یک پیکربندی ماژول ذخیره می‌شود. سیستم مدیریت محتوا هم فایل‌های استاندارد و هم تغییرات شخصی شما را در نظر می‌گیرد.

این آموزش بر اساس مستندات «اضافه کردن و تنظیم ماژول‌های CMS» استوار است. شما باید قبلاً با پوشه توسعه‌دهنده bx_Mod و استفاده از _own-فایل‌های خود آشنا باشید.

1. تولید خودکار فایل‌های JavaScript

هر بار که یک پیکربندی ماژول را ذخیره می‌کنید، سیستم مدیریت محتوا به‌طور خودکار تمامی فایل‌های جاوااسکریپت وابسته به زبان مورد نیاز را مجدداً تولید می‌کند.

تنها نسخه‌های زبانی که از طریق ماژول Lang فعال کرده‌اید، ایجاد خواهند شد.

زبان‌های فعال شده از طریق پیکربندی کلی ماژول تعیین می‌شوند:

bx_Mod/config_own.php

به عنوان مثال، اگر شما زبان‌های آلمانی، انگلیسی و اسپانیایی را فعال کرده‌اید، سیستم مدیریت محتوا فایل‌های جاوااسکریپت مربوط به این سه زبان را ایجاد می‌کند.

تغییر مجموعه رنگ یا چیدمان دیگر، فایل‌های جاوااسکریپت را دیگر تغییر نخواهد داد. تولید خودکار مجدد در هنگام ذخیره یک پیکربندی ماژول انجام می‌شود.

2. تولید دستی فایل‌های JavaScript

علاوه بر تولید خودکار، شما می‌توانید فایل‌های جاوااسکریپت وابسته به زبان را به‌طور دستی هم تولید کنید.

برای این کار به عنوان مدیر به آدرس زیر مراجعه کنید. دامنه نمونه را با آدرس سیستم مدیریت محتوای خود جایگزین کنید:

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

از طریق این فراخوان می‌توانید فایل‌های جاوااسکریپت را مستقل از ذخیره پیکربندی ماژول مجدداً تولید کنید.

3. پیکربندی ماژول جهانی

پیکربندی کلی ماژول در آدرس زیر قرار دارد:

bx_Mod/config_own.php

این فایل شامل تنظیمات خاص پروژه شما است. پس از نصب، مطابق با نیازهای کاربر تنظیم خواهد شد.

در اینجا همچنین تعیین می‌شود که کدام ماژول‌ها و بخش‌ها باید استفاده شوند، به عنوان مثال فروشگاه یا وبلاگ. علاوه بر این، زبان‌های فعال شده در نظر گرفته می‌شوند.

به این ترتیب، پیکربندی یک بنیاد مهم برای تولید فایل‌های جاوااسکریپت وابسته به زبان ایجاد می‌کند.

4. پیکربندی ماژول‌ها و فایل‌های زبانی

در هنگام تولید، سیستم مدیریت محتوا فایل‌های پیکربندی ماژول‌های مربوطه را در نظر می‌گیرد. این شامل پیکربندی استاندارد، تغییرات ویژه و متن‌های وابسته به زبان است.

به عنوان مثال، ماژول فروشگاه، این‌ها هستند:

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 مخصوص استفاده کنید تا تغییرات شما در به‌روزرسانی‌های عادی سیستم مدیریت محتوا حفظ شود.

5. JavaScript استاندارد و تنظیمات شخصی

فایل‌های عمومی جاوااسکریپت در پوشه توسعه‌دهنده bx_script قرار دارند.

برای عملکردهای مرکزی جاوااسکریپت، فایل‌های زیر در نظر گرفته شده‌اند:

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

BxScript.js فایل استاندارد CMS بلوترونیکس است. این فایل ممکن است در به‌روزرسانی‌های سیستم نادیده گرفته شود.

فایل‌های BxScript_own.js و BxScript_own_min.js برای تنظیمات فردی در نظر گرفته شده‌اند.

این فایل‌ها می‌توانند هنگام تولید فایل‌های جاوااسکریپت وابسته به زبان در نظر گرفته شوند.

6. JavaScript هدر و تنظیمات شخصی

علاوه بر فایل‌های عمومی جاوااسکریپت، فایل‌های جداگانه‌ای برای هدر وب‌سایت شما وجود دارد.

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

BxHeadScript.js شامل توابع جاوااسکریپت هدر ارائه شده توسط CMS است. این فایل استاندارد ممکن است در یک به‌روزرسانی سیستم نادیده گرفته شود.

برای تنظیمات خودتان، BxHeadScript_own.js و BxHeadScript_own_min.js در دسترس شما هستند.

نسخه‌های وابسته به زبان نیز از این فایل‌ها تولید می‌شوند.

7. فایل‌های JavaScript تولید شده

CMS فایل‌های جداگانه‌ای برای هر زبان فعال شده با استفاده از فایل‌های پیکربندی، زبان و جاوااسکریپت موجود تولید می‌کند.

به عنوان مثال، فایل‌های عمومی جاوااسکریپت زیر تولید می‌شوند:

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

علاوه بر این، فایل‌های جاوااسکریپت هدر مربوطه نیز ایجاد می‌شوند:

/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 تولید شده

در حین تولید، فایل‌های جاوااسکریپت به طور اضافی بهینه‌سازی می‌شوند. بنابراین می‌توان نظرات غیر ضروری و فضای اضافی حذف شود.

بهینه‌سازی ساده شامل مراحل زیر است:

1. خطوطی که با // شروع می‌شوند، حذف می‌شوند.

2. خطوطی که فقط شامل فضای خالی هستند، حذف می‌شوند.

3. چند فضای خالی می‌تواند با یک فضای خالی جایگزین شود.

یک مینی‌فیکیشن کامل در حال حاضر الزامی نیست.

بهینه‌سازی محتویات غیر ضروری درون فایل‌های تولید شده جاوااسکریپت را کاهش می‌دهد.

9. بارگذاری خودکار فایل‌های JavaScript وابسته به زبان

CMS بلوترونیکس هنگام تولید وب‌سایت شما بررسی می‌کند که آیا برای زبان فعلی انتخاب شده، فایل جاوااسکریپت مربوطه وجود دارد یا خیر.

در قالب HTML، به عنوان مثال، فایل عمومی جاوااسکریپت ممکن است از طریق نشانه‌گذاری CMS زیر گنجانده شده باشد:

__FV_/bx_script/BxScript_own_min.js__

اگر بازدیدکننده نسخه زبان آلمانی وب‌سایت شما را باز کند و فایل زبان مربوطه موجود باشد، CMS به طور خودکار نشانه‌گذاری را با:

__FV_/bx_script/BxScript_de.js__

همین اصل برای فایل جاوااسکریپت هدر نیز صدق می‌کند.

از:

__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 هدر قابل استفاده است.

۱۱. خلاصه

CMS bluetronix به‌طور خودکار فایل‌های JavaScript جداگانه برای هر زبان فعال وب‌سایت شما ایجاد می‌کند.

ایجاد در هنگام ذخیره هر تنظیم ماژول انجام می‌شود. علاوه بر این، می‌توانید آنها را به‌صورت دستی از طریق bx_Mod/BxScript.php اجرا کنید.

در هنگام ایجاد، پیکربندی عمومی ماژول، فایل‌های پیکربندی و زبان ماژول‌ها و همچنین فایل‌های JavaScript استاندارد و سفارشی در نظر گرفته می‌شوند.

CMS به‌طور خودکار در لایه تشخیص می‌دهد که آیا فایل زبان مناسب وجود دارد و آن را به‌جای فایل JavaScript عمومی پیوست می‌کند.

برای تنظیمات فردی، به‌طور کلی از فایل‌های _own استفاده کنید تا تغییرات شما در به‌روزرسانی‌های سیستم حفظ شود.