List 플러그인

||Type|Object
{LIST()}
    {OUTPUT()}{display name=object_type}|{display name=object_id}
   {ALTERNATE()}This will display if no results are found{ALTERNATE}
{OUTPUT}
{LIST}
||

표 서식적용

{LIST()}
   {filter type=trackeritem}
   {filter content="water"}
   {OUTPUT(template="table")}
       {column sort="title" label="Title" field="title_link" mode=raw}
       {column label="Description" field="description"}
       {column sort="tracker_field_18" field="event_date" label="Event Date"}
   {OUTPUT}

   {FORMAT(name="title_link")}{display name=title format=objectlink}{FORMAT}
   {FORMAT(name="event_date")}{display name=tracker_field_18 format=date}{FORMAT}
{LIST}

미디어 목록 서식적용
Tiki13+
이 샘플은 현재 사용자에 의하여 획득된 뱃지 의 모록을 제공합니다.

↵
{LIST()}↵
{filter relation="" objecttype="user" qualifier="tiki.badge.received.invert"}↵
{OUTPUT(template=medialist)}↵
{icon field=tracker_field_image}↵
{body field=tracker_field_description}↵
{OUTPUT}{LIST}

(OUTPUT 내부의) column (열) 플러그인들이 템플릿으로 전송될 데이터 배열로 변환된다는 점에 주의하십시오. 표 서식은 스마티 형식을 사용하고 동일한 기능을 제공합니다.

주의 티키9 이후로, objectlink 와 trackerrender 서식적용된 값들과 같은 HTML 출력을 포함하는 열에서는 mode=raw 를 정의해야 할 것 입니다, 이는 티키 9에서의 구문분석기에 수정에 기인합니다.

위키 서식적용 (플러그인 내부에서)
각각의 결과에 대하여, 플러그인은 템플릿을 적용하는 것을 허용합니다.

• DISPLAY '플러그인' 은 개체 유형이 명명된 값을 포함하지 않는 경우, 그 값을 지정할 추가적 기본 매개변수를 보유할 수 있습니다
  • 값이 없을 경우 default="" 를 사용하여 "No value for ..." 대신 비어있는 값을 표시하도록 하십시오
• DISPLAY '플러그인' 운 사용자 지정 표시 방식을 지정하기 위하여 추가 format (형식) 매개변수를 보유할 수 있습니다
  • plain: 그대로, 기본 형식
    • 선택적 '분리자' (separator) 속성
  • date (날짜): 짧은 날짜 형식을 사용
  • datetime (날짜시간): 짧은 날짜 시간 형식을 사용 (티키8)
  • objectlink (개체링크): 값을 개체로의 링크에 대한 레이블로써의 사용
  • snippet: 다량의 텍스트의 초기 부분을 표기하기 위함
    • 선택적 'length' (길이) 속성
    • 선택적 'suffix' (접미어) 속성
  • reference (참조): 값에 기반하여 링크를 표시하기 위함
    • 필수 'type' (유형) 속성
    • 선택적 'separator'(구분자) 속성
    • 트래커 필드가 "page selector"(페이지 선택기) 필드인 트래커 필드에대하여 "format=reference" 를 사용하십시오. 이는 링크가 트래커 레코드가 아닌 페이지명이 트래커에 포함되어있는 페이지로 연결되었다는 것을 확인하기 위합입니다.
  • trackerrender: 트래커 필드를 렌더하기 위함 (trackerrender 사용시, 스마티 변수 "$context.search_render" 는 "y" 가 될 것이며 trackeroutput 스마티 tpl 내부에서 다른 형식을 가지기 위하여 사용될 수 있습니다)
  • wikiplugin: list 출력에 위키 플러그인을 렌더
    • name: 플러그인명. 예: wikiplugin_img
    • default: url 질의형식 내부의 임의의 매개변수에 대한 fallback 값 (예: field=42&caption="Not+Found) "(티키11)"
    • 기타 플러그인 매개변수 "(티키11)"
• (티키 9+) list_mode="y" 를 추가하여 해당 필드에 대하여 목록 표기 설정을 사용할 수 있습니다. 예: {display name="tracker_field_42" format="trackerrender" list_mode="y"}
• (티키 9+) pagetitle="y" 는 웹브라우저 제목을 pagetitle 으로 설정되어 결과 내부에 발견된 첫 항목에 대한 필드의 컨텐츠로 설정할 것입니다 (한 개의 항목 결과 페이지에 대하여 유용함)
• (티키 11+) pagedescription="y" 는metatag_pagedesc 선호설정이 활성화된 경우, 페이지의 메타 설명 태그를 결과에 발견된 첫번째 항목에 대한 필드의 내용물에 pagedescrption 으로 지정할 것입니다.
  • 주의: pagedescription 과 pagetitle 은 콘텐츠상에서 필터링이 수행되지 않으므로 일반 텍스트만을 사용하고 알파벳숫자가 아닌 글자는 피하도록 하십시오 (한글?)
• (티키 11+) editable=inline 은 필드를 온라인 편집가능하도록 설정할 것입니다. 필수사항: "인라인 편집 (트래커 내부에서 발견할 수 있음)" 및 열은 mode=raw 로 설정되어야 합니다. 즉:↵

{column label="First Name" field="firstName" mode=raw}↵
{FORMAT(name="firstName")}{display name="tracker_field_firstName" format=trackerrender editable=inline}{FORMAT}

• FORMAT '플러그인' 은 위키 템플릿을 적용하는 것과 명기된 값 내부에 저장하는 것을 허용합니다. 그러면 이 값은 다른 위키 템플릿 내부 혹은, 더 유용하게는 스마티 템플릿 내부에서 사용될 수 있습니다.

범주 링크 표시
{display name=categories format=reference type=category}

프리태그 링크 표시
{display name=freetags format=reference type=freetag}

항목 링크 표시
{display name=tracker_field_42 format=trackerrender}
{display name=tracker_field_42 format=reference type=trackeritem}

위키 페이지의 시작
{display name=wiki_content format=snippet length=500 suffix="..."}

(티키 8) 범주
{display name=categories format=categorylist singleList=y}
{display name=categories format=categorylist requiredParents="15,20" excludeParents="5,6"}
{display name=categories format=categorylist singleList=y separator=", "}

(Tiki 9|티키 9) 위키 플러그인
{display name="wikiplugin_addtocart" format=wikiplugin code="tracker_field_42" description="tracker_field_43" price="tracker_field_44"}↵
(Tiki 11|티키 11)↵
{display name="wikiplugin_img" format="wikiplugin" fileId="tracker_field_pic" thumb="box" default="fileId=42"})

{sort mode="tracker_field_18_asc"}
{sort mode="tracker_field_18_desc"}

숫자 정렬을 원하는 경우 (12가 2보다 커야되는), 다음을 대신 사용하십시오 (티키 8부터):

{sort mode="tracker_field_18_nasc"}
{sort mode="tracker_field_18_ndesc"}

티키 8부터는, 짧은 목록을 표시할 때 무작위 결과를 시뮬레이트하는 방법도 있습니다. 물론 이는 페이지 매김 기능과는 호환되지 않습니다. 무작위로 선택을 할 관련성없는 필드들 상에서 정렬 모드의 목록을 지정해야만 합니다, 예를 들면:

{sort mode="randommode" modes="tracker_field_18_nasc,tracker_field_18_ndesc,tracker_field_19_asc,trackerfield_19_desc"}

{LIST()}
    {output wiki=ResultsTemplatePageName"}
    {FORMAT(name=label)}{display name=title format=objectlink}
{display name=description}{FORMAT}
    {FORMAT(name=description)}{display name=description}{FORMAT}
{LIST}

그리고 나서, "ResultsTemplatePageName" 라는 위키 페이지 템플릿을 만들고 다음의 내용을 삽입합니다

{literal}
This is the label: {display name=label}
This is the description: {display name=description}
{/literal}

{display name=label} 과 {display name=description} 이 일반적인 스마티 변수들로 구문분석되는 것을 막기 위하여 "문자 그대로의" 스마티 태그가 요구된다는 점에 유의하십시오.

템플릿 내부에 HTML 의 사용을 원하는 경우, 올바른 방법은 다음과 같습니다:

{literal}
{HTML(wiki=1)}
<div>This is the label: {display name=label}</div>
<div>This is the description: {display name=description}</div>
{HTML}
{/literal}

고급 스마티 서식적용
추가 고급 서식적용에 대하여, 이 플러그인은 디스크에 저장된 스마티 템플릿에 의존할 수 있습니다. 템플릿은 resultset (결과세트) 에 입력으로써 보내집니다.

출력 플러그인의 컨텐츠는 템플릿 매개변수가 설정되었을 때 무시됩니다.

{LIST()}
    {output template=/path/to/file.tpl}

    {FORMAT(name="label")}{display name=title format=objectlink}
{display name=description}{FORMAT}
{LIST}