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

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

ਤੁਹਾਨੂੰ ਕੀ ਚਾਹੀਦਾ ਹੈ

• 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 ਅਤੇ ਪੋਰਟ ਫਲੈਗਸ ਦੀ ਸੂਚੀ ਦਿੰਦਾ ਹੈ। ਉਦਾਹਰਨਾਂ ਸਮੇਤ ਪੂਰੀ ਸੂਚੀ, ਕਮਾਂਡ ਰੈਫ਼ਰੈਂਸ ਵਿੱਚ ਹੈ।

ਕਦਮ 4 — ਇੱਕ ਸਾਈਟ ਸਕੈਫੋਲਡ ਕਰੋ

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 ਵਰਜ਼ਨ, ਲੋਡ ਕੀਤੇ ਐਕਸਟੈਂਸ਼ਨ) ਅਤੇ ਰੁਕ ਜਾਂਦਾ ਹੈ — ਜਦੋਂ ਤੁਸੀਂ ਕਿਸੇ ਵਾਅਦੇ ਦੀ ਬਜਾਏ ਸਬੂਤ ਚਾਹੁੰਦੇ ਹੋ ਤਾਂ ਲਾਭਦਾਇਕ ਹੁੰਦਾ ਹੈ।

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

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

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