Plokiteegi loomine
Plokiteek on iseseisvate jaotisplokkide komplekt, millest saab koostada terviklikke lehti. Igal plokil on oma skeem, mall ja stiilid. Blockstudio pakub raamistikku: Tailwind CSS töötlemist, atribuutide registreerimist ja lehtede sünkroonimist. Teie loote plokid.
See juhend näitab, kuidas luua teek algusest peale, järgides sadades tootmiskasutuses olevates teemades rakendatud arhitektuuri. Lõpuks on teil toimiv teema päise, funktsioonide ruudustiku ja terviklikuks koostatud avalehega.
Kaustastruktuur
Iga Blockstudio teema kasutab sama paigutust:
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
Plokid asuvad kataloogis blockstudio/sections/. Iga plokk on kaust, milles on block.json skeem ja index.php mall. Lehed asuvad kataloogis pages/ ja koosnevad plokkidest, mida kasutatakse süntaksiga <block>.
Põhifailid
blockstudio.json
See fail määrab, kuidas Blockstudio teie teemat töötleb. Kõigi teemade konfiguratsioon on sama:
{
"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 eemaldab vaikimisi WordPress plokistiilid. fullWidth paneb page postitusetüübid laiusele venima. canvas lubab puhtama redigeerimiskogemuse jaoks redaktori lõuendirežiimi.
Väli tailwind.config on tahtlikult tühi. Kui kasutusel on Tailwind v4, asub kogu konfiguratsioon kataloogis style.css ja järgib CSS-põhist lähenemist.
index.php
Peamine mall WordPress. See on tavaline WordPress, mis ei sõltu Blockstudio-st:
<!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>
Kui vajate navigeerimist, lisage header.php ja footer.php. Praegu piisab plokkide renderdamiseks minimaalsest mallist.
Kujundustokenid
Kogu kujundamine toimub failis style.css, kasutades Tailwind v4 direktiivi @theme. See on teie kujundussüsteemi tuum.
/*
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;
}
Iga teema vajab vähemalt järgmist:
| Token | Otstarve |
|---|---|
--font-sans või --font-serif |
Põhifont |
--color-bg |
Lehe taust |
--color-elevated |
Kaardi või pinna taust |
--color-subtle |
Äärised ja eraldajad |
--color-muted |
Teisene tekst |
--color-accent |
Brändi põhivärv |
Nende tokenite põhjal luuakse automaatselt Tailwind utiliidiklassid. --color-accent muutub kujuks bg-accent, text-accent, border-accent ja nii edasi.
Heleda teema puhul pöörake väärtused ümber:
@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;
}
Põhistiilid ja utiliidid
Lisage pärast plokki @theme keha stiilid, baaskihi vaikeväärtused ja kohandatud utiliidid.
Keha stiilid peavad asuma väljaspool plokki @layer, et redaktor WordPress need üles leiaks:
body {
@apply bg-bg font-sans text-white antialiased;
}
Baaskiht elementide vaikeväärtuste jaoks:
@layer base {
section {
@apply relative overflow-hidden;
}
h1, h2, h3 {
text-wrap: balance;
}
p {
text-wrap: pretty;
}
}
Kohandatud utiliidid korduvkasutatavate mustrite jaoks. Iga teema määratleb järjepideva jaotisevahega container utiliidi ning tavaliselt ka utiliidid card, badge ja nuppude jaoks:
@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);
}
}
Pseudo-selektorid paigutage ploki @utility sisse ja kasutage pesastamist CSS (&:hover). Ärge kunagi pange neid utiliidi nimesse. @utility btn-primary:hover {} on vigane ja Tailwind lükkab selle tagasi.
@source tekstisiseselt
Blockstudio otsib teie plokimalle automaatselt Tailwind klasse. Kuid klassid, mida kasutatakse väljaspool plokimalle (failides functions.php, header.php, index.php), jäävad otsingust välja. Lisage need deklaratsiooniga @source inline:
@source inline("bg-bg bg-accent-tint container container-px container-no-pb");
See käsib Tailwind-il lisada need klassid väljundisse, kuigi need esinevad ainult failides PHP, mida läbi ei otsita.
Jaotise muster
Jaotise muster on Blockstudio plokiteegi kõige olulisem kokkulepe. Selle abil saab iga ploki vahet, tausta vahetamist ja polsterdust juhtida järjepidevalt kahe ühise mehhanismiga: kohandatud välja ja abifunktsiooniga PHP.
Jaotise väli
Looge ühine väljamääratlus, millele iga plokk saab viidata:
{
"$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"
}
]
}
]
}
See väli kuvatakse iga ploki inspektoris vahekaardi „Jaotis” all. Kliendid saavad kasutada kahte juhtelementi: aktsenttausta lülitit ja alumise polsterduse eemaldamist (kasulik jaotiste vahedeta virnastamiseks).
Jaotise abifunktsioon
Looge kaustas functions.php abifunktsioon, mis teisendab need atribuudid klassideks CSS:
<?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 );
}
Iga plokimall kutsub selle abifunktsiooni välja esimesel real. Abifunktsioon tagastab kaks klassistringi: ühe välimise elemendi <section> ja teise sisemise konteineri <div> jaoks.
Tailwind konfiguratsioonifilter
Lisage ka faili functions.php filter, mis edastab teie style.css komponendi Blockstudio töötlejale 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 '';
}
);
See käsib Blockstudio-il kasutada teie style.css-it Tailwind v4 konfiguratsiooniallikana. Ilma selleta poleks teie @theme tokenid ja @utility määratlused plokimallides saadaval.
Teie esimene plokk: päis
Päisejaotis näitab täielikku plokimustrit. Alustage skeemist:
{
"$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" }
]
}
]
}
]
}
}
Pange tähele järgmisi põhimustreid:
Ümbris tabs loob kahe vahekaardiga inspektori: „Sisu” ploki väljade jaoks ja „Jaotis” ühiste jaotise juhtelementide jaoks. Kõik plokid kasutavad sama struktuuri.
Väljad on korraldatud group konteineritesse. Rühmad eraldavad seotud väljad inspektoris visuaalselt. Esimeses rühmas on tekstiväljad, teises lingiväljad.
Vaikeväärtused annavad sisuka sisu, nii et plokk näeb terviklik välja kohe pärast lisamist. See on lehtede koostamisel hädavajalik, sest plokid lisatakse ilma kasutaja sekkumiseta.
Nüüd mall:
<?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>
Mall järgib järjepidevat mustrit:
- Kutsuge jaotise abifunktsioon välja, et saada CSS klassid
- Välimine
<section>koosuseBlockPropsja jaotise klassidega - Sisemine
<div>koos konteineri klassidega - Sisu renderdamine väärtusest
$a(atribuutide lühivorm) - Valikuliste väljade tingimuslik renderdamine
- Õige paomärkide kasutamine:
esc_html()teksti,esc_url()URL-ide jaesc_attr()atribuutide jaoks
Korduvad väljad: funktsioonide ruudustik
Korduvate väljade abil saavad kliendid elemente lisada, eemaldada ja ümber järjestada. Klassikaline näide on funktsioonide ruudustik:
{
"$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" }
]
}
]
}
]
}
}
Atribuut textMinimized määrab, millist teksti kuvatakse korduva välja rea kokkuklappimisel. See loeb välja title väärtuse ja kasutab tühja väärtuse korral teksti „Funktsioon”. Nii on inspektorit mugav kasutada ka paljude üksustega.
Massiiv default sisaldab algseid üksusi. Need kuvatakse ploki esmakordsel lisamisel. Lisage alati realistlikud vaikeväärtused, et plokk näeks kohe terviklik välja.
<?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>
Korduvate väljade üksustele pääseb ligi lihtsa PHP massiivina. Kasutage tsüklit foreach ja avage iga üksuse väljad nende id kaudu.
Pildid ja kohatäited
Piltidega plokkide puhul kasutage välja tüüpi files ja komponenti MediaPlaceholder. Kohatäide kuvab redaktoris pukseerimisala:
{
"id": "image",
"type": "files",
"label": "Image"
}
Renderdage mallis pilt käsuga wp_get_attachment_image() ja kuvage valimata pildi korral kohatäite 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() tagastab tekstisisese SVG, mis kasutab currentColor koos muutujaga --color-accent, nii et see kohandub automaatselt teemaga. Heledate teemade puhul kasutage blockstudio_placeholder_light(). Mõlemad aktsepteerivad variandi argumenti:
blockstudio_placeholder_dark( 'dashboard' ) // Dashboard mockup
blockstudio_placeholder_dark( 'chart' ) // Chart illustration
blockstudio_placeholder_dark( 'product' ) // Product shot
Lehtede koostamine
Lehtede paigutused koosnevad plokkidest, kasutades süntaksit <block>. Looge avaleht:
{
"name": "home",
"title": "Home",
"slug": "home",
"postType": "page",
"postStatus": "publish",
"templateLock": "all"
}
<block name="my-theme/hero"></block>
<block name="my-theme/features"></block>
Valmis. Iga <block> element lisab ploki selle atribuutide vaikeväärtustega. Käivitage wp bs pages sync, et rakendada lehe allikas väärtusele WordPress.
Lehepõhiste vaikeväärtuste ülekirjutamiseks edastage atribuudid otse:
<block name="my-theme/hero" heading="About Us" description="Our story and mission."></block>
<block name="my-theme/features" heading="Our Values"></block>
Kui templateLock väärtuseks on "all", ei saa kliendid plokke lisada, eemaldada ega ümber järjestada. Lehe struktuur on teie malliga lukustatud. Teiste lukustusrežiimide ja redigeerimisjuhtelementide kohta vaadake lehte Lehed.
Teegi laiendamine
Minimaalne teek algab 3–5 plokiga. Põhjalikus teegis on 8–14 plokki. Siin on levinumad plokitüübid ligikaudses kasutussageduse järjekorras:
| Plokk | Kirjeldus | Põhiväljad |
|---|---|---|
| Päis | Suur pealkiri ja tegevuskutsed | pealkiri, kirjeldus, lingid |
| Funktsioonid | Eeliste ruudustik | pealkiri, korduv väli pealkirja ja kirjeldusega |
| CTA | Tegevuskutse riba | pealkiri, kirjeldus, link |
| Hinnad | Pakettide võrdlus | pealkiri, korduv väli nime, hinna ja funktsioonidega |
| Klienditagasiside | Klientide tsitaadid | korduv väli tsitaadi, nime ja rolliga |
| KKK | Küsimuste akordion | pealkiri, korduv väli küsimuse ja vastusega |
| Logod | Klientide logode kogum | pealkiri (logod on tavaliselt kõvakodeeritud SVG-d) |
| Sisu | Vahelduvad teksti- ja pildiread | korduv väli pealkirja, kirjelduse ja pildiga |
| Esitlus | Täislaiuses pilt allkirjaga | pealkiri, kirjeldus, pilt |
| Meeskond | Meeskonnaliikmete ruudustik | pealkiri, korduv väli nime, rolli ja pildiga |
| Statistika | Olulised mõõdikud | korduv väli numbri ja sildiga |
Iga plokk järgib sama mustrit: vahekaardid (Sisu ja Jaotis), rühmad korrastamiseks, korduvad väljad loendite jaoks ning jaotise abifunktsioon järjepideva vahe jaoks. Kui olete kaks või kolm plokki valmis saanud, on järgmiste lisamine mehaaniline töö.
Lehtede lisamine
Teegi kasvades saate samadest plokkidest koostada erinevaid lehti:
<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>
Samad plokid sobivad mitmele lehele, igaühel erinevad vaikeväärtused. See on teegipõhise lähenemise eelis: looge plokid üks kord ja kasutage neid nii paljude lehtede koostamiseks, kui vaja.
Järgmised sammud
- Atribuutide registreerimine: väljatüüpide ja omaduste täielik viide
- Väljatüübid: kõik saadaolevad väljatüübid
- Väljamustrite retseptiraamat: tingimuslikud rühmad, nutikad valikud ja korduvate väljade näited
- Lehed: mallide lukustamine, redigeerimisrežiimid ja võtmete alusel ühendamine
- Failipõhiste lehtede loomine: praktiline juhend lehemallide ja sünkroonimise kohta
- Interaktiivsus: kliendipoolse käitumise lisamine plokkidele