25 Nisan 2009

wp_list_authors Fonksiyonuyla Yazar Listeleme

WordPress Yorum Ekle

Günlüklerde artık birden fazla yazarın yazması moda oldu. Yazarlarını listelemek için site sahiplerinin kullanabileceği süper bir fonksiyon var o da wp_list_authors fonksiyonu. Fonksiyon verdiğiniz parametrelere göre yazarları listeliyor. Geriye de bu listeyi yan menüye ya da sayfa içerisine eklemek kalıyor. Gerçi temanız bileşen destekli ise bu işi Yazarlar Bileşeni ile de halledebilirsiniz.

Açıklama

Fonksiyon kendisine verilen parametrelere göre yazarları listeliyor. Eğer yazarın yazısı varsa ismine, yazarın yazılarını gösterecek bir bağlantı ekleniyor. İstenirse yazı sayısı ve RSS adresi de eklenebiliyor.

Kullanım

  1. <?php wp_list_authors('parametreler'); ?>

Örnek Kullanımlar

Varsayılan Kullanımda

  1. <?php $defaults = array(
  2.           'optioncount' => false,
  3.           'exclude_admin' => true,
  4.           'show_fullname' => false,
  5.           'hide_empty' => true,
  6.           'echo' => true,
  7.           'feed' =>'' ,
  8.           'feed_image' =>'' ,
  9.           'style'  => 'list',
  10.           'html'  =>''
  11.  ); ?>
  12. <?php wp_list_authors($defalts); ?>

Varsayılan olarak, yazı sayısını göstermez, admin'i göstermez, yazarın tam adını (ad-soyad) göstermez, kullanıcı adını gösterir, yazısı olmayan yazarları göstermez, listeyi yazdırır, RSS bağlantısını ve resmini göstermez.
Yazarların Tam Adları ve Yazı Sayıları
Bu örnek sitenin yazar listesi Ad, Soyadları ve yazı sayılarıyla gösterir. Diğer durumlar varsayılandakiyle aynı.

  1. <?php
  2.  echo '<ul>';
  3.   wp_list_authors('show_fullname=1&optioncount=1');
  4.  echo '</ul>';
  5. ?>

HTML Çıktısı

  1. <ul>
  2.  <li><a href="http://localhost/wp271/authors/mahmut/" title="mahmut tarafından yazılan yazılar">Mahmut Armut</a> (29)</li>
  3.  <li><a href="http://localhost/wp271/authors/yakup/" title="yakup tarafından yazılan yazılar">Yakup Gövler</a> (199)</li>
  4. </ul>

Bu fonksiyonu ve parametrelerini kullanırken benim tavsiyem, bütün parametreleri bir dizi olarak tanımladıktan sonra fonksiyona vermenizdir. Şöyle ki;

  1. <?php $yazar_parametreler = array(
  2.           'optioncount' => true,
  3.           'exclude_admin' => false,
  4.           'show_fullname' => true,
  5.           'hide_empty' => true,
  6.           'echo' => true,
  7.           'feed' =>'RSS' ,
  8.           'feed_image' =>'' ,
  9.           'style'  => 'list',
  10.           'html'  => ''
  11.  );
  12. echo '<ul>';
  13.  wp_list_authors($yazar_parametreler);
  14. echo '</ul>';
  15. ?>

şeklinde kullanmanız listeye tam olarak hakim olmanızı sağlayacaktır. Tabi ki parametre değerlerini uygun olarak değiştirmeniz kaydıyla.

Aldığı Parametreler

optioncount
(boolean) Her yazarın isminin yanında yazarın yazı sayısını gösterir. Varsayılan değer 0 (false)
exclude_admin
(boolean) 'admin' adlı yazarı listede göstermez. Varsayılan 1 (true).
show_fullname
(boolean) Yazarın tam adını (ad, soyad) gösterir. Eğer tam adı yoksa kullanıcı adını gösterir. Varsayılan 1 (true)
hide_empty
(boolean) Yazı sayısı 0 olan yazarları göstermez. Varsayılan 1 (true)
echo
(boolean) Listeyi yazdırır. Varsayılan 1 (true)
feed
(string) Yazarın RSS beslemesi için yazar adının yanında RSS yazısıyla bir bağlantı oluşturur. Varsayılan olarak bağlantı gösterilmez.
feed_image
(string) Yazarın RSS besleme bağlantısı için yazı yerine bir resim kullanmanızı sağlar. Bu parametre bir resmin adresini alır. Bu parametre kullanılmışsa feed parametresi es geçilir.
style
(string) Yazar listesinin nasıl gösterileceği. Yazar listesi sırasız bir liste olarak ya da aralarına <br /> ile ayrılarak gösterilir. Varsayılan list olup, liste olarak gösterilir.
html
(string) Liste elemanlarının html olarak ya da düz yazı olarak gösterilmesini sağlar. Varsayılan html. Bu seçenek WP 2.8 ile birlikte eklendi.


Bu yazının kısa bağlantısı http://www.yakupgovler.com/?p=788.

Yazılarımı RSS aboneliği ile takip edebilir, yeni yazılarıma kolaylıkla ulaşabilirsiniz. Bunun için ise RSS adresimi kullanabilirsiniz.


“wp_list_authors Fonksiyonuyla Yazar Listeleme” yazısı için 5 Yorum

Bu yazıya yapılan yorumları dilerseniz, ( RSS 2.0 ) beslemesini kullanarak takibe alabilirsiniz.

  1. cihan dedi ki:

    Yazarlara bağlantı eklemek için ne yapmalıyız?

  2. Yakup Gövler dedi ki:

    @cihan, yazarlara bağlantı eklemek derken? Yazıdaki kodlarla yazarların isimleri, onların yazılarını gösterecek şekilde listelenir.

  3. cihan dedi ki:

    Yukarıdaki kod ile sadece tek yazarı çekiyor ve tıklayınca yazarın yazılarını listeliyor.

    Sizin verdiğin kodda ise yazarların hepsi listeleniyor fakat yazarların isimleri link olarak değil normal yazı olarak listeleniyor.

    Benim isteğim hem tüm yazarların listelenmesi hem de hepsine tıklandığında o yazarın yazdığı yazılara gidecek linklerin yer alması.
    Sizin yayınladığınız bileşeni de denedim. Yazarlar link olarak gelmiyor onda da.

  4. cihan dedi ki:

    @yakup, Sorunu çözdüm. html parametresi içi boş kalmaması lazım. Eğer html içeriği boş kalırsa yazıları yan yana ve bağlantısız listeliyor.

    Özetle; 'html' => '1' yaparak sorunu düzelttim.

  5. haber dedi ki:

    Peki benzeri bir işlemi üyeler için gerçekleştirebilirmiyiz. İyi çalışmalar dilerim.