Katalog ve Ürün Sayfaları

public static function catalog_plans(int $categoryId, string $type, string $layout = 'grid'): array;

// $categoryId  ürünleri istenen kategori
// $type        ürün türü, yapılandırma adresinin kullandığı parçanın aynısı
// $layout      'grid' ya da 'rows'; dönen HER planın ŞEKLİNİ değiştirir

$plan = [
    'id'          => 18,                 // ürün id'si
    'title'       => 'Starter',
    'tagline'     => 'İlk siteniz için',
    'popular'     => true,               // ürünün kendi seçeneklerinden
    'in_stock'    => true,               // '' stok sınırsız demek, 0 tükendi demek
    'prices'      => [                   // YALNIZ gerçekten fiyatı olan döngüler
        'monthly' => 4.90,
        'annual'  => 49.00,
    ],
    'currency'    => 'USD',              // görüntü kodu, data-currency özniteliği için
    'currency_id' => 2,                  // görüntü para birimi id'si, biçimlendirici kullanır
    'link'        => '/configure/hosting/18',
    'features'    => ['10 GB disk', '1 alan adı'],
];

// $layout = 'rows' iken son anahtar yerine iki anahtar gelir:
//   'specs' => [['value' => '10 GB', 'label' => 'Disk'], ...]   kıyaslanabilir sütunlar
//   'chips' => ['Ücretsiz taşıma', ...]                         düz satırlar

public static function seed_plan_prices(array &$plans, string $cycle, bool $periodMode): void;

// $cycle       bu sayfanın varsayılan faturalama döngüsü
// $periodMode  true tam dönem toplamını basar, false aylık karşılığını basar
//
// Her plana iki anahtar ekler:
//   price_now  şablonun bastığı biçimlenmiş string
//   is_period  o string bir dönem toplamı mı ("/ay" son ekini o belirler)
//
// $cycle için fiyatı olmayan plan sıfır değil, price_now = '' alır.
// Aylık fiyatı olmayan plan, $periodMode false olsa bile dönem moduna zorlanır.

public static function plan_cycles(array $tabs): array;
// [['key' => 'monthly', 'label' => 'Aylık'], ['key' => 'annual', 'label' => 'Yıllık']]
// Yalnız sayfadaki en az bir planın gerçekten fiyatladığı döngüler. Sabit gösterim sırası.

public static function price_monthly_equivalent(): bool;
// $periodMode'un arkasındaki GENEL ayar. Kurulumun tema yapılandırmasında yaşar,
// temanızın kendi ayar şemasında DEĞİL, yani bir tema onu zorlayamaz.

// controllers/website/products.php, drilldown dalı

$plans = Products::catalog_plans($categoryId, $kind, $layout);

// Genel ayar, tersine çevrilmiş: aylık karşılık AÇIK ise dönem modu KAPALI.
$period_mode = !Theme::price_monthly_equivalent();

// Sayfanın varsayılan döngüsünde her plana price_now + is_period yazar.
Products::seed_plan_prices($plans, $default_cycle, $period_mode);

$this->addData("mode",           "drilldown");
$this->addData("plans",          $plans);
$this->addData("cards",          $cards);
$this->addData("layout",         $layout);
$this->addData("billing_cycles", Products::plan_cycles([['plans' => $plans]]));
$this->addData("default_cycle",  $default_cycle);
$this->addData("price_mode",     $period_mode ? "period" : "monthly");

{* Bölüm sarmalayıcısı, fiyat script'inin okuduğu sayfa düzeyi bağlamı taşır. *}
<section data-billing="{$default_cycle}" data-currency="{$selected_currency_code}" data-price-mode="{$price_mode}">

    {if $layout == 'rows'}
        {include file='components/plan-rows.tpl' plans=$plans billing_cycles=$billing_cycles}
    {else}
        {include file='components/plan-grid.tpl' plans=$plans billing_cycles=$billing_cycles}
    {/if}

</section>

{* components/plan-grid.tpl, tek bir kartın fiyat bandı *}
<div class="card plan-card{if !$plan.in_stock} plan-soldout{/if}"
     data-currency="{$plan.currency}"
     data-monthly="{$plan.prices.monthly|default:''}"
     data-annual="{$plan.prices.annual|default:''}"
     data-biennial="{$plan.prices.biennial|default:''}">

  <div class="plan-price price-band">
    {* Script doldurur. Sunucuda bilerek boş. *}
    <del class="price-was num-tabular d-none" data-role="price-was"></del>
    <span class="badge d-none" data-role="savings"></span>

    {* Sunucu basar ki ilk boyama hiç boş kalmasın, sonra script yüklemede
       AYNI string ile üzerine yazar. *}
    <span class="price-now num-tabular" data-role="price-now">{$plan.price_now|default:''}</span>
    <span class="{if $plan.is_period}d-none{/if}" data-role="price-suffix">{lang key='website/products/category-per-month'}</span>

    {* Döngü başına bir satır; toplamlar script'in işi. *}
    {foreach $billing_cycles as $c}
      <tr data-cycle="{$c.key}">
        <td>{$c.label}</td>
        <td data-role="cycle-total"></td>
        <td data-role="cycle-mo"></td>
      </tr>
    {/foreach}
  </div>
</div>