Librerie frontend integrate e licenze di terze parti
Scopri le librerie CSS e JavaScript integrate nella versione standard di bluetronix. Scopri quali licenze di terze parti sono documentate, come mantenere i file standard aggiornabili e quali controlli di licenza sono necessari prima di una distribuzione proprietaria.
Obiettivo del tutorial
Questa documentazione è destinata agli sviluppatori e spiega le librerie front-end integrate della versione standard bluetronix, i loro percorsi di archiviazione e le licenze di terze parti documentate nel modello.
Importante: Prima della consegna di una versione, devono essere verificati i file effettivamente contenuti, i loro avvisi di licenza originali e, se presenti, le prove di licenza commerciale. Le versioni citate qui provengono da questo modello di documentazione.
Il CMS bluetronix include nella versione standard varie librerie front-end esterne per layout, funzionalità JavaScript, slider, gallerie e animazioni.
Questi componenti sono denominati librerie front-end integrate e si distinguono dai moduli del CMS bluetronix come Blog, Negozio, Ricerca o Login.
I relativi file standard si trovano in base al tipo di file all'interno delle directory di sistema:
/bx_style/
/bx_script/Importante: Le directory bx_style e bx_script appartengono al sistema bluetronix. I file standard in esse contenuti possono essere sostituiti o sovrascritti da versioni aggiornate durante un aggiornamento del CMS bluetronix.
Pertanto, le modifiche personali non dovrebbero essere effettuate direttamente all'interno di questi file standard.
Per personalizzazioni personalizzate, dovrebbero essere utilizzati file propri o file _own opportunamente contrassegnati.
Librerie frontend incluse
| Biblioteca | Versione | Licenza | $SMTPType |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Layout reattivi e componenti CSS |
| jQuery | 3.7.1 | MIT | Funzioni JavaScript e DOM |
| Owl Carousel | 2.3.4 | MIT | Slider e Carousels |
| Swiper | 8.4.6 | MIT | Touch-Slider e Carousels responsive |
| WOW.js | 1.2.1 | MIT | Animazioni di scorrimento e apparizione |
| LightGallery | 1.6.2 | GPLv3 / Licenza commerciale | Gallerie di immagini e video / Lightbox |
Bootstrap 5.3.3 CSS
Bootstrap fornisce la struttura CSS responsive della versione standard bluetronix.
Viene utilizzato:
Bootstrap 5.3.3 CSSNota: La versione JavaScript di Bootstrap (bootstrap.js) non è parte della versione standard bluetronix.
Bootstrap offre tra l'altro le seguenti funzionalità CSS:
- Grid-System
- responsive Breakpoints
- Container
- Spacing-Klassen
- Typografie
- Buttons
- Formular-Styles
- Utility-Klassen
Licenza: MIT License
Il codice Bootstrap può essere utilizzato, modificato e ridistribuito in progetti commerciali e proprietari, rispettando la licenza MIT.
Le note sul copyright e sulle licenze devono rimanere nelle copie o nelle parti sostanziali del software.
jQuery 3.7.1
jQuery viene utilizzato per diverse funzioni JavaScript e DOM all'interno del CMS bluetronix.
Versione utilizzata:
jQuery 3.7.1Licenza: MIT License
jQuery può essere utilizzato e distribuito anche all'interno di progetti commerciali e proprietari, rispettando la licenza MIT.
L'avviso di copyright e di licenza esistente deve rimanere all'interno del file jQuery fornito.
Owl Carousel 2.3.4
Owl Carousel viene utilizzato per rappresentazioni di slider e carousel.
Versione utilizzata:
Owl Carousel 2.3.4Licenza: MIT License
Owl Carousel può essere utilizzato anche all'interno di progetti commerciali e proprietari, rispettando la licenza MIT.
Nota: Il progetto ufficiale Owl Carousel 2 non è più attivamente sviluppato. La licenza MIT della versione utilizzata 2.3.4 rimane invariata.
Swiper 8.4.6
Swiper è una libreria touch e slider per siti web responsive.
Versione utilizzata:
Swiper 8.4.6Swiper può essere utilizzato, ad esempio, per le seguenti funzioni:
- Bild-Slider
- Content-Slider
- Touch-Gesten
- mobile Carousels
- responsive Slider
Licenza: MIT License
La versione di Swiper utilizzata può essere utilizzata e distribuita all'interno di progetti commerciali e proprietari, rispettando la licenza MIT.
WOW.js 1.2.1
WOW.js viene utilizzato per far apparire elementi durante lo scroll di una pagina web o per attivare animazioni CSS.
Versione utilizzata:
WOW.js 1.2.1La versione utilizzata in bluetronix contiene il seguente avviso di licenza:
WOW wow.js - v1.2.1
Copyright (c) 2016 Thomas Grainger
Licensed MITLicenza: MIT License
Importante: Per bluetronix viene utilizzata la variante di WOW.js con licenza MIT gestita da Thomas Grainger.
Questa versione può essere utilizzata anche all'interno di progetti commerciali e proprietari, rispettando la licenza MIT.
LightGallery 1.6.2
Verifica della licenza: L'inclusione di LightGallery in questa panoramica non implica che sia già presente una licenza commerciale per la specifica distribuzione bluetronix. Prima di una distribuzione proprietaria, la base legale della versione effettivamente utilizzata deve essere chiarita e documentata.
LightGallery viene utilizzato all'interno del sistema per gallerie di immagini e video e per rappresentazioni in lightbox.
Versione utilizzata:
LightGallery 1.6.2
2017-10-03Il file utilizzato contiene il seguente avviso di licenza:
Lightgallery
Author: Sachin N
License: GPLv3
Version: 1.6.2 - 2017-10-03Licenza: GNU General Public License Versione 3 (GPLv3)
Importante: LightGallery ha condizioni di licenza diverse rispetto alle altre librerie MIT qui elencate.
Il progetto LightGallery distingue tra:
Open-Source-Nutzung
→ GPLv3
Proprietäre / kommerzielle Anwendung
→ Commercial LicensePer l'uso all'interno di una distribuzione proprietaria bluetronix, quindi, dovrebbe essere presente una licenza LightGallery commerciale valida.
In alternativa, l'uso deve essere completamente compatibile con i termini della GPLv3.
Raccomandazione: Se bluetronix viene fornito in modo proprietario ai clienti, LightGallery dovrebbe essere utilizzato con una licenza commerciale adeguata o sostituito con una libreria con una licenza adatta per la distribuzione proprietaria.
Percorsi di archiviazione
I file della libreria vengono memorizzati all'interno delle cartelle del sistema bluetronix a seconda del loro tipo di file.
| Tipo di file | Directory |
|---|---|
| CSS | /bx_style/ |
| JavaScript | /bx_script/ |
Le librerie come Owl Carousel, Swiper o LightGallery possono contenere file CSS e JavaScript e quindi possono essere presenti in entrambe le aree di sistema.
Aggiornamenti
All'interno di:
/bx_style/
/bx_script/i file standard presenti sono gestiti dal sistema di aggiornamento bluetronix.
Durante un aggiornamento del CMS, questi file possono essere sostituiti da versioni più recenti fornite da bluetronix.
Di conseguenza, possono essere forniti aggiornamenti come i seguenti:
- Sicherheitsupdates
- Fehlerkorrekturen
- Browser-Kompatibilitätsanpassungen
- neue Bibliotheksversionen
Importante: Nel caso di un aggiornamento di versione di una libreria di terze parti, è necessario verificare anche se le condizioni di licenza sono cambiate.
Non modificare i file standard direttamente
I file standard forniti da bluetronix non dovrebbero essere modificati direttamente.
Modifiche dirette possono essere sovrascritte in un futuro aggiornamento del sistema.
Per le estensioni personalizzate vale quindi:
Standarddatei
→ unverändert lassen
Eigene Erweiterung
→ eigene Datei oder _own-Datei verwendenRicevere avvisi di licenza
Le avvertenze di copyright e licenza presenti nei file di terze parti non dovrebbero essere rimosse.
Ad esempio:
/*!
* Bootstrap ...
* Licensed under MIT
*/oppure:
/*! jQuery ...
* OpenJS Foundation ...
*/dovrebbero rimanere all'interno dei file forniti.
Licenze di terze parti
Inoltre, è consigliabile fornire una panoramica centrale di tutte le librerie di terze parti utilizzate all'interno della distribuzione bluetronix.
Per esempio:
THIRD-PARTY-LICENSES.txtQuesto file dovrebbe contenere almeno le seguenti informazioni:
- Name der Bibliothek
- verwendete Version
- Urheber bzw. Projekt
- Lizenz
- Verweis auf die jeweilige Lizenz
Contenuto consigliato del file delle licenze di terze parti
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 NVerifica della licenza durante gli aggiornamenti
Poiché le librerie frontend possono essere aggiornate tramite il sistema di aggiornamento bluetronix, è necessario verificare prima di aggiungere una nuova versione:
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?Solo dopo, una nuova versione dovrebbe essere adottata come libreria standard in bx_style o bx_script.
Panoramica delle licenze per la versione standard bluetronix attuale
| Biblioteca | Versione | Licenza | Utilizzo proprietario |
|---|---|---|---|
| Bootstrap CSS | 5.3.3 | MIT | Sì, nel rispetto della licenza MIT |
| jQuery | 3.7.1 | MIT | Sì, nel rispetto della licenza MIT |
| Owl Carousel | 2.3.4 | MIT | Sì, nel rispetto della licenza MIT |
| Swiper | 8.4.6 | MIT | Sì, nel rispetto della licenza MIT |
| WOW.js | 1.2.1 | MIT | Sì, nel rispetto della licenza MIT |
| LightGallery | 1.6.2 | GPLv3 / Commerciale | Per distribuzione proprietaria utilizzare la licenza commerciale |
Riepilogo
La versione standard bluetronix contiene le seguenti librerie frontend esterne:
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 e la versione di WOW.js utilizzata sono sotto licenza MIT.
Le relative note di copyright e licenza devono rimanere inalterate.
LightGallery 1.6.2 è sotto GPLv3 oppure può essere licenziato tramite una licenza commerciale per applicazioni proprietarie.
Pertanto, per una distribuzione proprietaria di bluetronix dovrebbero valere:
Bootstrap
jQuery
Owl Carousel
Swiper
WOW.js
→ MIT-Lizenzbedingungen einhalten
LightGallery
→ gültige Commercial License verwenden
oder durch eine entsprechend lizenzierte Alternative ersetzenAd ogni aggiornamento futuro di una libreria di terze parti, devono essere nuovamente verificate la versione e la licenza, prima che la nuova versione venga distribuita tramite il sistema di aggiornamento di bluetronix.
FAQ
cosa ci chiedono spesso i clienti
Cosa sono le librerie frontend integrate?
Sono librerie CSS e JavaScript esterne utilizzate nella versione standard di bluetronix per layout, slider, gallerie e animazioni. Non sono moduli CMS autonomi come blog o negozi.
Quali librerie frontend menziona questa documentazione?
Il modello menziona Bootstrap CSS 5.3.3, jQuery 3.7.1, Owl Carousel 2.3.4, Swiper 8.4.6, WOW.js 1.2.1 e LightGallery 1.6.2. Prima della distribuzione, dovresti confrontare le versioni installate con i file reali.
È incluso JavaScript di Bootstrap nel sistema standard bluetronix?
No. Secondo il modello, Bootstrap 5.3.3 viene utilizzato esclusivamente come CSS; bootstrap.js non è parte della versione standard.
Dove si trovano i file CSS e JavaScript inclusi di default?
I file CSS si trovano in /bx_style/ e i file JavaScript in /bx_script/. Le librerie possono possedere file in entrambe le directory.
Posso modificare direttamente i file di sistema?
I file standard in bx_style e bx_script possono essere sovrascritti durante gli aggiornamenti. Usa file di progetto separati o file contrassegnati con _own per le tue estensioni.
Quali delle librerie elencate utilizzano la licenza MIT?
Il modello menziona Bootstrap CSS, jQuery, Owl Carousel, Swiper e la variante di WOW.js mantenuta da Thomas Grainger. Controlla le note di licenza nei file effettivamente consegnati.
Qual è la particolarità di LightGallery 1.6.2?
La versione documentata utilizza GPLv3 o una licenza commerciale. Per una distribuzione proprietaria, è necessario verificare se è presente una licenza commerciale appropriata o se l'uso concreto è completamente conforme alla GPLv3.
È possibile un uso commerciale con la licenza MIT?
Sì, se vengono rispettate le condizioni della licenza MIT. Questo include, in particolare, la conservazione delle note di copyright e licenza richieste nelle copie o in parti significative.
Come documento le licenze delle terze parti?
Il modello raccomanda un file centrale THIRD-PARTY-LICENSES.txt. Dovrebbe contenere nome, versione, autore o progetto, licenza e un riferimento al testo della licenza associato.
Cosa devo controllare durante un aggiornamento della libreria?
Controlla la versione effettivamente consegnata, il suo testo di licenza, la compatibilità con la distribuzione prevista e l'obbligo di fornire note di licenza o copyright. Chiarisci se è necessaria una licenza commerciale separata.
I file _own creati rimangono intatti durante gli aggiornamenti di sistema?
La convenzione _own serve a separare i file personalizzati dai file standard. Questo protegge le modifiche individuali dall'essere aggiornate come i normali file di sistema; tuttavia, la manutenzione e l'applicazione degli aggiornamenti di sicurezza pertinenti rimangono compito dello sviluppatore.
Le librerie di terze parti sono le stesse dei moduli CMS?
No. Le librerie frontend forniscono ad esempio layout CSS, slider o funzioni di galleria. I moduli CMS come blog, shop, ricerca e login sono funzioni applicative separate del CMS bluetronix.