data:widgets

Data TypeGadget TypeGadget VersionLayouts Version
array[Object]Global
2
3
Blogger - Ressources du dictionnaire de données data:widgets
data:widgets est un tableau de données universelles regroupant les gadgets Blogger visibles installés sur le blog.
Ce dictionnaire est disponible uniquement pour les Layouts Version 3.


Ressources

"data": {
  "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 : 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='data:widgets' var='w'>

  <!-- ALL VISIBLE WIDGETS -->
  <data:w.title/>
  <data:w.type/>
  <data:w.sectionId/>
  <data:w.id/>

  <!-- FEATUREDPOST ONLY -->
  <b:if cond='data:w.type == "FeaturedPost"'>
    <data:w.postId/>
  </b:if>

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

      <data:p.id/>
      <data:p.title/>

      <!-- BLOG ONLY -->
      <b:if cond='data:w.type == "Blog"'>
        <data:p.featuredImage/>
        <data:p.showInlineAds/>
      </b:if>

    </b:loop>
  </b:if>

  <!-- BLOG ONLY -->
  <b:if cond='data:w.type == "Blog"'>

    <data:w.headerByline.regionName/>
    <b:loop values='data:w.items' var='it'>
      <data:it.name/>
      <data:it.label/>
    </b:loop>
    <b:loop values='data:w.footerBylines' var='footerByline'>
      <data:footerByline.regionName/>
      <b:loop values='data:footerByline.items' var='it'>
        <data:it.name/>
        <data:it.label/>
      </b:loop>
    </b:loop>
    <data:w.headerByline.regionName/>
    <b:loop values='data:w.allBylineItems' var='it'>
      <data:it.name/>
      <data:it.label/>
    </b:loop>

  </b:if>

</b:loop>


Ressources additionnelles

"data": {
  "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 ],
      "FollowByEmail": [ 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).

Items de l'objet : gadgets AdSense, BlogArchive, BloggerButton, BlogList, BlogSearch, ContactForm, Feed, FollowByEmail, Header, HTML, Image, Label, LinkList, PageList, Profile, ReportAbuse, Stats, Subscribe, Text, TextList, Translate et Wikipedia
[{
  "title": string,
  "type": string,
  "sectionId": string,
  "id": string
}]

Items de l'objet : Gadget FeaturedPost
[{
  "title": string,
  "type": string,
  "sectionId": string,
  "id": string,
  "postId": number
}]

Items de l'objet : Gadget PopularPosts
[{
  "title": string,
  "type": string,
  "sectionId": string,
  "id": string,
  "posts": [array]
}]

Items de l'objet : Gadget 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.Blog' 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
Common
openGraphMetaData 1 2 1 2 3
Blog
main 2 3
Contempo
Notable
Soho
Blog
postCommentsAndAd 2 3
Emporio


Implantation du tableau au-delà des gadgets

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


Les autres dictionnaires universels

Spotlight

Populaires cette semaine

LinkedIn : Bouton de partage [Share button]

Les gadgets Blogger [introduction]

Les thèmes Blogger [introduction]