WordPress, geliştiricilere eklentilerini yayınlama ve barındırma fırsatını eklenti dizini aracılığıyla sunmaktadır. Ancak, eklentilerinizi buraya yüklerken İngilizce dil becerilerinizi iyi bir şekilde kullanmanız gerekmektedir. WordPress bu süreci, Subversion adı verilen bir versiyon kontrol sistemi aracılığıyla gerçekleştirir. Subversion genellikle sunucu tarafında çalışır ve Linux sistemlerinde komut satırı üzerinden kullanılır. Bu rehberde, Windows ortamında bu sistemi nasıl kullanabileceğinizi detaylı bir şekilde anlatacağım. Dolayısıyla, sistemin kendi web sitesinde veya WordPress.org’da bulunan genel Subversion bilgilerinin bu yazının kapsamı dışında olduğunu belirtmek isterim.
İşlem Adımları Bu yazıda, “Advanced Random Posts” eklentimi WordPress eklenti dizinine eklerken gerçekleştirdiğim adımları tek tek açıklayacağım. Siz de bu adımları takip ederek, kendi eklentinizi kolayca dizine ekleyebilirsiniz.
- WordPress.org Hesabı Oluşturma İlk olarak, WordPress destek sayfasına giderek bir hesap oluşturuyoruz. Eklentinizi yükleme sürecinde bu hesaba ihtiyacınız olacak, bu yüzden kullanıcı adı ve şifrenizi güvenle saklayın.
- Eklenti Yayın İsteği Gönderme
Eklentinizi WordPress dizinine eklemek için https://wordpress.org/extend/plugins/add/ adrese giderek istekte bulunmanız gerekmektedir. Bu işlem için siteye giriş yapmış olmanız önemlidir. Başvurunuzu tamamlarken aşağıdaki bilgilere ihtiyaç duyacaksınız:
Eklenti Adı: İngilizce, uygun ve özgün bir isim seçin. Eklentinizin ismi için dizinde arama yaparak başka bir eklentiyle çakışmadığından emin olun.
Açıklayıcı Bilgi: Eklentinizin işlevini ve amacını birkaç cümle ile açıklayın. Bu açıklama İngilizce olmalı; diğer eklenti sayfalarını inceleyerek nasıl yazıldığını görebilirsiniz.
Eklentiye Özel Sayfa (Opsiyonel): İsterseniz, eklentiniz hakkında daha fazla bilgi içeren bir sayfa oluşturabilirsiniz. Bunu yapmazsanız, eklenti sayfanız varsayılan olarak WordPress dizini olacaktır. Ancak, daha profesyonel bir izlenim için özel bir sayfa hazırlamak önerilir.
Onay Sürecini Bekleme
İsteğinizi tamamladıktan ve gerekli bilgileri sağladıktan sonra başvurunuzu gönderin ve onay sürecini bekleyin. Başvurunuz onaylandığında, kullanıcı hesabınızda tanımlı e-posta adresinize aşağıdaki gibi bir bilgilendirme e-postası alacaksınız:
E-postada, eklenti dosyalarınızı yüklemeniz gereken dizin adresi (örneğin, http://svn.wp-plugins.org/advanced-random-posts/) ve süreci daha iyi anlamanıza yardımcı olacak bazı kaynak bağlantıları bulunur. Dosyaları bu dizine yüklerken WordPress.org kaydınız sırasında oluşturduğunuz kullanıcı adı ve şifreye ihtiyaç duyacaksınız.
- TortoiseSVN Programını İndirme ve Kurma
Eklenti dizinini yönetmek için kullanacağımız araç, sadece Windows ortamında çalışabilen TortoiseSVN’dir. TortoiseSVN, bir programdan ziyade kabuk (shell extension) olarak çalışır. Yani, kurulumun ardından doğrudan çalıştırabileceğiniz bir uygulama yerine, sağ tıklama menüsü aracılığıyla işlem yapabileceğiniz seçenekler eklenir. Kurulumu oldukça basittir ve “İleri” diyerek birkaç adımda tamamlanabilir. Kurulumdan sonra bilgisayarınızı yeniden başlatmanız gerekecektir. Programı resmi web sitesinden https://tortoisesvn.net/downloads.html indirebilirsiniz.
- Klasör Oluşturma
Bilgisayarınızda, eklentilerinizi düzenli bir şekilde saklayabilmek için bir klasör oluşturun. Örneğin, ben “Eklentilerim” adında bir klasörü E: sürücüsünde oluşturdum. Bu klasörü istediğiniz yerde ve isimde oluşturabilirsiniz. Ancak, klasörün yerini değiştirmek zorunda kalmayacağınız sabit bir konumda oluşturmanız işlemlerinizi kolaylaştıracaktır. - Depoyu (WP Eklenti Dizinindeki Alanı) Kontrol Etme
Oluşturduğunuz klasöre gidin ve boş bir alanda farenin sağ tuşuna tıklayın. Açılan sağ tıklama menüsünden SVN Checkout seçeneğini seçin. Bu adım, eklentinizi WordPress eklenti dizinindeki depoyla senkronize etmenizi sağlar.
SVN Checkout seçeneğini tıkladığınızda, karşınıza e-posta ile gelen dizin adresini ve dosyaların saklanacağı yerel klasörü belirteceğiniz bir ekran çıkacaktır. ‘URL of repository’ alanına, e-postanızda belirtilen dizin adresini (örneğin,http://svn.wp-plugins.org/advanced-random-posts/) girin. ‘Checkout directory’ bölümü, seçtiğiniz klasör yoluna göre otomatik olarak doldurulacaktır. Bu ekranda ayarları kontrol ettikten sonra, gösterilen seçenekleri onaylayarak işleme devam edin. Bu adım, eklenti dosyalarınızın depoya bağlanmasını ve WordPress dizini ile senkronizasyonu sağlar.
OK düğmesine tıkladığınızda, aşağıdaki gibi bir uyarı mesajı ile karşılaşacaksınız: Bu mesajda, dosyaların depolanacağı klasörün mevcut olmadığı ve bu klasörü oluşturmak isteyip istemediğiniz sorulacaktır. Yes seçeneğini tıklayarak, gerekli klasörün otomatik olarak oluşturulmasını onaylayın. Bu işlem, eklenti dosyalarınızı uygun klasöre depolamak için gerekli ortamı hazırlayacaktır.
Eğer her şey yolunda giderse, aşağıdaki gibi bir pencere görüntülenir ve klasör başarıyla oluşturulmuş olur. Bu aşamada, eklenti dosyalarınızı bu yeni oluşturulan klasöre depolayabilirsiniz. Klasörün düzgün bir şekilde oluşturulduğuna emin olduktan sonra, işleminizi devam ettirebilirsiniz.
Oluşturulan ‘advanced-random-posts’ klasörü içerisinde, aşağıdaki gibi üç ana klasör daha otomatik olarak oluşturulacaktır:
- branches
- tags
- trunk
Bu klasör yapısı, SVN (Subversion) versiyon kontrol sisteminin standart yapısını yansıtır.
- trunk: Ana geliştirme dalı (burada eklentinizin ana dosyaları bulunur).
- branches: Farklı geliştirme dallarının yer aldığı alan.
- tags: Yayınlanmış sürümler veya stabil versiyonlar için kullanılan alan.
Sonuç olarak, klasör yapınız şu şekilde olacak:
Read Me Dosyasını Hazırlama
Eklentinizle ilgili bilgileri içeren bir readme.txt dosyası oluşturmanız gerekmektedir. https://wordpress.org/extend/plugins/about/readme.txt Bu dosya, eklenti dizininde eklentinizin sayfasının oluşturulmasında kullanılacak ve dolayısıyla doğru şekilde hazırlanması oldukça önemlidir. Readme dosyasını hazırlarken belirli kurallara uymanız gerekiyor. Aşağıdaki örneğe uygun şekilde, kendi eklentinize özgü bilgileri girerek dosyanızı oluşturmalısınız. Dosyayı hazırladıktan sonra, WordPress’in readme doğrulayıcı http://wordpress.org/extend/plugins/about/validator/ aracını kullanarak doğru hazırlanıp hazırlanmadığını kontrol edebilirsiniz. Ayrıca, dosyanın başlık kısmındaki eklenti adı, açıklaması ve eklenti adresi gibi bilgilerin de doğruluğuna dikkat etmelisiniz.
İpuçları:
- Etiketler: Eklentinize uygun etiketleri belirlemek için diğer eklentilerden ilham alabilirsiniz.
- Dosya Konumu: readme.txt dosyasını eklentinizin ana klasörüne kaydetmelisiniz.
- Ekran Görüntüleri: Eğer açıklamalarda ekran görüntüsü kullanacaksanız, bunların isimlerini screenshot-1, screenshot-2, vb. şeklinde numaralandırarak kaydedin. Dosya uzantılarının (.webp, .webp, .webp) bir önemi yoktur.
- Stable Tag: Eklentinizin stabil sürümünü belirlerken, örneğin Stable tag: 1.0 yazabilirsiniz.
- Not Defteri Kullanımı: Dosyayı, Not Defteri gibi basit bir metin editörüyle readme.txt olarak kaydedin.
Dosyaları Trunk Klasörüne Kopyalama
Eklentinizin tüm dosya ve klasörlerini, readme.txt dosyasını ve varsa ekran görüntülerini trunk klasörüne kopyalayın. Bu, eklentinizin ana dizinine yüklemeye hazır hale gelmesini sağlayacaktır.
Dosyaları Yüklüyoruz
Trunk klasörüne tüm eklenti dosyalarınızı ve readme.txt dosyasını ekledikten sonra, dosyaları yüklemek için şu adımları izleyebilirsiniz:
- Trunk klasörüne gidin ve sağ tıklayın.
- Kısayol menüsünden SVN Commit seçeneğini tıklayın. Bu işlem, dosyalarınızı WordPress’in eklenti dizinine yükleyecektir.
Bu adımı takip ederek eklentinizin dosyalarını SVN aracılığıyla WordPress’e gönderebilirsiniz. Yükleme sırasında, dosyaların doğru bir şekilde eklenti dizinine gönderildiğinden emin olun.
Dosyaların Yüklenmesi
- SVN Commit seçeneğini tıkladığınızda, Trunk klasöründeki dosya ve klasörlerin listelendiği bir diyalog penceresi görüntülenecektir.
- Bu pencerede, yüklenecek dosyaların tümünü seçmek için pencerenin alt kısmındaki Select/deselect all seçeneğine tıklayın.
- Ardından, OK düğmesine tıklayarak dosyalarınızı WordPress eklenti dizinine göndermeye başlayabilirsiniz.
Bu işlem, tüm dosyaların doğru şekilde yüklenmesini sağlar ve eklentinizin yayına alınması için gerekli adımları atmış olursunuz.
Kullanıcı Adı ve Şifre Girişi
- OK düğmesine tıkladıktan sonra, karşınıza kullanıcı adı ve şifrenizi girmeniz gereken bir pencere çıkacaktır.
- Bu pencerede, WordPress.org hesabınızın kullanıcı adı ve şifresini girmeniz gerekecek.
- Eğer şifreyi her seferinde girmek istemiyorsanız, Save authentication seçeneğini işaretleyerek giriş bilgilerinizi kaydedebilirsiniz. Bu sayede, gelecekteki işlemler için şifreyi tekrar girmenize gerek kalmaz.
Kullanıcı adı ve şifrenizi girdikten sonra, dosyalarınız WordPress eklenti dizinine yüklenmeye başlayacaktır.
Dosyaların Yüklenmesi Tamamlandı
Her şey yolunda giderse, SVN Commit işleminden sonra aşağıdaki gibi bir ekran görüntülenecektir. Bu ekranda, yüklediğiniz dosyaların başarıyla eklendiğini görebileceksiniz.
- Yüklenen dosyalar, Trunk klasöründe bulunan dosyalarla uyumlu olarak listelenir.
- Bu ekran, dosyaların doğru bir şekilde WordPress eklenti dizinine gönderildiğini onaylamak için son bir kontrol fırsatı sunar.
Ekranı inceledikten sonra, OK düğmesine tıklayarak işlem tamamlanmış olur ve eklentiniz WordPress eklenti dizininde yayımlanmak üzere onay sürecine geçer.
Dosyaların Yüklenip Yayımlandığını Kontrol Etme
Eklentinizi yükledikten sonra, dosyaların başarıyla gönderilip gönderilmediğini kontrol etmek için şu adımları izleyebilirsiniz:
- Web tarayıcınızı açın ve Trunk klasörünüzün adresine gidin:
http://svn.wp-plugins.org/advanced-random-posts/trunk/ - Burada, yüklediğiniz dosyaların listelendiğini görmelisiniz. Eğer dosyalarınız doğru şekilde yüklendiyse, Trunk klasöründe yer alan eklenti dosyaları, readme.txt ve diğer ilgili dosyalar burada görünecektir.
Bu adımla, yüklediğiniz dosyaların doğru bir şekilde eklenti dizininde yer aldığını doğrulayabilirsiniz.
Eklentimizin Görünürlüğünü Kontrol Etme
Eğer readme.txt dosyanızı WordPress’in belirlediği kurallara uygun olarak doğru şekilde hazırladıysanız, eklentinizin başlığı ve açıklamaları, WordPress Eklenti Dizininde görünmeye başlayacaktır.
- WordPress Eklenti Dizinine gidin:
https://wordpress.org/plugins/ - Burada, eklentinizin adı ve açıklamaları, readme.txt dosyanızdaki bilgilerle eşleşen şekilde listelenecektir.
Eklentiniz, başlık ve açıklamaları doğru biçimde girdiğiniz takdirde, dizinde görünür hale gelir. Bu, eklentinizin kullanıcılar tarafından bulunabilir ve indirilebilir olduğunu gösterir.
Eklentimizin Sayfasının Görünürlüğü ve İndirilebilirlik Durumu
Eklentimizin başlığına tıklayarak, WordPress Eklenti Dizininde yer alan eklentimize ait sayfayı görüntüleyebiliriz. Bu sayfa, readme.txt dosyanızda sağladığınız bilgilere dayalı olarak otomatik olarak oluşturulur.
- Eklenti Sayfası: Sayfada, eklentimizin adı, açıklaması, sürüm bilgisi, kurulum talimatları gibi veriler yer alacaktır.
- İndirilebilir Hali: Eklentinin en son sürümü, kullanıcıların kolayca indirebileceği şekilde sayfada otomatik olarak yer alır.
- Sitemize Bağlantılar: Ayrıca, eklenti sayfasında eklentinin resmi web sitesi, destek sayfası gibi bağlantılar da bulunur, böylece kullanıcılar doğrudan sitemize yönlendirilir.
Eklentimizin başlığına tıkladığınızda, bu özelliklerin tümü doğru şekilde çalışacak ve kullanıcılara eklentiyi kolayca edinme imkanı sunacaktır.
Eklenti Güncellemeleri ve Yeni Sürümler
Bir sonraki yazımda, eklentimizin yeni sürümlerini nasıl dizine ekleyip güncelleyebileceğimizi adım adım anlatacağım. Bu işlemi, dizine eklediğim bir eklentimi güncellediğimde örnek olarak yapacağım.
Bu konuda, WordPress Eklenti Dizinindeki kaynak sitede kısa bir açıklama yer alıyor. İlgilenenler, şimdilik oradan da eklenti güncelleme işlemi hakkında bilgi edinebilirler. Yeni sürüm eklemek, eklentinizi sürekli güncel tutmak ve kullanıcılarınızın en son özelliklere erişebilmesini sağlamak adına oldukça önemli bir adımdır.