Alan grubu oluşturma

Alan gruplarını oluşturmak veya değiştirmek için yönetici hesabına (manage_options yetkisi) ihtiyacınız vardır.

Field Groups listesi

Şu sayfayı açın: WPM Fields › Field Groups (wp-admin/admin.php?page=wpmcf-field-groups).

Her alan grubu bir karttır. Kartta şunlar görünür:

Bir grubun tablosu yoksa, kartların üstündeki bilgi kutusu kaç grubun tablosunun olmadığını belirtir. Veritabanında hiçbir grubun sahip olmadığı wpmcf_fg_* tabloları varsa, kartların üstündeki bir panel bunları unregistered database tables olarak listeler (bkz. Table health).

Alan grubu ekleme

1. Şu düğmeye tıklayın: Add field group. Henüz hiç grubu olmayan bir sitede aynı düğme boş durum ekranında yer alır.
2. Şu bölümde: Group info şunları girin:

Anahtar bir harfle başlamalı, yalnızca küçük harf, rakam ve alt çizgi içermelidir (en fazla 63 karakter); ayrıca select, group veya table gibi bir SQL ayrılmış sözcüğü ya da eklentinin sistem sözcüklerinden biri (id, mid, mtype, wpid, uid, created_at, updated_at, ai_context, omit_delivery) olmamalıdır. REST API üzerinden büyük harfli veya boşluklu bir anahtar yazarsanız anahtar düzeltilir (Bad Key değeri bad_key olur); düzenleyicinin kendisi geçersiz karakterleri engeller.

3. Şu bölümde: Fields alanlarınızı ekleyin. Bkz. Alan ekleme ve düzenleme.
4. Şu bölümde: Settings › Location rules grubun nerede görüneceğini belirleyin. Bkz. Konum kuralları. Kuralı olmayan bir grup kaydedilir ancak hiçbir yerde gösterilmez.
5. İsteğe bağlı olarak stili, konumu ve etiket yerleşimini ayarlamak için Settings › Presentation bölümünü açın. Bkz. Grup ayarları.
6. Şuna tıklayın: Create field group.

Eklenti önce veritabanı tablosunu oluşturur, ardından tanımı kaydeder. Field group "..." created. bildirimini görürsünüz. Tablo oluşturulamazsa (örneğin veritabanı kullanıcısının tablo oluşturma yetkisi yoksa) hiçbir şey kaydedilmez ve hata nedenini belirtir.

Düzenleyicinin gösterdikleri

Düzenleyicide katlanabilir üç bölüm vardır. Yeni bir grupta hepsi açık başlar; kaydedilmiş bir grupta Group info ve Settings için tek satırlık bir özet gösterilir.

Her bölümün, son kaydedilen duruma dönen bir geri alma düğmesi vardır (Revert all group info changes, Revert all field changes, Revert all settings changes). Kaydedilmemiş değişikliklerle ayrılırsanız düzenleyici kapanmadan önce sorar.

Kaydedilmiş bir grupta, tablo ile tanım birbirini tutmadığında Table differences adlı ek bir panel, Group info ile Fields arasında görünür.

Alan grubunu düzenleme

1. Karta veya Edit düğmesine tıklayın. Adres: wp-admin/admin.php?page=wpmcf-field-groups#edit/{key}.
2. İstediğiniz değişiklikleri yapın ve Save changes düğmesine tıklayın.

Kaydederken olanlar:

• Önce tablo değiştirilir (yeni sütunlar, yeniden adlandırılan sütunlar, tür değişiklikleri, dizinler). Tanım yalnızca bu başarılı olduktan sonra kaydedilir. Veritabanı değişikliği reddederse her şey geri alınır; mesaj başarısız olan ifadeyle başlar ve Nothing was changed. ile biter.
• Uyarılar (örneğin "This group has 45 columns") kaydedilen grupla birlikte döndürülür.
• Kaldırılan bir alanın adı yeni bir alanda yeniden kullanılırsa, eski değerlere ne yapılacağı sorulur. Bkz. Bir alan grubunu güvenle değiştirme.
• Arka plandaki bir değişiklik sürerken Save changes devre dışıdır (REST API de 409 yanıtı verir).

Listeye dönmek için Cancel düğmesine tıklayın.

PHP ile kaydedilen gruplar

Kartında PHP görünen grup kodla kaydedilmiştir (wpmcf_register_field_group(), bkz. Geliştirici API'si). Düzenleyici Registered in PHP notunu gösterir ve kaydetmeyi devre dışı bırakır. Grubu, onu kaydeden kodda değiştirin. Silme işlemi de reddedilir.

Alan grubunu silme

Kartın üzerinden (Delete) veya düzenleyiciden silebilirsiniz: Settings › Group settings › Delete field group....

1. Açılan iletişim kutusu Delete field group? diye sorar ve tabloyu belirtir, örneğin This deletes «Product details» and drops its database table «wpmcf_fg_product_details» with all stored values.
2. İsteğe bağlı: tanımın bir kopyasını saklamak için önce Download the field group definition (JSON) first seçeneğine tıklayın (kayıtlı değerler bu dosyaya dahil değildir).
3. Şuna tıklayın: Delete.

REST API, istek confirm=true parametresini taşımıyorsa isteği reddeder.

REST API ile grup oluşturma

curl -X POST https://example.com/wp-json/wpmcf/v1/field-groups \
  -H "Content-Type: application/json" -u admin:APP_PASSWORD \
  -d '{
    "key": "product_details",
    "label": "Product details",
    "location": [[{ "param": "post_type", "operator": "equal", "value": "product" }]],
    "fields": [
      { "key": "price", "label": "Price", "type": "number" },
      { "key": "sku",   "label": "SKU",   "type": "text", "indexed": true }
    ]
  }'

Güncellemeler PUT /wpmcf/v1/field-groups/{key} kullanır. Kısmi bir gövde, dışarıda bıraktığı her şeyi korur. fields değerini geri gönderirken her alanın uid değerini koruyun: uid, eklentinin bir alanı kayıtlar arasında tanımasını sağlar; yeni bir key ve aynı uid ile gönderilen alan bir yeniden adlandırma sayılır; uid eksik olan alan ise yeni alandır.

İpuçları

• Kaydetmeden önce grup anahtarını ve alan anahtarlarını planlayın: bunlar gerçek sütun adları olur.
• Tek bir dev grup yerine iyi adlandırılmış birkaç grup tercih edin. Yaklaşık 40 sütundan az olan bir tablonun yönetimi kolay kalır.
• Hiçbir zaman filtrelemediğiniz veriler için (örneğin bir adres bloğu) Group alanlarını kullanın: çok sayıda sütun yerine tek sütun olur.
• Daha büyük yapısal değişikliklerden önce veritabanını yedekleyin.

Sorun giderme