Geliştirici Dokümantasyonu

Runevo Developer Marketplace, E-Ticaret ekosistemine özel dinamik bloklar ve temalar geliştirip satabileceğiniz bir platformdur. Platform, kullanıcıların sürükle-bırak yöntemiyle kendi mağazalarını oluşturduğu bir BlockBuilder mimarisi kullanır.

Blok Dosya Yapısı

Bir blok sisteme yüklenirken 5 temel dosyadan oluşur. Tüm bu dosyaları içeren bir klasörü upload edersiniz.

my-block/
├── config.json    → Blok meta verileri ve değişken tanımları (Zorunlu)
├── template.php   → PHP + HTML şablonu (Zorunlu)
├── style.css      → CSS stilleri (Zorunlu)
├── script.js      → JavaScript dosyası (Opsiyonel)
└── preview.png    → 400x300 Önizleme görseli (Zorunlu)

config.json Şeması

Bloğunuzun adını, kategorisini ve kullanıcının değiştirebileceği ayar değişkenlerini burada tanımlarsınız.

{
    "name": "Hero Section (Video)",
    "slug": "hero-video-v1",
    "category": "Ana Sayfa",
    "description": "Tam ekran video arkaplanlı karşılama alanı.",
    "variables": [
        {
            "key": "title",
            "label": "Ana Başlık",
            "type": "text",
            "default": "Hoş Geldiniz"
        },
        {
            "key": "bg_color",
            "label": "Arkaplan Rengi",
            "type": "color",
            "default": "#000000"
        }
    ]
}

Değişken Tipleri

Kullanıcı admin panelinde bloğu eklediğinde bu değişkenleri düzenleyebilir. template.php içinde bu değişkenleri doğrudan kullanabilirsiniz (Örn: $title).

Tip	Açıklama	Örnek Kullanım
text	Kısa metin girişi	<?= htmlspecialchars($title) ?>
textarea	Uzun metin	<?= nl2br(htmlspecialchars($desc)) ?>
image	Görsel URL seçici	<img src="<?= $image_url ?>">
color	Renk seçici (Hex)	style="color: <?= $bg_color ?>"

RunevoSDK Kullanımı

Ürünler, kategoriler ve mağaza ayarlarını çekmek için RunevoSDK sınıfını kullanın.

1. Ürünleri Çekmek

<?php
// Son eklenen 4 ürünü çek
$products = RunevoSDK::getProducts(4, 0, null, 'newest');

foreach ($products as $product) {
    // Ürün kartını sistemin varsayılan tasarımıyla render et
    echo RunevoSDK::renderProductCard($product);
}
?>

2. Kategorileri Çekmek

<?php
$categories = RunevoSDK::getCategories(10);
foreach ($categories as $cat) {
    echo "<a href='{$cat['url']}'>{$cat['name']}</a>";
}
?>

Yasaklı Fonksiyonlar (Blacklist)

Sistemin güvenliği için aşağıdaki fonksiyonlar engellenmiştir. Tespit edilirse dosya yüklemesi reddedilir.

• eval(), exec(), system(), shell_exec()
• file_get_contents() (URL ile), curl_exec()
• fopen(), fwrite(), file_put_contents()
• $pdo, getPanelDB(), getStoreDB() — Direkt veritabanı erişimi yok.
• $_GET, $_POST, $_SESSION — Güvenlik sebebiyle direkt input erişimi kapatılmıştır.

Komisyon Oranları

Marketplace üzerinde kademeli komisyon sistemi uygulanır. Satışlarınız arttıkça ödediğiniz komisyon oranı düşer.

Toplam Kazancınız	Kesilecek Komisyon	Size Kalan
0 ₺ — 20.000 ₺	%25	%75
20.000 ₺ — 100.000 ₺	%20	%80
100.000 ₺ ve Üzeri	%12	%88

Rozet Sistemi

Sistemde satış sayınıza göre (Blok bazlı) rozetler kazanırsınız. Eğer bir tema satarsanız ve tema 5 blok içeriyorsa, satış hanenize 5 blok eklenir.

Satış Sayısı	Rozet Adı
0 — 10	🌱 Yeni Geliştirici
10 — 50	🌿 Gelişen Geliştirici
50 — 100	📈 Yükselen Geliştirici
100 — 200	🔧 Usta Geliştirici
200 — 500	💎 Profesyonel Geliştirici
500 — 1.000	⭐ Yıldız Geliştirici
1.000+	🌟 Efsane Geliştirici