Beépített frontend könyvtárak és harmadik féltől származó licencek
Ismerd meg a bluetronix standard verzió beépített CSS és JavaScript könyvtárait. Tudj meg többet arról, hogy milyen harmadik féltől származó licencek vannak dokumentálva, hogyan tarthatod naprakészen a standard fájlokat, és milyen licencellenőrzések szükségesek egy szabadalmaztatott kiadás előtt.
A tutoriál célja
Ez a dokumentáció fejlesztőknek szól, és magyarázza a bluetronix standard verzió beépített frontend könyvtárait, azok tárolási helyeit és a sablonban dokumentált harmadik féltől származó licenceket.
Fontos: A kiadás előtt ellenőrizni kell az aktuálisan tartalmazott fájlokat, azok eredeti licencértesítéseit és a meglévő kereskedelmi licenc bizonyítékokat. Az itt felsorolt verzióhoz kapcsolódó adatok ebből a dokumentációs sablonból származnak.
A bluetronix CMS a standard verzióban különféle külső frontend könyvtárakat tartalmaz a megjelenéshez, JavaScript funkciókhoz, csúszkákhoz, galériákhoz és animációkhoz.
Ezeket az összetevőket beépített frontend könyvtáraknak nevezzük, és külön kell választani az alap bluetronix CMS moduloktól, mint például Blog, Bolt, Keresés vagy Bejelentkezés.
A megfelelő standard fájlok a fájltípustól függően a rendszer könyvtáraiban találhatók:
/bx_style/
/bx_script/Fontos: A bx_style és bx_script könyvtárak a bluetronix rendszerhez tartoznak. Az ezekben található standard fájlokat a bluetronix CMS frissítésekor frissített verziók helyettesíthetik vagy felülírhatják.
A saját módosításokat ezért nem szabad közvetlenül ezekben a standard fájlokban elvégezni.
Egyedi beállításokhoz saját fájlokat, vagy megfelelően megjelölt _own fájlokat kell használni.
Tartalmazott frontend könyvtárak
| Könyvtár | Verzió | Licenc | Használat |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Reszponzív elrendezések és CSS komponensek |
| jQuery | 3.7.1 | MIT | JavaScript és DOM funkciók |
| Owl Carousel | 2.3.4 | MIT | Csúszkák és Karusszelek |
| Swiper | 8.4.6 | MIT | Érintő csúszkák és reszponzív karusszelek |
| WOW.js | 1.2.1 | MIT | Görgetési és megjelenítési animációk |
| LightGallery | 1.6.2 | GPLv3 / Kereskedelmi Licenc | Kép- és Videógalériák / Lightbox |
Bootstrap 5.3.3 CSS
A Bootstrap biztosítja a bluetronix standard verziójának reszponzív CSS alapjait.
Használva van:
Bootstrap 5.3.3 CSSMegjegyzés: A Bootstrap JavaScript verziója (bootstrap.js) nem része a bluetronix standard verziónak.
A Bootstrap többek között az alábbi CSS-funkciókat biztosítja:
- Grid-System
- responsive Breakpoints
- Container
- Spacing-Klassen
- Typografie
- Buttons
- Formular-Styles
- Utility-Klassen
Licenc: MIT Licenc
A Bootstrap kódja az MIT licenc figyelembevételével kereskedelmi és tulajdonosi projektekben is használható, módosítható és terjeszthető.
A szerzői jogi és licencnyilatkozatokat meg kell őrizni a szoftver másolataiban vagy lényeges részeiben.
jQuery 3.7.1
A jQuery különböző JavaScript- és DOM-funkciókhoz van használva a bluetronix CMS-en belül.
Használt verzió:
jQuery 3.7.1Licenc: MIT Licenc
A jQuery az MIT licenc figyelembevételével kereskedelmi és tulajdonosi projektekben is használható és terjeszthető.
A meglévő szerzői jogi és licencnyilatkozatot a szállított jQuery fájlban meg kell őrizni.
Owl Carousel 2.3.4
Az Owl Carousel a csúszkák és karusszel megjelenítésére használatos.
Használt verzió:
Owl Carousel 2.3.4Licenc: MIT Licenc
Az Owl Carousel az MIT licenc figyelembevételével kereskedelmi és tulajdonosi projektekben is felhasználható.
Megjegyzés: Az hivatalos Owl Carousel-2 projekt már nem aktívan folytatják. A használt 2.3.4 verzió MIT licencét ez nem befolyásolja.
Swiper 8.4.6
A Swiper egy érintő- és csúszkakönyvtár reszponzív weboldalakhoz.
Használt verzió:
Swiper 8.4.6A Swipe például a következő funkciókhoz használható:
- Bild-Slider
- Content-Slider
- Touch-Gesten
- mobile Carousels
- responsive Slider
Licenc: MIT Licenc
A használt Swiper verzió az MIT licenc figyelembevételével kereskedelmi és tulajdonosi projektekben is használható és terjeszthető.
WOW.js 1.2.1
A WOW.js-t arra használják, hogy elemeket jelenítse meg weboldalon való görgetés közben, illetve CSS animációkat indítson el.
Használt verzió:
WOW.js 1.2.1A bluetronix-en belül használt verzió tartalmazza a következő licencnyilatkozatot:
WOW wow.js - v1.2.1
Copyright (c) 2016 Thomas Grainger
Licensed MITLicenc: MIT Licenc
Fontos: A bluetronix számára Thomas Grainger által fenntartott MIT licenc alapján engedélyezett WOW.js változatot használják.
Ez a verzió az MIT licenc figyelembevételével kereskedelmi és tulajdonosi projektekben is használható.
LightGallery 1.6.2
Licencellenőrzés: Az, hogy a LightGallery szerepel ebben az áttekintésben, nem jelenti azt, hogy már létezik kereskedelmi licenc a konkrét bluetronix disztribúcióra. A tulajdonosi terjesztés előtt tisztázni és dokumentálni kell a ténylegesen használt verzió jogi alapját.
A LightGallery a rendszerben képalbumok és videógalériák, valamint Lightbox megjelenítésekhez használatos.
Használt verzió:
LightGallery 1.6.2
2017-10-03A használt fájl tartalmazza a következő licencnyilatkozatot:
Lightgallery
Author: Sachin N
License: GPLv3
Version: 1.6.2 - 2017-10-03Licenc: GNU General Public License Version 3 (GPLv3)
Fontos: A LightGallery más licenc feltételekkel rendelkezik, mint a többi itt felsorolt MIT könyvtár.
A LightGallery projekt megkülönbözteti a következőket:
Open-Source-Nutzung
→ GPLv3
Proprietäre / kommerzielle Anwendung
→ Commercial LicenseA bluetronix saját terjesztésében történő használathoz érvényes kereskedelmi LightGallery licenc szükséges.
Alternatív megoldásként a használatnak teljes mértékben összhangban kell lennie a GPLv3 feltételeivel.
Ajánlás: Ha a bluetronix saját terjesztéssel jut el a vásárlókhoz, a LightGallery-t egy megfelelő Kereskedelmi Licenc keretein belül kell használni, vagy egy, a saját terjesztéshez illő licenccel rendelkező könyvtárral fel kell váltani.
Tárolási helyek
A könyvtár fájlok a fájltípusuktól függően kerülnek mentésre a bluetronix rendszer mappáiba.
| Fájltípus | Mappa |
|---|---|
| CSS | /bx_style/ |
| JavaScript | /bx_script/ |
Olyan könyvtárak, mint az Owl Carousel, Swiper vagy LightGallery és CSS, és JavaScript fájlokat is tartalmazhatnak, ezért mindkét rendszerterületben képviseltethetik magukat.
Frissítések
A következő helyen:
/bx_style/
/bx_script/meglevő alapértelmezett fájlokat a bluetronix frissítési rendszer kezeli.
Egy CMS frissítés során ezek a fájlok a bluetronix által biztosított újabb verziókkal helyettesíthetők.
Ezért a következő frissítések is kiadhatók:
- Sicherheitsupdates
- Fehlerkorrekturen
- Browser-Kompatibilitätsanpassungen
- neue Bibliotheksversionen
Fontos: Egy harmadik féltől származó könyvtár verziófrissítésekor ellenőrizni kell, hogy a licencfeltételeik megváltoztak-e.
Standard fájlokat közvetlenül ne módosítsd
A bluetronix által biztosított alapértelmezett fájlokat közvetlenül nem szabad módosítani.
A közvetlen módosítások egy jövőbeli rendszerfrissítés során felülírhatók.
Az egyéni bővítések esetében a következőt kell figyelembe venni:
Standarddatei
→ unverändert lassen
Eigene Erweiterung
→ eigene Datei oder _own-Datei verwendenLicencértesítések megszerzése
A harmadik féltől származó fájlokban található szerzői jogi és licencformulák nem távolíthatók el.
Például:
/*!
* Bootstrap ...
* Licensed under MIT
*/vagy:
/*! jQuery ...
* OpenJS Foundation ...
*/a biztosított fájlokban benne kell maradniuk.
Harmadik féltől származó licencek
Továbbá érdemes egy központi áttekintést biztosítani az összes használt harmadik féltől származó könyvtárról a bluetronix terjesztés keretein belül.
Például:
THIRD-PARTY-LICENSES.txtEnnek a fájlnak legalább a következő információkat kell tartalmaznia:
- Name der Bibliothek
- verwendete Version
- Urheber bzw. Projekt
- Lizenz
- Verweis auf die jeweilige Lizenz
Ajánlott tartalom a harmadik féltől származó licencek fájlban
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 NLicencellenőrzés frissítéseknél
Mivel a frontend könyvtárak a bluetronix frissítési rendszerén keresztül frissíthetők, mielőtt új verziót felvennénk, ellenőrizni kell:
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?Csak ezután lehet egy új verziót alapértelmezett könyvtárként átvenni a bx_style vagy bx_script rendszerében.
Licencáttekintés a jelenlegi bluetronix standard verzióra vonatkozóan
| Könyvtár | Verzió | Licenc | Proprietárius felhasználás |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Igen, a MIT-licenc betartásával |
| jQuery | 3.7.1 | MIT | Igen, a MIT-licenc betartásával |
| Owl Carousel | 2.3.4 | MIT | Igen, a MIT-licenc betartásával |
| Swiper | 8.4.6 | MIT | Igen, a MIT-licenc betartásával |
| WOW.js | 1.2.1 | MIT | Igen, a MIT-licenc betartásával |
| LightGallery | 1.6.2 | GPLv3 / Kereskedelmi | Kereskedelmi licencet használj a proprietárius terjesztéshez |
Összefoglalás
A bluetronix standard verzió a következő külső frontend könyvtárakat tartalmazza:
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.2A Bootstrap, jQuery, Owl Carousel, Swiper és a használt WOW.js verzió a MIT-licenc alatt áll.
A megfelelő szerzői jogi és licencértesítéseket meg kell őrizni.
A LightGallery 1.6.2 viszont GPLv3 alatt áll, vagy kereskedelmi licencet igényelhet proprietárius alkalmazásokhoz.
Ezért egy proprietárius bluetronix terjesztés esetén a következőket kell figyelembe venni:
Bootstrap
jQuery
Owl Carousel
Swiper
WOW.js
→ MIT-Lizenzbedingungen einhalten
LightGallery
→ gültige Commercial License verwenden
oder durch eine entsprechend lizenzierte Alternative ersetzenMinden jövőbeli frissítésnél egy harmadik féltől származó könyvtár esetében újra ellenőrizni kell a verziót és a licencet, mielőtt az új verziót a bluetronix frissítési rendszere szállítaná.
GYIK
Miket kérdeznek tőlünk gyakran az ügyfelek?
Mik azok az integrált frontend könyvtárak?
Ezek olyan külső CSS- és JavaScript-könyvtárak, amelyeket a bluetronix standard verzióban használnak elrendezésekhez, csúszkákhoz, galériákhoz és animációkhoz. Nem önálló CMS-modulok, mint a blog vagy a bolt.
Milyen frontend könyvtárakat említ ez a dokumentáció?
A sablon említi a Bootstrap CSS 5.3.3, jQuery 3.7.1, Owl Carousel 2.3.4, Swiper 8.4.6, WOW.js 1.2.1 és LightGallery 1.6.2 verziókat. A szállítás előtt ellenőrizd az összes telepített verziót a tényleges fájlokkal.
Tartalmazza a Bootstrap JavaScript-et a bluetronix standard rendszer?
Nem. A sablon szerint a Bootstrap 5.3.3 kizárólag CSS-ként használható; a bootstrap.js nem a standard verzió része.
Hol találhatók az alapértelmezett CSS- és JavaScript-fájlok?
A CSS-fájlok a /bx_style/ mappában, a JavaScript-fájlok a /bx_script/ mappában találhatók. A könyvtárak mindkét mappában tartalmazhatnak fájlokat.
Megváltoztathatom közvetlenül a rendszerfájlokat?
A bx_style és bx_script standard fájljait frissítések során felülírhatják. Saját bővítésekhez használj külön projektfájlokat vagy megfelelően megjelölt _own fájlokat.
A felsorolt könyvtárak közül melyek használják a MIT-licencet?
A sablon említi a Bootstrap CSS-t, jQuery-t, Owl Carousel-t, Swiper-t és a Thomas Grainger által továbbfejlesztett WOW.js változatot. Ellenőrizd a licenctudnivalókat a ténylegesen átadott fájlokban.
Mi a különlegesség a LightGallery 1.6.2-re vonatkozóan?
A dokumentált verzió GPLv3 vagy kereskedelmi licencet használ. A tulajdonosi terjesztés előtt ellenőrizni kell, hogy rendelkezésre áll-e megfelelő kereskedelmi licenc, vagy hogy a konkrét felhasználás teljesen GPLv3-kompatibilis.
Lehetséges a kereskedelmi felhasználás az MIT-licensz mellett?
Igen, ha betartják az MIT-licensz feltételeit. Különösen fontos, hogy a kötelező szerzői jogi és licenc figyelmeztetéseket a másolatokban, vagy azok lényeges részein megőrizzék.
Hogyan dokumentáljam a harmadik féltől származó licenceket?
Az előnyújtó egy központi fájlt ajánl THIRD-PARTY-LICENSES.txt. Ebben szerepelnie kell a névnek, verziónak, szerzőnek vagy projekthez, licencnek és egy hivatkozásnak a vonatkozó licenc szövegre.
Mit kell ellenőriznem egy könyvtárfrissítésnél?
Ellenőrizd a ténylegesen kiadott verziót, a licenc szövegét, a tervezett terjesztéssel való kompatibilitást és a licenc- vagy szerzői jogi figyelmeztetések kötelező továbbadását. Tudd meg, szükséges-e külön kereskedelmi licenc.
Megmaradnak a saját _own fájljaim a rendszerfrissítések során?
A _own konvenció arra szolgál, hogy a saját fájlokat elválassza a szabvány fájloktól. Ez megvédi az egyedi módosításokat attól, hogy a hagyományos rendszerfájlokkal együtt frissüljenek; a releváns biztonsági frissítések karbantartása és átvétele azonban a fejlesztő feladata.
A harmadik féltől származó könyvtárak ugyanazok, mint a CMS-modulok?
Nem. A frontend könyvtárak például CSS-elrendezéseket, csúszkákat vagy galéria funkciókat biztosítanak. A CMS-modulok, mint a blog, bolt, keresés és bejelentkezés, a bluetronix CMS külön alkalmazási funkciói.