Pagbibigay ng Nilalaman para sa Iyong Demo gamit ang Playground
Isa sa mga bagay na maaaring gusto mong gawin para makagawa ng mahusay na demo gamit ang WordPress Playground ay ang pag-load ng paunang nilalaman upang higit na maipakita ang mga feature ng iyong plugin o theme. Maaaring kabilang dito ang mga larawan o iba pang asset.
May ilang blueprint steps at estratehiya na maaari mong gamitin upang i-import (o bumuo) ng content sa Playground instance:
importWxr
Gamit ang importWxr
step, maaari mong i-import ang iyong sariling content sa pamamagitan ng isang .xml
file na na-export mula sa umiiral na WordPress installation:
"steps": [
...,
{
"step": "importWxr",
"file": {
"resource": "url",
"url": "https://raw.githubusercontent.com/WordPress/blueprints/trunk/blueprints/install-activate-setup-theme-from-gh-repo/blueprint-content.xml"
}
},
...
]
Patakbuhin ang Blueprint Tignan ang blueprint.json
Upang isama ang mga larawan sa iyong imported content, magandang paraan ang i-upload ang mga larawan sa iyong GitHub repo at gamitin ang path na https://raw.githubusercontent.com/{repo}/{branch}/{image_path}
sa exported .xml
file.
<!-- wp:image {"lightbox":{"enabled":false},"id":4751,"width":"78px","sizeSlug":"full","linkDestination":"none","align":"center","className":"no-border"} -->
<figure class="wp-block-image aligncenter size-full is-resized no-border">
<img src="https://raw.githubusercontent.com/WordPress/blueprints/trunk/blueprints/install-activate-setup-theme-from-gh-repo/images/avatars.png" alt="" class="wp-image-4751" style="width:78px" />
</figure>
<!-- /wp:image -->
Inirerekomenda na i-upload mo ang iyong na-export na .xml
file at anumang naka-referensyang asset (tulad ng mga larawan) sa parehong directory kung saan naroon ang iyong blueprint.json
sa iyong GitHub repository.
importWordPressFiles
Gamit ang importWordPressFiles
step, maaari mong i-import ang iyong sariling top-level WordPress files mula sa isang .zip
file tungo sa root folder ng instance. Halimbawa, kung naglalaman ang .zip
file ng wp-content
at wp-includes
directories, papalitan nito ang katumbas na directories sa root folder ng Playground.
Maaaring malikha ang .zip
file mula sa anumang Playground instance gamit ang option na "Download as zip" sa Playground Options Menu.
Maaari mong ihanda ang demo para sa iyong WordPress theme o plugin (kasama ang mga larawan at iba pang asset) sa isang Playground instance at pagkatapos ay i-export ito bilang snapshot sa .zip
file. Maaari itong i-import muli gamit ang importWordPressFiles
step.
{
"landingPage": "/",
"login": true,
"steps": [
{
"step": "importWordPressFiles",
"wordPressFilesZip": {
"resource": "url",
"url": "https://raw.githubusercontent.com/adamziel/playground-sites/main/playground-for-site-builders/playground.zip"
}
}
]
}
importThemeStarterContent
Ilang tema ay may starter content na maaaring i-publish upang ipakita ang feature ng isang theme.
Gamit ang importThemeStarterContent
step maaari mong i-publish ang starter content ng anumang theme kahit hindi ito ang naka-activate sa Playground instance.
"steps": [
{
"step": "installTheme",
"themeData": {
"resource": "wordpress.org/themes",
"slug": "twentytwenty"
}
},
{
"step": "importThemeStarterContent",
"themeSlug": "twentytwenty"
}
]
Maaari mo ring i-publish ang starter content ng isang theme kapag ini-install ito gamit ang installTheme
step sa pamamagitan ng pagtatakda sa options.importStarterContent
bilang true
:
{
"steps": [
{
"step": "installTheme",
"themeData": {
"resource": "wordpress.org/themes",
"slug": "twentytwenty"
},
"options": {
"activate": true,
"importStarterContent": true
}
}
]
}
wp-cli
Isa pang paraan ng pag-generate ng content para sa iyong theme o plugin ay sa pamamagitan ng wp-cli
step na nagpapahintulot sa'yo na patakbuhin ang mga WP-CLI commands gaya ng wp post generate
:
{
"landingPage": "/wp-admin/edit.php",
"login": true,
"steps": [
{
"step": "wp-cli",
"command": "wp post generate --count=20 --post_type=post --post_date=1999-01-04"
}
]
}
Maaari mo ring gamitin ang wp-cli
step kasama ang writeFile
step upang lumikha ng mga post mula sa umiiral na content at mag-import ng mga larawan sa Playground instance:
{
"$schema": "https://playground.wordpress.net/blueprint-schema.json",
"landingPage": "/?p=4",
"login": true,
"steps": [
{
"step": "writeFile",
"path": "/wordpress/wp-content/postcontent.md",
"data": {
"resource": "url",
"url": "https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/wpcli-post-with-image/postcontent.md"
}
},
{
"step": "wp-cli",
"command": "wp post create --post_title='Welcome to Playground' --post_status='published' /wordpress/wp-content/postcontent.md"
},
{
"step": "writeFile",
"path": "/wordpress/wp-content/Select-storage-method.png",
"data": {
"resource": "url",
"url": "https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/wpcli-post-with-image/Select-storage-method.png"
}
},
{
"step": "wp-cli",
"command": "wp media import wordpress/wp-content/Select-storage-method.png --post_id=4 --title='Select your storage method' --featured_image"
}
]
}
Tingnan ang halimbawa na "Use wp-cli to add a post with image" mula sa Blueprints Gallery upang makita ang buong halimbawa na nagpapakita ng ugnayan sa pagitan ng content at featured image.