Μετάβαση στο περιεχόμενο

Ρυθμίσεις

Το Blockstudio περιλαμβάνει ένα ισχυρό API ρυθμίσεων, που επιτρέπει τον ορισμό επιλογών μέσω ενός αρχείου blockstudio.json μέσα στον φάκελο του θέματος ή/και μέσω φίλτρων. Επιπλέον, οι χρήστες με τα κατάλληλα δικαιώματα μπορούν να αλλάζουν οπτικά τις ρυθμίσεις στην περιοχή διαχείρισης.

Μέσω JSON

Αν υπάρχει αρχείο blockstudio.json στον φάκελο του θέματος, θα χρησιμοποιηθεί για τον ορισμό των προεπιλεγμένων επιλογών για τον τρέχοντα ιστότοπο. Διατίθεται σχήμα JSON για την επικύρωση του αρχείου και την υποβοήθηση της αυτόματης συμπλήρωσης σε ένα IDE.

Το αρχείο είναι προαιρετικό. Χωρίς αυτό, το Blockstudio χρησιμοποιεί τις ρυθμίσεις που έχουν αποθηκευτεί στην περιοχή διαχείρισης, πάνω από τις ενσωματωμένες προεπιλογές του. Η προσθήκη, η αλλαγή ή η αφαίρεση του αρχείου εντοπίζεται αυτόματα, επομένως δεν απαιτείται εκκαθάριση της προσωρινής μνήμης ή μη αυτόματη επαναφόρτωση.

Διατίθενται οι εξής ιδιότητες:

JSON
{
  "$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 και να έχετε μεγαλύτερη ευελιξία.

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. Το τελευταίο πρέπει να επιστρέφει ένα έγκυρο αντικείμενο ρυθμίσεων.

Πώς συνδυάζονται οι πηγές

Κάθε πηγή φορτώνεται και συγχωνεύεται, ξεκινώντας από τη χαμηλότερη προτεραιότητα:

  1. Ενσωματωμένες προεπιλογές
  2. Ρυθμίσεις αποθηκευμένες μέσω του UI διαχείρισης (η επιλογή blockstudio_settings)
  3. blockstudio.json στο θέμα
  4. Φίλτρα blockstudio/settings/*

Το blockstudio.json υπερισχύει μόνο για τα κλειδιά που δηλώνει. Παλαιότερα αντικαθιστούσε πλήρως τις αποθηκευμένες ρυθμίσεις, οπότε μια άσχετη τιμή που είχε αποθηκευτεί από τη διαχείριση έπαυε να εφαρμόζεται μόλις εμφανιζόταν το αρχείο· τώρα προστίθεται πάνω από αυτές. Από την άλλη, μια παλιά τιμή που έχει αποθηκευτεί μέσω του UI διαχείρισης εξακολουθεί να εφαρμόζεται μέχρι το αρχείο να δηλώσει το συγκεκριμένο κλειδί ή να αφαιρεθεί η αποθηκευμένη τιμή. Αν μια ρύθμιση συμπεριφέρεται διαφορετικά από ό,τι ορίζει το αρχείο, ελέγξτε το αποθηκευμένο επίπεδο με το wp bs settings ή το Settings::get_raw(), το οποίο επιστρέφει μόνο όσα δήλωσε ρητά η ενεργή πηγή JSON ή επιλογών.

Ανάγνωση ρυθμίσεων από το PHP

Το Blockstudio\Settings φορτώνει την ενεργή πηγή, αναφέρει κακοσχηματισμένο JSON και επαναφορτώνεται αυτόματα όταν αλλάζει το blockstudio.json:

PHP
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(). Υποστηρίζει διαδρομές με κάθετες ή τελείες:

PHP
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 φιλτράρει τον επιλυμένο βασικό κατάλογο:

PHP
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. Η λειτουργία υπογραφής χρησιμοποιεί μια ελαφριά ταυτότητα που ενεργοποιείται στα συνήθη αιτήματα. Η λειτουργία γραφήματος προορίζεται για ρητές δημιουργίες: καταγράφει τις εξαρτήσεις πηγής ανά σελίδα, ώστε η αλλαγή μίας σελίδας να μην ακυρώνει άσχετα έγγραφα. Δείτε τη Στατική προαπόδοση για λεπτομέρειες σχετικά με την προθέρμανση, την ανάπτυξη, την πρόωρη εξυπηρέτηση και την ασφάλεια.

Οι μετρήσεις είναι διαθέσιμες μέσω προγραμματισμού:

PHP
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/*.

JSON
{
  "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

JSON
{
  "blockEditor": {
    "blocks": {
      "styles": {
        "deny": {
          "my-theme/card": ["outline"],
          "my-theme/media": ["framed"]
        }
      }
    }
  }
}

blockEditor.patterns

Χρησιμοποιήστε το blockEditor.patterns για να απενεργοποιήσετε τις καθολικές πηγές μοτίβων και να φιλτράρετε τις κατηγορίες μοτίβων.

JSON
{
  "blockEditor": {
    "patterns": {
      "core": false,
      "remote": false,
      "theme": true,
      "blockstudio": true,
      "categories": {
        "deny": ["gallery"],
        "rename": {
          "featured": "Featured Layouts"
        },
        "order": ["featured", "buttons"]
      }
    }
  }
}

blockEditor.media

Χρησιμοποιήστε το blockEditor.media για την πολιτική καθολικής εισαγωγής πολυμέσων.

JSON
{
  "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 για το ευρετήριο τεκμηρίωσης και το πλήρες παραγόμενο κείμενο.

Στοιχεία UI

Ενεργοποιήστε και συνθέστε τα ενσωματωμένα headless στοιχεία UI που εισήχθησαν στην έκδοση Blockstudio 7.3.