Ürün Özellikleri

Ürün beslemenizde Selwise'in standart alanlarına girmeyen kendi alanlarınız varsa (garanti_suresi, mensei, kumas_turu) bunları zenginleştirme bloklarında yer tutucu olarak, katalog koşullarında ise hedefleme ölçütü olarak kullanabilirsiniz.

Panelde nerede

• Blok formu: Content Blocks → New block, Product tokens kutusunun altındaki Your own feed fields (Kendi besleme alanlarınız) listesi. Her alan ${attr.alan_adı} etiketi olarak görünür.
• Kural formu: Rules adımı → Catalogue conditions → alan seçicisindeki Custom fields from your feed (Beslemeden gelen özel alanlar) grubu.
• Kütüphane'de içerik bloğu şablonu yazarken Dynamic fields kutusundaki Custom product attributes listesi.

Nasıl yakalanır

Besleme senkronizasyonunda, standart alanlara eşlenmeyen alanlar otomatik olarak ürünün özellik listesine yazılır. Ayrıca bir şey yapmanız gerekmez. Alan, alan eşleştirmesinde bir standart alana eşlediğiniz kaynak alansa özel alan olarak tekrar taşınmaz; aynı değer iki yerde yaşamasın diye.

Hangi alanların taşınabildiğini önceden seçemezsiniz (hangilerinin var olduğunu görmeden karar veremezsiniz), bu yüzden sınırlar tek savunmadır.

Blokta kullanma

Özel alanlara attr öneki ile erişirsiniz:

<ul class="teknik">
  <li>Garanti: ${attr.garanti_suresi}</li>
  <li>Menşei: ${attr.mensei}</li>
  <li>Kumaş: ${attr.kumas_turu}</li>
</ul>

${attr.mensei} yerine {{attr.mensei}} yazımı da aynı işi yapar.

Alan adı nasıl sadeleştirilir

Beslemenizdeki ad, yer tutucuda kullanacağınız ada şu kurallarla dönüşür: harfler küçülür, Türkçe harfler ve aksanlar ASCII karşılığına çevrilir (ı → i, ü → u), harf ve rakam dışındaki her şey tek alt çizgi olur, baştaki ve sondaki alt çizgiler atılır, en fazla 64 karakter kalır. XML öznitelik işareti (@_) ve ad alanı öneki (g:) atılır.

Beslemedeki ad	Yer tutucu
Garanti Süresi	${attr.garanti_suresi}
g:material	${attr.material}
@_size	${attr.size}
Kumaş Türü	${attr.kumas_turu}

Alan adı hiç harf ya da rakam içermiyorsa o alan atlanır.

İç içe alanlar

Beslemeniz alanları bir kap içinde gönderiyorsa bir seviye içine bakılır. Şu kap adları tanınır ve içerdeki alanlar kendi adlarıyla gelir: attributes, attribute, custom_attributes, custom_fields, specs, specifications, properties, ozellikler. Akinon'un attributes.pre_ent_beden alanı ${attr.pre_ent_beden} olur. Tanınmayan bir kabın içindekiler kap_alan biçiminde önekle gelir (çünkü code, name gibi çocuk adları her şeyle çakışırdı). Aynı ad hem üst seviyede hem kap içinde varsa üst seviyedeki kazanır.

Değer nasıl okunur

Her değer metin olarak taşınır: sayı ve evet/hayır değerleri yazıya çevrilir. Boş değerler yakalanmaz. Sadece tek tek değerlerden oluşan bir liste virgülle birleştirilir (Pamuk, Keten). İçinde nesne olan liste atlanır. XML'de <ozellik birim="cm">120</ozellik> gibi öznitelikli bir öğede öğenin kendi metni (120) değerdir.

Hangi alanlar var

Blok editöründeki liste, son senkronizasyonda görülen alan adlarını gösterir (en fazla 200 ayrı ad). Bu liste beslemenizden çıkarılır ve senkronizasyonla güncellenir.

Liste	Sebep
Hiç alan yok, "No product feed is connected yet"	Kanala besleme bağlı değil
"The last feed sync found no fields beyond the standard ones"	Son senkronizasyonda standart alanların dışında alan bulunmadı; beslemenize ekleyip yeniden senkronlayın
"The custom fields from your feed could not be loaded"	Liste okunamadı; yeniden deneyin. Yer tutucu yazmaya yine devam edebilirsiniz

Beslemenizde olmayan bir alan yazarsanız blok o ürün için boş render eder; sayfada ${attr.garanti_suresi} yazısı görünmez.

Sınırlar

Yakalama sınırsız değildir:

Sınır	Değer
Ürün başına alan sayısı	40
Alan başına karakter	500
Ürün başına toplam boyut	yaklaşık 8 KB (8.000 karakter; ad ve değer toplamı)

Beslemenizde yüzlerce alan varsa sırayla ilk 40'ı alınır, sonrası atlanır. Satırın kendi bedeni ve rengi (attr.size, attr.color) bu sınırların dışında ayrıca eklenir. Bir blok, yalnızca gerçekten kullandığı alanları indirir: kırk alanlı bir üründe iki alan kullanan blok yalnızca o iki alanı taşır, yani kullanmadığınız alanların sayısı sayfa hızını etkilemez.

Boş alan yönetimi

Her ürünün her alanı dolu olmaz. Boş bir alan blokta boş bir satır bırakır. CSS ile gizleyebilirsiniz:

.teknik li:empty { display: none; }

Ya da bloğu yalnızca o alanı olan ürünlere atayın: kural yazarken Catalogue conditions içinde attr.garanti_suresi için is present koşulu kullanın. Bkz. Katalog Koşulları. Blok tasarımcısında bir metin öğesini attr. alanına bağladıysanız alan boşken satır kendini gizler.

Standart alanlar

Ürünün standart alanlarına (ad, fiyat, kategori) önek olmadan erişirsiniz. Tam liste ve örnek çıktılar: Yer Tutucular.