기사 플러그인
이 위키 플러그인 을 사용하여 위키 페이지 안으로 기사를 원하는 수만큼 포합하도록 하십시오. 한 개의 기사의 부분들을 포함하는 플러그인은 기사 플러그인 을 참고하십시오. 이 플러그인은 홈페이지에 상위 2개의 기사를 포함시킬 때 특히 유용합니다, 하지만, 어떠한 사용자 지정 위키 텍스트를 작성할 수도 있습니다.
기사의 목록의 짧은 요약은 pluginModule 을 이용하여 Module last_articles 을 사용할 수도 있습니다.
사용법
위키 페이지에 기사를 표시하려면, 다음 문법을 사용합니다:
Copy to clipboard
{ARTICLES(max=>3, topic=>tw,topicId=>1, type=>news, categId=>1, lang=>en, sort=>lastModif_asc)}{ARTICLES}
| Param | Values | Defaults | Req ? | Explanation | Since |
|---|---|---|---|---|---|
| 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, |
|
| periodUnit | 시간/일/주/월 | n | "Period quantity" 와 함께 사용되는 시간 단위 | 6.5, |
예제
아래의 예제에서는 위키 페이지가 기사들 (articles) 플러그인을 포함되어 페이지의 "! 뉴스" 헤딩아래에 최근 기사들이 보여지도록 되어있는 것을 볼 수 있습니다:
이 예제에서, 사용된 문법은 다음과 같습니다:
Copy to clipboard
{ARTICLES(max=>5,topicId=>!5)}{ARTICLES}
topic="!뉴스+이벤트' 로 설정되면, 뉴스 토픽이 아니거나 이벤트 토픽을 가진 기사들만이 표시될 것입니다. '+' 문자로 구분하여 원하는 만큼 많은 수의 토픽을 놓을 수 있습니다. '!' 문자는 아님 을 의미합니다 - 첫 번째 위치에만 올 수 있습니ㄷ. 구분자 주위에 스페이스를 두지 마십시오.
다국어지원
다국어지원은 2가지 측면에서 관리됩니다:
- 다국어지원과 최고 언어(best_language) 기능을 선택한 경우,그리고 이 플러그인이 정의된 언어를 보유하는 한 페이지에 삽입되었을 때, 일부 기사들은 필터과정에서 제외될 수 있습니다. 번역의 각 세트에 대하여, 이 세트의 한 기사가 페이지 언어와 동일한 언어를 가지고 있을 때, 세트 내부의 이 기사만이 표시될 것입니다. 이 기사가 번역의 세트 안에 있지 않거나 이 세트가 페이지 언어로된 기사가 없을 경우, 다른 언어로된 기사를 여전히 볼수잇다는 점에 유의하십시오.
- lang 매개변수를 사용하는 경우, 이 언어로 된 기사만이 표시될 것입니다.