Integrované frontendové knihovny a licence třetích stran

Cíl tutoriálu

Tato dokumentace je určena pro vývojáře a vysvětluje integrované front-end knihovny standardní verze bluetronix, jejich umístění a dokumentované licence třetích stran v šabloně.

Důležité: Před dodáním verze je nutné zkontrolovat skutečně obsažené soubory, jejich původní licenční upozornění a případně existující komerční doklady o licenci. Uvedené verze pocházejí z této dokumentační šablony.

bluetronix CMS ve standardní verzi obsahuje různé externí front-end knihovny pro rozvržení, funkce JavaScript, posuvníky, galerie a animace.

Tyto komponenty se nazývají integrované front-end knihovny a liší se od skutečných modulů bluetronix CMS, jako jsou Blog, Obchod, Vyhledávání nebo Přihlášení.

Odpovídající standardní soubory se nacházejí v závislosti na typu souboru v systémových adresářích:

/bx_style/
/bx_script/

Důležité: Adresáře bx_style a bx_script patří k systému bluetronix. Standardní soubory v nich obsažené mohou být při aktualizaci bluetronix CMS nahrazeny nebo přepsány aktualizovanými verzemi.

Vlastní změny by proto neměly být prováděny přímo v těchto standardních souborech.

Pro vlastní úpravy by měly být použity vlastní soubory nebo odpovídajícím způsobem označené _own soubory.

Obsažené frontendové knihovny

Bootstrap 5.3.3 CSS

Bootstrap poskytuje responsivní CSS základ pro standardní verzi bluetronix.

Používá se:

Bootstrap 5.3.3 CSS

Poznámka: JavaScriptová verze Bootstrapu (bootstrap.js) není součástí standardní verze bluetronix.

Bootstrap poskytuje mimo jiné následující CSS funkce:

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

Licence: MIT licence

Kód Bootstrapu může být použit, upraven a distribuován v komerčních a proprietárních projektech v souladu s MIT licencí.

Oznámení o autorských právech a licencích musí zůstat zachována v kopiích či podstatných částech softwaru.

jQuery 3.7.1

jQuery se používá pro různé JavaScript a DOM funkce v bluetronix CMS.

Použitá verze:

jQuery 3.7.1

Licence: MIT licence

jQuery může být také používán a distribuován v komerčních a proprietárních projektech v souladu s MIT licencí.

Copyright a licenční informace by měly zůstat v dodávaném jQuery souboru.

Owl Carousel 2.3.4

Owl Carousel se používá pro zobrazení slidů a carouselů.

Použitá verze:

Owl Carousel 2.3.4

Licence: MIT licence

Owl Carousel může být používán i v komerčních a proprietárních projektech za dodržení MIT licence.

Poznámka: Oficiální projekt Owl Carousel 2 již není aktivně vyvíjen. MIT licence použité verze 2.3.4 zůstává nedotčena.

Swiper 8.4.6

Swiper je knihovna pro touch a slidery pro responzivní webové stránky.

Použitá verze:

Swiper 8.4.6

Swiper může být například použit pro následující funkce:

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

Licence: MIT licence

Použitá verze Swiper je dostupná pro komerční a proprietární projekty za dodržení MIT licence.

WOW.js 1.2.1

WOW.js se používá k zobrazení prvků při rolování webové stránky nebo k spuštění CSS animací.

Použitá verze:

WOW.js 1.2.1

Použitá verze v bluetronix obsahuje následující licenční upozornění:

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

Licence: MIT licence

Důležité: Pro bluetronix je používána varianta WOW.js s MIT licencí, kterou dále rozvíjí Thomas Grainger.

Tato verze může být používána v komerčních a proprietárních projektech za dodržení MIT licence.

LightGallery 1.6.2

Kontrola licence: Zařazení LightGallery do tohoto přehledu neznamená, že již existuje komerční licence pro konkrétní distribuci bluetronix. Před vlastním vydáním musí být řádně vyjasněny a zdokumentovány právní podmínky použité verze.

LightGallery se používá v systému pro galerie obrázků a videí a pro zobrazení lightboxů.

Použitá verze:

LightGallery 1.6.2
2017-10-03

Použitý soubor obsahuje následující licenční upozornění:

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

Licence: GNU General Public License verze 3 (GPLv3)

Důležité: LightGallery má jiné licenční podmínky než ostatní zde uvedené MIT knihovny.

Projekt LightGallery rozlišuje mezi:

Open-Source-Nutzung
→ GPLv3

Proprietäre / kommerzielle Anwendung
→ Commercial License

Pro použití v proprietární distribuci bluetronix by měla být tedy k dispozici platná komerční licence LightGallery.

Alternativně by mělo být používání plně v souladu s podmínkami GPLv3.

Doporučení: Pokud je bluetronix dodáván klientům jako proprietární, měl by LightGallery být používán buď na základě odpovídající komerční licence, nebo nahrazen knihovnou s licencí vhodnou pro proprietární distribuci.

Umístění souborů

Knihovní soubory jsou ukládány do systémových složek bluetronix v závislosti na jejich typu.

Knihovny jako Owl Carousel, Swiper nebo LightGallery mohou mít jak CSS, tak JavaScript soubory, a proto mohou být zastoupeny v obou systémech.

Aktualizace

V rámci:

/bx_style/
/bx_script/

přítomné standardní soubory spravuje systém aktualizací bluetronix.

Při aktualizaci CMS mohou být tyto soubory nahrazeny novějšími verzemi určenými společností bluetronix.

Tím mohou být například dodávány následující aktualizace:

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

Důležité: Při aktualizaci verze knihovny třetích stran je nutné dále zkontrolovat, zda se změnily její licenční podmínky.

Standardní soubory neměňte přímo

Standardní soubory dodávané společností bluetronix by neměly být přímo měněny.

Přímé změny mohou být při budoucí systémové aktualizaci přepsány.

Pro individuální rozšíření platí:

Standarddatei
→ unverändert lassen

Eigene Erweiterung
→ eigene Datei oder _own-Datei verwenden

Získat informace o licenci

Přítomné autorské a licenční informace v souborech třetích stran by neměly být odstraňovány.

Například:

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

nebo:

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

by měly zůstat zachovány v dodaných souborech.

Licencí třetích stran

Dále se doporučuje poskytnout v rámci distribuce bluetronix centrální přehled všech používaných knihoven třetích stran.

Například:

THIRD-PARTY-LICENSES.txt

Tento soubor by měl obsahovat minimálně následující informace:

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

Doporučený obsah souboru licencí třetích stran

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 licencí při aktualizacích

Jelikož mohou být knihovny pro frontend aktualizovány prostřednictvím systému aktualizací bluetronix, měla by před přidáním nové verze být zkontrolována:

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?

Teprve poté by měla být nová verze přijata jako standardní knihovna v bx_style nebo bx_script.

Přehled licencí pro aktuální standardní verzi bluetronix

Shrnutí

Standardní verze bluetronix obsahuje následující externí knihovny pro frontend:

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žívaná verze WOW.js jsou pod MIT licencí.

Příslušné autorské a licenční poznámky musí být zachovány.

LightGallery 1.6.2 je licencován pod GPLv3 nebo může být licencován prostřednictvím komerční licence pro proprietární aplikace.

Pro proprietární distribuci bluetronix by mělo platit:

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

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

Při každé budoucí aktualizaci knihovny třetí strany je nutné znovu zkontrolovat verzi a licenci, než bude nová verze dodána prostřednictvím systému aktualizací bluetronix.