튜토리얼 - 블로그 최근글

필수사항

WZDAPI를 따르는 위젯은 다음 조건들을 만족해야 합니다.

  • 위젯은 XHTML 형식의 파일 하나로 구성됩니다.
  • 이 파일은 UTF-8 문자셋으로 작성되어야 합니다.
  • 이 파일의 XML namespace로 http://wzdapi.com/widget/ 을 포함해야 합니다.
  • 이 파일에 주어진 외부 CSS나 외부 자바스크립트 파일은 위자드팩토리와 위자드닷컴에 등록할 때 자동으로 제외됩니다. 개발 및 테스트를 마친 후 위자드팩토리와 위자드닷컴에 등록하실 때는 반드시 필요한 외부 CSS나 외부 자바스크립트 파일을 XHTML 문서 안에 포함시켜 등록하십시오.

위 조건들을 만족하지 않는 경우 해당 위젯 파일은 위자드 팩토리 혹은 위자드닷컴에 정상적으로 등록이 불가능하므로 유의하십시오.

위젯정보

위젯 XHTML 문서는 head 태그 안에 위젯 이름을 포함한 여러가지 정보를 담게 되며 필수적으로 포함하여야 할 정보들은 다음과 같습니다.

항목 이름 의미
apiVersion 이 위젯이 사용한 API 버전. 현재 WZDAPI에서는 1.5 버전만 지원하고 있습니다.
author 이 위젯을 제작한 사람 혹은 단체의 이름

그 밖에 아래와 같은 정보들을 명시할 수 있습니다.

항목 이름 의미
website 이 위젯을 제작한 사람 혹은 단체의 웹사이트의 주소
email 이 위젯을 제작한 사람 혹은 단체의 이메일
keyword 이 위젯에 대한 키워드(태그). 각 키워드는 콤마(,)로 구분합니다.
description 이 위젯에 대한 설명
version 이 위젯의 버전
autoRefresh 이 위젯이 내용을 갱신할 시간 간격 (분 단위) (단. 위자드팩토리에서는 현재 지원하지 않습니다.)
width 이 위젯의 기본 가로 사이즈 (초기값은 170)
height 이 위젯의 기본 세로 사이즈 (초기값은 250)
fixedsize 이 위젯의 크기를 고정으로 하는 지 여부 (초기값은 false)
ratio 이 위젯의 크기를 기본 사이즈의 비율대로 조정할지 여부 (초기값은 false)

위젯에 필요한 아이콘 이미지는 총 4개가 필요합니다. 종류는 아래와 같습니다.

종류 크기 및 쓰임
icon 16 ×16 크기의 이미지. 위자드팩토리에서는 등록한 위젯 목록을, 위자드닷컴에서는 위젯 목록이나 제목 표시줄에 나타나는 아이콘입니다.
richicon 100 × 100 크기의 이미지. 위자드팩토리에서 위젯 목록이나 위젯 상세보기에 나타나는 이미지입니다. 위자드팩토리 등록시 필수입니다.
thumbnail 100 × 70 크기의 이미지. 위자드닷컴 등록시 오즈의 위젯 목록에 나타나는 썸네일입니다.
screenshot 가로 240 크기의 이미지. 위자드닷컴 등록시 오즈의 위젯 상세보기에서 보여지는 위젯의 스크린샷입니다. 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:widget="http://wzdapi.com/widget/">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="author" content="wizard works" />
<meta name="website" content="http://wzdworks.com/" />
<meta name="email" content="wzd@wzd.com" />
<meta name="apiVersion" content="1.5" />
<meta name="keyword" content="블로그, 유용한도구, 구독기, RSS, 카페, 도구, 최근글, 최신글" />
<meta name="description" content="블로그나 카페 등 RSS를 지원하는 사이트의 글을 위젯으로 만들어보세요. 내 블로그에서 자주가는 블로그나 
    카페의 글을 확인할 수 있습니다." />
<meta name="width" content="170" />
<meta name="height" content="233" />
<title>블로그 최근글</title>
<link rel="alternate" type="application/rss+xml" title="위자드웍스 공식 블로그" href="http://blog.wzdworks.com/rss" />
<link rel="icon" type="image/gif" href="http://image.widget.wzdfactory.com/wzd_rss/icon_rss.gif" />
<link rel="richicon" type="image/gif" href="http://image.widget.wzdfactory.com/wzd_rss/richicon_s2.gif" />
<link rel="thumbnail" type="image/gif" href="" />
<link rel="screenshot" type="image/gif" href="" />
</head>
<body>
</body>
</html>
미리보기