Lumaktaw patungo sa pangunahing content

Playground para sa Mga Plugin Developer

Ang WordPress Playground ay isang makabagong tool na nagpapahintulot sa mga plugin developer na magtayo, mag-test, at magpakita ng kanilang mga plugin nang direkta sa browser.

Ang gabay na ito ay magpapakita kung paano gamitin ang WordPress Playground upang pagandahin ang iyong workflow sa pag-develop ng plugin, lumikha ng live na demo para ipakita ang iyong plugin, at pasimplehin ang iyong plugin testing at review.

info

Tuklasin kung paano Mag-build, Mag-test, at Mag-launch ng iyong mga produkto gamit ang WordPress Playground sa About Playground na seksyon.

Paglunsad ng isang Playground instance gamit ang plugin

Plugin sa WordPress Themes Directory

Sa WordPress Playground, maaari kang mabilis maglunsad ng WordPress installation na may halos anumang plugin mula sa WordPress Plugins Directory na naka-install at naka-activate. Kailangan mo lamang idagdag ang plugin na query parameter sa Playground URL at gamitin ang slug ng plugin mula sa WordPress directory bilang halaga. Halimbawa: https://playground.wordpress.net/?plugin=create-block-theme

tip

Maaari kang mag-install at mag-activate ng maraming plugin sa pamamagitan ng pag-uulit ng plugin parameter para sa bawat plugin na nais mong i-install at i-activate sa Playground instance. Halimbawa: https://playground.wordpress.net/?plugin=gutenberg&plugin=akismet&plugin=wordpress-seo

Maaari mo ring i-load ang anumang plugin mula sa WordPress plugins directory sa pamamagitan ng pag-set ng installPlugin step ng isang Blueprint na ipapasa sa Playground instance.

{
"landingPage": "/wp-admin/plugins.php",
"login": true,
"steps": [
{
"step": "installPlugin",
"pluginData": {
"resource": "wordpress.org/plugins",
"slug": "gutenberg"
}
}
]
}

   Patakbuhin ang Blueprint   

Ang mga Blueprint ay maaaring ipasa sa isang Playground instance sa iba't ibang paraan.

Plugin mula sa GitHub Repository

Ang plugin na naka-imbak sa isang GitHub repository ay maaari ring i-load sa isang Playground instance gamit ang Blueprints.

Sa pamamagitan ng pluginData property ng installPlugin blueprint step, maaari mong tukuyin ang url resource na tumuturo sa lokasyon ng .zip file na naglalaman ng plugin na nais mong i-load sa Playground instance.

Upang maiwasan ang mga isyu sa CORS, nag-aalok ang proyekto ng GitHub proxy na nagpapahintulot sa iyo na bumuo ng .zip mula sa isang repository (o kahit isang folder sa loob nito) na naglalaman ng iyong plugin.

info

Ang GitHub proxy ay isang napaka-kapaki-pakinabang na tool upang mag-load ng mga plugin mula sa mga GitHub repository dahil pinapayagan kang mag-load ng plugin mula sa isang partikular na branch, direktoryo, commit, o PR.

Halimbawa, ang sumusunod na blueprint.json ay nag-i-install ng plugin mula sa isang GitHub repository gamit ang https://github-proxy.com tool:

{
"landingPage": "/wp-admin/admin.php?page=add-media-from-third-party-service",
"login": true,
"steps": [
{
"step": "installPlugin",
"pluginData": {
"resource": "url",
"url": "https://github-proxy.com/proxy/?repo=wptrainingteam/devblog-dataviews-plugin"
}
}
]
}

   Patakbuhin ang Blueprint   

Plugin mula sa Code sa File o Gist sa GitHub

Sa pamamagitan ng kombinasyon ng writeFile at activatePlugin na mga step, maaari ka ring maglunsad ng WP Playground instance na may plugin na binuo sa real-time mula sa code na naka-imbak sa isang gist o file sa GitHub:

{
"landingPage": "/wp-admin/plugins.php",
"login": true,
"steps": [
{
"step": "login"
},
{
"step": "writeFile",
"path": "/wordpress/wp-content/plugins/cpt-books.php",
"data": {
"resource": "url",
"url": "https://raw.githubusercontent.com/WordPress/blueprints/trunk/blueprints/custom-post/books.php"
}
},
{
"step": "activatePlugin",
"pluginPath": "cpt-books.php"
}
]
}

   Patakbuhin ang Blueprint  

info

Ang Install plugin from a gist example sa Blueprints Gallery ay nagpapakita kung paano mag-load ng plugin mula sa code sa isang gist

Pagse-set up ng demo para sa iyong plugin gamit ang Blueprints

Kapag nagbibigay ng link sa isang WordPress Playground instance na may ilang mga plugin na naka-activate, maaari mo ring i-customize ang paunang setup para sa Playground instance na iyon gamit ang mga plugin na iyon. Sa pamamagitan ng Blueprints ng Playground, maaari mong i-load/activate ang mga plugin at i-configure ang Playground instance.

tip

Here are some useful tools and resources provided by the Playground project to work with blueprints:

  • Check the Blueprints Gallery to explore real-world code examples of using WordPress Playground to launch a WordPress site with a variety of setups.
  • The WordPress Playground Step Library tool provides a visual interface to drag or click the steps to create a blueprint for WordPress Playground. You can also create your own steps!
  • The Blueprints builder tool allows you edit your blueprint online and run it directly in a Playground instance.

Sa pamamagitan ng mga katangian at steps sa Blueprint, maaari mong i-configure ang paunang setup ng Playground instance, ibibigay ang iyong mga plugin ng kinakailangang content at configuration upang maipakita ang mga kapana-panabik na feature at functionality ng iyong plugin.

info

Isang mahusay na demo gamit ang WordPress Playground ay maaaring mangailangan na mag-load ka ng default na content para sa iyong plugin at theme, kabilang ang mga larawan at iba pang asset. Tingnan ang Pagbibigay ng nilalaman para sa iyong demo na gabay para matuto nang higit pa tungkol dito.

plugins

Kung ang iyong plugin ay may dependencies sa ibang mga plugin, maaari mong gamitin ang shorthand na plugins upang i-install ang mga iyon kasama ang iyong plugin.

{
"landingPage": "/wp-admin/plugins.php",
"plugins": ["gutenberg", "sql-buddy", "create-block-theme"],
"login": true
}

   Patakbuhin ang Blueprint   

landingPage

If your plugin has a settings view or onboarding wizard, you can use the landingPage shortcut to automatically redirect to any page in the Playground instance upon loading.

{
"landingPage": "/wp-admin/admin.php?page=my-custom-gutenberg-app",
"login": true,
"plugins": ["https://raw.githubusercontent.com/WordPress/block-development-examples/deploy/zips/data-basics-59c8f8.zip"]
}