Make WordPress Core


Ignore:
Timestamp:
07/02/2008 11:07:56 PM (17 years ago)
Author:
mdawaffe
Message:

crazyhorse: merge with log:trunk@8151:8240

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/crazyhorse/wp-includes/comment-template.php

    r7999 r8242  
    1010
    1111/**
    12  * get_comment_author() - Retrieve the author of the current comment
    13  *
    14  * If the comment has an empty comment_author field, then 'Anonymous' person
    15  * is assumed.
     12 * Retrieve the author of the current comment.
     13 *
     14 * If the comment has an empty comment_author field, then 'Anonymous' person is
     15 * assumed.
    1616 *
    1717 * @since 1.5
     
    3030
    3131/**
    32  * comment_author() - Displays the author of the current comment
     32 * Displays the author of the current comment.
    3333 *
    3434 * @since 0.71
     
    4141
    4242/**
    43  * get_comment_author_email() - Retrieve the email of the author of the current comment
     43 * Retrieve the email of the author of the current comment.
    4444 *
    4545 * @since 1.5
     
    5555
    5656/**
    57  * comment_author_email() - Display the email of the author of the current global $comment
    58  *
    59  * Care should be taken to protect the email address and assure that email harvesters
    60  * do not capture your commentors' email address. Most assume that their email address will
    61  * not appear in raw form on the blog. Doing so will enable anyone, including those that
    62  * people don't want to get the email address and use it for their own means good and bad.
     57 * Display the email of the author of the current global $comment.
     58 *
     59 * Care should be taken to protect the email address and assure that email
     60 * harvesters do not capture your commentors' email address. Most assume that
     61 * their email address will not appear in raw form on the blog. Doing so will
     62 * enable anyone, including those that people don't want to get the email
     63 * address and use it for their own means good and bad.
    6364 *
    6465 * @since 0.71
     
    7071
    7172/**
    72  * comment_author_email_link() - Display the html email link to the author of the current comment
    73  *
    74  * Care should be taken to protect the email address and assure that email harvesters
    75  * do not capture your commentors' email address. Most assume that their email address will
    76  * not appear in raw form on the blog. Doing so will enable anyone, including those that
    77  * people don't want to get the email address and use it for their own means good and bad.
     73 * Display the html email link to the author of the current comment.
     74 *
     75 * Care should be taken to protect the email address and assure that email
     76 * harvesters do not capture your commentors' email address. Most assume that
     77 * their email address will not appear in raw form on the blog. Doing so will
     78 * enable anyone, including those that people don't want to get the email
     79 * address and use it for their own means good and bad.
    7880 *
    7981 * @since 0.71
     
    9799
    98100/**
    99  * get_comment_author_link() - Retrieve the html link to the url of the author of the current comment
     101 * Retrieve the html link to the url of the author of the current comment.
    100102 *
    101103 * @since 1.5
     
    117119
    118120/**
    119  * comment_author_link() - Display the html link to the url of the author of the current comment
     121 * Display the html link to the url of the author of the current comment.
    120122 *
    121123 * @since 0.71
     
    127129
    128130/**
    129  * get_comment_author_IP() - Retrieve the IP address of the author of the current comment
     131 * Retrieve the IP address of the author of the current comment.
    130132 *
    131133 * @since 1.5
     
    141143
    142144/**
    143  * comment_author_IP() - Displays the IP address of the author of the current comment
     145 * Display the IP address of the author of the current comment.
    144146 *
    145147 * @since 0.71
     
    151153
    152154/**
    153  * get_comment_author_url() - Returns the url of the author of the current comment
     155 * Retrieve the url of the author of the current comment.
    154156 *
    155157 * @since 1.5
     
    164166
    165167/**
    166  * comment_author_url() - Display the url of the author of the current comment
     168 * Display the url of the author of the current comment.
    167169 *
    168170 * @since 0.71
     
    175177
    176178/**
    177  * get_comment_author_url_link() - Retrieves the HTML link of the url of the author of the current comment
    178  *
    179  * $linktext parameter is only used if the URL does not exist for the comment author. If the URL does
    180  * exist then the URL will be used and the $linktext will be ignored.
    181  *
    182  * Encapsulate the HTML link between the $before and $after. So it will appear in the order of $before,
    183  * link, and finally $after.
     179 * Retrieves the HTML link of the url of the author of the current comment.
     180 *
     181 * $linktext parameter is only used if the URL does not exist for the comment
     182 * author. If the URL does exist then the URL will be used and the $linktext
     183 * will be ignored.
     184 *
     185 * Encapsulate the HTML link between the $before and $after. So it will appear
     186 * in the order of $before, link, and finally $after.
    184187 *
    185188 * @since 1.5
     
    203206
    204207/**
    205  * comment_author_url_link() - Displays the HTML link of the url of the author of the current comment
     208 * Displays the HTML link of the url of the author of the current comment.
    206209 *
    207210 * @since 0.71
     
    217220
    218221/**
    219  * get_comment_date() - Retrieve the comment date of the current comment
     222 * Retrieve the comment date of the current comment.
    220223 *
    221224 * @since 1.5
     
    236239
    237240/**
    238  * comment_date() - Display the comment date of the current comment
     241 * Display the comment date of the current comment.
    239242 *
    240243 * @since 0.71
     
    247250
    248251/**
    249  * get_comment_excerpt() - Retrieve the excerpt of the current comment
     252 * Retrieve the excerpt of the current comment.
    250253 *
    251254 * Will cut each word and only output the first 20 words with '...' at the end.
     
    279282
    280283/**
    281  * comment_excerpt() - Returns the excerpt of the current comment
     284 * Display the excerpt of the current comment.
    282285 *
    283286 * @since 1.2
     
    289292
    290293/**
    291  * get_comment_ID() - Retrieve the comment id of the current comment
     294 * Retrieve the comment id of the current comment.
    292295 *
    293296 * @since 1.5
     
    303306
    304307/**
    305  * comment_ID() - Displays the comment id of the current comment
     308 * Displays the comment id of the current comment.
    306309 *
    307310 * @since 0.71
     
    313316
    314317/**
    315  * get_comment_link() - Retrieve the link to the current comment
     318 * Retrieve the link to the current comment.
    316319 *
    317320 * @since 1.5
     
    326329
    327330/**
    328  * get_comments_link() - Retrieves the link to the current post comments
     331 * Retrieves the link to the current post comments.
    329332 *
    330333 * @since 1.5
     
    337340
    338341/**
    339  * comments_link() - Displays the link to the current post comments
     342 * Displays the link to the current post comments.
    340343 *
    341344 * @since 0.71
     
    349352
    350353/**
    351  * get_comments_number() - Retrieve the amount of comments a post has
     354 * Retrieve the amount of comments a post has.
    352355 *
    353356 * @since 1.5
     
    374377
    375378/**
    376  * comments_number() - Display the language string for the number of comments the current post has
     379 * Display the language string for the number of comments the current post has.
    377380 *
    378381 * @since 0.71
     
    400403
    401404/**
    402  * get_comment_text() - Retrieve the text of the current comment
     405 * Retrieve the text of the current comment.
    403406 *
    404407 * @since 1.5
     
    413416
    414417/**
    415  * comment_text() - Displays the text of the current comment
     418 * Displays the text of the current comment.
    416419 *
    417420 * @since 0.71
     
    424427
    425428/**
    426  * get_comment_time() - Retrieve the comment time of the current comment
     429 * Retrieve the comment time of the current comment.
    427430 *
    428431 * @since 1.5
     
    445448
    446449/**
    447  * comment_time() - Display the comment time of the current comment
     450 * Display the comment time of the current comment.
    448451 *
    449452 * @since 0.71
     
    456459
    457460/**
    458  * get_comment_type() - Retrieve the comment type of the current comment
     461 * Retrieve the comment type of the current comment.
    459462 *
    460463 * @since 1.5
     
    474477
    475478/**
    476  * comment_type() - Display the comment type of the current comment
     479 * Display the comment type of the current comment.
    477480 *
    478481 * @since 0.71
     
    497500
    498501/**
    499  * get_trackback_url() - Retrieve The current post's trackback URL
    500  *
    501  * There is a check to see if permalink's have been enabled and if so, will retrieve
    502  * the pretty path. If permalinks weren't enabled, the ID of the current post is used
    503  * and appended to the correct page to go to.
     502 * Retrieve The current post's trackback URL.
     503 *
     504 * There is a check to see if permalink's have been enabled and if so, will
     505 * retrieve the pretty path. If permalinks weren't enabled, the ID of the
     506 * current post is used and appended to the correct page to go to.
    504507 *
    505508 * @since 1.5
     
    520523
    521524/**
    522  * trackback_url() - Displays the current post's trackback URL
     525 * Displays the current post's trackback URL.
    523526 *
    524527 * @since 0.71
     
    534537
    535538/**
    536  * trackback_rdf() - Generates and displays the RDF for the trackback information of current post
     539 * Generates and displays the RDF for the trackback information of current post.
    537540 *
    538541 * @since 0.71
     
    558561
    559562/**
    560  * comments_open() - Whether the current post is open for comments
     563 * Whether the current post is open for comments.
    561564 *
    562565 * @since 1.5
     
    575578
    576579/**
    577  * pings_open() - Whether the current post is open for pings
     580 * Whether the current post is open for pings.
    578581 *
    579582 * @since 1.5
     
    592595
    593596/**
    594  * wp_comment_form_unfiltered_html_nonce() - Displays form token for unfiltered comments
    595  *
    596  * Will only display nonce token if the current user has permissions for unfiltered html.
    597  * Won't display the token for other users.
    598  *
    599  * The function was backported to 2.0.10 and was added to versions 2.1.3 and above. Does not
    600  * exist in versions prior to 2.0.10 in the 2.0 branch and in the 2.1 branch, prior to 2.1.3.
    601  * Technically added in 2.2.0.
     597 * Displays form token for unfiltered comments.
     598 *
     599 * Will only display nonce token if the current user has permissions for
     600 * unfiltered html. Won't display the token for other users.
     601 *
     602 * The function was backported to 2.0.10 and was added to versions 2.1.3 and
     603 * above. Does not exist in versions prior to 2.0.10 in the 2.0 branch and in
     604 * the 2.1 branch, prior to 2.1.3. Technically added in 2.2.0.
    602605 *
    603606 * @since 2.0.10 Backported to 2.0 branch
     
    612615
    613616/**
    614  * comments_template() - Loads the comment template specified in $file
    615  *
    616  * Will not display the comments template if not on single post or page, or
    617  * if the post does not have comments.
     617 * Loads the comment template specified in $file.
     618 *
     619 * Will not display the comments template if not on single post or page, or if
     620 * the post does not have comments.
    618621 *
    619622 * Uses the WordPress database object to query for the comments. The comments
     
    670673
    671674/**
    672  * comments_popup_script() - Displays the JS popup script to show a comment
     675 * Displays the JS popup script to show a comment.
    673676 *
    674677 * If the $file parameter is empty, then the home page is assumed. The defaults
     
    701704
    702705/**
    703  * comments_popup_link() - Displays the link to the comments popup window for the current post ID.
    704  *
    705  * Is not meant to be displayed on single posts and pages. Should be used on the lists of posts
     706 * Displays the link to the comments popup window for the current post ID.
     707 *
     708 * Is not meant to be displayed on single posts and pages. Should be used on the
     709 * lists of posts
    706710 *
    707711 * @since 0.71
Note: See TracChangeset for help on using the changeset viewer.