Twig
Το Twig είναι μια ευέλικτη, γρήγορη και ασφαλής μηχανή προτύπων για το PHP. Επιτρέπει στους προγραμματιστές να γράφουν συνοπτικό και ευανάγνωστο κώδικα σε πρότυπα, ενισχύοντας την παραγωγικότητα και τη δυνατότητα συντήρησης. Το Twig υποστηρίζει πολλές λειτουργίες που κάνουν τη δημιουργία προτύπων ισχυρή και απλή, ιδανική για έργα που χρειάζονται ανθεκτικά, επαναχρησιμοποιήσιμα πρότυπα.
Ρύθμιση
Για να χρησιμοποιήσετε πρότυπα Twig με το Blockstudio, πρέπει να εγκαταστήσετε το πακέτο timber/timber (που περιλαμβάνει το Twig) με το Composer. Το Blockstudio θα εντοπίσει αυτόματα αν είναι εγκατεστημένο το Timber και θα ενεργοποιήσει τη δημιουργία προτύπων Twig για τα blocks σας.
composer require timber/timber
Μόλις εγκατασταθεί το Timber, το Blockstudio θα αναλαμβάνει αυτόματα την απόδοση των αρχείων index.twig που βρίσκονται στους φακέλους των block σας.
Μεταβλητές προτύπων
Όλα τα αρχεία Twig θα έχουν πρόσβαση στο πλαίσιο Timber, το οποίο περιλαμβάνει κοινά δεδομένα και συναρτήσεις WordPress, καθώς και μεταβλητές ειδικές για το Blockstudio:
| Μεταβλητή | Περιγραφή |
|---|---|
a |
Ψευδώνυμο του attributes |
attributes |
Τα attributes του block |
b |
Ψευδώνυμο του block |
block |
Δεδομένα σχετικά με το ίδιο το block (περιλαμβάνει τα postId, postType, context κ.λπ.) |
c |
Ψευδώνυμο του context |
context |
Το πλαίσιο του block (e.g., postId, postType μέσα σε βρόχο) |
isEditor |
Boolean, true αν το block αποδίδεται στον editor |
isPreview |
Boolean, true αν το block αποδίδεται στην προεπισκόπηση του inserter |
Χρήση
Για να χρησιμοποιήσετε το Twig για το πρότυπο του block σας, δημιουργήστε απλώς ένα αρχείο index.twig στον κατάλογο του block. Στη συνέχεια, το Blockstudio θα χρησιμοποιεί αυτόματα αυτό το αρχείο για την απόδοση του block.
<div class="my-block">
{% if a.title %}
<h2>{{ a.title }}</h2>
{% endif %}
{% if a.content %}
<p>{{ a.content }}</p>
{% endif %}
</div>