Εξατομικευμένα αποσπάσματα σε αποθηκευμένες σελίδες
Μια σελίδα που προβάλλεται από στατική κρυφή μνήμη είναι ίδια για όλους. Αυτός είναι ο σκοπός της αποθήκευσής της στην κρυφή μνήμη, αλλά και το πρόβλημα: η κεφαλίδα θέλει να πει «Γεια σου, Ada» σε έναν συνδεδεμένο πελάτη και το εικονίδιο του καλαθιού θέλει να εμφανίσει τρία προϊόντα. Αν το πρότυπο εμφανίζει διαφορετικό περιεχόμενο ανάλογα με τον τρέχοντα χρήστη, η κρυφή μνήμη είτε αποθηκεύει τον χαιρετισμό ενός επισκέπτη για όλους είτε αναγκάζεται να παραλείψει εντελώς τη σελίδα.
Οι δυναμικές νησίδες του Blockstudio διαχωρίζουν αυτές τις δύο ανάγκες. Το αποθηκευμένο στην κρυφή μνήμη HTML περιέχει ένα ασφαλές για την κρυφή μνήμη σύμβολο κράτησης θέσης. Αφού φορτωθεί η σελίδα, ένα μικρό περιβάλλον εκτέλεσης ζητά από το WordPress το προσωπικό απόσπασμα με το αίτημα του ίδιου του επισκέπτη και το τοποθετεί στη θέση του. Η σελίδα παραμένει κατάλληλη για αποθήκευση στην κρυφή μνήμη και μόνο το απόσπασμα είναι δυναμικό.
Αυτός ο οδηγός δημιουργεί δύο νησίδες, έναν χαιρετισμό και το πλήθος προϊόντων στο καλάθι, και παρουσιάζει το περιεχόμενο της αποθηκευμένης σελίδας, τη μορφή του αιτήματος αποσπάσματος και τον τρόπο με τον οποίο το endpoint αναγνωρίζει τον επισκέπτη. Συμπληρώνει τον οδηγό Προβολή του WordPress ως στατικό HTML.
Πώς λειτουργεί μια δυναμική νησίδα
- Το μπλοκ αποδίδει το σύμβολο κράτησης θέσης μέσα σε ένα στοιχείο δείκτη. Ο δείκτης περιλαμβάνει το όνομα του μπλοκ, τα επιτρεπόμενα χαρακτηριστικά και μια υπογραφή που δημιουργείται στον διακομιστή.
- Επειδή η αποδιδόμενη σελίδα περιέχει δείκτη, το Blockstudio εισάγει το περιβάλλον εκτέλεσης νησίδων. Οι σελίδες χωρίς νησίδες δεν περιλαμβάνουν κώδικα νησίδων JavaScript.
- Το περιβάλλον εκτέλεσης συλλέγει τους έτοιμους δείκτες και στέλνει ένα ομαδοποιημένο
POSTστο/wp-json/blockstudio/v1/island/render. - Το endpoint επαληθεύει κάθε υπογραφή, αποδίδει το μπλοκ στο πλαίσιο αιτήματος του επισκέπτη και επιστρέφει τα αποσπάσματα.
- Το περιβάλλον εκτέλεσης αντικαθιστά κάθε σύμβολο κράτησης θέσης και αποστέλλει συμβάντα.
Στον επεξεργαστή μπλοκ, το μπλοκ αποδίδεται κανονικά, χωρίς σύμβολο κράτησης θέσης.
Βήμα 1: Το μπλοκ χαιρετισμού
Δημιουργήστε το μπλοκ με τρία αρχεία:
blocks/
└── greeting/
├── block.json
├── placeholder.php
└── index.php
{
"apiVersion": 3,
"name": "acme/greeting",
"title": "Greeting",
"category": "widgets",
"icon": "admin-users",
"description": "Account link that greets signed-in visitors.",
"blockstudio": {
"island": {
"mode": "dynamic",
"tag": "span",
"attributes": ["guestLabel"],
"cache": {
"ttl": 300,
"per": "user"
}
},
"attributes": [
{ "id": "guestLabel", "type": "text", "label": "Guest label", "default": "Sign in" }
]
}
}
Το mode: "dynamic" είναι αυτό που κάνει τη νησίδα να υποβάλλει αίτημα αποσπάσματος.
Το tag ορίζει το στοιχείο δείκτη, ώστε η νησίδα να μπορεί να εμφανίζεται ενσωματωμένα σε μια γραμμή πλοήγησης. Το attributes είναι η λίστα επιτρεπόμενων χαρακτηριστικών μπλοκ που αποστέλλονται μαζί με το αίτημα αποσπάσματος· οτιδήποτε δεν περιλαμβάνεται δεν αποστέλλεται ούτε υπογράφεται. Το cache εξηγείται παρακάτω.
Το περιεχόμενο της αποθηκευμένης σελίδας είναι το σύμβολο κράτησης θέσης. Πρέπει να είναι ασφαλές για όλους τους επισκέπτες και επομένως δεν περιέχει δεδομένα χρήστη. Ένας σύνδεσμος «Λογαριασμός» λειτουργεί για όλους:
<a href="<?php echo esc_url( home_url( '/account/' ) ); ?>">Account</a>
Το κύριο πρότυπο αποδίδει το πραγματικό απόσπασμα:
<?php
$user = wp_get_current_user();
?>
<?php if ( $user->exists() ) : ?>
<a href="<?php echo esc_url( home_url( '/account/' ) ); ?>">
<?php echo esc_html( sprintf( 'Hi, %s', $user->display_name ) ); ?>
</a>
<?php else : ?>
<a href="<?php echo esc_url( wp_login_url() ); ?>">
<?php echo esc_html( $a['guestLabel'] ); ?>
</a>
<?php endif; ?>
Εδώ μπορείτε να ελέγχετε τον τρέχοντα χρήστη, καθώς αυτό το πρότυπο εκτελείται μόνο για το αίτημα αποσπάσματος και ποτέ για την αποθηκευμένη σελίδα.
Τοποθετήστε το όπου αποδίδεται η κεφαλίδα:
<?php echo bs_block( array( 'name' => 'acme/greeting' ) ); ?>
Λειτουργούν και οι ετικέτες μπλοκ: <bs:acme-greeting /> ή
<block name="acme/greeting" />.
Βήμα 2: Περιεχόμενο της αποθηκευμένης σελίδας
Όταν το μπλοκ αποδίδεται στον διακομιστή, παράγει μόνο τον δείκτη και το σύμβολο κράτησης θέσης:
<span data-bs-island="acme/greeting" data-bs-island-mode="dynamic" data-bs-island-phase="placeholder" data-bs-island-props="{"guestLabel":"Sign in"}" data-bs-island-signature="a7311ba9f6abf3c993edfdd7d49d2fa23bfa068f715b96637c35ef30de8b2043" data-bs-island-loading="eager"><!--blockstudio/acme/greeting--><a href="https://example.com/account/">Account</a>
</span>
Αποδώστε το μία φορά ως ανώνυμος επισκέπτης και μία ως συνδεδεμένος χρήστης· τα δύο κείμενα είναι πανομοιότυπα, μέχρι και το byte. Αυτή ακριβώς είναι η ιδιότητα που απαιτεί μια στατική προαπόδοση με ενεργοποιημένο το serveLoggedIn: όποιος κι αν ξεκινήσει την απόδοση, το αποθηκευμένο έγγραφο είναι ίδιο και δεν μπορεί να περιέχει προσωπικά δεδομένα.
Βήμα 3: Το αίτημα αποσπάσματος
Το περιβάλλον εκτέλεσης υποβάλλει όλες τις έτοιμες νησίδες με ένα αίτημα:
{
"islands": [
{
"clientId": "a1",
"name": "acme/greeting",
"attributes": {
"guestLabel": "Sign in"
},
"signature": "a7311ba9f6abf3c993edfdd7d49d2fa23bfa068f715b96637c35ef30de8b2043"
}
]
}
Η απόκριση αντιστοιχίζει τα αποτελέσματα με βάση το clientId. Για έναν συνδεδεμένο επισκέπτη:
{
"a1": "<!--blockstudio/acme/greeting--> <a href=\"https://example.com/account/\">\n Hi, Ada </a>\n"
}
Αν μια εγγραφή δεν περάσει την επαλήθευση, επιστρέφεται κωδικός σφάλματος αντί για HTML, χωρίς να αποτυγχάνει η υπόλοιπη ομαδική υποβολή. Εδώ, η δεύτερη εγγραφή άλλαξε το guestLabel χωρίς αντίστοιχη υπογραφή και η τρίτη όριζε ένα μπλοκ που δεν είναι δυναμική νησίδα:
{
"a1": "<!--blockstudio/acme/greeting--> <a href=\"https://example.com/wp-login.php\">\n Sign in </a>\n",
"a2": {
"error": "blockstudio_island_invalid_signature"
},
"a3": {
"error": "blockstudio_island_not_allowed"
}
}
Κάθε απόκριση περιλαμβάνει τα Cache-Control: no-store, no-cache, must-revalidate, max-age=0,
Pragma: no-cache και X-Robots-Tag: noindex. Το endpoint βρίσκεται κάτω από το
/wp-json, το οποίο παρακάμπτει πάντα τη στατική προαπόδοση, ώστε ούτε η κρυφή μνήμη της προέλευσης ούτε ένα CDN που τηρεί τις κεφαλίδες της προέλευσης να αποθηκεύει κάποιο απόσπασμα.
Ποιος είναι ο επισκέπτης
Το περιβάλλον εκτέλεσης στέλνει το αίτημα με credentials: 'same-origin', ώστε το πρόγραμμα περιήγησης να συμπεριλάβει το cookie σύνδεσης WordPress. Το WordPress REST API συνήθως αγνοεί την πιστοποίηση μέσω cookie χωρίς nonce, ενώ ένα nonce δεν μπορεί να βρίσκεται σε αποθηκευμένη σελίδα. Το endpoint νησίδων το χειρίζεται αυτόνομα: για αίτημα προγράμματος περιήγησης ίδιας προέλευσης, επικυρώνει το cookie logged_in και επαναφέρει τον συγκεκριμένο χρήστη πριν από την απόδοση.
Η ίδια προέλευση προσδιορίζεται από την κεφαλίδα Sec-Fetch-Site και, αν υπάρχει, από την κεφαλίδα Origin που συγκρίνεται με το home_url(). Ένα αίτημα από άλλη προέλευση που τυχαίνει να περιλαμβάνει το cookie αποδίδεται ως ανώνυμο, οπότε αίτημα από άλλον ιστότοπο δεν αποδίδει ποτέ το προσωπικό απόσπασμα ενός επισκέπτη. Στην πράξη:
| Αίτημα | Αποδίδεται ως |
|---|---|
| Λήψη ίδιας προέλευσης με έγκυρο cookie σύνδεσης | συνδεδεμένος χρήστης |
| Αίτημα διασταυρούμενης προέλευσης με το ίδιο cookie | ανώνυμος |
| Χωρίς cookie | ανώνυμος |
Ποια σελίδα είναι αυτή;
Προσθέστε "context": true στο blockstudio.island όταν το τμήμα χρειάζεται την ταυτότητα της σελίδας του. Ο δείκτης υπογράφει τότε το αναγνωριστικό ανάρτησης και τον τύπο ανάρτησης της σελίδας του ερωτήματος μαζί με τα χαρακτηριστικά. Μέσα στο τμήμα, τα $block['postId'], $block['postType'], get_the_ID() και get_queried_object_id() αναφέρονται σε αυτήν τη σελίδα. Μέσα σε έναν βρόχο ερωτήματος, αυτό εξακολουθεί να σημαίνει την εξωτερική σελίδα του ερωτήματος και όχι το στοιχείο του βρόχου.
Το περιεχόμενο σελίδας είναι προαιρετικό και αποτελεί επίσης μέρος του κλειδιού της προσωρινής μνήμης αποσπασμάτων. Το endpoint ελέγχει ξανά την πρόσβαση, ακόμη και για αποσπάσματα που βρίσκονται στην προσωρινή μνήμη, ώστε ένας υπογεγραμμένος δείκτης να μην αποκαλύπτει μια σελίδα που έκτοτε έγινε ιδιωτική ή προστατεύτηκε με κωδικό πρόσβασης. Δείτε την ενότητα Πλαίσιο σελίδας για τις λεπτομέρειες διαμόρφωσης και ασφάλειας. Δεν επαναλαμβάνονται αυθαίρετα URL ή παράμετροι ερωτήματος.
Βήμα 4: Πλήθος προϊόντων στο καλάθι που ανανεώνεται αυτόματα
Η δεύτερη νησίδα παρουσιάζει ένα άλλο στυλ συμβόλου κράτησης θέσης και δύο επιλογές περιβάλλοντος εκτέλεσης. Αντί για ξεχωριστό αρχείο συμβόλου κράτησης θέσης, το πρότυπο ελέγχει το $isIslandPlaceholder:
{
"apiVersion": 3,
"name": "acme/cart-count",
"title": "Cart Count",
"category": "widgets",
"icon": "cart",
"description": "Number of items in the visitor's cart.",
"blockstudio": {
"island": {
"mode": "dynamic",
"loading": "visible",
"event": "acme:cart-updated"
},
"attributes": []
}
}
<?php
$count = (int) apply_filters( 'acme/cart_count', 0 );
?>
<?php if ( $isIslandPlaceholder ) : ?>
<a href="/cart/" class="cart-count">Cart</a>
<?php else : ?>
<a href="/cart/" class="cart-count">
Cart <span class="cart-count__badge"><?php echo esc_html( (string) $count ); ?></span>
</a>
<?php endif; ?>
Οι ίδιες σημαίες υπάρχουν σε κάθε γλώσσα προτύπων: isIsland,
isIslandPlaceholder, isIslandFragment και islandPhase ("normal",
"hydrate", "placeholder" ή "fragment"). Εδώ, το πλήθος προέρχεται από ένα φίλτρο acme/cart_count που συμπληρώνει ο κώδικας εμπορίου σας. Αν επιστρέφει 3, το endpoint επιστρέφει:
{"c1":"<!--blockstudio/acme/cart-count--> <a href=\"/cart/\" class=\"cart-count\">\n Cart <span class=\"cart-count__badge\">3</span>\n </a>\n"}
Το loading: "visible" αναβάλλει το αίτημα μέχρι ο δείκτης να μπει στο ορατό τμήμα της σελίδας, χρησιμοποιώντας το IntersectionObserver. Οι ορατές νησίδες που εμφανίζονται ταυτόχρονα εξακολουθούν να ομαδοποιούνται σε ένα αίτημα. Το event ορίζει ένα συμβάν παραθύρου που ανακτά ξανά τη νησίδα, ώστε μετά από μια κλήση προσθήκης στο καλάθι το script σας να χρειάζεται μόνο να το ανακοινώσει:
window.dispatchEvent(new Event('acme:cart-updated'));
Αντίδραση σε κώδικα διεπαφής
Τα συμβάντα διαδίδονται από τον δείκτη, οπότε ένας ακροατής στο document καλύπτει κάθε νησίδα. Το event.detail.name περιέχει το όνομα του μπλοκ:
document.addEventListener('blockstudio:island:rendered', (event) => {
if (event.detail.name !== 'acme/cart-count') return;
event.target.querySelector('.cart-count__badge')?.classList.add('is-fresh');
});
document.addEventListener('blockstudio:island:error', (event) => {
console.warn('Island failed', event.detail.name, event.detail.error);
});
Μετά την αντικατάσταση, το περιβάλλον εκτέλεσης αποστέλλει το blockstudio:island:rendered και έπειτα το blockstudio:island:hydrate. Σε περίπτωση αποτυχίας, το σύμβολο κράτησης θέσης παραμένει στη θέση του και ενεργοποιείται το blockstudio:island:error. Οι ενυδατωμένες νησίδες ("island": "hydrate") παραλείπουν εντελώς το αίτημα: ολόκληρο το HTML τους βρίσκεται στη σελίδα και λαμβάνουν μόνο το συμβάν hydrate, κάτι που ταιριάζει σε διαδραστικά μπλοκ ασφαλή για την προσωρινή μνήμη, όπως οι καρτέλες.
Προσωρινή αποθήκευση τμημάτων
Από προεπιλογή, τα τμήματα αποδίδονται σε κάθε αίτημα. Ο παραπάνω χαιρετισμός επιλέγει σύντομη προσωρινή αποθήκευση:
{
"cache": {
"ttl": 300,
"per": "user"
}
}
Το per: "user" διαφοροποιεί το αποθηκευμένο τμήμα ανά WordPress ID χρήστη, ενώ τα ανώνυμα αιτήματα δεν αποθηκεύονται ποτέ με αυτό το κλειδί, ώστε δύο ανώνυμοι επισκέπτες να μην μοιράζονται μια καταχώριση που προορίζεται για χρήστη. Το per: "global" μοιράζεται ένα τμήμα για το ίδιο μπλοκ και τα ίδια χαρακτηριστικά, κάτι που ταιριάζει σε ζωντανό αλλά μη προσωπικό περιεχόμενο, όπως το επίπεδο αποθέματος. Το ttl έχει προεπιλογή τα 60 δευτερόλεπτα, ενώ το cache: true είναι καθολική προσωρινή μνήμη 60 δευτερολέπτων.
Το μοντέλο ασφάλειας
Το τελικό σημείο είναι δημόσιο, αλλά δεν αποτελεί γενικό αποδοτή μπλοκ. Αποδίδει μια καταχώριση μόνο όταν ισχύουν όλα τα εξής:
- το μπλοκ είναι καταχωρισμένο, δυναμικό και έχει ορισμένο το
island.modeσεdynamic - η υπογραφή αντιστοιχεί στο όνομα του μπλοκ και στα χαρακτηριστικά που περνούν από το φίλτρο: μόνο κλειδιά που υπάρχουν τόσο στο σχήμα του μπλοκ όσο και στη λίστα επιτρεπόμενων νησίδων
Η υπογραφή είναι HMAC-SHA256 πάνω στο κανονικοποιημένο όνομα του μπλοκ και στα χαρακτηριστικά, με κλειδί το αλάτι auth του ιστότοπου που το εξυπηρετεί. Οι υπογραφές δημιουργούνται κατά την απόδοση σε αυτόν τον ιστότοπο και δεν ενσωματώνονται ποτέ σε θέμα. Αυτό έχει δύο συνέπειες. Ένα έγγραφο που αποδόθηκε σε περιβάλλον σταδιοποίησης φέρει υπογραφές σταδιοποίησης, επομένως αποδώστε τα έγγραφα στον ιστότοπο που τα εξυπηρετεί. Και η αλλαγή των αλάτων WordPress ακυρώνει κάθε υπογραφή σε αποθηκευμένα έγγραφα, επομένως εκκαθαρίστε την στατική προαπόδοση μετά την αλλαγή αλατιού.
Ένα αίτημα δέχεται έως 50 νησίδες· για περισσότερες επιστρέφεται HTTP 413. Αλλάξτε το όριο με το blockstudio/islands/max_per_request. Υπάρχουν άγκιστρα υπογραφής (blockstudio/islands/signature_payload, blockstudio/islands/signature, blockstudio/islands/verify_signature) για οικοδεσπότες που χρειάζονται διαφορετικό σχήμα.
Πότε να μην χρησιμοποιείτε νησίδα
Τα τμήματα δεν περιλαμβάνονται στο αρχικό HTML, επομένως οι ανιχνευτές δεν τα βλέπουν. Διατηρήστε το περιεχόμενο που σχετίζεται με το SEO στην κανονική απόδοση. Χρησιμοποιήστε δυναμικές νησίδες για ό,τι μπορεί να εμφανιστεί μετά το περίβλημα της σελίδας: συνδέσμους λογαριασμού, κατάσταση καλαθιού, προτάσεις και στοιχεία ελέγχου με περιορισμό δικαιωμάτων. Όταν ολόκληρη η σελίδα είναι προσωπική, όπως ένας πίνακας ελέγχου λογαριασμού, προσθέστε τη διαδρομή της στο dynamicPaths και αποδώστε την ζωντανά.
Επόμενα βήματα
- Αναφορά νησίδων: κάθε επιλογή, σειρά αναζήτησης συμβόλων κράτησης θέσης, PHP API και άγκιστρα.
- Εξυπηρέτηση WordPress ως στατικό HTML: η προσωρινή μνήμη για την οποία έχουν σχεδιαστεί αυτές οι νησίδες.
- Αναφορά στατικής προαπόδοσης:
serveLoggedIn, δυναμικές διαδρομές και έγκαιρη εξυπηρέτηση. - Διαδραστικά στοιχεία: συμπεριφορά στην πλευρά του πελάτη για μπλοκ που χρειάζονται περισσότερα από ένα συμβάν τοποθέτησης.