Aller au contenu

Métadonnées de l’article

Comme les modèles de blocs sont de simples fichiers PHP ordinaires, vous pouvez y utiliser le code PHP de votre choix. Dans l’éditeur d’articles, les aperçus des blocs sont rendus avec l’article en cours de modification comme variable globale $post ; fonctionsget_the_ID() telles que et les autres fonctions qui en dépendent y fonctionnent donc aussi. Les éditeurs sans article en cours de modification, comme l’éditeur de site, ne disposent pas de variable globale $post.

Blockstudio propose quatre méthodes différentes pour accéder à l’identifiant de l’article actuel dans l’éditeur et sur l’interface publique.

PHP

PHP
echo $post_id;
echo $postId;
echo $block['postId'];
echo $b['postId'];

Twig

Twig
{{ post_id }}
{{ postId }}
{{ block.postId }}
{{ b.postId }}

Accès aux métadonnées de l’article

Toutes les extensions courantes de champs personnalisés, ainsi que WordPress, permettent d’accéder aux métadonnées d’un article à l’aide de son identifiant.

ACF

PHP

PHP
echo get_field('field_name', $post_id);

Twig

Twig
{{ fn('get_field', 'field_name', postId) }}

Metabox

PHP

PHP
echo rwmb_get_value('field_id', null, $post_id);

Twig

Twig
{{ fn('rwmb_get_value', 'field_id', postId) }}

Actualisation des blocs

Par défaut, les blocs ne sont pas actualisés lorsque vous enregistrez ou mettez à jour un article. L’éditeur peut donc afficher d’anciennes données après l’enregistrement. Pour corriger ce problème, utilisez la clé refreshOn dans votre block.json pour indiquer à Blockstudio d’actualiser le bloc lors de l’enregistrement d’un article.

JSON
{
  "name": "blockstudio/native",
  "title": "Native Block",
  "category": "text",
  "icon": "star-filled",
  "description": "Native Blockstudio block.",
  "blockstudio": {
    "refreshOn": [
      "save"
    ]
  }
}