ספריות Frontend משולבות ורישיונות צד שלישי

מטרת המדריך

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

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

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

רכיבים אלו נקראים ספריות frontend מובנות ומומלץ להבדיל בינן לבין מודולי ה-CMS של bluetronix כמו בלוג, חנות, חיפוש או התחברות.

הקבצים הסטנדרטיים הרלוונטיים נמצאים בהתאם לסוג הקובץ בתוך ספריות המערכת:

/bx_style/
/bx_script/

חשוב: הספריות bx_style ו-bx_script שייכות למערכת ה-bluetronix. קבצים סטנדרטיים הנמצאים בהן עשויים להיות מוחלפים או נכתבים מחדש בעדכון ה-CMS של bluetronix.

שינויים אישיים לא צריכים להתבצע ישירות בתוך קבצים סטנדרטיים אלו.

לשינויים אישיים יש להשתמש בקבצים אישיים או קבצים המוסמלים בהתאם כ-_own.

ספריות Frontend כלולות

Bootstrap 5.3.3 CSS

Bootstrap מספק את מבנה ה-CSS המגיב לגרסה הסטנדרטית של bluetronix.

נעשה שימוש:

Bootstrap 5.3.3 CSS

הערה: הגרסה של JavaScript של 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 בתוך ה-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 נעשה שימוש בגרסה של WOW.js שמנוהלת על ידי תומס גריינגר ורשומה תחת רישיון 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

רישיון: רישיון ציבורי כללי של 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 לא powinny być zmieniane bezpośrednio.

שינויים ישירים עשויים להתבטל בעדכון מערכת עתידי.

לכן, עבור תוספות אישיות:

Standarddatei
→ unverändert lassen

Eigene Erweiterung
→ eigene Datei oder _own-Datei verwenden

לקבל הודעות על רישיונות

יש לשמור על הודעות הזכויות יוצרים ורישוי הקיימות בתוך קבצי צד שלישי.

למשל:

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

או:

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

צריכות להישמר בתוך הקבצים המסופקים.

רישיונות של צד שלישי

בנוסף, מומלץ לספק סקירה מרכזית של כל ספריות צד שלישי בשימוש בתוך הפצת bluetronix.

לדוגמה:

THIRD-PARTY-LICENSES.txt

קובץ זה должен zawierać przynajmniej następujące informacje:

• 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.