Kodunuzun bozulmasının nedeni temel bir tipografi çakışmasıdır. Yapay zeka araçları ve kelime işlemciler genellikle “akıllı tırnak işaretleri” (kıvrımlı tırnak işaretleri gibi “ ve ”) oluşturur. WordPress kısa kodları ve temel programlama dilleri kesinlikle “düz tırnak işaretleri” (gibi " ve ') gerektirir. Gutenberg kısa kod parantezi içinde kıvrımlı tırnak işaretleri gördüğünde, bunu kod olarak ayrıştıramaz ve görüntülemeyi bozar.

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

Metninizi düzelttim. Tüm tipografiyi düz tırnak işaretlerine dönüştürdüm, kısa kodlarınızı kod biçimlendirmesi ile sararak Gutenberg’in onları çalıştırmaya çalışmamasını sağladım ve bozulan 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ını otomatik olarak oluşturmalıdır.

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

---

TruePaws — Tam Kullanıcı Kılavuzu

TruePaws Nedir?

TruePaws, WordPress sitenizin içinde çalışan bir kennel yönetim sistemidir. Profesyonel yetiştiricilerin hayvanlarını yönetmelerine, üreme ve hamilelikleri takip etmelerine, alıcıları yönetmelerine, resmi belgeler (soy ağacı sertifikaları ve devir paketleri gibi) oluşturmalarına ve hatta mevcut yavruları/köpek yavrularını halka açık web sitenizde göstermelerine 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 hizmetinizde kurulu bir WordPress sitesine ihtiyacınız var (ücretsiz WordPress.com blogu değil).
• WordPress 5.0 veya üzeri bir sürüm gereklidir.

2. Barındırma Gereksinimleri

• PHP 7.4 veya daha yenisi (çoğu modern hosting PHP 8.0+ sunar).
• MySQL veritabanı (tüm WordPress hostinglerde standart olarak bulunur).
• WordPress REST API etkin olmalıdır (varsayılan olarak etkindir — yalnızca birisi bilerek kapatmadıysa devre dışıdır).

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

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

Bölüm 2: Eklentiyi Kurma

1. Adım — Eklentiyi Yükle

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

2. Adım — 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ğunda 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 yan menünüzde. Üstte birkaç sekme göreceksiniz. Her birini tamamlayın.

Sekme 1: Genel Ayarlar

Ayarlar	Ne Yapar	Örnek
Varsayılan Tür	Başlıca yetiştirdiğiniz hayvan türü. Seçenekler: Köpek, Kedi, At, Tavşan, Gine Domuzu, Gelincik, Kuş.	Köpek
Yetiştirici Öneki	Yavru köpeklerin/kedilerin otomatik isimlendirilmesinde kullanılan kısa bir kod (en fazla 5 karakter).	TP
Gebelik Süresi — Köpekler	Bir köpeğin gebelik süresi kaç gün sürer. Varsayılan değer 63'tür. Yalnızca farklı bir bilgiye sahipseniz değiştirin.	63
Gebelik Süresi — Kediler	Bir kedinin gebelik süresi kaç gün sürer. Varsayılan değer 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 beslendiğini ve özel talimatları yazın.	"Royal Canin yavru maması ile günde 3 kez besleyin…"
Gemini API Anahtarı	Google Gemini API anahtarınızı buraya yapıştırarak AI özelliklerini etkinleştirin. 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 halde boş bırakın.	(webhook URL'niz)

Tıkla Ayarları Kaydet işlem bittiğinde.

Sekme 2: Yetiştirici Bilgileri

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

Alan	Ne Girilecek
Üretici Adı	Üretici olarak tam adınız
İşletme Adı	Köpek kulübeniz veya kedi çiftliğinizin adı
Lisans Numarası	Yetiştiricilik lisans numaranız (varsa)
Telefon	İşletme telefon numaranız
E-posta	İşletme e-posta adresiniz

Tıkla Ayarları Kaydet işlem bittiğinde.

Sekme 3: Irklar

Burada, eklenti genelindeki açılır menülerde kullanılabilecek ırklar listesini yönetirsiniz. TruePaws, önceden yüklenmiş 20 yaygın köpek ırkı ve 20 yaygın kedi ırkı ile gelir.

• Bir ırk eklemek için: Irk adını metin kutusuna 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: Şimdi çalıştığınız tüm ırkları ekleyin. Daha sonra her zaman daha fazla ekleyebilirsiniz.

Sekme 4: İletişim

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

Alan	Ne Girilecek
Sokak Adresi	Köpek kulübenizin sokak adresi
Şehir	Şehir
Eyalet/Bölge	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şim" butonlarında varsayılan bağlantı olarak kullanılır)

Tıkla Ayarları Kaydet işlem bittiğinde.

Sekme 5: Satış Raporları

Bu sekme salt okunurdur — satış kayıtlarınız başladığında istatistiklerinizi gösterir. Şunları göreceksiniz:

• Toplam Elde Edilen Gelir
• Toplam Satış Sayısı
• Ortalama Satış Fiyatı
• Aylık detaylı tablo
• En Çok Satın Alanlar tablosu

Bölüm 4: Kontrol Paneli

Yan menüden TruePaws'a tıkladığınızda, Kontrol Paneline yönlendirilirsiniz. Burası ana merkezinizdir. İşte görecekleriniz:

İstatistik Kartları

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

Hızlı İşlemler

• Hayvan Ekle — doğrudan yeni hayvan formuna git
• Çiftleşme Kaydet — yeni bir üreme kaydı ekle
• İletişim Ekle — yeni bir alıcı veya bekleme listesi kaydı ekle

Başlangıç Kontrol Listesi

• İlk kez kurulum sürecinde size rehberlik eden yararlı bir kontrol listesi.

Son Etkinlikler

• Tüm hayvanlarınız için 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.

Etkinlik Isı Haritası

• Geçen yıl boyunca köpek üretim çiftliğ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 kaydedilmiş.

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

Yeni Bir Hayvan Nasıl Eklenir

1. Git TruePaws → Hayvanlar (veya Kontrol Paneli'nde "Hayvan Ekle"yi 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ı
Takma Ad	Hayır	Evde gerçekten onlara hitap ettiğiniz ad
Kayıt Numarası	Hayır	Cins kaydınızdaki resmi kayıt numarası
Mikroçip Kimliği	Hayır	Mikroçip numarası (benzersiz olmalıdır)
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 Sahip (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: Yetişkin üreme hayvanlarınızı (erkek ve dişileri) önce ekleyerek başlayın. Bu şekilde, 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üleyin. Bu, eklentideki en fazla özelliğe sahip sayfadır. İşte yapabilecekleriniz:

Bilgileri Görüntüle

• Girdiğiniz tüm detayları, artı bir durum rozetini (örneğin, yeşil "Aktif", mavi "Satıldı") görün.
• Öne çıkan görsel önemle görüntülenir, fotoğraf yüklenmediyse bir silüet gösterilir.

Fotoğraf Galerisi

• "Fotoğraf Ekle"yi 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 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. Ağırlık olayları için ağırlık 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 Büyüme Grafiği

• Ağırlık olaylarını kaydettiyseniz, hayvanın zaman içindeki ağırlığını gösteren bir çizgi grafik görünür.

Yapay Zeka Özellikleri (Gemini API anahtarı gerektirir)

• AI Bakım Tavsiyesi — hayvanın cinsine, yaşına 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ı — olay geçmişini analiz eder ve potansiyel sağlık sorunlarını işaretler.

Hayvan Satışı

1. Hayvanın profilinde, Sat / Rezerve Et.
2. Alıcıyı kişi listenizden seçin.
3. Satış tarihini 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 web sitenizde göstermek için bu kodu herhangi bir WordPress sayfasına veya yazısına yapıştırabilirsiniz.

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

Yeni Çiftleşme Kaydı

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

Alan	Gerekli mi?	Açıklama
Baba	Evet	Erkek hayvanı seçin
Anne	Evet	Dişi hayvanı 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 notlar

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

Gebelik Takibi

Her aktif yavru grubu bir Gebelik Takipçisi kart ile görüntülenir:

• 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ı (Yerleşme, Kalp Atışı, Ultrason vb.).

Doğum Kaydı (Yavrulama)

1. Git TruePaws → Yavrular.
2. Yavruyu bulun ve tıklayın Yavru Partisi.
3. Adım 1 — Doğumu Kaydet: Gerçek doğum tarihini, erkek/dişi yavru sayısını girin ve otomatik olarak oluşturulan isimleri önizleyin.
4. Adım 2 — Onay: Özeti gözden geçirin ve Gönder'e tıklayın. Sistem her yavru için ayrı 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 & 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 İnaktif
Notlar	Hayır	Bu kişi hakkında özel notlar

4. Tıkla Kişiyi Kaydet.

İletişim Listesi Özellikleri

• Duruma göre filtrele — sadece Bekleme Listesi, Rezerve Edilen, Alıcılar veya Pasif kişileri göster.
• CSV olarak dışa aktar — e-posta pazarlama araçları için tüm kişileri 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 web sitenizde göstermek için WordPress sayfalarına veya yazılarına yapıştırdığınız özel kodlardır.

1. Tek Bir Hayvanı Görüntüle

[truepaws_animal id="7"]

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

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

Parametre	Ne Yapar	Varsayılan
contact_url="https://..."	'Üreticiyle İletişim' butonu için özel bağlantı	Ayarlar URL'niz
show_ai="true" veya "false"	AI bakım bilgilerini göster veya gizle	doğru
show_pedigree="true" veya "false"	Soyağacı ağ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 Grubunu Görüntüle

[truepaws_litter id="1"]

Bu, ebeveynleri, doğum tarihini ve mevcut yavruların fotoğraflarıyla durum rozetlerini içeren bir yavru grubunun bilgilerini gösterir.

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

[truepaws_available_puppies]

Bu, 'Aktif' durumundaki tüm hayvanları bir ızgara olarak gösterir.

İsteğe bağlı ayarlar:

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

Örnek:

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

4. Bir Sorgu Formu Görüntüle

[truepaws_inquiry_form]

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

İsteğe bağlı ayarlar:

Parametre	Ne Yapar	Varsayılan
animal_id="123"	Sorguyu belirli bir hayvana bağla	(yok)
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ştirici adınızı 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 yüklü 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ırlatıcıları gönderir:

• Doğum Hatırlatıcıları: Beklenen doğum tarihinden 7 gün önce gönderilir.
• Aşı Hatırlatıcıları: Size önemli dönüm noktalarında 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ünde girdiğiniz adrese gönderilir.

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

İlk Kurulum

1. Eklentiyi yükleyip 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ı (baba ve anne) ekleyin.
2. Fotoğrafları yükleyin ve kayıt bilgilerini 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 geçmiş olayları ekleyin.

Günlük Kullanım

1. Çiftleşme olduğunda, Yavrular altına kaydedin.
2. Gebelikleri takip edin ve doğum olduğunda Yavrulama Sihirbazı'nı kullanın.
3. Yavrular büyüdükçe profillerini güncelleyin.
4. Alıcıları Kişiler listesine ekleyin.

Satış

1. Bir hayvan satıldığında, profilindeki Sat/Rezerve özelliğini kullanın.
2. Devir Belgesi PDF'ini oluşturun.
3. Satış Raporlarını takip edin.

Herkese Açık Web Sitesi

1. "Mevcut Yavrular" sayfası oluşturmak için: truepaws_available_puppies kısa kod
2. Bireysel sayfalar oluşturmak için truepaws_animal id="..." kısa kod
3. Ekle truepaws_inquiry_form kişi sayfanıza kısa kod ekleyin.

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

• Kayıt tutmadaki boşlukları tespit etmek için Kontrol Paneli'ndeki Aktivite Isı Haritasını kullanın.
• Posta listenizi güncel tutmak için iletişim bilgilerini düzenli olarak CSV olarak dışa aktarın.
• AI Pazarlama Biyografisi, listelemeler yazarken size zaman kazandırabilir.
• Yavruların kilolarını haftalık olarak kaydedin ve büyüme grafiğini kullanarak sorunları erken tespit edin.
• Kullanın animal_id parametresini sorgu formlarında belirli hayvan taleplerini takip etmek için kullanın.
• Üreticiler arasında paylaşılan hayvanlar için "Ortak Sahipli" durumunu kullanın.