Ingebouwde frontend-bibliotheken en externe licenties

Doel van de tutorial

Deze documentatie is bedoeld voor ontwikkelaars en legt de ingebouwde frontend-bibliotheken van de bluetronix standaardversie uit, hun opslaglocaties en de in de sjabloon gedocumenteerde derde partij licenties.

Belangrijk: Voor de levering van een versie moeten de daadwerkelijk aanwezige bestanden, hun originele licentie-informatie en eventuele commerciële licentiebewijs worden gecontroleerd. De hier vermelde versie-informatie is afkomstig uit deze documentatiesjabloon.

Het bluetronix CMS bevat in de standaardversie verschillende externe frontend-bibliotheken voor lay-out, JavaScript-functies, sliders, galerijen en animaties.

Deze componenten worden aangeduid als ingebouwde frontend-bibliotheken en moeten worden onderscheiden van de eigenlijke bluetronix CMS-modules zoals Blog, Shop, Zoek of Inloggen.

De desbetreffende standaardbestanden bevinden zich, afhankelijk van het type bestand, binnen de systeemmappen:

/bx_style/
/bx_script/

Belangrijk: De mappen bx_style en bx_script behoren tot het bluetronix-systeem. De daarin opgenomen standaardbestanden kunnen bij een bluetronix CMS-update worden vervangen of overschreven door bijgewerkte versies.

Eigen wijzigingen mogen daarom niet direct binnen deze standaardbestanden worden aangebracht.

Voor individuele aanpassingen moeten eigen bestanden of overeenkomstig gemarkeerde _own-bestanden worden gebruikt.

Inbegrepen frontend-bibliotheken

Bootstrap 5.3.3 CSS

Bootstrap biedt de responsieve CSS-basisstructuur van de bluetronix standaardversie.

Gebruikt wordt:

Bootstrap 5.3.3 CSS

Opmerking: De JavaScript-versie van Bootstrap (bootstrap.js) maakt geen deel uit van de bluetronix standaardversie.

Bootstrap biedt onder andere de volgende CSS-functies aan:

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

Licentie: MIT Licentie

De Bootstrap-code kan, in overeenstemming met de MIT-licentie, ook binnen commerciële en eigendomscorrecte projecten worden gebruikt, gewijzigd en verspreid.

De auteursrecht- en licentieverklaringen moeten behouden blijven in kopieën of belangrijke delen van de software.

jQuery 3.7.1

jQuery wordt gebruikt voor verschillende JavaScript- en DOM-functies binnen het bluetronix CMS.

Gebruikte versie:

jQuery 3.7.1

Licentie: MIT Licentie

jQuery kan, in overeenstemming met de MIT-licentie, ook binnen commerciële en eigendomscorrecte projecten worden gebruikt en verspreid.

De bestaande auteursrecht- en licentieverklaring moet behouden blijven binnen het geleverde jQuery-bestand.

Owl Carousel 2.3.4

Owl Carousel wordt gebruikt voor slider- en carouselweergaven.

Gebruikte versie:

Owl Carousel 2.3.4

Licentie: MIT Licentie

Owl Carousel mag onder de MIT-licentie ook binnen commerciële en propriëtaire projecten worden ingezet.

Opmerking: Het officiële Owl-Carousel-2-project wordt inmiddels niet meer actief verder ontwikkeld. De MIT-licentie van de gebruikte versie 2.3.4 blijft daarvan ongewijzigd.

Swiper 8.4.6

Swiper is een touch- en sliderbibliotheek voor responsieve websites.

Gebruikte versie:

Swiper 8.4.6

Swiper kan bijvoorbeeld voor de volgende functies worden gebruikt:

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

Licentie: MIT Licentie

De gebruikte Swiper-versie kan onder de MIT-licentie binnen commerciële en propriëtaire projecten worden gebruikt en verspreid.

WOW.js 1.2.1

WOW.js wordt gebruikt om elementen in te blenden bij het scrollen van een website of om CSS-animaties te activeren.

Gebruikte versie:

WOW.js 1.2.1

De versie die binnen bluetronix wordt gebruikt bevat de volgende licentieopmerking:

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

Licentie: MIT Licentie

Belangrijk: Voor bluetronix wordt de door Thomas Grainger voortgezette MIT-gelegeerde variant van WOW.js gebruikt.

Deze versie kan onder de MIT-licentie ook binnen commerciële en propriëtaire projecten worden gebruikt.

LightGallery 1.6.2

Licentiecontrole: Uit de opname van LightGallery in deze overzicht volgt niet dat er al een commerciële licentie voor de specifieke bluetronix-distributie aanwezig is. Voor een propriëtaire levering moet de juridische basis van de werkelijk gebruikte versie worden opgehelderd en gedocumenteerd.

LightGallery wordt binnen het systeem gebruikt voor beeld- en videogalerijen en lightboxweergaven.

Gebruikte versie:

LightGallery 1.6.2
2017-10-03

Het gebruikte bestand bevat de volgende licentieopmerking:

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

Licentie: GNU General Public License Versie 3 (GPLv3)

Belangrijk: LightGallery heeft andere licentievoorwaarden dan de overige hier genoemde MIT-bibliotheken.

Het LightGallery-project maakt onderscheid tussen:

Open-Source-Nutzung
→ GPLv3

Proprietäre / kommerzielle Anwendung
→ Commercial License

Voor gebruik binnen een propriëtaire bluetronix-distributie zou daarom een geldige commerciële LightGallery-licentie aanwezig moeten zijn.

Alternatief zou het gebruik volledig met de voorwaarden van de GPLv3 in overeenstemming moeten zijn.

Aanbeveling: Als bluetronix propriëtair aan klanten wordt geleverd, moet LightGallery ofwel via een overeenkomstige commerciële licentie worden gebruikt of vervangen worden door een bibliotheek met een voor propriëtaire distributie geschikte licentie.

Opslaglocaties

De bibliotheekbestanden worden afhankelijk van hun bestandstype binnen de bluetronix-systeemmappen opgeslagen.

Bibliotheken zoals Owl Carousel, Swiper of LightGallery kunnen zowel CSS- als JavaScript-bestanden bevatten en daarom in beide systeemgebieden aanwezig zijn.

Updates

Binnen:

/bx_style/
/bx_script/

bestaande standaardbestanden worden beheerd door het bluetronix-update-systeem.

Bij een CMS-update kunnen deze bestanden worden vervangen door nieuwere versies die door bluetronix zijn vastgesteld.

Hierdoor kunnen bijvoorbeeld de volgende updates worden geleverd:

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

Belangrijk: Bij een versie-update van een derdepartijenbibliotheek moet bovendien worden gecontroleerd of de licentievoorwaarden zijn veranderd.

Standaardbestanden niet direct wijzigen

De door bluetronix geleverde standaardbestanden mogen niet rechtstreeks worden gewijzigd.

Directe wijzigingen kunnen bij een toekomstige systeemupdate worden overschreven.

Voor individuele uitbreidingen geldt daarom:

Standarddatei
→ unverändert lassen

Eigene Erweiterung
→ eigene Datei oder _own-Datei verwenden

Licentie-informatie ontvangen

De bestaande copyright- en licentie-informatie in de derdepartijenbestanden moet behouden blijven.

Bijvoorbeeld:

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

of:

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

moeten behouden blijven in de geleverde bestanden.

Derde partij licenties

Daarnaast is het raadzaam om binnen de bluetronix-distributie een centrale overzicht van alle gebruikte derdepartijenbibliotheken te bieden.

Bijvoorbeeld:

THIRD-PARTY-LICENSES.txt

Dit bestand moet minstens de volgende informatie bevatten:

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

Aanbevolen inhoud van het bestand met derde partij licenties

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

Licentiecontrole bij updates

Aangezien de frontend-bibliotheken via het bluetronix-update-systeem kunnen worden bijgewerkt, moet voorafgaand aan de opname van een nieuwe versie worden gecontroleerd:

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?

Pas daarna moet een nieuwe versie als standaardbibliotheek in bx_style of bx_script worden opgenomen.

Licentieoverzicht voor de huidige bluetronix standaardversie

Samenvatting

De bluetronix-standaardversie bevat de volgende externe frontend-bibliotheken:

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 en de gebruikte WOW.js-versie vallen onder de MIT-licentie.

De respectieve copyright- en licentie-informatie moet behouden blijven.

LightGallery 1.6.2 valt daarentegen onder GPLv3 of kan worden gelicentieerd via een commerciële licentie voor proprietaire toepassingen.

Voor een proprietaire bluetronix distributie moet het volgende gelden:

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

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

Bij elke toekomstige update van een externe bibliotheek moeten versie en licentie opnieuw worden gecontroleerd voordat de nieuwe versie via het bluetronix update-systeem wordt geleverd.