RbnAdmin/Views — 28 panel görünümü

Doğrulanan kod tabanı: d49b4413 (dal feat/fw-license-master) · Tarih: 2026-10-05 · Yayın: 0.9.7 = bu commit + sonrası; belge yalnız doğrulama anındaki kodu anlatır
Kaynak klasör: Bundles/RbnSuite/RbnAdmin/Views/ — 28 *.php
(Contact 2 · Cronlogs 2 · Hostmailhub 3 · Notification 2 · Seo 1 · Setting 8 ·
User 5 · Webtraffic 5)
Envanter: 28 dosyanın 28'i aşağıda anlatıldı.
Üst belge: README.md

1. Ne işe yarar, kimler kullanır

Bunlar panelin son katmanıdır: kontrolörün render() çağrısıyla bulunan,
ViewResolver'ın çözdüğü PHP şablonlarıdır. Veri hazırlama tamamen kontrolörde
yapılır; görünüm yalnız bastırır.

Panel görünümlerinin yerleşim kafesi iki yerdedir:

RbnAdminController::renderDashboard() birincisini değil ikincisini render eder:
render('RbnAdmin/dashboard', …) → Resources/Views/RbnAdmin/dashboard.rbn.php
(RbnAdminController.php:149). Bu 9 dosya bu görevin kapsamı dışıdır
(Resources/ ayrı görev; bkz. docs/README.md §2.2).

2. Uzantı ve isimlendirme

ViewResolver iki uzantıyı da kabul eder: $extensions = ['.php', '.rbn.php']
(Core/Render/Resolvers/ViewResolver.php:43). .rbn.php standarttır ve
ViewProvider bu uzantıya özel davranış uygular
(Core/Render/Providers/UI/ViewProvider.php:59).

Ölçülen istisna: Views/Hostmailhub/index.php düz .php'dir; 28 dosyanın
27'si .rbn.php'dir. Çalışır (çözücü ikisini de kabul eder) ama konvansiyon dışıdır.

3. Dosya envanteri (28 dosya)

3.1 Contact/ — 2

3.2 Cronlogs/ — 2

view.rbn.php iki farklı kayıt şeklini basar: DB kaydı (tek satır, level
INFO/ERROR'a çevrilmiş — :113-123) ve dosya (.jsonl satırları, timestamp
alanına göre sıralanmış — :145-159). Görünüm bu iki şekli logs dizisinde
aynı anahtarlarla taşıyacağı için ayrımı logId tipinden yapar.

3.3 Hostmailhub/ — 3

3.4 Notification/ — 2

3.5 Seo/ — 1

3.6 Setting/ — 8

tasks.rbn.php ile Setting/cron.rbn.php aynı veriyi gösterir (ikisi de
master.cronJob + getScheduleSummaryData()), yalnız cron.rbn.php hafta
günlerini de (daysOfWeek) ve tasks.rbn.php hours_string'i ayrıca üretir
(Controllers/BotSettingsController.php:90). İki ekran kasıtalı olarak
ayrılmıştır; biri kaldırılırsa diğeri etkilenmez.

3.7 User/ — 5

3.8 Webtraffic/ — 5

google_map.rbn.php en ağır görünümdür (481 satır): Türkiye illerini
DataHelper::get('tr-locations') + TextHelper::turkishSlug() ile GA4 şehir
adlarına eşler (Controllers/WebtrafficController.php:363).

4. Veri akışı

Kontrolör                              →  View::render()          →  dosya
------------------------------------------------------------------------------------
AdminSettingsController::index()   :78 → render('Setting/index')     → Setting/index.rbn.php
CronLogsController::cron()        :35 → render('Setting/cron')       → Setting/cron.rbn.php
BotSettingsController::aiUsage() :246 → render('Setting/ai_usage')   → Setting/ai_usage.rbn.php
HostmailhubController::index()    :66 → render('Hostmailhub/index')  → Hostmailhub/index.php
SeoReportController::index()      :27 → render('Seo/report')         → Seo/report.rbn.php
RbnAdminController::adminIndex() :149 → render('RbnAdmin/dashboard') → Resources/Views/RbnAdmin/
                                                                     dashboard.rbn.php

View::render($view, $data, $type) üçüncü argümanı context'tir
(panel/auth/frontend); hangi RenderProvider'ın çalışacağını belirler
(Core/Base/Web/Traits/Controller/ViewTrait.php:83).

5. Tuzaklar

1. Beklenen değişken adı denetlenmez. render() çıktısındaki eksik bir
   anahtar PHP uyarısı (Undefined array key) ve sessiz boş render verir;
   istisna fırlatılmaz. report.rbn.php bunu kendi içinde koruyor:
   $totalHits > 0 ? round(…) : 0 (:1-2). Yeni bir görünüme veri eklerken
   kontrolörün değişkeni gönderdiğinden emin olmak gerekir.

2. ajax => true bayrağı bazı görünümlerde eksik. ActionControllerTrait::modal()
   her modal render'da 'ajax' => true enjekte eder (:291), ama RbnAdmin'ın
   kendi modal() yazan iki görünümü bu bayrağı elle koymak zorundadır:
   BotSettingsController::modal() (:177,184), HostmailhubController modalı.
   Bayrak, görünümün partial olarak mı tam sayfa mı basılacağını belirler.

3. Hostmailhub/index.php uzantısı. §2.

4. Setting/tasks.rbn.php ve Setting/cron.rbn.php aynı veriyi iki kez
   sorgulatır. tasks() görevi, proje için iş bulunamazsa tüm işleri de
   çeker (Controllers/BotSettingsController.php:89); cron() yalnız proyeye
   ait işleri çeker. İki ekran arasındaki fark bu yedek sorgudur.

5. ra-stat-* sınıf ön eki bir konvansiyondur, kod değil. Setting/index,
   User/index, User/activities, Setting/botdash görünümlerinde
   <!-- … Terracotta ra-stat-* Standardı … --> yorumları vardır. Panelin görsel
   kimliği PanelIdentity::THEME_COLOR = '#c56a3c' ile bu sınıflara bağlıdır; tema
   değişikliği (saveTheme()) bu sınıflara da yansımalıdır.

6. report.rbn.php yüzde hesabını kendisi yapar. $organicPercent /
   $botPercent kontrolörde değil görünümde hesaplanır (:1-2); WebtrafficController::report()
   yalnız ham botStats sayılarını verir. Aynı hesap TrafficAnalysisTrait::computeSummary()
   içinde yeniden yapılır (TrafficAnalysisTrait.php:225) — iki kaynak,
   aynı mantık.

7. Sekme sayfaları iki farklı isim kullanır. CronLogsController::index()
   görünüme files ve dbLogs gönderir ve yalnız aktif sekmeninkini
   doldurur (Controllers/CronLogsController.php:89); diğer anahtar boş dizi olur.

6. Örnek (gerçek koddan)

Panel iskeleti bu klasörde değil, Resources altında — dashboard render çağrısı:

// Bundles/RbnSuite/RbnAdmin/Controllers/RbnAdminController.php:147-158
return $this->render('RbnAdmin/dashboard', array_merge([
    'panel'            => $panel,
    'module'           => null,          // proje modülü zorunlu değil
    'groupProjects'    => $groupProjects,
    'projectKey'       => $projectKey,
    'activeProjectName'=> $activeProjectName,
    'projectDomain'    => $projectDomain,
    'botActive'        => $botActive,
    'aiReport'         => $aiReport
], $data));

7. İlgili belgeler

• RbnAdmin README · Controllers.md · Models.md · Providers.md
• kavramlar/05-asset-sistemi — görünüm/asset çözümleme konvansiyonları
• Core/Render — ViewResolver, ViewProvider (⏳ ayrı görev)
• Resources/README — panel iskeleti (Resources görevi)