Zintegrowane biblioteki frontendowe i licencje osób trzecich
Poznaj zintegrowane biblioteki CSS i JavaScript standardowej wersji bluetronix. Dowiedz się, które licencje osób trzecich są udokumentowane, jak utrzymać standardowe pliki w stanie aktualizacji i jakie kontrole licencyjne są wymagane przed wydaniem dla majątku.
Cel samouczka
Ta dokumentacja jest skierowana do programistów i wyjaśnia zintegrowane biblioteki front-endowe wersji standardowej bluetronix, ich lokalizacje oraz dokumentowane w szablonie licencje osób trzecich.
Waźne: Przed wydaniem wersji należy sprawdzić faktycznie zawarte pliki, ich oryginalne informacje o licencji oraz, jeśli to konieczne, istniejące dowody licencji komercyjnej. Podane tutaj informacje o wersji pochodzą z tego szablonu dokumentacyjnego.
System bluetronix CMS w wersji standardowej zawiera różne zewnętrzne biblioteki front-endowe do układów, funkcji JavaScript, suwaków, galerii i animacji.
Te komponenty są nazywane zintegrowanymi bibliotekami front-endowymi i różnią się od rzeczywistych modułów bluetronix CMS, takich jak Blog, Sklep, Wyszukiwarka czy Zaloguj.
Odpowiednie pliki standardowe znajdują się w zależności od rodzaju pliku w katalogach systemowych:
/bx_style/
/bx_script/Waźne: Katalogi bx_style i bx_script należą do systemu bluetronix. Pliki standardowe zawarte w nich mogą zostać zastąpione lub nadpisane przez zaktualizowane wersje w przypadku aktualizacji bluetronix CMS.
Własne zmiany nie powinny być wprowadzane bezpośrednio w tych plikach standardowych.
Do indywidualnych dostosowań należy używać własnych plików lub odpowiednio oznaczonych plików _own.
Zawarte biblioteki frontendowe
| Biblioteka | Wersja | Licencja | Zastosowanie |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Responsywne układy i komponenty CSS |
| jQuery | 3.7.1 | MIT | Funkcje JavaScript i DOM |
| Owl Carousel | 2.3.4 | MIT | Suwaki i karuzele |
| Swiper | 8.4.6 | MIT | Suwaki dotykowe i responsywne karuzele |
| WOW.js | 1.2.1 | MIT | Animacje przewijania i wprowadzania |
| LightGallery | 1.6.2 | GPLv3 / Licencja komercyjna | Galerie obrazów i wideo / Lightbox |
Bootstrap 5.3.3 CSS
Bootstrap zapewnia responsywny fundament CSS dla standardowej wersji bluetronix.
Używana wersja:
Bootstrap 5.3.3 CSSUwaga: Wersja JavaScript Bootstrap (bootstrap.js) nie jest częścią standardowej wersji bluetronix.
Bootstrap oferuje między innymi następujące funkcje CSS:
- Grid-System
- responsive Breakpoints
- Container
- Spacing-Klassen
- Typografie
- Buttons
- Formular-Styles
- Utility-Klassen
Licencja: MIT License
Kod Bootstrap może być używany, modyfikowany i rozpowszechniany w projektach komercyjnych i własnościowych zgodnie z licencją MIT.
Informacje o prawach autorskich i licencji muszą pozostać w kopiach lub istotnych częściach oprogramowania.
jQuery 3.7.1
jQuery jest używane do różnych funkcji JavaScript i DOM w CMS bluetronix.
Używana wersja:
jQuery 3.7.1Licencja: MIT License
jQuery może być używane i rozpowszechniane w projektach komercyjnych i własnościowych zgodnie z licencją MIT.
Zachowana informacja o prawach autorskich i licencji powinna pozostać w dostarczonym pliku jQuery.
Owl Carousel 2.3.4
Owl Carousel jest używany do wyświetlania sliderów i karuzel.
Używana wersja:
Owl Carousel 2.3.4Licencja: MIT License
Owl Carousel może być również stosowany w projektach komercyjnych i zastrzeżonych zgodnie z licencją MIT.
Uwaga: Oficjalny projekt Owl-Carousel-2 nie jest już aktywnie rozwijany. Licencja MIT stosowanej wersji 2.3.4 pozostaje nietknięta.
Swiper 8.4.6
Swiper to biblioteka dotykowa i slider dla responsywnych stron internetowych.
Używana wersja:
Swiper 8.4.6Swiper można na przykład wykorzystać do następujących funkcji:
- Bild-Slider
- Content-Slider
- Touch-Gesten
- mobile Carousels
- responsive Slider
Licencja: MIT License
Wykorzystywana wersja Swiper może być używana i rozpowszechniana w projektach komercyjnych i zastrzeżonych zgodnie z licencją MIT.
WOW.js 1.2.1
WOW.js jest używany do wprowadzania elementów na stronę podczas przewijania lub uruchamiania animacji CSS.
Używana wersja:
WOW.js 1.2.1Stosowana w bluetronix wersja zawiera następujący informacyjny zapis licencyjny:
WOW wow.js - v1.2.1
Copyright (c) 2016 Thomas Grainger
Licensed MITLicencja: MIT License
Ważne: Dla bluetronix wykorzystywana jest wersja WOW.js, prowadzonej przez Thomasa Graingera, licencjonowana na podstawie MIT.
Ta wersja może być również stosowana w projektach komercyjnych i zastrzeżonych zgodnie z licencją MIT.
LightGallery 1.6.2
Weryfikacja licencji: Ujęcie LightGallery w tej przeglądzie nie oznacza, że już istnieje licencja komercyjna dla konkretnej dystrybucji bluetronix. Przed wydaniem zastrzeżonym należy wyjaśnić i udokumentować podstawy prawne stosowanej wersji.
LightGallery jest używany w systemie do galerii zdjęć i wideo oraz wyświetlania w trybie lightbox.
Używana wersja:
LightGallery 1.6.2
2017-10-03Stosowany plik zawiera następujący informacyjny zapis licencyjny:
Lightgallery
Author: Sachin N
License: GPLv3
Version: 1.6.2 - 2017-10-03Licencja: GNU General Public License wersja 3 (GPLv3)
Ważne: LightGallery ma inne warunki licencyjne niż pozostałe wymienione biblioteki MIT.
Projekt LightGallery rozróżnia:
Open-Source-Nutzung
→ GPLv3
Proprietäre / kommerzielle Anwendung
→ Commercial LicenseDlatego do użycia w dystrybucji zastrzeżonej bluetronix powinna być dostępna ważna komercyjna licencja LightGallery.
Alternatywnie wykorzystanie musi być całkowicie zgodne z warunkami GPLv3.
Rekomendacja: Jeśli bluetronix jest dostarczany komercyjnie klientom, LightGallery powinien być używany albo na podstawie odpowiedniej licencji komercyjnej, albo zastąpiony biblioteką z licencją odpowiednią do dystrybucji zastrzeżonej.
Lokalizacje
Pliki biblioteki są przechowywane w zależności od ich typu pliku w folderach systemowych bluetronix.
| Typ pliku | Katalog |
|---|---|
| CSS | /bx_style/ |
| JavaScript | /bx_script/ |
Biblioteki takie jak Owl Carousel, Swiper czy LightGallery mogą posiadać zarówno pliki CSS, jak i JavaScript, dlatego mogą być obecne w obu obszarach systemowych.
Aktualizacje
W ramach:
/bx_style/
/bx_script/dostępne pliki standardowe są zarządzane przez system aktualizacji bluetronix.
Podczas aktualizacji CMS te pliki mogą zostać zastąpione nowszymi wersjami przewidzianymi przez bluetronix.
Dzięki temu mogą być dostarczane na przykład następujące aktualizacje:
- Sicherheitsupdates
- Fehlerkorrekturen
- Browser-Kompatibilitätsanpassungen
- neue Bibliotheksversionen
Ważne: Przy aktualizacji wersji biblioteki zewnętrznego dostawcy należy dodatkowo sprawdzić, czy zmieniły się jej warunki licencyjne.
Nie zmieniać plików standardowych bezpośrednio
Dostarczone przez bluetronix pliki standardowe nie powinny być zmieniane bezpośrednio.
Bezpośrednie zmiany mogą zostać nadpisane podczas przyszłej aktualizacji systemu.
Dlatego dla indywidualnych rozszerzeń należy:
Standarddatei
→ unverändert lassen
Eigene Erweiterung
→ eigene Datei oder _own-Datei verwendenOtrzymywanie informacji o licencji
Zachować istniejące informacje o prawach autorskich i warunkach licencyjnych w plikach zewnętrznych.
Na przykład:
/*!
* Bootstrap ...
* Licensed under MIT
*/lub:
/*! jQuery ...
* OpenJS Foundation ...
*/powinny pozostać w dostarczonych plikach.
Licencje osób trzecich
Dodatkowo wskazane jest, aby w dystrybucji bluetronix przygotować centralny przegląd wszystkich używanych bibliotek zewnętrznych.
Na przykład:
THIRD-PARTY-LICENSES.txtTen plik powinien zawierać przynajmniej następujące informacje:
- Name der Bibliothek
- verwendete Version
- Urheber bzw. Projekt
- Lizenz
- Verweis auf die jeweilige Lizenz
Zalecana zawartość pliku licencji osób trzecich
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 NSprawdzenie licencji podczas aktualizacji
Ponieważ biblioteki frontendowe mogą być aktualizowane przez system aktualizacji bluetronix, przed dodaniem nowej wersji należy sprawdzić:
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?Dopiero potem nowa wersja powinna być przejęta jako biblioteka standardowa w bx_style lub bx_script.
Podsumowanie licencji dla aktualnej wersji standardowej bluetronix
| Biblioteka | Wersja | Licencja | Użytkowanie komercyjne |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Tak, przy przestrzeganiu licencji MIT |
| jQuery | 3.7.1 | MIT | Tak, przy przestrzeganiu licencji MIT |
| Owl Carousel | 2.3.4 | MIT | Tak, przy przestrzeganiu licencji MIT |
| Swiper | 8.4.6 | MIT | Tak, przy przestrzeganiu licencji MIT |
| WOW.js | 1.2.1 | MIT | Tak, przy przestrzeganiu licencji MIT |
| LightGallery | 1.6.2 | GPLv3 / Licencja komercyjna | Do dystrybucji komercyjnej użyj Licencji Komercyjnej |
Podsumowanie
Standardowa wersja bluetronix zawiera następujące zewnętrzne biblioteki frontendowe:
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.2Bootstrap, jQuery, Owl Carousel, Swiper i używana wersja WOW.js są objęte licencją MIT.
Konieczne jest zachowanie odpowiednich informacji o prawach autorskich i warunkach licencyjnych.
LightGallery 1.6.2 jest dostępny na licencji GPLv3 lub może być licencjonowany poprzez licencję komercyjną dla aplikacji zamkniętych.
Dla dystrybucji bluetronix opartej na licencji zamkniętej powinno obowiązywać:
Bootstrap
jQuery
Owl Carousel
Swiper
WOW.js
→ MIT-Lizenzbedingungen einhalten
LightGallery
→ gültige Commercial License verwenden
oder durch eine entsprechend lizenzierte Alternative ersetzenPrzy każdym przyszłym aktualizowaniu biblioteki zewnętrznej należy ponownie sprawdzić wersję i licencję przed dostarczeniem nowej wersji za pośrednictwem systemu aktualizacji bluetronix.
FAQ
co klienci często nas pytają
Czym są zintegrowane biblioteki frontendowe?
Są to zewnętrzne biblioteki CSS i JavaScript, które są stosowane w standardowej wersji bluetronix do układów, sliderów, galerii i animacji. Nie są to samodzielne moduły CMS, takie jak blog czy sklep.
Jakie biblioteki frontendowe wymienia ta dokumentacja?
Dokumentacja wymienia Bootstrap CSS 5.3.3, jQuery 3.7.1, Owl Carousel 2.3.4, Swiper 8.4.6, WOW.js 1.2.1 i LightGallery 1.6.2. Przed dostarczeniem powinieneś porównać zainstalowane wersje z rzeczywistymi plikami.
Czy JavaScript Bootstrap jest zawarty w standardowym systemie bluetronix?
Nie. Zgodnie z dokumentacją, Bootstrap 5.3.3 jest używany wyłącznie jako CSS; bootstrap.js nie jest częścią wersji standardowej.
Gdzie znajdują się standardowe pliki CSS i JavaScript?
Pliki CSS znajdują się w /bx_style/, a pliki JavaScript w /bx_script/. Biblioteki mogą mieć pliki w obu katalogach.
Czy mogę bezpośrednio modyfikować pliki systemowe?
Standardowe pliki w bx_style i bx_script mogą być zastępowane przy aktualizacjach. Użyj osobnych plików projektu lub odpowiednio oznaczonych plików _own dla własnych rozszerzeń.
Które z wymienionych bibliotek korzystają z licencji MIT?
Dokumentacja wymienia Bootstrap CSS, jQuery, Owl Carousel, Swiper oraz rozwijaną przez Thomasa Graingera wersję WOW.js. Sprawdź informacje o licencji w rzeczywiście dostarczonych plikach.
Jakie szczególne zasady obowiązują dla LightGallery 1.6.2?
Dokumentowana wersja korzysta z licencji GPLv3 lub licencji komercyjnej. Dla dystrybucji zamkniętej należy przed dostarczeniem sprawdzić, czy odpowiednia licencja komercyjna jest dostępna lub czy konkretne użycie jest całkowicie zgodne z GPLv3.
Czy możliwe jest komercyjne wykorzystanie z licencją MIT?
Tak, pod warunkiem, że przestrzegane są warunki licencji MIT. Należy szczególnie zachować wymagane informacje o prawach autorskich i licencji w kopiach lub istotnych częściach.
Jak dokumentuję licencje zewnętrznych dostawców?
Dokumentacja zaleca centralny plik THIRD-PARTY-LICENSES.txt. Powinny się w nim znajdować nazwa, wersja, autor lub projekt, licencja oraz odniesienie do odpowiedniego tekstu licencji.
Co muszę sprawdzić przy aktualizacji biblioteki?
Sprawdź rzeczywiście dostarczoną wersję, jej tekst licencji, kompatybilność z planowaną dystrybucją oraz obowiązek przekazywania informacji o licencji i prawach autorskich. Ustal, czy potrzebna jest osobna licencja komercyjna.
Czy samodzielnie utworzone pliki _own pozostaną przy aktualizacjach systemu?
Konwencja _own ma na celu oddzielenie własnych plików od plików standardowych. Chroni to indywidualne zmiany przed aktualizacją jak zwykłe pliki systemowe; jednak utrzymanie i przyjmowanie istotnych aktualizacji bezpieczeństwa pozostaje obowiązkiem dewelopera.
Czy biblioteki stron trzecich to to samo co moduły CMS?
Nie. Biblioteki frontendowe oferują na przykład układy CSS, suwaki czy funkcje galerii. Moduły CMS, takie jak blog, sklep, wyszukiwarka i logowanie, to oddzielne funkcje aplikacyjne CMS bluetronix.