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 ”) üretir. WordPress kısa kodları ve temel programlama dilleri kesinlikle “düz tırnaklar” (gibi " ve ') gerektirir. Gutenberg bir kısa kod parantezi içinde kıvrımlı tırnaklar gördüğünde, onu kod olarak ayrıştıramaz ve işlemi 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 veriyi bozar.

Metninizi temizledim. Tüm tipografiyi düz tırnaklara dönüştürdüm, kısa kodlarınızı kod biçimlendirmesiyle sararak Gutenberg'in onları çalıştırması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 köpek kulübesi 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ı 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 hizmetinize kurduğunuz bir WordPress sitesine ihtiyacınız var (ücretsiz WordPress.com blogu değil).
• WordPress 5.0 veya daha yeni bir sürüm gereklidir.

2. Barındırma Gereksinimleri

• PHP 7.4 veya daha yenisi (çoğu modern hosting PHP 8.0+ sağlar).
• MySQL veritabanı (tüm WordPress hostinglerde standart olarak bulunur).
• WordPress REST API'nin etkin olması gerekir (varsayılan olarak etkindir — sadece biri bilerek kapatmışsa devre dışıdır).

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

• AI destekli özellikleri (bakım tavsiyeleri, sağlık uyarıları, pazarlama biyografisi oluşturma) kullanmak istiyorsanız bir Google Gemini API anahtarı. 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

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 aldığınız truepaws.zip dosyayı 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 butonuna 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. Üstte 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, Ginepig, 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öpeğin gebeliği kaç gün sürer. Varsayılan 63 gündür. Sadece farklı bir bilginiz varsa değiştirin.	63
Gebelik Süresi — Kediler	Bir kedinin gebeliği kaç gün sürer. Varsayılan 65 gündür.	65
Beslenme Talimatları	Yeni alıcılara verdiğiniz teslim belgelerinde görünecek metin. Hayvanın ne yediğini, ne sıklıkla 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 işlem bittiğinde.

Sekme 2: Yetiştirici Bilgileri

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

Alan	Ne Girilmeli
Yetiştirici Adı	Yetiştirici olarak tam adınız
İşletme Adı	Köpek veya kedi çiftliğinizin adı
Lisans Numarası	Yetiştirici 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

Bu, eklenti genelindeki açılır menülerde kullanılabilen ırklar 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 cins eklemek için: Metin kutusuna cins adını yazın ve Cins Ekle.
• Bir cinsi kaldırmak için: Listedeki herhangi bir cinsin yanındaki silme butonuna 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 / Sorgu 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ı tutmaya başladığınızda satış istatistiklerinizi gösterir. Şunları göreceksiniz:

• Toplam Kazanılan Gelir
• Toplam Satış Sayısı
• Ortalama Satış Fiyatı
• Aylık detaylandırılmış tablo
• En İyi Alıcılar tablosu

Bölüm 4: Kontrol Paneli

Kenar çubuğunda TruePaws'a tıkladığınızda, Kontrol Paneline yönlendirilirsiniz. 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 — 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 faydalı bir kontrol listesi.

Son Etkinlikler

• Tüm hayvanlarınızla ilgili 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 kulübenizin 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 Kontrol Paneli'nde "Hayvan Ekle"ye tıklayın).
2. Üstteki Yeni Hayvan Ekle butonuna 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çekte onlara hitap ettiğiniz ad
Kayıt Numarası	Hayır	Irk kayıt kuruluşunuzdan resmi kayıt numarası
Mikroçip ID	Hayır	Mikroçip numarası (benzersiz olmalıdır)
Irk	Hayır	Irk listenizden seçin
Cinsiyet	Evet	Erkek veya Dişi
Baba (Sire)	Hayır	Sisteminizdeki mevcut erkek hayvanlardan seçin
Anne (Dam)	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 olarak 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 ipucu: Önce yetişkin üreme hayvanlarınızı (baba ve anne) ekleyerek başlayın. Bu şekilde, genç hayvanları veya yavruları eklerken 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ı ve bir durum rozetini (örneğin, yeşil "Aktif", mavi "Satıldı") görün.
• Öne çıkan görsel belirgin şekilde gösterilir, fotoğraf yüklenmediyse yedek 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.
• Bir fotoğrafa tıklayarak öne çıkan görsel olarak ayarlayı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 butonuna 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 olayları 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 olaylarını 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 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, 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, şuna benzer bir kısa kod göreceksiniz:

. Kopyalamak için tıklayın. Bu kodu herhangi bir WordPress sayfasına veya yazısına yapıştırarak bu hayvanın profilini halka açık web sitenizde görüntüleyebilirsiniz.

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

Yeni Bir Çiftleşme Kaydetme

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

Alan	Gerekli mi?	Açıklama
Baba (Sire)	Evet	Erkek hayvanınızı seçin
Anne (Dam)	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 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, aşağıdakileri içeren bir Gebelik Takipçisi 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ı (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 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 & 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ş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 halka açık web sitenizde görüntülemek 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 ID 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 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 ila 6)	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 fotoğrafları ile durum rozetlerini içeren mevcut yavruların bir ızgarasını gösterir.

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

[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"	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 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	(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ştirici adınızı içerir.

2. Teslimat 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 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ı: Önemli dönüm noktaları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ü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).
2. Fotoğrafları yükleyin ve kayıt verilerini doldurun.
3. Soyağacı 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 olduğunda, Yavrular altına kaydedin.
2. Gebelikleri takip edin ve doğumlar olduğunda 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, profillerindeki Sat/Rezerve özelliğini kullanın.
2. Teslimat PDF'sini oluşturun.
3. Satış Raporlarını izleyin.

Halka 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 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 Kontrol 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, 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.
• Yetiştiriciler arasında paylaşılan hayvanlar için "Ortak Sahipli" durumunu kullanın.