Wprowadzenie do Zinnector®, interfejsu wiersza poleceń dla programistów

Zinnector® to bezpłatne, udostępniane na licencji MIT narzędzie wiersza poleceń od Zinn Digital® dla programistów WordPress. Tworzy szkielet witryny, uruchamia prawdziwego WordPress na twoim komputerze bez konieczności instalowania czegokolwiek poza Node — bez Docker, bez MAMP i bez PHP w zmiennej PATH — a następnie weryfikuje przygotowany projekt pod kątem docelowego slotu hostingowego i go wdraża. Ten poradnik pozwoli Ci przejść od zera do działającej witryny w około dwie minuty oraz wskaże, jak powinien wyglądać pomyślny wynik na każdym etapie, aby w razie problemów od razu wiedzieć, co poszło nie tak.

Czego potrzebujesz

• Node 24 lub nowszego. Uruchom node --version; polecenie musi zwrócić v24 lub wyższą wersję. Zainstaluj bieżącą wersję LTS ze strony nodejs.org — w systemie Windows: winget install OpenJS.NodeJS.LTS, w systemie macOS: brew install node@24.
• npm, dostarczanego razem z Node. Zinnector® używa go tylko raz, aby pobrać środowisko uruchomieniowe WordPress do własnej pamięci podręcznej.
• git, wyłącznie dla polecenia zinnector push — wdrożenia są realizowane bezpośrednio z twojego repozytorium.
• Docker, wyłącznie jeśli zostanie wskazany za pomocą opcji --runtime docker. Domyślne środowisko uruchomieniowe go nie wymaga.

Żaden z poniższych kroków nie wymaga konta. Klucz API jest potrzebny dopiero na etapie slotu hostingowego, jak opisano w sekcji Wdrażanie za pomocą Zinnector®.

Krok 1 — instalacja

npm install -g zinnector

Jeśli npm wyświetli komunikat npm WARN EBADENGINE, oznacza to, że twoja wersja Node jest starsza niż wymagana przez pakiet wersja >=24.18.1. Instalacja dobiegnie końca, ale CLI odmówi uruchomienia. W pierwszej kolejności zaktualizuj Node, a następnie powtórz instalację.

Krok 2 — sprawdzenie wersji

zinnector --version

Sukces: numer wersji, na przykład 0.1.2. Jeśli zobaczysz komunikat „Zinnector® needs Node 24 or newer — this is Node 20.x”, plik binarny jest zainstalowany, ale wersja Node jest zbyt stara; polecenie zakończy działanie z kodem 78, nie wykonując żadnej operacji.

Krok 3 — wyświetlenie pomocy

zinnector --help

Sukces: baner z nazwami pięciu poleceń całego procesu (new, dev, link, check, push), a następnie lista wszystkich poleceń z jednozdaniowym opisem ich przeznaczenia. Każde polecenie obsługuje również własną opcję --help — zinnector dev --help wyświetla flagi dotyczące środowiska uruchomieniowego, wersji PHP oraz portów. Pełna lista wraz z przykładami znajduje się w sekcji Dokumentacja poleceń.

Krok 4 — wygenerowanie struktury witryny

zinnector new my-site

Sukces: nagłówek Created my-site oraz lista utworzonych plików — zinnector.json, drzewo katalogów wp-content z plugins/, themes/ i skryptem pomocniczym mu-plugins/, plik .gitignore oraz README — a pod nimi kolejne polecenia do uruchomienia. Żaden element nie jest tylko szablonem zastępczym; projekt uruchamia się w takiej postaci, w jakiej jest. Opcje --template plugin lub --template theme tworzą szkielet wtyczki lub motywu blokowego, który aktywuje się natychmiast po utworzeniu.

Krok 5 — uruchomienie

cd my-site
zinnector dev

Za pierwszym razem Zinnector® wyświetli jednorazowy monit przed pobraniem środowiska uruchomieniowego WordPress — o rozmiarze około 570 MB, ponieważ zawiera wszystkie wersje PHP od 5.2 do 8.5 — do własnego katalogu pamięci podręcznej, nigdy do wnętrza projektu. Wpisz Y lub użyj opcji --yes, aby pominąć to pytanie. W przypadku środowiska Node 26 lub nowszego narzędzie pobierze również osobną wersję Node 24 przeznaczoną wyłącznie dla środowiska uruchomieniowego (około 30 MB, zweryfikowaną na podstawie sum kontrolnych z nodejs.org), ponieważ natywny moduł środowiska posiada prekompilowane pliki binarne tylko dla Node 24 i 25; kompilator ani Visual Studio nie są wymagane.

Sukces: blok zawierający nazwę projektu, wersję PHP i wersję WordPress, a następnie:

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

Krok 6 — otwarcie witryny

Przejdź pod adres http://127.0.0.1:9400 w przeglądarce. Sukces: nowa witryna WordPress o tytule My WordPress Website, obsługiwana przez wybraną wersję PHP. Adres http://127.0.0.1:9400/wp-admin otwiera panel administracyjny z aktywnym logowaniem. Umieść wtyczkę w katalogu wp-content/plugins/ lub motyw w wp-content/themes/, a pojawią się one przy kolejnym odświeżeniu strony — środowisko uruchomieniowe serwuje te katalogi bezpośrednio z twojego projektu.

Naciśnij Ctrl-C, aby zatrzymać działanie. Polecenie zinnector dev --once uruchamia środowisko, wyświetla faktycznie działającą konfigurację (wersję PHP, wersję WordPress, załadowane rozszerzenia) i kończy pracę — co jest przydatne, gdy potrzebujesz twardych faktów zamiast zapewnień.

Co dalej

• Lokalne programowanie z zinnector dev — dwa środowiska uruchomieniowe, wybór wersji PHP i WordPress oraz informacje o tym, co i skąd jest serwowane.
• Wdrażanie za pomocą Zinnector® — logowanie, łączenie projektu ze slotem, weryfikacja wstępna, wdrożenie.
• Dokumentacja poleceń — wszystkie polecenia, flagi i przykłady.
• Rozwiązywanie problemów — błędy, na które rzeczywiście natrafiają użytkownicy, wraz ze sposobami ich naprawy.

Tę samą dokumentację znajdziesz w pliku README pakietu w serwisach npm oraz GitHub, gdzie z chęcią przyjmujemy zgłoszenia błędów i pull requesty.