comment.module
Version 1.520.2.14 (checked in on 2009/04/29 at 18:32:15 by drumm)
Enables users to comment on published content.
When enabled, the Drupal comment module creates a discussion board for each Drupal node. Users can post comments to discuss a forum topic, weblog post, story, collaborative book page, etc.
Constants
| Name | Description |
|---|---|
| COMMENT_ANONYMOUS_MAYNOT_CONTACT | Anonymous posters may not enter their contact information. |
| COMMENT_ANONYMOUS_MAY_CONTACT | Anonymous posters may leave their contact information. |
| COMMENT_ANONYMOUS_MUST_CONTACT | Anonymous posters must leave their contact information. |
| COMMENT_CONTROLS_ABOVE | Comment controls should be shown above the comment list. |
| COMMENT_CONTROLS_ABOVE_BELOW | Comment controls should be shown both above and below the comment list. |
| COMMENT_CONTROLS_BELOW | Comment controls should be shown below the comment list. |
| COMMENT_CONTROLS_HIDDEN | Comment controls are hidden. |
| COMMENT_FORM_BELOW | Comment form should be shown below post or list of comments. |
| COMMENT_FORM_SEPARATE_PAGE | Comment form should be displayed on a separate page. |
| COMMENT_MODE_FLAT_COLLAPSED | Comments are displayed in a flat list - collapsed. |
| COMMENT_MODE_FLAT_EXPANDED | Comments are displayed in a flat list - expanded. |
| COMMENT_MODE_THREADED_COLLAPSED | Comments are displayed as a threaded list - collapsed. |
| COMMENT_MODE_THREADED_EXPANDED | Comments are displayed as a threaded list - expanded. |
| COMMENT_NODE_DISABLED | Comments for this node are disabled. |
| COMMENT_NODE_READ_ONLY | Comments for this node are locked. |
| COMMENT_NODE_READ_WRITE | Comments are enabled on this node. |
| COMMENT_NOT_PUBLISHED | Comment is awaiting approval. |
| COMMENT_ORDER_NEWEST_FIRST | Comments are ordered by date - newest first. |
| COMMENT_ORDER_OLDEST_FIRST | Comments are ordered by date - oldest first. |
| COMMENT_PREVIEW_OPTIONAL | Comment preview is optional. |
| COMMENT_PREVIEW_REQUIRED | Comment preview is required. |
| COMMENT_PUBLISHED | Comment is published. |
Functions
| Name | Description |
|---|---|
| comment_access | This is *not* a hook_access() implementation. This function is called to determine whether the current user has access to a particular comment. |
| comment_admin | Menu callback; present an administrative comment listing. |
| comment_admin_overview | |
| comment_admin_overview_submit | Execute the chosen 'Update option' on the selected comments, such as publishing, unpublishing or deleting. |
| comment_admin_overview_validate | We can't execute any 'Update options' if no comments were selected. |
| comment_admin_settings | Menu callback; presents the comment settings page. |
| comment_block | Implementation of hook_block(). |
| comment_confirm_delete | |
| comment_confirm_delete_submit | |
| comment_controls | |
| comment_controls_submit | |
| comment_delete | Menu callback; delete a comment. |
| comment_edit | |
| comment_form | |
| comment_form_add_preview | |
| comment_form_alter | |
| comment_form_box | |
| comment_form_submit | |
| comment_form_validate | |
| comment_get_recent | Find a number of recent comments. This is done in two steps. 1. Find the n (specified by $number) nodes that have the most recent comments. This is done by querying node_comment_statistics which has an index on last_comment_timestamp, and is thus a... |
| comment_help | Implementation of hook_help(). |
| comment_invoke_comment | Invoke a hook_comment() operation in all modules. |
| comment_link | Implementation of hook_link(). |
| comment_links | |
| comment_menu | Implementation of hook_menu(). |
| comment_multiple_delete_confirm | List the selected comments and verify that the admin really wants to delete them. |
| comment_multiple_delete_confirm_submit | Perform the actual comment deletion. |
| comment_nodeapi | Implementation of hook_nodeapi(). |
| comment_node_url | |
| comment_num_all | |
| comment_num_new | get number of new comments for current user and specified node |
| comment_num_replies | |
| comment_operations | Comment operations. We offer different update operations depending on which comment administration page we're on. |
| comment_perm | Implementation of hook_perm(). |
| comment_render | Renders comment(s). |
| comment_reply | This function is responsible for generating a comment reply form. There are several cases that have to be handled, including: |
| comment_save | Accepts a submission of new or changed comment content. |
| comment_user | Implementation of hook_user(). |
| comment_validate | |
| int2vancode | Generate vancode. |
| theme_comment | |
| theme_comment_admin_overview | |
| theme_comment_block | Returns a formatted list of recent comments to be displayed in the comment block. |
| theme_comment_controls | |
| theme_comment_flat_collapsed | |
| theme_comment_flat_expanded | |
| theme_comment_folded | |
| theme_comment_post_forbidden | |
| theme_comment_preview | |
| theme_comment_thread_collapsed | |
| theme_comment_thread_expanded | |
| theme_comment_view | |
| theme_comment_wrapper | Allow themable wrapping of all comments. |
| vancode2int | Decode vancode back to an integer. |
| _comment_delete_thread | |
| _comment_form_submit | |
| _comment_get_display_setting | Return a current comment display setting |
| _comment_get_modes | Return an array of viewing modes for comment listings. |
| _comment_get_orders | Return an array of viewing orders for comment listings. |
| _comment_load | Load the entire comment by cid. |
| _comment_per_page | Return an array of "comments per page" settings from which the user can choose. |
| _comment_update_node_statistics | Updates the comment statistics for a given node. This should be called any time a comment is added, deleted, or updated. |