Composer
Το Blockstudio είναι διαθέσιμο στο Packagist. Υπάρχουν διάφοροι τρόποι εγκατάστασής του μέσω του Composer, ανάλογα με τη διαμόρφωση του έργου σας.
Ως πρόσθετο
Χρησιμοποιήστε το composer/installers για να εγκαταστήσετε το Blockstudio απευθείας στον κατάλογο wp-content/plugins/ σας. Αυτή είναι η συνήθης προσέγγιση για έργα WordPress που διαχειρίζονται με Composer, όπως το Bedrock.
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Ενεργοποιήστε το Blockstudio μέσω της διαχείρισης WordPress ή με το WP-CLI:
wp plugin activate blockstudio
Ο autoloader του Composer του έργου σας πρέπει να φορτωθεί από την εφαρμογή WordPress, ώστε το Composer να μπορεί να καταχωρίσει το Blockstudio. Στο Bedrock αυτό γίνεται αυτόματα. Σε άλλες διαμορφώσεις, χρησιμοποιήστε ένα πρόσθετο υποχρεωτικής χρήσης:
<?php
require_once dirname( __DIR__, 2 ) . '/vendor/autoload.php';
Όταν το Blockstudio συμπεριλαμβάνεται μέσω του autoloader του Composer πριν αρχίσει το WordPress να φορτώνει πρόσθετα, το bootstrap του Composer αναβάλλει την αρχικοποίηση μέχρι να είναι διαθέσιμο το περιβάλλον φόρτωσης προσθέτων. Έτσι, το Bedrock και άλλες διαμορφώσεις Composer σε επίπεδο ιστότοπου μπορούν να συμπεριλάβουν νωρίς το πακέτο χωρίς να εκκινήσουν το Blockstudio πριν είναι έτοιμα τα API προσθέτων του WordPress.
Ως πρόσθετο υποχρεωτικής χρήσης
Εγκαταστήστε το Blockstudio στο mu-plugins/, ώστε να φορτώνεται αυτόματα χωρίς ενεργοποίηση. Παρακάμψτε τη διαδρομή εγκατάστασης για να ορίσετε τον κατάλογο mu-plugins:
{
"require": {
"composer/installers": "^2.0",
"blockstudio/blockstudio": "^7.0"
},
"extra": {
"installer-paths": {
"wp-content/mu-plugins/{$name}/": ["type:wordpress-plugin"]
}
}
}
Το WordPress φορτώνει αυτόματα μόνο αρχεία PHP στη ρίζα του mu-plugins/, όχι σε υποκαταλόγους. Προσθέστε ένα αρχείο φόρτωσης:
<?php
require_once WPMU_PLUGIN_DIR . '/blockstudio/blockstudio.php';
Δεν απαιτείται ενεργοποίηση. Το Blockstudio φορτώνεται αυτόματα σε κάθε αίτημα.
Ενσωμάτωση σε θέμα
Εγκαταστήστε το Blockstudio ως εξάρτηση μέσα στο θέμα σας. Έτσι, όλα παραμένουν αυτοτελή χωρίς να απαιτείται ξεχωριστό πρόσθετο.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Φορτώστε το στο functions.php του θέματος:
<?php
require_once __DIR__ . '/vendor/autoload.php';
Το Blockstudio εκκινείται αυτόματα μέσω του autoloader του Composer όταν φορτώνεται από το WordPress. Τα URL των στοιχείων ενεργητικού δείχνουν στον σωστό κατάλογο θέματος. Τα μπλοκ που ορίζονται στον φάκελο blockstudio/ του θέματος λειτουργούν ακριβώς όπως σε εγκατάσταση προσθέτου. Αυτό λειτουργεί και όταν ο δημόσιος κατάλογος θέματος είναι συμβολικός σύνδεσμος: το Blockstudio αντιστοιχίζει τη φυσική διαδρομή του πακέτου μέσω του URL του ενεργού ή γονικού θέματος, αντί να εκθέτει τη διαδρομή του διακομιστή.
Ενσωμάτωση σε πρόσθετο
Εγκαταστήστε το Blockstudio ως εξάρτηση μέσα σε ένα άλλο πρόσθετο. Ισχύει η ίδια διαδικασία αρχικοποίησης του autoloader.
{
"require": {
"blockstudio/blockstudio": "^7.0"
}
}
Φορτώστε το στο κύριο αρχείο του προσθέτου σας:
<?php
/*
Plugin Name: My Plugin
*/
require_once __DIR__ . '/vendor/autoload.php';
Τα URL των στοιχείων ενεργητικού δείχνουν στον σωστό κατάλογο προμηθευτή του προσθέτου.
Έλεγχοι υποστηριζόμενων λειτουργιών φόρτωσης
Το Blockstudio επαληθεύει συνεχώς το ίδιο πακέτο σε τέσσερις υποστηριζόμενες θέσεις εκτέλεσης:
| Λειτουργία | Bootstrap |
|---|---|
| Πρόσθετο WordPress | Το WordPress ενεργοποιεί το blockstudio.php |
| Πρόσθετο υποχρεωτικής χρήσης | Ένας φορτωτής ρίζας απαιτεί το σημείο εισόδου του πακέτου |
| Εξάρτηση Composer σε θέμα | Το θέμα απαιτεί το autoloader του Composer |
| Εξάρτηση Composer σε πρόσθετο | Το πρόσθετο υποδοχής απαιτεί το autoloader του Composer |
Κάθε λειτουργία εκκινεί το WordPress με το ίδιο αποτέλεσμα: ένα στιγμιότυπο Blockstudio με ορισμένο το BLOCKSTUDIO_VERSION και χωρίς δεύτερη αφαίρεση επιπέδου υποδοχής από κάτω.
Προσαρμοσμένο πακέτο URL
Οι εγκαταστάσεις ως κανονικό πρόσθετο, πρόσθετο υποχρεωτικής χρήσης, ενσωματωμένο πρόσθετο, ενεργό θέμα, γονικό θέμα και θέμα μέσω συμβολικού συνδέσμου επιλύονται αυτόματα. Για προσαρμοσμένη ανάπτυξη όπου το πακέτο εκτίθεται μέσω άλλου δημόσιου URL, ορίστε το BLOCKSTUDIO_URL πριν το Composer φορτώσει το Blockstudio. Συμπεριλάβετε την κάθετο στο τέλος:
<?php
define(
'BLOCKSTUDIO_URL',
get_stylesheet_directory_uri() . '/packages/blockstudio/'
);
require_once __DIR__ . '/vendor/autoload.php';
Μπορείτε, εναλλακτικά, να καταχωρίσετε το blockstudio/url πριν φορτώσετε τον autoloader του Composer:
<?php
add_filter(
'blockstudio/url',
function (string $url, string $directory): string {
return get_stylesheet_directory_uri() . '/vendor/blockstudio/blockstudio/';
},
10,
2
);
require_once __DIR__ . '/vendor/autoload.php';
Το φίλτρο λαμβάνει το επιλυμένο URL και τον φυσικό κατάλογο του πακέτου.
Εξαρτήσεις
Οι εξαρτήσεις εκτέλεσης του Blockstudio (TailwindPHP, ScssPhp, Minify) περιλαμβάνονται και έχουν χώρο ονομάτων μέσα στο πρόσθετο. Η μόνη εξάρτηση Composer που εγκαθίσταται στον κατάλογο vendor/ σας είναι το yahnis-elsts/plugin-update-checker, το οποίο χειρίζεται εσωτερικά την επίλυση διενέξεων εκδόσεων.
composer.json requires:
php >= 8.2
yahnis-elsts/plugin-update-checker ^5.6
Ενημερώσεις
Οι εγκαταστάσεις Composer λαμβάνουν ενημερώσεις μέσω του Composer. Το ενσωματωμένο πρόγραμμα ενημέρωσης GitHub απενεργοποιείται αυτόματα όταν το Blockstudio φορτώνεται από κατάλογο vendor/.