WordPress Codean Standartlarına Başlayan Kılavuz
WordPress’in gerçek güzelliği açık kaynaktır. Bu nedenle, katkıda bulunabilir ve daha güçlü hale getirebilirsiniz. Evet. Sen. . Açık kaynak yazılımının kesin bir iş tarafı olmasına rağmen, arkasındaki felsefe basittir: Birlikte bir şeyler yapalım. Daha önce herhangi bir grupla çalıştıysanız, insanların egolarını kapıda kontrol etmesini ve iyi oynamasının ne kadar zor olduğunu biliyorsunuz. Bu nedenle, WordPress kodlama standardını yazma, HTML, CSS, JavaScript ve PHP yönergelerinin toplanması, kaynak kodu mümkün olduğunca temiz ve işlevsel tutmak için yazılı olarak yazılmıştır.
Al … işlevsel mi? Bu bir kod şakası. Neden WordPress kodlama standartlarına ihtiyacımız var? Yazma tarzım rahat, rahat ve kelimelerle dolu. Eşim toplandı, profesyonel ve özlü. Mülkünüz … tamamen farklı ve benzersiz bir şey. Hiçbiri kötü ya da yanlış değil, sadece farklı. Bu kod için de geçerlidir. HTML’m sizden farklı görünecek, JavaScript’im gözlerinizin kanamasını sağlayabilir ve CSS’niz çok güzel olabilir. Reçeteli kodun sözdiziminin yanı sıra, siz ve ben satır satır yazdıklarım biraz farklı olacaktır. WordPress kodlama standartları, sizden sonra gelen ve koda katkıda bulunan herkesin sadece çalışmanızı okuyabilmesini ve anlayabilmesini sağlamak, aynı zamanda sorunsuz bir şekilde ekleyebilmesini sağlamak için mevcuttur.
Katkıda bulunmak için ne bilmeniz gerekiyor? Standardı ilk gördüğünüzde, çok sınırlayıcı görünebilirler. Ve onlar böyledir. Eğer daha yumuşaklarsa, işlerini yapmayacaklar ve WP çekirdek kodu parçalanacaktır. Ancak belgeler çok eksiksiz, her ayrıntıyı hatırlamanıza gerek yok. Son çekme isteğiniz kabul edilmeden ve birleştirilmeden önce kodunuzu yıkıp hata ayıkladığınızda her parçaya atıfta bulunarak, ihtiyacınız olduğunda her şeyi arayın. Çekme isteği terimi sizin için yabancıysa, yeni başlayanlar için yeni başlayan kılavuzumuza bakın Git ve Github. WordPress kodu GitHub’da olduğu için gitmeye alışkın olmalısınız. WordPress kodlama standartlarına örnek olarak WordPress’i oluşturan her temel dilin kendi standartları vardır: PHP, JavaScript, HTML, CSS. Gerçekten bu amaca adanmışsanız, sonunda dördünde bir şeyler bağışlayabilirsiniz. Eğer katkıda bulunabileceğiniz gibi hissedebileceğiniz bir noktada değilseniz, sorun değil. Kodlama standartlarının çekirdeğini görmek ve incelemek, hazır olduğunuzda hayatınızı daha kolay hale getirecektir. HTML örnekleri hiç bir web sayfası açtınız, kaynak kodunu kontrol ettiniz ve daha sonra insanların kodu yazmanın iyi bir fikir olduğunu nasıl düşündüğünü görmek dehşete kapıldınız mı?
Hareket, onu ortadan kaldırmak için cinsel şiddeti ortaya çıkarır. Bu nedenle HTML standartları olduğu gibi düzenlenir. Standart W3C’nin kendisinin arkasında, bu, parmak kaslarınızın anısına uygulanmanız gereken standarttır. Kıvırcık parantezlerin dışındaki eğri, girinti çoğu kodun en tartışmalı unsurlarından biridir. CODEX WordPress bir sekme kullandığını ve açık ve kapak işaretlerinin dizilmiş olması için kod girintinizi oluşturmanız gerektiğini söylüyor. Not: Bu benim alışmam uzun zaman alıyor, çünkü kampınızda güçlüyüm ‘iki alanla belirtiyorsunuz’. Siz de, benim sempatim var. Bagus:
Merhaba, dünya!
Ahoy, Divi Nation!
Hoşçakal, dünya!
Kötü:
Merhaba, dünya!
Ahoy, Divi Nation!
Hoşçakal, dünya!
PHP ve HTML bayraklarını karıştırdığınızda aynı mantık da geçerlidir. Teklif Tırnaklar kullanın. Alıntı kullanmayın. Seçiminizdir, ancak herhangi bir şekilde kullanın. Uyarıldın. İyi:
E -posta adresiniz:
Veya
E -posta adresiniz:
Kötü:
E -posta adresiniz:
Yani … Alıntı = evet. Alıntı yok = kötü. Diğer HTML kodlama standartları için buraya gidebilirsiniz. CSS örnekleri CSS hakkında konuşurken standartların çoğu okunabilirlik içindir. WP’de birçok sınıf ve kimlik var. Dikkatli olmazsak, bu stil sayfası gerçek bir kabusa dönüşebilir. WordPress kodlamasının standart yapısı, CSS’nin sınıf seçmenlerinden ve kimliklerden stil ve parantezlere kadar her bir öğeye sahip olması gerektiğini söylüyor. Ayrıca, başkalarının takip edebileceği unsurlarınız için özel bir isim kullanmalısınız. İyi:#e-posta-div-tout,
#e-posta-div-blog {
Metin-align: merkez;
Ekran bloğu;
Marj: Otomatik;
}
Kötü: .Awesome-emets,. İnanılmaz-saming {text-align: center; Ekran bloğu; Marj: Otomatik; }
Ya da bu: .Awesome-e-postalar,#Amazing-Stuff {
Metin-align: merkez;
Ekran bloğu;
Marj: Otomatik;
}
WP’nin CSS yazma şeklinin her öğeyi daha kolay tanımlanmasını ve düzenlediğini görebilirsiniz.
Mülk, yapı ve seçim ile aynıdır, mülk mümkün olduğunca kısa ve mümkün olduğunca spesifik olmalıdır. Bu, diğer kullanıcıların hayatlarını biraz daha kolaylaştırır ve aynı zamanda kodun toplam boyutunu azaltır – ve WP geniş olduğunda, her bit ve bayt hesaplanır. İyi:#gönder-btn {
Ekran bloğu;
Arka plan: #000;
Renk: #fff;
Marj: 20px;
}
Kötü:#bjs-awesome-button {
Arka plan: Beyaz;
Renk: #ffffff;
Sınır: 35px;
Marj-sağ: 30;
}
İkincisi sadece çirkin. Ve awww’da değil, köpek çok çirkin ve komik. Ve kontrol edilecek daha fazla CSS standardı var.
Örnek JavaScript Birçok önemli JavaScript WordPress kodlama standartları vardır. Hatırlaması çok zor değil veya JS’nin en iyi uygulamasından gerçekten çok uzak, ama anlamanız gereken çok şey var. Hangi değişkenler değişkenler olmadan JavaScript olacak, biliyor musunuz? İyi ole var olmadan pek çok şey yapamazsınız ve bunu düzgün yaptığınızdan emin olmak istiyorum. Resmi yönergeleri izleyerek, repoyu etkileyen garip bir kapsamla ilgili sorunlardan farklı olan sorunlardan kaçınacaksınız. İyi: var b, j, k, harika, // Burada da sekmelerle girintili olmalısınız!
değer = “bir şey”;
Kötü:
var b = true;
var j = yanlış; // Kötü bir örnek olduğu için, işte yanlış yapılan bir yorum!
var k = b + j;
var harika = true;
Tamam yorumlar, bu yüzden belki yorumlar özellikle JavaScript kodunun bir parçası değildir, ancak bir yorum bağımlısıyım ve iyi belgelenen kodun bir sanat olduğunu düşünüyorum. Çekirdek ekip, beni gülümseten yorum yapmak için bazı iyi yönergeler derledi. Tek satır: bjk () işlevi;
// Kısa olun ve bir sonraki kod satırını açıklayın
$ (“Beej”). Beawesim ();
Bazı satırlar: /*
* Yıldızları tuttuğunuzdan emin olun
* Yorumlar koyduğunuzda dizildi
* Çoklu satırlar. Bunun gibi!
*/
Satırda: Bu yalnızca parametrelerin listesini eklemek için kullanılacaktır. Bjk işlevi (param1, param2, param7 / * Neden paramleri 3 ila 6 * / param 8 atladığımı açıklayın) {
// fantastik kod buraya gidiyor
}
Artık en iyileriyle ek açıklama yapabilirsiniz. Ve bunu yaptığınızda, JavaScript için tüm WordPress kodlama standartlarını okumanız gerekebilir. PHP WordPress örnekleri PHP yazılımıdır. Geliştiriciler ve katkıda bulunanlar son zamanlarda orada çok fazla JavaScript ekliyor, ancak yine de PHP hakim. PHP etiketi açılır ve PHP etiketinin kendi satırında olması gerekir (yine okunması kolaydır) ve kısaltmamalısınız. Bir kere. İyi:
Veya
Kötü Php:
Adlandırma Sözleşmesi: PHP birçok şey yapabilir. Çok. Ama bu da biraz dağınık. PHP ilk kez spagetti kodu terimini keşfettiğim ve WordPress kodlama standartlarını takip ederseniz, belki de bir şeyin adını doğru şekilde vererek temizlemeye yardımcı olabilirsiniz.
Yılanta işlev: function_name
Yılan vakalarında sınıf, ancak büyük harflerle: sınıf isimleri
Sınıf bir kısaltma olmadıkça, o zaman bir yılan başkenti: wp_js
Sabit ayrıca tüm büyük harfler, Yılan Kılıfı: Constant_Name
Dosyalar, bağlantı işareti ile tüm küçük harflerle yazılmıştır: wp-consig.php
Yılanta işlev: function_name