Tagvn Widget
Tài liệu này hướng dẫn các cách sử dụng Tagvn Widget cho Website của bạn một cách có hiệu quả nhất.

Nội dung
  1. Giới thiệu
    1. Hoạt động ra sao
  2. Các loại hình Widget
    1. Javascript Widget
      1. Tính năng
      2. Tùy chỉnh thông số
      3. Cách sử dụng
    2. Iframe Widget
      1. Tính năng
      2. Cách sử dụng
        1. Quản lý chiều cao
      3. Tùy chỉnh thông số

Giới thiệu
Với Tagvn Widget, bạn có thể dễ dàng theo dõi những thông tin mới nhất, nóng hổi nhất của Tagvn ngay trên Website hay Blog của mình. Với khả năng tùy biến cao, giao diện đơn giản, dễ dàng tích hợp vào giao diện có sẵn, Tagvn Widget sẽ làm cho Website của bạn hấp dẫn hơn.

Hoạt động ra sao

Tagvn Widget là một đoạn code động (portable) có thể cài đặt và thực thi trong bất kì một trang web dòng HTML nào mà không cần biên dịch. Nó tương tự như thuật ngữ plugin hay extension của các ứng dụng. Nó là các đoạn javascript nhúng trong các trang web chính là các web widget.

Tagvn Widget sẽ giúp cho các webmaster làm phong phú thêm nội dung website của họ, các webmaster (có thể trong đó có bạn) sẽ có toàn quyền tinh chỉnh, tùy biến Tagvn Widget sao cho phù hợp nhất với website của mình.

Bạn chỉ cần chèn 1 đoạn code nhỏ do Tagvn cung cấp vào website của mình, Tagvn sẽ giúp bạn những việc còn lại!

Các loại hình Widget
Tagvn cung cấp cho người sử dụng đầu cuối 2 sự lựa chọn, đó là Javascript Widget và Iframe Widget.

Mỗi loại hình đều có ưu điểm lẫn nhược điểm, tùy thuộc vào nhu cầu sử dụng, bạn có toàn quyền quyết định nên sử dụng loại hình Widget nào cho Website của mình

Javascript Widget

Tagvn Javascript Widget là 1 đoạn code nhỏ, cho phép các webmaster chèn trực tiếp vào site của mình để hiển thị các thông tin đã được lựa chọn từ Tagvn.

Dưới đây là 1 ví dụ Javascript Widget hiển thị 2 thông tin mới nhất từ Tagvn với đầy đủ các loại hình thông tin (bao gồm cả link, video clip, hình ảnh hay media) cho tất cả các thư mục

Dưới đây là đoạn code đã được sử dụng để hiển thị

<script src="http://www.tagvn.com/widget?linktype=all&limit=3&linkstatus=queued&category=all&widgettype=js" type="text/javascript"></script>

Tính năng

Tagvn Javascript Widget có một tính năng rất nổi bật, đó là khả năng tự động điều chỉnh kích thước để phù hợp với Website của bạn. Không giống như Iframe Widget, Javascript Widget không cần thanh cuộn, chiều dài và chiều ngang của Widget được tự động thay đổi phụ thuộc vào vị trí cũng như kích thước của trang Web.

Do đó Javascript Widget rất được yêu chuộng do khả năng tùy biến cao, đơn giản, tốc độ nhanh.

Tùy chỉnh thông số

Tagvn cung cấp cho người sử dụng khả năng tùy biến cao để họ có thể lựa chọn ra được những thông tin phù hợp nhất cho website của minh

Tagvn Javascript Widget hiện có 4 thông tin để bạn tùy chỉnh:
ParameterGiá trịChú giải
linktypeall - 0 - 1 - 2 - 3Loại hình thông tin (Link, Video Clip, Hình ảnh hay Media
limitsốSố link hiển thị tối đa trong Widget
linkstatusall - published - queuedTình trạng của thông tin (Nổi tiếng nhất, Mới nhất hay Tất cả)
categoryall - giá trị ID của thư mục thông tinHiển thị thông tin chỉ trong một thư mục nào đó hoặc là tất cả

linktype

Các giá trị dành cho parameter linktype=

Parameter này có tác dụng là phân lọc các loại hình thông tin, để từ đó các Webmaster có thể dễ dàng tìm thấy những loại hình thông tin mà thích hợp nhất với nội dung website của mình
linktype (Giá trị)Chú giải
linktype=allHiển thị toàn bộ các loại hình thông tin (bao gồm Link, Video Clip, Hình ảnh và Media)
linktype=0Link
linktype=1Video Clip
linktype=2Hình ảnh
linktype=3Media


Một ví dụ về Tagvn Widget chỉ hiển thị các video clip nổi tiếng nhất trong tất cả các thư mục

Dưới đây là đoạn code đã được sử dụng để hiển thị

<script src="http://www.tagvn.com/widget?linktype=1&limit=3&linkstatus=published&category=all&widgettype=js" type="text/javascript"></script>

limit

Các giá trị dành cho parameter limit=

Parameter này có tác dụng là giới hạn số lượng thông tin được hiển thị tối đa cho từng Widget
limit (Giá trị)Chú giải
limit=(số lượng tin hiển thị)Thay (số lượng tin hiển thị) bằng số lượng tin bạn muốn hiển thị.

Ví dụ: limit=5


Một ví dụ về Tagvn Widget hiển thị 5 thông tin nổi tiếng trong tất cả các thư mục

Dưới đây là đoạn code đã được sử dụng để hiển thị

<script src="http://www.tagvn.com/widget?linktype=all&limit=5&linkstatus=published&category=all&widgettype=js" type="text/javascript"></script>

limit

Các giá trị dành cho parameter limit=

Parameter này có tác dụng là giới hạn số lượng thông tin được hiển thị tối đa cho từng Widget
limit (Giá trị)Chú giải
limit=(số lượng tin hiển thị)Thay (số lượng tin hiển thị) bằng số lượng tin bạn muốn hiển thị.

Ví dụ: limit=5


Một ví dụ về Tagvn Widget hiển thị 5 thông tin nổi tiếng trong tất cả các thư mục

Dưới đây là đoạn code đã được sử dụng để hiển thị

<script src="http://www.tagvn.com/widget?linktype=all&limit=5&linkstatus=published&category=all&widgettype=js" type="text/javascript"></script>

linkstatus

Các giá trị dành cho parameter linkstatus=

Sử dụng parameter này có thể giúp cho bạn chọn được tình trạng của thông tin để chúng được hiển thị (Nổi tiếng, mới nhất hoặc tất cả)
linkstatus (Giá trị)Chú giải
linkstatus=allHiển thị tất cả thông tin (bao gồm cả mới nhất lẫn nổi tiếng nhất
linkstatus=publishedChỉ hiển thị các thông tin nổi tiếng (được Tag nhiều nhất)
linkstatus=queuedChỉ hiển thị các thông tin mới nhất


Một ví dụ về Tagvn Widget hiển thị 2 thông tin mới nhất trong tất cả các thư mục

Dưới đây là đoạn code đã được sử dụng để hiển thị

<script src="http://www.tagvn.com/widget?linktype=all&limit=5&linkstatus=queued&category=all&widgettype=js" type="text/javascript"></script>

category

Các giá trị dành cho parameter category=

Quyết định thông tin trong thư mục nào được hiển thị trong Widget của mình bằng cách sử dụng parameter này.
category (Giá trị)Chú giải
category=allHiển thị tất cả thông tin trong mọi thư mục
category=(giá trị ID của thư mục thông tin)Thay giá trị ID của thư mục thông tin bằng số ID của thư mục mà bạn muốn hiển thị.

Ví dụ: category=55
Tên thư mụcID
Việt Nam hôm nay1
Xã hội & Pháp luật2
Phóng sự & Ký sự4
Lịch sử Việt Nam6
Âm nhạc12
Khác15
Nhịp sống trẻ26
Giáo dục & Du học27
Khám phá Việt Nam29
Văn hóa & Du lịch30
Thế Giới40
Tình yêu & Giới tính41
Nghệ thuật sống42
Sức khỏe & Làm đẹp44
Kinh tế Việt Nam46
Giải trí47
Điện ảnh48
Công nghệ49
World Wide Web50
Khoa học51
Danh nhân đất Việt52
Cuộc sống53
Ẩm thực55
Góc tâm tình56
Nối vòng yêu thương58
Thời trang & Nghệ thuật59
Thể thao60
Tản mạn quê hương61
Vui cười62
Phong tục & Lễ hội64
Tin tức thế giới65
Tài chính quốc tế66
Phần mềm68
Phần cứng69
Ngôi sao70
Tin tức công nghệ71
Bảo mật72
Kinh doanh73
Phân tích tài chính74
Game75
Tư liệu & Lịch sử Thế giới78
Chuyện lạ83
Ô tô & Xe máy84
Thủ thuật & Mods85
Hoạt hình & Truyện tranh86
Động vật & Thú cưng87
Doanh nhân88
Kiến trúc & Phong thủy92
Điện thoại95


Một ví dụ về Tagvn Widget hiển thị 2 thông tin mới nhất trong thư mục Ẩm thực

Dưới đây là đoạn code đã được sử dụng để hiển thị

<script src="http://www.tagvn.com/widget?linktype=all&limit=5&linkstatus=queued&category=55&widgettype=js" type="text/javascript"></script>

Cách sử dụng

Để sử dụng Tagvn Javascript Widget, bạn chỉ cần chèn đoạn code sau đây vào vị trí mà bạn muốn Widget hiển thị

<script src="http://www.tagvn.com/widget?linktype=all&limit=5&linkstatus=queued&category=55&widgettype=js" type="text/javascript"></script>

Sau đó thay thế các giá trị như linktype, limit, linkstatus, category bằng các thông số sao cho phù hợp với Website của bạn