CR – IPRCT

# Celeb-Right — WordPress Tatil ve Sezon Banner Eklentisi

## Celeb-Right Nedir?

**Celeb-Right**, WordPress sitenize özel günler, resmi tatiller ve sezonlara göre otomatik banner, mesaj ve görsel efektler ekleyen profesyonel bir eklentidir. Yılbaşı kar yağışından 4 Temmuz bayrak animasyonlarına, Sonbahar yapraklarından Noel sezonu kutlamalarına kadar sitenizi her özel güne hazır hale getirir.

Eklenti, tarih aralıklarına göre otomatik çalışır; yönetim panelinden tamamen özelleştirilebilir ve kod bilgisi gerektirmez.

## Temel Özellikler

### Otomatik Tatil ve Sezon Bannerları
Belirlediğiniz tarih aralıklarında sitenizde otomatik olarak banner veya açılır pencere (modal) gösterilir. Her özel gün için ayrı mesaj, renk, arka plan ve efekt tanımlayabilirsiniz.

### Düşen Görsel Efektler
Sayfa üzerinde animasyonlu efektler oluşturur:

– **Kar (Snow)** — Yılbaşı ve Noel sezonu için
– **Yapraklar (Leaves)** — Sonbahar ve Şükran Günü sezonu için
– **Bayrak (Flag)** — Ulusal bayramlar için (varsayılan: ABD bayrağı)
– **Özel (Custom)** — Kendi SVG/PNG görsellerinizle özel animasyonlar

Birden fazla efekt grubunu aynı anda kullanabilirsiniz (örneğin hem bayrak hem yaprak birlikte).

### Üç Farklı Gösterim Konumu

**Üst (Top)**
Sayfanın en üstünde, yapışkan (sticky) banner
**Alt (Bottom)**
Sayfanın alt kısmında, footer üzerinde banner
**Modal**Tam ekran açılır pencere; kullanıcı kapatana kadar görünür

### Gelişmiş Tasarım Kontrolleri
Her tatil için ayrı ayrı ayarlanabilir:

– Arka plan rengi ve görseli (WordPress medya kütüphanesinden seçim)
– Arka plan tekrarı, konumu, boyutu ve şeffaflığı
– Banner yüksekliği ve sayfa içeriğiyle örtüşme (overlap) ayarı
– Yazı tipi ailesi, boyutu, stili (kalın/italik) ve rengi
– Metin yatay/dikey hizalama ve piksel bazlı konum kaydırma
– Görsel renk seçici (Coloris) ile kolay renk yönetimi

### Hazır Tatil Listesi (ABD Takvimi)

Tüm tatiller düzenlenebilir, silinebilir veya devre dışı bırakılabilir. Kendi özel günlerinizi de ekleyebilirsiniz (örneğin 23 Nisan, 29 Ekim, Ramazan Bayramı vb.).

### Varlık Kütüphanesi (Asset Library)
Kendi SVG veya PNG görsellerinizi yükleyip tatil efektlerinde kullanabilirsiniz. Özel bayraklar, simgeler, logolar veya dekoratif öğeler eklemek için idealdir.

### JSON İçe / Dışa Aktarma
Tüm ayarlarınızı tek tıkla JSON dosyası olarak dışa aktarın. Başka bir siteye aktarmak, yedek almak veya toplu düzenleme yapmak için içe aktarın.

### Hata Ayıklama (Debug) Modu
Belirli bir tarihi simüle ederek efektleri önceden test edebilirsiniz. Örneğin `2025-12-25` girerek Noel günü görünümünü bugün kontrol edebilirsiniz.

### Genel Ayarlar
– Eklentiyi tek tıkla açma/kapama
– Tüm tatiller için global efekt zorlama (tümüne kar, yaprak veya bayrak)
– Her banner altında görünen genel not alanı
– Önbellek uyumluluğu (WP Super Cache ile günlük otomatik temizleme)

## Teknik Bilgiler

## Tema Gereksinimi: `wp_body_open`

Üst konum (Top) banner ve Modal popup, WordPress’in `wp_body_open` kancasına bağlıdır. Temanız bu kancayı desteklemiyorsa bu iki konum **çalışmaz**. Alt konum (Bottom) banner `wp_footer` ile çalışmaya devam eder.

Temanızın `header.php` dosyasında `` etiketinden hemen sonra şu satır olmalıdır:

“`php
>

“`

Tema `wp_body_open` desteklemiyorsa `functions.php` dosyanıza şunu ekleyebilirsiniz:

“`php
if ( ! function_exists( ‘wp_body_open’ ) ) {
function wp_body_open() {
do_action( ‘wp_body_open’ );
}
}
“`

Ardından `header.php` içinde `` açılış etiketinin hemen altına `` ekleyin.

## Kurulum

Eklenti ZIP dosyasını indirin. WordPress yönetim panelinde **Eklentiler → Yeni Ekle → Eklenti Yükle** bölümünden ZIP dosyasını seçin ve yükleyin. Alternatif olarak `cr` klasörünü `wp-content/plugins/` dizinine FTP ile yükleyebilirsiniz. Ardından **Eklentiler** sayfasından **Celeb-Right** eklentisini etkinleştirin.

Kurulumdan sonra sol menüde **Celeb-Right** sekmesi görünür.

## Hızlı Başlangıç

Eklentiyi etkinleştirdikten sonra **Celeb-Right → Settings** sayfasına gidin. **Enable holiday banner** seçeneğini açın ve **Save Changes** ile kaydedin. Varsayılan ABD tatil takvimi otomatik olarak aktif olur.

Kendi özel gününüzü eklemek için tatil listesinin altındaki boş satıra etiket ve tarih aralığı girin (format: `MM-DD`, örn. `10-29`). Kaydettikten sonra **Edit** butonuyla mesaj, renk, efekt ve konum ayarlarını yapın.

## Kimler İçin Uygun?

– Kurumsal ve kamu kurumu web siteleri (resmi gün kutlamaları)
– Okul ve üniversite siteleri (sezonluk duyurular)
– E-ticaret siteleri (Noel, Black Friday, sezon kampanyaları)
– Blog ve haber siteleri (özel gün mesajları)
– ABD pazarına yönelik siteler (hazır tatil takvimi)

## Sürüm Notları (v4.0.0)

– Çoklu düşen efekt grubu desteği (kar + bayrak + özel varlık birlikte)
– Özel varlık kütüphanesi (Asset Library)
– Gelişmiş arka plan kontrolleri (şeffaflık, konum kaydırma, örtüşme)
– 3×3 metin hizalama sistemi
– JSON tam ayar içe/dışa aktarma (tatil listesi veya tam ayar objesi)
– Coloris renk seçici eklenti içine gömülü (harici CDN yok)
– Debug modu ile tarih simülasyonu
– Modern yönetim paneli arayüzü (modal düzenleyici, renk seçici)
– Yıl sonu tarih sarmalama desteği (ör. `12-20` → `01-05`)

## İndirme

**Celeb-Right v4.0.0** — WordPress Tatil Banner ve Efekt Eklentisi
Geliştirici: Ace Kupeli | Lisans: GPL2+