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

Αποθήκευση

Από προεπιλογή, όλες οι τιμές πεδίων αποθηκεύονται ως χαρακτηριστικά μπλοκ μέσα στο σχόλιο του μπλοκ στο περιεχόμενο της ανάρτησης. Η λειτουργία αποθήκευσης επιτρέπει να αποθηκεύετε επιπλέον τιμές στα μεταδεδομένα αναρτήσεων (wp_postmeta) ή στις επιλογές (wp_options), ώστε να είναι προσβάσιμες και έξω από το πλαίσιο του μπλοκ.

Γιατί να χρησιμοποιήσετε την αποθήκευση;

Τα χαρακτηριστικά μπλοκ αποθηκεύονται μέσα σε σχόλια HTML στο περιεχόμενο της ανάρτησης, πράγμα που σημαίνει ότι είναι προσβάσιμα μόνο κατά την ανάλυση του περιεχομένου των μπλοκ. Χρησιμοποιώντας πρόσθετες τοποθεσίες αποθήκευσης, μπορείτε να:

  • Υποβάλετε ερωτήματα για αναρτήσεις βάσει τιμών πεδίων με το meta_query
  • Αποκτήσετε πρόσβαση σε τιμές μέσω του REST API για headless εγκαταστάσεις
  • Μοιραστείτε δεδομένα με άλλα πρόσθετα, όπως το SEO ή πρόσθετα προσωρινής αποθήκευσης
  • Δημιουργήσετε καθολικές ρυθμίσεις που διατηρούνται σε όλες τις αναρτήσεις

Τύποι αποθήκευσης

Τύπος Τοποθεσία Εμβέλεια Κατάλληλο για
postMeta πίνακα wp_postmeta Ανά ανάρτηση Δεδομένα συγκεκριμένης ανάρτησης με δυνατότητα υποβολής ερωτημάτων
option πίνακα wp_options Καθολική (σε ολόκληρο τον ιστότοπο) Ρυθμίσεις ιστότοπου, κοινόχρηστες τιμές

Σημείωση

Η αποθήκευση χαρακτηριστικών μπλοκ (στο σχόλιο HTML του περιεχομένου της ανάρτησης) γίνεται πάντα αυτόματα. Η ιδιότητα storage προσθέτει επιπλέον τοποθεσίες αποθήκευσης· δεν αντικαθιστά την αποθήκευση μπλοκ.

Διαμόρφωση

Προσθέστε την ιδιότητα storage σε οποιονδήποτε ορισμό πεδίου:

JSON
{
  "name": "blockstudio/example",
  "title": "Example Block",
  "blockstudio": {
    "attributes": [
      {
        "id": "subtitle",
        "type": "text",
        "label": "Subtitle",
        "storage": {
          "type": "postMeta",
          "postMetaKey": "my_subtitle"
        }
      }
    ]
  }
}

Ιδιότητες αποθήκευσης

Ιδιότητα Τύπος Περιγραφή
type string | string[] Πρόσθετες τοποθεσίες αποθήκευσης location(s): "postMeta", "option"
postMetaKey string Προσαρμοσμένο κλειδί μεταδεδομένων (προεπιλογή: {block_name}_{field_id})
optionKey string Προσαρμοσμένο κλειδί επιλογής (προεπιλογή: {block_name}_{field_id})

Μία ή πολλές τοποθεσίες αποθήκευσης

JSON
// Add post meta storage
"storage": {
  "type": "postMeta"
}

// Add both post meta and option storage
"storage": {
  "type": ["postMeta", "option"]
}

Πώς λειτουργεί

  1. Καταχώριση: Κατά τη φόρτωση του WordPress, το Blockstudio καταχωρίζει κλειδιά μεταδεδομένων και ρυθμίσεις βάσει των διαμορφώσεων πεδίων σας
  2. Επεξεργασία: Οι τιμές διαχειρίζονται ως χαρακτηριστικά μπλοκ στον επεξεργαστή (αποθηκεύονται πάντα στο μπλοκ)
  3. Αποθήκευση: Τα μεταδεδομένα της ανάρτησης συγχρονίζονται κατά την αποθήκευση της ανάρτησης. Οι επιλογές του ιστότοπου συγχρονίζονται όταν δημοσιεύεται η ανάρτηση ή όταν αλλάζει η τιμή πεδίου μιας δημοσιευμένης ανάρτησης.

Τα αυτόματα αποθηκευμένα αντίγραφα και οι αναθεωρήσεις δεν συγχρονίζουν καμία από τις δύο τοποθεσίες αποθήκευσης. Οι πρόχειρες, οι εκκρεμείς, οι ιδιωτικές και οι προγραμματισμένες αναρτήσεις μπορούν να ενημερώνουν τα δικά τους μεταδεδομένα, αλλά δεν αλλάζουν τις ενεργές επιλογές του ιστότοπου. Μια προγραμματισμένη ανάρτηση συγχρονίζει τις επιλογές όταν το WordPress τη δημοσιεύσει.

Οι τιμές αντιγράφονται κυριολεκτικά, συμπεριλαμβανομένων των ανάστροφων καθέτων, των εισαγωγικών και των ένθετων τιμών επαναλήπτη. Μην προσθέτετε διαφυγή στις τιμές πεδίων για να αντισταθμίσετε την αποθήκευση μεταδεδομένων WordPress· το Blockstudio διαχειρίζεται αυτό το όριο. Οι επιλογές ιστότοπου διατηρούν τις ίδιες κυριολεκτικές τιμές χωρίς πρόσθετη προσθήκη καθέτων.

Αν μια παλαιότερη έκδοση αφαίρεσε ανάστροφες καθέτους από το αντίγραφο μεταδεδομένων μιας ανάρτησης, αποθηκεύστε ξανά την ανάρτηση μετά την αναβάθμιση. Η αρχική τιμή πεδίου στα γνωρίσματα του μπλοκ χρησιμοποιείται για την ανανέωση του αντιγράφου μεταδεδομένων.

Αποθήκευση επιλογών ιστότοπου

Οι επιλογές είναι κοινές σε ολόκληρο τον ιστότοπο. Η δημοσίευση ενός νέου block αποθηκεύει στα options τα πεδία επιλογών που παρέχονται στα αποθηκευμένα attributes του. Σε επόμενες αποθηκεύσεις, κάθε πεδίο συγκρίνεται με την προηγούμενη αποθηκευμένη έκδοση αυτού του block και αποθηκεύονται μόνο οι τιμές που έχουν αλλάξει. Η αποθήκευση του τίτλου μιας ανάρτησης ή ενός αμετάβλητου παλαιότερου αντιγράφου του block σε άλλη ανάρτηση δεν αντικαθιστά μια νεότερη τιμή option.

Ένα πεδίο που παραλείπεται από τα αποθηκευμένα attributes αφήνει το option του ανέπαφο. Αυτό προστατεύει επίσης τα υπάρχοντα options όταν προστίθεται ένα νέο πεδίο στο block.json. Ένα ρητό null διαγράφει ένα option· οι κενές συμβολοσειρές, τα false, τα 0 και οι κενές arrays αποθηκεύονται ως τιμές. Η αφαίρεση ενός block δεν διαγράφει τα options του.

Χρησιμοποιήστε ένα καθορισμένο δημοσιευμένο block για τη διαχείριση κάθε κοινόχρηστου option. Αν πολλά blocks αλλάξουν σκόπιμα το ίδιο option, υπερισχύει η τελευταία αποθηκευμένη αλλαγή. Η αποθήκευση δεν φορτώνει την τρέχουσα τιμή του option σε κάθε block: κάθε block διατηρεί τις δικές του τιμές πεδίων στο περιεχόμενο της ανάρτησης.

Για σελίδες που βασίζονται σε αρχεία, ένα μόνιμο block key επιτρέπει στο Blockstudio να αναγνωρίζει το ίδιο block αφού μετακινηθεί μέσα στο έγγραφο. Τα blocks χωρίς κλειδί αντιστοιχίζονται με βάση το όνομα και τη θέση τους.

Πρόσβαση στις αποθηκευμένες τιμές

Στα πρότυπα block

Μέσα στο πρότυπο του block, οι τιμές πεδίων είναι πάντα διαθέσιμες μέσω του $attributes:

PHP

PHP
<div>
  <h1><?php echo $a['subtitle']; ?></h1>
</div>

Twig

Twig
<div>
  <h1>{{ a.subtitle }}</h1>
</div>

Μεταδεδομένα ανάρτησης (εκτός του πλαισίου block)

Οι τιμές που είναι αποθηκευμένες στο postMeta είναι προσβάσιμες παντού στο WordPress:

PHP

PHP
// Get meta value
$subtitle = get_post_meta( $post_id, 'my_subtitle', true );

// Query posts by meta value
$posts = get_posts([
  'meta_key'   => 'my_subtitle',
  'meta_value' => 'Hello World',
]);

Twig

Twig
{# Using Timber #}
{{ post.meta('my_subtitle') }}

{# Or via function #}
{{ function('get_post_meta', post.id, 'my_subtitle', true) }}

Τα μεταδεδομένα ανάρτησης είναι επίσης διαθέσιμα μέσω του REST API:

Κέλυφος
GET /wp-json/wp/v2/posts/123
# Response includes: { "meta": { "my_subtitle": "Hello World" } }

Options (καθολικές τιμές)

Οι τιμές που είναι αποθηκευμένες στο option είναι προσβάσιμες σε ολόκληρο τον ιστότοπο:

PHP

PHP
$company_name = get_option( 'site_company_name' );

Twig

Twig
{{ function('get_option', 'site_company_name') }}

Παραδείγματα

Πεδία μεταδεδομένων SEO

Αποθηκεύστε δεδομένα SEO στα μεταδεδομένα ανάρτησης για συμβατότητα με πρόσθετα SEO:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "seo_title",
        "type": "text",
        "label": "SEO Title",
        "storage": {
          "type": "postMeta",
          "postMetaKey": "_yoast_wpseo_title"
        }
      },
      {
        "id": "seo_description",
        "type": "textarea",
        "label": "Meta Description",
        "storage": {
          "type": "postMeta",
          "postMetaKey": "_yoast_wpseo_metadesc"
        }
      }
    ]
  }
}

Προσθέστε αποθήκευση μεταδεδομένων ανάρτησης, ώστε να μπορείτε να αναζητάτε αναρτήσεις με βάση την τιμή ενός πεδίου:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "featured",
        "type": "toggle",
        "label": "Featured",
        "storage": {
          "type": "postMeta",
          "postMetaKey": "is_featured"
        }
      }
    ]
  }
}

Αναζητήστε τις επιλεγμένες αναρτήσεις:

PHP
$featured_posts = get_posts([
  'meta_key'   => 'is_featured',
  'meta_value' => '1',
]);

Καθολικές ρυθμίσεις ιστότοπου

Αποθηκεύστε τη διαμόρφωση για ολόκληρο τον ιστότοπο στα options:

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "company_name",
        "type": "text",
        "label": "Company Name",
        "storage": {
          "type": "option",
          "optionKey": "site_company_name"
        }
      },
      {
        "id": "support_email",
        "type": "text",
        "label": "Support Email",
        "storage": {
          "type": "option",
          "optionKey": "site_support_email"
        }
      }
    ]
  }
}

Αποκτήστε πρόσβαση από οπουδήποτε στον ιστότοπό σας:

PHP
<footer>
  <p>&copy; <?php echo get_option( 'site_company_name' ); ?></p>
  <p>Contact: <?php echo get_option( 'site_support_email' ); ?></p>
</footer>

Μεταδεδομένα ανάρτησης και option

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

JSON
{
  "blockstudio": {
    "attributes": [
      {
        "id": "important_value",
        "type": "text",
        "label": "Important Value",
        "storage": {
          "type": ["postMeta", "option"],
          "postMetaKey": "important_meta",
          "optionKey": "important_option"
        }
      }
    ]
  }
}

Προεπιλεγμένα ονόματα κλειδιών

Αν δεν καθορίσετε προσαρμοσμένο κλειδί, το Blockstudio δημιουργεί ένα αυτόματα:

Τύπος αποθήκευσης Μορφή προεπιλεγμένου κλειδιού Παράδειγμα
postMeta {block_name}_{field_id} blockstudio_example_subtitle
option {block_name}_{field_id} blockstudio_example_subtitle

Το όνομα του block καθαρίζεται (οι κάθετες αντικαθίστανται με κάτω παύλες).

Προειδοποίηση

Συνιστάται η χρήση προσαρμοσμένων κλειδιών σε περιβάλλον παραγωγής. Τα προεπιλεγμένα κλειδιά ενδέχεται να αλλάξουν αν μετονομάσετε το block σας.