Πολυμέσα
Οι εικόνες του θέματος βρίσκονται έξω από τη βιβλιοθήκη πολυμέσων, επομένως το WordPress δεν γνωρίζει τις διαστάσεις τους και κάθε εικόνα χωρίς στυλ μετακινεί τη διάταξη καθώς φορτώνεται. Το Blockstudio καλύπτει αυτό το κενό με ένα παραγόμενο manifest μεταδεδομένων, ένα βοηθητικό πρότυπο που εκπέμπει πάντα πραγματικές διαστάσεις και έναν προαιρετικό lazy loader.
Απόδοση εικόνων
Το bs_media_image() αποδίδει τα assets του θέματος με πραγματικό πλάτος, ύψος και δεσμευμένο λόγο διαστάσεων:
<?php
echo bs_media_image([
'src' => 'assets/images/hero.webp',
'alt' => 'Hero',
'class' => 'hero-media',
'sources' => [
['srcset' => '/hero-small.webp', 'media' => '(max-width: 640px)'],
],
]);
?>
Η έξοδος είναι ένα figure.blockstudio-media με inline aspect-ratio γύρω από ένα img που φέρει πραγματικές τιμές width, height, loading και decoding.
Το src δέχεται διαδρομή σχετική με το θέμα, απόλυτη διαδρομή ή πλήρες URL, ενώ το attachmentId καλύπτει εικόνες της βιβλιοθήκης πολυμέσων. Το eager εξαιρείται από την lazy φόρτωση πάνω από το σημείο αναδίπλωσης, ενώ το sources εκπέμπει ένα στοιχείο <picture> με τα καθορισμένα εναλλακτικά στοιχεία.
Το βοηθητικό στοιχείο εκπέμπει πάντα γνωστές τιμές πλάτους, ύψους και λόγου διαστάσεων όταν υπάρχουν μεταδεδομένα. Η λειτουργία lazy χρησιμοποιεί μόνο κλάσεις, attributes, handles και globals του blockstudio-*.
Το manifest μεταδεδομένων
Οι διαστάσεις προέρχονται από το assets/media.json, το οποίο γράφεται από το Blockstudio\Media_Metadata_Builder σε βήμα κατασκευής ή χειροκίνητα:
use Blockstudio\Media_Metadata_Builder;
(new Media_Metadata_Builder())->write(
get_stylesheet_directory(),
true
);
Αυτό γράφει ντετερμινιστικά μεταδεδομένα για τα assets του θέματος και, με το δεύτερο όρισμα, προαιρετικά συνημμένα WordPress. Αναδημιουργήστε το κάθε φορά που αλλάζουν αρχεία στο assets/.
Το Media_Metadata_Builder::build( string $root ) επιστρέφει το manifest χωρίς να το γράψει· το write() είναι η παραλλαγή που το αποθηκεύει. Το Blockstudio\Media_Metadata::reset() εκκαθαρίζει την cache εντός της διεργασίας μετά από ανακατασκευή, κάτι που χρειάζονται οι μακρόβιες διεργασίες build πριν αποδώσουν με τα νέα μεταδεδομένα.
Lazy φόρτωση
Οι ρυθμίσεις performance.media ελέγχουν τον loader του frontend:
{
"performance": {
"media": {
"lazy": true,
"skeleton": true,
"metadata": true,
"rootMargin": "300px"
}
}
}
Όταν είναι ενεργό το lazy, το πραγματικό URL μεταφέρεται στο data-src, πίσω από ένα placeholder με σωστό μέγεθος, και ο loader του Blockstudio, που βασίζεται στην τομή, το αντικαθιστά καθώς η εικόνα πλησιάζει το viewport και το rootMargin εκ των προτέρων. Το skeleton εμφανίζει το ενσωματωμένο placeholder φόρτωσης, ενώ το metadata δηλώνει ότι χρησιμοποιείται το assets/media.json.
Τα speed και strict προφίλ απόδοσης ενεργοποιούν τον loader από προεπιλογή· το compat τον αφήνει απενεργοποιημένο. Κάθε θυγατρική τιμή μπορεί να παρακάμψει την προεπιλογή του προφίλ της.
Ο πλήρης πίνακας επιλογών
performance.media.
Τα μεταδεδομένα πολυμέσων είναι το δεύτερο βήμα στη σειρά υιοθέτησης για παραγωγή.