Bibliothèques frontend intégrées et licences tierces

Objectif du tutoriel

Cette documentation s'adresse aux développeurs et explique les bibliothèques frontend intégrées de la version standard de bluetronix, leurs emplacements et les licences tierces documentées dans le modèle.

Important : Avant la livraison d'une version, il est nécessaire de vérifier les fichiers réellement inclus, leurs avis de licence originaux et, le cas échéant, les preuves de licence commerciale existantes. Les spécifications de version énumérées ici proviennent de ce modèle de documentation.

Le CMS bluetronix inclut dans sa version standard plusieurs bibliothèques frontend externes pour la mise en page, les fonctions JavaScript, les sliders, les galeries et les animations.

Ces composants sont appelés bibliothèques frontend intégrées et se distinguent des modules CMS bluetronix tels que le blog, la boutique, la recherche ou la connexion.

Les fichiers standards correspondants se trouvent selon le type de fichier dans les répertoires système :

/bx_style/
/bx_script/

Important : Les répertoires bx_style et bx_script font partie du système bluetronix. Les fichiers standards qui y sont inclus peuvent être remplacés ou écrasés par des versions mises à jour lors d'une mise à jour du CMS bluetronix.

Les modifications personnelles ne doivent donc pas être effectuées directement dans ces fichiers standard.

Pour les ajustements individuels, des fichiers propres ou des fichiers marqués comme _own doivent être utilisés.

Bibliothèques frontend incluses

Bootstrap 5.3.3 CSS

Bootstrap fournit la structure CSS réactive de la version standard de bluetronix.

Utilisé :

Bootstrap 5.3.3 CSS

Remarque : La version JavaScript de Bootstrap (bootstrap.js) ne fait pas partie de la version standard de bluetronix.

Bootstrap fournit notamment les fonctions CSS suivantes :

• Grid-System
• responsive Breakpoints
• Container
• Spacing-Klassen
• Typografie
• Buttons
• Formular-Styles
• Utility-Klassen

Licence : MIT License

Le code Bootstrap peut être utilisé, modifié et distribué dans le cadre de projets commerciaux et propriétaires, sous réserve du respect de la licence MIT.

Les mentions de droits d'auteur et de licence doivent être conservées dans les copies et les parties essentielles du logiciel.

jQuery 3.7.1

jQuery est utilisé pour diverses fonctions JavaScript et DOM au sein du CMS bluetronix.

Version utilisée :

jQuery 3.7.1

Licence : MIT License

jQuery peut être utilisé et distribué dans le cadre de projets commerciaux et propriétaires, sous réserve du respect de la licence MIT.

La mention de droits d'auteur et de licence existante doit être conservée dans le fichier jQuery livré.

Owl Carousel 2.3.4

Owl Carousel est utilisé pour les affichages de sliders et de carrousels.

Version utilisée :

Owl Carousel 2.3.4

Licence : MIT License

Owl Carousel peut également être utilisé dans des projets commerciaux et propriétaires, sous réserve du respect de la licence MIT.

Remarque : Le projet officiel Owl-Carousel-2 n'est plus activement développé. La licence MIT de la version utilisée 2.3.4 reste inchangée.

Swiper 8.4.6

Swiper est une bibliothèque Touch et Slider pour les sites web réactifs.

Version utilisée :

Swiper 8.4.6

Swiper peut par exemple être utilisé pour les fonctions suivantes :

• Bild-Slider
• Content-Slider
• Touch-Gesten
• mobile Carousels
• responsive Slider

Licence : MIT License

La version de Swiper utilisée peut être utilisée et distribuée dans des projets commerciaux et propriétaires, sous réserve du respect de la licence MIT.

WOW.js 1.2.1

WOW.js est utilisé pour faire apparaître des éléments lors du défilement d'une page web ou pour déclencher des animations CSS.

Version utilisée :

WOW.js 1.2.1

La version utilisée dans bluetronix contient la mention de licence suivante :

WOW wow.js - v1.2.1
Copyright (c) 2016 Thomas Grainger
Licensed MIT

Licence : MIT License

Important : Pour bluetronix, la variante MIT licenciée de WOW.js maintenue par Thomas Grainger est utilisée.

Cette version peut également être utilisée dans des projets commerciaux et propriétaires, sous réserve du respect de la licence MIT.

LightGallery 1.6.2

Vérification de la licence : L'inclusion de LightGallery dans cet aperçu ne signifie pas qu'une licence commerciale pour la distribution spécifique de bluetronix est déjà en place. Avant une distribution propriétaire, il faut clarifier et documenter la base légale de la version réellement utilisée.

LightGallery est utilisé au sein du système pour les galeries d'images et de vidéos ainsi que pour les affichages en Lightbox.

Version utilisée :

LightGallery 1.6.2
2017-10-03

Le fichier utilisé contient la mention de licence suivante :

Lightgallery
Author: Sachin N
License: GPLv3
Version: 1.6.2 - 2017-10-03

Licence : GNU General Public License Version 3 (GPLv3)

Important : LightGallery a des conditions de licence différentes des autres bibliothèques MIT répertoriées ici.

Le projet LightGallery distingue entre :

Open-Source-Nutzung
→ GPLv3

Proprietäre / kommerzielle Anwendung
→ Commercial License

Pour une utilisation au sein d'une distribution propriétaire bluetronix, il est donc nécessaire de disposer d'une licence commerciale LightGallery valide.

Alternativement, l'utilisation doit être entièrement conforme aux conditions de la GPLv3.

Recommandation : Si bluetronix est livré de manière propriétaire aux clients, LightGallery doit être utilisé soit avec une licence commerciale appropriée, soit remplacé par une bibliothèque ayant une licence adaptée à une distribution propriétaire.

Emplacements de stockage

Les fichiers de bibliothèque sont stockés en fonction de leur type de fichier dans les dossiers système bluetronix.

Des bibliothèques comme Owl Carousel, Swiper ou LightGallery peuvent posséder à la fois des fichiers CSS et JavaScript et peuvent donc être présentes dans les deux domaines système.

Mises à jour

Ceux compris dans :

/bx_style/
/bx_script/

les fichiers standards sont gérés par le système de mise à jour bluetronix.

Lors d'une mise à jour du CMS, ces fichiers peuvent être remplacés par des versions plus récentes prévues par bluetronix.

Cela permet par exemple de livrer les mises à jour suivantes :

• Sicherheitsupdates
• Fehlerkorrekturen
• Browser-Kompatibilitätsanpassungen
• neue Bibliotheksversionen

Important : Lors d'une mise à jour version d'une bibliothèque tierce, il faut également vérifier si ses conditions de licence ont changé.

Ne pas modifier directement les fichiers standards

Les fichiers standards livrés par bluetronix ne devraient pas être modifiés directement.

Les modifications directes peuvent être écrasées lors d'une future mise à jour du système.

Pour les extensions individuelles, il convient donc de noter :

Standarddatei
→ unverändert lassen

Eigene Erweiterung
→ eigene Datei oder _own-Datei verwenden

Recevoir des avis de licence

Les avis de copyright et de licence présents dans les fichiers des tiers ne doivent pas être supprimés.

Par exemple :

/*!
 * Bootstrap ...
 * Licensed under MIT
 */

ou :

/*! jQuery ...
 * OpenJS Foundation ...
 */

devraient rester dans les fichiers livrés.

Licences tierces

De plus, il est recommandé de fournir dans la distribution bluetronix une vue d'ensemble centrale de toutes les bibliothèques tierces utilisées.

Par exemple :

THIRD-PARTY-LICENSES.txt

Ce fichier doit contenir au moins les informations suivantes :

• Name der Bibliothek
• verwendete Version
• Urheber bzw. Projekt
• Lizenz
• Verweis auf die jeweilige Lizenz

Contenu recommandé du fichier de licences tierces

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

Vérification de licence lors des mises à jour

Comme les bibliothèques frontend peuvent être mises à jour via le système de mise à jour bluetronix, il convient de vérifier avant d'ajouter une nouvelle version :

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?

Ce n'est qu'ensuite qu'une nouvelle version doit être adoptée comme bibliothèque standard dans bx_style ou bx_script.

Résumé des licences pour la version standard actuelle de bluetronix

Résumé

La version standard de bluetronix contient les bibliothèques frontend externes suivantes :

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 et la version WOW.js utilisée sont sous la licence MIT.

Les mentions de droits d'auteur et de licence doivent être conservées.

LightGallery 1.6.2, en revanche, est sous GPLv3 ou peut être licencié via une licence commerciale pour des applications propriétaires.

Pour une distribution propriétaire de bluetronix, il convient donc de respecter :

Bootstrap
jQuery
Owl Carousel
Swiper
WOW.js
→ MIT-Lizenzbedingungen einhalten

LightGallery
→ gültige Commercial License verwenden
   oder durch eine entsprechend lizenzierte Alternative ersetzen

À chaque mise à jour future d'une bibliothèque tierce, la version et la licence doivent être vérifiées à nouveau avant que la nouvelle version ne soit livrée via le système de mise à jour bluetronix.