Πρώτα βήματα με το Zinnector®, το CLI για προγραμματιστές

Το Zinnector® είναι το δωρεάν εργαλείο γραμμής εντολών με άδεια χρήσης MIT της Zinn Digital® για προγραμματιστές WordPress. Δημιουργεί τη δομή (scaffold) ενός ιστοτόπου, εκτελεί ένα πραγματικό WordPress στον δικό σας υπολογιστή χωρίς τίποτα άλλο εγκατεστημένο εκτός από το Node — χωρίς Docker, χωρίς MAMP, χωρίς PHP στο PATH σας — στη συνέχεια ελέγχει αυτό που δημιουργήσατε σε σχέση με την υποδοχή φιλοξενίας (hosting slot) στην οποία πρόκειται να κάνετε ανάπτυξη (deploy) και το προωθεί (push). Αυτός ο οδηγός σας καθοδηγεί από το μηδέν σε έναν ιστότοπο σε λειτουργία μέσα σε περίπου δύο λεπτά, και σας παρουσιάζει πώς μοιάζει η επιτυχία σε κάθε βήμα, ώστε να γνωρίζετε πότε κάτι έχει πάει στραβά.

Τι χρειάζεστε

• Node 24 ή νεότερο. Εκτελέστε node --version· πρέπει να εμφανίσει v24 ή ανώτερη έκδοση. Εγκαταστήστε την τρέχουσα έκδοση LTS από το nodejs.org — στα Windows με winget install OpenJS.NodeJS.LTS, στο macOS με brew install node@24.
• npm, το οποίο παρέχεται μαζί με το Node. Το Zinnector® το χρησιμοποιεί μία φορά, για να κατεβάσει το περιβάλλον εκτέλεσης (runtime) του WordPress στη δική του προσωρινή μνήμη (cache).
• git, μόνο για το zinnector push — οι αναπτύξεις πραγματοποιούνται από το αποθετήριό σας.
• Docker, μόνο αν το ζητήσετε με το --runtime docker. Το προεπιλεγμένο περιβάλλον εκτέλεσης δεν χρειάζεται κανένα.

Τίποτα από τα παρακάτω δεν απαιτεί λογαριασμό. Ένα κλειδί API χρειάζεται μόνο όταν φτάσετε σε μια υποδοχή φιλοξενίας, στην ενότητα Ανάπτυξη με το 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, μια δομή wp-content με τα plugins/, themes/ και έναν βοηθό mu-plugins/, ένα .gitignore και ένα README — ακολουθούμενα από τις επόμενες εντολές προς εκτέλεση. Τίποτα σε αυτό δεν είναι σύμβολο κράτησης θέσης (placeholder)· το έργο ξεκινά ως έχει. Το --template plugin ή το --template theme δημιουργεί τη δομή ενός προσθέτου (plugin) ή ενός θέματος μπλοκ (block theme) που ενεργοποιείται τη στιγμή που δημιουργείται.

Βήμα 5 — εκτελέστε το

cd my-site
zinnector dev

Την πρώτη φορά, το Zinnector® ρωτά μία φορά πριν κατεβάσει το περιβάλλον εκτέλεσης του WordPress — περίπου 570 MB, επειδή περιλαμβάνει κάθε έκδοση PHP από 5.2 έως 8.5 — στον δικό του κατάλογο προσωρινής μνήμης (cache), ποτέ μέσα στο έργο σας. Απαντήστε με Y, ή προσθέστε το --yes για να παραλείψετε την ερώτηση. Σε Node 26 ή νεότερο, λαμβάνει επίσης ένα Node 24 αποκλειστικά για το περιβάλλον εκτέλεσης (περίπου 30 MB, επαληθευμένο με τα αθροίσματα ελέγχου του nodejs.org), επειδή η εγγενής μονάδα (native module) του περιβάλλοντος εκτέλεσης διαθέτει προκατασκευασμένα εκτελέσιμα αρχεία μόνο για 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 σε ένα πρόγραμμα περιήγησης. Επιτυχία: ένας νέος ιστότοπος WordPress με τίτλο My WordPress Website, που εξυπηρετείται από την έκδοση 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® — σύνδεση, συσχέτιση του έργου με μια υποδοχή, προκαταρκτικός έλεγχος (pre-flight), προώθηση (push).
• Η τεκμηρίωση εντολών — κάθε εντολή, σημαία και παράδειγμα.
• Αντιμετώπιση προβλημάτων — τα σφάλματα που αντιμετωπίζουν συνήθως οι χρήστες και η λύση για το καθένα.

Η ίδια τεκμηρίωση περιλαμβάνεται στο αρχείο README του πακέτου στο npm και στο GitHub, όπου τα ζητήματα (issues) και τα αιτήματα έλξης (pull requests) είναι ευπρόσδεκτα.