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

Πηγές λογικού εντοπισμού

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

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

Πηγές αποθέματος

Χρησιμοποιήστε το φίλτρο blockstudio/discovery/sources για να αντικαταστήσετε τα προεπιλεγμένα αντικείμενα Filesystem_Discovery_Source:

PHP
use Blockstudio\Inventory_Discovery_Source;

add_filter(
    'blockstudio/discovery/sources',
    function (array $sources, string $context, array $paths): array {
        if ('blocks' !== $context) {
            return $sources;
        }

        return [
            new Inventory_Discovery_Source(
                'preview:feature-card',
                '/runtime-preview/feature-card/blockstudio',
                [
                    'card/block.json' => [
                        'path' => '/theme/blockstudio/card/block.json',
                        'provenance' => [
                            'layer' => 'parent',
                            'inherited' => true,
                        ],
                    ],
                    'card/index.php' => [
                        'path' => '/runtime-preview/feature-card/blockstudio/card/index.php',
                        'provenance' => [
                            'layer' => 'preview',
                        ],
                    ],
                ],
                'parent-and-preview-fingerprint',
                ['/theme/blockstudio', '/runtime-preview/feature-card/blockstudio']
            ),
        ];
    },
    10,
    3
);

Τα διαθέσιμα περιβάλλοντα είναι:

  • blocks
  • fields
  • pages
  • patterns
  • site-templates
  • site-template-parts

Ένα απόθεμα είναι το τελικό ορατό δέντρο. Συνθέστε τα επίπεδα πριν το επιστρέψετε:

  • Χρησιμοποιήστε μία εγγραφή για κάθε ορατή λογική διαδρομή.
  • Αφήστε το επιλεγμένο επίπεδο να παρέχει τη φυσική διαδρομή.
  • Παραλείψτε τις διαγραμμένες λογικές διαδρομές.
  • Επιστρέψτε τις εγγραφές με οποιαδήποτε σειρά. Το Blockstudio τις ταξινομεί κατά λογική διαδρομή.
  • Συμπεριλάβετε τους κενούς λογικούς καταλόγους στο προαιρετικό έκτο όρισμα του κατασκευαστή, όταν έχει σημασία η ορατότητα των καταλόγων.

Το Inventory_Discovery_Source είναι πρακτικό για αποθέματα που βασίζονται σε πίνακες. Οι ενσωματώσεις μπορούν να υλοποιήσουν τη διεπαφή Discovery_Source όταν οι εγγραφές επιλύονται αργά ή προέρχονται από άλλο σύστημα αποθήκευσης.

Επίλυση γειτονικών στοιχείων

Τα λογικά γειτονικά στοιχεία μπορούν να επιλύονται σε διαφορετικές φυσικές ρίζες. Ένα γονικό block.json μπορεί να χρησιμοποιεί επικάλυψη index.php, ενώ μια σελίδα επικάλυψης μπορεί να κληρονομεί το pages.json, τον φορτωτή ή τη διάταξη του γονέα της. Το Blockstudio επιλύει αυτές τις σχέσεις με βάση τη λογική διαδρομή πριν διαβάσει τα επιλεγμένα φυσικά αρχεία.

Οι διαδρομές φορτωτών εκτός μιας συλλογής εξακολουθούν να υπόκεινται στα υπάρχοντα όρια ασφαλείας blockstudio/pages/allow_external_loader_path.

Ταυτότητα και ακύρωση

Κάθε πηγή παρέχει:

  • Ένα σταθερό αναγνωριστικό πηγής για το επιλεγμένο περιβάλλον εκτέλεσης.
  • Ένα αποτύπωμα που αλλάζει μαζί με το ορατό απόθεμα.
  • Φυσικές εισόδους παρακολούθησης για ζωντανή επαναφόρτωση και επικύρωση κρυφής μνήμης.
  • Προέλευση και μεταδεδομένα για κάθε εγγραφή.

Το Blockstudio περιλαμβάνει αναγνωριστικά πηγής και αποτυπώματα στις ταυτότητες της κρυφής μνήμης εκτέλεσης, του μανιφέστου σελίδων, των προτύπων Επεξεργαστή ιστοτόπου και Καμβά, καθώς και του Tailwind.

Χρησιμοποιήστε το blockstudio/cache/context όταν η ίδια επιλογή πηγής μπορεί να αποδοθεί σε πολλές παραλλαγές περιβάλλοντος εκτέλεσης:

PHP
add_filter(
    'blockstudio/cache/context',
    fn ($context, string $scope) => [
        'preview' => 'feature-card',
        'site' => get_current_blog_id(),
    ],
    10,
    2
);

Η τιμή περιβάλλοντος πρέπει να μπορεί να σειριοποιηθεί και να παραμένει σταθερή για ισοδύναμα αιτήματα. Το Tailwind διατηρεί την τελευταία καλή έκδοση του CSS σε χώρο ονομάτων συγκεκριμένο για το περιβάλλον, ώστε μια προεπισκόπηση να μην μπορεί να λάβει την εφεδρική τιμή CSS κάποιας άλλης.

Παραγόμενα στοιχεία ενεργητικού

Επισημάνετε τις κληρονομημένες εγγραφές ή τις εγγραφές μόνο για ανάγνωση με inherited: true, readOnly: true ή writable: false στην προέλευση ή στα μεταδεδομένα. Έπειτα, το Blockstudio γράφει τα μεταγλωττισμένα στοιχεία ενεργητικού σε πεδίο εφαρμογής generated, συγκεκριμένο για το περιβάλλον, κάτω από τη διαμορφωμένη ρίζα προσωρινής μνήμης Blockstudio, αντί δίπλα στην πηγή γονέα. Έτσι, τα παραγόμενα στοιχεία ενεργητικού, η έξοδος Tailwind, τα έγγραφα απόδοσης και οι στατικές προαποδόσεις μοιράζονται το ίδιο όριο εγγράψιμου κεντρικού συστήματος.

Δύο φίλτρα καλύπτουν την προσαρμοσμένη δρομολόγηση εκτέλεσης:

PHP
add_filter(
    'blockstudio/generated_output/path',
    function (string $path, string $source, string $scope, array $metadata) {
        return $path;
    },
    10,
    4
);

add_filter(
    'blockstudio/files/url',
    function (string $url, string $path, string $scope) {
        return $url;
    },
    10,
    3
);

Χρησιμοποιήστε το φίλτρο URL όταν τα επιλεγμένα αρχεία βρίσκονται έξω από το wp-content ή εξυπηρετούνται μέσω τελικού σημείου εκτέλεσης.