# Täielikud lehed koodis määratuna

Mallid ja Markdown sünkroonitakse ühe käsuga keskkonda WordPress.

## Failidest loodud kogud

Määrake `pages.json` ja laske Blockstudio-l kõik selle alamkataloogide allikad avastada. Pesastatud teedest saavad pesastatud lehed, vaikeseaded kehtivad kogule ning puuduvad ülemlehed saab luua.

Kasutage kogusid dokumentatsiooni, teadmistebaaside või sihtlehtede jaoks ning ühendage välised kaustad teeprefiksi alla käsuga `loader.php`.

Lisage `pages.json` kõrvale `layout.php` või renderdaja paigutus, näiteks `layout.tsx`, et mähkida kogu kogu iga leht ühte kesta, kus külgriba jaoks on `blockstudio_page_tree()`.

[Lehekogud](https://blockstudio.dev/et/docs/pages-and-patterns/pages/#page-collections)

pages/docs/pages.json

```
{
  "collection": "docs",
  "title": "Documentation",
  "postType": "bs_docs",
  "defaults": {
    "postStatus": "publish",
    "templateLock": "contentOnly"
  }
}
```

## Selgesõnaline sünkroonimine

wp bs pages sync rakendab muudatused; muutmata lehtede kirjutamine ei maksa midagi.

## Markdown allikad

Kasutage index.md-i koos päiseandmetega või ühendage page.json sisuga Markdown.

## Toores Markdown

Markdown faililehed vastavad nende URL aadressil, millele lisatakse .md, või tavalisel URL aadressil päise Accept: text/markdown korral; kaasas on kanooniline link tagasi HTML juurde.

## Kogulaadurid

Ühendage välise dokumentatsiooni kaustad kogusse teeprefiksi alla.

## Saidi kogud

pages.json, mille ulatus on site, rakendab ühiseid vaikeväärtusi tervele lehtede puule ja loetleb selle, muutmata URL-e ega postitusridu.

## Navigeerimisabilised

blockstudio_page_tree(), blockstudio_page_children(), blockstudio_current_page() ja blockstudio_page_content() loovad külgribasid, leheküljevahetajaid ja sisuosa.

## Kogud ja postitustüübid

Kogud saavad registreerida spetsiaalsed hierarhilised postitustüübid.

## Mallide lukustamine

Lukustage lehed või üksikud plokid väärtustega contentOnly, all või insert.

## Kirjuta HTML, saad plokid

Standardelemendid, näiteks `<h1>`, `<p>` ja `<ul>`, vastendatakse tuumplokkidega. Kasutage `<block>` kõigi muude plokinimede ja pesastustasemete jaoks.

Blockstudio parsib täielikud lehepaigutused päris redigeeritavateks WordPress plokkideks.

[Lehesüntaksi teatmik](https://blockstudio.dev/et/docs/pages-and-patterns/pages/)

index.php

```
<div>
  <h1 blockEditingMode="contentOnly">About Us</h1>
  <p>We build tools for WordPress developers.</p>
  <img src="/team.jpg" alt="Our team" />
</div>

<block name="core/columns">
  <block name="core/column"><h2>Our Mission</h2></block>
  <block name="core/column"><h2>Our Stack</h2></block>
</block>
```

## Komponentide renderdatud lehed

Määrake `render` väärtuseks `page.json`-is kirje, näiteks `page.tsx`, ja `data.php` laadija; seejärel renderdab teie teema või plugina registreeritud leherenderdaja kogu lehe. Sünkroonimine salvestab ühe `blockstudio/page` ploki ning WordPress sisu, näiteks lühikood, jääb oma pesasse.

Renderdaja tagastatud varasid töödeldakse samamoodi nagu ploki varasid ja prinditakse üks kord, nii et eelt renderdatud leht sisaldab neid. blockstudio.dev ise luuakse komponentlehtedest.

[Komponentlehed](https://blockstudio.dev/et/docs/pages-and-patterns/pages/#component-pages)

pages/legal-notice/page.json

```
{
  "name": "legal-notice",
  "title": "Legal Notice",
  "slug": "legal-notice",
  "postStatus": "publish",
  "render": { "entry": "page.tsx", "data": "data.php" }
}
```

## Postituseta marsruudid

`Blockstudio\Virtual_Routes::register()` serveerib dokumenti, mille taga pole postitust, näiteks komponendi viidet või kataloogi. `prefix` ja `match` abil vastab üks registreering tervele URL-ide perele ning tagastades `null`, jätate URL WordPress hooleks.

Marsruut renderdatakse Blockstudio väljundpuhvris, nii et selle plokid saavad oma varad ja Tailwind väljundi. `urls` teed lisatakse staatiliste eelt renderdamise järkude hulka ning `Virtual_Routes::urls()` tagastab need saidikaardi jaoks.

[Virtuaalsed marsruudid](https://blockstudio.dev/et/docs/pages-and-patterns/pages/#virtual-routes)

functions.php

```
add_action( 'init', function () {
    Blockstudio\Virtual_Routes::register(
        'components',
        function ( $component, string $rest ) {
            get_header();
            echo my_component_page( $component );
            get_footer();
        },
        [
            'prefix' => true,
            'match'  => fn ( string $rest ) => '' === $rest ? 'index' : my_component( $rest ),
            'title'  => fn ( $component ) => my_component_title( $component ),
            'urls'   => fn () => my_component_paths(),
        ]
    );
} );
```

## Sünkroonige siis, kui ise soovite

Lehefaile muudetakse WordPress-is ainult teie soovil. `wp bs pages sync` rakendab kõik muudetud allikad, säilitab võtmega redaktori sisu ning eemaldab lehed, mille failid on kadunud.

Sõrmejäljed hõlmavad manifeste, laadureid, paigutusi ja allikaid, nii et muutmata lehtede kirjutamine ei maksa midagi. Juurutused käivitavad käsu `Pages::reconcile()` ja saavad masinloetava aruande.

[Sünkroonimise käitumine](https://blockstudio.dev/et/docs/pages-and-patterns/pages/#sync-behavior)

Terminal

```
# Apply changed sources, keep keyed edits
wp bs pages sync

# Replace managed content from the files
wp bs pages sync --authoritative

# Compare every page and report as JSON
wp bs pages sync --full --format=json
```

## Võtmega plokid säilitavad sisu

Lisage `key` mis tahes plokile. Järgmisel sünkroonimisel ühendavad võtmega plokid malli atribuudid olemasoleva kasutaja sisuga, võtmeta plokid aga asendatakse.

Muutke struktuuri juurutuste käigus, säilitades samal ajal kliendi sisu.

[Võtmega plokid](https://blockstudio.dev/et/docs/pages-and-patterns/pages/#keyed-block-merging)

index.php

```
<h1 key="title">About Us</h1>
<block name="core/cover" key="hero" url="/hero.jpg">
  <h2>Welcome to our company</h2>
  <p>Edit this content freely.</p>
</block>
<block name="core/columns" key="team">
  <block name="core/column"><h3>Our Team</h3></block>
</block>
```

## Mallide lukustamine ja redigeerimisrežiimid

`"all"` takistab muudatusi, `"contentOnly"` lukustab struktuuri, lubades samal ajal teksti muuta, ning `"insert"` lubab muuta järjekorda ja sisu, kuid ei luba elemente lisada ega eemaldada.

Kirjutage mis tahes elemendi säte käsuga `blockEditingMode` üle, et muuta lukustatud leht valikuliselt redigeeritavaks või üksik plokk keelata.

[Mallide lukustamine](https://blockstudio.dev/et/docs/pages-and-patterns/pages/#template-lock)

index.php

```
<h1>Welcome to Our Product</h1>
<p>The best solution for your needs.</p>
<block name="core/cover" blockEditingMode="disabled" url="/static-banner.jpg">
  <p>Promotional banner</p>
</block>
<block name="core/group" blockEditingMode="default">
  <h2>Customizable Section</h2>
</block>
```

## Site Editori mallid failidest

Lisage `templates/`-i fail `template.json` ja mall või lisage `parts/`-i `part.json`; nii saab teie plokiteema failipõhised allikad `wp_template` ja `wp_template_part` jaoks.

Need kasutavad lehtedega sama süntaksit. Site Editoris tehtud kohandus jääb kehtima, kuni keegi selle lähtestab; seejärel taastub failiallikas.

[Saidimallid](https://blockstudio.dev/et/docs/pages-and-patterns/site-templates/)

templates/front-page/index.php

```
<block name="core/template-part" slug="header" />

<div>
  <h1>Welcome</h1>
  <block name="core/post-content" />
</div>

<block name="core/template-part" slug="footer" />
```

## Valitud andmebaasisisu asukohas git

`wp bs content pull` ekspordib lubatud postitused, terminid, seosed ja deklareeritud metaandmed kaasaskantavatesse failidesse ning `push` rakendab need teises keskkonnas. Deklareeritud viited, vanemad ja terminiseosed liiguvad püsivate UID-dena.

Lehe sünkroonimisega hallatavad postitused saavad liituda `includePageSyncManaged`-iga. Nende failid sisaldavad `"bodyOwner": "page-sync"`, nii et Content Sync teisaldab metaandmed, samal ajal kui lehe sünkroonimine hoiab sisu alles.

[Sisu sünkroonimine](https://blockstudio.dev/et/docs/content-sync/)

blockstudio.json

```
{
  "content": {
    "enabled": true,
    "id": "default",
    "path": "content",
    "postTypes": ["team_member"],
    "taxonomies": ["category"],
    "meta": {
      "include": ["_my_*"],
      "references": {
        "_thumbnail_id": { "kind": "attachment" },
        "_related_posts": { "kind": "post", "path": "*" }
      }
    },
    "media": "manifest"
  }
}
```

## Võtmega plokid

Säilitage kasutaja sisu mallide arenedes.

## Redigeerimisrežiimid

Määrake lehe vaikeväärtused ja kirjutage üksikute elementide sätted üle.

## Plokisidumised

Ühendage plokid postituse metaandmetega, et sisu säiliks sünkroonimisel.

## Postitustüübi mallid

templateFor määrab lehe iga uut tüüpi postituse algseks plokistruktuuriks.

## Kinnitatud postituste ID-d

postId taastab sama ID, kui leht kustutatakse ja uuesti sünkroonitakse, nii et menüüd ja lingid töötavad edasi.

## Põhjad ja lukud

sync: false koos Pages::force_sync()-ga loob lehe üks kord, et toimetajad saaksid seda ise hallata. Pages::lock() ja unlock() jätavad ühe lehe sünkroonimisest välja.

## Kohandatud parseri renderdajad

Ehitaja ja renderdaja filtrid muudavad plokisildi kolmanda osapoole ploki plokimassiiviks või muudavad tuumploki kirjutamisviisi.

## Elementide vastendamine

Vastendage HTML element teise plokiga, valige plokk elemendi atribuutide põhjal ja suunake lõigu HTML sisuväljale.

## Kohandatud avastusteed

Filtrid lisavad lehtede, mustrite ja saidiredaktori mallide juurkaustu, näiteks plugina kaudu.

## Loogilised avastusallikad

Eelvaated, ülekatted ja loodud teemad saavad anda Blockstudio-le koostatud failide loendi ühe teemakausta asemel.

## Stabiilsed viited

Deklareeritud postituste, terminite ja manuste viited muutuvad sissetoomisel kaasaskantavateks UID-deks ning lahendatakse saatmisel kohalikeks ID-deks.

## Olek enne saatmist

wp bs content status raporteerib iga üksuse olekuna unchanged, would-update, missing-db, conflict, locked või orphaned ning hoiatab saladustena näivate metavõtmete eest.

## Valideeritud ja piiritletud saatmised

Push valideerib kogu plaani enne kirjutamist ja jätab lukustatud üksused vahele. –dry-run kuvab plaani ning –prune –yes eemaldab ainult selle sisukomplekti üksused.

## Versioonihallatavad

Jälgige lehefaile keskkonnas Git ja juurutage need eri keskkondadesse.

## PHP API

Juurdepääs puudele, alamüksustele, metaandmetele, sünkroonimisele, lukustamisele ja ID-dele programmiliselt.

Plus

## Ametlik laienduskomplekt

Esmaklassilised saidimallid, tehisintellekti süsteemijuhised ja privaatne Discord kogukond. Ühekordne ost, eluaegsed uuendused.

- 500+ saidimalli
- Tehisintellekti süsteemijuhised
- Eluaegsed uuendused
- Privaatne Discord-i kogukond

[Hangi Plus](https://blockstudio.dev/et/plus/)
