Mga Kontribusyon sa Code
Tulad ng lahat ng WordPress projects, ginagamit ng Playground ang GitHub para pamahalaan ang code at subaybayan ang mga isyu. Ang pangunahing repositorya ay matatagpuan sa https://github.com/WordPress/wordpress-playground at ang Playground Tools repositorya ay nasa https://github.com/WordPress/playground-tools/.
Mag-ambag sa Playground Tools
Kasama sa gabay na ito ang mga link sa pangunahing repositorya, ngunit ang lahat ng hakbang at opsyon ay magagamit din para sa Playground Tools. Kung interesado ka sa mga plugin o lokal na development tools—simulan mo doon.
I-browse ang listahan ng mga bukas na isyu upang makita kung saan ka maaaring magtrabaho. Ang label na Good First Issue ay inirerekomendang panimulang punto para sa mga unang beses na kontribyutor.
Siguraduhing suriin ang mga sumusunod na resources bago ka magsimula:
Mag-ambag ng Pull Request
I-fork ang Playground repository at i-clone ito sa iyong local machine. Upang gawin ito, kopyahin at i-paste ang mga utos na ito sa iyong terminal:
git clone -b trunk --single-branch --depth 1 --recurse-submodules
# replace `YOUR-GITHUB-USERNAME` with your GitHub username:
git@github.com:YOUR-GITHUB-USERNAME/wordpress-playground.git
cd wordpress-playground
npm install
Gumawa ng bagong branch, gumawa ng mga pagbabago, at i-test ito nang lokal sa pamamagitan ng pag-run ng sumusunod:
npm run dev
Magbubukas ang Playground sa bagong browser tab at awtomatikong magre-refresh sa bawat pagbabago.
Troubleshooting: File watcher limit sa Linux
Sa Linux, maaari kang makakita ng error tulad ng ENOSPC: System limit for number of file watchers reached kapag nagpapatakbo ng npm run dev. Nangyayari ito dahil mas maraming file ang Playground repository kaysa sa default na system limit para sa file watching.
Para ayusin ito, suriin muna ang kasalukuyang limit:
cat /proc/sys/fs/inotify/max_user_watches
Kung nasa 65,536 o mas mababa, taasan ito sa pamamagitan ng:
sudo sysctl fs.inotify.max_user_watches=131070
sudo sysctl -p
Pagkatapos, subukan ulit ang npm run dev. Karaniwan itong isyu sa Debian, Ubuntu, at iba pang Linux distribution.
Kapag handa ka na, i-commit ang mga pagbabago at mag-submit ng Pull Request.
Pag-format
Awtomatikong hinahandle ang code formatting at linting. Mag-relax ka lang, mag-type lang, at hayaan ang makina ang gumalaw.
Pagpapatakbo ng lokal na Multisite
May ilang restriksyon kapag nagpapatakbo ng Multisite nang lokal. Kung balak mong i-test ang Multisite network gamit ang enableMultisite step ng Playground, siguraduhing babaguhin mo ang default na port ng Playground CLI o mag-set ng lokal na test domain na tumatakbo sa HTTPS.
Upang baguhin ang default na port ng Playground CLI sa suportadong port ng WordPress Multisite, patakbuhin ito gamit ang flag na --port=80:
npx @wp-playground/cli@latest start --port=80
May ilang paraan upang mag-set up ng lokal na test domain, kabilang ang pag-edit ng iyong hosts file. Kung hindi ka sigurado kung paano gawin iyon, inirerekomenda naming i-install ang Laravel Valet at patakbuhin ang sumusunod:
valet proxy playground.test http://127.0.0.1:5400 --secure
Ngayon ay maa-access ang iyong dev server sa https://playground.test.
Debugging
Paggamit ng VS Code at Chrome
Kung gumagamit ka ng VS Code at naka-install ang Chrome, maaari mong i-debug ang Playground sa code editor:
- Buksan ang project folder sa VS Code.
- Piliin ang Run > Start Debugging mula sa main menu o pindutin ang
F5/fn+F5.
Debugging PHP
Ina-log ng Playground ang PHP errors sa browser console pagkatapos ng bawat PHP request.