Lumaktaw patungo sa pangunahing content

WordCamp Contributor Day

Ang WordCamp Contributor Day ay isang event kung saan nagsasama-sama ang komunidad ng WordPress para mag-ambag sa proyektong WordPress. Nakatuon ang gabay na ito sa kung paano ka makapag-aambag sa proyektong WordPress Playground, o kung paano ka matutulungan ng Playground sa pag-aambag sa WordPress Core.

Sino ang Maaaring Mag-ambag?​

May ilang event na may dedicated table para sa proyekto. Malugod na tinatanggap ng WordPress Playground contributor table ang lahat ng uri ng kontribusyon, hindi lang mula sa mga developer. Kung ikaw ay writer, coder, tester, plugin o theme developer, marketer, site owner, o anupamang uri ng user, hinihikayat kang mag-ambag.

Pinahahalagahan namin ang iba't ibang kontribusyon sa maraming larangan, kabilang ang community building, testing, dokumentasyon, at disenyo.

Paano Mag-ambag sa Proyektong Playground​

Binabalangkas ng seksyon na ito kung paano ka direktang makapag-aambag sa proyektong WordPress Playground at sa mga kaugnay nitong tool:

  • Dokumentasyon: Pagandahin ang aming dokumentasyon sa pamamagitan ng pagpapabuti ng umiiral na content, paggawa ng bagong gabay, o pagsasalin ng materyales sa iba't ibang wika.
  • Blueprints: Gumawa ng plugin demo para sa mga plugin sa WordPress Plugin repository, o mag-develop ng bagong Blueprint para pagyamanin ang dokumentasyon ng proyekto.
  • Pagsubok sa Playground Environment: Makilahok sa pagsubok sa mismong proyektong WordPress Playground. Magagawa mo ito sa pamamagitan ng maingat na paggawa ng bagong isyu na naglalarawan sa mga problemang naranasan mo at nagmumungkahi ng actionable na solusyon. Subukan ang aming WordPress web instance (ang site na playground.wordpress.net), o tuklasin ang iba't ibang application na pinapagana ng Playground. Subukan ang mga tool na ito, obserbahan ang kanilang functionality, at magbigay ng detalyadong feedback.
  • Product Feedback: Napakahalaga ng iyong insight para mapabuti ang Playground experience. Kasama rito ang pangkalahatang feedback sa web instance, sa application, at sa anumang server-side tool.

Ang lahat ng feedback, kabilang ang naiulat na isyu at test result, ay maaaring isumite sa aming GitHub repository.

Follow-up at Patuloy na Pakikilahok​

Maraming gawain ang natatapos sa event, ngunit hindi kailangang doon magtapos ang iyong pag-aambag. Malugod kang inaanyayahan na ipagpatuloy ang trabaho sa iyong isyu o pull request pagkatapos ng Contributor Day. Inaasahan namin ang patuloy na aktibidad mula sa mga kontribyutor na tumatanggap ng gawain lampas sa event. Pakitandaan na kung walang aktibidad ang isang pull request sa loob ng isang buwan, maaari itong ituring na abandoned at isara.

Paghingi ng Tulong at Pananatiling Aktibo​

Sa Contributor Day, maaari kang humingi ng tuwirang tulong at makipag-ugnayan sa amin sa dedicated Playground table. Para sa tuloy-tuloy na support at community interaction, makakabit ka sa amin sa #playground channel sa WordPress Slack o sa GitHub.

Paano gamitin ang Playground sa Contributor Day​

Ngayon, tatalakayin namin kung paano ka matutulungan ng Playground sa Contributor Day. Ang WordPress Playground VS Code extension at ang @wp-playground/cli ay nagpapadali sa proseso ng pag-set up ng lokal na WordPress environment. Pinapagana ng WordPress Playground ang pareho—hindi kailangan ng Docker, MySQL, o Apache.

Patuloy na basahin upang matutunan kung paano gamitin ang mga tool na ito para sa local development kapag nag-aambag sa WordPress. Pansinin na ang extension at ang NPM package ay nasa development pa, at hindi pa fully supported ang lahat ng Make WordPress teams.

Pagsisimula​

VS Code Playground extension​

Ang Visual Studio Code Playground extension ay isang friendly na zero-setup development environment.

  1. Buksan ang VS Code at pumunta sa tab na Extensions (View > Extensions).
  2. Sa search bar, i-type ang WordPress Playground at i-click ang Install.
  3. Para makipag-ugnayan sa Playground, i-click ang bagong icon sa Activity Bar at pindutin ang button na Start WordPress Server.
  4. Magbubukas ang isang bagong tab sa iyong browser sa loob ng ilang segundo.

@wp-playground/cli NPM package​

Ang @wp-playground/cli ay isang CLI tool na nagpapahintulot sa iyo na mag-spin up ng WordPress site gamit ang isang utos lamang. Hindi kailangan ang Docker, MySQL, o Apache.

Mga Kinakailangan​

Nangangailangan ang @wp-playground/cli ng Node.js 20.18 o mas bago at NPM. Kung hindi mo pa nai-install, i-download at i-install muna pareho bago magsimula.

Depende sa Make WordPress team na iyong inaambagan, maaaring kailanganin mong gumamit ng ibang bersyon ng Node.js kaysa sa naka-install mo. Maaari mong gamitin ang Node Version Manager (NVM) upang magpalit ng bersyon. Sundin ang installation guide dito.

Pagpapatakbo ng @wp-playground/cli​

Hindi mo kailangang i-install ang @wp-playground/cli sa iyong device para magamit ito. Pumunta sa direktoryo ng iyong plugin o theme at simulan ang @wp-playground/cli gamit ang mga sumusunod na utos:

cd my-plugin-or-theme-directory
npx @wp-playground/cli@latest server --auto-mount

Mga Ideya para sa mga Kontribyutor​

Gumawa ng Gutenberg Pull Request (PR)​

  1. I-fork ang Gutenberg repository sa iyong GitHub account.
  2. I-clone ang forked repository para ma-download ang mga file.
  3. I-install ang mga kinakailangang dependencies at i-build ang code sa development mode.
git clone git@github.com:WordPress/gutenberg.git
cd gutenberg
npm install
npm run dev

Kung hindi ka sigurado sa mga hakbang sa itaas, bisitahin ang opisyal na Gutenberg Project Contributor Guide. Tandaan na sa pagkakataong ito, papalitan ng @wp-playground/cli ang wp-env.

Magbukas ng bagong terminal tab, pumunta sa Gutenberg directory, at simulan ang WordPress gamit ang @wp-playground/cli:

cd gutenberg
npx @wp-playground/cli@latest server --auto-mount

Kapag handa ka na, i-commit at i-push ang iyong mga pagbabago sa iyong forked repository sa GitHub at magbukas ng Pull Request sa Gutenberg repository.

Subukan ang isang Gutenberg PR​

  1. Para subukan ang ibang Gutenberg PR, i-checkout ang branch na kaugnay nito.
  2. I-pull ang pinakabagong mga pagbabago upang siguraduhing up to date ang lokal mong kopya.
  3. Susunod, i-install ang mga kinakailangang dependencies, siguraduhing tugma ang testing environment sa pinakabagong mga pagbabago.
  4. Sa wakas, i-build ang code sa development mode.
# kopyahin ang branch-name mula sa GitHub #
git checkout branch-name
git pull
npm install
npm run dev

# Sa ibang terminal sa loob ng Gutenberg directory *
npx @wp-playground/cli@latest server --auto-mount

Subukan ang isang Gutenberg PR gamit ang Playground sa browser​

Hindi mo kailangan ng lokal na development environment para subukan ang mga Gutenberg PR—gamitin ang Playground para gawin ito nang direkta sa browser.

  1. Kopyahin ang ID ng PR na nais mong subukan (pumili mula sa listahan ng open Pull Requests).
  2. Buksan ang Gutenberg PR Previewer ng Playground at i-paste ang kinopyang ID.
  3. Kapag na-click mo ang Go, susuriin ng Playground kung valid ang PR at magbubukas ng bagong tab na may kaugnay na PR, na nagpapahintulot sa iyong i-review ang mga iminungkahing pagbabago.

Isalin ang mga WordPress Plugin gamit ang Playground sa browser​

Maaari mong isalin ang suportadong mga WordPress Plugin sa pamamagitan ng pag-load ng plugin na nais mong isalin at paggamit ng Inline Translation. Kung idinagdag ng mga developer ng plugin ang opsyon, makikita mo ang Translate Live link sa itaas na kanang toolbar ng view ng pagsasalin. Maaari mong basahin ang tungkol sa kapanapanabik na bagong opsyon na ito sa Polyglots blog post na ito.

Humingi ng Tulong at Mag-ambag sa WordPress Playground​

May tanong o ideya para sa bagong feature? Nakakita ng bug? May hindi gumana ayon sa inaasahan? Narito kami upang tumulong: