Integrerede frontend-biblioteker og tredjepartslisenser
Lær om de integrerede CSS- og JavaScript-biblioteker i bluetronix standardversion. Find ud af, hvilke tredjepartslisenser der er dokumenteret, hvordan du holder standardfiler opdaterbare, og hvilke licenskontroller der er nødvendige før en proprietær udgivelse.
Mål med vejledningen
Denne dokumentation henvender sig til udviklere og forklarer de integrerede frontend-biblioteker i bluetronix standardversionen, deres lagringssteder og de dokumenterede tredjepartslicenser i skabelonen.
Vigtigt: Før levering af en version skal de faktisk inkluderede filer, deres oprindelige licensnotater og eventuelle kommercielle licensbeviser kontrolleres. Versionsoplysningerne her er fra denne dokumentationsskabelon.
Det bluetronix CMS indeholder i standardversionen forskellige eksterne frontend-biblioteker til layout, JavaScript-funktioner, slider, gallerier og animationer.
Disse komponenter betegnes som integrerede frontend-biblioteker og skal adskilles fra de egentlige bluetronix CMS-moduler som blog, shop, søgning eller login.
De relevante standardfiler findes afhængigt af filtypen inden for systemmapperne:
/bx_style/
/bx_script/
Vigtigt: Mapperne bx_style og bx_script tilhører bluetronix-systemet. De standardfiler, der er indeholdt deri, kan ved en bluetronix CMS-opdatering blive erstattet eller overskrevet af opdaterede versioner.
Egne ændringer bør derfor ikke foretages direkte inden for disse standardfiler.
Til individuelle tilpasninger bør egne filer eller passende markerede _own-filer anvendes.
Enhederede frontend-biblioteker
| Bibliotek | Version | Licens | Anvendelse |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Responsive layouts og CSS-komponenter |
| jQuery | 3.7.1 | MIT | JavaScript- og DOM-funktioner |
| Owl Carousel | 2.3.4 | MIT | Slider og Carousels |
| Swiper | 8.4.6 | MIT | Touch-Slider og responsive Carousels |
| WOW.js | 1.2.1 | MIT | Scroll- og fade-in animationer |
| LightGallery | 1.6.2 | GPLv3 / Kommerciel licens | Billede- og video-gallerier / Lightbox |
Bootstrap 5.3.3 CSS
Bootstrap leverer det responsive CSS-grundlag for bluetronix standardversionen.
Anvendes:
Bootstrap 5.3.3 CSS
Bemærk: JavaScript-versionen af Bootstrap (bootstrap.js) er ikke en del af bluetronix standardversionen.
Bootstrap tilbyder blandt andet følgende CSS-funktioner:
- Grid-System
- responsive Breakpoints
- Container
- Spacing-Klassen
- Typografie
- Buttons
- Formular-Styles
- Utility-Klassen
Licens: MIT License
Bootstrap-koden kan anvendes, ændres og distribueres inden for kommercielle og proprietære projekter i overensstemmelse med MIT-licensen.
Ophavsret- og licensnotifikationer skal forblive i kopier eller væsentlige dele af softwaren.
jQuery 3.7.1
jQuery anvendes til forskellige JavaScript- og DOM-funktioner inden for bluetronix CMS.
Anvendt version:
jQuery 3.7.1
Licens: MIT License
jQuery kan anvendes og distribueres inden for kommercielle og proprietære projekter i overensstemmelse med MIT-licensen.
Ophavsret- og licensnotatet skal forblive i den leverede jQuery-fil.
Owl Carousel 2.3.4
Owl Carousel bruges til slider- og carousel-visualiseringer.
Anvendt version:
Owl Carousel 2.3.4
Licens: MIT License
Owl Carousel må også anvendes i kommercielle og proprietære projekter i overensstemmelse med MIT-licensen.
Bemærk: Det officielle Owl-Carousel-2-projekt bliver ikke længere aktivt udviklet. MIT-licensen for den anvendte version 2.3.4 berøres ikke af dette.
Swiper 8.4.6
Swiper er et touch- og slider-bibliotek til responsive hjemmesider.
Anvendt version:
Swiper 8.4.6
Swiper kan for eksempel bruges til følgende funktioner:
- Bild-Slider
- Content-Slider
- Touch-Gesten
- mobile Carousels
- responsive Slider
Licens: MIT License
Den anvendte Swiper-version kan anvendes og distribueres i kommercielle og proprietære projekter i overensstemmelse med MIT-licensen.
WOW.js 1.2.1
WOW.js bruges til at vise elementer, når man scroller på en hjemmeside, eller til at udløse CSS-animationer.
Anvendt version:
WOW.js 1.2.1
Den version, der er brugt i bluetronix, indeholder følgende licensnotat:
WOW wow.js - v1.2.1
Copyright (c) 2016 Thomas Grainger
Licensed MIT
Licens: MIT License
Vigtigt: For bluetronix anvendes den MIT-licenserede version af WOW.js, som videreføres af Thomas Grainger.
Denne version kan også anvendes i kommercielle og proprietære projekter i overensstemmelse med MIT-licensen.
LightGallery 1.6.2
Licenskontrol: Inkluderingen af LightGallery i denne oversigt betyder ikke, at der allerede foreligger en kommerciel licens for den specifikke bluetronix-distribution. Den juridiske basis for den faktiske anvendte version skal afklares og dokumenteres, før en proprietær distribution.
LightGallery anvendes i systemet til billed- og video-gallerier samt lightbox-visualiseringer.
Anvendt version:
LightGallery 1.6.2
2017-10-03
Den anvendte fil indeholder følgende licensnotat:
Lightgallery
Author: Sachin N
License: GPLv3
Version: 1.6.2 - 2017-10-03
Licens: GNU General Public License Version 3 (GPLv3)
Vigtigt: LightGallery har andre licensvilkår end de øvrige MIT-biblioteker, der er nævnt her.
LightGallery-projektet differentierer mellem:
Open-Source-Nutzung
→ GPLv3
Proprietäre / kommerzielle Anwendung
→ Commercial License
For brugen i en proprietær bluetronix-distribution bør der derfor være en gyldig kommerciel LightGallery-licens.
Alternativt skal brugen være helt i overensstemmelse med GPLv3's vilkår.
Anbefaling: Hvis bluetronix leveres proprietært til kunder, bør LightGallery bruges med en passende kommerciel licens eller erstattes med et bibliotek med en licens, der er egnet til proprietær distribution.
Lagringssteder
Biblioteksfilerne gemmes afhængigt af deres filtype inden for bluetronix systemmapper.
| Filtype | Mappe |
|---|---|
| CSS | /bx_style/ |
| JavaScript | /bx_script/ |
Biblioteker som Owl Carousel, Swiper eller LightGallery kan have både CSS- og JavaScript-filer og kan derfor være til stede i begge systemområder.
Opdateringer
Inden for:
/bx_style/
/bx_script/
forefindes standardfilerne, der administreres af bluetronix opdateringssystem.
Ved en CMS-opdatering kan disse filer blive erstattet af nyere versioner, der er foreskrevet af bluetronix.
Dermed kan eksempelvis følgende opdateringer leveres:
- Sicherheitsupdates
- Fehlerkorrekturen
- Browser-Kompatibilitätsanpassungen
- neue Bibliotheksversionen
Vigtigt: Ved en versionsopdatering af en tredjepartsbibliotek skal det desuden kontrolleres, om deres licensbetingelser er ændret.
Ændre ikke standardfiler direkte
De standardfiler, der leveres af bluetronix, bør ikke ændres direkte.
Direkte ændringer kan blive overskrevet ved en fremtidig systemopdatering.
For individuelle udvidelser gælder derfor:
Standarddatei
→ unverändert lassen
Eigene Erweiterung
→ eigene Datei oder _own-Datei verwenden
Modtage licensnotater
De eksisterende copyright- og licenshenvisninger inden for tredjepartsfilerne bør ikke fjernes.
Eksempelvis:
/*!
* Bootstrap ...
* Licensed under MIT
*/
eller:
/*! jQuery ...
* OpenJS Foundation ...
*/
bør forblive inden for de leverede filer.
Tredjepartslicenser
Desuden anbefales det at give en central oversigt over alle anvendte tredjepartsbiblioteker inden for bluetronix-distributionen.
For eksempel:
THIRD-PARTY-LICENSES.txt
Denne fil skal indeholde mindst følgende oplysninger:
- Name der Bibliothek
- verwendete Version
- Urheber bzw. Projekt
- Lizenz
- Verweis auf die jeweilige Lizenz
Anbefalet indhold af Tredjepartslicensfilen
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
Licenskontrol ved opdateringer
Da frontend-bibliotekerne kan opdateres via bluetronix opdateringssystem, bør det kontrolleres før en ny version tilføjes:
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?
Først derefter bør en ny version tages som standardbibliotek i bx_style eller bx_script.
Licensoversigt for den aktuelle bluetronix standardversion
| Bibliotek | Version | Licens | Proprietær brug |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Ja, under overholdelse af MIT-licensen |
| jQuery | 3.7.1 | MIT | Ja, under overholdelse af MIT-licensen |
| Owl Carousel | 2.3.4 | MIT | Ja, under overholdelse af MIT-licensen |
| Swiper | 8.4.6 | MIT | Ja, under overholdelse af MIT-licensen |
| WOW.js | 1.2.1 | MIT | Ja, under overholdelse af MIT-licensen |
| LightGallery | 1.6.2 | GPLv3 / Kommerciel | Brug kommerciel licens til proprietær distribution |
Sammendrag
Den bluetronix-standardversion indeholder følgende eksterne frontend-biblioteker:
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 og den anvendte version af WOW.js er under MIT-licensen.
De respektive copyright- og licenshenvisninger skal bevares.
LightGallery 1.6.2 er under GPLv3 eller kan licenseres gennem en kommerciel licens til proprietære applikationer.
Derfor bør det gælde for en proprietær bluetronix distribution:
Bootstrap
jQuery
Owl Carousel
Swiper
WOW.js
→ MIT-Lizenzbedingungen einhalten
LightGallery
→ gültige Commercial License verwenden
oder durch eine entsprechend lizenzierte Alternative ersetzen
Ved hver fremtidig opdatering af et tredjepartsbibliotek skal version og licens kontrolleres igen, før den nye version distribueres gennem bluetronix opdateringssystem.
FAQ
hvad kunder ofte spørger os
Hvad er integrerede frontend-biblioteker?
Det er eksterne CSS- og JavaScript-biblioteker, der bruges i den danske bluetronix standardversion til layouts, sliders, gallerier og animationer. De er ikke selvstændige CMS-moduler som blog eller shop.
Hvilke frontend-biblioteker nævner denne dokumentation?
Skabelonen nævner Bootstrap CSS 5.3.3, jQuery 3.7.1, Owl Carousel 2.3.4, Swiper 8.4.6, WOW.js 1.2.1 og LightGallery 1.6.2. Før levering bør du kontrollere de installerede versioner mod de faktiske filer.
Er Bootstrap-JavaScript inkluderet i bluetronix standard-system?
Nej. Ifølge skabelonen bruges Bootstrap 5.3.3 kun som CSS; bootstrap.js er ikke en del af standardversionen.
Hvor ligger de standardindholdte CSS- og JavaScript-filer?
CSS-filer ligger under /bx_style/ og JavaScript-filer under /bx_script/. Biblioteker kan have filer i begge mapper.
Må jeg ændre systemfiler direkte?
Standardfiler i bx_style og bx_script kan blive overskrevet ved opdateringer. Brug separate projektfiler eller korrekt markerede _own-filer til egne udvidelser.
Hvilke af de nævnte biblioteker bruger MIT-licensen?
Skabelonen nævner Bootstrap CSS, jQuery, Owl Carousel, Swiper og den version af WOW.js, som Thomas Grainger har videreført. Tjek licensnoterne i de faktisk leverede filer.
Hvilken særskilt regel gælder for LightGallery 1.6.2?
Den dokumenterede version bruger GPLv3 eller en kommerciel licens. For en proprietær distribution skal det kontrolleres inden levering, om der er en passende kommerciel licens til rådighed, eller om den konkrete brug er helt GPLv3-kompatibel.
Er kommerciel brug med MIT-licensen mulig?
Ja, hvis betingelserne i MIT-licensen overholdes. Dette omfatter især, at de krævede copyright- og licensnotiser bevares i kopier eller væsentlige dele.
Hvordan dokumenterer jeg tredjepartslicenser?
Skabelonen anbefaler en centralt dokument THIRD-PARTY-LICENSES.txt. Der bør være navn, version, ophavsret eller projekt, licens og en henvisning til den tilhørende licenstekst.
Hvad skal jeg kontrollere ved en biblioteksopdatering?
Kontroller den faktisk leverede version, dens licenstekst, kompatibiliteten med den tilsigtede distribution og forpligtelsen til at videregive licens- eller copyrightnoter. Afklar om en separat kommerciel licens er nødvendig.
Forbliver selvoprettede _own-filer intakte ved systemopdateringer?
_own-konventionen tjener til at adskille egne filer fra standardfiler. Det beskytter individuelle ændringer mod at blive opdateret som regulære systemfiler; vedligeholdelse og overtagelse af relevante sikkerhedsopdateringer forbliver dog udviklerens ansvar.
Er tredjepartsbiblioteker det samme som CMS-moduler?
Nej. Frontend-biblioteker tilbyder f.eks. CSS-layouts, sliders eller galleri-funktioner. CMS-moduler som blog, shop, søgning og login er separate applikationsfunktioner i bluetronix CMS.