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

Blade

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

Ρύθμιση

Για να χρησιμοποιήσετε πρότυπα Blade με το Blockstudio, εγκαταστήστε το πακέτο illuminate/view του Laravel με το Composer. Λειτουργούν οι εκδόσεις 8 έως 12.

Κέλυφος
composer require illuminate/view

Στη συνέχεια, προσθέστε ένα φίλτρο στο αρχείο functions.php του theme σας για να υποδείξετε στο Blockstudio πώς να αποδίδει πρότυπα Blade. Το Blockstudio συλλέγει αυτόματα όλα τα πρότυπα Blade και αντιστοιχίζει τις διαδρομές τους, επιτρέποντάς σας να χρησιμοποιείτε τη σύνταξη με τελεία του Blade για includes και layouts. Το Blockstudio\Blade_Renderer δημιουργεί το view factory από το illuminate/view και αποθηκεύει τα μεταγλωττισμένα views στον προσωρινό κατάλογο του συστήματος.

PHP
add_filter(
    "blockstudio/blocks/render",
    function ($value, $block) {
        $blockPath = $block->path;
        if (str_ends_with($blockPath, ".blade.php")) {
            if (!Blockstudio\Blade_Renderer::available()) {
                return 'Error: Blade is not installed. Please run "composer require illuminate/view".';
            }
            $data = $block->blockstudio["data"];
            $bladeData = $data["blade"];

            return Blockstudio\Blade_Renderer::render(
                $bladeData["path"],
                $bladeData["templates"][$block->name],
                [
                    "a" => $data["attributes"],
                    "attributes" => $data["attributes"],
                    "b" => $data["block"],
                    "block" => $data["block"],
                    "c" => $data["context"],
                    "context" => $data["context"],
                ]
            );
        }

        return $value;
    },
    10,
    2
);

Το wrapper jenssegers/blade που χρησιμοποιούσαν παλαιότερες εκδόσεις αυτής της σελίδας αποτυγχάνει με το illuminate/view 10 και μεταγενέστερες εκδόσεις (“Target class [blade.compiler] does not exist”). Αν είναι εγκατεστημένο, το Blade_Renderer χρησιμοποιεί το πακέτο illuminate/view που περιλαμβανόταν σε αυτό.

Μεταβλητές προτύπων

Τα πρότυπα Blade σας θα έχουν πρόσβαση στις εξής μεταβλητές:

Μεταβλητή Περιγραφή
$a Ψευδώνυμο του $attributes
$attributes Τα attributes του block
$b Ψευδώνυμο του $block
$block Δεδομένα σχετικά με το ίδιο το block
$c Ψευδώνυμο του $context
$context Το πλαίσιο του block (e.g., ID ανάρτησης, τύπος ανάρτησης μέσα σε βρόχο)

Χρήση

Για να χρησιμοποιήσετε το Blade για το πρότυπο του block σας, δημιουργήστε ένα αρχείο index.blade.php στον κατάλογο του block. Στη συνέχεια, το Blockstudio θα χρησιμοποιεί αυτόματα αυτό το αρχείο για την απόδοση του block.

PHP
<div class="my-block">
  @if($a['title'])
    <h2>{{ $a['title'] }}</h2>
  @endif

  @if($a['content'])
    <p>{{ $a['content'] }}</p>
  @endif
</div>