WordPress Kısa Kodları için Eksiksiz Kılavuz

Yayınlanan: 2020-10-02

WordPress blok düzenleyicisinden önce, WordPress kısa kodları, bir WordPress web sitesinin sayfalarına, yayınlarına ve diğer bölümlerine eklenti ve tema işlevleri eklemeyi kolaylaştırmak için WordPress düzenleyicisine isabet eden en iyi şeylerden biriydi.

WordPress kısa kodları nihai kılavuzu

Blok düzenleyiciye geçişle birlikte, hala kısa kodlarla dolu olan eski eklentilerin ve web sitelerinin çoğu için bu ne anlama geliyor? WordPress kısa kodları çalışmaya devam edecek mi? WordPress kısa kodlarını kullanmaktan WordPress bloklarına kolayca geçmenin bir yolu var mı?

Hadi bulalım. Bu kılavuzda, WordPress blok düzenleyici çağındaki WordPress kısa kodlarını keşfedeceğiz.

Bu kılavuzda

    WordPress Kısa Kodları Nelerdir?

    Bir WordPress kısa kodu, [brackets] içine sarılmış yeniden kullanılabilir, dinamik bir kod bitidir. Kısa kodlar, WordPress'in veya bir eklentinin veya temanın belirli işlevlerini herhangi bir gönderiye, sayfaya, özel gönderi türüne veya widget'a kolayca eklemenize olanak tanır. Web sitenizdeki "kısayollar" veya makrolar gibi WordPress kısa kodlarını düşünün.

    Kodlamaya ve tekrarlamaya devam etmek için çok sıkıcı olan statik içeriği görüntülemek için WordPress kısa kodlarını kullanabilirsiniz. Ayrıca resim galerileri, podcast'ler için ses çalarlar, etkinlik takvimleri veya belirli veriler için değişen istatistikler gibi dinamik içeriği görüntülemek için kısa kodları da kullanabilirsiniz.

    Kısa Kod Formatı

    Kısa kodların eklenmesi söz konusu olduğunda, temel [parantez] biçimi çeşitli şekillerde "genişletilebilir", bu da öznitelikler adı verilen ek ayar bilgilerini özelleştirmenize veya eklemenize olanak tanır. Ek olarak, kısayollar metni (veya HTML'yi) kaydırabilir veya hatta başka bir kısa kodun içine yerleştirilebilir.

    Örneğin, bir kısa kod aşağıdaki biçimlere sahip olabilir:

    [shortcode]
    
    [shortcode]Some text[/shortcode]
    
    [shortcode]<a href="http://mysite.com/">HTML content</a>[/shortcode]
    
    [shortcode]Some text [another-shotcode] more text [/shortcode]
    
    [shortcode icon="icon: star" background="#eeeeee" color="#F73F43" text_color="#F73F43" size="32" shape_size="16" radius="256" text_size="16" url="#" target="self" margin="0"] This is a custom icon [/shortcode]
    

    Kısa Kod Özellikleri

    Kısa kodlar da esnektir çünkü niteliklerle genişletilebilirler. Kısa kodlar, özniteliklerle, yalnızca kısa kodun içine fazladan kod parçacıkları ekleyerek ek özelleştirme sunar.

    Eklentiler ve temalar, kullanıcıların çıktıya belirli öğeleri eklemek veya çıkarmak için doğru kısa kod parçacıklarını kullanmalarına yardımcı olmak için ekstra kılavuzlar ve değerlendirme listeleri sunar.

    Niteliklere sahip birkaç kısa kod örneği.

    [[gallery id="123" size="medium"]]
    
    [recent-posts posts="5"]
    
    [recent-posts posts="5"]Posts Heading[/recent-posts]
    

    Yerleşik WordPress Kısa Kodları

    WordPress, belirli içerik türlerini oluşturmak için birkaç yerleşik kısa kodla birlikte gelir.

    [[audio]]
    

    Ses kısa kodu, ses dosyalarını gömmenize ve oynatmanıza olanak tanır.

    [[caption]]
    

    Öncelikli olarak tek tek görüntülerle kullanılan altyazı kısa kodu, altyazıları içeriğin etrafına sarmanıza olanak tanır.

    [[gallery]]
    

    Galeri kısa kodu, yazılarınıza ve sayfalarınıza bir veya daha fazla resim galerisi eklemenize olanak tanır.

    [[embed]]
    

    Gömme kısa kodu, gömülü öğeleri maksimum (ancak sabit olmayan) genişlik ve yükseklikle sarmanıza olanak tanır.

    [[playlist]]
    

    Oynatma listesi kısa kodu, bir gönderide bir WordPress ses veya video dosyası koleksiyonu görüntüleme işlevini uygular.

    [[video]]
    

    Video kısa kodu, video dosyalarını gömmenizi ve oynatmanızı sağlar.

    Eklenti ve Tema Kısa Kodları

    Belirli WordPress temaları ve eklentileri, posta veya sayfa düzenleyicisine ekleyebileceğiniz ve sonucu ön uçta oluşturacak kutudan çıkar çıkmaz kısa kodlara sahiptir. Bu tarihe kadar birçok tema ve eklenti hala kısa kod kullanıyor.

    Örneğin, kısa kodlar genellikle takvimler, formlar, tablolar, üyelikler, geri sayım sayaçları veya alıntılar için ortak eklentilerde kullanılır. Herhangi bir şey için kısa kodlar oluşturmanıza izin veren kısa kod eklentileri bile mevcuttur.

    WordPress temaları, önceden şekillendirilmiş veya onlar tarafından sağlanan belirli dinamik içeriği oluşturmak için kısa kodları da kullanabilir.

    Özel Kısa Kodlar

    Çoğu uzman geliştirici, kendi kısa kodlarını oluşturmayı tercih ederek, tekrarlayan bir şeyi kodlamak için gereken süreyi kısaltır. Custom-shortcodes.php dosyasını oluşturmak için dosya dizininizdeki basit bir ek dosya yeterlidir . Özel kısa kodların iplerini öğrenmek istiyorsanız, özel kısa kodlar oluşturmaya yönelik bir kılavuz burada.

    WordPress Kısa Kod API'si

    Kendi özel kısa kodlarını oluşturan geliştiriciler için, WordPress Kısa Kod API'si, yazılarda ve sayfalarda kullanılmak üzere WordPress kısa kodları oluşturmaya yönelik basit bir işlevler kümesi sağlar.

    Shortcode API, eklenti geliştiricilerinin, içerik alanına ilgili kısa kodu ekleyerek kullanıcıların sayfalara veya gönderilere ekleyebilecekleri dinamik içerik oluşturmasına yardımcı olur. Neyse ki, API tüm karmaşık ayrıştırma işlemlerini hallederek her bir kısa kod için özel bir normal ifade yazma ihtiyacını ortadan kaldırır. Ayrıca, varsayılan kısa kod özniteliklerini ayarlamak ve getirmek için yardımcı işlevler dahil edilmiştir.

    Geliştiriciler, aşağıdakiler hakkında daha fazla bilgi edinmek için WordPress Kısa Kod API belgelerini çıkarabilir:

    • İşleme özellikleri
    • Çıktı
    • Kendiliğinden kapanan kısa kodlara karşı çevreleme
    • fonksiyon referansı
    • sınırlamalar
    • Resmi sözdizimi

    Klasik Düzenleyicideki Kısa Kodlar

    Geçmişte, herhangi bir yazının veya sayfanın klasik düzenleyicisine aşağıdaki gibi kısa kodlar eklenirdi:

    WordPress kısa kodu

    WordPress Blokları Nedir?

    Önce kısa kodlar vardı… ama sonra blok tabanlı düzenleme geldi. WordPress 5.0'ın piyasaya sürülmesiyle, uzun süredir planlanan Gutenberg editörünün veya WordPress'in ana sayfası ve yazı editörü olarak WordPress Blok Editörünün uygulanması geldi ve yıllardır var olan klasik WordPress metin tabanlı editörün yerini aldı.

    İşte WordPress 5.5'ten önceki içerik düzenleyiciye bir bakış (ah, o günlerdi!)

    Gutenberg editörü ilk olarak WordPress'in önceki sürümlerinde duyurulmuştu, ancak varsayılan editör olunca WordPress 5.0'a kadar isteğe bağlı kaldı.

    E-Kitabı İndirin: WordPress 5.0 ve Gutenberg Düzenleyicisi için En İyi Kılavuz
    PDF'yi indirin

    Yeni engellenen düzenleyicide doğal olarak yanlış bir şey yok. Aslında, çoğu kullanıcı WordPress'in gelişmiş ve daha temiz, daha az korkutucu görünümünü sever.

    Ancak WordPress blok düzenleyicisi ile WordPress blokları geldi. Microsoft Word gibi kelime işlem uygulamalarını andıran en üstteki biçimlendirme seçenekleri gitti. Bunun yerine, biçimlendirme seçenekleri, her blok için sekmeli sağ kenar çubuğu seçenekleriyle değiştirildi.

    WordPress blokları aslında içerik kapsayıcılarıdır. Farklı içerik türleri (resimler, videolar, metinler, başlıklar, galeriler) için birçok farklı blok vardır.

    Biçimlendirme, ayırıcı ve ayırıcı için bir WordPress bloğu bile vardır ve bunlar kolay erişim için kategoriler halinde rasgele düzenlenmiştir.

    En üstte bulunan tüm seçenekler ve kontroller artık sayfa/yazı düzenleyicinin sağ tarafında yer alıyor ve üstte sekmeler, seçenekleri tek başına mı yoksa tüm belge için mi görmek istediğinizi gösteriyor.

    Blok düzenleyici daha kolay, daha hızlı ve daha kullanıcı dostudur. Ayrıca, tema ve eklenti geliştiricileri, varsayılan WordPress bloklarına daha fazla blok seçeneği ekleyen kendi bloklarını da yapıyorlar.

    Yeniden Kullanılabilir Bloklar ve Kısa Kodlar

    WordPress klasik düzenleyicide bir dizi önceden tanımlanmış çıktıyı kaydetmenin eski yolu, kendi kısa kodlarınızı oluşturmaktı. Şimdi, bu yöntem yeniden kullanılabilir bloklarla değiştirildi.

    Önceden tanımlanmış ve önceden özelleştirilmiş blokları kaydetme yeteneği, belirli bir bloğun düzenini ve tasarımını kaydetmeyi ve başka bir blokta kullanmayı da kolaylaştırdı. Bir sayfa şablonuna çok benzer.

    Örneğin, bir düğme bloğu ekler ve onu belirli bir renk, fareyle üzerine gelme efektleri vb. ile biçimlendirirseniz, o düğmeyi eklediğiniz her sayfada bunu yapmaya devam etmek istemezsiniz. Yeniden kullanılabilir bir bloğa değiştirirseniz, düğme WordPress sitenize kaydedilir ve diğer sayfalarda veya gönderilerde kullanabileceğiniz kendi bloğu olur.

    Ayrıca bu blokları normal bloklara dönüştürerek, yeni bir blok olarak (yeni bir adla) kaydederek veya mevcut bloğun tasarımını güncelleyerek de güncelleyebilirsiniz.

    Grup Blokları

    WordPress 5.3'te ayrıca grup bloklarının ve şablonlarının tanıtımı geldi.

    Temel olarak, belirli blokları birlikte gruplandırma ve hepsini birlikte taşıma veya güncelleme yeteneği verilir. Bu sonunda blok kalıplara yol açtı . Blok kalıplar, kullanıcılar bir kalıp seçmeyi ve boş bir tuvalden başlamak yerine içeriği güncellemeyi tercih ettiğinden, içeriği düzenlemeyi kolaylaştırdı.

    Blok Şekillendirme Seçenekleri

    Her tema ile farklı stil seçenekleri geliyor. Ve normalde her siteye eklediğiniz içeriğin stili temanız tarafından önceden belirlenir.

    Blok düzenleyici ile, her bloğun stilini, öne çıkmak veya daha belirgin hale getirmek için ayrı ayrı güncelleme seçeneğiniz vardır.

    Bloklar ve Tam Site Düzenleme

    WordPress'te sayfa oluşturma ve oluşturma yöntemimizdeki tüm bu ilerlemeler ve değişikliklerle birlikte, fikir ve nihai olarak Tam Site Düzenleme olarak adlandırılan şeye geçiş geliyor.

    Yapıştırmada, çoğu kullanıcı bir gönderi veya sayfanın yalnızca gerçek gövdesini güncelleyebilir. Üstbilgi, altbilgi, kenar çubukları ve widget'lar gibi web sitesinin belirli yönleri hala büyük ölçüde temaya bağlıdır. Bu, elbette, WordPress geliştiricileri ve kullanıcıları için doğru miktarda seçeneğe sahip mükemmel temayı aramayı en büyük mücadele haline getirdi.

    Tam Site Düzenleme ve Blok Oluşturucu'nun tanıtılmasıyla birlikte, trend, bir sayfanın veya yazının tüm bölümlerini bir şekilde blokları kullanarak düzenlenebilir hale getirme yönünde ilerliyor.

    Örneğin, en son Twenty-Twenty WordPress teması, yaratıcılara ve web sitesi sahiplerine web siteleri ve nasıl görünmesini istedikleri üzerinde daha fazla kontrol sağlayarak bu modeli takip eder.

    İleriye dönük olarak, eklenti ve tema geliştiricilerinin, WordPress blok düzenleyicisinin yeni tam site düzenleme ve sayfa oluşturma deneyimine uyum sağlamak için yazılımlarını geliştirirken farklı bir yaklaşım benimsemeleri gerekecektir. Bunun tam olarak uygulanması hala ufukta olsa da, er ya da geç göreceğimiz olumlu bir değişiklik.

    Yeni Kısa Kod Bloğu

    Blok düzenleyiciden önce, kısa kodlar doğrudan sayfaya veya sayfa düzenleyiciye eklenirdi. Artık WordPress blok düzenleyicisi yeni bir kısa kod bloğu içeriyor.

    Kısa kod bloğu, bir gönderi veya sayfada eski kısa kodları kullanmaya devam etmeyi kolaylaştırır ve kısa kod çıktısının bütünlüğünü korur.

    Not: Bir paragraf bloğuna kısa kod eklemek her zaman işe yaramayabilir, bu nedenle bunun yerine kısa kod bloğunu kullanmanız gerekebilir.

    Kısa kod bloğu, Blok Ekle düğmesine tıklayarak bir sayfaya veya gönderiye eklenebilir. Alternatif olarak, /shortcode yazıp enter tuşuna basabilirsiniz.

    wordpress kısa kod bloğu

    Diğer yaygın bloklardan farklı olarak, kısa kod bloğunun blok araç çubuğunda veya düzenleyici kenar çubuğunda herhangi bir özel ayar içermediğini fark edeceksiniz, bunun nedeni muhtemelen kısa kodların öznitelikleri kullanılarak özelleştirilebilmesidir.

    Blok Düzenleyici, WordPress Kısa Kodları için Ne Anlama Geliyor?

    WordPress blok düzenleyicisinin kısa kodlar için önemli etkileri vardır. Blok düzenleyici çağında WordPress kısa kodları hakkında dikkat edilmesi gereken en önemli şeylerden birkaçını ele alalım.

    1. WordPress blok düzenleyicisi, çoğu eklenti ve tema için kısa kodların ihtiyacını ve amacını temelden değiştirir. Blok tabanlı bir düzenleme sistemiyle, sayfadaki her "öğenin" düzenlenebilir tek bir WYSIWYG düzenleyicisinde yer almak yerine kendi bloğu vardır.

    Blok düzenleyici, bir gönderi veya sayfa oluşturmaya yönelik tamamen farklı bir yaklaşım olduğundan, kısa kodlar tarafından oluşturulan bir sayfanın daha dinamik bölümleri, ayrı ayrı eklenebilen bloklar olarak mevcut olabilir.

    2. Bloklar artık çoğu kısa kodun yerini alabilir ve kullanıcıların kısa kodları nasıl kullanacaklarını öğrenme ihtiyacını ortadan kaldırır. Kısa kod kavramı ve formatı bazı kullanıcılar için dik bir öğrenme eğrisine sahip olabilir, bu nedenle blok yaklaşımı daha kolay olabilir.

    Örneğin, Gravity Forms eklentisini alın. Blok düzenleyiciden önce, bir gönderiye veya sayfaya form ekleme işlemi farklıydı. Klasik düzenleyiciden, içeriğinize bir form eklemek için bir düğme kullanmanız gerekiyordu.

    yerçekimi formları ekleme formu

    Formunuzu seçtikten sonra form kısa kodu içeriğinize eklendi. Seçtiğiniz seçeneklere bağlı olarak kısa kod, başlık ve açıklama özniteliklerini içeriyordu.

    Şimdi, Gravity Forms eklentisi bir form bloğu k gömme bloğu sunuyor. Blok düzenleyiciden Formlar bloğunu seçin.

    Formu seçtikten sonra, formun sayfanızda nasıl görüneceğine dair daha iyi bir önizleme göreceksiniz. Form ayarları blok ayarlarında bulunabilir.

    3. Tema ve eklenti geliştiricilerinin, kısa kod uygulamalarının geleceğine ve kısa kodlarını bloklara dönüştürmeye karar vermeleri gerekecektir. Yukarıda bahsedildiği gibi, yüzlerce tema, eklenti ve geliştirici, web sitelerinde ve uygulamalarında hala kısa kodlar kullanıyor. Blok benimseme yavaş olabilir, ancak kullanıcılar yeni blok düzenleyiciye daha aşina hale geldikçe, kullanıcıların bir blok seçeneği istemesi muhtemeldir.

    WordPress blok düzenleme sistemini benimsemekten hala kilometrelerce uzakta olan geliştiriciler için Tam Site Düzenleme konsepti, kısa kodlarıyla el ele gidebilir. İnceleme ve derecelendirme eklentileri, müzik çalarlar, tarih göstergeleri, galeriler, iletişim formları ve hala kısa kod kullanan diğer her şey gibi eklentiler hala “oyunda”.

    4. Kısa kodlar yakın zamanda ortadan kalkmayacak. Muhtemelen bu yüzden WordPress blok düzenleyicisi, kısa kod kullanımını korumaya yardımcı olmak için kısa kod bloğu sunar. Kısa kodların WordPress 5.0 ve blok düzenleyiciden önce bu kadar geniş kullanımı ve uygulaması olduğundan, WordPress'in gelecekteki sürümlerinin hala kısa kodları desteklemesi önemlidir.

    5. Kısa kodlar bir bloğa dönüştürülebilir . Kısa kod kullanan favori bir temanız veya eklentiniz mi var? Bu kısa kodların bir noktada bir bloğa dönüştürülmesi muhtemeldir. Bir eklenti veya tema geliştiricisiyseniz veya WordPress web siteleri oluşturuyorsanız ve özel bir temada kısa kodlar kullanıyorsanız, kısa kodları bloklar olarak yeniden düşünmek mümkündür.

    Bir sonraki bölümde, WordPress kısa kodlarının WordPress bloklarına nasıl dönüştürüleceğini kısaca ele alacağız.

    WordPress Kısa Kodlarını WordPress Bloklarına Dönüştürme

    Özel kısa kodlar ve yeniden kullanılabilir bloklar ekleyebildiğiniz gibi, özel WordPress kısa kodlarını da WordPress bloklarına kolayca dönüştürebilirsiniz.

    Bu özel kısa kod kılavuzundaki ilk adımları izleyin.

    Bu temel örneği Caldera Forms'dan alın:

     <?php /** * Handler for [cl_post_title] shortcode * * @param $atts * * @return string */ function caldera_learn_basic_blocks_post_title_shortcode_handler($atts) { $atts = shortcode_atts([ 'id' => 0, 'heading' => 'h3', ], $atts, 'cl_post_title'); return caldera_learn_basic_blocks_post_title($atts[ 'id' ], $atts[ 'heading' ]); } /** * Output the post title wrapped in a heading * * @param int $post_id The post ID * @param string $heading Allows : h2,h3,h4 only * * @return string */ function caldera_learn_basic_blocks_post_title($post_id, $heading) { if (!in_array($heading, ['h2', 'h3', 'h4'])) { $heading = 'h2'; } $title = get_the_title(absint($post_id)); return "<$heading>$title</$heading>"; } /** * Register Shortcode */ add_shortcode('cl_post_title', 'caldera_learn_basic_blocks_post_title_shortcode_handler');

    Bu kod, gönderi kimliğini ve bir başlık düzeyini (h2, h3, he) alır ve başlık için HTML'ye sarılı gönderinin başlığını çıkarır.

    Bu yapıldıktan ve kodun çalıştığını test ettikten sonra, kısa kodu bir blok olarak kaydetmeniz gerekir. Örnek olarak bir WordPress Kısa Kodunu Gutenberg Bloğuna Dönüştürmek İçin Adım Adım Kılavuz.

    WordPress Blokları Oluşturma Hakkında Daha Fazla Kaynak

    WordPress'in İlk Blok Türünüzü Yazma konusundaki resmi belgeleri de dahil olmak üzere, bu adıma ulaşmanıza yardımcı olacak çevrimiçi olarak çok sayıda eklenti ve kaynak bulunmaktadır. Igor Benic'in gönderisini, gönderileri görüntülemek için nasıl blok oluşturulacağını da inceleyebilirsiniz.

    Bu kılavuzları okuduktan sonra, özel kısa kodlarınızı kullanarak kendi WordPress bloklarınızı nasıl oluşturacağınızı öğrenebileceksiniz.

    Not: İşlem, farklı kısa kodlarla biraz farklı olabilir. Kısa kodlu eklentiler ve temalar, dikkate alınması gereken niteliklerin çokluğu nedeniyle farklı bir yaklaşım benimseyebilir. Temel olarak, çok fazla araştırma yapmanız ve bunu kodlamak için biraz zaman harcamanız gerekebilir.

    WordPress Kısa Kodları için Karar

    WordPress kısa kodları, WordPress'in en önemli parçalarından biridir ve olmaya devam edecektir. Kısa kodlar, birçok eklenti geliştiricisinin eklentilerini daha kullanıcı dostu hale getirmesine yardımcı oldu ve birçok tema geliştiricisi, temalarının işlevlerini genişletiyor. Kısa kodlar, birçok içerik oluşturucunun ve web sitesi sahibinin kendi özel kısa kodlarını oluşturduktan sonra, istedikleri şeyleri tekrar tekrar ekleme ve güncelleme konusunda yaşadığı baş ağrılarının sayısını da azalttı.

    Bununla birlikte, blok düzenleyicinin WordPress düzenleme deneyiminin geleceği olduğuna şüphe yok, bu nedenle daha fazla geliştiricinin onu daha iyi hale getirmeye ve hatta hala kısa kod kullananlar da dahil olmak üzere daha fazla özellik dolu hale getirmeye katkıda bulunduğunu görmeyi bekleyin. İleriye baktığımızda, daha fazla geliştiricinin WordPress kısa kodları yerine WordPress bloklarını kullanmaya ve eklemeye geçmesini bekliyoruz.

    WordPress kısa kodlarının önemi, ne için oldukları ve ne zaman kullanılacağı hakkında çok şey öğrendiğinizi umuyoruz. Umarım, kendi özel kısa kodlarınızı ve nihayetinde her ikisi de yakın zamanda ortadan kalkmayacak olan kendi bloklarınızı oluşturmaya başlayabilirsiniz.