blogger - widget 태그

위젯(=가젯)의 속성 값을 데이터 형식으로 반환 받을 수 있는 태그가 있습니다. 예를 들어 블로거 변수를 브라우저로 출력하기 위해 <data:…/> 형식으로 작성하는데, <b:section…/> 과 <b:widget…/> 의 속성 값을 다음 표의 태그로 반환 받을 수 있습니다.

속 성	데이터 태그	Ex.
섹션 ID	data:widget.sectionId	<b:section id='섹션 ID' …>
위젯 ID	data:widget.instanceId	<b:widget id='위젯 ID' …>
위젯 편집 URL	data:widget.quickEditUrl	관리자용 URL
위젯 Type	data:widget.type	<b:widget type='위젯 Type' …> Ex.) BlogArchive(블로그보관함 가젯)     HTML(HTML/JavaScript 가젯)     FollowByEmail(이메일구독 가젯)     PopularPosts(인기글 가젯)     PageList(페이지 가젯)
위젯 Version	data:widget.version	<b:widget version='위젯 Version' …>

위젯 데이터 태그는 공통된 데이터 태그이므로 모든 위젯에서 사용할 수 있지만 위젯 내에서만 사용 가능합니다.

<b:section id='Option' name='내 테마'>
<b:widget id='HTML900' title='사용자 정의' type='HTML' version='2'>
  <b:includable id='main'>
    섹션 ID: <data:widget.sectionId /><br/>
    위젯 ID: <data:widget.instanceId /><br/>
    위젯 Type: <data:widget.type /><br/>
    위젯 Version: <data:widget.version />
  </b:includable>
</b:widget>
</b:section>
<!--//
결과:
섹션 ID: Option
위젯 ID: HTML900
섹션 Type: HTML
위젯 Version: 2
//-->

위 예제를 통해 알 수 있듯 <b:section …/>과 <b:widget …/> 의 속성 값을 데이터로 반환 받았습니다. 주의할 점은 위젯 태그 내에서만 사용 가능하기 때문에 위젯 밖에서는 출력되지 않습니다.

data:widget.quickEditUrl 는 위젯 편집(관리자용) URL입니다. 관리자가 블로거 편집기 > 레이아웃의 단계를 거치지 않고 위젯을 바로 편집할 수 있는 링크를 제공합니다. 위젯 편집 URL은 다음 형식으로 출력됩니다.

https://www.blogger.com/rearrange?
  blogID=블로그 ID
  &widgetType=위젯 Type
  &widgetId=위젯 ID
  &sectionId=섹션 ID
  &action=editWidget

위젯 관리자용 URL은 다음 사례와 같이 링크로 사용할 수 있으며 편집 권한이 없는 사용자이면 에러 페이지로 리다이렉션(redirection)됩니다.

<b:widget id='HTML900' title='사용자 정의' type='HTML' version='2'>
  <b:includable id='main'>
    <h2><a expr:href='data:widget.quickEditUrl'><data:title/></a></h2>
  </b:includable>
</b:widget>
<!--//
결과:
<h2><a href='https://www.blogger.com/rearrange?blogID=123456789&widgetType=HTML&widgetId=HTML900&sectionId=Option&action=editWidget'>사용자 정의</a></h2>
//-->