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

Ayrıca, kopyala-yapıştır işleminiz belgelerdeki tabloları tamamen yok ederek, onları 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ırnak işaretlerine çevirdim, kısa kodlarınızı kod biçimlendirmesiyle sararak Gutenberg’in onları çalıştırmaya çalışmasını engelledim ve bozulan tablolarınızı uygun Markdown’a yeniden düzenledim. 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 gebelikleri takip etmelerine, alıcı iletişimlerini yönetmelerine, resmi belgeler (soy ağacı sertifikaları ve devretme paketleri gibi) oluşturmalarına ve hatta mevcut yavruları/köpek yavrularını genel web sitenizde görüntülemelerine yardımcı olur.

Bölüm 1: Ön Koşullar (Kurulumdan Önce Gerekenler)

1. Bir WordPress Sitesi

• Kendi barındırma hizmetinizde kurulu 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 yeni (çoğu modern sunucu PHP 8.0+ sağlar).
• MySQL veritabanı (tüm WordPress sunucularında standarttır).
• WordPress REST API etkin olmalıdır (varsayılan olarak etkindir — yalnızca biri bilerek kapatmışsa devre dışıdır).

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

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

Bölüm 2: Eklentinin Kurulumu

Adım 1 — Eklentiyi Yükleme

1. WordPress yönetici paneline giriş yapın (genellikle yourwebsite.com/wp-admin).
2. Sol taraftaki kenar çubuğundan Eklentiler → Yeni Ekle.
3. Üstteki Eklenti Yükle düğmesine 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.

Adım 2 — Eklentiyi Etkinleştirme

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 kenar çubuğunuzda. Üst kısımda birkaç sekme göreceksiniz. Her birini tek tek doldurun.

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, Dağ Gelinciği, Kuş.	Köpek
Yetiştirici Öneki	Yavruları/yavru kedileri otomatik adlandırırken kullanılan kısa bir kod (en fazla 5 karakter).	TP
Gebelik Süresi — Köpekler	Bir köpeğin hamileliği kaç gün sürer. Varsayılan değer 63'dür. Sadece farklı bildiğiniz durumlarda değiştirin.	63
Hamilelik Süresi — Kediler	Bir kedinin hamileliği kaç gün sürer. Varsayılan değer 65'tir.	65
Beslenme Talimatları	Yeni alıcılara verdiğiniz teslim belgelerinde görünecek metin. Hayvanın ne yediğini, ne sıklıkla yediğini ve özel talimatları yazın.	"Royal Canin yavru köpek maması ile günde 3 kez besleyin…"
Gemini API Anahtarı	AI özelliklerini etkinleştirmek için Google Gemini API anahtarınızı buraya yapıştırın. AI özellikleri 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şiniz bittiğinde.

Sekme 2: Yetiştirici Bilgileri

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

Alan	Ne Girilmeli
Yetiştirici Adı	Yetiştirici olarak tam adınız
İş Adı	Çiftlik veya kediliğinizin adı
Lisans Numarası	Yetiştiricilik lisans numaranız (varsa)
Telefon	İş telefon numaranız
E-posta	İş e-posta adresiniz

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

Sekme 3: Irklar

Bu, eklenti genelindeki 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 daha fazla ekleyebilirsiniz.

Sekme 4: İletişim

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

Alan	Ne Girilmeli
Sokak Adresi	Çiftliğinizin sokak 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şim" butonlarında varsayılan bağlantı olarak kullanılır)

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

Sekme 5: Satış Raporları

Bu sekme salt okunurdur — satış kayıtlarınızı başlattığı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 Paneline ulaşırsınız. Burası ana merkezinizdir. İşte görecekleriniz:

İstatistik Kartları

• Toplam Hayvanlar — 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 — doğrudan yeni hayvan formuna git
• Çiftleşme Kaydı — yeni bir üreme kaydı oluştur
• İletişim Ekle — yeni bir alıcı veya bekleme listesi girişi ekle

Başlarken Kontrol Listesi

• İlk kurulum sırasında 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 ı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 kulübenizin her gün ne kadar aktif olduğunu gösteren bir GitHub tarzı takvim ısı haritası. Daha koyu kareler = o gün kaydedilen daha fazla etkinlik.

Bölüm 5: Hayvanları 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 ona gerçekten hitap ettiğiniz ad
Kayıt Numarası	Hayır	Irk kaydınızdan 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 (Baba)	Hayır	Sisteminizdeki mevcut erkek hayvanlardan seçin
Anne (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ı, Ölü veya Ortak Sahipli (varsayılan Aktif)
Renk/İşaretler	Hayır	Hayvanın görünümünü tarif edin
Açıklama	Hayır	Hayvanla ilgili ek notlar
Öne Çıkan Görsel	Hayır	WordPress Medya Kütüphanesi'ni 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. Bu şekilde, 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üleyin. Bu, eklentideki en zengin özelliklere sahip sayfadır. İşte yapabileceğiniz her şey:

Bilgileri Görüntüle

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

Fotoğraf Galerisi

• Çoklu fotoğraf yüklemek için "Fotoğraf Ekle"yi tıklayın.
• 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. Ağırlık olayları için, ağırlık değerini girin.
5. Tıkla Kaydet.

Soy Ağacı

• Ebeveyn, 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 Pedigree PDF İ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üntülenir.

Yapay Zeka Özellikleri (Gemini API anahtarı gerektirir)

• AI Bakım Tavsiyesi hayvanın cinsine, yaşına ve geçmişine göre 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.

Bir Hayvan Satmak

1. Hayvanın profilinde tıklayın 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, göreceğiniz bir kısa kod şöyle olacak

. Kopyalamak için tıklayın. Bu hayvanın profilini halka açık web sitenizde göstermek için bu kodu 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ı

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

Alan	Gerekli mi?	Açıklama
Baba (Baba)	Evet	Erkek hayvanı seçin
Anne (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 Döllenme (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 listesi şunları içeren Gebelik Takipçisi 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ünler.
• 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 Doğumu.
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'e 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şim Yönetimi (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 Etkin Değil
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, 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üle

[truepaws_animal id="7"]

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

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

Parametre	Ne Yapar	Varsayılan
contact_url="https://..."	"Yetiştiriciyle İletişime Geç" 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ı 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ı ile durum rozetlerini içeren bir ızgara gösterir.

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

[truepaws_available_puppies]

Bu, 'Aktif' durumundaki tüm hayvanları içeren bir ızgara 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 ırka ait 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 doldurabilecekleri 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	(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 bilgilerini, 3 nesillik soy ağacını ve yetiştirici adınızı içerir.

2. Teslim 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 aşağıdakiler 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 kilometre taşlarında (6 hafta, 9 hafta, 12 hafta, 16 hafta, 1 yıl, 2 yıl, 3 yıl) hatırlatır.

Ö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 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 hayvanlar).
2. Fotoğrafları yükleyin ve kayıt verilerini doldurun.
3. Soy ağaçları 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. Bir çiftleşme gerçekleştiğinde, Yavrular altına kaydedin.
2. Gebelikleri takip edin ve doğumlar gerçekleştiğinde Doğum 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. Teslimat PDF'sini oluşturun.
3. Satış Raporlarını izleyin.

Halka Açık Website

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 iletişim sayfanıza kısa kod ekleyin.

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

• Kayıt tutmanızdaki boşlukları tespit etmek için Gösterge Paneli'ndeki Aktivite Isı Haritasını kullanın.
• E-posta listenizi güncel tutmak için kişileri düzenli olarak CSV olarak dışa 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.
• Kullanın animal_id belirli hayvan taleplerini takip etmek için sorgu formlarındaki parametreyi kullanın.
• Üreticiler arasında paylaşılan hayvanlar için "Ortak Sahipli" durumunu kullanın.