کتابخانه‌های فرانت‌اند یکپارچه و مجوزهای سوم شخص

هدف این آموزش

این مستندات به توسعه دهندگان اختصاص دارد و کتابخانه های فرانت اند مجتمع در نسخه استاندارد bluetronix، مکان های آنها و مجوزهای شخص ثالث مستند در الگو را توضیح می دهد.

مهم: قبل از ارائه یک نسخه، باید فایل های موجود، اطلاعیه های مجوز اصلی آنها و در صورت وجود مدارک مجوز تجاری بررسی شود. اطلاعات نسخه های ذکر شده در این الگوی مستندات آمده است.

CMS bluetronix در نسخه استاندارد خود کتابخانه های فرانت اند مختلفی برای چیدمان، توابع JavaScript، اسلایدرها، گالری ها و انیمیشن ها دارد.

این اجزا به عنوان کتابخانه های فرانت اند مجتمع شناخته می شوند و باید از ماژول های واقعی CMS bluetronix مانند وبلاگ، فروشگاه، جستجو یا ورود تفکیک شوند.

فایل های استاندارد مربوطه بسته به نوع فایل در دایرکتوری های سیستم قرار دارد:

/bx_style/
/bx_script/

مهم: دایرکتوری های bx_style و bx_script بخشی از سیستم bluetronix هستند. فایل های استاندارد موجود در آن می توانند در زمان به روز رسانی CMS bluetronix با نسخه های به روز شده جایگزین یا بازنویسی شوند.

بنابراین تغییرات شخصی نباید مستقیماً در این فایل های استاندارد اعمال شود.

برای تنظیمات فردی، باید از فایل های شخصی یا فایل های مشخص شده با _own استفاده شود.

کتابخانه‌های فرانت‌اند موجود

CSS Bootstrap 5.3.3

بوت‌استرپ چارچوب CSS پاسخگوی نسخه استاندارد bluetronix را فراهم می‌کند.

استفاده شده است:

Bootstrap 5.3.3 CSS

توجه: نسخه جاوااسکریپت بوت‌استرپ (bootstrap.js) جزو نسخه استاندارد bluetronix نیست.

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

• Grid-System
• responsive Breakpoints
• Container
• Spacing-Klassen
• Typografie
• Buttons
• Formular-Styles
• Utility-Klassen

مجوز: مجوز MIT

کد بوت‌استرپ می‌تواند با رعایت مجوز MIT در پروژه‌های تجاری و خصوصی نیز استفاده، تغییر و توزیع شود.

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

jQuery 3.7.1

jQuery برای توابع مختلف جاوااسکریپت و DOM درون CMS bluetronix استفاده می‌شود.

نسخه استفاده شده:

jQuery 3.7.1

مجوز: مجوز MIT

jQuery می‌تواند با رعایت مجوز MIT در پروژه‌های تجاری و خصوصی نیز استفاده و توزیع شود.

هشدار حق نشر و مجوز موجود باید در فایل jQuery تحویلی حفظ شود.

Owl Carousel 2.3.4

Owl Carousel برای نمایش اسلایدرها و کاروسل‌ها استفاده می‌شود.

نسخه استفاده شده:

Owl Carousel 2.3.4

مجوز: مجوز MIT

Owl Carousel می‌تواند تحت رعایت مجوز MIT در پروژه‌های تجاری و مالکیتی نیز استفاده شود.

توجه: پروژه رسمی Owl-Carousel-2 در حال حاضر به‌طور فعال توسعه داده نمی‌شود. مجوز MIT نسخه مورد استفاده 2.3.4 از این موضوع مستثنی است.

Swiper 8.4.6

Swiper یک کتابخانه لمسی و اسلایدر برای وب‌سایت‌های واکنش‌گرا است.

نسخه استفاده شده:

Swiper 8.4.6

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

• Bild-Slider
• Content-Slider
• Touch-Gesten
• mobile Carousels
• responsive Slider

مجوز: مجوز MIT

نسخه استفاده شده از Swiper می‌تواند تحت رعایت مجوز MIT در پروژه‌های تجاری و مالکیتی مورد استفاده و منتقل شود.

WOW.js 1.2.1

WOW.js برای نمایان کردن عناصر هنگام اسکرول کردن یک وب‌سایت و یا فعال کردن انیمیشن‌های CSS استفاده می‌شود.

نسخه استفاده شده:

WOW.js 1.2.1

نسخه استفاده شده در bluetronix شامل هشدار مجوز زیر است:

WOW wow.js - v1.2.1
Copyright (c) 2016 Thomas Grainger
Licensed MIT

مجوز: مجوز MIT

مهم: برای bluetronix از نسخه MIT مجوز WOW.js که توسط توماس گرینجر ادامه یافته استفاده می‌شود.

این نسخه نیز می‌تواند تحت رعایت مجوز MIT در پروژه‌های تجاری و مالکیتی استفاده شود.

LightGallery 1.6.2

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

LightGallery در سیستم برای گالری‌های تصویر و ویدیو و همچنین نمایش‌های لایت باکس استفاده می‌شود.

نسخه استفاده شده:

LightGallery 1.6.2
2017-10-03

فایل مورد استفاده شامل هشدار مجوز زیر است:

Lightgallery
Author: Sachin N
License: GPLv3
Version: 1.6.2 - 2017-10-03

مجوز: مجوز عمومی عمومی GNU نسخه 3 (GPLv3)

مهم: LightGallery شرایط مجوز متفاوتی با سایر کتابخانه‌های MIT ذکر شده در اینجا دارد.

پروژه LightGallery بین موارد زیر تمایز قائل می‌شود:

Open-Source-Nutzung
→ GPLv3

Proprietäre / kommerzielle Anwendung
→ Commercial License

به همین دلیل باید برای استفاده در یک توزیع مالکیتی bluetronix یک مجوز تجاری معتبر LightGallery موجود باشد.

در غیر این صورت، استفاده باید به‌طور کامل با شرایط GPLv3 سازگار باشد.

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

مکان های ذخیره سازی

فایل‌های کتابخانه بر اساس نوع فایل‌شان در پوشه‌های سیستمی bluetronix ذخیره می‌شوند.

کتابخانه‌هایی مانند Owl Carousel، Swiper یا LightGallery می‌توانند هم فایل‌های CSS و هم JavaScript داشته باشند و بنابراین در هر دو بخش سیستم موجود باشند.

به روز رسانی ها

درون:

/bx_style/
/bx_script/

فایل‌های استاندارد موجود توسط سیستم به‌روزرسانی bluetronix مدیریت می‌شوند.

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

به این ترتیب، به‌روزرسانی‌های زیر می‌توانند ارائه شوند:

• Sicherheitsupdates
• Fehlerkorrekturen
• Browser-Kompatibilitätsanpassungen
• neue Bibliotheksversionen

مهم: در یک به‌روزرسانی نسخه برای یک کتابخانه شخص ثالث باید به‌علاوه بررسی شود که آیا شرایط مجوز آن تغییر کرده‌است.

فایل های استاندارد را مستقیماً تغییر ندهید

فایل‌های استاندارد ارائه شده توسط bluetronix نباید به‌طور مستقیم تغییر داده‌شوند.

تغییرات مستقیم می‌توانند در یک به‌روزرسانی سیستم آینده نادیده گرفته شوند.

بنابراین برای گسترش‌های فردی:

Standarddatei
→ unverändert lassen

Eigene Erweiterung
→ eigene Datei oder _own-Datei verwenden

اطلاعیه های مجوز را دریافت کنید

باید نشانه‌های حق چاپ و مجوز موجود در فایل‌های شخص ثالث حذف نشوند.

به عنوان مثال:

/*!
 * Bootstrap ...
 * Licensed under MIT
 */

یا:

/*! jQuery ...
 * OpenJS Foundation ...
 */

باید درون فایل‌های ارائه شده حفظ شوند.

مجوزهای شخص ثالث

علاوه بر این، توصیه می‌شود که در توزیع bluetronix یک نمای کلی مرکزی از تمام کتابخانه‌های شخص ثالث مورد استفاده ارائه شود.

برای مثال:

THIRD-PARTY-LICENSES.txt

این فایل باید حداقل شامل اطلاعات زیر باشد:

• Name der Bibliothek
• verwendete Version
• Urheber bzw. Projekt
• Lizenz
• Verweis auf die jeweilige Lizenz

محتوای پیشنهادی فایل مجوزهای شخص ثالث

Bootstrap 5.3.3
License: MIT
Copyright: The Bootstrap Authors

jQuery 3.7.1
License: MIT
Copyright: OpenJS Foundation and other contributors

Owl Carousel 2.3.4
License: MIT
Copyright: David Deutsch

Swiper 8.4.6
License: MIT
Copyright: Vladimir Kharlampidi

WOW.js 1.2.1
License: MIT
Copyright: Thomas Grainger

LightGallery 1.6.2
License: GPLv3 or valid Commercial License
Copyright: Sachin N

بررسی مجوز در زمان به روز رسانی ها

از آنجا که کتابخانه‌های ظاهری می‌توانند از طریق سیستم به‌روزرسانی bluetronix به‌روزرسانی شوند، قبل از افزودن یک نسخه جدید باید بررسی شود:

1. Welche Version wird ausgeliefert?

2. Welche Lizenz verwendet diese Version?

3. Ist die Lizenz mit einer proprietären bluetronix Distribution kompatibel?

4. Müssen Copyright- oder Lizenztexte mit ausgeliefert werden?

5. Benötigt die Bibliothek eine zusätzliche kommerzielle Lizenz?

6. Hat sich die Lizenz gegenüber der vorherigen Version geändert?

فقط پس از آن یک نسخه جدید باید به‌عنوان کتابخانه استاندارد در bx_style یا bx_script پذیرفته شود.

مرور کلی مجوز برای نسخه استاندارد فعلی bluetronix

خلاصه

نسخه استاندارد bluetronix شامل کتابخانه‌های خارجی ظاهری زیر است:

Bootstrap CSS 5.3.3
jQuery 3.7.1
Owl Carousel 2.3.4
Swiper 8.4.6
WOW.js 1.2.1
LightGallery 1.6.2

Bootstrap، jQuery، Owl Carousel، Swiper و نسخه استفاده شده WOW.js تحت مجوز MIT هستند.

نشانه‌های حق چاپ و مجوز مربوطه باید حفظ شوند.

LightGallery 1.6.2 تحت GPLv3 قرار دارد و یا می‌تواند از طریق یک مجوز تجاری برای برنامه‌های اختصاصی مجوزگذاری شود.

بنابراین برای یک توزیع اختصاصی bluetronix باید به این موارد توجه شود:

Bootstrap
jQuery
Owl Carousel
Swiper
WOW.js
→ MIT-Lizenzbedingungen einhalten

LightGallery
→ gültige Commercial License verwenden
   oder durch eine entsprechend lizenzierte Alternative ersetzen

در هر بروزرسانی آینده یک کتابخانه برای شخص ثالث، نسخه و مجوز باید دوباره بررسی شود، قبل از اینکه نسخه جدید از طریق سیستم بروزرسانی bluetronix ارائه شود.