İlk mesajınızda oyuncunun yapacağı işi anlatın
MCP sayesinde asistan, bağlandığı yazılımın hangi araçları sunduğunu öğrenip ihtiyacı olan aracı çağırabilir. Burada “ajan” dediğimiz şey, isteğinizi okuyup bu araçlarla çalışabilen asistan. Hangi dosyayı okuyabildiği, bir taslak hazırlayıp hazırlayamadığı veya sitenize yazıp yazamadığı seçtiğiniz bağlantıya ve verdiğiniz izinlere bağlı.İlk denemede bizim harita örneğimizi kendi sitenize uyarlayabilirsiniz. Bir kitapçı için aynı istek, üç şubenin adresini telefonda kolay okunur bir sayfada göstermek olabilir. İşe, asistanın erişebildiği bir sayfayı seçip mevcut başlığını ve içeriğini sormakla başlayın. Sizin gördüğünüz sayfayı tarif edebiliyorsa ne eklemek istediğinizi somut bir örnekle anlatın.
Sunucum için “Yeni Oyuncu Rehberi” hazırlamak istiyorum. İskele, pazar ve başlangıç madeni için üç yer kartı olsun. Telefonda yer adı ile koordinatlar yan yana okunabilsin. Önce mevcut temayı incele ve bana bir taslak göster.Bu tarif renk, yazı tipi veya dosya adı içermiyor ama sonucu değerlendirmek kolay. Telefonunuzdan pazarı bulup koordinatını okuyabiliyor musunuz? İlk taslakta bunu deneyin. Eğer üç konum uzun süre sabit kalacaksa sayfaya yazılmış üç kart işi görebilir. Ekibiniz her hafta konum ekleyecekse her seferinde tema kodu açmak istemezsiniz. Modülü konuşmanın zamanı o zaman gelir.
SFTP ile temanın doğru yerine dokunmak
Yetkili SFTP bağlantısı, ajanın düzenlenebilen tema dosyalarını okuyup değişiklik hazırlamasını sağlar. Kullandığınız sistem tema dosyalarını SFTP ile sunuyorsa bağlantıyı kendi barındırma veya tema yönetim aracınızdan hazırlayabilirsiniz. Önce etkin temayı ve hedef sayfayı okutun. “Rehber başlığının hemen altında göster” dediğinizde asistan o başlığın geçtiği gerçek şablonu bulabilir. Sayfanızdaki iki ayrı başlık benzerse birkaç komşu satırı da isteyin. Böylece mobil menüdeki bağlantı ile sayfanın içindeki başlığı ayırt edebilirsiniz.Aşağıdaki küçük parça, bir taslakta görmek isteyeceğiniz farkı anlatır. İlk satır temada zaten var. İkinci satır, yeni listeyi yerleştirmek için önerilen bölgedir. Buradaki kimlik örneğe aittir.
<h2>Yeni Oyuncu Rehberi</h2>
<div id="rehber-konumlari"></div>
Boş bir bölüm ekleyince harita kendiliğinden oluşmaz. Bu satırın görevi, konum listesinin sayfada nerede görüneceğini belirlemektir. Ajandan mevcut dosya sürümünü esas alarak yalnız bu noktayı değiştirmesini, taslağı eşitlemesini ve önizlemeyi açmasını isteyin. Bu arada ekipten biri aynı şablonu düzenlemişse güncel içeriği tekrar okuyup farkı ona göre hazırlayın. “74. satıra yaz” talimatı başına birkaç satır eklenen bir dosyada artık başka bir yere denk gelebilir.Oyuncu sayfayı açtığında modül ne yapar?
Örnek harita modülünün üç parçasını düşünün. Paket tanımı modülün kimliğini, sürümünü, hedef temayı ve sunduğu işlemleri bildirir. Şablon, oyuncunun gördüğü liste için yer ve görünüm sağlar. Modülün API tarafı ise gösterilecek konumları okur. Örneğin ziyaretçi rehberi açtığında sayfa konum listesini ister. Okuma işlemi kayıtlı isimleri ve koordinatları döndürür. Görünüm de “Pazar” adını kendi koordinatlarıyla aynı karta yerleştirir.Bu ayrımın karşılığını pazar taşındığında görürsünüz. Yetkili bir yönetim işlemiyle koordinat kaydını güncellersiniz. Sayfa yeni listeyi okuduğunda aynı kartta yeni koordinat görünür. Kartın rengini düzeltmek için bu kez konum kayıtlarına dokunmanız gerekmez. Liste boşsa “Henüz konum eklenmedi” yazması, veri alınamadığında ise yüklemenin başarısız olduğunu söylemesi iyi bir ayrıntıdır. O iki durumda yöneticinin yapacağı iş farklıdır.
Geliştirici tarafında herkese açık konumları döndüren işlem yalnız okumaya açılabilir. Kayıt değiştiren işlem ise yetkili oturum, POST isteği ve CSRF doğrulaması gerektirir. Modülün veri erişiminde kendisine sağlanan veritabanı nesnesi ve parametreli sorgular kullanılır. Şablon tarafı HTML veya panelin desteklediği şablon diliyle hazırlanır. Çalıştırılacak PHP kodunun yeri paketin API alanıdır.
Ajana ikinci mesajda ne söylersiniz?
İlk taslağı telefonunuzda açtınız. İskele ve maden rahat okunuyor ama “Eski Şehir Pazarı” iki satıra düşünce koordinatlar sağdan taşıyor. Ajana yalnızca “Mobil kötü olmuş, düzelt” derseniz o da baştan bir kart tasarlamayı deneyebilir. Oysa sizin sevdiğiniz taraflar var. Bunu tarifinize katın. “Kartların sırası ve isimleri güzel. Uzun yer adında koordinatlar ekranın dışına çıkıyor. Adı üst satırda, koordinatı altında gösterecek bir mobil düzen dene. Masaüstünde yan yana kalsın.” Bu mesajdaki her cümleyi sonraki önizlemede kendiniz kontrol edebilirsiniz.Bir de aynı hafta pazarı başka yere taşıdığınızı düşünün. Sorun bu kez yazının sığması mı, kartın yanlış koordinat göstermesi mi? Sayfa görünümünü yeniletmeden önce ajandan konum listesinin pazar için döndürdüğü değeri okumasını isteyin. Dönen değer de eskiyse düzeltilecek şey kayıttır. Liste yeni koordinatı döndürdüğü hâlde kart eski değeri gösteriyorsa bu kez görünümün hangi alanı kullandığına bakarsınız. Bu ayrım sayesinde çalışan şablonu her veri düzeltmesinde yeniden hazırlatmazsınız.
Son olarak ajandan bir sonraki kişinin anlayacağı kadar kısa bir teslim notu isteyin. Haritayı açan sayfa hangisi, konum adları nereden geliyor, tasarım değişecekse hangi şablona bakılacak? Ekibinize yeni katılan geliştirici ilk görevinde “Başlangıç madeni taşındı” mesajını aldığında o üç satır işine yarayacak.
SFTP’deki taslaktan çalışan pakete
Ajana önce mevcut modül durumunu ve hedef temayı inceletin. Bu örnekteki modül sistemi, SFTP çalışma alanındaki kaynakları taslak olarak tutuyor. Kendi altyapınızda modülün kaynak biçimini ve nasıl etkinleştirildiğini o sistemin belgelerinden öğrenebilirsiniz. PHP kaynaklarını burada .php.txt uzantısıyla görmeniz beklenen davranıştır. Asistan ZIP’i yeniden hazırlarken dosyaları paketin içinde özgün .php adlarına döndürür. Dosyayı SFTP’de kaydetmek, sitenizde o kodu çalıştırmaz.Paketin tanımını, hedeflediği şablonları ve API dosyalarını inceleyin. Ardından ZIP, modül yükleyicisinden doğrulanarak yüklenir ve seçilen site ile temaya uygulanır. Bir paket hedef şablonu bütünüyle içerebilir. Sizin tasarımınızda korunacak bir bölüm varsa uygulamadan önce önerilen dosyayı mevcut sürümle karşılaştırın. Tema yöneticiniz dosya farklarını gösteriyorsa eklenen ve kaldırılan satırları oradan okuyun. Aynı karşılaştırmayı dosyaların uygulama öncesi ve sonrası kopyalarıyla da yapabilirsiniz.
“Yüklendi” mesajından sonra pazarı bulun
Deneme sitesinde rehberi oturum açmadan ziyaret edin. Üç yer görünüyor mu? Pazarın koordinatını deneme kaydında değiştirip sayfayı yeniden açın. Oyuncu yeni değeri okuyabiliyor, diğer iki yer aynı kalıyor ve ziyaretçiye yönetim işlemi açılmıyorsa modülün hem veri hem görünüm tarafını sınamışsınız demektir. Sonra telefona geçip uzun bir konum adıyla okuyun.Menüye “Oyuncu Rehberi” bağlantısını en son eklemek işinizi kolaylaştırır. Böylece oyuncular bir vaatle karşılaşmaz. Bağlantıya dokunduklarında gerçekten pazara giden yolu bulurlar.








“10 üzerinden 10 veriyorum bu kadar özellik diğer yazılımlarda bile yok.”