<?php

/**
 * Core Comment API
 *
 * @package WordPress
 * @subpackage Comment
 */

/* function check_comment() – Check whether a comment passes internal checks to be allowed to add. */

/* function get_approved_comments() – Retrieve the approved comments for post $post_id. */

/* function get_comment() – Retrieves comment data given a comment ID or comment object. */

/* function get_comments() – Retrieve a list of comments. */

/* function get_comment_statuses() – Retrieve all of the WordPress supported comment statuses. */

/* function get_default_comment_status() – Gets the default comment status for a post type. */

/* function get_lastcommentmodified() – The date the last comment was modified. */

/* function get_comment_count() – Retrieves the total comment counts for the whole site or a single post. */

//
// Comment meta functions.
//

/* function add_comment_meta() – Add meta data field to a comment. */

/* function delete_comment_meta() – Remove metadata matching criteria from a comment. */

/* function get_comment_meta() – Retrieve comment meta field for a comment. */

/* function update_comment_meta() – Update comment meta field based on comment ID. */

/* function wp_queue_comments_for_comment_meta_lazyload() – Queues comments for metadata lazy-loading. */

/* function wp_set_comment_cookies() – Sets the cookies used to store an unauthenticated commentator’s identity. Typically used
to recall previous comments by this commentator that are still held in moderation. */

/* function sanitize_comment_cookies() – Sanitizes the cookies sent to the user already. */

/* function wp_allow_comment() – Validates whether this comment is allowed to be made. */

/* function check_comment_flood_db() – Hooks WP’s native database-based comment-flood check. */

/* function wp_check_comment_flood() – Checks whether comment flooding is occurring. */

/* function separate_comments() – Separates an array of comments into an array keyed by comment_type. */

/* function get_comment_pages_count() – Calculate the total number of comment pages. */

/* function get_page_of_comment() – Calculate what page number a comment will appear on for comment paging. */

/* function wp_get_comment_fields_max_lengths() – Retrieves the maximum character lengths for the comment form fields. */

/* function wp_check_comment_data_max_lengths() – Compares the lengths of comment data against the maximum character limits. */

/* function wp_check_comment_disallowed_list() – Checks if a comment contains disallowed characters or words. */

/* function wp_count_comments() – Retrieves the total comment counts for the whole site or a single post. */

/* function wp_delete_comment() – Trashes or deletes a comment. */

/* function wp_trash_comment() – Moves a comment to the Trash */

/* function wp_untrash_comment() – Removes a comment from the Trash */

/* function wp_spam_comment() – Marks a comment as Spam */

/* function wp_unspam_comment() – Removes a comment from the Spam */

/* function wp_get_comment_status() – The status of a comment by ID. */

/* function wp_transition_comment_status() – Call hooks for when a comment status transition occurs. */

/* function _clear_modified_cache_on_transition_comment_status() – Clears the lastcommentmodified cached value when a comment status is changed. */

/* function wp_get_current_commenter() – Get current commenter’s name, email, and URL. */

/* function wp_get_unapproved_comment_author_email() – Get unapproved comment author’s email. */

/* function wp_insert_comment() – Inserts a comment into the database. */

/* function wp_filter_comment() – Filters and sanitizes comment data. */

/* function wp_throttle_comment_flood() – Whether a comment should be blocked because of comment flood. */

/* function wp_new_comment() – Adds a new comment to the database. */

/* function wp_new_comment_notify_moderator() – Send a comment moderation notification to the comment moderator. */

/* function wp_new_comment_notify_postauthor() – Send a notification of a new comment to the post author. */

/* function wp_set_comment_status() – Sets the status of a comment. */

/* function wp_update_comment() – Updates an existing comment in the database. */

/* function wp_defer_comment_counting() – Whether to defer comment counting. */

/* function wp_update_comment_count() – Updates the comment count for post(s). */

/* function wp_update_comment_count_now() – Updates the comment count for the post. */

//
// Ping and trackback functions.
//

/* function discover_pingback_server_uri() – Finds a pingback server URI based on the given URL. */

/* function do_all_pings() – Perform all pingbacks, enclosures, trackbacks, and send to pingback services. */

/* function do_all_pingbacks() – Perform all pingbacks. */

/* function do_all_enclosures() – Perform all enclosures. */

/* function do_all_trackbacks() – Perform all trackbacks. */

/* function do_trackbacks() – Performs trackbacks. */

/* function generic_ping() – Sends pings to all of the ping site services. */

/* function pingback() – Pings back the links found in a post. */

/* function privacy_ping_filter() – Check whether blog is public before returning sites. */

/* function trackback() – Send a Trackback. */

/* function weblog_ping() – Send a pingback. */

/* function pingback_ping_source_uri() – Default filter attached to pingback_ping_source_uri to validate the pingback’s Source URI */

/* function xmlrpc_pingback_error() – Default filter attached to xmlrpc_pingback_error. */

//
// Cache.
//

/* function clean_comment_cache() – Removes a comment from the object cache. */

/* function update_comment_cache() – Updates the comment cache of given comments. */

/* function _prime_comment_caches() – Adds any comments from the given IDs to the cache that do not already exist in cache. */

//
// Internal.
//

/* function _close_comments_for_old_posts() – Close comments on old posts on the fly, without any extra DB queries. Hooked to the_posts. */

/* function _close_comments_for_old_post() – Close comments on an old post. Hooked to comments_open and pings_open. */

/* function wp_handle_comment_submission() – Handles the submission of a comment, usually posted to wp-comments-post.php via a comment form. */

/* function wp_register_comment_personal_data_exporter() – Registers the personal data exporter for comments. */

/* function wp_comments_personal_data_exporter() – Finds and exports personal data associated with an email address from the comments table. */

/* function wp_register_comment_personal_data_eraser() – Registers the personal data eraser for comments. */

/* function wp_comments_personal_data_eraser() – Erases personal data associated with an email address from the comments table. */

/* function wp_cache_set_comments_last_changed() – Sets the last changed time for the ‘comment’ cache group. */

/* function _wp_batch_update_comment_type() – Updates the comment type for a batch of comments. */

/* function _wp_check_for_scheduled_update_comment_type() – In order to avoid the _wp_batch_update_comment_type() job being accidentally removed,
check that it’s still scheduled while we haven’t finished updating comment types. */