Zinnector® ਨਾਲ ਸ਼ੁਰੂਆਤ ਕਰਨਾ, ਡਿਵੈਲਪਰ CLI

Zinnector® Zinn Digital® ਦਾ WordPress ਡਿਵੈਲਪਰਾਂ ਲਈ ਇੱਕ ਮੁਫ਼ਤ, MIT-ਲਾਇਸੰਸਸ਼ੁਦਾ ਕਮਾਂਡ-ਲਾਈਨ ਟੂਲ ਹੈ। ਇਹ ਇੱਕ ਸਾਈਟ ਦਾ ਢਾਂਚਾ (scaffold) ਤਿਆਰ ਕਰਦਾ ਹੈ, ਤੁਹਾਡੀ ਆਪਣੀ ਮਸ਼ੀਨ 'ਤੇ Node ਤੋਂ ਇਲਾਵਾ ਕੁਝ ਵੀ ਇੰਸਟਾਲ ਕੀਤੇ ਬਿਨਾਂ ਇੱਕ ਅਸਲ WordPress ਚਲਾਉਂਦਾ ਹੈ — ਕੋਈ Docker ਨਹੀਂ, ਕੋਈ MAMP ਨਹੀਂ, ਤੁਹਾਡੇ PATH 'ਤੇ ਕੋਈ PHP ਨਹੀਂ — ਫਿਰ ਜੋ ਤੁਸੀਂ ਬਣਾਇਆ ਹੈ ਉਸ ਦੀ ਜਾਂਚ ਉਸ ਹੋਸਟਿੰਗ ਸਲਾਟ ਨਾਲ ਕਰਦਾ ਹੈ ਜਿੱਥੇ ਤੁਸੀਂ ਡਿਪਲਾਏ ਕਰਨ ਵਾਲੇ ਹੋ ਅਤੇ ਉਸ ਨੂੰ ਪੁਸ਼ ਕਰਦਾ ਹੈ। ਇਹ ਗਾਈਡ ਤੁਹਾਨੂੰ ਲਗਭਗ ਦੋ ਮਿੰਟਾਂ ਵਿੱਚ ਸ਼ੁਰੂਆਤ ਤੋਂ ਇੱਕ ਚਲਦੀ ਸਾਈਟ ਤੱਕ ਲੈ ਜਾਂਦੀ ਹੈ, ਅਤੇ ਤੁਹਾਨੂੰ ਹਰ ਕਦਮ 'ਤੇ ਦੱਸਦੀ ਹੈ ਕਿ ਸਫਲਤਾ ਕਿਹੋ ਜਿਹੀ ਦਿਖਾਈ ਦਿੰਦੀ ਹੈ ਤਾਂ ਜੋ ਤੁਹਾਨੂੰ ਪਤਾ ਲੱਗ ਸਕੇ ਕਿ ਕਦੋਂ ਕੋਈ ਗੜਬੜ ਹੋਈ ਹੈ।

ਤੁਹਾਨੂੰ ਕਿਸ ਦੀ ਲੋੜ ਹੈ

• Node 24 ਜਾਂ ਨਵਾਂ। node --version ਚਲਾਓ; ਇਹ v24 ਜਾਂ ਇਸ ਤੋਂ ਉੱਚਾ ਪ੍ਰਿੰਟ ਕਰਨਾ ਚਾਹੀਦਾ ਹੈ। nodejs.org ਤੋਂ ਮੌਜੂਦਾ LTS ਇੰਸਟਾਲ ਕਰੋ — Windows 'ਤੇ winget install OpenJS.NodeJS.LTS, macOS 'ਤੇ brew install node@24।
• npm, ਜੋ Node ਦੇ ਨਾਲ ਆਉਂਦਾ ਹੈ। Zinnector® ਇਸਦੀ ਵਰਤੋਂ ਇੱਕ ਵਾਰ, WordPress ਰਨਟਾਈਮ ਨੂੰ ਆਪਣੇ ਕੈਸ਼ ਵਿੱਚ ਡਾਊਨਲੋਡ ਕਰਨ ਲਈ ਕਰਦਾ ਹੈ।
• git, ਸਿਰਫ਼ zinnector push ਲਈ — ਡਿਪਲਾਏਮੈਂਟ ਤੁਹਾਡੀ ਰਿਪੋਜ਼ਟਰੀ ਤੋਂ ਚਲਾਈਆਂ ਜਾਂਦੀਆਂ ਹਨ।
• Docker, ਸਿਰਫ਼ ਉਦੋਂ ਹੀ ਜੇਕਰ ਤੁਸੀਂ --runtime docker ਨਾਲ ਇਸਦੀ ਮੰਗ ਕਰਦੇ ਹੋ। ਡਿਫਾਲਟ ਰਨਟਾਈਮ ਨੂੰ ਕਿਸੇ ਦੀ ਲੋੜ ਨਹੀਂ ਹੈ।

ਹੇਠਾਂ ਦਿੱਤੀ ਕਿਸੇ ਵੀ ਚੀਜ਼ ਲਈ ਖਾਤੇ ਦੀ ਲੋੜ ਨਹੀਂ ਹੈ। ਇੱਕ API ਕੁੰਜੀ ਦੀ ਲੋੜ ਸਿਰਫ਼ ਉਦੋਂ ਪੈਂਦੀ ਹੈ ਜਦੋਂ ਤੁਸੀਂ ਕਿਸੇ ਹੋਸਟਿੰਗ ਸਲਾਟ 'ਤੇ ਪਹੁੰਚਦੇ ਹੋ, Deploying with Zinnector® ਵਿੱਚ।

ਕਦਮ 1 — ਇਸਨੂੰ ਇੰਸਟਾਲ ਕਰੋ

npm install -g zinnector

ਜੇਕਰ npm npm WARN EBADENGINE ਪ੍ਰਿੰਟ ਕਰਦਾ ਹੈ, ਤਾਂ ਤੁਹਾਡਾ Node ਪੈਕੇਜ ਦੁਆਰਾ ਘੋਸ਼ਿਤ >=24.18.1 ਨਾਲੋਂ ਪੁਰਾਣਾ ਹੈ। ਇੰਸਟਾਲੇਸ਼ਨ ਫਿਰ ਵੀ ਪੂਰੀ ਹੋ ਜਾਂਦੀ ਹੈ, ਪਰ CLI ਚੱਲਣ ਤੋਂ ਇਨਕਾਰ ਕਰ ਦੇਵੇਗਾ। ਪਹਿਲਾਂ Node ਨੂੰ ਅੱਪਗ੍ਰੇਡ ਕਰੋ, ਫਿਰ ਦੁਬਾਰਾ ਇੰਸਟਾਲ ਕਰੋ।

ਕਦਮ 2 — ਵਰਜ਼ਨ ਦੀ ਜਾਂਚ ਕਰੋ

zinnector --version

ਸਫਲਤਾ: ਇੱਕ ਵਰਜ਼ਨ ਨੰਬਰ, ਉਦਾਹਰਨ ਲਈ 0.1.2 । ਜੇਕਰ ਤੁਸੀਂ "Zinnector® needs Node 24 or newer — this is Node 20.x" ਦੇਖਦੇ ਹੋ, ਤਾਂ ਬਾਇਨਰੀ ਇੰਸਟਾਲ ਹੈ ਪਰ ਤੁਹਾਡਾ Node ਬਹੁਤ ਪੁਰਾਣਾ ਹੈ; ਕਮਾਂਡ ਕੁਝ ਵੀ ਕਰਨ ਦੀ ਬਜਾਏ ਕੋਡ 78 ਨਾਲ ਬਾਹਰ ਨਿਕਲ ਜਾਂਦੀ ਹੈ।

ਕਦਮ 3 — ਮਦਦ ਪੜ੍ਹੋ

zinnector --help

ਸਫਲਤਾ: ਫਲੋ ਦੀਆਂ ਪੰਜ ਕਮਾਂਡਾਂ (new, dev, link, check, push) ਦੇ ਨਾਮ ਵਾਲਾ ਇੱਕ ਬੈਨਰ ਅਤੇ ਫਿਰ ਇੱਕ ਲਾਈਨ ਦੇ ਉਦੇਸ਼ ਵਾਲੀ ਹਰੇਕ ਕਮਾਂਡ। ਹਰੇਕ ਕਮਾਂਡ ਆਪਣੀ --help ਵੀ ਲੈਂਦੀ ਹੈ — zinnector dev --help ਰਨਟਾਈਮ, PHP ਅਤੇ ਪੋਰਟ ਫਲੈਗਾਂ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ। ਉਦਾਹਰਨਾਂ ਦੇ ਨਾਲ ਪੂਰੀ ਸੂਚੀ, command reference ਵਿੱਚ ਹੈ।

ਕਦਮ 4 — ਸਾਈਟ ਦਾ ਢਾਂਚਾ (scaffold) ਬਣਾਓ

zinnector new my-site

ਸਫਲਤਾ: ਇੱਕ Created my-site ਹੈਡਿੰਗ ਅਤੇ ਇਸ ਦੁਆਰਾ ਲਿਖੀਆਂ ਫਾਈਲਾਂ ਦੀ ਇੱਕ ਸੂਚੀ — zinnector.json, plugins/, themes/ ਅਤੇ ਇੱਕ mu-plugins/ ਹੈਲਪਰ ਦੇ ਨਾਲ ਇੱਕ wp-content ਟ੍ਰੀ, ਇੱਕ .gitignore ਅਤੇ ਇੱਕ README — ਜਿਸ ਤੋਂ ਬਾਅਦ ਚਲਾਉਣ ਲਈ ਅਗਲੀਆਂ ਕਮਾਂਡਾਂ ਹਨ। ਇਸ ਵਿੱਚ ਕੁਝ ਵੀ ਪਲੇਸਹੋਲਡਰ ਨਹੀਂ ਹੈ; ਪ੍ਰੋਜੈਕਟ ਜਿਵੇਂ ਹੈ ਉਵੇਂ ਹੀ ਬੂਟ ਹੁੰਦਾ ਹੈ। --template plugin ਜਾਂ --template theme ਇੱਕ ਪਲੱਗਇਨ ਜਾਂ ਇੱਕ ਬਲਾਕ ਥੀਮ ਦਾ ਢਾਂਚਾ ਤਿਆਰ ਕਰਦੇ ਹਨ ਜੋ ਮੌਜੂਦ ਹੁੰਦੇ ਹੀ ਸਰਗਰਮ ਹੋ ਜਾਂਦੇ ਹਨ।

ਕਦਮ 5 — ਇਸਨੂੰ ਚਲਾਓ

cd my-site
zinnector dev

ਪਹਿਲੀ ਵਾਰ, Zinnector® WordPress ਰਨਟਾਈਮ — ਲਗਭਗ 570 MB, ਕਿਉਂਕਿ ਇਹ 5.2 ਤੋਂ 8.5 ਤੱਕ ਹਰ PHP ਬਿਲਡ ਲੈ ਕੇ ਜਾਂਦਾ ਹੈ — ਨੂੰ ਆਪਣੇ ਕੈਸ਼ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਡਾਊਨਲੋਡ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਇੱਕ ਵਾਰ ਪੁੱਛਦਾ ਹੈ, ਤੁਹਾਡੇ ਪ੍ਰੋਜੈਕਟ ਵਿੱਚ ਕਦੇ ਨਹੀਂ। Y ਉੱਤਰ ਦਿਓ, ਜਾਂ ਸਵਾਲ ਨੂੰ ਛੱਡਣ ਲਈ --yes ਪਾਸ ਕਰੋ। Node 26 ਜਾਂ ਨਵੇਂ 'ਤੇ ਇਹ ਸਿਰਫ਼ ਰਨਟਾਈਮ ਲਈ ਇੱਕ Node 24 ਵੀ ਪ੍ਰਾਪਤ ਕਰਦਾ ਹੈ (ਲਗਭਗ 30 MB, nodejs.org ਦੇ ਚੈੱਕਸਮ ਵਿਰੁੱਧ ਵੈਰੀਫਾਈ ਕੀਤਾ ਗਿਆ), ਕਿਉਂਕਿ ਰਨਟਾਈਮ ਦੇ ਨੇਟਿਵ ਮੋਡੀਊਲ ਵਿੱਚ ਸਿਰਫ਼ Node 24 ਅਤੇ 25 ਲਈ ਪੂਰਵ-ਨਿਰਮਿਤ ਬਾਇਨਰੀਆਂ ਹਨ; ਤੁਹਾਨੂੰ ਕੰਪਾਈਲਰ ਜਾਂ Visual Studio ਦੀ ਲੋੜ ਨਹੀਂ ਹੈ।

ਸਫਲਤਾ: ਇੱਕ ਬਲਾਕ ਜੋ ਪ੍ਰੋਜੈਕਟ, PHP ਵਰਜ਼ਨ ਅਤੇ WordPress ਵਰਜ਼ਨ ਦਾ ਨਾਮ ਦਿੰਦਾ ਹੈ, ਫਿਰ:

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

ਕਦਮ 6 — ਇਸਨੂੰ ਖੋਲ੍ਹੋ

ਬ੍ਰਾਊਜ਼ਰ ਵਿੱਚ http://127.0.0.1:9400 'ਤੇ ਜਾਓ। ਸਫਲਤਾ: My WordPress Website ਸਿਰਲੇਖ ਵਾਲੀ ਇੱਕ ਨਵੀਂ WordPress ਸਾਈਟ, ਜੋ ਤੁਹਾਡੇ ਦੁਆਰਾ ਮੰਗੇ ਗਏ PHP ਵਰਜ਼ਨ ਦੁਆਰਾ ਸਰਵ ਕੀਤੀ ਗਈ ਹੈ। http://127.0.0.1:9400/wp-admin ਡੈਸ਼ਬੋਰਡ ਨੂੰ ਪਹਿਲਾਂ ਤੋਂ ਸਾਈਨ ਇਨ ਕਰਕੇ ਖੋਲ੍ਹਦਾ ਹੈ। wp-content/plugins/ ਵਿੱਚ ਇੱਕ ਪਲੱਗਇਨ ਜਾਂ wp-content/themes/ ਵਿੱਚ ਇੱਕ ਥੀਮ ਸੁੱਟੋ ਅਤੇ ਇਹ ਅਗਲੇ ਰੀਲੋਡ 'ਤੇ ਉੱਥੇ ਹੁੰਦਾ ਹੈ — ਰਨਟਾਈਮ ਉਹਨਾਂ ਡਾਇਰੈਕਟਰੀਆਂ ਨੂੰ ਤੁਹਾਡੇ ਪ੍ਰੋਜੈਕਟ ਤੋਂ ਸਿੱਧਾ ਸਰਵ ਕਰਦਾ ਹੈ।

ਰੋਕਣ ਲਈ Ctrl-C ਦਬਾਓ। zinnector dev --once ਰਨਟਾਈਮ ਨੂੰ ਬੂਟ ਕਰਦਾ ਹੈ, ਜੋ ਅਸਲ ਵਿੱਚ ਚੱਲ ਰਿਹਾ ਹੈ (PHP ਵਰਜ਼ਨ, WordPress ਵਰਜ਼ਨ, ਲੋਡ ਕੀਤੇ ਐਕਸਟੈਂਸ਼ਨ) ਉਸਨੂੰ ਪ੍ਰਿੰਟ ਕਰਦਾ ਹੈ ਅਤੇ ਰੁਕ ਜਾਂਦਾ ਹੈ — ਉਦੋਂ ਉਪਯੋਗੀ ਹੁੰਦਾ ਹੈ ਜਦੋਂ ਤੁਸੀਂ ਵਾਅਦੇ ਦੀ ਬਜਾਏ ਸਬੂਤ ਚਾਹੁੰਦੇ ਹੋ।

ਅੱਗੇ ਕਿੱਥੇ ਜਾਣਾ ਹੈ

• Local development with zinnector dev — ਦੋ ਰਨਟਾਈਮ, PHP ਅਤੇ WordPress ਵਰਜ਼ਨ ਚੁਣਨਾ, ਅਤੇ ਕਿੱਥੋਂ ਕੀ ਸਰਵ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।
• Deploying with Zinnector® — ਸਾਈਨ ਇਨ ਕਰੋ, ਪ੍ਰੋਜੈਕਟ ਨੂੰ ਇੱਕ ਸਲਾਟ ਨਾਲ ਲਿੰਕ ਕਰੋ, ਇਸਦੀ ਪ੍ਰੀ-ਫਲਾਈਟ ਜਾਂਚ ਕਰੋ, ਪੁਸ਼ ਕਰੋ।
• The command reference — ਹਰ ਕਮਾਂਡ, ਫਲੈਗ ਅਤੇ ਉਦਾਹਰਨ।
• Troubleshooting — ਉਹ ਗਲਤੀਆਂ ਜੋ ਲੋਕਾਂ ਨੂੰ ਅਸਲ ਵਿੱਚ ਆਉਂਦੀਆਂ ਹਨ, ਅਤੇ ਹਰੇਕ ਦਾ ਹੱਲ।

ਇਹੀ ਦਸਤਾਵੇਜ਼ npm ਅਤੇ GitHub 'ਤੇ ਪੈਕੇਜ ਦੇ README ਵਿੱਚ ਵੀ ਹਨ, ਜਿੱਥੇ ਸਮੱਸਿਆਵਾਂ (issues) ਅਤੇ ਪੁੱਲ ਬੇਨਤੀਆਂ (pull requests) ਦਾ ਸਵਾਗਤ ਹੈ।