WordPress Eklenti Yazımı

Semih | 03.Mayıs.2009 | bu yazı eskimiş | Codex

Giriş

WordPress Eklentileri, blogunuzu kolayca düzenlemenize, kişiselleştirmenize ve iyileştirmenize imkan verir. WordPress Eklentilerini kullanarak WordPress’in sistem dosyalarını değiştirip, işlevselliği artırabilirsiniz. İşte basit bir tanım:

WordPress Eklentisi: Bir WordPress eklentisi, PHP kodlama diliyle yazılmış, WordPress Eklenti API’si tarafından belirlenmiş erişim noktalarını ve yöntemleri kullanarak WordPress blogunuza belirli özellikler eklemenize imkan veren bir program veya bir yada birden fazla fonksiyondan oluşan kod bütünüdür.

WordPress’in yeni veya değiştirilmiş işlevleri olmasını mı istiyoruz? Yapılacak ilk şey, ihtiyacınız olan şeyi karşılayacak bir WordPress Eklentisi olup olmadığını kontrol etmek için, WordPress Eklenti havuzunu veya kaynaklarını aramak.

Eğer yoksa, bu makale sizin kendi ihtiyaçlarınıza uygun WordPress Eklentinizi oluşturmanıza yardımcı olacaktır.

Bu makale WordPress’in temel fonksiyonlarıyla ve PHP programlamayla daha önceden tanışmış olduğunuzu varsaymaktadır!

Kaynaklar

WordPress Eklentilerinin nasıl çalıştığını ve WordPress blogunuza bunları nasıl kuracağınızı anlamak için, Eklentiler‘e göz atın.
WordPress Eklenti Kaynakları başlığında ise Eklenti geliştiricileri için, Eklenti Yazımıyla ilgili makaleler ve iç/dış kaynakları da içeren geniş kapsamlı bir liste bulabilirsiniz.
WordPress Eklentisi yazımının temelini öğrenmek için, Hello Dolly gibi, WordPress tarafından geliştirilmiş ve iyi yazılmış eklentilerin kaynak kodlarını inceleyin.
Kendi WordPress Eklentinizi yazdığınızda, eklentiyi nasıl yayınlayacağınızı ve diğerleriyle nasıl paylaşacağınızı öğrenmek için, Eklenti Yayınlama ve Promosyon konusunu okuyun.

Eklenti Oluşturmak

Makalenin bu kısmını adım adım takip ederek, iyi yapılanmış bir WordPress Eklentisinin nasıl yazılacağını görebilirsiniz.

İsimler, Dosyalar ve Yerleşimler

Eklenti İsmi

Bir WordPress eklentisi yazmaya başlarken yapacağınız ilk şey Eklentinin işlevini düşünmek ve Eklentiniz için bir isim(benzersiz) bulmak. Eklentiler dizinini ve diğer kaynakları araştırarak, eklenti isminizin başkası tarafından kullanılıp kullanılmadığını kontrol edin; ayrıca Google aramasıyla da kontrol edebilirsiniz. Bir çok eklenti geliştiricisi, kullanacakları eklenti isminin Eklenti işlevini tanımlamasını isterler; bir örnek verecek olursak, bir hava durumu Eklentisi, isminde en azından “hava” kelimesini içermelidir. Kullanacağınız isim bir kaç kelimeden oluşabilir.

Eklenti Dosyaları

Bir sonraki adımda, seçmiş olduğunuz Eklenti ismine istinaden bir PHP dosyası oluşturun. Örneğin, Eklentinizin ismi “Mükemmel Fonksiyonlar” ise, PHP dosyanızın ismi <tt>mukfonk.php</tt> olabilir. Yine aynı şekilde, dosya ismininde benzersiz olmasına dikkat edin. Eklentinizi kullanacak kişiler, eklentiyi sitelerindeki WordPress Eklenti dizinine, “wp-content/plugins“, yükleyecekleri için, aynı Eklentiden iki tane olmamasına dikkat edilmeli, bu yüzden dosya adı benzersiz olmalıdır.

Diğer bir seçenek ise Eklentinizi birden çok dosyaya bölmektir. WordPress eklentiniz en azından bir PHP dosyası içerektir; aynı zamanda JavaScript dosyaları, CSS dosyaları, resim dosyaları, dil dosyaları vb dosyalar da içerebilir. Eğer birden çok dosyanız varsa, dosyaların dizini için ve ana PHP dosyanız için “mukfonk” ve “mukfonk.php” örneğindeki gibi, benzersiz isimler seçin, bütün Eklenti dosyalarınızı o dizin içerisine yerleştirin, ve Eklentiyi kullanacak kişilere, Eklenti dizinini “wp-content/plugins” içerisine yüklemelerini söyleyin.

Makalenin geri kalanında, “PHP Eklenti dosyası” kelimeleri, “wp-content/plugins” veya bunun bir alt dizinindeki ana Eklenti dosyanız yerine kullanılacaktır.

Readme Dosyası

Eğer Eklentinizi http://wordpress.org/extend/plugins/ adresinde barındırmak istiyorsanız, standart düzene sahip bir readme.txt dosyası oluşturmalı ve Eklentiniz içerisine yerleştirmelisiniz.

Standart düzeni görmek için http://wordpress.org/extend/plugins/about/readme.txt adresine bakınız.

Ana Sayfa

Aynı zamanda, WordPress Eklentiniz için bir internet sayfası oluşturmak gerçekten çok kullanışlı olacaktır. Bu sayfa eklentinin nasıl kurulacağını, ne işe yaradığını, hangi WordPress sürümleriyle uyumlu olduğunu, sürümler arasındaki farklıları ve tabi ki Eklentinin nasıl kullanacağını içermelidir.

Dosya Başlıkları

Şimdi PHP Eklenti dosyası içerisine biraz bilgi yerleştirme zamanı.

Standart Eklenti Bilgisi

Eklentinizin ana PHP dosyasının en üstünde standart Eklenti bilgisi bulunmalıdır! Bu bilgiler WordPress’in eklentinin var olup olmadığını anlamasını, Eklenti Yönetimi ekranına eklentinizi eklemesini ve buradan eklentiyi etkinleştirebilmenizi, yükleyebilmenizi, fonksiyonlarını çalıştırabilmenizi sağlar. Bu bilgiler olmazsa, Eklentiniz hiç etkinleştirilemeyecek ve çalıştırılmayacaktır. İşte standart Eklenti bilgileri düzeni:

<?php
/*
Plugin Name: Eklentinizin İsmi
Plugin URI: http://Eklenti Bilgilerini yazdığınız internet sitesinin adresi
Description: Eklentinizin açıklaması
Version: Eklenti Sürüm Numarası. Örn. 1.0
Author: Eklenti Yazarının İsmi
Author URI: http://Eklenti Yazarının internet sitesinin adresi
*/
?>

Lisans

Eklentinize lisans bilgilerini eklemek tamamen size bağlıdır. Çoğu Eklenti WordPress tarafından da kullanılan GPL lisansını veya GPL ile uyumlu lisansları kullanır. GPL lisansı kullanmak için, aşağıdaki satırları Eklentinize ekleyiniz:

<?php
/*  Copyright YIL  EKLENTI_YAZARI_ISMI  (email : EKLENTI_YAZARI_MAIL_ADRESI)

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
*/
?>

Şimdilik ufak bir başlangıç yaptık….

Devamı gelecektir sanırım

Not: Bu döküman, WordPress Codex içerisindeki Writing A Plugin dökümanının çevirisi niteliğindedir!

Semih

Yazarin Sitesini Ziyaret Edin | Bu Yazarin Diger Yazilari(165)

Benzer Yazilar