Anasayfa./Bilgi./WordPress/İçerik detayları.

WordPress tema geliştirme pratiği: Sıfırdan bire özel bir tema oluşturmanın kapsamlı rehberi

3 dakika okuma.
2026-03-21
2026-06-04
2,677
Aşağıdaki bağlantılar üzerinden alışveriş yaptığınızda, sizin için ek bir maliyet olmadan komisyon kazanıyorum.

Geliştirme Ortamı ve Proje Başlatma

Özel bir WordPress teması oluşturmaya başlamadan önce, verimli bir geliştirme ortamı oluşturmak çok önemli bir ilk adımdır. Bu sadece kodun standartlara uygun olmasını sağlamakla kalmaz, aynı zamanda geliştirme verimliliğini ve hata ayıklama deneyimini de büyük ölçüde artırır.

Yerel geliştirme ortamının kurulması

Yerel sunucu yazılımlarını kullanmanızı öneririz; örneğin Local by Flywheel, MAMP veya XAMPP. Bu yazılımlar, bilgisayarınızda PHP, MySQL ve Apache/Nginx içeren bir çalışma ortamı hızlı bir şekilde kurmanıza olanak tanır. Yerel sunucuyu kurduktan sonra, en yeni sürümdeki WordPress’i indirip yükleyin. Daha sonra, WordPress’in kurulum dizininde… wp-content/themes Klasörün içinde, örneğin, yeni bir klasör oluşturun. my-custom-themeBu, temanızın kök dizini olacaktır.

Temel konu dosyasının oluşturulması

En temel bir WordPress teması yalnızca iki dosyaya ihtiyaç duyar:style.css 和 index.phpÖncelikle, bir şeyler oluşturmak gerekir. style.css Bu dosyanın işlevi sadece stilleri tanımlamakla kalmaz; daha da önemlisi, dosyanın başındaki yorum bilgileri aracılığıyla WordPress’e temanız hakkında bilgi verir.

Tavsiye edilen okuma WordPress tema geliştirme kapsamlı rehberi: Sıfırdan özel WordPress web sitesi teması oluşturma.。

/*
Theme Name: My Custom Theme
Theme URI: https://yourdomain.com/
Author: Your Name
Author URI: https://yourdomain.com/
Description: 一个从零开始构建的自定义 WordPress 主题。
Version: 1.0.0
License: GPL v2 or later
Text Domain: my-custom-theme
*/

Text Domain Uluslararasılaştırma için kullanılır ve sonraki çeviri metinlerinin tanımlayıcısı olarak görev yapar. Ardından, en temel olanı oluşturulur. index.php Dosya, başlangıçta sadece basit bir HTML yapısını içerebilir. Bu iki dosyayı tamamladıktan sonra, WordPress arayüzündeki “Görünüm” -> “Temalar” bölümünde bu boş temayı görebilir ve etkinleştirebilirsiniz.

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%).
UltaHost LOGOSU Sayfaya erişin.

Konu Yapısı ve Şablon Seviyeleri

WordPress’in şablon hiyerarşisini anlamak, temalar geliştirmenin temelidir. Bu hiyerarşi, WordPress’in farklı isteklere (örneğin makale sayfaları, sayfalar, kategori arşivleri) göre hangi şablon dosyasını otomatik olarak seçip kullanacağını belirler.

Temel şablon dosyaları ve bunların işlevleri

WordPress, şablon dosyalarını belirli bir sırayla arar. En temel işlem akışı, en özelleştirilmiş şablodan en genel şabloya doğru ilerlemektir. Örneğin, tek bir makaleye erişildiğinde, WordPress sırasıyla şunları arar:single-post-{id}.php, single-post.php, single.phpSon olarak, singular.phpEğer hiçbiri bulunamazsa, o zaman şu yöntemi kullanın: index.phpAynı şekilde, ana sayfa öncelikle aramayı başlatacaktır. front-page.phpVe sonra gelir… home.phpBu hiyerarşik ilişkiyi kavramak, belirli şablon dosyaları oluşturarak farklı sayfaların düzenini hassas bir şekilde kontrol etmenizi sağlar.

Yaygın olarak kullanılan şablon dosyaları oluşturun.

Bunun dışında… index.phpTam bir tema yapısı oluşturmak için aşağıdaki temel şablon dosyalarını kademeli olarak oluşturmalısınız:
- header.phpWeb sitesinin üst kısmı, şunları içerir: <head> Bölge ve üst menü.
- footer.phpWeb sitesinin alt kısmı.
- sidebar.php: Yan menü.
- functions.phpKonunun işlevsel dosyasıdır; işlevlerin eklenmesi, menülerin ve araç çubuklarının kaydedilmesi gibi işlemler için kullanılır.
- page.php:Bir sayfanın renderlanması için kullanılır.
- single.php:Bir makalenin renderlanması için kullanılır.
- archive.phpKategorileri, etiketleri, yazarları ve diğer arşiv sayfalarını renderlemek için kullanılır.

在 index.php Burada, kullanabilirsiniz. get_header(), get_footer(), get_sidebar() Bu modüler bölümleri dahil etmek ve kod tekrar kullanımını sağlamak için şablon etiketlerini kullanın.

Tavsiye edilen okuma WordPress tema geliştirmeye derinlemesine bir inceleme: Temel tekniklerden ileri düzeye kadar bir rehber.。

Çekirdek Özellikler ve Tema Seçenekleri

functions.php Dosya, temanızın “beyni”dir; tüm arka uç mantığı ve işlevsel geliştirmeler burada gerçekleştirilir. Tema başlatıldığında otomatik olarak yüklenir.

Konu desteği ve kayıt özelliği ekleyin.

geçmek (bir fatura veya teftiş vb.) add_theme_support() Bu fonksiyonlar aracılığıyla, bir temanın desteklediği çeşitli özellikleri tanımlayabilirsiniz. Örneğin, makale özetlerinin (özel görsellerin) gösterilmesini etkinleştirmek, modern temalar için standart bir özelliktir.

function my_theme_setup() {
    // 添加文章和评论的 RSS feed 链接到 head
    add_theme_support( 'automatic-feed-links' );
    // 启用文章缩略图功能
    add_theme_support( 'post-thumbnails' );
    // 启用自定义菜单功能
    add_theme_support( 'menus' );
    // 让 WordPress 管理文档标题
    add_theme_support( 'title-tag' );
    // 启用对古腾堡编辑器的宽对齐和颜色支持
    add_theme_support( 'align-wide' );
    add_theme_support( 'editor-color-palette', array( /* ... */ ) );
}
add_action( 'after_setup_theme', 'my_theme_setup' );

Ayrıca, navigasyon menüsü yerlerini ve araç çubuğu (yan çubuk) bölgesini de kaydetmeniz gerekiyor.

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
hosting.com LOGO Sayfaya erişin. 
',
        'after_widget'  =&gt; '</tr>',
    ) );
}
add_action( 'widgets_init', 'my_theme_widgets_init' );'<section id="%1$s" class="widget %2$s">',
        'after_widget'  =&gt; '</section>',
        'before_title'  =&gt; '<h2 class="widget-title">',
        'after_title'   =&gt; '</h2>',
    ) );
}
add_action( 'widgets_init', 'my_theme_widgets_init' );

Stil şemalarını ve betik dosyalarını içe aktarın.

Doğru kaynakların dahil edilme yöntemi şu şekildedir: wp_enqueue_style() 和 wp_enqueue_script() İşlevleri, onları monte etmeye yardımcı olacak bir fonksiyon. wp_enqueue_scripts Kancada.

function my_theme_scripts() {
    // 引入主样式表
    wp_enqueue_style( 'my-theme-style', get_stylesheet_uri(), array(), wp_get_theme()->get('Version') );

// 引入自定义 JavaScript 文件
    wp_enqueue_script( 'my-theme-navigation', get_template_directory_uri() . '/js/navigation.js', array(), wp_get_theme()->get('Version'), true );

// 如果评论功能开启且是单篇文章/页面，加载评论回复脚本
    if ( is_singular() && comments_open() && get_option( 'thread_comments' ) ) {
        wp_enqueue_script( 'comment-reply' );
    }
}
add_action( 'wp_enqueue_scripts', 'my_theme_scripts' );

Döngüler ve Şablon Etiketleri

“Döngüler”, WordPress’in veritabanından içerik çekmek ve bu içeriği sayfada göstermek için kullandığı varsayılan mekanizmadır. Döngüleri anlamak ve doğru bir şekilde kullanmak, dinamik içeriklerin sunulmasının temelidir.

Standart bir döngünün yapısı

Şablon dosyalarında sık sık aşağıdakine benzer bir kod yapısı görürsünüz; bu, WordPress’in ana döngüsüdür.

Tavsiye edilen okuma WordPress Tema Geliştirme: Sıfırdan Başlayarak Özel Temalar Oluşturmak。

<article id="post-<?php the_ID(); ?>" no numeric noise key 1008>
            <header class="entry-header">
                <h2 class="entry-title"><a href="/tr/</?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
            </header>
            <div class="entry-content">
                <?php the_content(); ?>
            </div>
        </article>
    
    <p><p><strong>Üzgünüm, herhangi bir içerik bulunamadı.</strong></p></p>
<?php endif; ?>

have_posts() 和 the_post() Fonksiyonlar, döngünün nasıl ilerleyeceğini kontrol eder.the_title(), the_content(), the_permalink() `` ve ` `%>` gibi şablon etiketleri, mevcut makalenin belirli bilgilerini çıkarmak için kullanılır. Döngünün dışında ise, bu etiketleri istediğiniz yerde kullanabilirsiniz. is_home(), is_single(), is_page() Belirli koşullara dayalı etiketler kullanarak mevcut sayfa türünü belirleyebilir ve buna göre farklı mantık işlemleri gerçekleştirebilirsiniz.

Özelleştirilmiş sorgular ve döngüler

Bazen ana döngünün dışındaki içerikleri de göstermeniz gerekebilir; örneğin, ana sayfada belirli bir kategorideki makaleleri göstermek isteyebilirsiniz. Bu durumda şu yöntemi kullanabilirsiniz: WP_Query Kendi sorgularınızı oluşturmak için sınıflar kullanabilirsiniz.

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.
InterServer LOGO. Sayfaya erişin. 
<?php
$custom_query = new WP_Query( array(
    'category_name' => 'featured',
    'posts_per_page' => 3,
) );
if ( $custom_query->have_posts() ) :
    while ( $custom_query->have_posts() ) : $custom_query->the_post();
        // 输出文章内容...
    endwhile;
    wp_reset_postdata(); // 重置全局 $post 数据
endif;
?>

Özetle.

Sıfırdan bir WordPress teması geliştirmek, ortam kurulumundan, yapı planlamasına, işlevlerin gerçekleştirilmesinden dinamik içeriklerin gösterilmesine kadar tüm süreci kapsayan sistematik bir iştir. Temel nokta, sayfaların renderlanma mantığını belirleyen şablon hiyerarşisi mekanizmasını anlamaktır; bu mekanizmayı ustaca kullanmak çok önemlidir. functions.php Temanın işlevselliğini genişletin ve verileri çıkarmak için “döngüler” (loops) adı verilen temel yapıları öğrenin. WordPress kodlama standartlarına ve en iyi uygulamalarına uymak – örneğin kaynakları doğru bir şekilde dahil etmek, çeviri fonksiyonlarını kullanmak, yeterli tema desteği eklemek – temanınızın sağlam, verimli ve kolayca sürdürülebilir olmasını sağlayacaktır. Bu rehberdeki adımları uygulayarak, yapısal olarak bütünlüklü ve işlevsel olarak eksiksiz bir özel tema oluşturabilir ve daha ileri seviye geliştirmeler için sağlam bir temel atabilirsiniz.

Sıkça Sorulan Sorular.

WordPress teması geliştirmek için hangi temel teknolojileri bilmek gerekiyor?

PHP’nin (arka uç mantığı ve şablonlar için), HTML/CSS’nin (yapı ve stil için) ve JavaScript’in (etkileşim için) temel bilgilerine sahip olmanız gerekmektedir. En önemlisi, WordPress’in temel kavramlarını anlamanızdır; örneğin şablon hiyerarşisi, hook’lar (Eklentiler), eylemler ve filtreler (Actions & Filters), The Loop (Döngü) ve WordPress tarafından sağlanan çeşitli fonksiyonlar ve sınıflar.

Nasıl temamı Gutenberg editörünü destekleyecek hale getirebilirim?

Öncelikle, functions.php Çince'de kullanılır. add_theme_support() İlgili özellikleri etkinleştirin, örneğin… editor-styles、align-wide Ayrıca, özel bir renk paneli de bulunmaktadır. İkincisi, editör için özel bir stil şeması oluşturulmuş ve bunun aracılığıyla… add_editor_style() Fonksiyonların tanıtılması, arka uç düzenleyicinin görsel deneyiminin ön uç ile tutarlı olmasını sağlar. Ayrıca, daha zengin düzenleme özellikleri sunmak için Blok Stilleri (Block Styles) veya Özel Bloklar (Custom Blocks) oluşturabilirsiniz.

Konu geliştirme sürecinde çok dilli destek nasıl sağlanır?

WordPress, uluslararasılaştırma (i18n) işlemleri için GNU gettext çerçevesini kullanır. Kod içinde, çevrilmeye ihtiyaç duyan tüm metinler belirli fonksiyonlar kullanılarak sarılmalıdır. () PHP’de çeviri yapmak için kullanılır._e() Çeviri için kullanılır ve doğrudan geri yansıtılır.esc_html() HTML’yi çevirmek ve escape işlemlerini yapmak için kullanılır. JavaScript’te bu işlevler için belirli fonksiyonlar kullanılır. wp.i18n.__()Daha sonra, Poedit gibi araçları kullanarak bu metinleri çıkarın ve .pot dosyalarını oluşturun; ardından bu metinleri .po ve .mo dosyalarına çevirin. Son olarak, style.css Başlık kısmı doğru bir şekilde ayarlanmış. Text Domain Ve ayrıca… functions.php Çince'de kullanılır. load_theme_textdomain() Çeviri dosyası yükleniyor.

Kendi temama özel ayarlar sayfası nasıl eklerim?

Basit seçenekler için, WordPress’in yerleşik “Özelleştirici” (Customizer) API’sini kullanabilirsiniz; bu API, kullanıcı dostu ve gerçek zamanlı bir önizleme arayüzü sunar. Daha karmaşık ihtiyaçlar için ise “Seçenek Sayfası” (Options Page) tabanlı ayar arayüzleri oluşturulabilir. Ayarların güvenli bir şekilde kaydedilmesi, doğrulanması ve yönetilmesi amacıyla WordPress Settings API’sinin kullanılması önerilir. Ayrıca, özel alanlar (custom fields) oluşturma ve Seçenek Sayfaları’nı yönetme sürecini büyük ölçüde kolaylaştıran ACF (Advanced Custom Fields) veya Carbon Fields gibi üçüncü parti kütüphanelerden de yararlanabilirsiniz.

Bir sonraki adım, bundan sonra ne yapmalıyım?

Eğer bir WordPress web sitesi oluşturuyorsanız veya optimize ediyorsanız, performans optimizasyonu, eklenti yapılandırması ve tema özelleştirmesi ile ilgili konuları okumaya devam etmeniz önerilir.

Daha fazla okuma ve pratik bilgiler.

Aşağıdaki içerikler bu makalenin konusuyla ilgilidir ve daha fazla okumak için uygundur. Öncelikle mevcut sorununuza en yakın makaleden başlayın, sonra çevresel konulara doğru ilerleyin, genellikle daha iyi sonuçlar alırsınız.

Etiketler: