Introduction : Les réglages des données / Data settings

Les réglages des données, également appelés paramètres additionnels des données, sont des éléments faisant partie du langage des thèmes Blogger. Ils consistent en des suffixes ajoutés aux données XML utilisées dans le thème. Leur rôle est d’enrichir la donnée d’origine en ajoutant des informations supplémentaires ou en modifiant son comportement. Grâce à ces réglages, les développeurs peuvent personnaliser leurs thèmes Blogger pour répondre à des besoins spécifiques, comme :

• Le formatage des chaînes de caractères.

• La conversion de dates.

• La manipulation de tableaux.

Maîtriser les réglages des données permet de tirer parti de la puissance des thèmes Blogger pour concevoir des designs dynamiques et interactifs.

Fonctionnement des réglages des données

D’un point de vue technique, un réglage agit comme un attribut supplémentaire appliqué à une donnée existante. Il est encapsulé dans un objet, lui-même inclus dans la donnée cible. Chaque réglage modifie ou enrichit la donnée initiale en produisant une nouvelle valeur.

Exemple schématique

  item: original_value,
        
          setting: new_value,
          setting: new_value,
          setting: new_value,
          setting: new_value,
          etc...
        

Dans cette représentation, chaque réglage (setting) s’applique à la donnée item pour produire une version enrichie.

Application des réglages dans l’éditeur XML

Pour appliquer un réglage, ajoutez-le directement au nom de la donnée Blogger dans l’éditeur XML. Voici deux exemples de syntaxe courante :

Réglage simple appliqué à une donnée

<data:item.setting/>

Réglage appliqué à une opération

<b:eval expr='(data:item snippet { length: 68 }).setting/>

Types de données compatibles avec les réglages

Les réglages des données Blogger sont strictement limités par le type de valeur auquel ils s’appliquent. Voici quelques exemples pour illustrer cette contrainte :

• Un réglage conçu pour une chaîne de caractères (string) est incompatible avec une valeur booléenne (boolean).

• Les réglages doivent être adaptés au type spécifique, comme par exemple, les dates (date), les tableaux (array), ou encore les images (image), etc.

Pour éviter les erreurs, identifiez toujours le type de donnée avant d’appliquer un réglage. Cela garantit non seulement la validité du code XML, mais aussi le bon fonctionnement du thème.

Ressources complémentaires

Explorateur des données Blogger

Introduction aux types des données Blogger

Une fois le type de donnée identifié, consultez les schémas des ressources ci-dessous pour choisir et appliquer les réglages adéquats.

⚠️ Attention !

Les dictionnaires de données XML des thèmes Blogger (inclus les réglages des données) sont confidentiels et intégrés directement dans le système de la plateforme. Contrairement à des formats publics comme JSON, leur contenu n'est pas accessible directement aux utilisateurs ou développeurs.

Par conséquent, les listes de données que vous trouvez sur le web (y compris sur Blogger Code PE) sont le fruit d’un travail minutieux de reconstitution réalisé par des tiers. Ces listes représentent des interprétations ou des compilations personnelles protégées par les lois sur la propriété intellectuelle et les règlements de la DMCA.

👉 Ce qu’il faut savoir :

• Ces listes sont créées par des auteurs indépendants.

• Elles n’appartiennent pas à Blogger et ne sont pas libres de droits.

• Leur republication ou redistribution sans autorisation est une infraction légale pouvant entraîner des conséquences graves.

Respectez les licences des créateurs pour garantir un accès continu à ces informations !

En respectant leurs droits, vous contribuez à maintenir un écosystème riche et collaboratif.

Les réglages disponibles

• String
• URL
• Image
• Date
• Locale
• Array
• Array[Image]
• Skin

Réglages String

Ces réglages s'appliquent aux données et valeurs de types string et aux chaînes de caractères dérivées url, image, date, locale et message.

Réglages	Description	Sortie
length size	Renvoient la longueur de la chaîne de caractères.	number
escaped jsEscaped jsonEscaped cssEscaped	Ces paramètres renvoient une chaîne de caractères échappée selon le contexte spécifique (HTML, JS, Json ou CSS).	string

Réglages Url

Ces réglages s'appliquent aux données et valeurs de types url.

Réglages	Description	Sortie
canonical	Renvoie l'url canonique de l'url courante.	URL
http https	HyperText Transfer Protocol Secure. Renvoie l'url avec le protocole http ou https.	URL

Réglages Image

Ces réglages s'appliquent aux données et valeurs de types image.

Réglages	Description	Sortie
isResizable	Indique si l'image peut être redimensionnée avec les opérateurs d'images.	boolean
isYoutube	Indique si l'image provient de YouTube.	boolean
youtubeMaxResDefaultUrl	Fourni l'URL de la vignette maxresdefault.jpg des vidéos YouTube.	image
width height originalWidth originalHeight	Renvoient les tailles d'affichage ou les dimensions originales de l'image (Si mentionnées explicitement).	number

Réglages Date

Ces réglages s'appliquent aux données et valeurs de types date.

Réglages	Description	Sortie
iso8601	Converti la date au format ISO 8601.	string
day month year dayOfWeek dayOfMonth dayOfYear	Renvoient un nombre correspondant au jour (jour de la semaine, du mois, ou de l'année) ou au mois et à l'année associés.	number

Réglages Locale

Ces réglages s'appliquent aux données et valeurs de types locale.

Réglages	Description	Sortie
name language language country	Renvoient le nom, l’abréviation, la variante de la langue courante ainsi que le pays associé.	string
languageDirection languageAlignment	Indiquent respectivement la direction (ltr pour gauche à droite ou rtl pour droite à gauche) et l’alignement du texte pour la langue courante (left aligné à gauche ou right aligné à droite).	string

Réglages Array

Ces réglages s'appliquent aux array.

Réglages	Description	Sortie
length size	Renvoient le nombre de sets contenus dans un tableau.	number
first last	Sélectionnent le premier ou le dernier set d'un tableau.	Type enfant du tableau.
empty notEmpty any	Indiquent si le tableau est vide, non vide, ou contient au moins un élément.	boolean
widgetType	Filtre par widget. Ce réglage sélectionne les sets d'un tableau d'un même type de gadget et s'applique uniquement au tableau widgets.	array[object]
itemName	Filtre par option des articles. Ce réglage sélectionne le set d'un tableau correspondant au nom de l'item : widgets[i].headerByline.items widgets[i].footerBylines[i].items widgets[i].allBylineItems	object

Réglages Array[Image]

Ces réglages sont des exceptions, parce qu'ils ne s'appliquent pas à un type de données spécifique, mais uniquement aux items issus d'une opération qui crée un tableau d'images redimensionnées array[image].

Réglages	Description	Sortie
size	Renvoie la taille de l'image.	number
url	Renvoie l'URL de l'image redimensionnée.	image

Réglages Skin

Ces paramètres s'appliquent uniquement aux données définies dans les variables d'habillage.

Réglages	Description	Sortie (Data Type)	Sortie (Skin Type)
L'arrière-plan du blog
image	Renvoie l'url de l'image d'arrière-plan.	image	indisponible
color	Renvoie le code de couleur associé à l'arrière-plan.	color(skin)	color(skin)
Les polices
size	Renvoie la taille de la police.	string	length(skin)
family	Renvoie le nom de la police.	string	string(skin)
Les couleurs
transparent inverse red green blue alpha	Ces paramètres permettent de manipuler ou extraire des informations spécifiques à un code de couleur. Par exemple : transparent : Convertit en un code RGBA transparent. inverse : Renvoie un code RGBA inversé. red, green, blue : Renvoient les codes RGB des couleurs primaires (entre 0 et 255). alpha : Indique le niveau de transparence (entre 0.0 et 1.0).	string	string(skin)

Avantages de l’utilisation des réglages des données

En utilisant efficacement les réglages des données XML, vous pouvez :

• Adapter vos thèmes Blogger avec des comportements précis et sur mesure.

• Simplifier la gestion et l’affichage des données complexes.

• Créer des fonctionnalités interactives qui améliorent l’expérience utilisateur.

• Maximiser les possibilités offertes par les paramètres XML avancés (Balises, Opérateurs).

Les Références XML

• Les balises
• Les attributs des balises
• Les types de données
• Les réglages des données
• Les opérateurs

Base de Connaissances