Subversion'ı WordPress Eklenti Dizini ile Kullanma

Genel WordPress Eklenti Dizinine eklenti eklemek ve güncellemek için bu adım adım talimatları izleyin.

Videodaki bu temel adımlar aşağıdaki gibidir:

• Eklentinize Başlarken
• Bir WordPress.org Hesabı için Kaydolun
• Yeni Eklentinizi WordPress Eklenti Dizinine Yerleştirme İsteği
• Makineniz İçin Bir SVN İstemcisi Kurun
• Projeleriniz için Yerel Dizin Seçin
• Eklenti Talebi Onay E-postanız
• Bu Makale için Dizin Şartları
• Yeni Sunucu Dizinini Yerel Makinenize Çekmek
• Eklentinizi Geliştirmeyi Bitirin
• İlk Sürümünüzü Herkese Açık Hale Getirin
  • Proje dizini ana hattını güncelleme
  • Sunucuda yeni bir sürümü etiketleme
  • Yerel proje dizininizi yeni etiketli sürümle güncelleme
  • readme.txt kararlı etiketini güncelleme
• Eklentiniz İçin Yeni Gelişmeler

Eklentinize Başlarken

İster yeni bir fikriniz olsun ister 0.1 sürümüyle işiniz bitmek üzere olsun, eklentiniz için bir ada ve açıklamaya ihtiyacınız vardır. Eklentinin ne yaptığı hakkında bir fikir vererek adı kısa ve açıklayıcı yapın. “Wax on Wax off Plugin” iyi bir isim değil. “Drop Shadow Maker” çok daha iyi. Asıl başlığa “Plugin” eklemeniz gerekmez.

Başlığınızla birlikte gitmek için, insanlara eklentinizin ne gibi faydalar sağladığını anlatan kısa bir açıklama yazmalısınız. Bu açıklamanın 150 karakterin altında olmasını tavsiye ederim.

Bir WordPress.org Hesabı için Kaydolun

Destek forumlarında ve benzerlerinde etkileşim kurmak için kullanılan bir WordPress.org hesabınız yoksa, bir tane edinmeniz gerekir. Basitçe şu adrese gidin: https://login.wordpress.org/register

Yeni Eklentinizi WordPress Eklenti Dizinine Yerleştirme İsteği

Uyumlu bir lisansla sağlanan en makul eklentiler, WordPress Eklenti Dizininde yer kaplayabilir.

1. Şu adrese gidin: http://wordpress.org/extend/plugins/add/
2. Başlığınızı ve Açıklamanızı Doldurun
   (Sana buna ihtiyacın olacağını söylemiştim!)
3. Eklentiniz kullanıma hazır olsa bile, bu formdan eklentinizin yüklenmesini atlayın.

Eklenti dizini isteğiniz gerçek kişiler tarafından işlenir, bu nedenle biraz zaman alabilir.

Makineniz için bir SVN İstemcisi Kurun

Eklenti Dizini ile çalışmak için makinenizde bir Subversion istemcisine ihtiyacınız var.

• Windows için TortoiseSVN'yi öneririm.
• Mac için SCPlugin iyi bir paket gibi görünüyor.

Sadece birini seçin ve kurun. Bunun hakkında söylenecek fazla bir şey yok.

Projeleriniz için Yerel Dizin Seçin

Subversion, eklenti dosyalarınızın yerel bir kopyasını WordPress Eklenti Dizini ile güncel tutacaktır. Subversion tarafından izlenen tüm projelerinizi tutacağınız yerel makinenizde bir dizin oluşturmanızı öneririm. Dikkat: Yerel makinenizde bir web geliştirme ortamınız varsa, yerel web sunucunuzun WordPress eklentileri dizinini proje dizininiz olarak kullanmaya kalkışmayın.

Örneğin, makinenizde eklentiler klasörünün bulunduğu yerel bir WordPress kurulumunuz varsa:

documents/public_html/devdomain.com/wp-content/plugins/

… WordPress Eklenti Dizini projelerinizi senkronize etmek için bu dizini kullanabileceğinizi düşünmeyin. Bu size acı verecektir.

Bunun yerine, şu örnekteki gibi bir dizin oluşturun:

documents/projects/wp-plugins-public/

Eklenti proje klasörlerinizin her biri "wp-plugins-public" içine girecektir. Bu eğitim için “content-scheduler” adlı bir eklenti klasörü kullanacağım. Böylece, şöyle bir dizin oluşturmuş olacağım:

documents/projects/wp-plugins-public/content-scheduler

Eklenti Talebi Onay E-postanız

Eklenti isteğiniz onaylandıktan sonra, SVN havuzunuzun bağlantısını içeren bir e-posta alacaksınız. Bu, özellikle o eklenti içindir ve Subversion senkronizasyonunuza devam etmek için gereklidir.

Bu Makale için Dizin Şartları

Bu makalede bahsedilen pek çok farklı dizin, proje ve klasör varken kafanın karışması kolay olabilir. Bu Subversion iş akışıyla çalışırken üç farklı konum üzerinde anlaşalım.

1. Çalışma dizini
   Bu, değiştirdiğiniz ve test ettiğiniz kodun mevcut kopyasıdır. Geliştirme web sunucunuzdaki “/wp-content/plugins/” klasöründe olmalıdır. Benim makinemde şöyle olur:
   documents/public_html/devdomain.com/wp-content/plugins/content-scheduler/
2. proje dizini
   Bu, Subversion istemcinizin WordPress Eklenti Dizini ile senkronize olmaya devam edeceği dizindir. Benim makinemde bu:
   documents/projects/wp-plugins-public/content-scheduler/
3. sunucu dizini
   Bu, projenizin WordPress Eklenti Dizininde depolandığı şekliyle ifade eder. Bu, halkın eklentinizi alabileceği yerdir. Kök konumu "SVN deponuz" olarak adlandırılır ve eklenti isteği onay e-postanızda size atanır. Benim örneğim için, bu:
   http://plugins.svn.wordpress.org/content-scheduler

Yeni Sunucu Dizinini Yerel Makinenize Çekmek

Eklenti Dizinindeki yeni eklenti konumunuza herhangi bir dosya koymamış olsanız bile, dizinin o kopyasını makinenize indirmeniz gerekir. Bunu yapmak, Subversion istemcinizin neyin güncel olup neyin olmadığını bilmesine yardımcı olmak için perde arkasına bazı işaretler koyar.

1. Proje dizini eklenti klasörünüzü sağ tıklayın.
2. “SVN Checkout”u seçin.
3. WordPress SVN veri havuzu URL'nizi (onay e-postanızdan) ilk alana girin.
4. Proje dizini eklenti klasörünüz ikinci alanda olmalıdır.
   Bu işlemi o klasöre sağ tıklayarak başlattığınız için, bu alan zaten doldurulmuş olmalıdır.
5. "Tamam" ı tıklayın

Eklentinizi Geliştirmeyi Bitirin

Eklentinizi geliştirin ve test edin. Bu, onunla birlikte gitmek için uygun bir “benioku.txt” dosyası oluşturmayı içerir. “Benioku.txt” dosyası, eklentinizle ilgili rastgele notlardan ibaret değildir. WordPress Eklenti Dizini, eklentinizin hangi sürümünün güncel olarak kabul edildiğini anlamak ve ayrıca eklenti sayfanızın içeriğini Dizin'de oluşturmak için “readme.txt” dosyasının içeriğini kullanır.

• Uygun bir "benioku.txt" dosyası oluşturma hakkında daha fazla bilgi için bu WordPress benioku.txt örneğine bakın.

“Benioku.txt” dosyanızın önemli bir parçası “Kararlı” etiketidir. Eklentinizi geliştirirken bu etiketi "gövde" olarak bırakın. Genel kullanım için bir sürüm yayınladığınızda, bunu doğru sürüm numarasıyla güncelleyeceğiz.

İlk Sürümünüzü Herkese Açık Hale Getirin

Proje dizini ana hattını güncelleme

1. Çalışma dizininizin içeriğini proje dizininizin “gövde” klasörüne kopyalayın.
   Benim durumumda, eklentimin tüm içeriğini çalışma dizininden kopyalıyorum:
   /documents/public_html/devdomain.com/wp-content/plugins/content-scheduler/
   proje dizinime:
   /documents/projects/wp-plugins-public/content-scheduler/
2. Proje dizininizdeki “content-scheduler” eklenti klasörüne sağ tıklayın ve “SVN Commit” seçeneğini seçin.
3. İsterseniz taahhüt için bir yorum girin.
4. Yeni olarak kabul edilen ve sunucuya kopyalanacak dosyaların listesini gözden geçirin. Bu liste doğru görünüyorsa, “Tamam”a tıklayın ve dosyalar wordpress.org adresindeki sunucu dizininize kopyalanacaktır.

Sunucuda yeni bir sürümü etiketleme

"Trunk"taki dosyaları güncellediniz, ancak halkın indirmesi gereken şey bu değil. "gövde"nin bir kopyasını oluşturmak için "etiketleme" kullanmanız gerekir. Bu kopya daha fazla değiştirilmeyecek ve genel kullanıma sunulacaktır. Bu örnek için bir sürüm 1.0 oluşturalım.

1. Proje dizininin “trunk” klasörüne sağ tıklayın ve “Dal/Etiket”i seçin.
   Benim için bu:
   /documents/projects/wp-plugins-public/content-scheduler/trunk/
2. "URL'ye" konum alanı "/trunk" ile bitecektir. 1.0 sürümünüzü oluşturmak için bunu “/tags/1.0” olarak değiştirmeniz gerekir.
3. Dilerseniz bu etiketleme işlemi ile ilgili bir not ekleyebilirsiniz.
4. “Tamam” ı tıklayın ve “bu dalda değişiklik yapılması önemli…” ile ilgili herhangi bir mesajı yok sayın .

Yerel proje dizininizi yeni etiketli sürümle güncelleme

Az önce sunucuya proje dosyalarınızın yeni bir kopyasını “/tags/1.0” dizininde yapmasını söylediniz. Şimdi, yerel proje dizininizi bu yeni etiketle güncel hale getirmemiz gerekiyor.

Bu süreç garip görünebilir. Yerel “/tags/1.0” dizininizde neden kendi kopyanızı oluşturamadığınızı merak edebilirsiniz. Bunu yaparsanız, sunucu dizini ve proje dizini, neyin güncellenip neyin güncellenmediği konusunda dağınık ve kafası karışabilir.

• Proje dizinine tekrar sağ tıklayın ve “SVN Güncellemesi”ni seçin.
  Bu, sunucu dizinindeki değişiklikleri yerel proje dizininize çeker. Bu durumda değişiklik, dosyalarınızın “/tags/1.0” kopyasının eklenmesidir.

readme.txt kararlı etiketini güncelleme

Halkın eklentinizi kullanması için tüm doğru dosyalar mevcuttur. Ancak, eklenti dizinine halkın hangi etiketli sürümü kullanması gerektiğini söylemeliyiz.

1. Yerel proje dizininizin “trunk” klasöründeki “benioku.txt” dosyasını düzenleyin.
   Benim için, bu aşağıdaki gibidir:
   /documents/projects/wp-plugins-public/content/scheduler/trunk/readme.txt
2. "Kararlı etiketi", yayın sürümünüz "1.0" olarak değiştirin
3. Dosya 'yı kaydet
4. Yeni güncellediğiniz “readme.txt” dosyasına sağ tıklayın ve “SVN Commit” seçeneğini seçin.

Bu kadar! 15 dakika içinde:

1. WordPress Eklenti Dizini proje listenizi güncelleyecektir
2. "1.0" kararlı etiket olarak görülecektir
3. Projenizin sayfasını doldurmak için “/tags/1.0/readme.txt” içindeki bilgiler kullanılacaktır.

Eklentiniz İçin Yeni Gelişmeler

Büyük olasılıkla, eklentinizde iyileştirmeler yapacaksınız ve bunları yayınlamanız gerekecek. İşte bu nasıl çalışıyor.

1. Çalışma dizininizdeki eklentide değişiklikler yapın.
   Bu değişiklikler, Changelog girişleri gibi, gerektiğinde readme.txt dosyasındaki değişiklikleri içermelidir.
2. Çalışma dizininizdeki değişiklikleri yerel proje dizininize kopyalayın.
3. Benioku.txt dosyasının geçerli genel sürüm için doğru "kararlı" etikete sahip olduğundan emin olun.
4. Proje dizinine sağ tıklayın ve yeni ana hat değişikliklerinizi sunucu dizinine almak için “SVN Commit” öğesini seçin.
5. Proje dizininizdeki "trunk" dizinine sağ tıklayın ve yayın için yeni bir sürüm etiketi oluşturmak için "Dal/Etiket"i seçin. ("Depoda kopya oluştur:" öğesinin "Çalışan kopya" olarak ayarlandığından emin olun.)
6. Proje dizinine sağ tıklayın ve sunucu dizininden etiket değişikliklerini aşağı çekmek için “SVN Güncelleme”yi seçin.
7. Proje dizininin “/trunk/readme.txt” dosyasındaki kararlı etiketi, oluşturduğunuz yeni yayın etiketiyle eşleşecek şekilde güncelleyin.
8. Proje dizinine sağ tıklayın (evet, bir kez daha) ve güncellenmiş benioku.txt dosyanızı sunucuya almak için “SVN Commit” öğesini seçin.

Vay canına. Bu kadar!

• geliştiriciler
• wordpress.org