WordPress'te kısa kodlar nasıl eklenir

Yayınlanan: 2021-07-10

Sitenize kısa kodlar eklemek ister misiniz? Doğru yere geldiniz. Bu kılavuzda, WordPress'te kısa kodları nasıl ekleyeceğinizi ve bunlardan en iyi şekilde yararlanabilmeniz için size bazı örnekler göstereceğiz.

2.5 sürümünde WordPress'e kısa kodlar eklendiğinden, kullanıcılar bunları her türlü özelleştirmeyi elde etmek için kullanıyor. Kısa kodlar çok kullanışlıdır ve gönderilerde, sayfalarda ve web sitelerimizin neredeyse her yerinde belirli bir kod parçasını çalıştırmamıza izin verir. Üstelik, en deneyimsiz kullanıcılar için bile kullanımı çok kolaydır.

Kısa kodlar nelerdir?

Kısa kod, her zaman köşeli parantez içine alınmış kısa kodun adıyla belirtilen bir kod parçasını tetikler: [shortcode-name]

Her kısa kodun çalıştırdığı kod, kısa kodun nasıl oluşturulduğuna bağlıdır. Birçok eklenti kendi kısa kodlarını sağlar ve WordPress ayrıca varsayılan olarak bazılarını içerir. Ve en iyi yanı, WP kısa kod API'sinin kendi özel kısa kodlarınızı oluşturmanıza izin vermesidir.

Kısa kodlar, sitenizin herhangi bir yerine herhangi bir komut dosyası eklemenize izin verdikleri için geliştiriciler için harika bir araçtır. Aynı komut dosyasını birçok kez kullandığınızda, kodu tekrarlamak zorunda kalmadan aynı kısa kodu kullanabilirsiniz. Bu, zamandan tasarruf etmenize ve kodunuzu temiz tutmanıza yardımcı olur.

Ek olarak, bir kısa kod, işlevlerin parametrelerine benzer şekilde çalışan bazı değerler alabilir.

[ shortcode val1='hi' val2='ok' ]

Ayrıca bu [ kısa kod ] some text [ /shortcode shortcode ] kısa kodları açarken ve kapatırken bir HTML etiketi olarak da kullanılabilir.

Özetle, bir kısa kod, herhangi bir kod yazmadan (mevcut bir kısa kodsa) ön uçta bir PHP betiği çalıştırmanıza izin verir. WordPress ve bazı eklentilerin varsayılan olarak bazı kısa kodları vardır, ancak ihtiyaçlarınıza göre kendi kısa kodlarınızı da oluşturabilirsiniz.

Son olarak, farklı kısa kod türleri vardır: galeriler, WooCommerce ürünleri, formlar, resimler ve çok daha fazlasını eklemek için. Her kısa kod farklıdır ve farklı şeyler yapar.

Daha fazla bilgiye ihtiyacınız varsa, kısa kodlarla ilgili bu eksiksiz kılavuza bakın.

Artık ne olduklarını daha iyi anladığımıza göre, WordPress sitenize nasıl kısa kod ekleyeceğinizi görelim.

WordPress'te kısa kodlar nasıl eklenir

Başlamadan önce, her kısa kodun farklı şekilde oluşturulduğundan, değerlerinin olabileceğini veya olmayabileceğini not etmek önemlidir. Bu değerler her kısa kod için özeldir ve istediğimiz sonucu elde etmek için değerleri koda iletirler.

Daha önce de belirttiğimiz gibi, farklı kısa kod türleri vardır ve WooCommerce kısa kodları en yaygın olanlardan bazılarıdır. Örneğin, [ woocommerce_cart ] kısa kodu, yapıştırdığınız her yerde WooCommerce sepetini görüntüler.

Test etmek için kısa kodu bir gönderiye veya sayfaya yapıştırmanız veya şöyle yazmanız yeterlidir: [ woocommerce_cart ] . Ardından, ön uca bir bakın ve kısa kodu eklediğiniz yerde WC arabasını göreceksiniz.

NOT : Bazı çekirdek dosyaları düzenleyeceğimiz için başlamadan önce sitenizin tam yedeğini almanızı ve bir alt tema oluşturmanızı öneririz. Programlı olarak veya bu eklentilerden herhangi birini kullanarak bir tane oluşturabilirsiniz.

Değerlerle WordPress kısa kodları ekleyin

Şimdi değerlerle kısa kodların nasıl ekleneceğini öğrenmek için varsayılan galeri WordPress kısa kodunu kullanalım.

Galeri kısa kodu, güzel görünümlü bir resim galerisi görüntüler ve çeşitli değerleri destekler. Galeride görüntülemek istediğiniz resimleri belirtmek için kimlik değerini eklemeniz gerekir. Bu parametre kimlikleri alır ve bu belirli görüntüleri görüntüler.

Örneğin 720, 729, 731 ve 732 ID'li görselleri görüntülemek istiyorsak, bir yazıya veya sayfaya kısa kodu şu şekilde ekliyoruz: [ gallery ids=”729,732,731,720” ]

Test etmek için, görüntü kimliklerini kendi kimliklerinizle değiştirerek kısa kodu yapıştırmanız yeterlidir. Resim kimliklerinizi bilmiyorsanız, bunları medya kitaplığı düzenleyicisinde açın; kimliğin tarayıcı URL'sinde ve kalıcı bağlantının resmin ayrıntılarında yazdırıldığını göreceksiniz.

WordPress'te kısa kodlar ekleyin - Medya kitaplığında Görüntü Kimliği

Klasik metin düzenleyiciyi kullanıyorsanız, kısa kodu içeriğe yapıştırmanız yeterlidir. Gutenberg'de ise kısa kod bloğunu kullanabilirsiniz. Ek olarak, birçok sayfa oluşturucu ve tema, kullanabileceğiniz diğer bazı kısa kod yönetimi çözümlerini içerir.

Gutenberg

Gutemberg kısa kod bloğu

Klasik editör

Klasik düzenleyicide kısa kod ekleyin

Kısa kodu ekledikten sonra sitenizin ön ucunu kontrol edin ve şöyle bir şey görmelisiniz:

WordPress galeri kısa kodu

Şablon dosyalarında kısa kodları kullanma

WordPress kısa kodlarını kullanmanın başka bir yolu da onları şablon dosyalarına eklemektir. Özel bir çözüm geliştirmek istiyorsanız, bu sizin için ilginç bir seçenek. Örneğin, bu, diğer birçok olasılık arasında, bir mantık koşullu üzerinde bir kısa kod çalıştırmanıza veya kısa kod değerlerini dinamik olarak değiştirmenize olanak tanır.

Kısa kodları bir şablon dosyasında do_shortcode() PHP işleviyle kullanabilirsiniz. Bu, herhangi bir dosyada kullanabileceğiniz varsayılan bir WordPress işlevidir.

Bir dosyadan kısa kod çalıştırmak için aşağıdakileri eklemeniz yeterlidir:

echo do_shortcode(' [ gallery ids=”21,42,32,11” ] ');

Şimdi başlığı özelleştirin ve galeri kısa kodunu header.php dosyasında çalıştırın. Bunu yapmak için, bir alt tema kullanarak bu dosyanın üzerine yazmanız gerekir. Şablonların nasıl özelleştirileceği hakkında daha fazla bilgi için bu kılavuza göz atın.

WordPress kontrol panelinizde, Görünüm > Tema Düzenleyici'ye gidip header.php dosyasını açarak kısa kodu başlığınıza ekleyin. Dosyanın sonuna gidin ve kodu aşağıda gösterildiği gibi yapıştırın:

Şablon dosyasındaki kısa kod

Yukarıdaki betiği dosyaya ekledikten sonra başlıkta galeriyi göreceksiniz.

WordPress kancalarıyla Kısa Kodları Kullanma

WordPress'e programlı olarak kısa kod eklemenin başka bir yolu, bunları kancalarla birlikte kullanmaktır. Kancalara aşina değilseniz, onlar hakkında daha fazla bilgi edinmek için bu kılavuza göz atmanızı öneririz.

Kancalı bir kısa kod kullanmak için, önceki bölümde gördüğümüz gibi, do_shortcode() işlevine ihtiyacınız vardır.

Aşağıdaki komut dosyası, alt temanın functions.php dosyası üzerinde çalışacaktır. wp_footer() kancasını kullanıyoruz, bu nedenle bu, sitenin altbilgisine yazdırılacaktır.

/* Shortcode with wp_footer hook*/
add_action('wp_footer','QuadLayers_footer_shortcode');
function QuadLayers_footer_shortcode(){
echo do_shortcode(' /* Shortcode with wp_footer hook*/
add_action('wp_footer','QuadLayers_footer_shortcode');
function QuadLayers_footer_shortcode(){
echo do_shortcode(' [ products ids="623" ] ');
} ');
}

Bu kısa kod, varsayılan olarak WooCommerce ile birlikte gelir ve ürünleri görüntülemek için kullanılır. Bu durumda, ID = 623 olan tek bir ürünü görüntülemek için kullanıyoruz.

WordPress kancalarıyla Kısa Kodları Kullanma

Sitenizdeki alt bilgiyi nasıl özelleştireceğiniz hakkında daha fazla bilgi için bu kılavuza göz atın.

WordPress'te özel kısa kodlar nasıl oluşturulur

Bir başka ilginç alternatif de kendi özel kısa kodlarınızı oluşturmaktır. Bu zor değil ama bazı temel geliştirici becerileri ve biraz kodlama bilgisi gerektiriyor. Gelişmiş bir kullanıcı değilseniz endişelenmeyin. En deneyimsiz programcılar bile bunu oldukça kolay bulacaktır.

WordPress, kendi kısa kodlarımızı oluşturmak ve eklemek için bize add_shortcode() işlevini sağlar. Bazı örnek komut dosyalarıyla özel bir kısa kod oluşturmak için bu işlevi nasıl kullanacağımızı görelim.

Oturum açmış ve çıkış yapmış kullanıcılar için farklı bir mesaj göster

Aşağıdaki komut dosyası bir kısa kod oluşturacak ve kullanıcılara bir mesaj yazdıracaktır. Daha ilginç hale getirmek için, oturum açmış ve oturumu kapatmış kullanıcılar için farklı mesajları görüntülemek üzere bir koşul uyguladık.

 /* Kısa kod girişi yapıldı*/
add_shortcode('loggedin','QuadLayers_shortcode_loggedin');
function QuadLayers_shortcode_loggedin($atts){
    if(is_user_logged_in()==true){
        $response='giriş yaptınız';
    }
    Başka{
        $response='çıkış yaptınız';
    }
$yanıtını döndür;
}

Bir if kullanarak, kullanıcının oturum açıp açmadığını kontrol ederiz ve doğruysa “Giriş yaptınız”, aksi takdirde “Çıkış yaptınız” mesajını görüntüleriz.

WordPress'te özel kısa kodlar nasıl oluşturulur

Kimliğe göre tek bir gönderi görüntüle

Başka bir seçenek de, kısa kodda bir değer olarak ileteceğimiz belirli bir gönderiyi görüntüleyen bir WordPress kısa kodu eklemektir.

 add_shortcode('get-post','QuadLayers_shortcode_post');
function QuadLayers_shortcode_post($atts) {
    $a = shortcode_atts(dizi('id' => '',), $atts); 
    $args = array('post_type' => 'post','p' => $a['id']); 
    $sorgu = new WP_Query($args); 
    $query->the_post();
    $string = '<h3>'.get_the_title().'</h3>' ; 
    $string.=the_post_thumbnail();
    $string .= get_the_content();
    $dize döndür;
}

Bu örnekte, [ get-post ] kısa kodunu ekledik ve şöyle görünüyor:

Kimliğe göre tek bir gönderi görüntüle

Bir mantık koşulunda farklı kısa kodlar çalıştırın

Bu örnekte, bir mantık koşulunda farklı kısa kodları çalıştırmak için özel bir kısa kod oluşturacağız.

Özel kısa kodumuz, bir iletişim formu eklentisi ile oluşturulmuş farklı formları görüntüleyecektir. Bu yüzden oturum açmış ve oturumu kapatmış kullanıcılar için farklı bir form yazdıracağız.

 add_shortcode('göster-form','QuadLayers_custom_shortcode');
function QuadLayers_custom_shortcode(){
    if(is_user_logged_in()==true){
        $response='<h3>Bize ulaşın</h3>';
        $response.='[wpforms]';
    }
    Başka{
        $response='<h3>Bültenimize abone olun</h3>';
        $response.='[wpforms]';
    }
    echo do_shortcode($yanıt);
}

Bir kez daha, kullanıcının oturum açıp açmadığını kontrol etmek için bir koşullu if kullanıyoruz ve buna bağlı olarak belirli bir form görüntülüyoruz.

Bir mantık koşulunda farklı kısa kodlar çalıştırın

notlar

  • Kısa kod oluştururken her zaman verileri döndürün. Bunu tekrarlarsanız, içeriği görüntülemeniz gereken konumla ilgili bazı sorunlarla karşılaşabilirsiniz.
  • do_shortcode(); işlevi çoğu şablon dosyasında harika çalışır, ancak yankılanması gerektiğinden bazı sorunları da tetikleyebilir
  • Birçok eklenti, özgürce kullanabileceğiniz kısa kodlar sağlar. Ancak bazı kısa kodlar gönderilerde, sayfalarda veya bunları üstbilgi, altbilgi veya kenar çubuğu widget'larında kullanmaya çalışırken çalışmayabilir. Bu, kısa kodun ne kadar karmaşık olduğuna ve nasıl oluşturulduğuna bağlıdır.
  • Gutenberg düzenleyicisinde özel bir kısa kod kullanırken bazı hatalar görüyorsanız, bu, kısa kodunuz Gutenberg ile uyumlu olmadığı anlamına gelir. Yine de ön uçta çalışacak ve bu hatadan kurtulmak için varsayılan düzenleyiciye geçmeyi deneyebilirsiniz.

Çözüm

Özetle, kısa kodlar, sitenizin herhangi bir yerinde belirli bir kod parçasını çalıştırmanıza izin veren kullanışlı araçlardır. Aynı betiği birkaç kez kullandığınızda, bir kısa kod oluşturabilir ve kodu tekrar tekrar tekrar etmekten kaçınmak için kullanabilirsiniz. Kısa kodların yeni başlayanlar için bile kullanımı kolaydır ve zamandan tasarruf etmenize yardımcı olur.

Bu kılavuzda, WordPress'e kısa kod eklemenin farklı yollarını gördük. Değerlerle, şablon dosyalarında ve kancalarla kısa kodların nasıl kullanılacağını öğrendik. Bunun da ötesinde, özel kısa kodların nasıl oluşturulacağını gördük ve ihtiyaçlarınıza göre ayarlayabileceğiniz birkaç örnek komut dosyası verdik.

Kısa kodlar ve sitenizi nasıl özelleştireceğiniz hakkında daha fazla bilgi edinmek için aşağıdaki gönderilere göz atın:

  • WooCommerce Kısa Kodları: En İyi Kılavuz
  • WooCommerce Mağaza Sayfası nasıl özelleştirilir
  • WooCommerce'de Ürün Sayfasını Özelleştirin

WordPress sitenize kısa kodlar eklediniz mi? Bu kılavuzu izleyerek herhangi bir sorun yaşadınız mı? Aşağıdaki yorumlarda bize bildirin!