Integroidut etupään kirjastot ja kolmannen osapuolen lisenssit
Tutustu bluetronixin standardiversion integroituun CSS- ja JavaScript-kirjastoihin. Opi, mitkä kolmannen osapuolen lisenssit on dokumentoitu, miten pidät standarditiedostot päivitettävinä ja mitkä lisenssitarkastukset ovat tarpeen ennen omistusoikeudellista jakelua.
Oppaan tavoite
Tämä dokumentaatio on suunnattu kehittäjille ja se selittää bluetronix standardiversion sisäänrakennetut frontend-kirjastot, niiden tallennuspaikat sekä mallissa dokumentoidut kolmannen osapuolen lisenssit.
Tärkeää: Ennen version toimittamista on tarkistettava, että mukana olevat tiedostot, niiden alkuperäiset lisenssitiedot ja mahdolliset kaupalliset lisenssivahvistukset ovat kunnossa. Täällä ilmoitetut versiotiedot perustuvat tähän dokumentaatio-malliin.
bluetronix CMS sisältää standardiversiossa erilaisia ulkoisia frontend-kirjastoja asettelua, JavaScript-toimintoja, liukusäätimiä, gallerioita ja animaatioita varten.
Nämä komponentit tunnetaan nimellä integroidut frontend-kirjastot ja ne ovat erillisiä varsinaisista bluetronix CMS -moduuleista, kuten blogista, kaupasta, hausta tai kirjautumisesta.
Asianmukaiset vakiotiedostot löytyvät tiedostotyypistä riippuen järjestelmäkohteista:
/bx_style/
/bx_script/Tärkeää: Hakemistot bx_style ja bx_script kuuluvat bluetronix-järjestelmään. Niissä olevat vakiotiedostot voidaan bluetronix CMS -päivityksen yhteydessä korvata tai ylittää päivitettyillä versioilla.
Omat muutokset ei tulisi tehdä suoraan näihin vakiotiedostoihin.
Yksilöllisiin mukautuksiin tulisi käyttää omia tiedostoja tai asianmukaisesti merkittyjä _own-tiedostoja.
Sisältyvät etupään kirjastot
| Kirjasto | Versio | Lisenssi | Käyttö |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Reagointikykyiset asettelut ja CSS-komponentit |
| jQuery | 3.7.1 | MIT | JavaScript- ja DOM-toiminnot |
| Pöllö Karuselli | 2.3.4 | MIT | Liukusäätimet ja Karusellit |
| Swiper | 8.4.6 | MIT | Kosketusliukusäätimet ja responsiiviset Karusellit |
| WOW.js | 1.2.1 | MIT | Sivun vieritykset ja esiin ilmestyvät animaatiot |
| LightGallery | 1.6.2 | GPLv3 / Kaupallinen lisenssi | Kuva- ja videot galleriat / Lightbox |
Bootstrap 5.3.3 CSS
Bootstrap tarjoaa responsiivisen CSS-perusrakenteen bluetronixin standardiversiolle.
Käytetään:
Bootstrap 5.3.3 CSSHuom: Bootstrapin JavaScript-versio (bootstrap.js) ei ole osa bluetronixin standardiversiota.
Bootstrap tarjoaa muun muassa seuraavat CSS-toiminnot:
- Grid-System
- responsive Breakpoints
- Container
- Spacing-Klassen
- Typografie
- Buttons
- Formular-Styles
- Utility-Klassen
Lisenssi: MIT-lisenssi
Bootstrap-koodia voidaan käyttää, muuttaa ja jakaa kaupallisissa ja yksityisissä projekteissa MIT-lisenssin ehtojen mukaisesti.
Tekijänoikeus- ja lisenssihavainnot on säilytettävä ohjelmiston kopioissa tai olennaisissa osissa.
jQuery 3.7.1
jQuery:tä käytetään erilaisissa JavaScript- ja DOM-toiminnoissa bluetronix CMS:ssä.
Käytetty versio:
jQuery 3.7.1Lisenssi: MIT-lisenssi
jQuery:tä voidaan käyttää ja jakaa kaupallisissa ja yksityisissä projekteissa MIT-lisenssin ehtojen mukaisesti.
Olemassa olevan tekijänoikeus- ja lisenssiviestin tulee pysyä toimitetussa jQuery-tiedostossa.
Owl Carousel 2.3.4
Owl Carouselia käytetään liukusäätimien ja karuselliesitysten toteuttamiseen.
Käytetty versio:
Owl Carousel 2.3.4Lisenssi: MIT-lisenssi
Owl Carouselia voidaan käyttää kaupallisissa ja omistusoikeudellisissa projekteissa MIT-lisenssin ehtojen mukaisesti.
Huom: Virallista Owl-Carousel-2 -projektia ei enää kehitetä aktiivisesti. Käytetyn version 2.3.4 MIT-lisenssi pysyy voimassa.
Swiper 8.4.6
Swiper on kosketus- ja liukusäät library responsiivisille verkkosivuille.
Käytetty versio:
Swiper 8.4.6Swiperia voidaan käyttää esimerkiksi seuraaviin toimintoihin:
- Bild-Slider
- Content-Slider
- Touch-Gesten
- mobile Carousels
- responsive Slider
Lisenssi: MIT-lisenssi
Käytettyä Swiper-versiota voidaan käyttää ja jakaa kaupallisissa ja omistusoikeudellisissa projekteissa MIT-lisenssin ehtojen mukaisesti.
WOW.js 1.2.1
WOW.js:tä käytetään elementtien näyttämiseen vierittämällä verkkosivua tai CSS-animaatioiden laukaisemiseen.
Käytetty versio:
WOW.js 1.2.1Bluetronixissa käytetty versio sisältää seuraavan lisenssiviestin:
WOW wow.js - v1.2.1
Copyright (c) 2016 Thomas Grainger
Licensed MITLisenssi: MIT-lisenssi
Tärkeää: Bluetronixissa käytetään Thomas Graingerin jatkamaa MIT-lisensoitua versiota WOW.js:stä.
Tätä versiota voidaan käyttää kaupallisissa ja omistusoikeudellisissa projekteissa MIT-lisenssin ehtojen mukaisesti.
LightGallery 1.6.2
Lisenssintarkistus: LightGalleryn sisällyttäminen tähän näkymään ei tarkoita, että tietylle bluetronix-jakelulle olisi jo kaupallinen lisenssi olemassa. Ennen omistusoikeudellista toimitusta on selvitettävä ja dokumentoitava käytetyn version oikeudellinen perusta.
LightGalleryia käytetään järjestelmässä kuvaja video-gallerioiden ja lightbox-esitysten toteuttamiseen.
Käytetty versio:
LightGallery 1.6.2
2017-10-03Käytetty tiedosto sisältää seuraavan lisenssiviestin:
Lightgallery
Author: Sachin N
License: GPLv3
Version: 1.6.2 - 2017-10-03Lisenssi: GNU General Public License Version 3 (GPLv3)
Tärkeää: LightGallerylla on erilaiset lisenssiehdot kuin muilla tässä luetelluilla MIT-kirjastoilla.
LightGallery-projekti tekee eron:
Open-Source-Nutzung
→ GPLv3
Proprietäre / kommerzielle Anwendung
→ Commercial LicenseKaupallisessa bluetronix-jakelussa tulisi siten olla voimassa oleva kaupallinen LightGallery-lisenssi.
Vaihtoehtoisesti käyttö pitäisi olla täysin GPLv3:n ehtojen mukaista.
Suositus: Jos bluetronix toimitetaan omistusoikeudellisesti asiakkaille, LightGallerya tulisi käyttää joko vastaavalla kaupallisella lisenssillä tai korvata se kirjastolla, jolla on omistusoikeudelliseen jakeluun soveltuva lisenssi.
Tallennuspaikat
Kirjastotiedostot tallennetaan bluetronix-järjestelmän kansioihin tiedostotyypistään riippuen.
| Tiedostotyyppi | Hakemisto |
|---|---|
| CSS | /bx_style/ |
| JavaScript | /bx_script/ |
Kirjastot kuten Owl Carousel, Swiper tai LightGallery voivat sisältää sekä CSS- että JavaScript-tiedostoja ja siksi ne voivat esiintyä molemmilla järjestelmäalueilla.
Päivitykset
Sisällä:
/bx_style/
/bx_script/olevat oletustiedostot hallinnoi bluetronix-päivitysjärjestelmä.
CMS-päivityksen yhteydessä nämä tiedostot voidaan korvata uusilla bluetronixin määrittämillä versioilla.
Tämä mahdollistaa esimerkiksi seuraavien päivitysten toimittamisen:
- Sicherheitsupdates
- Fehlerkorrekturen
- Browser-Kompatibilitätsanpassungen
- neue Bibliotheksversionen
Tärkeää: Kolmannen osapuolen kirjaston versiopäivityksen yhteydessä on myös tarkistettava, ovatko sen lisenssiehdot muuttuneet.
Älä muokkaa vakiotiedostoja suoraan
Bluetronixista toimitettuja oletustiedostoja ei pitäisi muokata suoraan.
Suorat muutokset voidaan ohittaa tulevassa järjestelmäpäivityksessä.
Yksilöllisille laajennuksille pätee siis:
Standarddatei
→ unverändert lassen
Eigene Erweiterung
→ eigene Datei oder _own-Datei verwendenSaat lisenssiin liittyvät tiedot
Kolmannen osapuolen tiedostoissa olevia tekijänoikeus- ja lisenssihuomautuksia ei tulisi poistaa.
Esimerkiksi:
/*!
* Bootstrap ...
* Licensed under MIT
*/tai:
/*! jQuery ...
* OpenJS Foundation ...
*/tiedostoista saatu lisenssi- ja tekijänoikeusmerkintä tulee säilyttää.
Kolmannen osapuolen lisenssit
On myös suositeltavaa, että bluetronix-jakelussa on keskitetty katsaus kaikista käytetyistä kolmannen osapuolen kirjastoista.
Esimerkiksi:
THIRD-PARTY-LICENSES.txtTämän tiedoston tulisi sisältää vähintään seuraavat tiedot:
- Name der Bibliothek
- verwendete Version
- Urheber bzw. Projekt
- Lizenz
- Verweis auf die jeweilige Lizenz
Suositeltu kolmannen osapuolen lisenssitiedoston sisältö
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 NLisenssitarkistus päivityksissä
Koska etupään kirjastot voidaan päivittää bluetronix-päivitysjärjestelmän kautta, on ennen uuden version lisäämistä tarkistettava:
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?Vasta sen jälkeen uusi versio tulisi ottaa oletuskirjastona bx_style tai bx_script.
Lisenssikatsaus nykyiselle bluetronix standardiversiolle
| Kirjasto | Versio | Lisenssi | Liiketoiminnallinen käyttö |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Kyllä, MIT-lisenssiä noudattaen |
| jQuery | 3.7.1 | MIT | Kyllä, MIT-lisenssiä noudattaen |
| Pöllö Karuselli | 2.3.4 | MIT | Kyllä, MIT-lisenssiä noudattaen |
| Swiper | 8.4.6 | MIT | Kyllä, MIT-lisenssiä noudattaen |
| WOW.js | 1.2.1 | MIT | Kyllä, MIT-lisenssiä noudattaen |
| LightGallery | 1.6.2 | GPLv3 / Kaupallinen | Käytä kaupallista lisenssiä kaupalliseen jakeluun |
Yhteenveto
Bluetronixin perusversio sisältää seuraavat ulkoiset etupään kirjastot:
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 ja käytetty WOW.js-versio ovat MIT-lisenssin alaisia.
Asianmukaiset tekijänoikeus- ja lisenssihuomautukset on säilytettävä.
LightGallery 1.6.2 on GPLv3-lisenssillä tai voidaan lisensoida kaupallisella lisenssillä omistusoikeudellisiin sovelluksiin.
Omistusoikeudellisen bluetronix-jakelun tulisi siis olla seuraavanlainen:
Bootstrap
jQuery
Owl Carousel
Swiper
WOW.js
→ MIT-Lizenzbedingungen einhalten
LightGallery
→ gültige Commercial License verwenden
oder durch eine entsprechend lizenzierte Alternative ersetzenJokaisessa tulevassa kolmannen osapuolen kirjastopäivityksessä on tarkistettava versio ja lisenssi uudelleen ennen uuden version toimittamista bluetronix-päivitysjärjestelmän kautta.
UKK
mitä asiakkaat meiltä usein kysyvät
Mitä integroituja frontend-kirjastoja tarkoitetaan?
Ne ovat ulkoisia CSS- ja JavaScript-kirjastoja, joita käytetään bluetronix-standardi-versiossa asetteluissa, liukusäätimissä, gallerioissa ja animaatioissa. Ne eivät ole itsenäisiä CMS-moduleita kuten blogi tai kauppa.
Mitä frontend-kirjastoja tämä dokumentaatio mainitsee?
Mallissa mainitaan Bootstrap CSS 5.3.3, jQuery 3.7.1, Owl Carousel 2.3.4, Swiper 8.4.6, WOW.js 1.2.1 ja LightGallery 1.6.2. Ennen toimittamista sinun tulee varmistaa asennetut versiot vastaavat todellisia tiedostoja.
Onko Bootstrap-JavaScript bluetronix-standardijärjestelmässä mukana?
Ei. Mallin mukaan Bootstrap 5.3.3:ta käytetään vain CSS:nä; bootstrap.js ei ole osa standardiversiota.
Missä oletetaan olevan oletusarvoisesti mukana CSS- ja JavaScript-tiedostot?
CSS-tiedostot sijaitsevat /bx_style/-hakemistossa ja JavaScript-tiedostot /bx_script/-hakemistossa. Kirjastot voivat sisältää tiedostoja molemmissa hakemistoissa.
Saanko muuttaa järjestelmätiedostoja suoraan?
Oletustiedostot bx_style- ja bx_script-hakemistoissa voidaan ylikirjoittaa päivityksissä. Käytä omille laajennuksille erillisiä projektitiedostoja tai asianmukaisesti merkittyjä _own-tiedostoja.
Mitkä luetelluista kirjastoista käyttävät MIT-lisenssiä?
Mallissa mainitaan Bootstrap CSS, jQuery, Owl Carousel, Swiper ja Thomas Graingerin ylläpitämä versio WOW.js:stä. Tarkista lisätiedot todellisesti toimitetuista tiedostoista.
Mikä erityisyys koskee LightGallery 1.6.2:ta?
Dokumentoitu versio käyttää GPLv3 tai kaupallista lisenssiä. Omistusoikeudellisen jakelun osalta on tarkistettava, onko käytettävissä asianmukainen kaupallinen lisenssi tai onko konkreettinen käyttö täysin GPLv3-yhteensopivaa.
Onko kaupallinen käyttö mahdollista MIT-lisenssillä?
Kyllä, jos MIT-lisenssin ehtoja noudatetaan. Tähän kuuluu erityisesti vaatimusten mukaan tekijänoikeus- ja lisenssitiedotteiden säilyttäminen kopioissa tai olennaisissa osissa.
Miten dokumentoin kolmannen osapuolen lisenssit?
Malli suosittelee keskitettyä tiedostoa THIRD-PARTY-LICENSES.txt. Siinä tulisi olla nimi, versio, tekijä tai projekti, lisenssi ja viittaus asianmukaiseen lisenssitekstiin.
Mitä minun on tarkistettava kirjastopäivityksessä?
Tarkista todellisesti toimitettu versio, sen lisenssitieto, yhteensopivuus tarkoitettuun jakeluun ja velvollisuus jakaa lisenssi- tai tekijänoikeustiedot. Selvitettävä, tarvitaanko erillistä kaupallista lisenssiä.
Säilyvätkö itse luodut _own-tiedostot järjestelmäpäivityksissä?
_own-konventio on kehitetty erottamaan omat tiedostot oletustiedostoista. Tämä suojaa yksittäisiä muutoksia siitä, että niitä päivitetään kuten säännöllisiä järjestelmätiedostoja; kuitenkin olennaisten turvallisuuspäivitysten hoitaminen ja käsittely jää kehittäjän vastuulle.
Onko kolmannen osapuolen kirjasto sama asia kuin CMS-moduulit?
Ei. Frontend-kirjastot tarjoavat esimerkiksi CSS-asetteluja, liukuportteja tai galleriaominaisuuksia. CMS-moduulit, kuten blogi, kauppa, haku ja kirjautuminen, ovat erillisiä sovellustoimintoja bluetronix CMS:ssä.