카페24 기능 함수 (모디파이어)

728x90

https://sdsupport.cafe24.com/board/tip/read_begin.html?no=633&board_no=1002

스마트디자인 서포트

모디파이어 고급편 모디파이어 초급편을 이해하셨다면 아래의 여러가지 모디파이어를 통해 다양하게 변수를 활용해 보세요! 모디파이어 바로가기 ▶ 1. Cover 문자열이 존재할 경우 해당 문자열

sdsupport.cafe24.com

모디파이어란?

변수들의 데이터 형태를 다양화하기 위해 여러 형태의 모디파이어를 제공합니다.
디자인 편집창에서 변수의 "}" 전에 |(shift + ￦) 를 사용하면 모디파이어 목록이 나옵니다.

모디파이어 고급편

모디파이어 초급편을 이해하셨다면 아래의 여러가지 모디파이어를 통해 다양하게 변수를 활용해 보세요!

모디파이어 바로가기 ▶

1. Cover

문자열이 존재할 경우 해당 문자열을 감싸는 역할을 하는 문자를 설정하게 합니다.
사용방법) {$foo|cover:(,)}
|cover:앞에 감쌀문자,뒤에 감쌀문자

* 예시_ 게시판게시글의 제목에 특수문자를 감싸는 경우

게시판 제목글 변수에 이와 같이 치환 합니다. {$subject|cover:+++++ , +++++}

2. Cut

문자열을 표현할 개수만큼 잘라서 출력하는 역할을 합니다. 첫번째 인자는 표현할 문자의 개수이고, 두번째는 잘린 문자의 표현 형태를 뜻합니다.
사용방법) {$foo|cut:,}
|cut:자르고 싶은 숫자, 잘린 문자의 표현 형태

* 예시_ 상품명을 일정 글자수만큼만 보이게 하고 싶은 경우

상품명변수에 이와 같이 치환 합니다. {$product_name|cut:10,...}

3. Date

날짜와 시간을 출력하는 포맷을 지정합니다. 년도-월-일, 시간의 출력 순서를 변경할 수 있습니다.(월-일-년도 등)
사용방법) {$foo|date:Y-m-d H:i:s}
|date:년-월-일 시간:분:초

* 예시_ 어드민>게시판관리>작성일표시의 설정을 무시하고 날짜와 시간을 출력합니다.

작성일 표시의 "작성시간 표시"가 체크되어 있어도 아래와 같이 사용하면 시간을 출력하지 않습니다.
게시판상세와 게시판목록의 시간표시 설정을 다르게 하고 싶은 경우 많이 쓰입니다.
{$write_date|date:Y-m-d}

4. Imgconv

값이있으면 첫번째 인자로 전달된 이미지주소를 할당하여 이미지 태그로 치환됩니다.
값이 없을 경우 두번째 인자로 전달된 이미지 주소를 할당하여 이미지 태그로 치환됩니다. 두번째 인자를 주지 않았을 경우는 빈문자열로 치환하게 됩니다.
사용방법){$foo|imgconv:}
imgconv:대체할 이미지주소, 값이없는 경우 대체할 이미지주소

* 예시_ {$name_or_img_tag} 변수에 있는 텍스트가 아닌 이미지를 변경 하고 싶을 경우, imgconv 사용하여 지정한 이미지로 변경합니다.

{$name_or_img_tag|imgconv:'이미지 주소'}

5. Strconv

imgconv 모디파이어와 동일한 기능이나 문자열로 치환한다는점이 다릅니다.
사용방법) {$foo|strconv:change}
$foo 라는 변수에 값이 있는 경우엔 무조건 지정한 "change" 문자열로 변경이 됩니다.

* 예시_ 아이콘 변수에 이미지를 문자열을 변경 하고 싶을 경우

{$new_icon|strconv:신상품} -> 뉴아이콘 이미지 대신 "신상품"이라는 문자열로 출력됩니다.

6. Nl2br

DB상에 저장된 데이터 자체의 줄바꿈문자가 그대로 저장된 경우 브라우저에서 그대로 노출시키기 위해,

줄바꿈 문자열을 잡아내어 <br> 태그만을 삽입 할 수 있는 기능입니다.

사용방법) {$foo|nl2br}

7. Numberformat

숫자형태의 문자를 천단위 형태로 구분합니다.
사용방법) {$foo|numberformat}

* 예시_ 상품 판매가에 천단위 콤마를 사용.

{$product_price|numberformat}

8. Replace

문자열을 치환합니다.
사용방법){$foo|replace:a,b}
replace:찾을문자 "a", 치환할 문자"b", 매치되지않은 경우에 치환할 문자

* 예시_ 게시판에서 "공지"라고 노출되는 변수에 replace 모디파이어를 사용하여 "공지사항"으로 노출되도록 치환.

{$notice_icon|replace:공지,공지사항}

9. Striptag

변수에 적용된 태그를 모두 제거합니다.
사용방법) {$foo|striptag}

* 예시_ 상품명에 태그를 사용하여 등록하였는데 불가피하게 모두 삭제해야 하는 경우 striptag 사용하여 태그를 제거함.

{$product_name|striptag}

10. Timetodate

타임스탬프값을 사용자가 지정한 포맷형식으로 날짜를 출력합니다.
주의) $foo 라는 변수에는 타임스탬프값이 할당되어 있어야 합니다.사용방법) {$foo|timetodate:Y-m-d}

* 예시_ 날짜를 특정 날짜로 고정하기.

{$write_date|timetodate:2011-06-11 09:33:34}

11. Lower

모든 문자를 소문자로 변경합니다.사용방법) {$foo|lower}

* 예시_ 상품명에 출력되는 영문을 모두 소문자로 출력하기. 상품등록시 대소문자 구분없이 등록하여도 모두 소문자로 출력됩니다.

{$product_name|lower}

12. Upper

모든 문자를 대문자로 변경합니다.사용방법) {$foo|upper}

* 예시_ 상품명에 출력되는 영문을 모두 대문자로 출력하기. 상품등록시 대소문자 구분없이 등록하여도 모두 대문자로 출력됩니다.

{$product_name|upper}

13. Display

해당 값이 false를 리턴한다면, display:none으로 처리합니다. 어드민 기능상의 노출설정을 연동되게 할 때 사용합니다.사용방법) {$foo|display}

* 예시_ 상품정보 표시설정에서 설정표시가 '사용안함'표기 되어있으면 "display:none"처리되어 노출되지 않습니다.

<ul module="product_ListItem">
    <li class="{$item_display|display}"><strong class="title {$item_title_display|display}">{$item_title} :</strong> {$item_content}</li>
    <li class="{$item_display|display}"><strong class="title {$item_title_display|display}">{$item_title} :</strong> {$item_content}</li>
</ul>