WordPress tema standartlarını anlamanın kapsamlı rehberi: oluşturmadan dağıtıma kadar.

WordPress tema kurallarına neden uymamız gerekiyor?

WordPress temalarının standartlara uygun olması, basit bir “en iyi uygulama”dan çok daha fazlasıdır; aslında başarılı bir temanın temel taşıdır. Bu standartlar sadece bir dizi teknik gereklilikten ibaret değildir; aynı zamanda temanın WordPress çekirdeği, binlerce eklenti ve gelecekteki sürümlerle uyumlu olmasını sağlayan bir sözleşmedir. Standartlara uygun bir tema, öngörülebilir bir yapıya, güvenli koda ve iyi performansa sahiptir; bu da doğrudan web sitesinin güvenliği, istikrarı ve arama motorlarına uygunluğu ile ilgilidir.

WordPress resmi ekibi, bu standartları “Theme Review Team” (Tema İnceleme Ekibi) aracılığıyla belirler ve sürdürür. WordPress’in resmi tema kataloğuna gönderilen tüm temalar, bu ekibin katı incelemelerinden geçmek zorundadır. Temanızı resmi kataloga göndermeyi planlamıyor olsanız bile, bu kurallara uymak sizin ve kullanıcılarınız için birçok avantaj sağlar: Popüler eklentilerle olası çakışmaları önler, gelecekteki bakım ve yükseltme işlemlerini kolaylaştırır ve kullanıcılara daha tutarlı ve güvenilir bir kullanım deneyimi sunar. Esasen, bu kurallar geliştiriciler ile tüm WordPress ekosistemi arasında uyumlu bir şekilde bir arada çalışmanın ortak dilidir.

Başlangıç Aşaması: Gerekli Dosyalar ve Klasör Yapısı

Standart bir WordPress teması, net ve standart bir dosya yapısıyla başlar. Bu sadece kodu düzenlemenin bir gerekliliği değil, aynı zamanda WordPress çekirdeğinin temanın bileşenlerini doğru bir şekilde tanıyıp yükleyebilmesi için de önemlidir.

Tavsiye edilen okuma WordPress Tema Geliştirme Kılavuzu: Başlangıçtan Uzmanlığa Kadar Tam Süreç Pratiği。

Ayrıntılı Çekirdek Dosya Açıklaması

Konunun ana dizini birkaç temel dosya içermelidir. Bunlar arasında…style.css Bu, bir temanın “kimlik kartıdır” ve dosya başlığındaki yorumlar, WordPress’in temayı tanımasının tek yoludur. Bu dosya en azından aşağıdaki bilgileri içermelidir:

UltaHost WordPress Sunucusu

30 gün iade garantisi, sınırsız bant genişliği ve veritabanı kullanımı, ücretsiz DDoS koruması; 3 yıllık abonelikte indirim (50%).

Sayfaya erişin.

/*
Theme Name: 你的主题名称
Theme URI: 主题的官方网站
Author: 作者名
Author URI: 作者的个人网站
Description: 主题的简短描述
Version: 1.0.0
License: GPL v2 or later
Text Domain: your-text-domain
*/

index.php Bu, temanın ana şablon dosyasıdır ve diğer tüm şablon dosyaları için bir yedek dosyadır. Ayrıca…functions.php Bu, temanın “Araç Çantası” bölümüdür ve işlevler eklemek, menüler oluşturmak, kenar çubukları gibi özellikleri yönetmek için kullanılır. screenshot.png Zorunlu değil, ancak bu, konunun arka planda gösterilen küçük resmidir. 1200×900 piksel boyutlarında ve net bir resim sağlamanızı şiddetle öneririz.

Şablon dosyaları ve organizasyon mantığı

WordPress, farklı sayfaları renderlemek için bir şablon hiyerarşisi sistemi kullanır. Standart bir tema, bu şablon dosyalarını mantıklı bir şekilde düzenlemelidir. Örneğin,single.php Tek bir makaleyi renderlemek için kullanılır.page.php Bağımsız sayfaları renderlamak için kullanılır.archive.php Kategorileri, etiketleri ve diğer arşiv sayfalarını renderlemek için kullanılır. Daha spesifik ihtiyaçlarınız için, örneğin… single-post.php 或 archive-product.php İşte böyle bir şablon.

Dizinlerin mantıklı kullanımı, projenin sürdürülebilirliğini artırabilir. JavaScript dosyalarını… /js 或 /assets/js Dizin ve CSS dosyaları şu yere konulmalıdır: /css 或 /assets/css Dizin, resimler ve yazı tipleri gibi statik kaynaklar şu klasöre yerleştirilir: /images 或 /assets Dizinleme, yaygın olarak kabul gören bir standart uygulamadır.

Geliştirme Temeli: Kod ve güvenlik standartlarına sıkı sıkıya uymak

Bu bölüm, tema standartlarının özüdür ve doğrudan temanın kalitesi, güvenliği ve performansıyla ilgilidir.

Tavsiye edilen okuma WordPress tema özelleştirme ve geliştirme tam kılavuzu: Başlangıçtan ileri düzeye kadar.。

PHP Kod Standartları ve WordPress API’leri

Tüm PHP kodlarınız WordPress kodlama standartlarına uymalıdır; bu, kodun okunabilirliğini ve tutarlılığını sağlar. Daha da önemlisi, yaygın görevleri yerine getirmek için WordPress tarafından sağlanan API’leri kullanmanız gerekir; yerel PHP fonksiyonlarını kullanmamalısınız. Örneğin, get_template_directory_uri() Konu dizininin URL’sini almak için, yol bilgisini sabit olarak kodlamak yerine şu yöntemi kullanın: wp_enqueue_script() 和 wp_enqueue_style() Bu, betiklerin ve stil şemalarının doğru bir şekilde yüklenmesini sağlar; bunun yerine şablonlarda doğrudan kullanılmazlar. <link> 或 <script> Etiketler.

function my_theme_scripts() {
    wp_enqueue_style( 'my-theme-style', get_stylesheet_uri() );
    wp_enqueue_script( 'my-theme-navigation', get_template_directory_uri() . '/js/navigation.js', array(), '1.0.0', true );
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );

Çekirdek Güvenlik ve Veri Kaçışı (Core Security and Data Escaping)

Güvenlik, pazarlık yapılamayan bir temel ilkedir. Ön uca dinamik olarak gönderilen tüm veriler, çapraz sitelik betik (XSS) saldırılarını önlemek için uygun şekilde işlenmelidir. WordPress, bu amaçla bir dizi işleme fonksiyonu sunar. esc_html()、esc_attr()、esc_url() 和 wp_kses_post()Uygun fonksiyonu seçmek için çıktının bağlamına göre hareket etmeniz gerekecektir.

// Doğru yöntem: HTML özniteliğinde karakterleri escape (dönüştürmek) etmek  
echo ‘<input type="“text”" value="“’" . esc_attr( $user_input ) ‘“>’// Doğru yöntem: HTML içeriğinde karakterleri escape (kaçırmak) yapmak  
echo ‘<p>’. esc_html($user_content)‘.‘</p>’;

Ayrıca, tüm kullanıcı girdilerine (gelen) yanıt verilmelidir. $_GET、$_POST、$_COOKIEDoğrulama ve temizleme işlemlerini gerçekleştirin; veritabanı ile etkileşim kurarken bu işlemleri kullanın. $wpdb SQL enjeksiyonlarını önlemek için sınıflar veya hazırlanmış ifadeler (prepared statements) kullanılmalıdır.

hosting.com Paylaşımlı Barındırma

AMD EPYC CPU'lar, NVMe SSD depolama ve LiteSpeed ile yüksek performans, 7/24, 7x7 uzman şirket içi destek, SSL, kaba kuvvet, kötü amaçlı yazılım ve DDoS koruması dahil gelişmiş güvenlik önlemleri, 73%'ye kadar tasarruf

Sayfaya erişin.

高级功能：集成核心功能与性能优化

Olgun bir modern WordPress teması, WordPress’in temel özelliklerini sorunsuz bir şekilde entegre etmeli ve performans açısından da dikkatli olmalıdır.

核心功能集成详解

Konunuzun onaylanması gerekiyor. add_theme_support() Fonksiyon, çekirdek özelliklere olan desteğini aktif olarak beyan eder. Bunlar arasında ancak bunlarla sınırlı olmamak üzere: makale özetleri (Featured Images), özel logolar (Custom Logo), başlık etiketleri (Title Tag), HTML5 işaretlemelerine destek ve özelleştirilebilir arka planlar bulunmaktadır.

function my_theme_setup() {
    // 支持文章缩略图
    add_theme_support( ‘post-thumbnails’ );
    // 支持自定义徽标
    add_theme_support( ‘custom-logo’ );
    // 让WordPress管理文档标题
    add_theme_support( ‘title-tag’ );
    // 对搜索表单、评论表单等使用HTML5标记
    add_theme_support( ‘html5’, array( ‘search-form’, ‘comment-form’, ‘comment-list’, ‘gallery’, ‘caption’ ) );
}
add_action( ‘after_setup_theme’, ‘my_theme_setup’ );

Navigasyon menüsü ve kenar çubuğu (araç çubuğu bölgesi) da gereklidir. functions.php Kullanıcılar, önce ilgili kayıt işlemlerini gerçekleştirmeli ve ardından ön uç şablonlarda bu özellikleri kullanabilmelidir. Bu sayede kullanıcılara esnek bir içerik yönetim yeteneği sunulmaktadır.

Tavsiye edilen okuma Sıfırdan profesyonel bir WordPress teması nasıl oluşturulur: Tam Geliştirme Kılavuzu。

Performans ve Modernizasyon Önlemleri

Performans, kullanıcı deneyiminin anahtarıdır. Tema, ön uç kaynaklarını (CSS, JS, resimler) mümkün olduğunca sade ve verimli hale getirmelidir. responsive (uyumlu) resimler kullanmak, önemsiz kaynakların gecikmeli olarak yüklenmesini sağlamak ve HTTP isteklerinin sayısını en aza indirmek temel gerekliliklerdir. Aynı zamanda, temanın ürettiği kod erişilebilirlik (WCAG) standartlarına uygun olmalıdır ki tüm kullanıcılar içeriklere engelsiz şekilde erişebilsin.

Daha karmaşık konular için, Gutenberg editörüne özelleştirilmiş destek sağlamayı düşünebilirsiniz; örneğin, editör için özel bir stil şeması (style sheet) oluşturarak…editor-style.cssVeya özel bloklar (Custom Blocks) oluşturabilirsiniz; bu, hem ön tarafta hem de arka tarafta daha tutarlı bir düzenleme deneyimi sağlar.

InterServer Paylaşımlı Barındırma

Paylaşımlı hosting aylık $2.50 USD, ilk ay $0.1 USD promosyon kodu tryinterserver, 461 bulut uygulaması komut dosyası, tek tıklamayla yükleme.

Sayfaya erişin.

Dağıtım ve Yayın: Son Kontroller ve Paketleme

Konu geliştirme işlemi tamamlandıktan sonra, dağıtımdan önce yapılacak son kontroller çok önemlidir.

Kapsamlı test

Temiz bir WordPress test ortamında, “Twenty Twenty” teması gibi varsayılan içerikleri ve birkaç temel eklentiyi kullanarak temanızı kapsamlı bir şekilde test etmeniz gerekiyor. Test edilmesi gereken konular arasında ancak bunlarla sınırlı olmamak üzere şunlar bulunmaktadır: En yeni WordPress sürümüyle uyumluluk, farklı cihazlarda responsif (uyumlu) tasarımın performansı, popüler eklentilerle uyumluluk, sayfa hızı testleri (Google PageSpeed Insights kullanılarak) ve PHP hata günlüklerinin incelenmesi. WP_DEBUG Ayarları yapın. trueHerhangi bir hata ayıklama kodu veya geçici dosyanın kalmadığından emin olun.

Paketin yayınlanması için hazırlıklar tamamlandı.

Nihai tema paketi yalnızca temanın çalışması için gerekli dosyaları içermelidir. Tüm geliştirme araçlarıyla ilgili dosyaları silin. .git İçindekiler,node_modules、package.jsonPhotoshop kaynak dosyası.psd）等。创建一个清晰的 README.txt Dosya, konunun işlevlerini, kurulum adımlarını, kullanım kılavuzunu ve sık karşılaşılan sorunları açıklamaktadır.

Eğer temanız üçüncü taraflardan elde edilen kaynakları (örneğin fontlar, ikon kütüphaneleri) içeriyorsa, lütfen bu kaynakların yeniden dağıtılmasına izin veren lisansların mevcut olduğundan emin olun ve ilgili lisans dosyalarını tema paketinizin içine ekleyin.

Özetle.

WordPress tema standartlarını öğrenmek ve bunlara uymak, her tema geliştiricisinin bir hobiden profesyonele geçiş yapmasının kaçınılmaz yoludur. Bu süreç, başlangıçtaki dosya yapısı planlamasından, katı kod ve güvenlik standartlarına, ardından temel özelliklerin derinlemesine entegrasyonuna ve performans optimizasyonuna kadar uzanır ve son olarak da titiz testler ve düzenli paketleme ile tamamlanır. Bu standartlar sadece bir kontrol listesi değil; aynı zamanda güvenilir, güvenli, sürdürülebilir ve geleceğe yönelik WordPress ürünleri geliştirmek için bir felsefedir. Bu standartlara bağlı kalırsanız, oluşturduğunuz tema sadece şu an için stabil bir şekilde çalışmakla kalmaz, aynı zamanda WordPress ekosisteminin sürekli evrimine de rahatça uyum sağlar.

Sıkça Sorulan Sorular.

Konunun `functions.php` dosyasına istediğimiz gibi kod ekleyebilir miyiz?

Olmaz.functions.php Dosyalar güçlü özelliklere sahip olsa da, “kod çöplüğü” haline gelmemelidir. Yalnızca temanın görünümü ve işlevleriyle doğrudan ilgili kodları eklemelisiniz. Karmaşık işlevsel mantıklar, bağımsız eklentiler olarak paketlenmelidir. Bunu yapmanın avantajı, temayı değiştirdiğinizde bile işlevlerin korunması ve kodun yeniden kullanılabilirliğinin ve sürdürülebilirliğinin artmasıdır.

Neden kaynakları yüklemek için `wp_enqueue_scripts` eylem kancasını kullanmak zorundayız?

Kullanın. wp_enqueue_scripts Action Hook’ları (ön uç kaynaklar için) ve admin_enqueue_scripts(Arka plan kaynakları için) Bu, WordPress tarafından resmi olarak önerilen bir kaynak yükleme yöntemidir. Bağımlılıkların doğru bir şekilde işlenmesini sağlar, tekrarlanan yüklemeleri önler ve önbellek eklentileri ile alt temalarla daha iyi bir şekilde uyum sağlar. Doğrudan entegre edilebilir. <link> 或 <script> Etiketler hatalı ve standartlara uymuyor.

Nasıl temamın çok dilli (uluslararasılaştırılmış) olmasını sağlayabilirim?

Konunuz için uluslararasılaştırma (i18n) hazırlıklarını yapmanız gerekiyor. Kodunuzda, kullanıcıya yönelik tüm metinler WordPress’in çeviri fonksiyonları ile sarılmalıdır; örneğin: ()、_e() 或 esc_html()Aynı zamanda, style.css Başlık kısmı doğru bir şekilde ayarlanmış. Text DomainVe kullanın. load_theme_textdomain() Bu fonksiyon, çeviri dosyalarını yüklemek için kullanılır. Böylece, topluluktaki çevirmenler Poedit gibi araçlar kullanarak temanız için dil paketleri oluşturabilirler.

Konu incelemesi sırasında en yaygın reddedilme nedenleri nelerdir?

En yaygın nedenler genellikle güvenlik ve kod standartları üzerinde yoğunlaşmaktadır. Bunlar arasında şunlar bulunmaktadır: Dinamik olarak üretilen verilerin doğru şekilde işlenmemesi (XSS güvenlik açığı), artık kullanılmayan veya önerilmeyen fonksiyonların kullanılması, URL’lerin veya yolların sabit olarak kodlanması, çeviri metinlerinin doğru şekilde işlenmemesi ve temel işlevlere olan desteklerin doğru bir şekilde belirtilmemesi (örneğin, bir işlevin desteklendiğinin unutulması). title-tagBu durum, sayfa başlığının görüntülenememesine neden olur. Göndermeden önce, resmi “Konu İnceleme Kılavuzu”nu dikkatlice incelemek bu tür sorunları önlemenin anahtarıdır.