History: Articles (기사들) 플러그인

Source of version: 5 (current)

! 기사 플러그인
이 ((위키 플러그인)) 을 사용하여 위키 페이지 안으로 기사를 원하는 수만큼 포합하도록 하십시오. 한 개의 기사의 부분들을 포함하는 플러그인은 ((pluginArticle|기사 플러그인)) 을 참고하십시오. 이 플러그인은 홈페이지에 상위 2개의 기사를 포함시킬 때 특히 유용합니다, 하지만, 어떠한 사용자 지정 위키 텍스트를 작성할 수도 있습니다.

기사의 목록의 짧은 요약은 ((pluginModule)) 을 이용하여 ((Module last_articles)) 을 사용할 수도 있습니다.

!! 사용법
위키 페이지에 기사를 표시하려면, 다음 문법을 사용합니다:
{CODE(wrap=1)}{ARTICLES(max=>3, topic=>tw,topicId=>1, type=>news, categId=>1, lang=>en, sort=>lastModif_asc)}{ARTICLES}{CODE}

{PLUGINPARAMS()}max|숫자|||기사의 갯수를 제어하기 위함|
topic|문자열|||토픽을 필터함. 예: '뉴스', '!뉴스', '뉴스+이벤트', '!뉴스+이벤트'|
topicId|문자열|||토픽 ID를 필터함. 예: '1', '!1', '1+2', '!1+2' | 1.10
type|문자열|||유형을 필터함. 예: '기사', '!기사', '기사+리뷰', '!기사+리뷰'|
categId|숫자|||범주 ID를 필터함|
lang|문자열(en,fr,en_uk...)|||언어|1.9.7
sort|문자열(columnName_asc 혹은 columnName_desc 여기서 columnName 은 열 이름 (created, publishDate, title....) 혹은 무작위|||column asc 혹은 desc 로 정렬|1.10
order|수직 막대기로 구분된 기사ID| | |기사가 매개변수의 순서대로 페이지 내부에서 표시되는 경우, 목록의 상단에 기사를 놓게됨|9.0
articleId|수직 맏개리고 구분된 기사ID| | |이러한 기사ID 들만을 표시함 - 다른 필터 역시 적용됨|9.0
notArticleId|수직 막대기로 구분된 기사ID| | |이러한 기사ID 들을 표시하지 않음|9.0
start|숫자|||목록이 이 기사 번호부터 시작됨|5.0
fullbody|y 혹은 n|||y 혹은 n 로 지정하며 기사 전체가 표시되는지 아니면 헤더와 제목만을 표시되는지 여부를 지정함|5.0
dateStart, dateEnd|날짜|||YYYY-MM-DD 서식을 사용하여, 개제 날짜가 dateStart 보다 크거나 dateEnd 보다 작거나 같은 기사들이 포함됨|5.0
overrideDates|y 혹은 n|||이는 y 로 설정되는 것이 좋으며, 그 이유는 유형 매개변수 "Show before publish date" 혹은 "Show after expire date" 가 적절한 기사로 설정되지 않은 경우에도 여전히 기사들이 개제 혹은 만기날짜 조건의 '바깥쪽'일 가능성이 있는 dateStart 및 dateEnd 값들을 사용하여 추출될 수 있다.|5.0
containerClass|텍스트|||결과물 표시에 스타일을 규정짓기 위하여 사용된 css 클래스 스타일을 지정하는 텍스트|5.0
largefirstimage|y 혹은 n|||y 일 경우, 첫번째 그림이 기사 보기를 위하여 사용된 규격으로 표시됨|6.0
urlparam|url 매개변수| | |tiki-read_articles.php 로 추가할 부가적 매개변수 (예: from=y)|6.0
actions|y 혹은 n| y | |권한이 적절한 경우, 표시된 각 기사에 수행할 작업을 할 링크와 버튼을 표기하기 위한 변수. 'n'으로 설정되면, '댓글 추가' 로의 링크가 보여지지 않을 것이며, 기사를 편집할 버튼 또한 표시되지 않을 것임, 기타.|6.1
usePagination | y 혹은 n | n | | 기사 나열의 길이가 길 경우 페이지매김 기능을 활성화 |
Maximum Displayed | 슷지 | | |  목록에 표시될 기사의 수 (기본으로 최대값 설정되지 않음). Pagination 이 y (Yes) 로 설정된 경우, 이는 페이지당 기사 수를 결정함. 이는 __Use Pagination__ 가 활성화된 경우 필요함. |
periodQuantity | 슷지 | n |  |사용자가 정의한 시간 프레임안에 만들어진 기사만을 표시할 수치 값. 아래의 매개변수 "Period unit" 와 함께 사용되며, 이 매개변수는 시간 프레임을 정의하기 위하여 얼마나 많은 그러한 유닛들이 고려될 것인지를 나타냄. "max=-1" 과 함께 사용하여 모든 항목들을 나열함 (기본으로 "max" 는 10으로 설정됨). | 6.5, --7.2--, 8.0
periodUnit | 시간/일/주/월 | n |  |"Period quantity" 와 함께 사용되는 시간 단위 | 6.5, --7.x--, 8.0
{PLUGINPARAMS}

!! 예제
아래의 예제에서는 위키 페이지가 기사들 (articles) 플러그인을 포함되어 페이지의 "! 뉴스" 헤딩아래에 최근 기사들이 보여지도록 되어있는 것을 볼 수 있습니다: 

^::{img src="img/wiki_up/plugin_articles_01.png" }::^

이 예제에서, 사용된 문법은 다음과 같습니다:
{CODE()}
{ARTICLES(max=>5,topicId=>!5)}{ARTICLES}
{CODE}

topic="!뉴스+이벤트' 로 설정되면, 뉴스 토픽이 아니거나 이벤트 토픽을 가진 기사들만이 표시될 것입니다. '+' 문자로 구분하여 원하는 만큼 많은 수의 토픽을 놓을 수 있습니다. '!' 문자는 아님 을 의미합니다 - 첫 번째 위치에만 올 수 있습니ㄷ. 구분자 주위에 스페이스를 두지 마십시오.

!! 다국어지원
다국어지원은 2가지 측면에서 관리됩니다:
* 다국어지원과 최고 언어(best_language) 기능을 선택한 경우,그리고 이 플러그인이 정의된 언어를 보유하는 한 페이지에 삽입되었을 때, 일부 기사들은 필터과정에서 제외될 수 있습니다. 번역의 각 세트에 대하여, 이 세트의 한 기사가 페이지 언어와 동일한 언어를 가지고 있을 때, 세트 내부의 이 기사만이 표시될 것입니다. 이 기사가 번역의 세트 안에 있지 않거나 이 세트가 페이지 언어로된 기사가 없을 경우, 다른 언어로된 기사를 여전히 볼수잇다는 점에 유의하십시오.
* lang 매개변수를 사용하는 경우, 이 언어로 된 기사만이 표시될 것입니다.