From b77dd5349cb2774b94f20d8613c94b706fe1642f Mon Sep 17 00:00:00 2001 From: Angie Byron Date: Thu, 26 Nov 2009 06:44:50 +0000 Subject: [PATCH] #633750 by arianek, Shai, jhodgdon, and JuliaKM: Update Comment module to new documentation standards. --- modules/comment/comment.module | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/modules/comment/comment.module b/modules/comment/comment.module index d119b8c8f296..5cbf1ec290f3 100644 --- a/modules/comment/comment.module +++ b/modules/comment/comment.module @@ -76,11 +76,15 @@ define('COMMENT_NODE_OPEN', 2); function comment_help($path, $arg) { switch ($path) { case 'admin/help#comment': - $output = '

' . t('The comment module allows visitors to comment on your posts, creating ad hoc discussion boards. Any content type may have its Default comment setting set to Open to allow comments, Hidden to hide existing comments and prevent new comments or Closed to allow existing comments to be viewed but no new comments added. Comment display settings and other controls may also be customized for each content type.', array('@content-type' => url('admin/structure/types'))) . '

'; - $output .= '

' . t('Comment permissions are assigned to user roles, and are used to determine whether anonymous users (or other roles) are allowed to comment on posts. If anonymous users are allowed to comment, their individual contact information may be retained in cookies stored on their local computer for use in later comment submissions. When a comment has no replies, it may be (optionally) edited by its author. The comment module uses the same text formats and HTML tags available when creating other forms of content.') . '

'; - $output .= '

' . t('Change comment settings on the content type\'s edit page.', array('@content-type' => url('admin/structure/types'))) . '

'; - $output .= '

' . t('For more information, see the online handbook entry for Comment module.', array('@comment' => 'http://drupal.org/handbook/modules/comment/')) . '

'; - + $output = '

' . t('About') . '

'; + $output .= '

' . t('The Comment module allows users to comment on site content, set commenting defaults and permissions, and moderate comments. For more information, see the online handbook entry for Comment module.', array('@comment' => 'http://drupal.org/handbook/modules/comment/')) . '

'; + $output .= '

' . t('Uses') . '

'; + $output .= '
'; + $output .= '
' . t('Default and custom settings') . '
'; + $output .= '
' . t("Each content type can have its own default comment settings configured as: Open to allow new comments, Hidden to hide existing comments and prevent new comments, or Closed to view existing comments, but prevent new comments. These defaults will apply to all new content created (changes to the settings on existing content must be done manually). Other comment settings can also be customized per content type, and can be overriden for any given item of content. When a comment has no replies, it remains editable by its author, as long as the author has a user account and is logged in.", array('@content-type' => url('admin/structure/types'))) . '
'; + $output .= '
' . t('Comment moderation') . '
'; + $output .= '
' . t("Comments from users who do not have the Post comments without approval permission are placed in the Unapproved comments queue, until a user who has permission to Administer comments moderates them as either published or deleted. Published comments can be bulk managed on the Published comments administration page.", array('@comment-approval' => url('admin/content/comment/approval'), '@admin-comment' => url('admin/content/comment'))) . '
'; + $output .= '
'; return $output; } }