Συλλογή συνταγών για μοτίβα πεδίων
Το σύστημα πεδίων του Blockstudio είναι απλό από μόνο του: προσθέστε ένα πεδίο στο blockstudio.attributes και αποκτήστε πρόσβαση σε αυτό μέσω του $a στο πρότυπό σας. Όμως τα πραγματικά μπλοκ σπάνια έχουν μόνο ένα πεδίο. Περιλαμβάνουν ομάδες σχετικών ρυθμίσεων, πεδία που εμφανίζονται ή αποκρύπτονται ανάλογα με άλλα πεδία, επαναλήψεις με σύνθετες δομές γραμμών και δεδομένα στα οποία πρέπει να μπορείτε να υποβάλετε ερωτήματα εκτός του επεξεργαστή μπλοκ.
Αυτός ο οδηγός συγκεντρώνει πρακτικές συνταγές για συνηθισμένα μοτίβα πεδίων. Κάθε συνταγή παρουσιάζει τη διαμόρφωση block.json και τον αντίστοιχο κώδικα προτύπου. Αντιγράψτε τις απευθείας στα μπλοκ σας και προσαρμόστε τις ανάλογα.
Πεδία υπό όρους
Το πιο συνηθισμένο μοτίβο: εμφάνιση ή απόκρυψη πεδίων με βάση την τιμή ενός άλλου πεδίου. Έτσι ο επεξεργαστής παραμένει οργανωμένος, καθώς εμφανίζονται μόνο οι σχετικές επιλογές.
Εναλλαγή για εμφάνιση επιλογών
Ένα μπλοκ CTA όπου εμφανίζονται πρόσθετες ρυθμίσεις όταν ο χρήστης ενεργοποιεί ένα κουμπί:
{
"name": "my-theme/cta",
"title": "Call to Action",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading", "default": "Ready to get started?" },
{ "id": "description", "type": "textarea", "label": "Description" },
{ "id": "showButton", "type": "toggle", "label": "Show Button", "default": true },
{
"id": "buttonText",
"type": "text",
"label": "Button Text",
"default": "Get Started",
"conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
},
{
"id": "buttonUrl",
"type": "link",
"label": "Button Link",
"conditions": [[{ "id": "showButton", "operator": "==", "value": true }]]
}
]
}
}
Τα πεδία κειμένου και συνδέσμου του κουμπιού εμφανίζονται μόνο όταν είναι ενεργοποιημένος ο διακόπτης. Στο πρότυπο, ελέγξτε τον διακόπτη πριν από την απόδοση:
<div useBlockProps>
<h2><?php echo esc_html( $a['heading'] ); ?></h2>
<?php if ( $a['description'] ) : ?>
<p><?php echo esc_html( $a['description'] ); ?></p>
<?php endif; ?>
<?php if ( $a['showButton'] && $a['buttonUrl'] ) : ?>
<a href="<?php echo esc_url( $a['buttonUrl']['url'] ); ?>">
<?php echo esc_html( $a['buttonText'] ); ?>
</a>
<?php endif; ?>
</div>
Επιλογή για εναλλαγή συνόλων πεδίων
Ένα μπλοκ hero όπου ο τύπος φόντου καθορίζει ποια πεδία εμφανίζονται:
{
"name": "my-theme/hero",
"title": "Hero",
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{
"id": "bgType",
"type": "select",
"label": "Background Type",
"default": "color",
"options": [
{ "value": "color", "label": "Solid Color" },
{ "value": "gradient", "label": "Gradient" },
{ "value": "image", "label": "Image" },
{ "value": "video", "label": "Video" }
]
},
{
"id": "bgColor",
"type": "color",
"label": "Background Color",
"conditions": [[{ "id": "bgType", "operator": "==", "value": "color" }]]
},
{
"id": "bgGradient",
"type": "gradient",
"label": "Background Gradient",
"conditions": [[{ "id": "bgType", "operator": "==", "value": "gradient" }]]
},
{
"id": "bgImage",
"type": "files",
"label": "Background Image",
"multiple": false,
"conditions": [[{ "id": "bgType", "operator": "==", "value": "image" }]]
},
{
"id": "bgVideo",
"type": "files",
"label": "Background Video",
"multiple": false,
"allowedTypes": ["video"],
"conditions": [[{ "id": "bgType", "operator": "==", "value": "video" }]]
},
{
"id": "overlay",
"type": "range",
"label": "Overlay Opacity",
"default": 50,
"min": 0,
"max": 100,
"conditions": [[{ "id": "bgType", "operator": "!=", "value": "color" }]]
}
]
}
}
Το πεδίο αδιαφάνειας επικάλυψης χρησιμοποιεί το != για να εμφανίζεται σε όλες τις περιπτώσεις εκτός από το μονόχρωμο φόντο. Κάθε φορά εμφανίζεται μόνο ένα πεδίο φόντου. Ένα πεδίο color επιστρέφει έναν πίνακα με τα value, name και slug του χρώματος, οπότε το πρότυπο διαβάζει το ['value']:
<?php
$bg_style = match ( $a['bgType'] ) {
'color' => $a['bgColor'] ? "background-color: {$a['bgColor']['value']}" : '',
'gradient' => $a['bgGradient'] ? "background: {$a['bgGradient']}" : '',
'image' => $a['bgImage'] ? "background-image: url({$a['bgImage']['url']})" : '',
default => '',
};
?>
<div useBlockProps style="<?php echo esc_attr( $bg_style ); ?>">
<?php if ( $a['bgType'] === 'video' && $a['bgVideo'] ) : ?>
<video autoplay muted loop playsinline>
<source src="<?php echo esc_url( $a['bgVideo']['url'] ); ?>" />
</video>
<?php endif; ?>
<h1><?php echo esc_html( $a['heading'] ); ?></h1>
</div>
Συνθήκες OR
Εμφανίστε ένα πεδίο όταν ισχύει οποιαδήποτε από πολλές συνθήκες. Κάθε εσωτερικός πίνακας είναι μια ομάδα AND· ο εξωτερικός πίνακας τις συνδυάζει με OR:
{
"id": "caption",
"type": "text",
"label": "Caption",
"conditions": [
[{ "id": "bgType", "operator": "==", "value": "image" }],
[{ "id": "bgType", "operator": "==", "value": "video" }]
]
}
Έτσι εμφανίζεται το πεδίο λεζάντας όταν το bgType είναι “image” Ή “video”.
Αλυσιδωτές συνθήκες
Πολλαπλές συνθήκες στον ίδιο εσωτερικό πίνακα χρησιμοποιούν λογική AND:
{
"id": "altText",
"type": "text",
"label": "Alt Text",
"conditions": [[
{ "id": "bgType", "operator": "==", "value": "image" },
{ "id": "bgImage", "operator": "!empty" }
]]
}
Το πεδίο εναλλακτικού κειμένου εμφανίζεται μόνο όταν το bgType είναι “image” ΚΑΙ έχει επιλεγεί εικόνα.
Καθολικές συνθήκες
Εμφανίστε πεδία με βάση τον τύπο ανάρτησης, το αναγνωριστικό ανάρτησης ή τον ρόλο χρήστη, αντί για τιμές άλλων πεδίων:
{
"id": "seoTitle",
"type": "text",
"label": "SEO Title",
"conditions": [[{ "type": "postType", "operator": "==", "value": "page" }]]
}
Διαθέσιμοι τύποι καθολικών συνθηκών: postType, postId, userRole, userId.
Οργανωμένες ρυθμίσεις
Καθώς τα μπλοκ γίνονται πιο σύνθετα, η οργάνωση των πεδίων σε λογικές ομάδες κρατά τον επιθεωρητή διαχειρίσιμο.
Ομάδες για οπτική οργάνωση
Οι ομάδες δημιουργούν συμπτυσσόμενες ενότητες στον επιθεωρητή. Μια ανώνυμη ομάδα (χωρίς id) είναι αποκλειστικά οπτική· η πρόσβαση στα πεδία της γίνεται με τα γυμνά αναγνωριστικά τους:
{
"name": "my-theme/card",
"title": "Card",
"blockstudio": {
"attributes": [
{
"type": "group",
"title": "Content",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "description", "type": "textarea", "label": "Description" },
{ "id": "image", "type": "files", "label": "Image", "multiple": false }
]
},
{
"type": "group",
"title": "Link",
"attributes": [
{ "id": "url", "type": "link", "label": "URL" },
{ "id": "openInNewTab", "type": "toggle", "label": "Open in New Tab" }
]
},
{
"type": "group",
"title": "Appearance",
"attributes": [
{
"id": "style",
"type": "select",
"label": "Style",
"default": "elevated",
"options": [
{ "value": "elevated", "label": "Elevated" },
{ "value": "outlined", "label": "Outlined" },
{ "value": "flat", "label": "Flat" }
]
},
{ "id": "accentColor", "type": "color", "label": "Accent Color" }
]
}
]
}
}
<div useBlockProps>
<h3><?php echo esc_html( $a['title'] ); ?></h3>
<p><?php echo esc_html( $a['description'] ); ?></p>
</div>
Η πρόσβαση στα πεδία γίνεται απευθείας: $a['title'], $a['style'], $a['accentColor']. Οι ομάδες επηρεάζουν μόνο τη διάταξη του επιθεωρητή.
Ονομασμένες ομάδες με το bs_get_group
Όταν μια ομάδα έχει id, στα αναγνωριστικά των θυγατρικών πεδίων προστίθεται αυτό ως πρόθεμα. Χρησιμοποιήστε το bs_get_group() για να αφαιρέσετε το πρόθεμα:
{
"id": "author",
"type": "group",
"title": "Author",
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "role", "type": "text", "label": "Role" },
{ "id": "avatar", "type": "files", "label": "Avatar", "multiple": false }
]
}
Χωρίς τη βοηθητική συνάρτηση, η πρόσβαση στα πεδία γίνεται ως εξής: $a['author_name'], $a['author_role'], $a['author_avatar']. Με τη βοηθητική συνάρτηση:
<?php $author = bs_get_group( $a, 'author' ); ?>
<div class="author">
<?php if ( $author['avatar'] ) : ?>
<img src="<?php echo esc_url( $author['avatar']['url'] ); ?>" alt="" />
<?php endif; ?>
<p><?php echo esc_html( $author['name'] ); ?></p>
<p><?php echo esc_html( $author['role'] ); ?></p>
</div>
Οι ονομασμένες ομάδες είναι χρήσιμες όταν τα ίδια ονόματα πεδίων εμφανίζονται σε πολλές ομάδες (e.g., author_name και company_name) ή όταν θέλετε να περάσετε την ομάδα ως ενιαίο σύνολο σε ένα μερικό πρότυπο.
Διάταξη πλέγματος σε ομάδες
Χρησιμοποιήστε την ιδιότητα style για να τοποθετήσετε τα θυγατρικά στοιχεία της ομάδας το ένα δίπλα στο άλλο:
{
"type": "group",
"title": "Dimensions",
"style": {
"display": "grid",
"grid-template-columns": "1fr 1fr",
"grid-gap": "16px"
},
"attributes": [
{ "id": "width", "type": "unit", "label": "Width", "default": "100%", "switch": false },
{ "id": "height", "type": "unit", "label": "Height", "default": "auto", "switch": false }
]
}
Τα δύο πεδία μονάδων εμφανίζονται δίπλα δίπλα στον επιθεωρητή αντί το ένα κάτω από το άλλο. Αυτό λειτουργεί καλά για ζεύγη διαστάσεων, τιμές περιθωρίου/εσωτερικού περιθωρίου ή οποιαδήποτε δύο πεδία που συνδέονται εννοιολογικά.
Καρτέλες για κύριες ενότητες
Όταν ένα μπλοκ έχει πολλές ρυθμίσεις, οι καρτέλες προσφέρουν πιο καθαρή οργάνωση από μια μακρά λίστα ομάδων:
{
"type": "tabs",
"tabs": [
{
"title": "Content",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{ "id": "body", "type": "wysiwyg", "label": "Body" }
]
},
{
"title": "Media",
"attributes": [
{ "id": "image", "type": "files", "label": "Image", "multiple": false },
{ "id": "video", "type": "files", "label": "Video", "multiple": false, "allowedTypes": ["video"] }
]
},
{
"title": "Settings",
"attributes": [
{ "id": "layout", "type": "select", "label": "Layout", "options": [
{ "value": "left", "label": "Media Left" },
{ "value": "right", "label": "Media Right" }
]},
{ "id": "fullWidth", "type": "toggle", "label": "Full Width" }
]
}
]
}
Η πρόσβαση στα πεδία κάθε καρτέλας γίνεται όπως και στα πεδία ανώτατου επιπέδου: $a['title'], $a['image'], $a['layout']. Οι καρτέλες είναι απλώς ένα δοχείο UI.
Μοτίβα επαναλήψεων
Οι επαναλήψεις επιτρέπουν στους χρήστες να προσθέτουν πολλές γραμμές πεδίων. Είναι απαραίτητες για λίστες, πλέγματα, χρονολόγια και κάθε στοιχείο με μεταβλητό αριθμό καταχωρίσεων.
Βασική επανάληψη με περιορισμούς
Μια λίστα χαρακτηριστικών με 1 έως 6 στοιχεία:
{
"id": "features",
"type": "repeater",
"label": "Features",
"min": 1,
"max": 6,
"textButton": "Add Feature",
"attributes": [
{ "id": "icon", "type": "icon", "label": "Icon" },
{ "id": "title", "type": "text", "label": "Title", "default": "Feature" },
{ "id": "description", "type": "textarea", "label": "Description" }
]
}
<div useBlockProps class="grid grid-cols-3 gap-8">
<?php foreach ( $a['features'] as $feature ) : ?>
<div>
<?php if ( $feature['icon'] ) : ?>
<?php bs_render_icon( $feature['icon'] ); ?>
<?php endif; ?>
<h3><?php echo esc_html( $feature['title'] ); ?></h3>
<p><?php echo esc_html( $feature['description'] ); ?></p>
</div>
<?php endforeach; ?>
</div>
Προσαρμοσμένες ετικέτες γραμμών
Από προεπιλογή, οι συμπτυγμένες γραμμές επανάληψης εμφανίζουν μια γενική ετικέτα. Χρησιμοποιήστε το textMinimized για να εμφανίσετε αντί γι’ αυτήν μια τιμή πεδίου:
{
"id": "team",
"type": "repeater",
"label": "Team Members",
"textMinimized": { "id": "name", "fallback": "Team Member" },
"attributes": [
{ "id": "name", "type": "text", "label": "Name" },
{ "id": "role", "type": "text", "label": "Role" },
{ "id": "photo", "type": "files", "label": "Photo", "multiple": false }
]
}
Όταν μια γραμμή συμπτύσσεται, εμφανίζει το όνομα του ατόμου αντί για το “Row 1”. Το fallback χρησιμοποιείται όταν το πεδίο ονόματος είναι κενό. Μπορείτε επίσης να προσθέσετε τις συμβολοσειρές prefix και suffix.
Συνθήκες μέσα σε επαναλήψεις
Τα πεδία μέσα σε μια επανάληψη μπορούν να αναφέρονται σε άλλα πεδία της ίδιας γραμμής χρησιμοποιώντας τα γυμνά id τους (δεν χρειάζεται πρόθεμα):
{
"id": "links",
"type": "repeater",
"label": "Links",
"attributes": [
{ "id": "label", "type": "text", "label": "Label" },
{ "id": "url", "type": "link", "label": "URL" },
{
"id": "isExternal",
"type": "toggle",
"label": "External Link"
},
{
"id": "externalNote",
"type": "message",
"label": "Note",
"description": "External links open in a new tab with rel=\"noopener\".",
"conditions": [[{ "id": "isExternal", "operator": "==", "value": true }]]
}
]
}
Αναφορά σε εξωτερικά πεδία από μέσα σε επανάληψη
Όταν μια συνθήκη μέσα σε επανάληψη πρέπει να ελέγξει ένα πεδίο εκτός της επανάληψης, προσθέστε "context": "main":
{
"id": "showDescriptions",
"type": "toggle",
"label": "Show Descriptions",
"default": true
},
{
"id": "items",
"type": "repeater",
"label": "Items",
"attributes": [
{ "id": "title", "type": "text", "label": "Title" },
{
"id": "description",
"type": "textarea",
"label": "Description",
"conditions": [[{
"id": "showDescriptions",
"operator": "==",
"value": true,
"context": "main"
}]]
}
]
}
Χωρίς το "context": "main", η συνθήκη θα αναζητούσε ένα πεδίο showDescriptions μέσα στη γραμμή της επανάληψης. Με αυτό, η συνθήκη ελέγχει τον διακόπτη στο επίπεδο της ρίζας.
Καρτέλες μέσα σε επαναλήπτες
Οι καρτέλες δεν είναι διαθέσιμες μέσα σε επαναλήπτες: ένα πεδίο tabs μέσα σε μια γραμμή επαναλήπτη εμφανίζει μια ειδοποίηση στον επεξεργαστή αντί για τα πεδία του, και η επέκταση PHPStan το αναφέρει. Κρατήστε τα πεδία μιας γραμμής σε επίπεδη διάταξη. Για μεγάλες γραμμές, μια προσαρμοσμένη ετικέτα γραμμής (textMinimized) διατηρεί την αναγνωσιμότητα των συμπτυγμένων γραμμών, ενώ οι συνθήκες μέσα στη γραμμή μπορούν να αποκρύπτουν πεδία που χρειάζονται μόνο ορισμένες γραμμές, όπως φαίνεται στα παραπάνω μοτίβα.
Ορίστε το "minimized": true σε έναν επαναλήπτη για να ξεκινούν συμπτυγμένες οι υπάρχουσες γραμμές. Οι γραμμές που προστίθενται ανοίγουν αμέσως. Οι εξαιρέσεις που έχουν αναπτυχθεί απομνημονεύονται σε αυτό το πρόγραμμα περιήγησης και διατηρούνται μετά από επαναφορτώσεις του επεξεργαστή· πρόκειται για προτίμηση επεξεργασίας και όχι για αποθηκευμένο περιεχόμενο ανάρτησης.
Οι επαναλήπτες χωρίς minimized διατηρούν την υπάρχουσα συμπεριφορά, σύμφωνα με την οποία είναι αναπτυγμένοι από προεπιλογή.
Μοτίβα πολυμέσων
Μεμονωμένη εικόνα με εφεδρική επιλογή
{
"id": "image",
"type": "files",
"label": "Image",
"multiple": false
}
<?php if ( $a['image'] ) : ?>
<img
src="<?php echo esc_url( $a['image']['url'] ); ?>"
alt="<?php echo esc_attr( $a['image']['alt'] ); ?>"
<?php if ( isset( $a['image']['sizes']['full-width'], $a['image']['sizes']['full-height'] ) ) : ?>
width="<?php echo esc_attr( $a['image']['sizes']['full-width'] ); ?>"
height="<?php echo esc_attr( $a['image']['sizes']['full-height'] ); ?>"
<?php endif; ?>
/>
<?php endif; ?>
Η προεπιλεγμένη returnFormat είναι "object", η οποία παρέχει ID, title, alt, caption, description, href, url και sizes. Το sizes περιέχει το URL κάθε καταχωρισμένου μεγέθους εικόνας (sizes['large']), μαζί με τις διαστάσεις του (sizes['large-width'], sizes['large-height']). Δείτε την ενότητα Χαρακτηριστικά απόδοσης για την πλήρη λίστα.
Συλλογή εικόνων με όριο
{
"id": "gallery",
"type": "files",
"label": "Gallery",
"multiple": true,
"max": 6,
"allowedTypes": ["image"]
}
<?php if ( $a['gallery'] ) : ?>
<div class="grid grid-cols-3 gap-4">
<?php foreach ( $a['gallery'] as $image ) : ?>
<img
src="<?php echo esc_url( $image['url'] ); ?>"
alt="<?php echo esc_attr( $image['alt'] ); ?>" />
<?php endforeach; ?>
</div>
<?php endif; ?>
Απενεργοποιήσιμη εικόνα με διακόπτη
Η ιδιότητα switch προσθέτει ένα εικονίδιο ματιού που επιτρέπει στους χρήστες να απενεργοποιούν το πεδίο χωρίς να διαγράφουν την τιμή:
{
"id": "logo",
"type": "files",
"label": "Logo",
"multiple": false,
"switch": true
}
<?php
$is_disabled = ! empty( $a['_disabled'] ) && in_array( 'logo', $a['_disabled'], true );
if ( $a['logo'] && ! $is_disabled ) : ?>
<img src="<?php echo esc_url( $a['logo']['url'] ); ?>" alt="" />
<?php endif; ?>
Ο χρήστης μπορεί να απενεργοποιήσει το λογότυπο χωρίς να αφαιρέσει το μεταφορτωμένο αρχείο. Αν το ενεργοποιήσει ξανά, εμφανίζεται πάλι το ίδιο αρχείο.
Παραλλαγές μορφής επιστροφής
Ελέγξτε τι επιστρέφει το πεδίο αρχείων:
// Full object (default)
{ "id": "photo", "type": "files", "returnFormat": "object", "multiple": false }
// $a['photo']['url'], $a['photo']['alt'], $a['photo']['sizes']['full-width'], etc.
// Just the ID
{ "id": "photo", "type": "files", "returnFormat": "id", "multiple": false }
// $a['photo'] = 42
// Just the URL
{ "id": "photo", "type": "files", "returnFormat": "url", "multiple": false }
// $a['photo'] = "https://example.com/photo.jpg"
Χρησιμοποιήστε το "id" όταν χρειάζεται να καλέσετε οι ίδιοι το wp_get_attachment_image(). Χρησιμοποιήστε το "url" για απλές εικόνες φόντου. Χρησιμοποιήστε το "object" (προεπιλογή) για όλες τις άλλες περιπτώσεις.
Με το "returnFormat": "id", μια εισαγόμενη αναφορά συμβολοσειράς, όπως η "buckshair-home", περνά χωρίς αλλαγές. Ο επεξεργαστής εμφανίζει μια εφεδρική κάρτα χωρίς μικρογραφία, ακόμη και σε γραμμές επαναλήπτη. Το άνοιγμα ή η αποθήκευση της σελίδας δεν μετατρέπει μια βαθμωτή αναφορά σε πίνακα. Λειτουργούν επίσης μικτές λίστες με αναγνωριστικά συνημμένων και αναφορές συμβολοσειρών· στη βιβλιοθήκη πολυμέσων αναζητούνται μόνο θετικά αναγνωριστικά συνημμένων.
Το Blockstudio δεν αντιστοιχίζει προσαρμοσμένες αναφορές συμβολοσειρών σε συνημμένα. Αν χρησιμοποιείτε φορητά ονόματα σε διαφορετικούς ιστότοπους, επιλύστε τις αναφορές στο δικό σας φίλτρο απόδοσης ή πρότυπο. Η επιλογή αντικατάστασης στη βιβλιοθήκη πολυμέσων αποθηκεύει, όπως συνήθως, το αναγνωριστικό του συνημμένου της.
Δυναμικές επιλογές
Συμπλήρωση από αναρτήσεις
Ένα πεδίο επιλογής που παραθέτει όλες τις δημοσιευμένες σελίδες:
{
"id": "linkedPage",
"type": "select",
"label": "Linked Page",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "posts",
"arguments": {
"post_type": "page",
"post_status": "publish",
"posts_per_page": -1
}
}
}
Το πεδίο συμπληρώνεται αυτόματα με τους τίτλους σελίδων ως ετικέτες και τα αναγνωριστικά αναρτήσεων ως τιμές. Χρησιμοποιήστε το returnFormat στη διαμόρφωση συμπλήρωσης για να προσαρμόσετε την αντιστοίχιση:
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"returnFormat": { "value": "ID", "label": "post_title" }
}
Συμπλήρωση από όρους ταξινομίας
{
"id": "category",
"type": "select",
"label": "Category",
"stylisedUi": true,
"populate": {
"type": "query",
"query": "terms",
"arguments": {
"taxonomy": "category",
"hide_empty": true
}
}
}
Συμπλήρωση από συνάρτηση PHP
{
"id": "postType",
"type": "select",
"label": "Post Type",
"populate": {
"type": "function",
"function": "get_post_types",
"arguments": { "public": true }
}
}
Στατικές επιλογές με συμπληρωμένες προσθήκες
Συνδυάστε σταθερές επιλογές με δυναμικές. Χρησιμοποιήστε το position για να καθορίσετε πού θα εμφανίζονται οι συμπληρωμένες επιλογές:
{
"id": "source",
"type": "select",
"label": "Source",
"options": [
{ "value": "manual", "label": "Manual Entry" },
{ "value": "latest", "label": "Latest Posts" }
],
"populate": {
"type": "query",
"query": "posts",
"arguments": { "post_type": "page" },
"position": "after"
}
}
Οι στατικές επιλογές εμφανίζονται πρώτες και ακολουθούν οι δυναμικά συμπληρωμένες σελίδες.
Αποθήκευση δεδομένων για ερωτήματα
Από προεπιλογή, οι τιμές πεδίων βρίσκονται στα χαρακτηριστικά μπλοκ μέσα στο post_content. Δεν είναι διαθέσιμες για ερωτήματα μέσω του WP_Query. Όταν χρειάζεται να φιλτράρετε ή να ταξινομήσετε αναρτήσεις με βάση μια τιμή πεδίου, χρησιμοποιήστε αποθήκευση.
Μεταδεδομένα ανάρτησης για πεδία με δυνατότητα ερωτημάτων
{
"id": "featured",
"type": "toggle",
"label": "Featured",
"storage": {
"type": "postMeta",
"postMetaKey": "is_featured"
}
},
{
"id": "priority",
"type": "number",
"label": "Priority",
"default": 0,
"min": 0,
"max": 100,
"storage": {
"type": "postMeta",
"postMetaKey": "priority_score"
}
}
Τώρα μπορείτε να υποβάλετε ερώτημα για επιλεγμένες αναρτήσεις:
$featured = new WP_Query( array(
'meta_query' => array(
array(
'key' => 'is_featured',
'value' => '1',
),
),
'orderby' => 'meta_value_num',
'meta_key' => 'priority_score',
'order' => 'DESC',
) );
Τα κλειδιά μεταδεδομένων καταχωρίζονται αυτόματα με το show_in_rest, επομένως είναι διαθέσιμα και στο REST API.
Διπλή αποθήκευση
Αποθηκεύστε τόσο στα χαρακτηριστικά μπλοκ όσο και στα μεταδεδομένα ανάρτησης. Το χαρακτηριστικό μπλοκ διατηρεί την τιμή διαθέσιμη στα πρότυπα μέσω του $a, ενώ τα μεταδεδομένα ανάρτησης επιτρέπουν την υποβολή ερωτημάτων:
{
"id": "eventDate",
"type": "date",
"label": "Event Date",
"storage": {
"type": ["block", "postMeta"],
"postMetaKey": "event_date"
}
}
Αποθήκευση επιλογών για καθολικές τιμές
Για ρυθμίσεις σε επίπεδο ιστότοπου που πρέπει να είναι ίδιες παντού, χρησιμοποιήστε αποθήκευση επιλογών:
{
"id": "companyName",
"type": "text",
"label": "Company Name",
"storage": {
"type": "option",
"optionKey": "site_company_name"
}
}
Η τιμή αποθηκεύεται στο wp_options και είναι προσβάσιμη παντού με το get_option('site_company_name'). Όταν ο χρήστης επεξεργάζεται αυτό το πεδίο σε οποιαδήποτε παρουσία μπλοκ, η τιμή ενημερώνεται καθολικά.
Επαναχρησιμοποιήσιμοι ορισμοί πεδίων
Όταν πολλά μπλοκ μοιράζονται την ίδια δομή πεδίων, ορίστε την μία φορά ως προσαρμοσμένο πεδίο και αναφερθείτε σε αυτήν παντού.
Δημιουργία προσαρμοσμένου πεδίου
Δημιουργήστε ένα field.json στον κατάλογο blockstudio/fields/ του θέματος σας:
theme/
└── blockstudio/
└── fields/
└── cta/
└── field.json
{
"name": "cta",
"title": "Call to Action",
"attributes": [
{ "id": "label", "type": "text", "label": "Button Label", "default": "Learn More" },
{ "id": "url", "type": "link", "label": "Button URL" },
{ "id": "style", "type": "select", "label": "Button Style", "default": "primary", "options": [
{ "value": "primary", "label": "Primary" },
{ "value": "secondary", "label": "Secondary" },
{ "value": "outline", "label": "Outline" }
]}
]
}
Χρήση προσαρμοσμένου πεδίου
Αναφερθείτε σε αυτό σε οποιοδήποτε μπλοκ με το "type": "custom/cta":
{
"blockstudio": {
"attributes": [
{ "id": "heading", "type": "text", "label": "Heading" },
{ "type": "custom/cta" }
]
}
}
Τα πεδία CTA ενσωματώνονται στο μπλοκ. Αποκτήστε άμεση πρόσβαση σε αυτά: $a['label'], $a['url'], $a['style'].
Προσαρμοσμένα πεδία με πρόθεμα μέσω του idStructure
Όταν χρησιμοποιείτε το ίδιο προσαρμοσμένο πεδίο πολλές φορές, προσθέστε το idStructure για να βάλετε πρόθεμα στα αναγνωριστικά:
{
"blockstudio": {
"attributes": [
{ "type": "custom/cta", "idStructure": "primary_{id}" },
{ "type": "custom/cta", "idStructure": "secondary_{id}" }
]
}
}
Τα πεδία της πρώτης CTA γίνονται primary_label, primary_url, primary_style. Τα πεδία της δεύτερης γίνονται secondary_label κ.ο.κ.
Παράκαμψη προεπιλογών
Προσαρμόστε συγκεκριμένα πεδία όταν αναφέρεστε σε ένα προσαρμοσμένο πεδίο:
{
"type": "custom/cta",
"idStructure": "hero_{id}",
"overrides": {
"label": { "default": "Get Started", "label": "CTA Label" },
"style": { "default": "primary" }
}
}
Οι παρακάμψεις συγχωνεύονται με τον αρχικό ορισμό. Μπορείτε να αλλάξετε τις προεπιλογές, τις ετικέτες, τις συνθήκες ή οποιαδήποτε άλλη ιδιότητα.
Μοτίβα απόδοσης
Έλεγχοι κενών τιμών
Οι περισσότεροι τύποι πεδίων επιστρέφουν false όταν είναι κενοί. Ελέγχετε πάντα πριν από την απόδοση:
<?php if ( $a['title'] ) : ?>
<h2><?php echo esc_html( $a['title'] ); ?></h2>
<?php endif; ?>
Για τους αριθμούς, το 0 είναι έγκυρη τιμή. Χρησιμοποιήστε αυστηρή σύγκριση αν χρειάζεται να διακρίνετε το “κενό” από το “μηδέν”:
<?php if ( $a['count'] !== 0 || $a['count'] !== false ) : ?>
<span><?php echo esc_html( $a['count'] ); ?></span>
<?php endif; ?>
Επιλογή με returnFormat: both
Όταν χρειάζεστε τόσο την τιμή (για λογική) όσο και την ετικέτα (για εμφάνιση):
{
"id": "status",
"type": "select",
"label": "Status",
"returnFormat": "both",
"options": [
{ "value": "active", "label": "Active" },
{ "value": "paused", "label": "On Hold" },
{ "value": "closed", "label": "Closed" }
]
}
<?php if ( $a['status'] ) : ?>
<span class="badge badge--<?php echo esc_attr( $a['status']['value'] ); ?>">
<?php echo esc_html( $a['status']['label'] ); ?>
</span>
<?php endif; ?>
Χαρακτηριστικά δεδομένων από το πεδίο attributes
Ο τύπος πεδίου attributes επιτρέπει στους χρήστες να προσθέτουν προσαρμοσμένα χαρακτηριστικά δεδομένων:
{
"id": "dataAttrs",
"type": "attributes",
"label": "Data Attributes",
"link": true,
"media": true
}
<div useBlockProps <?php bs_render_data_attributes( $a['dataAttrs'] ); ?>>
Content here.
</div>
Μεταβλητές CSS από τιμές πεδίων
Δημιουργήστε προσαρμοσμένες ιδιότητες CSS από επιλεγμένα πεδία:
{
"id": "textColor", "type": "color", "label": "Text Color"
},
{
"id": "fontSize", "type": "unit", "label": "Font Size", "default": "1rem"
}
<div useBlockProps style="<?php bs_render_variables( $a, array( 'textColor', 'fontSize' ) ); ?>">
<p>Styled content.</p>
</div>
Αυτό παράγει το style="--text-color: #333; --font-size: 1rem;" (τα αναγνωριστικά πεδίων μετατρέπονται σε kebab-case). Χρησιμοποιήστε τις μεταβλητές στο CSS σας:
p {
color: var(--text-color);
font-size: var(--font-size);
}
Επόμενα βήματα
- Καταχώριση χαρακτηριστικών: οι ιδιότητες
id,type,label,default,help,positionκαιconditions. - Αναφορά τύπων πεδίων: αυτόματα δημιουργημένη αναφορά με κάθε ιδιότητα για κάθε τύπο πεδίου.
- Λογική συνθηκών: τελεστές, καθολικές συνθήκες, προσαρμοσμένα φίλτρα συνθηκών και περιβάλλον επανάληψης.
- Συμπλήρωση επιλογών: λειτουργίες query, function, custom και fetch για δυναμικά πεδία επιλογών.
- Προσαρμοσμένα πεδία:
field.json, διαδρομές εντοπισμού, το φίλτροblockstudio/fieldsκαι προηγμένα μοτίβαidStructure. - Απόδοση:
$a,$b,$c, κενές τιμές και βοηθητικές συναρτήσεις.