Eklentinizi WordPress.org'a Nasıl Yüklersiniz?

WordPress , web geliştirme için en iyi platformlardan biridir. Pekala, belki en yeni teknolojileri kullanmıyor ve mimarisi mükemmel değil (2003'te doğmuş bir proje olduğunu ve bu nedenle bazı eski kodlar ve kararlar olduğunu unutmayalım), ancak proje ilerliyor. iyi bir hız ve her yeni yinelemede modernize ediliyor. Bu modernizasyonun bir örneği, React.js üzerinde uygulanan ve WordPress ile çalışma şeklimizde devrim yaratmayı vaat eden yeni WordPress editörü Gutenberg'de bulunabilir.

WordPress nasıl bu kadar harika? Çünkü öğrenebileceğiniz ve katkıda bulunabileceğiniz son derece aktif bir topluluğa sahip ve web'in %29'unu yöneten motor olduğu için. WordPress kazanan bir attır, dolayısıyla üzerine bahse girebilirsiniz. Birkaç yıl önce yaptığımız buydu ve işte buradayız, WordPress'ten geçimimizi sağlıyoruz.

WordPress'e başlamak isteyen geliştiricilerden en çok aldığım sorulardan biri: İlk WordPress eklentimi nasıl oluşturabilir ve herkesin kullanması için WordPress.org'a nasıl yükleyebilirim? WordPress'te nasıl eklenti oluşturulacağını açıkladığımda, blogumuzda sorunun ilk bölümünü zaten tartışmıştık. Aslında, temanızın functions.php dosyasını değiştirmeden özelleştirmelerle nasıl eklenti oluşturulacağının basit bir örneğini bile gördük. Şimdi ikinci kısma odaklanalım: İlk eklentinizi WordPress.org'a nasıl yükleyeceksiniz.

Eklentinizi Yüklemeyi Düşünmeden Önce…

WordPress.org'a bir eklenti yüklemek için ihtiyacınız olan ilk şey eklentinin kendisidir. Ah! Ancak zaten bir tane varsa bile, yüklemeden önce göz önünde bulundurmanız gereken birkaç ipucu var:

1. MVP nedir ve WordPress'teki temel işlevselliğe nasıl karar verilir. Yeni bir projeye başlamak üzereyseniz, başarılı olup olmayacağını mümkün olan en kısa sürede belirlemek çok önemlidir – başarısız olması muhtemel bir şeye çok fazla kaynak ayırmanın bir anlamı yoktur. Bu yazıda minimum geçerli ürünün ne olduğunu ve yeni eklentinize başlamak için onu nasıl kullanabileceğinizi açıklayacağım.
2. WordPress Kodlama Standartları. WordPress , gönüllülerden oluşan bir topluluğa dayanan devasa bir projedir. Başka bir deyişle, projeye katkıda bulunan çok sayıda insan var. Bu yazıda, bu platform için kod programlarken hangi stil kılavuzlarını izlemeniz gerektiğini göreceğiz.
3. WordPress özgürlüğü işinizi öldürdüğünde. WordPress için eklentileri programlarken, yalnız olmayacağınızı ve eklentinizin muhtemelen diğer birçok eklentiyle birlikte çalışacağını her zaman aklınızda bulundurmalısınız. Düzenli olun ve eklentinizin gereksiz görevler gerçekleştirmediğinden veya olmaması gereken yerlere gereksiz komut dosyaları ve stiller eklemediğinden emin olun.
4. Başarılı Uluslararasılaşmanın İlk 6 Sırrı. WordPress için bir eklenti oluşturacaksanız, hedef kitlenin dünyanın her yerinden insanlar olduğunu ve bu nedenle eklentinizin uluslararasılaşmaya hazır olduğunu unutmamalısınız. Bu gönderi, bunun nasıl yapılacağını açıklar.

Umarım bu kaynaklar daha iyi bir eklenti oluşturmanıza yardımcı olur? Öyleyse, gerçekten ilgilendiğiniz şeye geçelim: eklentiyi WordPress.org'a nasıl yükleyeceğiniz.

İlk Kez Eklenti Nasıl Yüklenir

Eklentinizi WordPress.org'da ilk kez yayınlamak çok kolaydır: bu formu kullanarak eklentinizle birlikte bir zip dosyası göndermeniz yeterlidir. Eklentiniz gönderildikten sonra, inancına karar verecek bir manuel revizyondan geçecektir. Gözden geçirenler, " eklenti WordPress kodlama standartlarına uyuyor mu?" gibi bazı temel şeyleri kontrol eder. veya "tüm girdiler temizlendi mi?" Eklenti inceleme süreci genellikle birkaç gün sürer, bu nedenle daha önce bahsettiğim ipuçlarını uyguladığınızdan emin olun.

Bir eklenti gönderirken iki kez kontrol etmeniz gereken diğer bazı şeyler şunlardır:

• Eklentinin geçerli bir README.txt dosyasına sahip olduğundan emin olun. Bu dosya çok önemlidir, çünkü içeriği WordPress eklenti dizininde görünendir. Başka bir deyişle, dosyanın farklı bölümleri istediğiniz gibi olamaz, ancak bir “standart” izlemeniz gerekir. Örneğin, Nelio İçerik eklentimizde bu README.txt dosyası bulunur ve bu, aşağıdaki sayfayla sonuçlanır. README.txt dosyanızın biçimini doğrulamak için bu aracı kullanabilirsiniz.
• Tüm sınıfların ve işlevlerin onları benzersiz kılan bir önek olduğundan emin olun. Örneğin, eklentinizin AJAX çağrılarının geri çağrıları için Post_Ajax_API adlı bir sınıf veya kullanıcının hizmetinize abone olup olmadığını kontrol etmek için has_subscription adlı bir işlev oluşturmayın. Bunun yerine, bu adlara bir önek ekleyin: Nelio_Content _Post_Ajax_API ve nelio_content _has_subscription . Bu şekilde, benzer bir sınıf veya işlev kullanmak isteyebilecek diğer eklentilerle çakışmalardan kaçınırız. Alternatif olarak, PHP ad alanlarını kullanabilirsiniz.
• Ekrana yazdırılan tüm metin dizelerinin esc_html ve esc_attr işlevleriyle doğru şekilde çıkışlandığından emin olun. Aynı şekilde ve daha önce de söylediğim gibi, kullanıcı tarafından verilen herhangi bir veriye sanitize etme fonksiyonlarını uyguladığınızdan emin olun. Bunu yapmazsanız, eklentinizde güvenlik açıkları oluşturma riskini alırsınız.
• Eklentinize eklediğiniz tüm JavaScript ve CSS kaynaklarının eklentinin kendisinde olduğunu (ve üçüncü taraf sunuculardan alınmadığını) kontrol edin.
• Son olarak, eklentinize verdiğiniz isme dikkat edin. Belgelerde belirtildiği gibi, sahip olmadığınız bir ticari markayı kullanarak eklentinizi arayamazsınız (ve evet, buna “ WordPress “ kelimesi dahildir). Eklentinizin sunduklarının bir uzantısı olduğunu ima etmek için tescilli bir ticari markanın adını eklerseniz, bunu bir uzantı olduğu açık olacak ve ticari markayla hiçbir ilginiz olmayacak şekilde yapmalısınız. Kısacası son kullanımda kafa karışıklığına yol açmayacak bir isim koyun.

Bu kurallara uyun ve eklentinizin hemen kabul edileceğinden eminim.

Eklenti Güncellemelerini Yüklemek için SVN Nasıl Kullanılır

Eklentiniz kabul edildiğinde, posta kutunuza aşağıdakine benzer bir e-posta alacaksınız:

Eklenti barındırma isteğiniz onaylandı.

Bir saat içinde, adresindeki SVN deponuza erişebileceksiniz.
https://plugins.svn.wordpress.org/nelio-content/
WordPress.org kullanıcı adınız ve şifrenizle (forumlarda kullandığınızla aynı).

(…)

Eğlence!

Başka bir deyişle, yakında eklentinizin kaynak kodunu ve kullanıcılarınızın indirebileceği farklı sürümleri yönetebileceğiniz bir SVN deposuna sahip olacaksınız. Hiç SVN kullanmadıysanız ve nereden başlayacağınızı bilmiyorsanız endişelenmeyin, Git'e benzer ve kullanımı oldukça kolaydır. Bugün size bilmeniz gereken en temel kavramları anlatacağım.

SVN Deponuzu Yerel Olarak Kurun

Sonunda SVN deposuna erişim izni verildiğinde, yapmanız gereken ilk şey onu yerel bilgisayarınızda “klonlamaktır”. SVN terminolojisini kullanarak, yapacağınız şey projeyi kontrol etmektir. Bunu yapmak için aşağıdaki komutu yürütün:

 svn ödeme https://plugins.svn.wordpress.org/plugin-name/

Bu, klonlanmış projeyle plugin -name klasörünü yaratacaktır. checkout anahtar sözcüğünü değiştirdiğiniz bu komutun daha kısa bir sürümü var:

 svn ortak https://plugins.svn.wordpress.org/plugin-name/

Bu klasörün içine bir göz atarsanız, muhtemelen bilmediğiniz birkaç dizin olduğunu göreceksiniz. Ne olduklarına ve ne için kullanıldığına bakalım:

1. trunk . Bu, geliştirmenin gerçekleştiği dizindir. Buradaki kod, üretim ortamlarında kullanılmamalıdır, ancak muhtemelen oldukça kararlıdır.
2. assets . Bu dizin, WordPress.org'un eklentinizi listelemek için kullandığı farklı dosyaları içerir. Yani, eklentinizin simgesi , başlık resmi ve ekran görüntüleri. WordPress belgelerinde size afişlerin tam olarak hangi boyutlarda olması gerektiğini, kaç farklı simge (ve hangi boyutlarda) oluşturmanız gerektiğini ve ekran görüntülerini nasıl adlandıracağınızı açıklarlar.
3. tags . Bu klasörde, yayınladığımız farklı kararlı sürümleri ekleyeceğiz. Bunun hakkında daha sonra ayrıntılı olarak konuşacağız.
4. branches . Bu son dizin, eklentinizin farklı geliştirme dallarını oluşturabileceğiniz yerdir. Konuyla ilgileniyorsanız, şubelerin nasıl oluşturulacağı ve kodun nasıl birleştirileceği ile ilgili SVN belgelerini okuyabilirsiniz.

Sunucu Bilgileriyle Yerel Kopyanızı Nasıl Güncellersiniz?

Deponun yerel kopyanız sunucudakinin arkasındaysa, tek yapmanız gereken onu güncellemektir. Git'te bu, pull komutuyla yapılır. SVN'de bunu daha önce gördüğümüz checkout komutu ile yaparsınız. Proje dizininde olduğunuzu varsayarak şunu çalıştırın:

 svn ortak

ve işin bitti!

Sunucuda Değişikliklerinizi Nasıl Yapabilirsiniz?

Git'te bir projede yaptığınız değişiklikleri kaydetmek için iki komut vardır: commit ve push . İlki değişiklikleri yerel olarak işler ve ikincisi bunları sunucuya yükler. commit bu çok daha basittir: kodunuzu düzenledikten sonra, sadece kabul edin ve otomatik olarak sunucunuza yüklenecektir:

 svn taahhüdü

veya daha kısa bir sürüm kullanarak:

 svn ci

Eklentinizin Yeni Kararlı Sürümünü Nasıl Oluşturabilirsiniz?

Son olarak, eklentinizin yeni sürümlerini oluşturma hakkında konuşmamız gerekiyor. Örneğin, şu anda trunk bulunan kodun, eklentinin 2.1.0 sürümü olması gerektiğini varsayalım. Tek yapmanız gereken tags aynı ada sahip bir klasör oluşturmak ve içeriği trunk aşağıdaki gibi kopyalamak:

 svn ana hat etiketlerini kopyala/2.1.0

veya daha kısa versiyonu:

 svn cp ana hat etiketleri/2.1.0

Ve bu kadar! Kullanıcılarımızın taahhüt ettiklerinde indirebilecekleri yeni bir etiket oluşturduk. Ancak, WordPress'e 2.1.0 sürümünün kararlı sürüm olduğunu nasıl söyleriz?

Eğer trunk README.txt dosyasına daha yakından bakarsanız, başlıkta Stable tag adında bir öznitelik olduğunu göreceksiniz. Tek yapmanız gereken, değerini, kararlı olmasını istediğiniz sürüme "işaret edecek" şekilde değiştirmek. Örneğimizde, şöyle görünmesi gerekiyor:

 Kararlı etiket: 2.1.0

ve şimdi kodumuzu commit ve kararlı hale getirebiliriz!

Ama Kodumu Yönetmek için Git'i Kullanmayı Tercih Ederim…

Ee yapıyor muyuz! Eklentilerimizin kaynak kodu, Bitbucket'teki Git deposunda yönetilir. Yeni bir sürüm çıkarmak istediğimizde Git dizinindeki tüm değişiklikleri SVN projesinin trunk dizinine kopyalıyoruz ve az önce açıkladığım gibi yeni kararlı etiketi oluşturuyoruz. Aslında, bu adım o kadar yaygın ki, süreci otomatikleştirmek için bir komut dosyası bile oluşturduk?

Peki Şimdi Ne?

Artık ihtiyacınız olan tüm araçlara ve bilgiye sahipsiniz! Eklentiyi yükleyin ve kullanıcılarınıza yardım etmeye hazır olun. Adım adım müşteri tabanınızı artıracaksınız ve eklentiniz başarılı olacak. Bize aşağıdaki yorumlar bölümünde nasıl çalıştığını söyleyin?

Unsplash'ta Ash Edmonds'ın Öne Çıkan Görseli.