Kodunuzun bozulmasının nedeni temel bir tipografi çakışmasıdır. AI araçları ve kelime işlemciler genellikle "akıllı tırnaklar" (kıvrımlı tırnaklar gibi “ ve ”). WordPress shortcode'ları ve temel programlama dilleri kesinlikle "düz tırnaklar" (gibi " ve '). Gutenberg kıvrımlı tırnakları bir shortcode parantezi içinde gördüğünde, bunu kod olarak ayrıştıramaz ve işleme bozulur.

Ayrıca, kopyala-yapıştır işleminiz belgelerdeki tabloları tamamen bozarak okunamaz metin bloklarına dönüştürdü. Ham metni körü körüne kopyala-yapıştır yapmak yapısal veriyi bozar.

Metninizi temizledim. Tüm tipografiyi düz tırnaklara çevirdim, shortcode'larınızı Gutenberg'in çalıştırmaya çalışmayacağı şekilde kod formatına aldım ve bozulmuş tablolarınızı uygun Markdown'a dönüştürdüm. Bunu doğrudan Gutenberg'e yapıştırırsanız, doğru başlıklar, tablolar ve kod blokları otomatik olarak oluşturulmalıdır.

İşte yapısal olarak sağlam versiyonu:

---

TruePaws — Tam Kullanıcı Kılavuzu

TruePaws Nedir?

TruePaws, WordPress siteniz içinde çalışan bir kennel yönetim sistemidir. Profesyonel yetiştiricilerin hayvanlarını yönetmelerine, üreme ve gebelikleri takip etmelerine, alıcı iletişimlerini yönetmelerine, resmi belgeler oluşturmalarına (soy ağacı sertifikaları ve devir paketleri gibi) ve hatta mevcut yavrularını web sitelerinde sergilemelerine yardımcı olur.

Bölüm 1: Ön Koşullar (Kurulumdan Önce İhtiyacınız Olanlar)

1. Bir WordPress Web Sitesi

• Kendi barındırma hizmetinize kurduğunuz bir WordPress sitesine ihtiyacınız var (ücretsiz WordPress.com blogu değil).
• WordPress sürüm 5.0 veya daha yenisi gereklidir.

2. Hosting Gereksinimleri

• PHP 7.4 veya daha yenisi (çoğu modern barındırma hizmeti PHP 8.0+ sağlar).
• MySQL veritabanı (tüm WordPress barındırma hizmetlerinde standarttır).
• WordPress REST API etkin olmalıdır (varsayılan olarak etkindir — yalnızca birisi bilerek kapatmışsa devre dışıdır).

3. İsteğe Bağlı (ancak Önerilen)

• AI destekli özellikleri (bakım tavsiyesi, sağlık uyarıları, pazarlama biyografisi oluşturma) kullanmak istiyorsanız bir Google Gemini API anahtarı gereklidir. Bunu Google AI Studio'dan ücretsiz alabilirsiniz.
• Harici hizmetlere otomatik bildirimler göndermek istiyorsanız bir Zapier veya Make hesabı gereklidir.

Bölüm 2: Eklentiyi Kurma

Adım 1 – Eklentiyi Yükle

1. WordPress yönetici paneline giriş yapın (genellikle yourwebsite.com/wp-admin).
2. Sol kenar çubuğunda, Eklentiler → Yeni Ekle.
3. Üstteki Eklenti Yükle düğmesine tıklayın.
4. Tıkla Dosya Seç ve truepaws.zip seçin.
5. Tıkla Şimdi Yükle ve bitmesini bekleyin.

Adım 2 – Eklentiyi Etkinleştir

1. Yükleme tamamlandıktan sonra, Eklentiyi Etkinleştir düğmesine tıklayın.
2. Eklenti, ihtiyaç duyduğu tüm veritabanı tablolarını otomatik olarak oluşturacaktır.
3. WordPress kenar çubuğunuzda yeni bir TruePaws menü öğesi göreceksiniz.

Bölüm 3: İlk Kurulum (Önce Bunu Yapın!)

Etkinleştirdikten sonra, şuraya gidin: TruePaws → Ayarlar WordPress kenar çubuğunuzda. Üst kısımda birkaç sekme göreceksiniz. Her birini tamamlayın.

Sekme 1: Genel Ayarlar

Ayarlar	Ne Yapar	Örnek
Varsayılan Tür	Esas olarak yetiştirdiğiniz hayvan türü. Seçenekler: Köpek, Kedi, At, Tavşan, Gine Domuzu, Feret, Kuş.	Köpek
Yetiştirici Öneki	Yavru köpeklerin/kedilerin otomatik isimlendirilmesinde kullanılan kısa bir kod (maksimum 5 karakter).	TP
Gebelik Süresi — Köpekler	Bir köpek gebeliğinin kaç gün sürdüğü. Varsayılan 63'tür. Sadece farklı bir bilginiz varsa değiştirin.	63
Gebelik Süresi — Kediler	Bir kedi gebeliğinin kaç gün sürdüğü. Varsayılan 65'tir.	65
Beslenme Talimatları	Yeni alıcılara verdiğiniz devir belgelerinde görünecek metin. Hayvanın ne yediğini, ne sıklıkla yediğini ve özel talimatları yazın.	"Günde 3 kez Royal Canin yavru maması ile besleyin…"
Gemini API Anahtarı	AI özelliklerini etkinleştirmek için Google Gemini API anahtarınızı buraya yapıştırın. AI özelliklerini istemiyorsanız boş bırakın.	(anahtarınız)
Webhook URL	Otomasyon için Zapier veya Make kullanıyorsanız, webhook URL'sini buraya yapıştırın. Aksi takdirde boş bırakın.	(webhook URL'niz)

Tıkla Ayarları Kaydet bitince.

Sekme 2: Yetiştirici Bilgileri

Profesyonel bilgilerinizi doldurun. Bu bilgiler oluşturulan PDF'lerde (soy sertifikaları, devir paketleri) görünür.

Alan	Ne Girilmeli
Yetiştirici Adı	Yetiştirici olarak tam adınız
İşletme Adı	Üretim çiftliği veya kedi evinizin adı
Lisans Numarası	Üretim lisans numaranız (varsa)
Telefon	İş telefon numaranız
E-posta	İş e-posta adresiniz

Tıkla Ayarları Kaydet bitince.

Sekme 3: Irklar

Bu, eklenti genelinde açılır menülerde kullanılabilen ırkların listesini yönettiğiniz yerdir. TruePaws, 20 yaygın köpek ırkı ve 20 yaygın kedi ırkı ile önceden yüklenmiş olarak gelir.

• Bir ırk eklemek için: Metin kutusuna ırk adını yazın ve Irk Ekle.
• Bir ırkı kaldırmak için: Listedeki herhangi bir ırkın yanındaki silme düğmesine tıklayın.

İpucu: Şu anda çalıştığınız tüm ırkları ekleyin. Daha sonra her zaman ekleyebilirsiniz.

Sekme 4: İletişim

Posta adresinizi ve iletişim sayfası URL'sini doldurun. Bu, halka açık özellikler ve kısa kodlar için kullanılır.

Alan	Ne Girilmeli
Adres	Üretim çiftliğinizin adresi
Şehir	Şehir
Eyalet/İl	Eyalet veya il
Posta Kodu	Posta kodu
Ülke	Ülke
İletişim / Soru URL'si	Web sitenizin iletişim sayfasının URL'si ("Yetiştiriciyle İletişime Geç" butonlarında varsayılan bağlantı olarak kullanılır)

Tıkla Ayarları Kaydet bitince.

Sekme 5: Satış Raporları

Bu sekme salt okunurdur — satış kaydı yapmaya başladığınızda satış istatistiklerinizi gösterir. Şunları göreceksiniz:

• Toplam Kazanılan Gelir
• Toplam Satış Sayısı
• Ortalama Satış Fiyatı
• Aylık detaylı tablo
• En İyi Alıcılar Tablosu

Bölüm 4: Kontrol Paneli

Kenar çubuğunda TruePaws'a tıkladığınızda, Kontrol Panelinize ulaşırsınız. Burası ana merkezinizdir. İşte görecekleriniz:

İstatistik Kartları

• Toplam Hayvan Sayısı — sisteminizdeki hayvan sayısı
• Aktif Yavrular — şu anda takip edilen gebelikler
• İletişimler — toplam alıcılar ve bekleme listesi girişleri
• Yaklaşan Etkinlikler — yakında gerçekleşecek etkinlikler (aşılar, doğum tarihleri vb.)

Hızlı Eylemler

• Hayvan Ekle — yeni hayvan formuna doğrudan git
• Çiftleşme Kaydı — yeni bir çiftleşmeyi kaydet
• İletişim Ekle — yeni bir alıcı veya bekleme listesi girişi ekle

Başlangıç Kontrol Listesi

• İlk kurulum sürecinde size rehberlik eden yardımcı bir kontrol listesi.

Son Etkinlikler

• Tüm hayvanlarınızdaki en son etkinliklerin zaman çizelgesi (aşılar, veteriner ziyaretleri, kilo kontrolleri vb.).

Grafikler

• Irk Dağılımı — her bir ırktan kaç hayvanınız olduğunu gösteren bir halka grafik.
• Satış Genel Bakışı — aylık geliri gösteren bir çubuk grafik.

Aktivite Isı Haritası

• Geçen yıl boyunca kennel'inizin her gün ne kadar aktif olduğunu gösteren GitHub tarzı bir takvim ısı haritası. Daha koyu kareler = o gün daha fazla etkinlik kaydedildi.

Bölüm 5: Hayvan Ekleme ve Yönetme

Yeni Bir Hayvan Nasıl Eklenir

1. Git TruePaws → Hayvanlar (veya Panoda "Hayvan Ekle"ye tıklayın).
2. Üstteki Yeni Hayvan Ekle düğmesine tıklayın.
3. Formu doldurun:

Alan	Gerekli mi?	Açıklama
Ad	Evet	Hayvanın kayıtlı/resmi adı
Evdeki Adı	Hayır	Evde ona gerçekte verdiğiniz ad
Kayıt Numarası	Hayır	Irk kayıt kuruluşunuzdan alınan resmi kayıt numarası
Mikroçip Kimliği	Hayır	Mikroçip numarası (benzersiz olmalı)
Irk	Hayır	Irk listenizden seçin
Cinsiyet	Evet	Erkek veya Dişi
Baba	Hayır	Sisteminizdeki mevcut erkek hayvanlardan seçin
Anne	Hayır	Sisteminizdeki mevcut dişi hayvanlardan seçin
Doğum Tarihi	Hayır	Hayvanın doğduğu tarih
Durum	Hayır	Aktif, Emekli, Satıldı, Vefat etti veya Ortak Sahipli (varsayılan Aktif)
Renk/İşaretler	Hayır	Hayvanın görünümünü tanımlayın
Açıklama	Hayır	Hayvan hakkında ek notlar
Öne Çıkan Görsel	Hayır	WordPress Medya Kütüphanesini açmak ve bir fotoğraf seçmek için tıklayın

4. Tıkla Hayvanı Kaydet.

İlk kurulum için ipucu: Önce yetişkin üreme hayvanlarınızı (baba ve anne) ekleyerek başlayın. Böylece, daha genç hayvanlar veya yavrular eklediğinizde, ebeveynlerini açılır menülerden seçebilirsiniz.

Hayvan Profil Sayfası

Kaydettikten sonra, herhangi bir hayvanın adına tıklayarak profil sayfasını görüntüleyebilirsiniz. Bu, eklentideki en zengin özellikli sayfadır. İşte yapabilecekleriniz:

Bilgileri Görüntüle

• Girdiğiniz tüm detayları ve bir durum rozetini görün (örneğin, yeşil "Aktif", mavi "Satıldı").
• Öne çıkan görsel ön planda gösterilir, fotoğraf yüklenmediyse bir siluet kullanılır.

Fotoğraf Galerisi

• "Fotoğraf Ekle"ye tıklayarak birden fazla fotoğraf yükleyin.
• Fotoğrafları yeniden sıralamak için sürükleyip bırakın.
• Öne çıkan görsel olarak ayarlamak için bir fotoğrafa tıklayın.
• Artık ihtiyacınız olmayan fotoğrafları silin.

Zaman Çizelgesi ve Etkinlikler

Zaman çizelgesi, bu hayvana olan her şeyin kronolojik bir geçmişini gösterir. Yeni bir etkinlik eklemek için:

1. Üstteki Etkinlik Ekle düğmesine tıklayın.
2. Etkinlik türünü seçin: Doğum, Aşı, Kızgınlık, Çiftleşme, Doğum, Kilo, Veteriner Ziyareti veya Not.
3. Tarih ve bir başlık/açıklama girin.
4. Kilo etkinlikleri için kilo değerini girin.
5. Tıkla Kaydet.

Soyağacı

• Ebeveynler, büyükanne ve büyükbabalar ile büyük büyükanne ve büyükbabaları gösteren 3 nesillik bir aile ağacı görüntüler. (Yalnızca ebeveyn ilişkilerini girdiyseniz çalışır).
• Tıkla Soyağacı PDF'sini İndir yazdırılabilir bir sertifika oluşturmak için.

Kilo Gelişim Grafiği

• Kilo etkinliklerini kaydettiyseniz, hayvanın zaman içindeki kilosunu gösteren bir çizgi grafik görünür.

Yapay Zeka Özellikleri (Gemini API anahtarı gerektirir)

• AI Bakım Tavsiyesi — hayvanın cinsi, yaşı ve geçmişine dayalı kişiselleştirilmiş bakım önerileri oluşturur.
• AI Pazarlama Biyografisi — web siteniz veya sosyal medya listeleriniz için etkileyici bir açıklama yazar.
• AI Sağlık Uyarıları — etkinlik geçmişini analiz eder ve potansiyel sağlık sorunlarını işaretler.

Hayvan Satışı

1. Hayvanın profili üzerinde tıklayın Sat / Rezerve Et.
2. Alıcıyı kişi listenizden seçin.
3. Satış tarihi ve fiyatını girin.
4. Not ekleyin (isteğe bağlı).
5. Tıkla Satışı Onayla.
6. Hayvanın durumu "Satıldı" olarak değişir.
7. Tıkla Devir PDF'si Oluştur profesyonel bir devir belgesi oluşturmak için.

Kısa Kodu Kopyala

Profilin alt kısmında,

gibi bir kısa kod göreceksiniz. Kopyalamak için tıklayın. Bu hayvanın profilini halka açık web sitenizde göstermek için bunu herhangi bir WordPress sayfasına veya gönderisine yapıştırabilirsiniz.

Bölüm 6: Üretim ve Yavru Yönetimi

Yeni Bir Çiftleşme Kaydı Oluşturma

1. Git TruePaws → Yavrular.
2. Tıkla Yeni Çiftleşme Kaydet.
3. Formu doldurun:

Alan	Gerekli mi?	Açıklama
Baba	Evet	Hayvanlarınızdan erkeği seçin
Anne	Evet	Dişi hayvanınızı seçin
Çiftleşme Tarihi	Evet	Çiftleşmenin gerçekleştiği tarih
Yöntem	Hayır	Doğal veya Yapay Tohumlama (AI)
Notlar	Hayır	Çiftleşme hakkında herhangi bir not

4. Tıkla KaydetSistem, gebelik süresi ayarlarınıza göre beklenen doğum tarihini otomatik hesaplar.

Gebelik Takibi

Her aktif yavru, Gebelik Takipçisi ile bir kart gösterir:

• Gebeliğin ne kadar ilerlediğini gösteren bir ilerleme çubuğu.
• Trimester göstergesi (Erken / Orta / Geç).
• Beklenen doğuma kalan gün sayısı.
• Yaklaşan kilometre taşları (Embriyo yerleşimi, Kalp atışı, Ultrason vb.).

Doğum Kaydı (Yavrulama)

1. Git TruePaws → Yavrular.
2. Yavruyu bul ve tıkla Yavrulama.
3. Adım 1 — Doğumu Kaydet: Gerçek doğum tarihini, erkek/dişi yavru sayısını girin ve otomatik oluşturulan isimleri önizleyin.
4. Adım 2 — Onay: Özeti gözden geçirin ve Gönder butonuna tıklayın. Sistem her yavru için otomatik olarak bireysel kayıtlar oluşturur, ebeveynleri atar, bir doğum olayını kaydeder ve durumlarını Aktif olarak ayarlar.

Bölüm 7: İletişimleri Yönetme (Alıcılar ve Bekleme Listesi)

Bir Kişi Ekleme

1. Git TruePaws → Kişiler.
2. Tıkla Yeni Kişi Ekle.
3. Formu doldurun:

Alan	Gerekli mi?	Açıklama
Ad	Evet	Alıcının adı
Soyadı	Hayır	Alıcının soyadı
E-posta	Evet	Alıcının e-posta adresi
Telefon	Hayır	Telefon numarası
Adres	Hayır	Posta adresi
Durum	Hayır	Bekleme Listesi, Rezerve, Alıcı veya Pasif
Notlar	Hayır	Bu kişiyle ilgili herhangi bir özel not

4. Tıkla Kişiyi Kaydet.

Kişi Listesi Özellikleri

• Duruma göre filtrele — sadece Bekleme Listesi, Rezerve, Alıcılar veya Pasif kişileri göster.
• CSV Olarak Dışa Aktar — tüm kişileri e-posta pazarlama araçları için bir elektronik tablo dosyası olarak indirin.

Bölüm 8: Hayvanları Web Sitenizde Görüntüleme (Kısa Kodlar)

Kısa kodlar, TruePaws içeriğini halka açık web sitenizde göstermek için WordPress sayfalarına veya gönderilerine yapıştırdığınız özel kodlardır.

1. Tek Bir Hayvan Görüntüleme

[truepaws_animal id="7"]

(123'ü gerçek hayvanın kimlik numarasıyla değiştirin)

Ekleyebileceğiniz isteğe bağlı ayarlar:

Parametre	Ne Yapar	Varsayılan
contact_url="https://..."	'Yetiştiriciyle İletişim' butonu için özel bağlantı	Ayarlarınızın URL'si
show_ai="true" veya "false"	AI bakım bilgilerini göster veya gizle	doğru
show_pedigree="true" veya "false"	Soyağacını göster veya gizle	doğru
show_inquiry_form="true" veya "false"	Hayvanın altına bir sorgu formu yerleştir	yanlış
show_gallery="true" veya "false"	Fotoğraf galerisini göster veya gizle	doğru
gallery_columns="3"	Galeri için sütun sayısı (2 ile 6 arası)	4

Seçeneklerle örnek:

[truepaws_animal id="45" show_inquiry_form="true" gallery_columns="3" show_ai="false"]

2. Bir Yavru Grubu Görüntüleme

[truepaws_litter id="1"]

Bu, ebeveynler, doğum tarihi ve fotoğrafları ile durum rozetleriyle birlikte mevcut yavruların/köpeklerin bir ızgarasını içeren yavru bilgilerini gösterir.

3. Tüm Mevcut Yavruları Görüntüleme

[truepaws_available_puppies]

Bu, "Aktif" durumundaki tüm hayvanların bir ızgarasını gösterir.

İsteğe bağlı ayarlar:

Parametre	Ne Yapar	Varsayılan
limit="6"	Gösterilecek maksimum hayvan sayısı	12
breed="Golden Retriever"	Yalnızca bu cinsin hayvanlarını göster	(tüm cinsler)
show_images="true" veya "false"	Fotoğrafları göster veya gizle	doğru

Örnek:

[truepaws_available_puppies breed="Labrador Retriever" limit="8"]

4. Bir Bilgi Formu Görüntüleme

[truepaws_inquiry_form]

Bu, ziyaretçilerin hayvanlarınız hakkında bilgi almak için doldurabileceği bir iletişim formu görüntüler.

İsteğe bağlı ayarlar:

Parametre	Ne Yapar	Varsayılan
animal_id="123"	Sorguyu belirli bir hayvana bağla	(hiçbiri)
title="Interested? Get in Touch!"	Özel form başlığı	“Bir Sorgu Gönder”

Bölüm 9: PDF Belgeleri

TruePaws, iki tür profesyonel PDF belgesi oluşturabilir:

1. Soy Ağacı Sertifikası

Herhangi bir hayvanın profil sayfasından oluşturulur. Hayvanın adını, kayıt detaylarını, 3 nesillik soy ağacını ve yetiştiricinizin adını içerir.

2. Devir Paketi

Satılan bir hayvanın profilinden oluşturulur. Hayvan detaylarını, soy ağacı önizlemesini, tam sağlık geçmişini, beslenme talimatlarını, bakım önerilerini, sözleşme/şartları ve yetiştirici bilgilerinizi içerir.

Not: En iyi PDF kalitesi için, web barındırıcınızdan TCPDF veya Dompdf PHP kütüphanesinin kurulu olduğundan emin olmasını isteyin.

Bölüm 10: Otomatik E-posta Bildirimleri

TruePaws günlük bir kontrol yapar ve size şunlar için e-posta hatırlatmaları gönderir:

• Yavrulama Hatırlatmaları: Beklenen doğum tarihinden 7 gün önce gönderilir.
• Aşı Hatırlatmaları: Önemli kilometre taşlarında size hatırlatır (6 hafta, 9 hafta, 12 hafta, 16 hafta, 1 yıl, 2 yıl, 3 yıl).

Önemli: Bu e-postalar, Ayarlar → Yetiştirici Bilgileri → E-posta bölümüne girdiğiniz adrese gönderilir.

Bölüm 11: Önerilen İş Akışı (Adım Adım)

İlk Kurulum

1. Eklentiyi kurun ve etkinleştirin.
2. Ayarlar'a gidin ve tüm sekmeleri doldurun.
3. Özel ırklarınızı ekleyin.

Veritabanınızı Oluşturma

1. Önce tüm yetişkin üreme hayvanlarınızı ekleyin (baba ve anne).
2. Fotoğrafları yükleyin ve kayıt verilerini doldurun.
3. Soyağacı ağaçlarını oluşturmak için ebeveyn ilişkilerini ayarlayın.
4. Her hayvanın zaman çizelgesini oluşturmak için tarihi olaylar ekleyin.

Günlük Kullanım

1. Bir çiftleşme gerçekleştiğinde, Yavrular altına kaydedin.
2. Gebelikleri takip edin ve doğumlar gerçekleştiğinde Yavrulama Sihirbazı'nı kullanın.
3. Yavrular büyüdükçe profillerini güncelleyin.
4. Alıcıları İletişim listesine ekleyin.

Satış

1. Bir hayvan satıldığında, profillerindeki Sat/Rezerve özelliğini kullanın.
2. Devir Teslim PDF'sini Oluşturun.
3. Satış Raporlarını İzleyin.

Halka Açık Web Sitesi

1. "Mevcut Yavrular" sayfasını şunu kullanarak oluşturun: truepaws_available_puppies kısa kod
2. Şunu kullanarak bireysel sayfalar oluşturun truepaws_animal id="..." kısa kod
3. Ekle truepaws_inquiry_form kısa kodunu iletişim sayfanıza ekleyin.

Bölüm 12: İpuçları ve Püf Noktaları

• Kayıt tutmadaki boşlukları tespit etmek için Gösterge Paneli'ndeki Aktivite Isı Haritasını kullanın.
• E-posta listenizi güncel tutmak için düzenli olarak kişileri CSV'ye aktarın.
• AI Pazarlama Biyografisi, ilan yazarken size zaman kazandırabilir.
• Yavruların kilolarını haftalık olarak kaydedin ve büyüme grafiğini kullanarak sorunları erken tespit edin.
• Şunu kullanın animal_id parametresini sorgu formlarında belirli hayvan taleplerini takip etmek için kullanın.
• Yetiştiriciler arasında paylaşılan hayvanlar için "Ortak Sahipli" durumunu kullanın.