Kategori Alanları

Bu dokümantasyon, Serenay\B2B\Data\Category nesnesinin tüm erişilebilir alanlarını ve metodlarını içerir. Kategori nesnesi Twig şablonlarında kullanılabilir.

Tüm Kategori Özellikleri

🔍

🏷️ Temel Bilgiler

Alan Adı	Arama Kelimeleri	Tip	Açıklama	Twig Kullanımı
id	id, kimlik, unique	int	Kategori benzersiz ID'si	{{ category.id }}
name / isim	isim, name, ad, başlık	string	Kategori adı	{{ category.name }} veya {{ category.isim }}
url	url, link, bağlantı	string	Kategori sayfası URL'i	<a href="{{ category.url }}">
description / aciklama	açıklama, description, detay, html	string	Kategori açıklaması (HTML içerebilir)	{{ category.description|raw }}
slug	slug, url, permalink	string	URL-friendly kategori ismi	{{ category.slug }}
admin_url	admin, yönetici, düzenleme	string	Admin panel URL'i	{{ category.admin_url }}
subtitle	alt başlık, subtitle	string	Alt başlık	{{ category.subtitle }}

🖼️ Görseller

Alan Adı	Arama Kelimeleri	Tip	Açıklama	Twig Kullanımı
image	görsel, image, resim, foto	string	Kategori görseli tam URL	<img src="{{ category.image }}">
category_image	kategori görseli, category image	string	Kategori görseli veya ürün görseli	<img src="{{ category.category_image }}">
product_image	ürün görseli, product image	string	Kategorideki ilk ürün görseli	<img src="{{ category.product_image }}">
has_image	görsel var mı, resim kontrol	bool	Kategorinin görseli var mı?	{% if category.has_image %}
dosya	dosya, file, görsel dosyası	string	Kategori görsel dosya adı	{{ category.dosya }}

📱 Mobil İkonlar

Alan Adı	Arama Kelimeleri	Tip	Açıklama	Twig Kullanımı
icon	ikon, icon, mobil ikon	string	Mobil ikon URL'i	<img src="{{ category.icon }}">
mobile_icon	mobil ikon, mobile icon	string	Mobil ikon dosya yolu	{{ category.mobile_icon }}
has_icon	ikon var mı, icon kontrol	bool	Mobil ikon var mı?	{% if category.has_icon %}

🌳 Hiyerarşi

Alan Adı	Arama Kelimeleri	Tip	Açıklama	Twig Kullanımı
parent_category	üst kategori, parent category	Category	Üst kategori	{{ category.parent_category.name }}
sub_categories	alt kategoriler, sub categories	Category[]	Alt kategoriler	{% for sub in category.sub_categories %}
id_with_sub_categories	alt kategori idleri, subcategory ids	array	Bu kategori ve alt kategori ID'leri	{{ category.id_with_sub_categories|join(',') }}
parent_id	üst kategori id, parent id	int	Üst kategori ID'si	{{ category.parent_id }}
main_category_id	ana kategori id, main category	int	Ana kategori ID'si	{{ category.main_category_id }}
ana_kategori	ana kategori, main category	smallint	Ana kategori mi? (1=evet, 0=hayır)	{% if category.ana_kategori %}

⚙️ Admin ve Ayarlar

Alan Adı	Arama Kelimeleri	Tip	Açıklama	Twig Kullanımı
admin_url	admin url, yönetici linki	string	Admin düzenleme URL'i	<a href="{{ category.admin_url }}">
all_products_link	tüm ürünler linki, all products	string	Tüm ürünler admin linki	<a href="{{ category.all_products_link }}">
active_products_link	aktif ürünler linki, active products	string	Aktif ürünler admin linki	<a href="{{ category.active_products_link }}">
pozisyon	pozisyon, position, sıralama	smallint	Kategori sıralama değeri	{{ category.pozisyon }}
durum	durum, status, aktif, pasif	smallint	Kategori durumu (1=aktif, 0=pasif)	{% if category.durum %}

🌍 Çoklu Dil

Alan Adı	Arama Kelimeleri	Tip	Açıklama	Twig Kullanımı
isim_en	english name, ingilizce isim	string	İngilizce kategori adı	{{ category.isim_en }}
isim_ru	russian name, rusça isim	string	Rusça kategori adı	{{ category.isim_ru }}
isim_ar	arabic name, arapça isim	string	Arapça kategori adı	{{ category.isim_ar }}
translates	çeviriler, translations	json	Çoklu dil çevirileri	{{ category.translates }}

🔍 SEO

Alan Adı	Arama Kelimeleri	Tip	Açıklama	Twig Kullanımı
seo_template_id	seo template id, seo şablon	int	SEO şablon ID'si	{{ category.seo_template_id }}
seo_template	seo template, seo şablonu	SeoTemplate	SEO şablonu	{{ category.seo_template.title }}

⚙️ Özel Alanlar

Alan Adı	Arama Kelimeleri	Tip	Açıklama	Twig Kullanımı
custom	özel alanlar, custom fields	array	Tüm özel alanlar	{% for key, value in category.custom %}
custom_field_{key}	özel alan, custom field	mixed	Özel alan değeri	{{ category.custom_field_website }}
customFieldValues	özel alan değerleri, custom field values	array	Özel alan değerleri	{% for field in category.customFieldValues %}

Twig Kullanım Örnekleri

Kategori Kartı

<div class="category-card">
    <a href="{{ category.url }}">
        {% if category.has_icon %}
            <img src="{{ category.icon }}" alt="{{ category.name }}" class="category-icon">
        {% elif category.has_image %}
            <img src="{{ category.image }}" alt="{{ category.name }}" class="category-image">
        {% else %}
            <img src="{{ category.product_image }}" alt="{{ category.name }}" class="category-product-image">
        {% endif %}
        
        <h3>{{ category.name }}</h3>
    </a>
</div>

Kategori Hiyerarşisi

<!-- Ana kategoriler -->
{% for category in main_categories %}
    <div class="main-category">
        <h2>
            <a href="{{ category.url }}">{{ category.name }}</a>
        </h2>
        
        <!-- Alt kategoriler -->
        {% if category.sub_categories %}
            <ul class="sub-category-list">
                {% for sub in category.sub_categories %}
                    <li>
                        <a href="{{ sub.url }}">{{ sub.name }}</a>
                    </li>
                {% endfor %}
            </ul>
        {% endif %}
    </div>
{% endfor %}

Breadcrumb Navigation

{% if category.parent_category %}
    <nav class="breadcrumb">
        <a href="{{ category.parent_category.url }}">{{ category.parent_category.name }}</a>
        <span> > </span>
        <span>{{ category.name }}</span>
    </nav>
{% endif %}

Public Metodlar

Metod	Parametreler	Dönüş	Açıklama
productCount()	-	int	Bu kategorideki ürün sayısı
removeImage()	-	void	Kategori görselini sil
removeIcon()	-	void	Kategori ikonunu sil
customValue('key')	string	string	Özel alan değerini getir
getSlug($lang)	string	string	Dile göre slug getir

Önemli Notlar

HTML İçerik

description alanı HTML içerebilir, güvenlik için |raw filtresi kullanırken dikkatli olun.

Görsel Önceliklendirmesi

category_image önce kategori görselini, yoksa ürün görselini döner.

Hiyerarşi

ana_kategori alanı ana kategoriyi, parent_id üst kategoriyi belirtir.

Sıkça Sorulan Sorular (SSS)

Kategori hiyerarşisi nasıl çalışır?

Kategori sistemi iki seviyeli çalışır: Ana kategoriler (ana_kategori = 1) ve alt kategoriler (ana_kategori = 0). parent_id alanı ile üst kategori belirtilir.

Kategori görseli nasıl önceliklendirilir?

category_image özelliği önce kategorinin kendi görselini kontrol eder, yoksa o kategorideki ilk ürünün görselini döner (product_image).

Mobil ikonlar neden ayrı?

Mobil uygulamalarda daha küçük ve optimize edilmiş ikonlar gerektiği için mobile_icon ayrı bir alan olarak tutulur.

---

Kaynaklar

• Ürün Alanları
• Marka Alanları
• Serenay Yazılım Destek Sayfası

---

İletişim ve Destek

Herhangi bir sorunla karşılaşırsanız veya yardıma ihtiyaç duyarsanız, destek ekibimizle iletişime geçebilirsiniz.