Function Reference/comments popup link

از وردپرس ویکی
پرش به: ناوبری، جستجو

محتویات

شرح

این تابع یک لینک به صفحه بازشدنی دیدگاهها به نمایش می گذارد، البته در صورتی که از comments_popup_script() استفاده شده باشد، در غیر اینصورت یک لینک عادی به صفحه نوشته و به بخش دیدگاهها نشان می دهد. این تگ باید درون حلقه یا Loop یا حلقه دیدگاهها باشد.

کاربرد

<?php comments_popup_link( $zero, $one, $more, $css_class, $none ); ?>

پارامترها

$zero
(string) (optional) نوشته ای که هنگامی که دیدگاهی نیست به نمایش در می آید.
مقدار پیش فرض: 'No Comments'
$one
(string) (optional) نوشته ای که هنگامی که یک دیدگاه وجود دارد به نمایش در می آید.
مقدار پیش فرض: '1 Comment'
$more
(string) (optional) نوشته ای که هنگامی که بیش از یک دیدگاه وجود دارد به نمایش در می آید.. '%' با تعداد دیدگاه ها جایگزین می شود, بنابراین '% so far' هنگامی که 5 نظر وجود داشته باشد به صورت "5 so far" به نمایش در می آید..
مقدار پیش فرض: '% Comments'
$css_class
(string) (optional) CSS (stylesheet) یا کلاس شیوه نامه برای لینک.
مقدار پیش فرض: هیچ
$none
(string) (optional) نوشته ای که هنگامی که دیدگاه ها بسته هستند به نمایش در می آید.
مقدار پیش فرض: 'Comments Off'

نمونه

لینک با توجه به تعداد نظرات

<p>
<?php
  comments_popup_link( 'No comments yet', '1 comment', '% comments', 'comments-link', 'Comments are off for this post');
?>
</p>

مخفی کردن لینک هنگامی که دیدگاه ها بسته هستند

تگ پاراگراف یا <p></p> را که شامل comments_popup_link است، هنگامی که دیدگاه‌ها برای یک نوشته بسته هستند مخفی می کند. مناسب برای افرادی است که برای نوشته هایی خاص نظرات را مخفی می کنند. باید درون حلقه به کار رود

<?php
if ( comments_open() ) :
  echo '<p>';
  comments_popup_link( 'No comments yet', '1 comment', '% comments', 'comments-link', 'Comments are off for this post');
  echo '</p>';
endif;
?>

بارگذاری شیوه نامه گوناگون مناسب با تعداد دیدگاه ها

اگر می خواهید شیوه نامه های مختلفی را بارگذاری کنید از این روش بهره ببرید :

$css_class = 'zero-comments';
$number    = (int) get_comments_number( get_the_ID() );
 
if ( 1 === $number )
    $css_class = 'one-comment';
elseif ( 1 < $number )
    $css_class = 'multiple-comments';
 
comments_popup_link( 
    __( 'Post a Comment', 'your-theme' ), 
    __( '1 Comment', 'your-theme' ), 
    __( '% Comments', 'your-theme' ),
    $css_class,
    __( 'Comments are Closed', 'your-theme' )
);

Source File

comments_popup_link() is located in الگو:Trac.

Related

الگو:Tag Comments Tags

همچنین مرجع توابع در Function Reference و مرجع Template Tags را نیز ببینید.