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

Συγχρονισμός περιεχομένου

Το Blockstudio βασίζεται σε μια ροή εργασίας με προτεραιότητα στα αρχεία: τα blocks, τα πεδία, τα πρότυπα, τα στοιχεία, τα μοτίβα και οι σελίδες που βασίζονται σε αρχεία μπορούν όλα να βρίσκονται στο έργο σας. Ο Συγχρονισμός περιεχομένου επεκτείνει αυτό το μοντέλο σε επιλεγμένο περιεχόμενο βάσης δεδομένων WordPress για ομάδες που θέλουν επίσης επιμελημένες αναρτήσεις, όρους, συσχετίσεις και δηλωμένα μεταδεδομένα στο git.

Πρόκειται για ροή εργασίας WP-CLI, όχι για ζωντανή αναπαραγωγή βάσης δεδομένων. Κατά τη λήψη, ο Συγχρονισμός περιεχομένου προβάλλει τις αναρτήσεις, τα postmeta, τους όρους, τα termmeta και τις σχέσεις ανάρτησης-όρου που περιλαμβάνονται στη λίστα επιτρεπόμενων σε φορητά αρχεία στο θέμα σας. Κατά την αποστολή, εφαρμόζει αυτά τα αρχεία σε άλλο περιβάλλον, χρησιμοποιώντας σταθερά UID και ξαναγράφοντας μόνο τις αναφορές που δηλώνετε ρητά.

Σημείωση

Ο Συγχρονισμός περιεχομένου γίνεται κατ’ απαίτηση. Δεν εκτελείται σε κάθε αίτημα διαχείρισης. Οι εντολές επιστρέφουν μια γραμμή παράλειψης μέχρι το content.enabled να γίνει true.

Πότε να χρησιμοποιείτε τον Συγχρονισμό περιεχομένου

Χρησιμοποιήστε τον Συγχρονισμό περιεχομένου για σύνολα περιεχομένου που είναι σημαντικό να εκδοθούν, να ελεγχθούν και να μετακινηθούν μεταξύ περιβαλλόντων:

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

Ως γενικός κανόνας, ο Συγχρονισμός περιεχομένου είναι κατάλληλος για δεκάδες ή εκατοντάδες γραμμές και μπορεί να λειτουργήσει και για λίγες χιλιάδες, όταν τα δεδομένα είναι δομημένα, αλλάζουν σπάνια και χωρίζονται σε εστιασμένους τύπους αναρτήσεων. Δεν προορίζεται για την αντιγραφή ολόκληρης βάσης δεδομένων παραγωγής, περιεχομένου σύνταξης με υψηλή επισκεψιμότητα, αρχείων καταγραφής, παραγγελιών, αναλυτικών στοιχείων, υποβολών φορμών, συνεδριών ή άλλων δεδομένων μεγάλου όγκου ή συχνών αλλαγών. Αν τα παραγόμενα αρχεία γίνουν δύσκολα στην ανασκόπηση, οι αποστολές χρειάζονται υπερβολική προσπάθεια για να αξιολογηθούν ή οι περισσότερες γραμμές αλλάζουν έξω από τη ροή ανάπτυξής σας, χρησιμοποιήστε αντί γι’ αυτό ένα εργαλείο αντιγράφων ασφαλείας, μετεγκατάστασης ή εισαγωγής/εξαγωγής βάσης δεδομένων.

Τα δυαδικά αρχεία πολυμέσων δεν αντιγράφονται. Οι αναφορές συνημμένων μπορούν να καταγραφούν σε ένα manifest και να επικυρωθούν, αλλά τα ίδια τα αρχεία πρέπει να υπάρχουν στο περιβάλλον προορισμού.

Διαμόρφωση

Ενεργοποιήστε τον Συγχρονισμό περιεχομένου στο blockstudio.json:

JSON
{
  "$schema": "https://blockstudio.dev/schema/blockstudio",
  "content": {
    "enabled": true,
    "id": "default",
    "path": "content",
    "includePageSyncManaged": false,
    "authors": "ignore",
    "postTypes": ["team_member"],
    "meta": {
      "include": ["_my_*"],
      "exclude": ["_edit_lock", "_edit_last", "_wp_old_slug"],
      "references": {
        "_thumbnail_id": { "kind": "attachment" },
        "_related_posts": { "kind": "post", "path": "*" },
        "_hero": { "kind": "attachment", "path": "image.id" }
      }
    },
    "taxonomies": [],
    "media": "manifest"
  }
}

Το postTypes είναι λίστα επιτρεπόμενων. Αν είναι κενό, ο Συγχρονισμός περιεχομένου δεν επηρεάζει αναρτήσεις. Το taxonomies είναι λίστα ήδη καταχωρισμένων ταξινομιών των οποίων οι όροι και οι σχέσεις με αναρτήσεις πρέπει να συγχρονίζονται. Το Blockstudio δεν καταχωρίζει ορισμούς ταξινομιών από αρχεία του Συγχρονισμού περιεχομένου. Τα postmeta και termmeta περιλαμβάνονται στη λίστα επιτρεπόμενων μέσω του meta.include· το meta.exclude υπερισχύει πάντα.

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

Αντιμετωπίστε το meta.include ως όριο υποβολής. Τα συγχρονισμένα αρχεία προορίζονται για αποθήκευση στο git, επομένως μην συμπεριλάβετε κλειδιά που περιέχουν μυστικά, token, διαπιστευτήρια ή προσωπικά δεδομένα. Το wp bs content status αναφέρει γραμμές προειδοποίησης όταν ένα κλειδί meta από τη λίστα επιτρεπόμενων φαίνεται ευαίσθητο.

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

Οι αναρτήσεις που διαχειρίζεται ο Συγχρονισμός σελίδων εξαιρούνται από προεπιλογή. Αν είναι ενεργό το includePageSyncManaged, ο Συγχρονισμός περιεχομένου μπορεί να συγχρονίσει τα διαμορφωμένα μεταδεδομένα τους, αλλά ο Συγχρονισμός σελίδων εξακολουθεί να διαχειρίζεται το post_content τους.

Αυτές οι προβολές περιέχουν "bodyOwner": "page-sync". Το Pull αναφέρει την εγγραφή JSON ως μεταδεδομένα μόνο και προσθέτει μια γραμμή σώματος skipped, αντί να παρουσιάζει την ανάρτηση σαν να έχει κενό σώμα. Δεν γράφει ούτε διαγράφει ένα συνοδευτικό αρχείο .html. Ένα υπάρχον αντίγραφο ελέγχου διατηρείται και αγνοείται από το push. Τα ίδια μηνύματα κυριότητας περιλαμβάνονται και στην έξοδο της δοκιμαστικής εκτέλεσης.

Σε άλλο περιβάλλον, εκτελέστε πρώτα το Page Sync. Μια προβολή με bodyOwner: "page-sync" πρέπει να αναφέρεται σε υπάρχουσα ανάρτηση που διαχειρίζεται το Page Sync· η εντολή push αρνείται να δημιουργήσει ένα κενό υποκατάστατο ή να εφαρμόσει το αντίγραφο ελέγχου του σώματος. Οι προβολές χωρίς τον δείκτη από παλαιότερες εκδόσεις εξακολουθούν να υποστηρίζονται.

Οι συντάκτες αγνοούνται από προεπιλογή, επειδή οι χρήστες δεν συγχρονίζονται. Ορίστε το authors: "login" για να αποθηκεύεται το όνομα σύνδεσης του συντάκτη στα αρχεία αναρτήσεων και να αντιστοιχίζεται σε υπάρχοντα χρήστη κατά την αποστολή. Η απουσία χρήστη προκαλεί σφάλμα στον προέλεγχο· ο Συγχρονισμός περιεχομένου δεν δημιουργεί χρήστες.

Εντολές

Κέλυφος
wp bs content pull [--post-type=<type>] [--taxonomy=<taxonomy>] [--dry-run]
wp bs content push [--dry-run] [--prune] [--yes]
wp bs content status

Το pull καταγράφει το περιεχόμενο της βάσης δεδομένων σε αρχεία. Εκχωρεί το _blockstudio_content_uid σε αναρτήσεις εντός του πεδίου εφαρμογής που δεν διαθέτουν ακόμη τιμή και αναφέρει παρωχημένα αρχεία των οποίων η προέλευση στη βάση δεδομένων δεν υπάρχει πλέον. Τα παρωχημένα αρχεία δεν διαγράφονται κατά τη λήψη.

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

Το status συγκρίνει τα αρχεία με τη βάση δεδομένων και αναφέρει κάθε οντότητα ως unchanged, would-update, missing-db, conflict, locked ή orphaned. Προειδοποιεί επίσης για κλειδιά meta από τη λίστα επιτρεπόμενων που μοιάζουν με μυστικά προτού υποβληθούν αυτές οι τιμές, καθώς και για αριθμητικά ID μέσα σε σώματα σήμανσης block, επειδή ο Συγχρονισμός περιεχομένου δεν ξαναγράφει ID σε αρχεία .html.

Χρησιμοποιήστε το --dry-run για να επιθεωρήσετε μια λήψη ή αποστολή χωρίς εγγραφή. Χρησιμοποιήστε το push --prune --yes για να αφαιρέσετε από τη βάση δεδομένων οντότητες που ανήκουν σε σύνολο περιεχομένου και δεν υπάρχουν πλέον στα αρχεία.

Ασφάλεια σε περίπτωση αποτυχίας

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

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

Ο χειρισμός των συνημμένων ακολουθεί το content.media. Με το "manifest", τα UID των αναφερόμενων συνημμένων πρέπει να υπάρχουν στο περιβάλλον προορισμού. Με το "none", οι δηλωμένες αναφορές συνημμένων αφαιρούνται σκόπιμα από τη φορητή έξοδο, αντί να διατηρούνται αναγνωριστικά συγκεκριμένα για το περιβάλλον.

Αρχεία

Το Content Sync γράφει αρχεία κάτω από το διαμορφωμένο content.path:

Κώδικας
content/
  posts/
    team_member/
      jane.9b1c0e6e.json
      jane.9b1c0e6e.html
  terms/
    category/
      leadership.5e900000.json
  media/
    manifest.json

Τα αρχεία .json αναρτήσεων αποθηκεύουν ταυτότητα, πεδία ανάρτησης, σχέσεις όρων, δηλωμένα μεταδεδομένα και κωδικοποίηση μεταδεδομένων. Το ομότιμο αρχείο .html αποθηκεύει το post_content ως ακατέργαστη σήμανση block και παραλείπεται όταν το περιεχόμενο είναι κενό. Τα αρχεία .json όρων αποθηκεύουν ταυτότητα, ταξινομία, slug, όνομα, περιγραφή, UID γονέα, δηλωμένα μεταδεδομένα όρου και κωδικοποίηση μεταδεδομένων.

Η άλλη περίπτωση χωρίς αρχείο .html είναι ένα σώμα που ανήκει στο Page Sync, το οποίο αναγνωρίζεται από το bodyOwner παραπάνω. Για συνηθισμένες αναρτήσεις των οποίων το σώμα αδειάζει, η εντολή pull αφαιρεί το παλιό αρχείο σώματος και το κατονομάζει σε ξεχωριστή γραμμή σώματος deleted.

JSON
{
  "uid": "9b1c0e6e-0000-4000-9000-000000000000",
  "type": "team_member",
  "status": "publish",
  "slug": "jane",
  "title": "Jane",
  "parent": null,
  "menuOrder": 0,
  "terms": {
    "category": ["5e900000-0000-4000-9000-000000000000"]
  },
  "meta": {
    "_my_subtitle": "Creative Director",
    "_thumbnail_id": "a1b2c3d4-0000-4000-9000-000000000000"
  },
  "metaEncoding": {
    "_my_subtitle": "scalar",
    "_thumbnail_id": "scalar"
  }
}

Η αποθηκευμένη κατάσταση συγχρονισμού είναι:

Κλειδί μεταδεδομένων Σκοπός
_blockstudio_content_uid Φορητή ταυτότητα περιεχομένου
_blockstudio_content_set Χώρος ονομάτων συνόλου περιεχομένου από το content.id
_blockstudio_content_source Διαδρομή αρχείου πηγής σχετική με το θέμα
_blockstudio_content_fingerprint Τελευταίο αποτύπωμα συγχρονισμένου αρχείου/βάσης δεδομένων
_blockstudio_content_locked Μη μηδενική τιμή εμποδίζει το push να αντικαταστήσει την οντότητα

Αναφορές

Το Content Sync δεν υποθέτει ποτέ ότι ένας ακέραιος είναι ID. Οι αναφορές επανεγγράφονται μόνο όταν έχουν διαμορφωθεί στο meta.references.

JSON
{
  "meta": {
    "references": {
      "_related_posts": { "kind": "post", "path": "*" },
      "_topic": { "kind": "term" },
      "_hero": { "kind": "attachment", "path": "image.id" }
    }
  }
}

Κατά το pull, τα τοπικά ID σε αυτές τις διαδρομές γίνονται φορητά UID. Κατά το push, τα UID επιλύονται ξανά σε τοπικά ID στην τρέχουσα βάση δεδομένων.

Οι γονικές αναρτήσεις, οι γονικοί όροι και οι σχέσεις όρων αναρτήσεων είναι δομικές αναφορές που ανήκουν στο Content Sync και αποθηκεύονται αυτόματα ως UID. Οι διαμορφωμένες ταξινομίες εγγράφονται στα αρχεία αναρτήσεων ακόμη κι όταν είναι κενές· ένας κενός πίνακας διαγράφει τις σχέσεις αυτής της ταξινομίας κατά το push.

Οι αναφορές συνημμένων επικυρώνονται, δεν εισάγονται. Με το media: "manifest", τα αναφερόμενα συνημμένα παρατίθενται στο content/media/manifest.json· το push απαιτεί το UID του αναφερόμενου συνημμένου να υπάρχει τοπικά. Με το media: "none", οι δηλωμένες αναφορές συνημμένων παραλείπονται από τα φορητά αρχεία. Επειδή ένα κλειδί που παραλείπεται δεν εφαρμόζεται κατά το push, μια υπάρχουσα ανάρτηση προορισμού διατηρεί τα τρέχοντα μεταδεδομένα συνημμένων της.

Ροή εργασίας φορητότητας

  1. Καταχωρίστε τον τύπο ανάρτησης προορισμού σε κάθε περιβάλλον.
  2. Διαμορφώστε τα content.postTypes, meta.include και τυχόν δηλωμένες αναφορές.
  3. Εκτελέστε το wp bs content pull στο περιβάλλον πηγής.
  4. Υποβάλετε τα αρχεία που δημιουργήθηκαν.
  5. Εκτελέστε το wp bs content push στο περιβάλλον προορισμού.
  6. Εκτελέστε το wp bs content status για να επαληθεύσετε ότι η βάση δεδομένων συμφωνεί με τα αρχεία.

Τα αρχεία είναι η πηγή αλήθειας για το push. Η βάση δεδομένων καταγράφεται ξανά σε αρχεία με το pull.

Εμβέλεια

Το Content Sync υποστηρίζει:

  • αναρτήσεις από επιτρεπόμενους τύπους αναρτήσεων
  • επιτρεπόμενα μεταδεδομένα αναρτήσεων
  • όρους από επιτρεπόμενες καταχωρισμένες ταξινομίες
  • επιτρεπόμενα μεταδεδομένα όρων
  • σχέσεις όρων αναρτήσεων
  • δηλωμένες αναφορές post, attachment και term
  • φορητά UID αναρτήσεων και όρων και ιδιοκτησία συνόλου περιεχομένου
  • εξαίρεση του Page Sync από προεπιλογή
  • μανιφέστο συνημμένων και προκαταρκτική επικύρωση
  • χειρισμό pull, push, status, --dry-run, --prune και κλειδωμένων οντοτήτων

Δεν υποστηρίζονται η καταγραφή ορισμών ταξινομίας, η αντιγραφή δυαδικών αρχείων πολυμέσων και η επανεγγραφή ID στη σήμανση block.