مكتبات واجهة المستخدم المدمجة والتراخيص من جهات خارجية
تعرف على مكتبات CSS وJavaScript المدمجة في إصدار bluetronix القياسي. اكتشف التراخيص من جهات خارجية الموثقة، وكيفية الحفاظ على تحديث الملفات الأساسية، وما هي مراجعات الترخيص المطلوبة قبل التسليم الملكي.
هدف البرنامج التعليمي
توجه هذه الوثيقة إلى المطورين وتشرح المكتبات الأمامية المدمجة في الإصدار القياسي من bluetronix، وأماكن تخزينها والترخيصات الخاصة بالجهات الخارجية الموثقة في القالب.
هام: قبل تسليم إصدار، يجب التحقق من الملفات الفعلية المضمنة، وإشعارات الترخيص الأصلية الخاصة بها، وأية إثباتات رخصة تجارية موجودة. المعلومات المذكورة هنا بشأن الإصدارات تأتي من قالب الوثائق هذا.
يحتوي نظام إدارة المحتوى bluetronix في الإصدار القياسي على مكتبات أمامية خارجية مختلفة لتصميم الواجهة، ووظائف JavaScript، والشرائح، والمعارض، والرسوم المتحركة.
تسمى هذه المكونات مكتبات أمامية مدمجة ويجب تمييزها عن وحدات bluetronix CMS الفعلية مثل المدونة، والمتجر، والبحث أو تسجيل الدخول.
تقع الملفات القياسية ذات الصلة اعتمادًا على نوع الملف ضمن الأدلة النظامية:
/bx_style/
/bx_script/
هام: الأدلة bx_style و bx_script تابعة لنظام bluetronix. يمكن استبدال الملفات القياسية الموجودة بها بإصدارات محدثة عند تحديث نظام إدارة المحتوى bluetronix.
لذا، يجب عدم إجراء تغييرات خاصة مباشرةً داخل هذه الملفات القياسية.
للتعديلات الفردية، يجب استخدام ملفات خاصة أو ملفات _own المحددة على هذا النحو.
مكتبات واجهة المستخدم المدخلة
| المكتبة | الإصدار | الرخصة | استخدام |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | تصاميم استجابة ومكونات CSS |
| jQuery | 3.7.1 | MIT | وظائف JavaScript و DOM |
| Owl Carousel | 2.3.4 | MIT | المزلقات والكاروسيلات |
| Swiper | 8.4.6 | MIT | مزلق اللمس وكاروسيلات استجابة |
| WOW.js | 1.2.1 | MIT | تحريك التمرير والظهور |
| LightGallery | 1.6.2 | ترخيص GPLv3 / ترخيص تجاري | معارض الصور ومقاطع الفيديو / Lightbox |
Bootstrap 5.3.3 CSS
يوفر Bootstrap الهيكل الأساسي لـ CSS المستجيب لإصدار bluetronix القياسي.
يستخدم:
Bootstrap 5.3.3 CSS
ملاحظة: النسخة الجافا سكريبت من Bootstrap (bootstrap.js) ليست جزءًا من إصدار bluetronix القياسي.
يوفر Bootstrap عددًا من وظائف CSS بما في ذلك:
- Grid-System
- responsive Breakpoints
- Container
- Spacing-Klassen
- Typografie
- Buttons
- Formular-Styles
- Utility-Klassen
ترخيص: ترخيص MIT
يمكن استخدام كود Bootstrap، مع الالتزام بترخيص MIT، داخل مشاريع تجارية وملكية.
يجب الحفاظ على إشعارات حقوق النشر والترخيص في النسخ أو الأجزاء الأساسية من البرنامج.
jQuery 3.7.1
يستخدم jQuery لوظائف JavaScript وDOM المختلفة داخل نظام إدارة المحتوى 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 التي يديرها توماس غرينجر.
يمكن استخدام هذه النسخة وفقًا لرخصة MIT أيضًا ضمن المشاريع التجارية والملكية.
LightGallery 1.6.2
مراجعة الترخيص: إن إدراج LightGallery في هذه النظرة العامة لا يعني أن هناك بالفعل ترخيص تجاري للإصدار المحدد من bluetronix. يجب توضيح وتوثيق الأساس القانوني للإصدار المستخدم فعليًا قبل التوزيع الملكي.
يستخدم LightGallery داخل النظام لعرض المعارض الخاصة بالصور والفيديو وكذلك عروض Lightbox.
الإصدار المستخدم:
LightGallery 1.6.2
2017-10-03
تحتوي الملف المستخدم على إشعار الترخيص التالي:
Lightgallery
Author: Sachin N
License: GPLv3
Version: 1.6.2 - 2017-10-03
ترخيص: رخصة جنو العامة (GPLv3)
هام: تمتلك LightGallery شروط ترخيص مختلفة عن المكتبات القائمة على MIT المذكورة هنا.
يميز مشروع LightGallery بين:
Open-Source-Nutzung
→ GPLv3
Proprietäre / kommerzielle Anwendung
→ Commercial License
لذا، يجب أن يكون لديك ترخيص LightGallery تجاري صالح لاستخدامه داخل توزيع bluetronix الملكي.
بدلاً من ذلك، يجب أن تكون الاستخدامات متوافقة تمامًا مع شروط GPLv3.
توصية: إذا تم تسليم bluetronix بشكل ملكي للعملاء، يجب استخدام LightGallery إما من خلال ترخيص تجاري مناسب أو استبداله بمكتبة برخصة مناسبة للتوزيع الملكي.
أماكن التخزين
يتم تخزين ملفات المكتبة حسب نوع ملفها داخل مجلدات نظام bluetronix.
| نوع الملف | دليل |
|---|---|
| CSS | /bx_style/ |
| JavaScript | /bx_script/ |
يمكن أن تحتوي المكتبات مثل 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
| المكتبة | الإصدار | الرخصة | الاستخدام الخاص |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | نعم، مع مراعاة رخصة MIT. |
| jQuery | 3.7.1 | MIT | نعم، مع مراعاة رخصة MIT. |
| Owl Carousel | 2.3.4 | MIT | نعم، مع مراعاة رخصة MIT. |
| Swiper | 8.4.6 | MIT | نعم، مع مراعاة رخصة MIT. |
| WOW.js | 1.2.1 | MIT | نعم، مع مراعاة رخصة MIT. |
| LightGallery | 1.6.2 | GPLv3 / تجاري | استخدم ترخيص Commercial License للتوزيع الخاص |
ملخص
تشمل النسخة القياسية من 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 أو يمكن ترخيصه من خلال ترخيص Commercial License للتطبيقات الخاصة.
لذا يجب أن تسري الشروط التالية على توزيع 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.
الأسئلة المتكررة
ما الذي يسأله العملاء غالباً
ما هي المكتبات الأمامية المدمجة؟
هي مكتبات CSS و JavaScript الخارجية التي تستخدم في النسخة القياسية من bluetronix للتصميم، والشرائح، والمعارض، والرسوم المتحركة. وهي ليست وحدات CMS قائمة بذاتها مثل المدونة أو المتجر.
ما هي المكتبات الأمامية التي تذكرها هذه الوثيقة؟
تذكر القالب 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. يجب عليك مطابقة الإصدارات المثبتة مع الملفات الفعلية قبل التسليم.
هل يتضمن نظام bluetronix القياسي JavaScript من Bootstrap؟
لا. وفقًا للقالب، يتم استخدام Bootstrap 5.3.3 كـ CSS فقط؛ bootstrap.js ليس جزءًا من النسخة القياسية.
أين توجد ملفات CSS و JavaScript المضمنة بشكل افتراضي؟
توجد ملفات CSS في /bx_style/ وملفات JavaScript في /bx_script/. قد تمتلك المكتبات ملفات في كلا الدليلين.
هل يمكنني تغيير ملفات النظام مباشرة؟
يمكن أن تُستبدل الملفات القياسية في bx_style و bx_script عند التحديثات. استخدم ملفات مشروع منفصلة أو ملفات _own المعلمة بشكل مناسب لتوسيعك الخاص.
أي من المكتبات المذكورة تستخدم رخصة MIT؟
تذكر القالب مكتبات Bootstrap CSS و jQuery و Owl Carousel و Swiper والإصدار المدعوم من Thomas Grainger لـ WOW.js. تحقق من إشعارات الترخيص في الملفات التي تم تسليمها بالفعل.
ما هي الخصوصية التي تنطبق على LightGallery 1.6.2؟
الإصدار الموثق يخضع لرخصة GPLv3 أو لترخيص Commercial License. يجب التحقق قبل التسليم مما إذا كان هناك ترخيص تجاري مناسب للتوزيع الخاص أو ما إذا كانت الاستخدامات المحددة تتماشى تمامًا مع GPLv3.
هل الاستخدام التجاري مسموح به بموجب رخصة MIT؟
نعم، إذا تم الالتزام بشروط رخصة MIT. ويشمل ذلك بشكل خاص الحفاظ على إشعارات حقوق الطبع والنشر والترخيص المطلوبة في النسخ أو الأجزاء المهمة.
كيف أوثق تراخيص الأطراف الثالثة؟
يوصي القالب بملف مركزي THIRD-PARTY-LICENSES.txt. ينبغي أن يتضمن الاسم والإصدار وحقوق المؤلف أو المشروع والترخيص وإشارة إلى نص الترخيص المعني.
ماذا يجب أن أتحقق منه عند تحديث المكتبة؟
تحقق من النسخة الفعلية المُقدمة، والنص الترخيص، والتوافق مع التوزيعة المقصودة، وواجب الإبلاغ عن حقوق الترخيص وحقوق الطبع. تحقق مما إذا كان هناك حاجة لرخصة تجارية منفصلة.
هل تبقى الملفات التي أنشأتها _own محفوظة أثناء تحديثات النظام؟
تهدف اتفاقية _own إلى فصل الملفات الخاصة عن الملفات القياسية. هذا يحمي التعديلات الفردية من أن يتم تحديثها مثل ملفات النظام العادية؛ ومع ذلك، تبقى مسؤولية صيانة وتبني التحديثات الأمنية الهامة على المطور.
هل مكتبات الجهات الخارجية هي نفسها وحدات نظام إدارة المحتوى؟
لا. توفر مكتبات الواجهة الأمامية، على سبيل المثال، تخطيطات CSS، وعروض الشرائح، أو وظائف المعرض. أما وحدات نظام إدارة المحتوى مثل المدونة، والمتجر، والبحث، وتسجيل الدخول فهي وظائف تطبيق منفصلة من نظام bluetronix.