Bloku bibliotēkas izveide
Bloku bibliotēka ir patstāvīgu sadaļu bloku kopums, no kura veido pilnas lapas. Katram blokam ir sava shēma, veidne un stili. Blockstudio nodrošina ietvaru: Tailwind CSS apstrādi, atribūtu reģistrēšanu un lapu sinhronizēšanu. Jūs izveidojat blokus.
Šajā ceļvedī soli pa solim aplūkota bibliotēkas izveide no nulles, izmantojot to pašu arhitektūru, kas tiek lietota simtiem ražošanas motīvu. Beigās jums būs gatavs motīvs ar galveno sadaļu, funkciju režģi un saliktu sākumlapu.
Mapju struktūra
Katram Blockstudio motīvam ir šāds izkārtojums:
my-theme/
├── style.css # WordPress header + Tailwind v4 config
├── blockstudio.json # Blockstudio settings
├── functions.php # Section helper + Tailwind filter
├── index.php # Main WordPress template
├── blockstudio/
│ ├── fields/
│ │ └── section/
│ │ └── field.json # Shared section controls
│ └── sections/
│ ├── hero/
│ │ ├── block.json
│ │ └── index.php
│ └── features/
│ ├── block.json
│ └── index.php
└── pages/
└── home/
├── page.json
└── index.php
Bloki atrodas mapē blockstudio/sections/. Katrs bloks ir mape ar block.json shēmu un index.php veidni. Lapas atrodas mapē pages/, un tajās bloki tiek salikti, izmantojot sintaksi <block>.
Pamata faili
blockstudio.json
Šis fails konfigurē, kā Blockstudio apstrādā jūsu motīvu. Konfigurācija visiem motīviem ir vienāda:
{
"assets": {
"enqueue": true,
"reset": {
"enabled": true,
"fullWidth": ["page"]
},
"minify": { "css": true, "js": true },
"process": { "scss": false, "scssFiles": true }
},
"tailwind": {
"enabled": true,
"config": ""
},
"dev": {
"canvas": { "enabled": true }
},
"$schema": "https://blockstudio.dev/schema/blockstudio"
}
reset noņem WordPress noklusējuma bloku stilus. fullWidth liek page ziņu tipiem aizņemt pilnu platumu. canvas iespējo redaktora audekla režīmu, lai rediģēšana būtu ērtāka.
Lauks tailwind.config ir apzināti atstāts tukšs. Izmantojot Tailwind v4, visa konfigurācija atrodas mapē style.css un izmanto pieeju, kurā vispirms veido CSS.
index.php
Galvenā WordPress veidne. Tā ir parasts WordPress, nekas īpaši saistīts ar Blockstudio:
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
<?php wp_head(); ?>
</head>
<body <?php body_class(); ?>>
<?php wp_body_open(); ?>
<main>
<?php
if ( have_posts() ) {
while ( have_posts() ) {
the_post();
the_content();
}
}
?>
</main>
<?php wp_footer(); ?>
</body>
</html>
Ja nepieciešama navigācija, pievienojiet header.php un footer.php. Pagaidām bloku renderēšanai pietiek ar minimālu veidni.
Dizaina tokeni
Visa motīva noformēšana notiek failā style.css, izmantojot Tailwind v4 direktīvu @theme. Tas ir jūsu dizaina sistēmas pamats.
/*
Theme Name: My Theme
Theme URI: https://example.com
Description: A clean theme built with Blockstudio.
Version: 1.0.0
Requires at least: 6.0
Requires PHP: 8.2
Author: Your Name
Text Domain: my-theme
*/
@theme {
--font-sans: 'Inter', ui-sans-serif, system-ui, sans-serif;
--color-bg: #050505;
--color-elevated: #111111;
--color-subtle: rgb(255 255 255 / 0.06);
--color-muted: #888888;
--color-accent: #6366f1;
--color-accent-hover: #4f46e5;
}
Katram motīvam nepieciešami vismaz šādi elementi:
| Tokens | Nolūks |
|---|---|
--font-sans vai --font-serif |
Primārais burtveidols |
--color-bg |
Lapas fons |
--color-elevated |
Kartītes/virsmas fons |
--color-subtle |
Apmales un atdalītāji |
--color-muted |
Sekundārais teksts |
--color-accent |
Zīmola primārā krāsa |
Šie tokeni automātiski ģenerē Tailwind utilītklases. --color-accent kļūst par bg-accent, text-accent, border-accent un tā tālāk.
Gaišam motīvam apgrieziet vērtības:
@theme {
--font-serif: 'Zilla Slab', serif;
--font-sans: 'DM Sans', sans-serif;
--color-bg: #f5f0e8;
--color-elevated: #ece6da;
--color-heading: #2c1810;
--color-body: #6b5c4f;
--color-muted: #9a8b7d;
--color-accent: #2d5016;
--color-subtle: #d9d1c4;
}
Pamatstili un utilītklases
Zem bloka @theme pievienojiet pamatstila noteikumus lapas saturam, bāzes slāņa noklusējuma iestatījumus un pielāgotas utilītklases.
Lapas satura stiliem jābūt ārpus @layer, lai tos pārņemtu redaktors WordPress:
body {
@apply bg-bg font-sans text-white antialiased;
}
Bāzes slānis elementu noklusējuma iestatījumiem:
@layer base {
section {
@apply relative overflow-hidden;
}
h1, h2, h3 {
text-wrap: balance;
}
p {
text-wrap: pretty;
}
}
Pielāgotas utilītklases atkārtoti izmantojamām struktūrām. Katrā motīvā ir definēta utilītklase container, kas nodrošina vienādas atstarpes starp sadaļām, kā arī parasti card, badge un pogu utilītklases:
@utility container-px {
@apply mx-auto max-w-5xl px-6;
}
@utility container {
@apply container-px py-24 sm:py-32;
}
@utility container-no-pb {
@apply pb-0 sm:pb-0;
}
@utility card {
@apply rounded-2xl border border-subtle bg-elevated/80 p-8 transition-all duration-300;
&:hover {
border-color: rgb(255 255 255 / 0.1);
}
}
@utility badge {
@apply inline-flex items-center gap-2 rounded-full border border-subtle bg-white/5 px-3.5 py-1.5 text-sm text-muted;
}
@utility btn-primary {
@apply inline-flex items-center gap-2 rounded-full bg-accent px-6 py-3 text-sm font-medium text-white transition-colors;
&:hover {
@apply bg-accent-hover;
}
}
@utility btn-secondary {
@apply inline-flex items-center gap-2 rounded-full border border-subtle px-6 py-3 text-sm font-medium text-white transition-all;
&:hover {
border-color: rgb(255 255 255 / 0.15);
background: rgb(255 255 255 / 0.04);
}
}
Pseidoselektori jāievieto bloka @utility iekšpusē, izmantojot CSS ligzdošanu (&:hover). Nekad nenorādiet tos utilītklases nosaukumā. @utility btn-primary:hover {} nav derīgs, un Tailwind to noraidīs.
@source iekļaušana
Blockstudio automātiski skenē jūsu bloku veidnes, meklējot Tailwind klases. Taču klases, kas tiek izmantotas ārpus bloku veidnēm (failos functions.php, header.php un index.php), netiek skenētas. Norādiet tās ar @source inline:
@source inline("bg-bg bg-accent-tint container container-px container-no-pb");
Tas liek Tailwind iekļaut šīs klases izvadē, lai gan tās ir tikai failos PHP, kuri netiek skenēti.
Sadaļu struktūra
Sadaļu struktūra ir svarīgākā vienošanās Blockstudio bloku bibliotēkā. Tā visiem blokiem nodrošina vienādas atstarpes, fona pārslēgšanu un atkāpju vadību, izmantojot divus kopīgus mehānismus: pielāgotu lauku un palīgfunkciju PHP.
Sadaļas lauks
Izveidojiet kopīgu lauka definīciju, ko var izmantot katrs bloks:
{
"$schema": "https://blockstudio.dev/schema/field",
"name": "section",
"title": "Section",
"attributes": [
{
"type": "group",
"attributes": [
{
"id": "removeBottomPadding",
"type": "toggle",
"label": "Remove bottom padding"
},
{
"id": "accentBg",
"type": "toggle",
"label": "Accent background"
}
]
}
]
}
Šis lauks tiek rādīts katra bloka inspektorā cilnē “Sadaļa”. Klientiem ir pieejamas divas vadīklas: ieslēgt akcenta fonu un noņemt apakšējo iekšējo atkāpi (noderīgi, lai bez atstarpēm savienotu sadaļas).
Sadaļas palīgfunkcija
Failā functions.php izveidojiet palīgfunkciju, kas šos atribūtus pārveido par CSS klasēm:
<?php
/**
* My Theme functions.
*
* @package My_Theme
*/
/**
* Returns section and container class strings based on block attributes.
*
* @param array $a Block attributes.
* @param string $extra_section Additional classes for the section element.
* @param string $extra_container Additional classes for the container element.
* @return array Array of [ section_classes, container_classes ].
*/
function mytheme_section_classes( array $a, string $extra_section = '', string $extra_container = '' ): array {
$section = ! empty( $a['accentBg'] ) ? 'bg-accent-tint' : 'bg-bg';
$container = 'container';
if ( ! empty( $a['removeBottomPadding'] ) ) {
$container .= ' container-no-pb';
}
if ( $extra_section ) {
$section .= ' ' . $extra_section;
}
if ( $extra_container ) {
$container .= ' ' . $extra_container;
}
return array( $section, $container );
}
Katra bloka veidne izsauc šo palīgfunkciju pirmajā rindā. Palīgfunkcija atgriež divas klašu virknes: vienu ārējam <section> elementam un otru iekšējam <div> konteineram.
Tailwind konfigurācijas filtrs
Tajā pašā failā functions.php pievienojiet filtru, kas nodod jūsu style.css Blockstudio procesoram Tailwind:
add_filter(
'blockstudio/settings/tailwind/config',
function () {
$style = get_stylesheet_directory() . '/style.css';
if ( file_exists( $style ) ) {
// phpcs:ignore WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents -- Reading local theme file.
return file_get_contents( $style );
}
return '';
}
);
Tas liek Blockstudio izmantot jūsu style.css kā Tailwind v4 konfigurācijas avotu. Bez tā jūsu @theme tokeni un @utility definīcijas bloku veidnēs nebūtu pieejamas.
Pirmais bloks: galvenā sadaļa
Galvenā sadaļa parāda visu bloka struktūru. Sāciet ar shēmu:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "my-theme/hero",
"title": "Hero",
"category": "my-theme",
"icon": "star-filled",
"description": "Full-width hero section with heading, description, and buttons.",
"blockstudio": {
"attributes": [
{
"type": "tabs",
"tabs": [
{
"title": "Content",
"attributes": [
{
"type": "group",
"attributes": [
{
"id": "heading",
"type": "text",
"label": "Heading",
"default": "Build beautiful websites without the complexity"
},
{
"id": "description",
"type": "textarea",
"label": "Description",
"default": "A powerful framework that lets you create stunning designs using the WordPress editor."
}
]
},
{
"type": "group",
"attributes": [
{
"id": "primaryButton",
"type": "link",
"label": "Primary Button",
"default": {
"title": "Get Started",
"url": "#"
}
},
{
"id": "secondaryButton",
"type": "link",
"label": "Secondary Button",
"default": {
"title": "Learn More",
"url": "#"
}
}
]
}
]
},
{
"title": "Section",
"attributes": [
{ "type": "custom/section" }
]
}
]
}
]
}
}
Galvenie principi, kam pievērst uzmanību:
Aptvērējs tabs izveido inspektoru ar divām cilnēm: “Saturs” bloka laukiem un “Sadaļa” kopīgajām sadaļas vadīklām. Šādu struktūru izmanto katrs bloks.
Lauki ir sakārtoti group konteineros. Grupas inspektorā vizuāli nodala saistītos laukus. Pirmajā grupā ir teksta lauki, bet otrajā — saišu lauki.
Noklusējuma vērtības nodrošina jēgpilnu saturu, lai bloks izskatītos pabeigts uzreiz pēc ievietošanas. Tas ir īpaši svarīgi, saliekot lapu, jo bloki tiek pievienoti bez lietotāja darbībām.
Tagad izveidojiet veidni:
<?php list( $section_classes, $container_classes ) = mytheme_section_classes( $a, '', 'text-center' ); ?>
<section useBlockProps class="<?php echo esc_attr( $section_classes ); ?>">
<div class="<?php echo esc_attr( $container_classes ); ?>">
<h1 class="text-5xl font-medium tracking-tight sm:text-6xl lg:text-7xl">
<?php echo esc_html( $a['heading'] ); ?>
</h1>
<?php if ( ! empty( $a['description'] ) ) : ?>
<p class="mt-6 text-lg leading-relaxed text-muted max-w-xl mx-auto">
<?php echo esc_html( $a['description'] ); ?>
</p>
<?php endif; ?>
<div class="mt-10 flex items-center justify-center gap-x-4">
<?php if ( ! empty( $a['primaryButton']['url'] ) ) : ?>
<a href="<?php echo esc_url( $a['primaryButton']['url'] ); ?>" class="btn-primary">
<?php echo esc_html( $a['primaryButton']['title'] ); ?>
</a>
<?php endif; ?>
<?php if ( ! empty( $a['secondaryButton']['url'] ) ) : ?>
<a href="<?php echo esc_url( $a['secondaryButton']['url'] ); ?>" class="btn-secondary">
<?php echo esc_html( $a['secondaryButton']['title'] ); ?>
</a>
<?php endif; ?>
</div>
</div>
</section>
Veidnei ir vienota struktūra:
- Izsauciet sadaļas palīgfunkciju, lai iegūtu CSS klases
- Ārējais
<section>aruseBlockPropsun sadaļas klasēm - Iekšējais
<div>ar konteinera klasēm - Saturs tiek renderēts no
$a(saīsinātā atribūtu pieraksta) - Nosacīta izvēles lauku renderēšana
- Pareiza datu atkodēšana:
esc_html()tekstam,esc_url()URL,esc_attr()atribūtiem
Atkārtotāji: funkciju režģis
Atkārtotāji ļauj klientiem pievienot, noņemt un pārkārtot vienumus. Funkciju režģis ir klasisks piemērs:
{
"$schema": "https://blockstudio.dev/schema/block",
"name": "my-theme/features",
"title": "Features",
"category": "my-theme",
"icon": "grid-view",
"description": "Feature grid with titles and descriptions.",
"blockstudio": {
"attributes": [
{
"type": "tabs",
"tabs": [
{
"title": "Content",
"attributes": [
{
"type": "group",
"attributes": [
{
"id": "heading",
"type": "text",
"label": "Heading",
"default": "Everything you need"
},
{
"id": "description",
"type": "textarea",
"label": "Description",
"default": "Our toolkit gives you the building blocks to go from idea to production."
}
]
},
{
"type": "group",
"attributes": [
{
"id": "features",
"type": "repeater",
"label": "Features",
"textMinimized": {
"id": "title",
"fallback": "Feature"
},
"default": [
{
"title": "Lightning Fast",
"description": "Optimized for performance with minimal overhead."
},
{
"title": "Fully Responsive",
"description": "Every component adapts across all screen sizes."
},
{
"title": "Easy to Customize",
"description": "Adjust every detail to match your brand."
}
],
"attributes": [
{
"id": "title",
"type": "text",
"label": "Title"
},
{
"id": "description",
"type": "textarea",
"label": "Description"
}
]
}
]
}
]
},
{
"title": "Section",
"attributes": [
{ "type": "custom/section" }
]
}
]
}
]
}
}
Īpašība textMinimized nosaka, kāds teksts tiek rādīts, kad atkārtotāja rinda ir sakļauta. Tā nolasa lauka title vērtību, bet, ja lauks ir tukšs, izmanto “Funkcija”. Tādējādi inspektoru ir ērti lietot arī tad, ja ir daudz vienumu.
Masīvs default nodrošina sākotnējos vienumus. Tie tiek parādīti, kad bloks ir ievietots pirmoreiz. Vienmēr norādiet reālistiskas noklusējuma vērtības, lai bloks uzreiz izskatītos pabeigts.
<?php list( $section_classes, $container_classes ) = mytheme_section_classes( $a ); ?>
<section useBlockProps class="<?php echo esc_attr( $section_classes ); ?>">
<div class="<?php echo esc_attr( $container_classes ); ?>">
<?php if ( ! empty( $a['heading'] ) ) : ?>
<div class="text-center max-w-2xl mx-auto">
<h2 class="text-3xl font-medium tracking-tight sm:text-4xl">
<?php echo esc_html( $a['heading'] ); ?>
</h2>
<?php if ( ! empty( $a['description'] ) ) : ?>
<p class="mt-4 text-base leading-relaxed text-muted">
<?php echo esc_html( $a['description'] ); ?>
</p>
<?php endif; ?>
</div>
<?php endif; ?>
<?php if ( ! empty( $a['features'] ) ) : ?>
<div class="mt-16 grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3">
<?php foreach ( $a['features'] as $feature ) : ?>
<div class="card">
<h3 class="text-sm font-medium">
<?php echo esc_html( $feature['title'] ); ?>
</h3>
<p class="mt-2 text-sm leading-relaxed text-muted">
<?php echo esc_html( $feature['description'] ); ?>
</p>
</div>
<?php endforeach; ?>
</div>
<?php endif; ?>
</div>
</section>
Atkārtotāja vienumiem var piekļūt kā vienkāršam PHP masīvam. Izmantojiet foreach cilpu un piekļūstiet katra vienuma laukiem pēc to id.
Attēli un vietturi
Blokiem ar attēliem izmantojiet lauka veidu files un komponentu MediaPlaceholder. Viettura vietā redaktorā tiek rādīts vilkšanas un nomešanas apgabals:
{
"id": "image",
"type": "files",
"label": "Image"
}
Veidnē renderējiet attēlu ar wp_get_attachment_image() un, ja attēls nav atlasīts, rādiet viettura SVG:
<div class="overflow-hidden rounded-2xl bg-elevated">
<MediaPlaceholder attribute="image" allowedTypes="<?php echo esc_attr( wp_json_encode( array( 'image' ) ) ); ?>" />
<?php if ( ! empty( $a['image'] ) ) : ?>
<?php echo wp_get_attachment_image( $a['image'][0]['ID'], 'full', false, array( 'class' => 'block w-full' ) ); ?>
<?php else : ?>
<?php echo blockstudio_placeholder_dark(); ?>
<?php endif; ?>
</div>
blockstudio_placeholder_dark() atgriež iekļautu SVG, kurā izmantots currentColor ar mainīgo --color-accent, tāpēc tas automātiski pielāgojas jūsu motīvam. Gaišiem motīviem izmantojiet blockstudio_placeholder_light(). Abiem var norādīt variantu:
blockstudio_placeholder_dark( 'dashboard' ) // Dashboard mockup
blockstudio_placeholder_dark( 'chart' ) // Chart illustration
blockstudio_placeholder_dark( 'product' ) // Product shot
Lapu salikšana
Lapas tiek veidotas no blokiem, izmantojot sintaksi <block>. Izveidojiet sākumlapu:
{
"name": "home",
"title": "Home",
"slug": "home",
"postType": "page",
"postStatus": "publish",
"templateLock": "all"
}
<block name="my-theme/hero"></block>
<block name="my-theme/features"></block>
Gatavs. Katrs elements <block> ievieto bloku ar tā noklusējuma atribūtu vērtībām. Palaidiet wp bs pages sync, lai lietotu lapas avotu WordPress.
Lai konkrētai lapai aizstātu noklusējuma vērtības, norādiet atribūtus tieši:
<block name="my-theme/hero" heading="About Us" description="Our story and mission."></block>
<block name="my-theme/features" heading="Our Values"></block>
Ja templateLock ir iestatīts uz "all", klienti nevar pievienot, noņemt vai pārkārtot blokus. Lapas struktūru nosaka jūsu veidne. Par citiem bloķēšanas režīmiem un rediģēšanas vadīklām skatiet Lapu pārvaldība.
Bibliotēkas paplašināšana
Minimālā bibliotēkā ir 3–5 bloki, bet visaptverošā — 8–14. Tālāk norādīti biežāk izmantotie bloku veidi, aptuveni sakārtoti pēc lietošanas biežuma:
| Bloks | Apraksts | Galvenie lauki |
|---|---|---|
| Galvenā sadaļa | Liels virsraksts ar aicinājumiem uz darbību | virsraksts, apraksts, saites |
| Funkcijas | Priekšrocību režģis | virsraksts, atkārtotājs ar nosaukumu un aprakstu |
| Aicinājums uz darbību | Reklāmkarogs ar aicinājumu uz darbību | virsraksts, apraksts, saite |
| Cenas | Plānu salīdzinājums | virsraksts, atkārtotājs ar nosaukumu, cenu un funkcijām |
| Atsauksmes | Klientu citāti | atkārtotājs ar citātu, vārdu un amatu |
| BUJ | Jautājumu akordeons | virsraksts, atkārtotājs ar jautājumu un atbildi |
| Logotipi | Klientu logotipu kopa | virsraksts (logotipi parasti ir statiski SVG attēli) |
| Saturs | Pamīšus teksta un attēla rindas | atkārtotājs ar virsrakstu, aprakstu un attēlu |
| Galerija | Pilna platuma attēls ar parakstu | virsraksts, apraksts, attēls |
| Komanda | Komandas dalībnieku režģis | virsraksts, atkārtotājs ar vārdu, amatu un attēlu |
| Statistika | Svarīgākie rādītāji | atkārtotājs ar skaitli un etiķeti |
Visiem blokiem ir vienāda struktūra: cilnes (“Saturs” un “Sadaļa”), grupas organizēšanai, atkārtotāji sarakstiem un sadaļas palīgfunkcija vienādām atstarpēm. Kad būsiet izveidojuši divus vai trīs blokus, pārējo pievienošana būs vienkārša.
Vairāk lapu pievienošana
Bibliotēkai augot, no tiem pašiem blokiem veidojiet dažādas lapas:
<block name="my-theme/hero" heading="Simple, Transparent Pricing" description="Choose the plan that fits."></block>
<block name="my-theme/pricing"></block>
<block name="my-theme/faq" heading="Pricing FAQ"></block>
<block name="my-theme/cta"></block>
<block name="my-theme/hero" heading="About Us" description="Our story."></block>
<block name="my-theme/team"></block>
<block name="my-theme/testimonials"></block>
<block name="my-theme/cta" heading="Join Our Team"></block>
Tie paši bloki kalpo vairākām lapām, katrai ar atšķirīgām noklusējuma vērtībām. Tā ir bibliotēkas pieejas priekšrocība: izveidojiet blokus vienreiz un salieciet no tiem tik daudz lapu, cik nepieciešams.
Nākamie soļi
- Atribūtu reģistrēšana: pilna uzziņu informācija par lauku veidiem un īpašībām
- Lauku veidi: visi pieejamie lauku veidi
- Lauku struktūru piemēru krājums: nosacījumu grupas, viedās atlases izvēlnes un atkārtotāju paraugi
- Lapas: veidņu bloķēšana, rediģēšanas režīmi un apvienošana pēc atslēgām
- Uz failiem balstītu lapu izveide: praktisks ceļvedis par lapu veidnēm un sinhronizēšanu
- Interaktivitāte: klienta puses darbības pievienošana blokiem