توابع طراحی قالب وردپرس

پیوندی را برای صرف نظر از پاسخگویی به یک دیدگاه (دیدگاه تودرتو) نمایش می دهد و فرم ارسال نظر را به موقعیت پیش فرض بر می گرداند

<?php cancel_comment_reply_link('text'); ?>

text

نوع: رشته

متن پیوند صرف نظر از پاسخگویی. اگر خالی باشد، مقدار پیش فرض (برای صرف‌نظر کردن از پاسخ‌گویی اینجا را کلیک کنید.) استفاده خواهد شد.

نام نویسنده دیدگاه را نمایش می دهد؛ نامی که نویسنده دیدگاه هنگام ارسال دیدگاه وارد کرده است. اگر نامی وارد نشود و وارد کردن نام اجباری نباشد، "ناشناس" به عنوان نام نویسنده درج می گردد. برای اختیاری کردن وارد نمودن نام و نشانی ایمیل، می توانید به تنظیمات گفت و گوها مراجعه کنید.

<?php comment_author($comment_ID); ?>

$comment_ID

نوع: عدد صحیح

(اختیاری) آیدی دیدگاهی که مایل به نمایش نام نویسنده آن هستید. مقدار پیش فرض: 0 (دیدگاه فعلی).

نشانی ایمیل نویسنده دیدگاه را نمایش می دهد (بدون پیوند). اگر در تنظیمات گفت و گوها " دیگر تنظیمات دیدگاه‌ها نویسنده‌‌ی دیدگاه باید نام و نشانی ایمیل خود را بنویسد" تیک خورده باشد، نویسنده دیدگاه باید ایمیل خود را وارد کند.

<?php comment_author_email($comment_ID); ?>

$comment_ID

نوع: عدد صحیح

(اختیاری) آیدی دیدگاهی که مایل به نمایش نشانی ایمیل نویسنده آن هستید. مقدار پیش فرض: 0 (دیدگاه فعلی).

نشانی ایمیل نویسنده دیدگاه را با یک پیوند به صورت mailto نمایش می دهد. اگر در تنظیمات گفت و گوها " دیگر تنظیمات دیدگاه‌ها نویسنده‌‌ی دیدگاه باید نام و نشانی ایمیل خود را بنویسد" تیک خورده باشد، نویسنده دیدگاه باید ایمیل خود را وارد کند. این تابع باید درون حلقه استفاده شود. نکته: نمایش نشانی ایمیل نویسنده دیدگاه توصیه نمی شود زیرا می تواند مورد سوء استفاده قرا گیرد. برای دریافت کردن نشانی ایمیل، از تابع get_comment_author_email_link() استفاده کنید.

<?php comment_author_email_link('linktext', 'before', 'after'); ?>

linktext

نوع: رشته

متن پیوند به نشانی ایمیل نویسنده. مقدار پیش فرض نشانی ایمیل نویسنده است.

before

نوع: رشته

متن مورد نظر جهت نمایش پیش از پیوند. به صورت پیش فرض متنی نمایش داده نمی شود.

after

نوع: رشته

متن مورد نظر جهت نمایش پس از پیوند. به صورت پیش فرض متنی نمایش داده نمی شود.

نمایش نشانی آی پی نویسنده دیدگاه. این تابع باید درون حلقه وردپرس یا حلقه دیدگاه ها مورد استفاده قرار گیرد.

<?php comment_author_IP($comment_ID); ?>

$comment_ID

نوع: رشته

(اختیاری) آیدی دیدگاه مورد نظر جهت نمایش آی پی نویسنده. مقدار پیش فرض: خالی.

پیوندی به صفحه نویسنده دیدگاه با متن نام نویسنده آن نمایش می دهد. برای فراخوانی نشانی از تابع get_comment_author_link() استفاده کنید.

<?php comment_author_link($comment_ID); ?>

$comment_ID

نوع: عدد صحیح

(اختیاری) آیدی دیدگاه مورد نظر جهت نمایش پیوند به صفحه نویسنده آن. مقدار پیش فرض: 0 (دیدگاه فعلی).

نمایش نویسنده دیدگاه فعلی در فید آر اس اس.

<?php comment_author_rss(); ?>

این تابع پارامتری ندارد.

نشانی وبلاگ و یا وب سایت نویسنده دیدگاه را نمایش می دهد (بدون پیوند). اگر نویسنده دیدگاه نشانی وبلاگ یا وب سایت خود را وارد نکرده باشد، نشانی صفحه فعلی نمایش داده خواهد شد. در این صورت استفاده از تابع get_comment_author_url() یک رشته خالی برخواهد گرداند.

<?php comment_author_url($comment_ID); ?>

$comment_ID

Type: Integer

آیدی دیدگاه مورد نظر جهت نمایش پیوند به وب سایت و یا وبلاگ نویسنده آن. مقدار پیش فرض: 0 (دیدگاه فعلی).

آدرس وب سایت نویسنده دیدگاه را نمایش می دهد. این تابع باید درون حلقه استفاده شود. برای فراخوانی مقدار، از تابع get_comment_author_url_link() استفاده کنید.

<?php comment_author_url_link('linktext', 'before', 'after'); ?>

linktext

نوع: رشته

متن پیوند. مقدار پیش فرض آدرس وب سایت نویسنده دیدگاه است.

before

نوع: رشته

متن مورد نظر جهت نمایش پیش از پیوند. به صورت پیش فرض متنی وجو ندارد.

after

نوع: رشته

متن مورد نظر جهت نمایش پس از پیوند. به صورت پیش فرض متنی پس از آن نمایش داده نمی شود.

تاریخ ارسال دیدگاه را نمایش می دهد. برای فراخوانی مقدار از تابع get_comment_date() استفاده کنید.

<?php comment_date('d', $comment_ID); ?>

d

نوع: رشته

ساختار تاریخ

$comment_ID

نوع: عدد صحیح

(اختیاری) آیدی دیدگاه مورد نظر جهت نمایش تاریخش. مقدار پیش فرض: 0 (دیدگاه فعلی).

چکیده دیدگاه (حداکثر 20 کلمه) را نمایش می دهد. از get_comment_excerpt() برای دریافت مقدار استفاده کنید.

<?php comment_excerpt($comment_ID); ?>

$comment_ID

نوع: عدد صحیح

(اختیاری) آیدی دیدگاهی که چکیده اش باید نمایش داده شود. پیش فرض: 0 (دیدگاه فعلی).

عنوان فرم ارسال دیدگاه. تنها موقعی تأثیر دارد که جاوااسکریپت کاربر غیرفعال باشد یا فایل comment-reply.js فراخوانی نشده باشد. این تابع معمولا زیر <div id="respond"> و قبل از فرم ارسال دیدگاه استفاده می شود.

<?php comment_form_title('noreplytext', 'replytext', 'linktoparent'); ?>

noreplytext

نوع: رشته

اختیاری. متن مورد نظر هنگامی که به دیدگاه خاصی پاسخ داده نمی شود. مقدار پیش فرض 'ارسال دیدگاه است'.

replytext

نوع: رشته

اختیاری. متن مورد نظر هنگامی که به یک دیدگاه پاسخ داده می شود. از "%s" برای برگرداندن نام نویسنده دیدگاه استفاده کنید. مقدار پیش فرض 'پاسخ دادن به %s' است.

linktoparent

نوع: بولی

اختیاری. انتخاب اینکه نام نویسنده دیدگاه به دیدگاهش پیوند شود یا نه. مقدار پیش فرض True.

این تابع یک فرم کامل ارسال دیدگاه برای استفاده در قالب ارائه می دهد. اکثر متن ها و فیلدها با استفاده از پارامترهای این تابع قابل کنترل هستند. همچنین می توانید از فیلتر comment_form_default_fields استفاده کنید تا فیلدهای دلخواه خود را اضافه یا حذف نمایید. تمامی فیلدها توسط یک فیلتر فرم comments_form_field_$name ارسال می شوند که $name نام استفاده شده در آرایه فیلدهاست.

<?php comment_form($args, $post_id); ?>

$args

نوع: آرایه

اختیاری. تنظیماتی برای رشته ها و فیلدهای فرم. مقادیر پیش فرض:

<?php $args = array(
'fields'	=>	apply_filters( 'comment_form_default_fields', $fields ),
'comment_field'	=>	'<p class="comment-form-comment"><label for="comment">' . _x( 'Comment', 'noun' ) . '</label><textarea id="comment" name="comment" cols="45" rows="8" aria-required="true"></textarea></p>',
'must_log_in'	=>	'<p class="must-log-in">' . sprintf( __( 'You must be <a href="%s">logged in</a> to post a comment.' ), wp_login_url( apply_filters( 'the_permalink', get_permalink( $post_id ) ) ) ) . '</p>',
'logged_in_as'	=>	'<p class="logged-in-as">' . sprintf( __( 'Logged in as <a href="%1$s">%2$s</a>. <a href="%3$s" title="Log out of this account">Log out?</a>' ), admin_url( 'profile.php' ), $user_identity, wp_logout_url( apply_filters( 'the_permalink', get_permalink( $post_id ) ) ) ) . '</p>',
'comment_notes_before'	=>	'<p class="comment-notes">' . __( 'Your email address will not be published.' ) . ( $req ? $required_text : '' ) . '</p>',
'comment_notes_after'	=>	'<p class="form-allowed-tags">' . sprintf( __( 'You may use these <abbr title="HyperText Markup Language">HTML</abbr> tags and attributes: %s' ), ' <code>' . allowed_tags() . '</code>' ) . '</p>',
'id_form'	=>	'commentform',
'id_submit'	=>	'submit',
'title_reply'	=>	__( 'Leave a Reply' ),
'title_reply_to'	=>	__( 'Leave a Reply to %s' ),
'cancel_reply_link'	=>	__( 'Cancel reply' ),
'label_submit'	=>	__( 'Post Comment' ),
);
?>

$post_id

نوع: Mixed

(اختیاری) آیدی نوشته مورد نظر جهت ساختن فرم دیدگاه برای آن، در صورت عدم استفاده، برای نوشته فعلی ایجاد می شود. پیش فرض: Null (نوشته فعلی).

آیدی عددی دیدگاه فعلی را نمایش می دهد. این تابع باید درون حلقه یا حلقه دیدگاه ها استفاده گردد. برای دریافت مقدار از get_comment_ID استفاده کنید.

<?php comment_ID(); ?>

این تابع پارامتری ندارد.

دو ورودی مخفی برای فرم ارسال دیدگاه ایجاد می کند تا identify the comment_post_ID و comment_parent برای دیدگاه های تودرتو را شناسایی کند. این تابع باید درون قسمت <form> فایل comments.php استفاده شود.

<?php comment_id_fields(); ?>

این تابع پارامتری ندارد.

نمایش پیوند برای فراهم کردن قابلیت پاسخ دادن به هر دیدگاه. اگر جاوااسکریپت فعال باشد و فایل comment-reply.js نیز فراخوانی شده باشد با کلیک کردن روی پیوند، فرم ارسال دیدگاه به زیر دیدگاه مورد نظر منتقل می شود.

<?php comment_reply_link($args, $comment, $post); ?>

$args

نوع: آرایه

(اختیاری) آرایه ی تنظیمات. پایین را ببینید.

$comment

نوع: عدد صحیح

(اختیاری) آیدی دیدگاهی که به آن پاسخ داده می شود. پیش فرض: Null.

$post

نوع: عدد صحیح

(اختیاری) آیدی نوشته ای که دیدگاه برای آن ارسال می شود.

آرگومان های $args:

add_below

نوع: رشته

برای تابع جاوای moveAddCommentForm(). پیش فرض 'post' است.

respont_id

نوع: عدد صحیح

برای تابع جاوای moveAddCommentForm(). پیش فرض 'respond' است.

reply_text

نوع: رشته

تنها درصورتی که قابلیت ارسال دیدگاه وجود داشته باشد استفاده می شود. پیش فرض 'پاسخ'.

login_text

نوع: رشته

تنها در صورتی استفاده می شود که کاربر برای ارسال دیدگاه نیاز به وارد شدن داشته باشد. پیش فرض 'ببخشید برای ارسال دیدگاه باید وارد شوید' است.

depth

نوع: عدد صحیح

نمایش متن یک دیدگاه. برای دریافت متن دیدگاه، از تابع get_comment_text استفاده نمایید.

<?php comment_text($comment_ID); ?>

$comment_ID

عدد صحیح

(اختیاری) آیدی دیدگاهی که متنش باید نمایش یابد. پیش فرض: 0 (دیدگاه فعلی).

محتوای دیدگاه فعلی را برای استفاده در فیدها نمایش می دهد.

<?php comment_text_rss(); ?>

این تابع پارامتری ندارد.

زمان ارسال دیدگاه را نمایش می دهد. این تابع باید درون حلقه استفاده شود.

<?php comment_time(d); ?>

d

رشته

قالب بندی زمان. به صورت پیش فرض ساختار تنظیم شده در وردپرس می باشد.

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

<?php comment_type('comment', 'trackback', 'pingback'); ?>

comment

رشته

متن توصیف کننده دیدگاه. پیش فرض 'دیدگاه' است.

trackback

رشته

توصیف کننده نوع بازتاب. پیش فرض 'Trackback' است.

pingback

رشته

نوع بازخوان. پیش فرض 'Pingback' است.

این تابع آدرس دیدگاه های نوشته فعلی را نمایش می دهد. این تابع باید درون حلقه یا حلقه دیدگاه ها استفاده شود. از get_comments_link برای دریافت آدرس استفاده کنید.

<?php comments_link(); ?>

این تابع پارامتری ندارد.

تعداد کل دیدگاه ها را شامل دیدگاه های عادی، بازتاب ها و بازخوان های نوشته فعلی زا نمایش می دهد. این تابع باید درون حلقه وردپرس مورد استفاده قرار گیرد. از get_comments_number برای دریافت مقدار استفاده کنید.

<?php comments_number('zero', 'one', 'more'); ?>

zero

رشته

متن نمایش یافته هنگامی که دیدگاهی وجود ندارد. مقدار پیش فرض 'بدون دیدگاه' است.

one

رشته

متن نمایش یافته زمانی که یک دیدگاه وجود دارد. مقدار پیش فرض: 'یک دیدگاه'.

more

رشته

متن نمایش یافته زمانی که بیش از یک دیدگاه وجود دارد. تعداد دیدگاه ها با % جایگزین خواهد شد. مثلا اگر 5 دیدگاه وجود داشته باشد، حاصل '% دیدگاه' برابر '5 دیدگاه' خواهد بود. مقدار پیش فرض '% دیدگاه'.

یک لینک جهت نمایش دیدگاه ها به صورت پاپ آپ به نمایش می گذارد (در صورتی که comments_popup_script فراخوانی شده باشد). در غیر این صورت لینکی عادی به دیدگاه ها نمایش داده می شود. این تابع باید درون حلقه دیدگاه ها یا حلقه اصلی وردپرس مورد استفاده قرار گیرد. همچنین این تابع در صفحات برگه ها و نوشته ها کاری انجام نمی دهد.

<?php comments_popup_link('zero', 'one', 'more', 'CSSclass', 'none'); ?>

zero

رشته

متنی که هنگامی که دیدگاهی وجود ندارد نمایش داده می شود. متن پیش فرض 'بدون دیدگاه'.

one

رشته

متن نمایش یافته زمانی که یک دیدگاه وجود دارد. مقدار پیش فرض 'یک دیدگاه'.

more

رشته

متن نمایش یافته زمانی که بیش از یک دیدگاه وجود دارد. پیش فرض '% دیدگاه'.

CSSclass

رشته

کلاسی که به پیوند نسبت داده می شود. به صورت پیش فرض مقداری ندارد.

none

رشته

متن نمایش یافته زمانی که دیدگاه ها غیر فعال هستند.

کد جاوااسکریپ لازم برای پاپ آپ دیدگاه ها را بر می گرداند. این تابع معمولا در تگ <head> استفاده می گردد

<?php comments_popup_script(width, height, 'file'); ?>

width

عدد صحیح

(اختیاری) عرض پنجره پاپ آپ.

height

عدد صحیح

(اختیاری) ارتفاع پنجره پاپ آپ.

file

رشته

(اختیاری) مکان پنجره پاپ آپ را تنظیم می کند.

نمایش آواتار کاربر با دریافت آیدی و یا آدرس ایمیل او. معمولا در بخش دیدگاه ها مورد استفاده قرار می گیرد.

<?php echo get_avatar($id_or_email, $size, $default, $alt); ?>

$id_or_email

عدد صحیح

(ضروری) آیدی نویسنده و یا آدرس ایمیل او. در اکثر قالب های دیدگاه می توانید از $comment در اینجا استفاده کنید. در دیگر قالب ها، از get_the_author_meta('user_email') استفاده کنید.

$size

عدد صحیح

(اختیاری) اندازه آواتار جهت نمایش (حد اکثر 512). پیش فرض: 96.

$default

رشته

(اختیاری) آدرس عکس. مقدار پیش فرض: خالی.

$alt

رشته

(اختیاری) نوشته جایگزین عکس. پیش فرض: خالی.

Display link to the next comments pages.

<?php next_comments_link($label, $max_page); ?>

$label

String

Label for link text. Default: ''.

$max_page

Integer

(Optional) Max page. Default: 0.

Create pagination links for the comments on the current post. Basically this is a macro to paginate_links() which sets the functional options of paginate_links() to make it work for comments. But you may use all the parameters of paginate_links() to style the output of paginate_comments_links().

<?php paginate_comments_link($args); ?>

$args

String | Array

(Optional). Optional arguments. See paginate_links(). Defaults:

<?php $args = array(
'base'	=>	add_query_arg( 'cpage', '%#%' ),
'format'	=>	,
'total'	=>	$max_page,
'current'	=>	$page,
'echo'	=>	true,
'add_fragment'	=>	'#comments'
);
?>

These arguments are mostly to make the call of paginate_links() work, so be careful if you change them.

Displays the permalink to the post to which a comment belongs, formatted for RSS. Typically used in the RSS comment feed template. This tag must be within The Loop, or a comment loop.

<?php permalink_comments_rss(); ?>

No parameters.

Display the previous comments page link.

<?php previous_comments_link(); ?>

$label

String

(Optional) Label for comments link text.

Displays all comments for a post or Page based on a variety of parameters including ones set in the administration area.

<?php wp_list_comments($args); ?>

$args

Array

(Optional) Label for comments link text.

<?php $args = array(
'walker'	=>	null,
'max_depth'	=>	,
'style'	=>	'ul',
'callback'	=>	null,
'end-callback'	=>	null,
'type'	=>	'all',
'page'	=>	,
'per_page'	=>	,
'avatar_size'	=>	32
'reverse_top_level'	=>	null,
'reverse_children'	=>
);
?>

avatar_size

Integer

Size that the avatar should be shown as, in pixels. Default: 32. http://gravatar.com/ supports sizes between 1 and 512.

style

String

Can be either 'div', 'ol', or 'ul', to display comments using divs, ordered, or unordered lists. Defaults to 'ul'. Note that there are containing tags that must be written explicitly such as <div class="commentlist"><?php wp_list_comments(array('style' => 'div')); ?></div> or <ol class="commentlist"><?php wp_list_comments(array('style' => 'ol')); ?></ol>

type

String

The type of comment(s) to display. Can be 'all', 'comment', 'trackback', 'pingback', or 'pings'. 'pings' is 'trackback' and 'pingback' together. Default is 'all'.

reply_text

String

Text to display in each comment as a reply link. (This isn't an argument of this function but it gets passed to the get_comment_reply_link function.) Default is 'Reply'.

login_text

String

Text to display in each comment if users must be registered and logged in to comment . (This isn't an argument of this function but it gets passed to the get_comment_reply_link function.) Default is 'Log in to Reply'.

login_text

String

Text to display in each comment if users must be registered and logged in to comment . (This isn't an argument of this function but it gets passed to the get_comment_reply_link function.) Default is 'Log in to Reply'.

callback

String

The name of a custom function to use to display each comment. Defaults to null. Using this will make your custom function get called to display each comment, bypassing all internal WordPress functionality in this respect. Use to customize comments display for extreme changes to the HTML layout. Use with caution.

reverse_top_level

Boolean

Setting this to true will display the most recent comment first then going back in order.

reverse_children

Boolean

Setting this to true will display the children (reply level comments) with the most recent ones first, then going back in order.

فهرست

وردپرس نسخه 3,0+مرجع توابع مورد استفاده در کد نویسی پوسته

توابع دیدگاه ها

Cancel Comment Reply Linkcancel_comment_reply_link();

Comment Authorcomment_author();

Comment Author Emailcomment_author_email();

Comment Author Email Linkcomment_author_email_link();

Comment Author IPcomment_author_IP();

Comment Author Linkcomment_author_link();

Comment Author RSScomment_author_rss();

Comment Author URLcomment_author_url();

Comment Author URL Linkcomment_author_url_link();

Comment Datecomment_date();

Comment Excerptcomment_excerpt();

Comment Form Titlecomment_form_title();

Comment Formcomment_form();

Comment Datecomment_date();

Comment ID Fieldscomment_id_fields();

Comment Reply Linkcomment_reply_link();

Comment Textcomment_text();

Comment Text RSScomment_text_rss();

Comment Timecomment_time();

Comment Typecomment_type();

Comments Linkcomments_link();

Comments Numbercomments_number();

Comments Popup Linkcomments_popup_link();

Comments Popup Scriptcomments_popup_script();

Get Avatar get_avatar();

Next Comments Linknext_comments_link();

Paginate Comments Linknext_comments_link();

Peramlink Comments RSSpermalink_comments_rss();

Previous Comments Linkprevious_comments_link();

WP List Commentswp_list_comments();