Ρυθμίσεις
Το Blockstudio περιλαμβάνει ένα ισχυρό API ρυθμίσεων, που επιτρέπει τον ορισμό επιλογών μέσω ενός αρχείου blockstudio.json μέσα στον φάκελο του θέματος ή/και μέσω φίλτρων. Επιπλέον, οι χρήστες με τα κατάλληλα δικαιώματα μπορούν να αλλάζουν οπτικά τις ρυθμίσεις στην περιοχή διαχείρισης.
Μέσω JSON
Αν υπάρχει αρχείο blockstudio.json στον φάκελο του θέματος, θα χρησιμοποιηθεί για τον ορισμό των προεπιλεγμένων επιλογών για τον τρέχοντα ιστότοπο. Διατίθεται σχήμα JSON για την επικύρωση του αρχείου και την υποβοήθηση της αυτόματης συμπλήρωσης σε ένα IDE.
Το αρχείο είναι προαιρετικό. Χωρίς αυτό, το Blockstudio χρησιμοποιεί τις ρυθμίσεις που έχουν αποθηκευτεί στην περιοχή διαχείρισης, πάνω από τις ενσωματωμένες προεπιλογές του. Η προσθήκη, η αλλαγή ή η αφαίρεση του αρχείου εντοπίζεται αυτόματα, επομένως δεν απαιτείται εκκαθάριση της προσωρινής μνήμης ή μη αυτόματη επαναφόρτωση.
Διατίθενται οι εξής ιδιότητες:
{
"$schema": "https://blockstudio.dev/schema/blockstudio",
"users": {
"ids": [],
"roles": []
},
"assets": {
"enqueue": true,
"reset": {
"enabled": false,
"fullWidth": []
},
"minify": {
"css": false,
"js": false
},
"process": {
"scss": false
}
},
"cache": {
"enabled": true,
"path": "blockstudio/cache"
},
"themeDefaults": {
"titleTag": false,
"suppressDirectoryUpdates": false
},
"performance": {
"profile": "compat",
"wordpress": {
"headNoise": false,
"embeds": false,
"xmlrpc": false,
"editor": false,
"frontendAssets": false,
"media": false,
"heartbeat": false
},
"preload": {
"links": "off"
},
"media": {
"lazy": false,
"skeleton": false,
"metadata": false,
"rootMargin": "300px"
},
"measurement": {
"enabled": false,
"queryMonitor": false,
"headers": false,
"timings": false
}
},
"content": {
"enabled": false,
"id": "default",
"path": "content",
"includePageSyncManaged": false,
"authors": "ignore",
"postTypes": [],
"meta": {
"include": [],
"exclude": ["_edit_lock", "_edit_last", "_wp_old_slug"],
"references": {}
},
"taxonomies": [],
"media": "manifest"
},
"editor": {
"formatOnSave": false,
"assets": [],
"markup": false
},
"tailwind": {
"enabled": false,
"config": "",
"output": "inline"
},
"blockTags": {
"enabled": false,
"allow": [],
"deny": [],
"prefixes": {}
},
"ui": {
"enabled": false
},
"blockEditor": {
"disableLoading": false,
"enhance": false,
"cssClasses": [],
"cssVariables": [],
"blocks": {
"allow": [],
"deny": [],
"directory": true,
"categories": {
"allow": [],
"deny": [],
"rename": {},
"order": []
},
"styles": {
"deny": {}
},
"legacyWidgets": {
"hide": []
}
},
"patterns": {
"core": true,
"remote": true,
"theme": true,
"blockstudio": true,
"categories": {
"allow": [],
"deny": [],
"rename": {},
"order": []
}
},
"media": {
"openverse": true,
"imageSizes": {
"allow": [],
"deny": []
}
}
},
"dev": {
"grab": {
"enabled": false
},
"perf": false,
"canvas": {
"enabled": false,
"adminBar": true
}
},
"githooks": {
"commit": false
},
"phpstan": {
"preset": "base",
"configuration": "",
"roots": ["."],
"excludePaths": [],
"maxFiles": 10000
},
"ai": {
"enableContextGeneration": false
}
}
Μέσω φίλτρων
Εναλλακτικά, μπορείτε να χρησιμοποιήσετε το φίλτρο blockstudio/settings/${setting} για να ορίσετε επιλογές μέσω του PHP και να έχετε μεγαλύτερη ευελιξία.
add_filter('blockstudio/settings/assets/enqueue', '__return_false');
add_filter('blockstudio/settings/editor/formatOnSave', '__return_true');
add_filter('blockstudio/settings/ui/enabled', '__return_true');
add_filter('blockstudio/settings/block_editor/patterns/remote', '__return_false');
Οι επιλογές που ορίζονται μέσω του φίλτρου blockstudio/settings/${setting} υπερισχύουν εκείνων που ορίζονται μέσω του αρχείου blockstudio.json. Μπορείτε να χρησιμοποιήσετε και τις δύο μεθόδους μαζί.
Οι τιμές κατά τον χρόνο εκτέλεσης παρέχουν επίσης φίλτρα blockstudio/performance/${setting} και ένα τελικό φίλτρο blockstudio/performance/config. Το τελευταίο πρέπει να επιστρέφει ένα έγκυρο αντικείμενο ρυθμίσεων.
Πώς συνδυάζονται οι πηγές
Κάθε πηγή φορτώνεται και συγχωνεύεται, ξεκινώντας από τη χαμηλότερη προτεραιότητα:
- Ενσωματωμένες προεπιλογές
- Ρυθμίσεις αποθηκευμένες μέσω του UI διαχείρισης (η επιλογή
blockstudio_settings) blockstudio.jsonστο θέμα- Φίλτρα
blockstudio/settings/*
Το blockstudio.json υπερισχύει μόνο για τα κλειδιά που δηλώνει. Παλαιότερα αντικαθιστούσε πλήρως τις αποθηκευμένες ρυθμίσεις, οπότε μια άσχετη τιμή που είχε αποθηκευτεί από τη διαχείριση έπαυε να εφαρμόζεται μόλις εμφανιζόταν το αρχείο· τώρα προστίθεται πάνω από αυτές. Από την άλλη, μια παλιά τιμή που έχει αποθηκευτεί μέσω του UI διαχείρισης εξακολουθεί να εφαρμόζεται μέχρι το αρχείο να δηλώσει το συγκεκριμένο κλειδί ή να αφαιρεθεί η αποθηκευμένη τιμή. Αν μια ρύθμιση συμπεριφέρεται διαφορετικά από ό,τι ορίζει το αρχείο, ελέγξτε το αποθηκευμένο επίπεδο με το wp bs settings ή το Settings::get_raw(), το οποίο επιστρέφει μόνο όσα δήλωσε ρητά η ενεργή πηγή JSON ή επιλογών.
Ανάγνωση ρυθμίσεων από το PHP
Το Blockstudio\Settings φορτώνει την ενεργή πηγή, αναφέρει κακοσχηματισμένο JSON και επαναφορτώνεται αυτόματα όταν αλλάζει το blockstudio.json:
use Blockstudio\Settings;
$enabled = Settings::get_bool('performance/media/lazy');
$margin = Settings::get_string('performance/media/rootMargin', '300px');
$roles = Settings::get_array('users/roles');
$ttl = Settings::get_int('performance/staticPrerender/ttl', 86400);
foreach (Settings::errors() as $error) {
error_log($error);
}
Χρησιμοποιήστε το Settings::get_raw() όταν μια ενσωμάτωση χρειάζεται μόνο τις τιμές που έχουν δηλωθεί ρητά από το ενεργό JSON ή την πηγή επιλογών. Το Settings::fingerprint() επιστρέφει ένα ντετερμινιστικό αναγνωριστικό για τις ενεργές ρυθμίσεις. Οι διεργασίες μακράς διάρκειας μπορούν να καλέσουν ρητά το Settings::reload() για να διαβάσουν αμέσως μια αλλαγή αρχείου. Η κανονική πρόσβαση ελέγχει το αρχείο το πολύ μία φορά ανά δευτερόλεπτο μέσα σε ένα αίτημα ή μια διεργασία PHP μακράς διάρκειας, ακόμη και για επεξεργασίες που δεν αλλάζουν το μέγεθος. Η αλλαγή της διαμορφωμένης διαδρομής ισχύει στην επόμενη ανάγνωση. Όταν δεν είναι ενεργό κανένα αρχείο JSON, οι αποθηκευμένες ρυθμίσεις της βάσης δεδομένων δεν καθυστερούν μέσα σε αυτό το διάστημα.
Το επιλυμένο προφίλ απόδοσης είναι διαθέσιμο μέσω του Blockstudio\Runtime_Settings::current(). Υποστηρίζει διαδρομές με κάθετες ή τελείες:
use Blockstudio\Runtime_Settings;
$runtime = Runtime_Settings::current();
if ($runtime->enabled('measurement/queryMonitor')) {
$hash = $runtime->hash();
}
Διαθέσιμες ρυθμίσεις
users
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
ids |
array | [] |
Αναγνωριστικά χρηστών με πρόσβαση στον επεξεργαστή |
roles |
array | [] |
Ρόλοι χρηστών με πρόσβαση στον επεξεργαστή |
assets
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
enqueue |
boolean | true |
Αυτόματη προσθήκη στοιχείων ενεργητικού μπλοκ στην ουρά |
reset.enabled |
boolean | false |
Αφαίρεση των στυλ βασικών μπλοκ και εφαρμογή της επαναφοράς βοηθητικών κλάσεων του επεξεργαστή |
reset.fullWidth |
array | [] |
Τύποι αναρτήσεων που χρησιμοποιούν διάταξη επεξεργαστή πλήρους πλάτους |
minify.css |
boolean | false |
Ελαχιστοποίηση της εξόδου CSS |
minify.js |
boolean | false |
Ελαχιστοποίηση της εξόδου JS |
process.scss |
boolean | false |
Επεξεργασία αρχείων SCSS |
output |
string | source |
Τοποθεσία εγγραφής των μεταγλωττισμένων στοιχείων ενεργητικού: source ή cache |
inlineLimit |
integer | 0 |
Bytes εξωτερικών στυλ μπλοκ CSS που εμφανίζονται ενσωματωμένα ανά σελίδα |
Το output έχει ως προεπιλογή το source, το οποίο δημιουργεί έναν κατάλογο _dist δίπλα σε κάθε block. Ορίστε το σε cache για την εγγραφή των μεταγλωττισμένων στοιχείων στον κατάλογο προσωρινής μνήμης Blockstudio, ώστε το δέντρο πηγαίου κώδικα των block να παραμένει καθαρό και να μπορεί να αναπτυχθεί από ένα αμετάβλητο αντίγραφο εργασίας. Οι πηγές Blockstudio που δεν μπορούν να γράψουν ήδη ανακατευθύνονται στην προσωρινή μνήμη, ανεξάρτητα από αυτήν τη ρύθμιση.
Το inlineLimit είναι απενεργοποιημένο στην τιμή 0, επομένως κάθε εξωτερικό φύλλο στυλ διατηρεί την ετικέτα <link>. Ορίστε το σε αριθμό bytes για να εμφανίζονται ενσωματωμένα τα μικρότερα εξωτερικά φύλλα στυλ μπλοκ μιας σελίδας, εφόσον το συνολικό μέγεθός τους δεν υπερβαίνει αυτόν τον αριθμό. Το 40000 είναι το όριο που χρησιμοποιεί το WordPress για τον ίδιο κανόνα. Δείτε την ενότητα Ενσωμάτωση μικρών φύλλων στυλ.
Όταν το reset.enabled είναι ενεργό, το Blockstudio αντιγράφει επίσης στο καμβά του επεξεργαστή τις εκκαθαρισμένες τιμές body_class του frontend. Χρησιμοποιήστε το blockstudio/editor/canvas/body_class για να προσαρμόσετε τη λίστα κλάσεων που αφορά μόνο τον επεξεργαστή.
cache
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
enabled |
boolean | true |
Ενεργοποίηση προσωρινής μνήμης με βάση αρχεία για το Blockstudio |
path |
string | "blockstudio/cache" |
Διαδρομή προσωρινής μνήμης, σχετική με το WP_CONTENT_DIR ή απόλυτη |
namespaceGrace |
integer | 86400 |
Δευτερόλεπτα διατήρησης ενός αποσυρμένου χώρου ονομάτων προσωρινής μνήμης πριν από τη συλλογή του |
Από προεπιλογή, τα αρχεία προσωρινής μνήμης εγγράφονται στο wp-content/blockstudio/cache, έξω από τον κατάλογο μεταφορτώσεων. Μια σχετική διαδρομή path επιλύεται από το WP_CONTENT_DIR· μια απόλυτη διαδρομή χρησιμοποιείται απευθείας. Έτσι υποστηρίζονται φιλοξενητές που παρέχουν ξεχωριστό τόμο με δυνατότητα εγγραφής για την προσωρινή μνήμη.
Όταν είναι ενεργό, το Blockstudio χρησιμοποιεί αυτήν τη μία ρίζα για τα δεδομένα δόμησης, τα προμεταγλωττισμένα δεδομένα καταχώρισης block, τα επιλυμένα στοιχεία του επεξεργαστή, το Tailwind CSS, τα έγγραφα απόδοσης, τα τμήματα νησίδων, τις στατικές προαποδόσεις, τα ευρετήρια γραφημάτων, τις ουρές και τα διαγνωστικά. Κάθε αντικείμενο απομονώνεται ανά δίκτυο, ιστότοπο, πλήρη ταυτότητα χρόνου εκτέλεσης και πεδίο εφαρμογής. Οι ταυτότητες χρόνου εκτέλεσης καλύπτουν το Blockstudio, τις ρυθμίσεις, το WordPress, το PHP, το ενεργό θέμα, τα ενεργά πρόσθετα, τις λογικές πηγές εντοπισμού, το περιβάλλον φιλοξενίας και τα ρητά hash εξαρτήσεων που παρέχονται από την εκάστοτε λειτουργία.
Οι αλλαγές σε περιεχόμενο, όρους, χρήστες και μεταδεδομένα ακυρώνουν τις συμπληρωμένες επιλογές πεδίων, όχι την ανακάλυψη της δομής των block ή τα μεταγλωττισμένα αρχεία. Οι επιλογές ανανεώνονται χωριστά, με σταθερό κλείδωμα στη διαδρομή build. Μια ριπή εγγραφών, όπως ο συγχρονισμός μεταφράσεων ή μια εισαγωγή, συγχωνεύεται: η πρώτη εγγραφή μετά από μια περίοδο αδράνειας προκαλεί άμεση ανανέωση και η τελευταία εγγραφή της ριπής αποτυπώνεται μία φορά αφού περάσουν τριάντα δευτερόλεπτα, με δυνατότητα προσαρμογής μέσω του blockstudio/cache/populate_debounce. Τα μεταδεδομένα που το WordPress εγγράφει ως λογιστική καταχώριση, όπως το κλείδωμα επεξεργασίας της ανάρτησης, δεν θεωρούνται αλλαγή· το blockstudio/cache/populate_ignored_meta_keys επεκτείνει αυτή τη λίστα. Ο επεξεργαστής αναζητά πάντα τις ενεργές επιλογές, επομένως το χρονικό παράθυρο επηρεάζει μόνο τις αποθηκευμένες επιλογές που διαβάζονται κατά την απόδοση. Τα αρχεία πηγαίου κώδικα και οι ρυθμίσεις build εξακολουθούν να ακυρώνουν κανονικά την προσωρινή μνήμη δομής. Η αντικατάσταση των επιλογών δεν προκαλεί νέα σάρωση του καταλόγου προσωρινής μνήμης σε κάθε αλλαγή περιεχομένου· ο περιοδικός καθαρισμός εξακολουθεί να συλλέγει τα ορφανά προσωρινά αρχεία. Οι ταυτότητες χρόνου εκτέλεσης για κάθε γλώσσα παραμένουν απομονωμένες· η παρουσία πολλών καταλόγων χώρων ονομάτων προσωρινής μνήμης σε έναν πολύγλωσσο ιστότοπο δεν αποτελεί από μόνη της ένδειξη αστοχίας της προσωρινής μνήμης.
Η δραστηριότητα ημερολογίου SQLite μέσα στον κατάλογο δεδομένων db ενός block δεν απορρίπτει τα αποθηκευμένα μεταδεδομένα του block. Οι αλλαγές στο db.php, στα παρακολουθούμενα αρχεία πηγαίου κώδικα ή στη δομή αρχείων πηγαίου κώδικα και υποκαταλόγων του καταλόγου δεδομένων εξακολουθούν να ακυρώνουν την προσωρινή μνήμη.
Στις ταυτόχρονες ανακατασκευές χρόνου εκτέλεσης εκλέγεται ένας δημιουργός. Τα άλλα αιτήματα περιμένουν έως πέντε δευτερόλεπτα και στη συνέχεια χρησιμοποιούν τα μεταδεδομένα block της τελευταίας επιτυχημένης δόμησης, εφόσον εξακολουθούν να υπάρχουν τα αρχεία πηγής και τα απαιτούμενα μεταγλωττισμένα στοιχεία. Ένα ψυχρό αίτημα χωρίς ασφαλές φορτίο επιστρέφει HTTP 503 με Retry-After, αντί να ξεκινήσει άλλη δόμηση. Το φίλτρο blockstudio/cache/build_wait_budget προσαρμόζει τον χρόνο αναμονής σε χιλιοστά του δευτερολέπτου τόσο για τις δομικές ανακατασκευές όσο και για τις ανανεώσεις επιλογών. Σε φιλοξενητή χωρίς συμβουλευτικά κλειδώματα αρχείων, οι επιλογές ανανεώνονται χωρίς προστασία και εξακολουθούν να δημοσιεύονται, ώστε το επόμενο αίτημα να τις βρει στην προσωρινή μνήμη.
Τα αδρανή αρχεία .build.lock ειδικά για κλειδιά, που άφησαν παλαιότερες εκδόσεις, συλλέγονται σε όλους τους χώρους ονομάτων προσωρινής μνήμης αυτού του ιστότοπου από το WP-Cron. Η διαδικασία ξεκινά πέντε λεπτά μετά την αναβάθμιση και αφαιρεί έως 10,000 κλειδώματα ανά λεπτό, εντός χρονικού ορίου δέκα δευτερολέπτων. Το wp bs cache status αναφέρει πόσα απομένουν και το wp bs cache cleanup εκκαθαρίζει αμέσως τις εκκρεμότητες, ενώ το wp bs cache clear εκκαθαρίζει την προσωρινή μνήμη χρόνου εκτέλεσης. Αν μια προγραμματισμένη δέσμη καθυστερεί πάνω από δέκα λεπτά επειδή δεν εκτελείται το cron, τα αιτήματα σαρώνουν μία φορά την ώρα έναν περιορισμένο αριθμό κλειδωμάτων, ώστε να μην κολλήσει η εκκαθάριση. Τα πρόσφατα κλειδώματα ή όσα βρίσκονται σε χρήση δεν πειράζονται, ενώ τα νέα κλειδώματα σταθερής διαδρομής δεν συλλέγονται ποτέ. Όταν εκκαθαριστούν οι εκκρεμότητες, η ίδια δέσμη συλλέγει τους εγκαταλελειμμένους χώρους ονομάτων προσωρινής μνήμης μόλις παρέλθει το namespaceGrace τους, το πολύ μία φορά την ώρα ανά ιστότοπο, και διατηρεί μια ημερήσια εκτέλεση για αυτόν τον σκοπό. Η περίοδος χάριτος μετρά από την πρώτη σάρωση που εντοπίζει έναν αποσυρμένο χώρο ονομάτων, όχι από το πιο πρόσφατο αρχείο του, και ένας χώρος ονομάτων που εξακολουθεί να είναι ενεργός σε οποιοδήποτε πεδίο εφαρμογής δεν συλλέγεται ποτέ.
Ο εσωτερικός καθαρισμός της προσωρινής μνήμης δεν ενεργοποιεί φίλτρα διαγραφής συνημμένων του WordPress. Οι φιλοξενητές με απενεργοποιημένο το WP-Cron πρέπει να συνεχίσουν να εκτελούν τη συνήθη προγραμματισμένη διεργασία εργασίας cron· μην διαγράφετε αδιακρίτως ενεργά αρχεία κλειδώματος για να εκκαθαρίσετε τις εκκρεμότητες.
Το φίλτρο ρύθμισης blockstudio/settings/cache/path αλλάζει τη διαμορφωμένη τιμή. Για την επίλυση διαδρομών ανάλογα με την ανάπτυξη, το blockstudio/cache/dir φιλτράρει τον επιλυμένο βασικό κατάλογο:
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Οι φιλοξενητές με ταυτότητα μισθωτή διαφορετική από τα αναγνωριστικά δικτύου/ιστολογίου του WordPress μπορούν να φιλτράρουν το blockstudio/cache/site_key. Το αποτέλεσμα καθαρίζεται και χρησιμοποιείται μόνο ως τμήμα καταλόγου. Το blockstudio/cache/context παραμένει το κατάλληλο σημείο για μια σειριοποιήσιμη παραλλαγή χρόνου εκτέλεσης που πρέπει να αλλάζει τις ταυτότητες αντικειμένων.
themeDefaults
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
titleTag |
boolean | false |
Ενεργοποίηση υποστήριξης ετικέτας τίτλου θέματος WordPress |
suppressDirectoryUpdates |
boolean | false |
Αφαίρεση των ενεργών θυγατρικών και γονικών θεμάτων από τα αποτελέσματα ενημέρωσης καταλόγου |
Τα μοτίβα εξακολουθούν να χρησιμοποιούν το υπάρχον Blockstudio\Patterns API· αυτές οι προεπιλογές δεν προσθέτουν εναλλακτικές προσόψεις για σελίδες ή μοτίβα.
performance
Το προφίλ compat αφήνει αμετάβλητη τη γενική συμπεριφορά του WordPress. Τα speed και strict ενεργοποιούν τις ίδιες προαιρετικές προεπιλογές frontend· κάθε θυγατρική ρύθμιση μπορεί να παρακάμψει την τιμή του προφίλ της.
Οι προαιρετικές ρυθμίσεις λειτουργούν ως πύλες καταχώρισης. Όταν μια προαιρετική λειτουργία είναι false, το Blockstudio δεν συνδέει τις αντίστοιχες κλήσεις επανάκλησης του frontend, της διαχείρισης, του επεξεργαστή, του REST ή του χρονοπρογραμματισμού. Η απενεργοποίηση του Early Serve ή της προγραμματισμένης προθέρμανσης αφού έχουν χρησιμοποιηθεί εκτελεί μία φορά τον καθαρισμό που τους αναλογεί· τα επόμενα αιτήματα δεν κάνουν τίποτα.
| Επιλογή | Τύπος | Προεπιλογή συμβατότητας | Προεπιλογή ταχύτητας/αυστηρότητας | Περιγραφή |
|---|---|---|---|---|
profile |
string | "compat" |
Δεν εφαρμόζεται | compat, speed ή strict |
wordpress.headNoise |
boolean | false |
true |
Αφαίρεση της γενικής ανακάλυψης στο head και της εξόδου emoji |
wordpress.embeds |
boolean | false |
true |
Αφαίρεση της ανακάλυψης oEmbed και των σεναρίων host |
wordpress.xmlrpc |
boolean | false |
true |
Απενεργοποίηση των XML-RPC και των pingbacks |
wordpress.editor |
boolean | false |
true |
Απενεργοποίηση απομακρυσμένων επιφανειών ανακάλυψης του επεξεργαστή |
wordpress.frontendAssets |
boolean | false |
true |
Αφαίρεση γενικών στοιχείων frontend του core |
wordpress.media |
boolean | false |
true |
Εφαρμογή προεπιλογών εξόδου εικόνων |
wordpress.heartbeat |
boolean | false |
true |
Περιορισμός του Heartbeat εκτός των επεξεργαστών |
preload.links |
string | "off" |
"intent" |
Προφόρτωση εγγράφων ίδιας προέλευσης μετά από ενέργεια χρήστη |
media.lazy |
boolean | false |
true |
Χρήση του φορτωτή εικόνων του Blockstudio |
media.skeleton |
boolean | false |
true |
Εμφάνιση του ενσωματωμένου σκελετού φόρτωσης |
media.metadata |
boolean | false |
true |
Δήλωση χρήσης του assets/media.json |
media.rootMargin |
string | "300px" |
"300px" |
Περιθώριο τομής για lazy-loader |
measurement.enabled |
boolean | false |
false |
Ενεργοποίηση API μέτρησης κατά τον χρόνο εκτέλεσης |
measurement.queryMonitor |
boolean | false |
false |
Συμπερίληψη ερωτημάτων διάρκειας τουλάχιστον 50ms |
measurement.headers |
boolean | false |
false |
Αποστολή κεφαλίδων κατακερματισμού προφίλ και ρυθμίσεων |
measurement.timings |
boolean | false |
false |
Αποστολή κεφαλίδας χρόνου εκτέλεσης |
staticPrerender.enabled |
boolean | false |
false |
Ενεργοποίηση ασφαλούς για ανώνυμους χρήστες προσωρινής αποθήκευσης HTML |
staticPrerender.ttl |
integer | 86400 |
86400 |
Μέγιστη ηλικία αποθηκευμένου εγγράφου σε δευτερόλεπτα |
staticPrerender.invalidate |
string | "signature" |
"signature" |
Χρήση ταυτότητας signature ή σταδιακής graph |
staticPrerender.earlyServe |
boolean | false |
false |
Εξυπηρέτηση ασφαλών επιτυχιών πριν από την εκκίνηση του WordPress |
staticPrerender.serveLoggedIn |
boolean | false |
false |
Να επιτρέπεται στους χρήστες να καταναλώνουν επιτυχίες cache, ποτέ να τις δημιουργούν |
staticPrerender.dynamicPaths |
array | [] |
[] |
Προθέματα διαδρομής που πρέπει να παραμένουν δυναμικά |
staticPrerender.replayHeaders |
array | ["Link"] |
["Link"] |
Κεφαλίδες απόκρισης που αποθηκεύονται και αποστέλλονται σε επιτυχίες cache |
staticPrerender.warm.enabled |
boolean | false |
false |
Ενεργοποίηση της ανθεκτικής προγραμματισμένης ουράς προθέρμανσης |
staticPrerender.warm.interval |
integer | 3600 |
3600 |
Διάστημα προθέρμανσης σε δευτερόλεπτα |
staticPrerender.warm.concurrency |
integer | 2 |
2 |
Μέγιστος αριθμός εργασιών ανά εκτέλεση προθέρμανσης |
staticPrerender.warm.transport |
string | "http" |
"http" |
Χρήση του http ή ενός renderer που παρέχεται από τον host internal |
Η στατική προαπόδοση παραμένει απενεργοποιημένη, εκτός αν ενεργοποιηθεί ρητά. Ένας απενεργοποιημένος κύριος διακόπτης δεν καταχωρίζει hooks αιτημάτων προαπόδοσης, ενώ οι απενεργοποιημένοι διακόπτες earlyServe και warm.enabled δεν καταχωρίζουν hooks διαχειριστή ή cron. Η λειτουργία υπογραφής χρησιμοποιεί μια ελαφριά ταυτότητα που ενεργοποιείται στα συνήθη αιτήματα. Η λειτουργία γραφήματος προορίζεται για ρητές δημιουργίες: καταγράφει τις εξαρτήσεις πηγής ανά σελίδα, ώστε η αλλαγή μίας σελίδας να μην ακυρώνει άσχετα έγγραφα. Δείτε τη Στατική προαπόδοση για λεπτομέρειες σχετικά με την προθέρμανση, την ανάπτυξη, την πρόωρη εξυπηρέτηση και την ασφάλεια.
Οι μετρήσεις είναι διαθέσιμες μέσω προγραμματισμού:
use Blockstudio\Performance_Measurement;
$snapshot = Performance_Measurement::snapshot();
Όταν είναι ενεργοποιημένες οι κεφαλίδες, το Blockstudio αποστέλλει τα X-Blockstudio-Performance-Profile, X-Blockstudio-Performance-Config και προαιρετικά το X-Blockstudio-Performance-Time. Η ενέργεια blockstudio/performance/measurement_enabled λαμβάνει τις επιλυμένες ρυθμίσεις χρόνου εκτέλεσης.
Οι επιλογές media καθορίζουν το bs_media_image(), το μανιφέστο assets/media.json και τον lazy loader του frontend. Δείτε τα Μέσα για το βοηθητικό εργαλείο, το εργαλείο δημιουργίας μανιφέστου και τη συμπεριφορά του loader.
content
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
enabled |
boolean | false |
Ενεργοποιεί τη διαμόρφωση Content Sync |
id |
string | "default" |
Χώρος ονομάτων συνόλου περιεχομένου που αποθηκεύεται στις συγχρονισμένες οντότητες |
path |
string | "content" |
Κατάλογος αρχείων περιεχομένου σχετικός με το θέμα |
includePageSyncManaged |
boolean | false |
Συμπεριλαμβάνει αναρτήσεις που διαχειρίζεται το Page Sync χωρίς να αναλαμβάνει το σώμα τους |
authors |
string | "ignore" |
Διαχείριση συντάκτη (ignore ή υπάρχων χρήστης login) |
postTypes |
array | [] |
Επιτρεπόμενοι τύποι αναρτήσεων |
meta.include |
array | [] |
Μοτίβα glob για συγχρονισμό meta keys |
meta.exclude |
array | ["_edit_lock", "_edit_last", "_wp_old_slug"] |
Μοτίβα glob για εξαίρεση meta keys |
meta.references |
object | {} |
Δηλωμένες αναφορές meta που αναδιαγράφονται μεταξύ ID και UID |
taxonomies |
array | [] |
Επιτρεπόμενες καταχωρισμένες ταξινομίες για όρους και σχέσεις |
media |
string | "manifest" |
Συμπεριφορά αναφοράς συνημμένων (manifest ή none) |
Το Content Sync διαχειρίζεται μέσω του wp bs content και μετατρέπει τις επιτρεπόμενες αναρτήσεις, τα postmeta και τις δηλωμένες αναφορές σε φορητά αρχεία. Δείτε το Content Sync για τη ροή εργασίας και τη μορφή αρχείων.
editor
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
formatOnSave |
boolean | false |
Μορφοποιεί το block.json κατά την αποθήκευση |
assets |
array | [] |
Πρόσθετα στοιχεία που φορτώνονται στον επεξεργαστή |
markup |
boolean | false |
Ενεργοποιεί την επεξεργασία σήμανσης |
tailwind
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
enabled |
boolean | false |
Ενεργοποιεί τη μεταγλώττιση Tailwind CSS |
config |
string | "" |
Διαμόρφωση Tailwind v4 με προτεραιότητα CSS |
Δείτε τα Tailwind CSS για τη συμπεριφορά μεταγλώττισης και τη μορφή διαμόρφωσης με προτεραιότητα CSS.
blockTags
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
enabled |
boolean | false |
Ενεργοποιεί την απόδοση ετικετών bs: σε επίπεδο σελίδας στο περιεχόμενο αναρτήσεων και στις περιοχές widget |
allow |
array | [] |
Λίστα επιτρεπόμενων μοτίβων ονομάτων μπλοκ· υποστηρίζει χαρακτήρες μπαλαντέρ fnmatch() |
deny |
array | [] |
Λίστα αποκλεισμένων μοτίβων ονομάτων μπλοκ· υπερισχύει του allow |
prefixes |
object | {} |
Πρόθεμα για συντομογραφίες χώρου ονομάτων· κάθε τιμή είναι χώρος ονομάτων ή ταξινομημένος πίνακας |
Η απόδοση ετικετών σε επίπεδο προτύπου είναι πάντα ενεργή· αυτές οι επιλογές ελέγχουν την αντικατάσταση σε επίπεδο σελίδας. Δείτε την Απόδοση για τη σύνταξη των ετικετών και τους κανόνες επίλυσης.
ui
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
enabled |
boolean | false |
Καταχωρίζει τα ενσωματωμένα στοιχεία bsui/* UI και τις δοκιμαστικές εφαρμογές app/* |
blockEditor
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
disableLoading |
boolean | false |
Απενεργοποιεί τη φόρτωση μπλοκ στον επεξεργαστή |
enhance |
boolean | false |
Ενεργοποιεί τις δυνατότητες αιώρησης και επιλογής του επεξεργαστή Blockstudio |
cssClasses |
array | [] |
URL stylesheet από τα οποία εξάγονται κλάσεις CSS για την αυτόματη συμπλήρωση του πεδίου κλάσεων |
cssVariables |
array | [] |
URL stylesheet από τα οποία εξάγονται μεταβλητές CSS για την αυτόματη συμπλήρωση του πεδίου κώδικα |
blockEditor.blocks
Χρησιμοποιήστε το blockEditor.blocks για την πολιτική εισαγωγής μπλοκ σε όλο το έργο. Τα allow και deny δέχονται ονόματα μπλοκ και μοτίβα μπαλαντέρ όπως το core/*.
{
"blockEditor": {
"blocks": {
"allow": ["core/*", "my-theme/*"],
"deny": ["core/embed", "core/freeform"],
"directory": false,
"categories": {
"rename": {
"text": "Writing",
"design": "Layout"
},
"order": ["my-theme", "text", "media"]
},
"legacyWidgets": {
"hide": ["archives", "calendar"]
}
}
}
}
Το blocks.styles.deny καταργεί την καταχώριση στυλ που είχαν καταχωριστεί μέσω του μητρώου στυλ μπλοκ WordPress:
PHP
{
"blockEditor": {
"blocks": {
"styles": {
"deny": {
"my-theme/card": ["outline"],
"my-theme/media": ["framed"]
}
}
}
}
}
blockEditor.patterns
Χρησιμοποιήστε το blockEditor.patterns για να απενεργοποιήσετε τις καθολικές πηγές μοτίβων και να φιλτράρετε τις κατηγορίες μοτίβων.
{
"blockEditor": {
"patterns": {
"core": false,
"remote": false,
"theme": true,
"blockstudio": true,
"categories": {
"deny": ["gallery"],
"rename": {
"featured": "Featured Layouts"
},
"order": ["featured", "buttons"]
}
}
}
}
blockEditor.media
Χρησιμοποιήστε το blockEditor.media για την πολιτική καθολικής εισαγωγής πολυμέσων.
{
"blockEditor": {
"media": {
"openverse": false,
"imageSizes": {
"allow": ["thumbnail", "large"],
"deny": ["medium_large"]
}
}
}
}
dev
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
grab.enabled |
boolean | false |
Ενεργοποιεί το εργαλείο επιλογής στοιχείων στο frontend |
perf |
boolean | false |
Ενεργοποιεί τον καταγραφέα επιδόσεων σε κάθε φόρτωση σελίδας |
canvas.enabled |
boolean | false |
Ενεργοποιεί τον καμβά |
canvas.adminBar |
boolean | true |
Εμφανίζει τη γραμμή διαχείρισης WordPress κατά την προβολή του καμβά |
githooks
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
commit |
boolean | false |
Δημιουργεί hook pre-commit μόνο για ανάλυση όταν εκτελείται το blockstudio-githooks sync |
Δείτε το διαχειριζόμενο hook commit για να μάθετε τι εκτελεί το hook που δημιουργείται και πώς παραμένει συγχρονισμένο.
phpstan
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
preset |
string | "base" |
Προεπιλογή ανάλυσης όταν η γραμμή εντολών δεν επιλέγει μία: base, theme, extreme-theme ή wordpress-render |
configuration |
string | "" |
Διαμόρφωση PHPStan έργου που συμπεριλαμβάνεται μαζί με την προεπιλογή, από το blockstudio.json |
roots |
array | ["."] |
Ρίζες θέματος που αναλύονται από την κανονική εντολή |
excludePaths |
array | [] |
Πρόσθετες εξαιρέσεις σαρωτή σε σχέση με κάθε διαμορφωμένη ρίζα |
maxFiles |
integer | 10000 |
Μέγιστος αριθμός αρχείων που εξετάζει ο σαρωτής θεμάτων |
blockTags |
object | {} |
Αντιστοιχίσεις στοιχείων, ψευδώνυμα ετικετών και scanPhp για τον κανόνα ετικέτας μπλοκ |
Αυτές οι ρυθμίσεις καθορίζουν την κανονική εντολή blockstudio-phpstan. Δείτε τα PHPStan για προεπιλογές, επίπεδα και υιοθέτηση.
ai
| Επιλογή | Τύπος | Προεπιλογή | Περιγραφή |
|---|---|---|---|
enableContextGeneration |
boolean | false |
Δημιουργεί ένα ενιαίο αρχείο περιβάλλοντος με μπλοκ, ρυθμίσεις, σχήματα και τεκμηρίωση για εργαλεία LLM |
Δείτε την Ενσωμάτωση AI για το ευρετήριο τεκμηρίωσης και το πλήρες παραγόμενο κείμενο.
Ενεργοποιήστε και συνθέστε τα ενσωματωμένα headless στοιχεία UI που εισήχθησαν στην έκδοση Blockstudio 7.3.