WordPress Eklentisi Nasıl Oluşturulur (Yeni Başlayanlar İçin Adım Adım)

Yıllar boyunca hem kendimize hem de binlerce kullanıcıya yardımcı olan birçok WordPress eklentisi oluşturduk. Birçok okuyucumuz bize kendi eklentilerini nasıl yapabileceklerini sordu.

Bir WordPress eklentisi yapmak ilk başta zor görünebilir, ancak aslında oldukça eğlenceli ve ödüllendiricidir. İster sitenize yeni bir özellik eklemek ister başkalarıyla faydalı bir şey paylaşmak isteyin, eklenti oluşturmak bunu yapmanın harika bir yoludur.

Bu kılavuzda, ilk WordPress eklentinizi adım adım nasıl yapacağınızı göstereceğiz.

İlk WordPress Eklentinizi Oluşturmak İçin Neye İhtiyacınız Var?

WordPress eklentileri, WordPress web siteniz için uygulamalar gibidir. Tıpkı telefonunuzdaki uygulamalar gibi, yeni özellikler eklemek için WordPress’e eklentiler yükleyebilirsiniz.

WordPress eklentileri hakkında daha fazla bilgi edinmek için WordPress eklentileri ve nasıl çalıştıkları hakkındaki kılavuzumuza bakın.

İlk WordPress eklentinizi oluşturmak için PHP, CSS, HTML ve JavaScript gibi kodlama dilleri hakkında temel bilgiye sahip olmanız gerekir.

Bu çok fazla gibi gelebilir, ancak endişelenmeyin; yine de eğitimimizi takip edebilirsiniz. Süreç boyunca size adım adım yol göstereceğiz ve sonunda basit bir WordPress eklentisi oluşturmak için WordPress programlama hakkında yeterli bilgiye sahip olacaksınız.

Bu nedenle, temel bilgilere bağlı kalacağız ve ileri düzey WordPress kodlama becerilerine girmeyeceğiz.

İkinci olarak, WordPress eklentinizi bilgisayarınızda test etmek için yerel bir geliştirme ortamına ihtiyacınız olacaktır. Bunu ayarlamak için WordPress’i Windows bilgisayarınıza veya Mac‘inize nasıl yükleyeceğinize ilişkin kılavuzumuza bakın).

Eklentinizi bir hazırlık web sitesinde de test edebilirsiniz. Ancak, bir hata oluşursa, web sitenizi bozabilir ve erişilemez hale getirebilirsiniz.

Bu sorunların üstesinden gelmek için yaygın WordPress hatalarının nasıl düzeltileceğine ilişkin kılavuzumuza bakın.

Kodunuzu yazmak için düz bir metin editörüne de ihtiyacınız olacak. Notepad veya TextEdit işinizi görecektir. Ancak, daha gelişmiş bir şey denemek istiyorsanız, geliştiriciler için bu kod editörlerine göz atın.

Bunlar hazır olduğuna göre, eğitime başlayalım. Belirli bir konuya geçmek için aşağıdaki hızlı bağlantıları kullanabilirsiniz:

Adım 1: Temel Bir WordPress Eklentisi Oluşturun

İlk adım, masaüstünüzde veya belgeler klasörünüzde yeni bir klasör oluşturmak ve buna wpb-plugin-tutorial veya my-first-plugin gibi bir isim vermektir.

Ardından, metin düzenleyicinizde yeni bir dosya oluşturmanız ve eklenti klasörünüzün içine wpb-plugin-tutorial.php veya my-first-plugin.php olarak kaydetmeniz gerekir. Önemli olan .php uzantısıdır, ancak dosyayı istediğiniz gibi adlandırabilirsiniz.

Bu PHP dosyasını metin düzenleyiciniz ile açmanız gerekecektir.

Eklenti dosyanıza eklemeniz gereken ilk şey eklenti başlığıdır. Bu yorum bloğu WordPress’e basitçe eklentinizin adını, sürümünü, web sitesini, eklenti yazarının adını ve daha fazlasını söyler:

/*
Plugin Name:  WPBeginner Plugin Tutorial
Plugin URI:   https://www.wpbeginner.com
Description:  A short little description of the plugin. It will be displayed on the Plugins page in WordPress admin area.
Version:      1.0
Author:       WPBeginner
Author URI:   https://www.wpbeginner.com
License:      GPL2
License URI:  https://www.gnu.org/licenses/gpl-2.0.html
Text Domain:  wpb-tutorial
Domain Path:  /languages
*/

Eklenti başlığını ekledikten sonra altına eklenti kodunu eklemeye başlayabilirsiniz.

Bu eğitimde, her makalenin sonuna kullanıcılardan bizi Twitter’da takip etmelerini isteyen bir mesaj ekleyen basit bir eklenti oluşturacağız.

Aşağıdaki kodu kopyalayıp eklenti başlık bloğunuzun altına yapıştırmanız yeterlidir:

<?php
function wpb_follow_us($content) {

// Only do this when a single post is displayed
if ( is_single() ) { 

// Message you want to display after the post
// Add URLs to your own Twitter and Facebook profiles

$content .= '<p class="follow-us">If you liked this article, then please follow us on <a href="http://twitter.com/wpbeginner" title="WPBeginner on Twitter" target="_blank" rel="nofollow">Twitter</a> and <a href="https://www.facebook.com/wpbeginner" title="WPBeginner on Facebook" target="_blank" rel="nofollow">Facebook</a>.</p>';

}
// Return the content
return $content; 

}
// Hook our function to WordPress the_content filter
add_filter('the_content', 'wpb_follow_us'); 

Değişikliklerinizi kaydetmeden önce Twitter ve Facebook profil URL’lerini kendi URL’lerinizle değiştirmeyi unutmayın.

Şimdi bilgisayarınızın masaüstüne gidin ve eklenti klasörü için bir zip dosyası oluşturun.

Mac kullanıcıları klasöre sağ tıklayıp ‘Compress wpb-plugin-tutorial’ seçeneğini seçebilirler. Windows kullanıcıları klasöre sağ tıklayıp ‘Zip dosyasına sıkıştır’ seçeneğini seçebilirler.

Adım 2: İlk WordPress Eklentinizi Kurun ve Etkinleştirin

Artık eklentiyi oluşturduğumuza göre, test edebilmeniz için yükleme zamanı geldi. Adım adım talimatlar için WordPress eklentisinin nasıl kurulacağına ilişkin makalemize göz atabilirsiniz.

Web sitenizdeki WordPress yönetici alanına gidin ve Eklentiler ” Yeni Ekle sayfasını ziyaret edin.

Eklentinizi yüklemek için en üstteki ‘Eklenti Yükle’ düğmesine tıklamanız gerekir. Bu size eklenti yükleme kutusunu gösterecektir.

Devam edin ve yeni oluşturduğunuz zip dosyasını seçmek için ‘Dosya Seç’ düğmesine tıklayın. Ardından, eklentiyi yüklemek ve kurmak için ‘Şimdi Yükle’ düğmesine tıklayın.

Kurulduktan sonra, devam edin ve eklentiyi etkinleştirin.

Artık eklentiyi çalışırken görmek için web sitenizi ziyaret edebilirsiniz.

Tüm tekli gönderilerinizin sonunda yeni paragrafı görebileceksiniz.

Adım 3: Eklentinizi WordPress.org Eklenti Deposuna Gönderin

Eklentinizin diğer WordPress kullanıcıları tarafından keşfedilmesini ve kullanılmasını istiyorsanız, WordPress.org’un eklenti deposuna gönderebilirsiniz.

Bunu yapmak için öncelikle eklentiniz için bir ‘Beni Oku’ dosyası oluşturmanız gerekecektir. Boş bir metin dosyası açın ve eklenti klasörünüze readme.txt olarak kaydedin.

Bu readme.txt dosyasının WordPress.org’un benioku dosyası sözdizimine uygun olması gerekir. Benioku.txt dosyasına eklediğiniz bilgiler eklentinizin WordPress.org’daki sayfasında görüntülenecektir.

Burada başlangıç noktası olarak kullanabileceğiniz örnek bir readme.txt dosyası bulunmaktadır:

=== Your Plugin Name ===
Contributors: WPBeginner
Tags: wpbeginner, plugin tutorial
Requires at least: 6.0
Tested up to: 6.2
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A WordPress plugin to teach beginners how to write a WordPress plugin. 

== Description ==

This simple plugin is part of our beginner's guide to writing a WordPress plugin. 

== Installation ==

1. Upload the plugin folder to your /wp-content/plugins/ folder.
1. Go to the **Plugins** page and activate the plugin.

== Frequently Asked Questions ==

= How do I use this plugin? =

Answer to the question

= How to uninstall the plugin? =

Simply deactivate and delete the plugin. 

== Screenshots ==
1. Description of the first screenshot.
1. Description of the second screenshot. 

== Changelog ==
= 1.0 =
* Plugin released.

Şimdi WordPress eklenti benioku dosyası sözdiziminin nasıl çalıştığını biraz açıklayalım, böylece bunu eklentiniz için özelleştirebilirsiniz.

Eklentinin beni oku kısmının ilk satırı eklenti adınızdır. Bu isim WordPress.org eklenti dizininde eklentinizin başlığı olarak görünecektir.

Bir sonraki satır Katkıda Bulunanlar’dır. Bunlar WordPress.org’da eklentinizi yönetmekten sorumlu kullanıcı kimlikleridir. Henüz bir WordPress.org kullanıcı hesabınız yoksa, kullanıcı kimliğinizi almak için ücretsiz bir WordPress.org kullanıcı hesabı oluşturabilirsiniz.

‘En az gerektirir’ ve ‘En fazla test edildi’ eklentinizin çalıştığı WordPress sürümlerini ifade eder. ‘Stable etiketi’ kendi eklentinizin sürümüdür.

‘Lisans’ alanlarını GPL olarak ve URL’yi aynı şekilde bırakabilirsiniz.

Ardından, eklentinizin ne yaptığını açıklamak için Açıklama alanını düzenleyebilirsiniz.

Eklentinizin benioku dosyasını düzenledikten sonra değişikliklerinizi kaydetmeyi unutmayın.

Artık eklentiniz WordPress.org’un eklentiler ekibi tarafından incelenmeye hazır. Eklentinizi göndermek için ücretsiz bir WordPress.org hesabına ihtiyacınız olacak.

Eklentinizi Ekleyin sayfasını ziyaret edin ve henüz giriş yapmadıysanız ‘lütfen giriş yapın’ düğmesine tıklayın.

Giriş yaptıktan sonra, eklentinizi yükleyebilir ve incelenmek üzere gönderebilirsiniz.

Eklentinizin zip dosyasını seçmek için ‘Dosya Seç’ düğmesine tıklamanız yeterlidir. Bundan sonra, geçerli olan tüm kutuları işaretleyin ve ‘Yükle’ye tıklayın.

WordPress.org eklenti inceleme ekibi daha sonra eklenti kodunuzu yaygın hatalar ve güvenlik kontrolleri açısından inceleyecektir. Onaylandıktan sonra eklenti ekibinden bir e-posta alacaksınız.

Bu e-posta, WordPress.org’da barındırılan eklentinizin Subversion (SVN) deposuna bir bağlantı içerecektir.

Adım 4: Eklentinizi Yüklemek için Subversion (SVN) Kullanın

Subversion bir sürüm kontrol yazılımıdır. Kullanıcıların dosya ve dizinlerde değişiklik yapmasına izin verirken, değişikliklerin kaydını tutar, farklı sürümleri yönetir ve işbirliğine izin verir.

Eklentinizi WordPress.org’a yüklemek için bilgisayarınızda kurulu bir SVN istemcisine ihtiyacınız olacak.

Windows kullanıcıları SilkSVN veya TortoiseSVN (ücretsiz) kullanabilir. Mac kullanıcıları bilgisayarlarına SmartSVN veya Versions App yükleyebilirler.

Bu yazıda size Mac için Versions Uygulamasının ekran görüntülerini göstereceğiz. Ancak, süreç GUI’ye sahip tüm SVN uygulamalarında çok benzerdir.

Kurulduktan sonra Sürümler uygulamasını açmanız ve WordPress eklentinizin deposunun bir kopyasını kontrol etmeniz gerekir. ‘Yeni Depo Yer İşareti’ düğmesine tıklamanız yeterlidir.

Bu, öncelikle bu yer imi için bir ad sağlamanız gereken bir açılır pencere getirecektir. Eklentinizin adını verebilirsiniz.

Bundan sonra, WordPress eklentinizin SVN depo URL’sini eklemeniz gerekir.

Deponuza bağlanmak için ‘Oluştur’ düğmesine tıklayın.

Versions Uygulaması şimdi eklentinizin deposunun bir kopyasını bilgisayarınıza indirecektir. Ardından, tarayıcı görünümünde depo adınıza sağ tıklayın ve ardından ‘Ödeme’ seçeneğini seçin.

Klasör için bir ad vermeniz ve bilgisayarınızda saklamak istediğiniz bir konum seçmeniz istenecektir. Eklenti dizininizle aynı klasör adını kullanabilir ve devam etmek için ‘Checkout’ düğmesine tıklayabilirsiniz.

Versions uygulaması artık bilgisayarınızda eklentinizin yerel bir kopyasını oluşturacaktır. Eklentinizin deposu altında görüntüleyebilir veya Finder uygulamasını kullanarak göz atabilirsiniz.

Şimdi eklenti dosyalarınızı kopyalamanız ve yerel deponuzun trunk klasörünün içine yapıştırmanız gerekir.

Bunu yaptığınızda, Sürümler uygulamasında yeni dosyaların yanında bir soru işareti simgesi göreceksiniz.

Bu dosyalar daha önce mevcut olmadığından, onları ‘Eklemeniz’ gerekir. Yeni dosyaları seçin ve bu dosyaları yerel klasörünüze eklemek için ‘Ekle’ düğmesine tıklayın.

Eklenti dosyalarınız subversion’a eklendiğine göre artık onları yüklemeye hazırsınız. Temel olarak, yerel klasörünüzdeki ve subversion dizinindeki değişiklikleri senkronize edeceksiniz.

Seçmek için yerel deponuza tıklayın ve ardından ‘Commit’ düğmesine tıklayın.

Yeni bir açılır pencere görünecektir.

Değişikliklerin listesini ve bir taahhüt mesajı eklemek için bir kutu göreceksiniz. Devam etmek için sadece ‘Commit’e tıklayın.

SVN uygulamanız şimdi değişikliklerinizi senkronize edecek ve bunları eklentinizin deposuna işleyecektir.

Artık eklenti dosyalarınızı trunk’a yüklediğinize göre, bunları bir sürüme etiketlemenin zamanı geldi.

Eklentinizin yerel kopyasına gidin ve trunk klasörünün içindeki dosyaları kopyalayın. Bundan sonra, tags klasörünü açmanız ve içinde yeni bir klasör oluşturmanız gerekir.

Bu klasöre bir sürüm adı verin. Eklentinizin başlığına girdiğiniz sürümle eşleştiğinden emin olun. Yukarıdaki örnek kodda, eklentimiz için 1.0 sürümünü kullandık.

1.0 klasörünü /tags/ klasörüne ekledikten sonra. Version uygulamasında klasör adının yanında soru işareti simgesini göreceksiniz.

Bu yeni bir klasör olduğundan, klasörü ve tüm dosyalarını depoya dahil etmek için ‘Ekle’ düğmesine tıklamanız gerekecektir.

Bundan sonra, devam edebilir ve değişikliklerinizi senkronize etmek için ‘Commit’ düğmesine tıklayabilirsiniz. Eklenti dosyalarınızı yerel kopyada düzenlemeye devam edebilirsiniz.

Değişikliklerinizi tamamladıktan sonra, WordPress.org deposu ile senkronize etmek için commit düğmesine tıklamanız yeterlidir.

Eklentinizde bazı büyük değişiklikler yaptıysanız, sürüm numarasından sonra adlandırılmış yeni bir klasör ekleyerek yeni bir sürüm eklemek isteyeceksiniz. Sürüm numarasının eklentinizin başlığıyla eşleştiğinden emin olun.

Artık eklentinizi WordPress.org eklentiler dizininde önizleyebilirsiniz.

Adım 5: WordPress.org’da Eklentinize Resim Ekleyin

WordPress.org, eklentilerinizle birlikte resim ve ekran görüntüleri eklemenize izin verir. Bu öğelerin standart adlandırma uygulamalarına uyması ve Subversion kullanılarak yüklenmesi gerekir.

Eklenti Başlık Bannerı

Bu, eklenti sayfasının en üstünde görünen büyük resimdir. Jpeg veya png dosya formatlarında 772 x 250 veya 1544 x 500 piksel olabilir. Her zaman bu şekilde adlandırılmalıdır:

• banner-772×250.jpg veya banner-772×250.png
• banner-1544×500.jpg veya banner-1544×500.png

Eklenti Simgesi

Bu daha küçük kare şeklindeki görüntü dosyası, arama sonuçlarında ve eklenti listelerinde eklenti simgesi olarak görüntülenir. Jpeg veya png dosya formatlarında 125 x 125 veya 250 x 250 piksel olabilir.

Bu simge dosyası şu şekilde adlandırılmalıdır:

• icon-128×128.jpg veya icon-128×128..png
• icon-256×256.jpg veya icon-256×256.png

Ekran Görüntüleri

Ekran görüntüsü dosyaları aşağıdaki format kullanılarak adlandırılmalıdır:

• ekran görüntüsü-1.png
• ekran görüntüsü-2.png

İstediğiniz kadar ekleyebilirsiniz. Bu ekran görüntüleri, benioku.txt dosyanızdaki ekran görüntüsü açıklamalarıyla aynı sırada görünmelidir.

Tüm çizimleri hazırladıktan sonra, bunları eklentinizin yerel kopyasının assets klasörüne yerleştirebilirsiniz.

Bundan sonra, varlıklar klasörünün yanında bir soru işareti simgesi göreceksiniz. Yeni varlık dosyasını deponuza eklemek için ‘Ekle’ düğmesine tıklayın.

Son olarak, devam edin ve dosyalarınızı WordPress.org deposuna yüklemek için commit düğmesine tıklayın. Bir süre sonra, eklenti sayfanızda resmin göründüğünü görebileceksiniz.

WordPress Eklenti Geliştirmeyi Öğrenmek İçin Nihai Kılavuzlar

WordPress eklentileri yukarıda gösterdiğimiz kadar basit olabilir. Ayrıca sınavlar, geri sayım sayaçları, LCV’ler, oylama, Google incelemeleri ve çok daha fazlası gibi çok daha güçlü olabilirler.

Bazı güçlü WordPress eklentilerinin eklentileri de olabilir. Bu eklentiler, diğer eklentileri genişleten eklentiler gibi çalışır.

WordPress eklentilerinize işlevsellik eklemenin daha fazla yolunu öğrenmenize yardımcı olacak bazı kaynakları burada bulabilirsiniz:

• Yeni başlayanlar için faydalı WordPress kod parçacıkları
• WordPress’te kısa kod ekleme
• functions.php dosyası artık siteye özel bir eklentide kullanabileceğinizhileler
• Özel gönderi türleri ve taksonomiler oluşturma
• WordPress’te stil sayfalarını ve JavaScript’i doğru şekilde ekleme

Umarız bu makale bir WordPress eklentisinin nasıl oluşturulacağını öğrenmenize yardımcı olmuştur. WordPress için yeni özellik önerilerinin nasıl yapılacağına ilişkin kılavuzumuza ve en başarılı WordPress işletmeleri ve şirketleri listemize de göz atmak isteyebilirsiniz.

If you liked this article, then please subscribe to our YouTube Channel for WordPress video tutorials. You can also find us on Twitter and Facebook.