Καμβάς
Ο καμβάς παρέχει μια συνοπτική επισκόπηση τύπου Figma όλων των σελίδων που διαχειρίζεται το Blockstudio. Κάθε σελίδα αποδίδεται ως ζωντανός καμβάς εργασίας iframe σε μία οριζόντια σειρά. Μετακινήστε την προβολή με το trackpad και κάντε ζουμ με τσίμπημα ή Ctrl+κύλιση.
Ενεργοποίηση
Ο καμβάς είναι διαθέσιμος ως κρυφή σελίδα διαχείρισης. Μεταβείτε στη διεύθυνση:
/wp-admin/admin.php?page=blockstudio-canvas
Η σελίδα είναι προσβάσιμη μόνο όταν το dev.canvas.enabled είναι true και ο τρέχων χρήστης έχει τη δυνατότητα edit_posts.
Ρυθμίσεις
Ενεργοποιήστε τον καμβά και διαμορφώστε τη συμπεριφορά του στο blockstudio.json του θέματος:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
| Ιδιότητα | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
enabled |
boolean |
false |
Ενεργοποίηση της λειτουργίας καμβά. |
adminBar |
boolean |
true |
Εμφάνιση της γραμμής διαχείρισης WordPress μέσα στα iframe καμβάδων εργασίας. Ορίστε το σε false για καθαρότερη προεπισκόπηση. |
Και οι δύο ρυθμίσεις είναι επίσης διαθέσιμες ως φίλτρα:
add_filter('blockstudio/settings/dev/canvas/enabled', '__return_true');
add_filter('blockstudio/settings/dev/canvas/admin_bar', '__return_false');
Προβολές
Εναλλάσσετε προβολές από το αναπτυσσόμενο μενού στην επάνω δεξιά γωνία.
- Σελίδες: Όλες οι σελίδες που διαχειρίζεται το Blockstudio, ως καμβάδες εργασίας πλήρους πλάτους σε μία σειρά.
- Blocks: Όλα τα καταχωρισμένα blocks του Blockstudio σε διάταξη πλέγματος, καθένα αποδοσμένο με τις προεπιλεγμένες τιμές χαρακτηριστικών του.
Δημόσιος κατάλογος και τεκμηρίωση εγγράφου API
Το Canvas παρέχει ένα συμβόλαιο PHP με έκδοση, ανεξάρτητο από καταναλωτές, για εργαλεία που χρειάζονται το ίδιο καταχωρισμένο περιεχόμενο χωρίς να αναδημιουργούν τη λογική εντοπισμού ή απόδοσης του Blockstudio:
use Blockstudio\Canvas;
$all = Canvas::inventory();
$changed = Canvas::inventory([
'blocks' => ['theme/hero'],
'pages' => ['about'],
]);
$documents = Canvas::documents([
'patterns' => ['theme/featured'],
'templates' => ['front-page'],
]);
Η τρέχουσα έκδοση είναι διαθέσιμη ως Canvas::SCHEMA_VERSION. Τα αποτελέσματα καταλόγου περιέχουν:
inventory: κανονικοποιημέναpages,blocks,patterns,templates,partsκαι παραδείγματα δημόσιας οικογένειαςuiorder: τη σταθερή σειρά εμφάνισης μεταξύ τύπωνsources: ακριβείς επιλεγμένες διαδρομές πηγής με προέλευση σε κάθε εγγραφή· τοsourceμιας εγγραφής σελίδας είναι η σταθερή ταυτότητα πηγής της, ενώ τοpathείναι η φυσική διαδρομή προτύπου απόδοσηςwarningsκαιerrors: δομημένα ζητήματα αντί για παραγόμενη έξοδοdeleted: ζητούμενα αναγνωριστικά που δεν υπάρχουν πλέονselection: την κανονικοποιημένη επιλογή και αν στοχεύτηκε
Το Canvas::documents() προσθέτει ένα πλήρες έγγραφο απόδοσης για κάθε επιλεγμένη εγγραφή. Κάθε έγγραφο περιέχει το σώμα του, συναρμολογημένο HTML, ονόματα block με κλειστές εξαρτήσεις, καθώς και ακριβή CSS, JavaScript, modules, αρχικοποίηση διαδραστικότητας, ενσωματωμένα καθολικά UI και έξοδο Tailwind. Τα έγγραφα σελίδων χρησιμοποιούν σημασιολογικό περίβλημα περιεχομένου <main>· οι καλούντες μπορούν να το παρακάμψουν ή να το απενεργοποιήσουν μέσω των κοινών επιλογών εγγράφου Render. Κάθε επιλεγμένη σελίδα αποδίδεται στο δικό της αποκατεστημένο περιβάλλον frontend WordPress, ώστε οι συνθήκες query, τα φίλτρα κλάσεων body, τα shortcodes, οι διατάξεις, οι ανακατευθύνσεις και οι επανακλήσεις wp_enqueue_scripts να αφορούν εκείνη τη σελίδα και όχι το αίτημα διαχειριστή ή REST που ζήτησε το αποτέλεσμα Canvas. Οι κλάσεις body που παρέχει ο καλών συνδυάζονται με τις κλάσεις της σελίδας, ενώ τα μητρώα enqueue του frontend απομονώνονται μεταξύ εγγράφων. Το Canvas επιλύει αυτές τις επανακλήσεις κύκλου ζωής μέσω των δημόσιων ονομάτων συναρτήσεων WordPress, ώστε να διατηρείται το ίδιο περιβάλλον όταν το Blockstudio φορτώνεται μέσω του Composer ή ενός μετεγκατεστημένου χώρου ονομάτων εφαρμογής.
Σημασιολογία ακριβούς επιλογής
Η επιλογή είναι αυστηρή:
- Χωρίς αναγνωρισμένα κλειδιά τύπων, φορτώνονται όλοι οι τύποι.
- Τα
true,nullή"*"φορτώνουν όλες τις εγγραφές αυτού του τύπου. - Μια συμβολοσειρά ή λίστα φορτώνει μόνο ακριβή ID, ονόματα, slug, διαδρομές ή διαδρομές πηγής.
- Μια κενή συμβολοσειρά/λίστα ή το
falseδεν φορτώνει κανένα στοιχείο αυτού του τύπου. - Μόλις υπάρχει οποιοδήποτε κλειδί τύπου, οι τύποι που παραλείπονται δεν εντοπίζονται, δεν συγχρονίζονται, δεν αποδίδονται ούτε μεταγλωττίζονται.
Έτσι τα αιτήματα μόνο για αλλαγές είναι ασφαλή σε μεγάλα έργα. Τα υπάρχοντα blocks και οι σελίδες επιλύονται μέσω των κανονικών μητρώων τους. Όταν ένα αίτημα frontend έχει φορτωμένη μόνο την αποθηκευμένη προβολή σελίδας, το Canvas εκτελεί εντοπισμό πηγών μόνο για ανάγνωση και συγχωνεύει τα αντίστοιχα ID αναρτήσεων και τους μόνιμους συνδέσμους χωρίς να συγχρονίζει περιεχόμενο. Η ίδια συγχώνευση ταυτότητας εφαρμόζεται όταν μια λογική πηγή εντοπισμού συμπληρώνει πρώτα το μητρώο που βασίζεται σε πηγές, ώστε η απόδοση σελίδας με βάση τα συμφραζόμενα να χρησιμοποιεί την αντίστοιχη διαχειριζόμενη ανάρτηση WordPress. Η νέα τοπολογία ζωντανής συνεδρίας εντοπίζεται μόνο γύρω από τον τροποποιημένο κατάλογο, ενώ οι επιλεγμένες πηγές pattern και προτύπων Site Editor μεταγλωττίζονται μόνο μετά την επιλογή.
Το endpoint ανανέωσης REST ακολουθεί τον ίδιο κανόνα για τις υπάρχουσες παραμέτρους query blocks και pages. Για παράδειγμα, το ?blocks=theme/hero επιστρέφει αυτό το block και καμία σελίδα· χρησιμοποιήστε και τις δύο παραμέτρους για μικτή απόκριση. Η κλήση του endpoint χωρίς καμία από τις δύο παραμέτρους διατηρεί την πλήρη παλαιού τύπου απόκριση.
Ζωντανή λειτουργία
Η ζωντανή λειτουργία χρησιμοποιεί Server-Sent Events (SSE) για να εντοπίζει αλλαγές αρχείων και να ενημερώνει τον καμβά σε πραγματικό χρόνο. Όταν επεξεργάζεστε ένα πρότυπο block, ένα πρότυπο σελίδας ή ένα φύλλο στυλ, οι επηρεαζόμενοι καμβάδες εργασίας ανανεώνονται αυτόματα μέσα σε περίπου ένα δευτερόλεπτο.
Ενεργοποιήστε ή απενεργοποιήστε τη ζωντανή λειτουργία από το αναπτυσσόμενο μενού. Όταν είναι ενεργή, εμφανίζεται μια πράσινη ένδειξη που πάλλεται. Η ρύθμιση διατηρείται μεταξύ συνεδριών μέσω του localStorage.
Η ζωντανή λειτουργία παρακολουθεί αλλαγές σε αρχεία .php, .json, .css, .scss, .js, .twig και .html στους καταλόγους block και σελίδων. Οι γνωστές επεξεργασίες ανανεώνουν μόνο το αντίστοιχο καταχωρισμένο block ή σελίδα. Ένα πραγματικά νέο block ή σελίδα ενεργοποιεί μία σάρωση τοπολογίας περιορισμένη στον κατάλογό του, ώστε να λειτουργεί η δημιουργία περιεχομένου σε ήδη ανοιχτή ζωντανή συνεδρία χωρίς επανεξέταση άσχετων πηγών.
Λειτουργία εστίασης
Κάντε κλικ σε οποιαδήποτε ετικέτα artboard για να μεταβείτε στη λειτουργία εστίασης. Το επιλεγμένο artboard καταλαμβάνει όλο το πλάτος της προβολής και μπορείτε να κάνετε κάθετη κύλιση. Πατήστε Escape ή κάντε κλικ στο κουμπί κλεισίματος για να επιστρέψετε στην επισκόπηση.
Χειριστήρια
| Ενέργεια | Είσοδος |
|---|---|
| Μετατόπιση | Κύλιση / σύρσιμο δύο δακτύλων στην επιφάνεια αφής |
| Μεγέθυνση | Ctrl+κύλιση ή τσίμπημα |
| Προσαρμογή στην προβολή | Αναπτυσσόμενο μενού |
| Μεγέθυνση στο 100% | Αναπτυσσόμενο μενού |
| Εστίαση στο artboard | Κλικ στην ετικέτα του artboard |
| Έξοδος από την εστίαση | Escape / κουμπί κλεισίματος |
Ασφάλεια
Το script του καμβά και τα δεδομένα της σελίδας φορτώνονται μόνο όταν πληρούνται όλες οι προϋποθέσεις:
- Η ρύθμιση
dev.canvas.enabledείναιtrue. - Ο τρέχων χρήστης έχει τη δυνατότητα
edit_posts.
Οι δημόσιοι επισκέπτες δεν βλέπουν ποτέ το script του καμβά ή τα μεταδεδομένα της σελίδας.