Comments확장은 태그가 존재하는 기사에 댓글을 달 수 있는 <comments /> 파서 후크를 더합니다.
댓글 동작은 Special:Log/comments에 로그를 기록하지만, 기본적으로 patrol 로그 엔터디에서 처럼 그것들은 숨겨집니다. Special:RecentChanges에 댓글 로그 엔터디를 보이기 위해 $wgCommentsInRecentChanges = true;를 설정할 수 있습니다 (버전 2.8+에서 사용할 수 있습니다).
대부분의 코드 수정은 Misza와 Jack Phoenix에 의해 수행됩니다.
Installation
미디어위키 확장 내려받기 지면에서 해당 판을 내려받아서 정해진 위치로 이동시킵니다.
미디어위키 설정 LocalSettings.php 파일에 다음을 추가합니다:
wfLoadExtension( 'Comments' );
이 확장에 필요한 필수 데이터베이스 테이블을 자동으로 생성하는 업데이트 스크립트를 실행하십시오:
- cd /var/www/html/w
- php maintenance/update.php
Special:Version에서, 확장이 활성화가 되었는지 확인을 하십시오.
Usage
- <comments /> — 기본 댓글 형식, 대부분의 경우에 충분합니다.
- <comments allow="Derfel,Jack Phoenix,Misza" /> — 오직 사용자 Derfel, Jack Phoenix 및 Misza에게 댓글 제출이 허용됩니다.
- <comments voting="Plus" /> — 댓글의 부정적인 표시 (thumb down)는 허락되지 않고, 긍정적인 표시 (thumb up)만 투표할 수 있도록 허용합니다.
Comments of the Day
이 확장은 "오늘의 댓글" 기능 (<commentsoftheday />)을 제공하지만, 기본적으로 활성화가 되어 있지 않습니다. 만약 이 기능을 활성화를 하고 싶다면, 미디어위키 설정 LocalSettings.php에 require_once 줄을 추가해야 합니다:
require_once "$IP/extensions/Comments/CommentsOfTheDay.php";
만약 nocache 인수가 파서 후크에 전달되면 (예를 들어: <commentsoftheday nocache=true />), 파서 후크는 memcached를 사용하지 않을 것이고 캐시 대신에 데이터베이스로부터 데이터를 가져올 것입니다. 이것은 가장 최신의 데이터를 표시하기를 원하면 유용하지만, 매우 많은 서버 자원을 소모할 것입니다.
User rights
이 확장은 3개의 새로운 사용자 권한을 더합니다:
- comment : 댓글을 허용합니다.
- commentlinks : 댓글에 외부 링크 포스팅을 허용합니다.
- commentadmin : 댓글 관리자가 사용자의 댓글을 지울 수 있도록 허용하며, 예를 들어,
$wgGroupPermissions['sysop']['commentadmin'] = true;
기본적으로, 모든 사용자, 심지어 익명 사용자는 댓글 게시를 할 수 있지만, 외부 링크를 포함하는 댓글을 포스팅하는 것은 자동-확인된 사용자로 제한됩니다.
만약 익명사용자에게 외부 링크를 포스팅하기를 원하면, require_once 뒤에 다음을 추가하십시오:
$wgGroupPermissions['*']['commentlinks'] = true;
기본적으로, 오직 commentadmin 그룹에 포함된 사용자가 댓글을 삭제할 수 있습니다.
User points
- $wgUserStatsPointValues['comment_plus'] — 또 다른 사용자들이 이 댓글에 대해 준 "thumbs up" 점수의 총합입니다.
- $wgUserStatsPointValues['comment_ignored'] — 또 다른 사용자들이 이 댓글에 대해 무시 목록 (Special:CommentIgnoreList)에 추가한 점수의 총합입니다.
Parameters
- $wgCommentsDefaultAvatar — social tools (SocialProfile 확장)이 설치되지 않으면, 아바타 대신에 사용할 이미지가 저장되는 경로. 반드시 50x50px이어야 합니다. Note that there is no default avatar image shipped with this extension. The default is defined in extension.json and links to an external image on shoutwiki.com server, an ad driven wiki farm. You may prefer to set this parameter to point to a local file.
- $wgCommentsInRecentChanges — 기본적으로, 이 변수는 false로 설정됩니다. Special:RecentChanges에 댓글 로그 엔터디 표시하기 위해 true로 설정하십시오. 마찬가지로 Special:Log/comments에 댓글 로그를 표시합니다.
- $wgCommentsSortDescending — 기본적으로, 이 변수는 false로 설정됩니다. 날짜 내림차순으로 정렬이 되며, 새 댓들 상자와 최근 댓글이 댓글 영역 최상위에 정렬하기 위해 true로 설정하십시오.
Magic words/Parser functions
Comments 확장은 2개의 마법 단어와 1개의 파서 함수를 포함합니다:
- {{NUMBEROFCOMMENTS}}는 위키에 전체 댓글의 개수를 제공합니다.
- {{NUMBEROFCOMMENTSPAGE}}는 현 지면의 댓글의 개수를 제공합니다.
- {{NUMBEROFCOMMENTSPAGE:<pagename>}}는 해당 지면의 댓글 개수를 제공합니다.
See also