PX

PowerX - Hata Düzeltme ve İyileştirme Aksiyon Planı

Statik Bağlantı ve Panel Denetim Raporu Sonuçlarına Göre Sıralı Eylem Listesi

Versiyon: 0.0.1
Tarih: 10.09.2026 03:00
Format: List / Table (Light Standard)
18
Toplam Eylem Maddesi
14
Düzeltme Bekleyen
4
Düzeltilen & Doğrulanan
5 Aşama
Mantıksal Parça / Dağıtım Sayısı

📌 Çalışma Prensibi & Parçalı Dağıtım Stratejisi

Hatalar toplu olarak değil; Aşama 1'den Aşama 5'e kadar mantıklı gruplar halinde tek tek çözülecektir. Her bir aşama tamamlandığında PowerX-Deployer/deploy.php çalıştırılarak merkezi sunucuya ve canlı test sitelerine otomatik dağıtılacak, aynı zamanda her adımda güvenli zip yedeklemesi oluşturulacaktır.

Aşama 1

Aşama 1: Kritik Header Overlap ve Elementor Özel Şablon Seçicileri

Ön yüzde çalışmayan Header Overlap anahtarının düzeltilmesi ve 404, Arama, Arşiv ve Single şablonları için Tema Ayarları paneline eksik ayarların ve Elementor şablon dropdown kontrollerinin eklenmesi.

Madde Sayısı: 4
Sıra / No Hata Adı & İlgili Dosya Hata Açıklaması & Belirtisi Nasıl Düzeltilecek? (Çözüm Yolu) Durum
Hata 1
Header Overlap (Üst Bilgi Bindirme) Anahtar Uyuşmazlığı
PowerX-Tema/PowerX/inc/header-functions.php & class-powerx-theme-settings.php
Panelde enable_header_overlap olarak kayıtlı, fakat frontend şablonunda powerx_get_setting('header_overlap') çağrılıyor. Bu nedenle panelden aç/kapa yapılsa da ön yüzde header asla örtüşmüyor.
🛠️ Çözüm Adımı:
inc/header-functions.php içinde enable_header_overlap anahtarı kontrol edilecek. Geriye dönük tam uyumluluk için hem enable_header_overlap hem header_overlap desteklenecektir.
✅ Düzeltildi
Hata 2
404 Sayfası Elementor Şablon Seçicisi Eksikliği
PowerX-Tema/PowerX/404.php & class-powerx-theme-settings.php
404.php şablonunda powerx_get_setting('template_404') aranıyor fakat panel varsayılanlarında ve ayar sayfalarında 404 şablonu seçtirecek bir alan yok.
🛠️ Çözüm Adımı:
get_defaults() içine template_404 => '' eklendi, Panel 'Genel' sekmesine Elementor Şablonu seçici dropdown alanı yerleştirildi.
✅ Düzeltildi
Hata 3
Arama Sonuçları (Search) Elementor Şablon Seçicisi Eksikliği
PowerX-Tema/PowerX/search.php & class-powerx-theme-settings.php
search.php şablonunda powerx_get_setting('search_template_id') aranıyor fakat panelde tanımlı değil.
🛠️ Çözüm Adımı:
get_defaults() içine search_template_id => '' eklendi, Panel 'Blog/Arama' sekmesine Elementor şablon seçici dropdown kontrolü eklendi.
✅ Düzeltildi
Hata 4
Ürün, Koleksiyon & Marka Tekil/Arşiv Elementor Şablon Seçicileri
PowerX-Tema/PowerX/single.php, single-product.php, archive.php & class-powerx-theme-settings.php
Şablonlarda product_single_template_id, product_archive_template_id, brand_single_template_id, brand_archive_template_id çağrılıyor fakat panelde kayıtlı değiller.
🛠️ Çözüm Adımı:
Bu şablon anahtarları get_defaults() ve sanitization içine eklendi, Panel 'Markalar' ve 'WooCommerce' sekmelerine Elementor şablon seçicileri yerleştirildi.
✅ Düzeltildi
Aşama 2

Aşama 2: Elementor Standart Widget Öksüz Kontrolleri

Elementor panelinde kullanıcıya gösterilen fakat koda bağlanmamış öksüz switch ve kontrollerin işler hale getirilmesi.

Madde Sayısı: 3
Sıra / No Hata Adı & İlgili Dosya Hata Açıklaması & Belirtisi Nasıl Düzeltilecek? (Çözüm Yolu) Durum
Hata 5
Mega Menu Widget 'dropdown_divider' (Öğe Ayracı) Öksüz Kontrolü
PowerX-Core-Eklentisi/powerx-core/inc/widgets/standard/class-widget-mega-menu.php
Panelde 'Dividers Between Items' (dropdown_divider) switcher'ı var ancak render() metodunda sorgulanmıyor ve CSS seçicisi yok; açılsa da menüde ayraç çizgisi oluşmuyor.
🛠️ Çözüm Adımı:
dropdown_divider kontrolüne render() metodu içinde menü konteynerine has-dropdown-dividers CSS sınıfı bağlanacak ve mega-menu.css içine alt kenarlık stili eklenecek.
⏳ Bekliyor
Hata 6
Product Categories Widget 'show_border' Öksüz Kontrolü
PowerX-Core-Eklentisi/powerx-core/inc/widgets/standard/class-widget-product-categories.php
Panelde 'Card Border & Outline' (show_border) switcher'ı var ancak render() metodunda kontrol edilmiyor; kart kenarlığı açılıp kapatılamıyor.
🛠️ Çözüm Adımı:
render() metodunda if ('yes' === $settings['show_border']) kontrolü eklenerek kategori kartına has-card-border sınıfı eklenecek veya doğrudan border seçicisi atanacak.
⏳ Bekliyor
Hata 7
Slider Widget Varsayılan Delay ve Speed Ayarlarının Eksikliği
PowerX-Core-Eklentisi/powerx-core/inc/widgets/standard/class-widget-slider.php
Tema ayarlarında slider_default_delay (5000) ve slider_default_speed (800) kayıtlı ancak widget bu global değerleri varsayılan olarak okumuyor.
🛠️ Çözüm Adımı:
Slider widget'ı kayıt fonksiyonunda default delay ve speed için powerx_get_setting() üzerinden global tema ayarları varsayılan olarak atanacak.
⏳ Bekliyor
Aşama 3

Aşama 3: CPT (Özel Gönderi Tipleri) Dinamik Slug ve Etiket Bağlantıları

Tema Ayarlarında kullanıcının değiştirebildiği CPT ve Taksonomi URL slug'ları ile tekil/çoğul etiketlerinin ilgili CPT sınıflarına dinamik olarak bağlanması.

Madde Sayısı: 4
Sıra / No Hata Adı & İlgili Dosya Hata Açıklaması & Belirtisi Nasıl Düzeltilecek? (Çözüm Yolu) Durum
Hata 8
Marka (Brand) CPT ve Taksonomi Statik Kayıt Hatası
PowerX-Core-Eklentisi/powerx-core/inc/cpt/class-powerx-cpt-brand.php
Paneldeki slug_brand, slug_brand_cat, label_brand_singular, label_brand_plural ayarları CPT sınıfında statik yazıldığı için panelden değiştirilse de URL ve menü etiketleri güncellenmiyor.
🛠️ Çözüm Adımı:
register_post_type ve register_taxonomy çağrılarında powerx_get_setting() üzerinden dinamik etiket ve rewrite slug argümanları geçirilecek.
⏳ Bekliyor
Hata 9
Koleksiyon (Collection) CPT ve Taksonomi Statik Kayıt Hatası
PowerX-Core-Eklentisi/powerx-core/inc/cpt/class-powerx-cpt-collection.php
Paneldeki slug_collection, slug_collection_cat, label_collection_singular, label_collection_plural ayarları CPT kaydına aktarılmıyor.
🛠️ Çözüm Adımı:
CPT kayıt fonksiyonunda powerx_get_setting() ile rewrite slug ve label parametreleri dinamikleştirilecek.
⏳ Bekliyor
Hata 10
Hizmetler (Service) CPT ve Taksonomi Statik Kayıt Hatası
PowerX-Core-Eklentisi/powerx-core/inc/cpt/class-powerx-cpt-service.php
Paneldeki slug_service, slug_service_cat, label_service_singular, label_service_plural ayarları CPT sınıfında okunmuyor.
🛠️ Çözüm Adımı:
CPT kayıt argümanları powerx_get_setting() ile dinamik hale getirilecek.
⏳ Bekliyor
Hata 11
Slider CPT Statik Slug ve Etiket Hatası
PowerX-Core-Eklentisi/powerx-core/inc/cpt/class-powerx-cpt-slider.php
Paneldeki slug_slide, slug_slider_group, label_slide_singular, label_slide_plural ayarları CPT sınıfında statik kalmış.
🛠️ Çözüm Adımı:
Slider CPT ve taksonomi kayıt argümanları powerx_get_setting() fonksiyonuna bağlanacak.
⏳ Bekliyor
Aşama 4

Aşama 4: Arşiv & Şablon Tüketicileri (Card Badges, Buttons ve Sayfalama)

content-powerx_product.php, content-category.php ve archive.php içinde çağrılan fakat panel get_defaults listesinde bulunmayan hayalet ayarların panele tescil edilmesi.

Madde Sayısı: 4
Sıra / No Hata Adı & İlgili Dosya Hata Açıklaması & Belirtisi Nasıl Düzeltilecek? (Çözüm Yolu) Durum
Hata 12
Koleksiyon ve Ürün Kartı Buton / Rozet / Açıklama Hayalet Ayarları
PowerX-Tema/PowerX/template-parts/content-powerx_product.php & class-powerx-theme-settings.php
Şablonda collection_item_show_badge, collection_item_show_btn, collection_item_show_desc, collection_btn_text, product_item_show_badge vb. çağrılıyor fakat get_defaults() içinde yok.
🛠️ Çözüm Adımı:
Tüm bu ayarlar get_defaults() içine mantıklı varsayılanlarla ('yes', 'İncele', '3' vb.) eklenecek ve panelde ilgili sekmelere switch/text alanları açılacak.
⏳ Bekliyor
Hata 13
Kategori Kartı Buton, Sayaç ve Satır Sınırı Hayalet Ayarları
PowerX-Tema/PowerX/template-parts/content-category.php & class-powerx-theme-settings.php
Şablonda product_cat_show_btn, product_cat_show_count, product_cat_count_text, product_cat_desc_lines çağrılıyor fakat panelde kayıtlı değil.
🛠️ Çözüm Adımı:
Bu anahtarlar get_defaults() listesine eklenecek ve panel Katalog sekmesinde kontrol kutuları oluşturulacak.
⏳ Bekliyor
Hata 14
Arşiv Düzeni (Layout) Hayalet Ayarları
PowerX-Tema/PowerX/archive.php & class-powerx-theme-settings.php
archive.php şablonunda collection_archive_layout, brand_archive_layout, service_archive_layout, product_archive_layout, products_archive_display çağrılıyor fakat panelde yok.
🛠️ Çözüm Adımı:
get_defaults() içine varsayılan yerleşimler ('grid', 'masonry' vb.) tanımlanacak ve panelde arşiv yerleşim seçicileri açılacak.
⏳ Bekliyor
Hata 15
Sayfa Başına Gönderi Adetleri (pre_get_posts) Bağlantı Eksikliği
PowerX-Tema/PowerX/inc/template-tags.php veya inc/query-functions.php
Panelde services_per_page (9), brands_per_page (12), collections_per_page (12) ayarları var fakat WP ana sorgusuna (pre_get_posts) bağlanmadığı için varsayılan 10 gönderi listeleniyor.
🛠️ Çözüm Adımı:
Temaya pre_get_posts kancası eklenerek ilgili CPT arşiv sorgularında paneldeki sayfa başı adet değeri posts_per_page parametresine atanacak.
⏳ Bekliyor
Aşama 5

Aşama 5: Kenar Çubuğu (Sidebar) Hayalet Ayarları & CSS Değişkeni Temizliği

Tekil sayfa, kategori ve WooCommerce kenar çubuğu ayarlarının panele bağlanması ve boşta kalan CSS değişkenlerinin optimize edilmesi.

Madde Sayısı: 3
Sıra / No Hata Adı & İlgili Dosya Hata Açıklaması & Belirtisi Nasıl Düzeltilecek? (Çözüm Yolu) Durum
Hata 16
Sayfa ve Ürün Tekil Kenar Çubuğu Hayalet Ayarları
PowerX-Tema/PowerX/inc/sidebars.php & class-powerx-theme-settings.php
sidebars.php dosyasında page_single_sidebar, page_single_sidebar_pos, page_single_sidebar_width, product_single_sidebar aranıyor fakat panelde tanımlı değil.
🛠️ Çözüm Adımı:
get_defaults() içine bu anahtarlar varsayılan değerleriyle ('none', 'right', '300px') eklenecek ve panel 'Yerleşim / Kenar Çubuğu' sekmesinde kontrolleri açılacak.
⏳ Bekliyor
Hata 17
WooCommerce Mağaza ve Tekil Ürün Kenar Çubuğu Hayalet Ayarları
PowerX-Tema/PowerX/sidebar.php, inc/sidebars.php & class-powerx-theme-settings.php
woo_shop_sidebar_id, woo_shop_sidebar_pos, woo_shop_sidebar_width, woo_single_sidebar, woo_single_sidebar_id ayarları kodda çağrılıyor fakat panelde kayıtlı değil.
🛠️ Çözüm Adımı:
get_defaults() içine WooCommerce kenar çubuğu konfigürasyonları eklenecek ve panel 'Mağaza' sekmesine kontrolleri bağlanacak.
⏳ Bekliyor
Hata 18
Kullanılmayan / Boşta Kalan CSS Değişkeninin İncelenmesi
PowerX-Core-Eklentisi/powerx-core/inc/admin/class-powerx-theme-settings.php
generate_frontend_css() içinde üretilen bazı CSS değişkenleri hiçbir CSS dosyasında var() olarak çağrılmıyor.
🛠️ Çözüm Adımı:
CSS değişkeni ya ilgili bileşenin style.css kuralına bağlanacak ya da gereksizse :root çıktısından subtractive olarak kaldırılacak.
⏳ Bekliyor