Integrované frontendové knižnice a licencie tretích strán

Cieľ tutoriálu

Táto dokumentácia je určená pre vývojárov a vysvetľuje integrované frontendové knižnice štandardnej verzie bluetronix, ich uložené miesta a licencie tretích strán zdokumentované v šablóne.

Dôležité: Pred dodaním verzie je potrebné skontrolovať skutočne obsiahnuté súbory, ich originálne licenčné upozornenia a prípadné existujúce komerčné doklady o licenciách. Tu uvedené informácie o verziách pochádzajú z tejto dokumentačnej šablóny.

CMS bluetronix obsahuje v štandardnej verzii rôzne externé frontendové knižnice pre rozloženie, JavaScriptové funkcie, posuvníky, galérie a animácie.

Tieto komponenty sa nazývajú integrované frontendové knižnice a delia sa od samotných modulov CMS bluetronix, ako sú Blog, Obchod, Vyhľadávanie alebo Prihlásenie.

Zodpovedajúce štandardné súbory sa nachádzajú v závislosti od typu súboru v systémových adresároch:

/bx_style/
/bx_script/

Dôležité: Adresáre bx_style a bx_script patrí k systému bluetronix. Štandardné súbory obsiahnuté v nich môžu byť pri aktualizácii CMS bluetronix nahradené alebo prepísané aktualizovanými verziami.

Vlastné zmeny by sa preto nemali robiť priamo v týchto štandardných súboroch.

Pre individuálne prispôsobenia by sa mali používať vlastné súbory alebo príslušne označené súbory _own.

Zahrnuté frontendové knižnice

Bootstrap 5.3.3 CSS

Bootstrap poskytuje responzívny CSS rámec pre štandardnú verziu bluetronix.

Používa sa:

Bootstrap 5.3.3 CSS

Poznámka: JavaScript verzia Bootstrapu (bootstrap.js) nie je súčasťou štandardnej verzie bluetronix.

Bootstrap poskytuje okrem iného nasledujúce CSS funkcie:

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

Licencia: MIT licencia

Kód Bootstrapu môže byť používaný, modifikovaný a distribuovaný v komerčných a proprietárnych projektoch v súlade s MIT licenciou.

Pôvodné a licenčné oznámenia musia zostať v kópiách alebo podstatných častiach softvéru.

jQuery 3.7.1

jQuery sa používa pre rôzne JavaScript a DOM funkcie v rámci bluetronix CMS.

Použitá verzia:

jQuery 3.7.1

Licencia: MIT licencia

jQuery môže byť používané a distribuované v komerčných a proprietárnych projektoch v súlade s MIT licenciou.

Existujúce upozornenie na autorské práva a licenčné podmienky by malo zostať v dodanej jQuery súbore.

Owl Carousel 2.3.4

Owl Carousel sa používa na zobrazenie sliderov a karuselistov.

Použitá verzia:

Owl Carousel 2.3.4

Licencia: MIT licencia

Owl Carousel sa môže používať aj v komerčných a proprietárnych projektoch v súlade s MIT licenciou.

Poznámka: Oficiálny projekt Owl-Carousel-2 sa už aktívne nevyvíja. MIT licencia použitej verzie 2.3.4 tým nie je dotknutá.

Swiper 8.4.6

Swiper je knižnica pre dotykové ovládanie a slidery pre responzívne webové stránky.

Použitá verzia:

Swiper 8.4.6

Swiper sa môže napríklad použiť na nasledujúce funkcie:

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

Licencia: MIT licencia

Použitá verzia Swiper môže byť použitá a distribuovaná v komerčných a proprietárnych projektoch v súlade s MIT licenciou.

WOW.js 1.2.1

WOW.js sa používa na zobrazenie prvkov pri rolovaní webovej stránky alebo na spúšťanie CSS animácií.

Použitá verzia:

WOW.js 1.2.1

Verzia použitá v bluetronix obsahuje nasledujúce licenčné upozornenie:

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

Licencia: MIT licencia

Dôležité: Pre bluetronix sa používa verzia WOW.js licencovaná MIT, ktorú spravuje Thomas Grainger.

Táto verzia sa môže používať aj v komerčných a proprietárnych projektoch v súlade s MIT licenciou.

LightGallery 1.6.2

Kontrola licencie: Zaradenie LightGallery do tohto prehľadu neznamená, že už existuje komerčná licencia pre konkrétnu distribúciu bluetronix. Pred proprietárnym dodaním je potrebné objasniť a zdokumentovať právny základ skutočne použitej verzie.

LightGallery sa v systéme používa na obrazové a video galérie, ako aj na zobrazenie lightboxu.

Použitá verzia:

LightGallery 1.6.2
2017-10-03

Použitý súbor obsahuje nasledujúce licenčné upozornenie:

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

Licencia: GNU General Public License verzia 3 (GPLv3)

Dôležité: LightGallery má iné licenčné podmienky ako ostatné tu uvedené MIT knižnice.

Projekt LightGallery rozlišuje medzi:

Open-Source-Nutzung
→ GPLv3

Proprietäre / kommerzielle Anwendung
→ Commercial License

Pre použitie v rámci proprietárnej distribúcie bluetronix by teda mala byť platná komerčná licencia LightGallery.

Alternatívne musí byť využitie úplne v súlade s podmienkami GPLv3.

Ak je bluetronix dodávaný zákazníkom proprietárne, mal by sa LightGallery používať buď prostredníctvom príslušnej komerčnej licencie, alebo by mal byť nahradený knižnicou s licenčnými podmienkami vhodnými pre proprietárnu distribúciu.

Uložené miesta

Súbory knižnice sa ukladajú v závislosti od ich typu do systémových priečinkov bluetronix.

Knižnice ako Owl Carousel, Swiper alebo LightGallery môžu mať ako CSS, tak aj JavaScript súbory, a preto môžu byť zastúpené v oboch systémových oblastiach.

Aktualizácie

V rámci:

/bx_style/
/bx_script/

prítomné štandardné súbory sú spravované aktualizačným systémom bluetronix.

Pri aktualizácii CMS môžu byť tieto súbory nahradené novšími verziami určenými bluetronix.

Týmto spôsobom môžu byť napríklad dodané nasledujúce aktualizácie:

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

Dôležité: Pri aktualizácii verzie knižnice tretej strany je potrebné dodatočne skontrolovať, či sa jej licenčné podmienky zmenili.

Nemenť štandardné súbory priamo

Štandardné súbory dodávané bluetronix by sa nemali priamo meniť.

Priame zmeny môžu byť pri budúcej aktualizácii systému prepísané.

Pre individuálne rozšírenia platí teda:

Standarddatei
→ unverändert lassen

Eigene Erweiterung
→ eigene Datei oder _own-Datei verwenden

Získať licenčné upozornenia

Existujúce upozornenia na autorské práva a licencie v súboroch tretej strany by sa nemali odstraňovať.

Napríklad:

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

alebo:

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

by mali zostať v dodaných súboroch.

Licencie tretích strán

Okrem toho je vhodné poskytnúť centrálny prehľad všetkých použitých knižníc tretej strany v rámci distribúcie bluetronix.

Napríklad:

THIRD-PARTY-LICENSES.txt

Tento súbor by mal obsahovať minimálne nasledujúce informácie:

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

Odporúčaný obsah súboru s licenciami tretích strán

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

Kontrola licencií pri aktualizáciách

Keďže front-end knižnice môžu byť aktualizované prostredníctvom aktualizačného systému bluetronix, pred pridaním novej verzie by sa malo skontrolovať:

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?

Až potom by sa mala nová verzia prijať ako štandardná knižnica v bx_style alebo bx_script.

Prehľad licencií pre aktuálnu štandardnú verziu bluetronix

Zhrnutie

Štandardná verzia bluetronix obsahuje nasledujúce externé front-end knižnice:

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 a použitá verzia WOW.js sú pod MIT licenciou.

Príslušné upozornenia na autorské práva a licencie musia zostať zachované.

LightGallery 1.6.2 je dostupný pod GPLv3 alebo môže byť licencovaný prostredníctvom komerčnej licencie pre proprietárne aplikácie.

Pre proprietárnu distribúciu bluetronix platia nasledujúce požiadavky:

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

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

Pri každej budúcej aktualizácii knižnice tretích strán treba opäť skontrolovať verziu a licenciu, predtým než sa nová verzia dodá prostredníctvom aktualizačného systému bluetronix.