İçerik Eşitleme
Blockstudio, dosyaları önceleyen bir iş akışı üzerine kuruludur: bloklar, alanlar, şablonlar, varlıklar, desenler ve dosya tabanlı sayfaların tümü projenizde yer alabilir. İçerik Eşitleme, seçilmiş WordPress veritabanı içeriğini de bu modele ekler; böylece ekipler seçilmiş yazıları, terimleri, ilişkileri ve tanımlanmış meta verileri git içinde tutabilir.
Bu, WP-CLI iş akışıdır; canlı veritabanı çoğaltma değildir. İçeri Aktar sırasında İçerik Eşitleme, izin verilen yazıları, postmeta, terimleri, termmeta’yı ve yazı-terim ilişkilerini temanızdaki taşınabilir dosyalara yansıtır. Dışarı Aktar sırasında ise bu dosyaları başka bir ortama uygular; kararlı UID’ler kullanır ve yalnızca açıkça tanımladığınız referansları yeniden yazar.
Not
İçerik Senkronizasyonu isteğe bağlıdır. Her yönetici isteğinde çalışmaz.
content.enabledtrueolana kadar komutlar atlanan bir satır döndürür.
İçerik Eşitleme ne zaman kullanılır
Sürüme alınması, incelenmesi ve ortamlar arasında taşınması gereken içerik kümeleri için İçerik Eşitleme’yi kullanın:
- ekip üyeleri, konumlar, vaka incelemeleri, ürünler, dokümantasyon girdileri veya kampanya sayfaları gibi yapılandırılmış içerikler
- bu içerik kümelerine ait taksonomiler ve ilişkiler
- işlenmesi güvenli olan ve kararlı referanslar gerektiren izin verilen meta veriler
- dosyaları git içinde incelemenin hâlâ pratik olduğu küçük ve orta büyüklükteki içerik kümeleri
Genel bir kural olarak İçerik Eşitleme, onlarca veya yüzlerce satır için uygundur; veriler yapılandırılmış, az değişen ve odaklı yazı türlerine ayrılmışsa birkaç bin satıra kadar kullanılabilir. Tüm üretim veritabanını, yoğun trafiğe sahip editoryal içeriği, günlükleri, siparişleri, analiz verilerini, form gönderimlerini, oturumları veya hacmi ya da değişim sıklığı yüksek diğer verileri yansıtmak için tasarlanmamıştır. Oluşturulan dosyaların incelenmesi gürültülü hâle gelirse, dışarı aktarımları değerlendirmek çok uzun sürerse veya satırların çoğu dağıtım iş akışınız dışında değişiyorsa bunun yerine veritabanı yedeği, geçiş veya içe/dışa aktarma aracı kullanın.
Medya ikili dosyaları kopyalanmaz. Ek dosya referansları bir manifestte kaydedilip doğrulanabilir; ancak dosyaların kendilerinin hedef ortamda bulunması gerekir.
Yapılandırma
İçerik Eşitleme’yi blockstudio.json içinde etkinleştirin:
{
"$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 bir izin listesidir. Boş olması, İçerik Eşitleme’nin yazılara dokunmayacağı anlamına gelir. taxonomies, terimleri ve yazı ilişkileri eşitlenecek, önceden kaydedilmiş taksonomilerin izin listesidir. Blockstudio, İçerik Eşitleme dosyalarındaki taksonomi tanımlarını kaydetmez. Postmeta ve termmeta, meta.include üzerinden izin listesine alınır; meta.exclude her zaman önceliklidir.
Uyarı
meta.includeöğesini bir commit sınırı olarak değerlendirin. Eşitlenen dosyaların git içinde bulunması amaçlanır; bu nedenle sır, token, kimlik bilgisi veya kişisel veri (PII) içeren anahtarları eklemeyin.wp bs content status, izin verilen meta anahtarları hassas göründüğünde uyarı satırları bildirir.
content.id, eşitlenen varlıklarda _blockstudio_content_set olarak saklanır. Budama ve sahiplik denetimleri bu değerle sınırlandırılır; böylece bir içerik kümesi diğerinin içeriğini silemez.
Page Sync tarafından yönetilen yazılar varsayılan olarak hariç tutulur. includePageSyncManaged etkinleştirilirse İçerik Eşitleme, yapılandırılmış meta verilerini eşitleyebilir; ancak post_content üzerindeki sahiplik Page Sync’te kalır.
Bu görünümler "bodyOwner": "page-sync" içerir. Pull, JSON yazımını yalnızca meta veri olarak raporlar ve skipped gövde satırı ekler; böylece yazıyı gövdesi boşmuş gibi göstermez.
Yanında bulunan bir .html dosyasını yazmaz veya silmez. Mevcut inceleme kopyası korunur ve push tarafından yok sayılır. Aynı sahiplik iletileri deneme çalıştırması çıktısına da eklenir.
Başka bir ortamda önce Page Sync’i çalıştırın. bodyOwner: "page-sync" içeren bir projection, Page Sync tarafından yönetilen mevcut bir gönderiye başvurmalıdır; push boş bir yer tutucu oluşturmayı veya bu gövdenin inceleme kopyasını uygulamayı reddeder. Eski sürümlerdeki işaretçiyi içermeyen projection’lar desteklenmeye devam eder.
Kullanıcılar eşitlenmediğinden yazarlar varsayılan olarak yok sayılır. Yazarın kullanıcı giriş adını yazı dosyalarında saklamak ve dışarı aktarma sırasında bu girişi mevcut bir kullanıcıyla eşleştirmek için authors: "login" ayarını yapın. Eksik kullanıcılar ön kontrol hatasına yol açar; İçerik Eşitleme kullanıcı oluşturmaz.
Komutlar
wp bs content pull [--post-type=<type>] [--taxonomy=<taxonomy>] [--dry-run]
wp bs content push [--dry-run] [--prune] [--yes]
wp bs content status
pull veritabanı içeriğini dosyalara alır. Kapsamdaki ve henüz _blockstudio_content_uid değeri olmayan yazılara bu değeri atar, ayrıca veritabanı kaynağı artık bulunmayan eski dosyaları bildirir. Eski dosyalar içeri aktarma sırasında silinmez.
push dosyaları geçerli veritabanına uygular. Yazma işleminden önce planı doğrular ve çözümlenmemiş bildirimli referansları, slug çakışmalarını, kilitli varlıkları ve eksik yazı türlerini engeller.
status dosyaları veritabanıyla karşılaştırır ve her varlığı unchanged, would-update, missing-db, conflict, locked veya orphaned olarak bildirir. Değerler commit edilmeden önce sır gibi görünen izinli meta anahtarları hakkında ve İçerik Eşitleme, .html dosyalarındaki kimlikleri yeniden yazmadığından blok işaretleme gövdelerindeki sayısal kimlikler hakkında da uyarı verir.
Yazma işlemi yapmadan içeri aktarma veya dışarı aktarma işlemini incelemek için --dry-run kullanın. Dosyalarda artık bulunmayan içerik kümesine ait veritabanı varlıklarını kaldırmak için push --prune --yes kullanın.
Hata Güvenliği
push, yazma veya budama işlemi yapmadan önce kaynak planın tamamını ayrıştırıp doğrular. Bozuk JSON, çözümlenmemiş bildirimli referanslar, geçersiz sahiplik ve diğer ön kontrol hataları yıkıcı aşamayı engeller. Budama, yapılandırılmış yazı türleri, taksonomiler ve content.id ile sınırlı kalır.
pull, yansıtılan her dosyayı yazdıktan sonra varlığı eşitlenmiş olarak kaydeder. Dosya sistemi yazma hatası bir hata satırı olarak döndürülür ve söz konusu varlığın kayıtlı eşitleme durumu ilerletilmez.
Ek ilişikleri content.media uyarınca işlenir. "manifest" kullanıldığında, başvurulan ek UID’leri hedef ortamda bulunmalıdır. "none" kullanıldığında, tanımlanmış ek referansları ortama özgü kimlikleri korumak yerine taşınabilir çıktıdan kasıtlı olarak kaldırılır.
Dosyalar
Content Sync, dosyaları yapılandırılmış content.path altına yazar:
content/
posts/
team_member/
jane.9b1c0e6e.json
jane.9b1c0e6e.html
terms/
category/
leadership.5e900000.json
media/
manifest.json
Gönderi .json dosyaları kimliği, gönderi alanlarını, terim ilişkilerini, tanımlanmış meta verileri ve meta kodlamasını saklar. Kardeş .html dosyası, boş değilse post_content öğesini ham blok işaretlemesi olarak saklar; içerik boş olduğunda bu dosya eklenmez. Terim .json dosyaları kimliği, taksonomiyi, kısa adı, adı, açıklamayı, üst UID’yi, tanımlanmış termmeta verilerini ve meta kodlamasını saklar.
.html dosyasının bulunmadığı diğer durum, yukarıda bodyOwner ile tanımlanan Page Sync tarafından yönetilen bir gövdedir. Gövdesi boşalan normal gönderilerde pull eski gövde dosyasını kaldırır ve bunu ayrı bir deleted gövde satırında belirtir.
{
"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"
}
}
Saklanan eşitleme durumu şöyledir:
| Meta anahtarı | Amaç |
|---|---|
_blockstudio_content_uid |
Taşınabilir içerik kimliği |
_blockstudio_content_set |
content.id kaynağından gelen içerik kümesi ad alanı |
_blockstudio_content_source |
Temaya göreli kaynak dosya yolu |
_blockstudio_content_fingerprint |
Son eşitlenen dosya/veritabanı parmak izi |
_blockstudio_content_locked |
Doğru (truthy) bir değer, gönderimin varlığın üzerine yazmasını önler |
Referanslar
Content Sync, bir tam sayının kimlik olduğunu asla varsaymaz. Referanslar yalnızca meta.references içinde yapılandırıldığında yeniden yazılır.
{
"meta": {
"references": {
"_related_posts": { "kind": "post", "path": "*" },
"_topic": { "kind": "term" },
"_hero": { "kind": "attachment", "path": "image.id" }
}
}
}
Alma sırasında yerel kimlikler bu yollarda taşınabilir UID’lere dönüştürülür. Gönderme sırasında UID’ler geçerli veritabanındaki yerel kimliklere geri çözümlenir.
Gönderi üst öğeleri, terim üst öğeleri ve gönderi-terim ilişkileri Content Sync’in yönettiği yapısal referanslardır ve otomatik olarak UID şeklinde saklanır. Yapılandırılmış taksonomiler boş olsalar bile gönderi dosyalarına yazılır; boş bir dizi gönderme sırasında o taksonominin ilişkilerini temizler.
Ek referansları içe aktarılmaz, doğrulanır. media: "manifest" kullanıldığında, başvurulan ekler content/media/manifest.json içinde listelenir; gönderme işlemi, başvurulan ek UID’sinin yerel olarak bulunmasını gerektirir. media: "none" kullanıldığında, tanımlanmış ek referansları taşınabilir dosyalara eklenmez. Atlanan bir anahtar gönderme sırasında uygulanmadığından, hedefteki mevcut gönderi geçerli ek meta verilerini korur.
Taşınabilirlik İş Akışı
- Hedef gönderi türünü her ortamda kaydedin.
content.postTypes,meta.includeve tanımlanmış tüm referansları yapılandırın.- Kaynak ortamda
wp bs content pullkomutunu çalıştırın. - Oluşturulan dosyaları kaydedin.
- Hedef ortamda
wp bs content pushkomutunu çalıştırın. - Veritabanının dosyalarla eşleştiğini doğrulamak için
wp bs content statuskomutunu çalıştırın.
push için tek doğruluk kaynağı dosyalardır. Veritabanı, pull ile yeniden dosyalara aktarılır.
Kapsam
Content Sync şunları destekler:
- izin verilen gönderi türlerindeki gönderiler
- izin verilen gönderi meta verileri
- izin verilen kayıtlı taksonomilerdeki terimler
- izin verilen termmeta verileri
- gönderi-terim ilişkileri
- tanımlanmış
post,attachmentvetermreferansları - taşınabilir gönderi ve terim UID’leri ile içerik kümesi sahipliği
- varsayılan olarak Page Sync hariç tutma
- ek bildirimi ve ön denetim doğrulaması
pull,push,status,--dry-run,--pruneve kilitli varlık işleme
Taksonomi tanımlarının yakalanması, medya ikili dosyalarının kopyalanması ve blok işaretlemesindeki kimliklerin yeniden yazılması desteklenmez.