data:widgets

Data TypeGadget TypeGadget VersionLayouts Version
array[Object]Global
2
3
!!! RAPPEL !!! Seuls les partenaires de Blogger-Code-PE disposent d'une licence spécifique sur notre propriété intellectuelle. Si vous n'êtes pas partenaire, vous n'êtes pas autorisé à recopier, à reproduire ou à traduire le contenu de ce blog sur un support public (blog, site web, forum, livre, e-book, etc...), ce qui inclut, sauf mention contraire, les textes, les codes, les listes des données, les illustrations, les syntaxes, les tableaux, etc... La violation de ces règles est passible de poursuites judiciaires. Conditions d'utilisation du blog.

Blogger - Ressources du dictionnaire de données data:widgets
data:widgets est un tableau de données universelles regroupant diverses caractéristiques des gadgets Blogger visibles installés sur le blog.
Ce dictionnaire est disponible uniquement pour les Layouts Version 3 et son contenu s'applique dans les thèmes officiels suivants :
  • « Essential »
  • « Contempo »
  • « Emporio »
  • « Notable »
  • « Soho »
Chaque donnée que nous avons répertorié dans notre sélection ci-dessous dispose d'une fiche technique sur ce blog. Dans chaque fiche, vous y trouverez des méthodes d'extraction des valeurs, les différents réglages qui peuvent être appliqués et des exemples que vous pouvez importer directement dans votre blog de tests.


Échantillonnage des ressources


  widgets: 
    title: string,
    type: string,
    sectionId: string,
    id: string,
    postId: number,
    posts: 
      id: number,
      title: string,
      featuredImage: image,
      showInlineAds: boolean
    ,
    headerByline: 
      regionName: string,
      items: 
        name: string,
        label: string
      
    ,
    footerBylines: 
      regionName: string,
      items: 
        name: string,
        label: string
      
    ,
    allBylineItems: 
      name: string,
      label: string
    
  



Extraction explicite des données

Note : Dans notre reconstitution ci-dessous, nous adoptons la formule d'uniformisation : <data:object.item/>. Cette formule favorise la réutilisation d'inclusions contenant les mêmes jeux de données. Bien évidemment, il existe diverses méthodes d'extraction et vous n'êtes pas obligé d'appliquer celle-ci dans le code XML de votre thème.
Afin d'éviter des confusions avec des données issues des autres dictionnaires, nous avons remplacé les variables widget par w, post par p et item par it.
Nous avons également ajouté des conditions pour les éléments spécifiques aux gadgets Blog, FeaturedPost et PopularPosts.

b:loop values='datawidgets' var='w'

  !-- ALL VISIBLE WIDGETS --
  dataw.title/
  dataw.type/
  dataw.sectionId/
  dataw.id/

  !-- FEATUREDPOST ONLY --
  b:if cond='dataw.type == "FeaturedPost"'
    dataw.postId/
  /b:if

  !-- BLOG AND POPULARPOSTS ONLY --
  b:if cond='dataw.type in ["Blog","PopularPosts"]'
    b:loop values='dataw.posts' var='p'

      datap.id/
      datap.title/

      !-- BLOG ONLY --
      b:if cond='dataw.type == "Blog"'
        datap.featuredImage/
        datap.showInlineAds/
      /b:if

    /b:loop
  /b:if

  !-- BLOG ONLY --
  b:if cond='dataw.type == "Blog"'

    dataw.headerByline.regionName/
    b:loop values='dataw.items' var='it'
      datait.name/
      datait.label/
    /b:loop
    b:loop values='dataw.footerBylines' var='footerByline'
      datafooterByline.regionName/
      b:loop values='datafooterByline.items' var='it'
        datait.name/
        datait.label/
      /b:loop
    /b:loop
    dataw.headerByline.regionName/
    datab:loop values='dataw.allBylineItems' var='it'
      datait.name/
      datait.label/
    /b:loop

  /b:if

/b:loop


Échantillonnage des ressources additionnelles


  widgets:  array ,
    
      size: number,
      length: number,
      empty: boolean,
      notEmpty: boolean,
      any: boolean,
      first:  Child type of the array ,
      last:  Child type of the array 
    ,
    
      AdSense:  array ,
      Blog:  array ,
      BlogArchive:  array ,
      BloggerButton:  array ,
      BlogList:  array ,
      BlogSearch:  array ,
      ContactForm:  array ,
      FeaturedPost:  array ,
      Feed:  array ,
      Header:  array ,
      HTML:  array ,
      Image:  array ,
      Label:  array ,
      LinkList:  array ,
      PageList:  array ,
      PopularPosts:  array ,
      Profile:  array ,
      ReportAbuse:  array ,
      Stats:  array ,
      Subscribe:  array ,
      Text:  array ,
      TextList:  array ,
      Translate:  array ,
      Wikipedia:  array 
    



Caractéristiques et valeurs

  • Peut être employée dans l'ensemble du code XML du thème.
  • Layouts Version 3 et Gadget Version 2.
  • Disponible sur toutes les pages.
  • Tableau[Objet] array[Object].
  • Tableau composé de sets de gadgets
  • Chaque set contient un tableau d'un gadget
  • Les gadgets doivent être visibles.
  • Le code XML des gadgets ne doit pas être en lecture seule (par exemple, le gadget Attribution n'est pas disponible).

Échantillonnage du contenu du tableau : AdSense BlogArchive BloggerButton BlogList BlogSearch ContactForm Feed Header HTML Image Label LinkList PageList Profile ReportAbuse Stats Subscribe Text TextList Translate Wikipedia

  title: string,
  type: string,
  sectionId: string,
  id: string


Échantillonnage du contenu du tableau : FeaturedPost

  title: string,
  type: string,
  sectionId: string,
  id: string,
  postId: number


Échantillonnage du contenu du tableau : PopularPosts

  title: string,
  type: string,
  sectionId: string,
  id: string,
  posts:  array 


Échantillonnage du contenu du tableau : Blog

  title: string,
  type: string,
  sectionId: string,
  id: string,
  posts:  array ,
  headerByline:  object ,
  footerBylines:  array ,
  allBylineItems:  array 



Extraction explicite des items du tableau

<b:loop values='data:widgets' var='widget'>

  <!-- ADD ITEMS HERE -->
  <data:widget.ITEM_NAME/>

</b:loop>



Filtrer le tableau par type de gadgets

En appliquant le nom d'un type de gadget comme suffixe à la donnée, le tableau ne contiendra plus que les gadgets de ce type.
En savoir plus
<b:loop values='data:widgets.WIDGET_TYPE' var='widget'>

</b:loop>
Exemple - Widget Blog
<b:loop values='data:widgets.Label' var='widget'>

</b:loop>



Premier et dernier set du tableau

Les suffixes .first (premier set) et .last (dernier set) transforment le tableau en un objet ne contenant que le premier ou le dernier set du tableau.
Ce qui permet d'extraire les items de ces sets, sans avoir à utiliser une boucle.
En savoir plus
Un item du premier set
<data:widgets.first.ITEM_NAME/>
Un item du dernier set
<data:widgets.last.ITEM_NAME/>
Le premier gadget de ce type
<data:widgets.WIDGET_TYPE.first.ITEM_NAME/>
Le dernier gadget de ce type
<data:widgets.WIDGET_TYPE.last.ITEM_NAME/>



Longueur du tableau

Les suffixes size et length permettent de connaître le nombre de set dans ce tableau. Le résultat sera une valeur numérique.
En savoir plus
Nombre total de gadgets
<data:widgets.size/>
Nombre total de gadgets du même type
<data:widgets.WIDGET_TYPE.length/>



Ce tableau n'est pas vide ?

Pour savoir si ce tableau n'est pas vide, appliquez le suffixe empty au tableau.
Pour vérifier si ce tableau contient des sets, appliquez les suffixes notEmpty ou any au tableau.
Quelque soit le suffixe, l'expression renverra une valeur booléenne.
En savoir plus
Est vide - Tous les gadgets
<b:if cond='data:widgets.empty'>

</b:if>
Est vide - Gadgets du même type
<b:if cond='data:widgets.WIDGET_TYPE.empty'>

</b:if>
N'est pas vide - Tous les gadgets
<b:if cond='data:widgets.notEmpty'>

</b:if>
N'est pas vide - Gadgets du même type
<b:if cond='data:widgets.WIDGET_TYPE.notEmpty'>

</b:if>



L'indice des items du tableau

L'indice des items est une valeur numérique (number). Il ne peut être obtenu qu'à l'intérieur d'une boucle <b:loop/>.
Tous les gadgets
<b:loop index='index' values='data:widgets' var='widget'>

  <!-- ADD INDEX HERE -->
  <data:index/>

</b:loop>
Les gadgets du même type
<b:loop index='index' values='data:widgets.WIDGET_TYPE' var='widget'>

  <!-- ADD INDEX HERE -->
  <data:index/>

</b:loop>



Implantation du tableau dans les thèmes de gadgets

Gadget Type Inclusion Gadget Version Layouts Version Thème
Global
all-head-content 1 2 1 2 3
Default
Common
openGraphMetaData 1 2 1 2 3
Default
Blog
main 2 3
Essential
Contempo
Notable
Soho
Blog
postCommentsAndAd 2 3
Emporio
FeaturedPost
PopularPosts
snippetedPostByline 2 3
Default


Implantation du tableau au-delà des gadgets

Emplacement Thème Layouts Version
<head> Essential, Contempo, Emporio, Notable, Soho. 3
<body> Essential, Contempo, Emporio, Notable, Soho. 3


Les autres dictionnaires de données

Spotlight

Les types de données [introduction]

Populaires cette semaine