Integrerade frontend-bibliotek och tredjepartslicenser

Målet med guiden

Denna dokumentation riktar sig till utvecklare och förklarar de integrerade frontend-biblioteken i bluetronix-standardversionen, deras lagringsplatser och de dokumenterade tredjepartslicenserna i mallen.

Viktigt: Innan en version levereras måste de faktiska filer som ingår, deras originallicensinformation och eventuella kommersiella licensbevis kontrolleras. Versionsinformationerna här kommer från denna dokumentationsmall.

Det bluetronix CMS innehåller i standardversionen olika externa frontend-bibliotek för layout, JavaScript-funktioner, bildspel, gallerier och animationer.

Dessa komponenter kallas integrerade frontend-bibliotek och ska särskiljas från de faktiska bluetronix CMS-modulerna såsom blogg, butik, sök eller inloggning.

De relevanta standardfilerna finns beroende på filtyp inom systemkatalogerna:

/bx_style/
/bx_script/

Viktigt: Katalogerna bx_style och bx_script tillhör bluetronix-systemet. De standardfiler som ingår där kan vid en uppdatering av bluetronix CMS ersättas eller skrivs över av uppdaterade versioner.

Egna ändringar bör därför inte göras direkt inom dessa standardfiler.

För individuella anpassningar bör egna filer eller motsvarande markerade _own-filer användas.

Innehållna frontend-bibliotek

Bootstrap 5.3.3 CSS

Bootstrap tillhandahåller den responsiva CSS-grundstrukturen för bluetronix standardversion.

Används:

Bootstrap 5.3.3 CSS

Observera: JavaScript-versionen av Bootstrap (bootstrap.js) ingår inte i bluetronix standardversion.

Bootstrap tillhandahåller bland annat följande CSS-funktioner:

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

Licens: MIT License

Bootstrap-koden kan användas, ändras och distribueras inom kommersiella och proprietära projekt i enlighet med MIT-licensen.

Copyright- och licensmeddelanden måste finnas kvar i kopior eller väsentliga delar av programvaran.

jQuery 3.7.1

jQuery används för olika JavaScript- och DOM-funktioner inom bluetronix CMS.

Använd version:

jQuery 3.7.1

Licens: MIT License

jQuery kan användas och distribueras inom kommersiella och proprietära projekt i enlighet med MIT-licensen.

Det befintliga copyright- och licensmeddelandet bör behållas inom den levererade jQuery-filen.

Owl Carousel 2.3.4

Owl Carousel används för slider- och carousel-representationer.

Använd version:

Owl Carousel 2.3.4

Licens: MIT License

Owl Carousel får användas inom kommersiella och proprietära projekt i enlighet med MIT-licensen.

Observera: Det officiella Owl-Carousel-2-projektet utvecklas nu inte längre aktivt. MIT-licensen för den använda versionen 2.3.4 påverkas inte av detta.

Swiper 8.4.6

Swiper är ett touch- och slider-bibliotek för responsiva webbplatser.

Använd version:

Swiper 8.4.6

Swiper kan till exempel användas för följande funktioner:

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

Licens: MIT License

Den använda Swiper-versionen kan användas och distribueras inom kommersiella och proprietära projekt i enlighet med MIT-licensen.

WOW.js 1.2.1

WOW.js används för att visa element när man scrollar på en webbplats eller för att utlösa CSS-animationer.

Använd version:

WOW.js 1.2.1

Den version som används inom bluetronix innehåller följande licensmeddelande:

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

Licens: MIT License

Viktigt: För bluetronix används den MIT-licensierade variant som vidareutvecklats av Thomas Grainger.

Denna version kan även användas inom kommersiella och proprietära projekt i enlighet med MIT-licensen.

LightGallery 1.6.2

Licenskontroll: Att LightGallery ingår i denna översikt betyder inte att det redan finns en kommersiell licens för den specifika bluetronix-distributionen. Innan en proprietär leverans måste de juridiska grunderna för den faktiskt använda versionen klargöras och dokumenteras.

LightGallery används i systemet för bild- och videogallerier samt lightbox-representationer.

Använd version:

LightGallery 1.6.2
2017-10-03

Den använda filen innehåller följande licensmeddelande:

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

Licens: GNU General Public License Version 3 (GPLv3)

Viktigt: LightGallery har andra licensvillkor än de övriga MIT-biblioteken som listats här.

LightGallery-projektet gör skillnad mellan:

Open-Source-Nutzung
→ GPLv3

Proprietäre / kommerzielle Anwendung
→ Commercial License

För användning inom en proprietär bluetronix-distribution bör således en giltig kommersiell LightGallery-licens finnas.

Alternativt måste användningen vara helt förenlig med villkoren för GPLv3.

Rekommendation: Om bluetronix levereras proprietärt till kunder bör LightGallery antingen användas med en lämplig kommersiell licens eller ersättas med ett bibliotek som har en licens som är lämplig för proprietär distribution.

Lagringsplatser

Biblioteksfilerna lagras i bluetronix-systemmapparna beroende på filtyp.

Bibliotek som Owl Carousel, Swiper eller LightGallery kan innehålla både CSS- och JavaScript-filer och kan därför förekomma i båda systemområdena.

Uppdateringar

innehållande:

/bx_style/
/bx_script/

Standardfilerna som finns i:

Vid en CMS-uppdatering kan dessa filer ersättas med nyare versioner som föreskrivits av bluetronix.

Genom detta kan exempelvis följande uppdateringar levereras:

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

Viktigt: Vid en versionsuppdatering av ett tredjepartsbibliotek måste det också kontrolleras om deras licensvillkor har ändrats.

Ändra inte standardfiler direkt

Standardfilerna som levereras av bluetronix bör inte ändras direkt.

Direkta ändringar kan skrivas över vid en framtida systemuppdatering.

För individuella utvidgningar gäller därför:

Standarddatei
→ unverändert lassen

Eigene Erweiterung
→ eigene Datei oder _own-Datei verwenden

Ta emot licensinformation

De befintliga upphovsrätts- och licensmeddelandena i tredjepartsfilerna bör inte tas bort.

Till exempel:

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

eller:

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

ska finnas kvar i de levererade filerna.

Tredjepartslicenser

Dessutom rekommenderas det att tillhandahålla en central översikt över alla använda tredjepartsbibliotek inom bluetronix-distributionen.

Till exempel:

THIRD-PARTY-LICENSES.txt

Denna fil bör innehålla minst följande information:

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

Rekommenderat innehåll för filen med tredjepartslicenser

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

Licenskontroll vid uppdateringar

Eftersom frontend-biblioteken kan uppdateras via bluetronix uppdateringssystem, bör det kontrolleras innan en ny version inkluderas:

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?

Först därefter bör en ny version antas som standardbibliotek i bx_style eller bx_script.

Licensöversikt för den aktuella bluetronix-standardversionen

Sammanfattning

Bluetronix standardversion innehåller följande externa frontend-bibliotek:

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 och den använda WOW.js-versionen omfattas av MIT-licensen.

De respektive upphovsrätts- och licensmeddelandena måste förbli.

LightGallery 1.6.2 omfattas däremot av GPLv3 eller kan licensieras genom en kommersiell licens för proprietära tillämpningar.

För en proprietär bluetronix-distribution ska följande gälla:

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

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

Vid varje framtida uppdatering av ett tredjepartsbibliotek måste version och licens kontrolleras på nytt innan den nya versionen levereras via bluetronix uppdateringssystem.