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

Ξεκινώντας

Αυτός ο οδηγός θα σας βοηθήσει να ρυθμίσετε το Blockstudio και να δημιουργήσετε το πρώτο σας προσαρμοσμένο block.

Εγκατάσταση

Κέλυφος
composer require blockstudio/blockstudio

Το Blockstudio μπορεί να εγκατασταθεί ως πρόσθετο μέσω composer/installers ή να συμπεριληφθεί απευθείας σε ένα θέμα. Δείτε την τεκμηρίωση του Composer για όλους τους τρόπους εγκατάστασης.

Οι εγκαταστάσεις Composer λαμβάνουν ενημερώσεις μέσω του Composer. Το ενσωματωμένο πρόγραμμα ενημέρωσης του GitHub απενεργοποιείται αυτόματα.

Μη αυτόματη εγκατάσταση

Κατεβάστε την πιο πρόσφατη έκδοση από το GitHub

Ανεβάστε το αρχείο zip στον κατάλογο προσθέτων του WordPress σας και ενεργοποιήστε το πρόσθετο. Οι μη αυτόματες εγκαταστάσεις λαμβάνουν αυτόματες ειδοποιήσεις ενημερώσεων στον πίνακα ελέγχου του WordPress μέσω του ενσωματωμένου προγράμματος ενημέρωσης GitHub.

Και οι δύο μέθοδοι εγκατάστασης περιλαμβάνουν ιδιωτικά αντίγραφα των βιβλιοθηκών Markdown, YAML και ενημέρωσης, μαζί με τις εξαρτήσεις τους. Δεν χρησιμοποιούν ούτε αντικαθιστούν εκδόσεις που παρέχονται από άλλο πρόσθετο ή θέμα. Εγκαταστήστε τη δική σας εξάρτηση Composer αν η εφαρμογή σας χρησιμοποιεί απευθείας κάποια από αυτές τις βιβλιοθήκες· τα ενσωματωμένα αντίγραφα του Blockstudio είναι εσωτερικά και δεν αποτελούν δημόσιο PHP API.

Έλεγχοι ενημερώσεων με πιστοποίηση ταυτότητας

Οι μη αυτόματες εγκαταστάσεις ελέγχουν ανώνυμα το GitHub από προεπιλογή. Αν πολλοί ιστότοποι μοιράζονται μία εξερχόμενη σύνδεση IP, μπορεί να εξαντλήσουν το ανώνυμο όριο API του GitHub και να λάβουν αποκρίσεις HTTP 403 κατά τον έλεγχο για ενημερώσεις. Από το 7.7.4, διαμορφώστε ένα προσωπικό διακριτικό πρόσβασης GitHub στο wp-config.php, πριν φορτωθεί το WordPress:

PHP
define('BLOCKSTUDIO_GITHUB_TOKEN', 'your-github-token');

Το token χρειάζεται πρόσβαση μόνο σε δημόσιες πληροφορίες αποθετηρίων. Μην εκχωρείτε δικαιώματα εγγραφής. Διατηρήστε το στις ρυθμίσεις παραμέτρων του διακομιστή, εκτός του ελέγχου εκδόσεων και του blockstudio.json, των γνωρισμάτων μπλοκ και του κώδικα frontend. Το πρόγραμμα ενημέρωσης το περνά στο ενσωματωμένο πρόγραμμα-πελάτη GitHub για ελέγχους με έλεγχο ταυτότητας και λήψεις εκδόσεων. Τα αιτήματα προς άσχετα αποθετήρια και άλλους διακομιστές λήψης δεν λαμβάνουν το token.

Για μυστικά που διαχειρίζονται μέσω περιβάλλοντος, ένα πρόσθετο MU μπορεί να παρέχει ή να παρακάμπτει το διακριτικό:

PHP
<?php
add_filter('blockstudio/updater/token', function ($token) {
  return getenv('BLOCKSTUDIO_GITHUB_TOKEN') ?: $token;
});

Το φίλτρο εκτελείται όταν το Blockstudio αρχικοποιεί το πρόγραμμα ενημέρωσής του, πριν φορτωθεί το θέμα. Καταχωρίστε το σε ένα πρόσθετο MU αντί για το functions.php. Αν επιστραφεί κενή συμβολοσειρά, απενεργοποιείται η πιστοποίηση ταυτότητας ακόμη και αν έχει οριστεί η σταθερά. Οι κενές ή μη συμβολοσειριακές τιμές αφήνουν τους ελέγχους ανώνυμους. Τα διακριτικά είναι προαιρετικά· χωρίς αυτά, η υπάρχουσα συμπεριφορά ενημέρωσης παραμένει ίδια. Οι εγκαταστάσεις Composer εξακολουθούν να χρησιμοποιούν το Composer για ενημερώσεις και δεν αρχικοποιούν αυτό το πρόγραμμα ενημέρωσης.

Δημιουργία του πρώτου σας block

1. Δημιουργία καταλόγου block

Δημιουργήστε έναν νέο κατάλογο στο θέμα σας:

Κώδικας
my-theme/
  blockstudio/
    my-first-block/
      block.json
      index.php

2. Ορισμός του σχήματος block

Δημιουργήστε το block.json με τις ρυθμίσεις του block σας:

JSON
{
  "$schema": "https://blockstudio.dev/schema/block",
  "name": "my-theme/my-first-block",
  "title": "My First Block",
  "category": "common",
  "icon": "star-filled",
  "blockstudio": {
    "attributes": [
      {
        "id": "heading",
        "type": "text",
        "label": "Heading",
        "default": "Hello World"
      },
      {
        "id": "content",
        "type": "textarea",
        "label": "Content"
      }
    ]
  }
}

3. Δημιουργία του προτύπου

Δημιουργήστε το index.php για την απόδοση:

PHP
<div class="my-first-block">
  <h2><?php echo $a['heading']; ?></h2>
  <p><?php echo $a['content']; ?></p>
</div>

Χρήση προτύπων Twig

Το Blockstudio υποστηρίζει πρότυπα Twig εξαρχής. Απλώς χρησιμοποιήστε το index.twig:

Twig
<div class="my-first-block">
  <h2>{{ a.heading }}</h2>
  <p>{{ a.content }}</p>
</div>

Προσθήκη στυλ

Δημιουργήστε ένα αρχείο style.css στον ίδιο φάκελο:

CSS
.my-first-block {
  padding: 2rem;
  background: #f5f5f5;
}

Το Blockstudio θα προσθέσει αυτόματα αυτό το φύλλο στυλ στην ουρά φόρτωσης όταν χρησιμοποιείται το block.

Μεταφράσεις

Τα στοιχεία ελέγχου του επεξεργαστή και η επισκόπηση διαχείρισης του Blockstudio φορτώνουν μεταφράσεις JavaScript για το πεδίο κειμένου blockstudio μέσω του WordPress. Εγκαταστήστε το αντίστοιχο πακέτο γλώσσας ή δημιουργήστε αρχεία μεταφράσεων σεναρίων JSON με το εργαλείο μετάφρασης που χρησιμοποιείτε στο wp-content/languages/plugins/. Οι συμβολοσειρές χωρίς διαθέσιμη μετάφραση παραμένουν στα Αγγλικά. Αυτό μεταφράζει το δικό του περιβάλλον εργασίας του Blockstudio, όχι το περιεχόμενο ή τις ετικέτες πεδίων που ορίζετε στα block σας.

Επόμενα βήματα

Το block σας είναι πλέον έτοιμο για χρήση στον επεξεργαστή WordPress. Συνεχίστε να εξερευνάτε την τεκμηρίωση για να μάθετε σχετικά με:

Δημιουργία βιβλιοθήκης block

Περάστε από ένα μόνο block σε μια πλήρη βιβλιοθήκη: σχεδιαστικά tokens, το μοτίβο ενότητας, επαναλήπτες, εικόνες και σύνθεση σελίδων.