WWW Counter là một chơng trình CGI (Common Gateway Interface) dùng để đếm số lần truy cập trang web. Nó có thể hiển thị số lần truy cập trang web dới dạng hình ảnh (image). Số lần truy cập sẽ đợc ghi trong một tập tin văn bản và sẽ đợc chuyển đổi (convert) sang dạng ảnh GIF khi trình bày trên trang web. Ngoài ra WWW Counter còn có thể hiển thị ngày giờ. WWW Counter còn có thể dùng làm bộ đếm lùi đến một thời điểm xác định nào đó (chẳng hạn lúc 0 giờ 00 ngày 1 tháng 1 năm 2000)
Cách gọi chơng trình counter từ trang web
Để hiển thị số lần truy cập trang web bạn gọi chơng trình WWW counter từ trang web đó nh sau:
<img src="/cgi-bin/Count.cgi?df=filename.dat" align="absmiddle">
Tag <img> báo cho web browser biết đây là một file hình ảnh (image). Để hiểu và sử dụng tag <img>, bạn hãy tìm đọc các sách nói về ngôn ngữ HTML (HyperText Markup Language).
Phần src="..." cho biết địa chỉ của file ảnh mà web browser cần tải (load) xuống. Bạn phải chỉ đờng dẫn của chơng trình WWW Counter là "/cgi-bin/Count.cgi" hay là "http://members.tlnet.com.vn/cgi-bin/Count.cgi".
Phần sau dấu hỏi (?) gọi là QUERY STRING. Phần này sẽ đợc web server truyền cho chơng trình CGI nh là các thông số. Thông số bắt buộc là "df=filename.dat" nếu bạn muốn hiển thị số lần truy cập trang web, trong đó filename.dat là tên tập tin sẽ đợc dùng để ghi lại số lần truy cập trang web. Để sử dụng các thông số của chơng trình, bạn hãy xem phần "Counter Options".
* Chú ý:
Khi bạn tạo Personal Home Page trên mạng Phơng Nam, server đã tạo sẵn cho bạn tập tin dùng để ghi lại số lần truy cập Home Page của bạn. Tên tập tin trùng với user name của bạn, phần mở rộng là ".dat". Do đó, để đếm số lần truy cập Home Page của bạn, bạn dùng cú pháp nh sau:
<img src="/cgi-bin/Count.cgi?df=your_user_name.dat" align="absmiddle">
Bạn có thể dùng thêm các thông số (option, parameter) khác, hãy xem phần "Counter Options" và phần "Các ví dụ".
Chơng trình có thể hiển thị số lần truy cập với những kiểu số khác nhau lấy từ các bộ số chuẩn có sẵn trên server. Các bộ số chuẩn và mẫu của nó đợc liệt kê trong bảng sau:
| A |  |
| B |  |
| C |  |
| D |  |
| E |  |
| cd |  |
| cdd |  |
| cdr |  |
Để chỉ định bộ số cho chơng trình, bạn dùng
thông số "dd=digit_style". (Xem phần Counter Options). Bộ số mặc định
(default) là style A.
Ví dụ:
<img src="/cgi-bin/Count.cgi?df=myaccount.dat&dd=F" align="absmiddle">
Các thông số của Counter (Counter options)
Các thông số của Counter đợc truyền qua biến môi trờng CGI QUERY_STRING.
Sau đây là bảng các thông số của chơng trình Counter:
| Thông số | Giải thích | Giá trị mặc định |
| df=file_name |
Chỉ định tên file dùng để ghi lại số lần truy cập trang web. Bạn có thể dùng giá trị "random" để hiển thị một số ngẫu nhiên đợc chơng trình phát sinh một cách tự động. |
df=random |
| dd=digit_style |
Chỉ định bộ số sẽ đợc dùng để hiển thị số lần truy cập trang web. Giá trị digit_style có thể là một trong các giá trị sau: A, B, C, D, E, cd, cdr và cdd. |
dd=A |
| display=X |
Giá trị xủa X có thể là một trong các giá trị sau: counter, clock, date hay countdown. Tùy theo giá trị của thông số display mà chơng trình sẽ hiển thị số lần truy cập (counter), hiển thị giờ (clock), ngày tháng (date) hay đếm lùi (countdown). Nếu display=countdown thì chơng trình sẽ hiển thì thời gian tính từ thời điểm chạy chơng trình đến thời điểm đợc chỉ định bởi thông số cdt. Nếu display=countdown và bạn không chỉ định thông số cdt thì chơng trình sẽ đếm thời gian đến lúc 0 giờ 00 ngày 1 tháng giêng năm 2000, tức là lúc xảy ra sự cố máy tính Y2K. |
display=counter |
| cdt=year;month;day; hour;minute;second |
Chỉ định mốc thời gian dùng cho bộ đếm lùi. Định dạng của thông số cdt là một chuỗi 6 số nguyên ngăn cách bởi dấu chấm phẩy (;). Ví dụ, để chỉ định mốc thời gian là lúc 0 giờ 00 ngày 1 tháng 1 năm 2000 (lúc xảy ra sự cố Y2K) bạn dùng thông số cdt=2000;1;1;0;0;0 Ngoài ra ngày giờ còn phụ thuộc vào múi giờ (timezone). Múi giờ đợc chỉ định bởi thông số timezone. Nếu bạn không chỉ định múi giờ thì chơng trình sẽ lấy múi giờ của server. Múi giờ của web server của mạng Phơng Nam là múi giờ của Việt Nam, tức GMT + 0700. |
|
| sfd=B |
Giá trị của B là giá trị luận lý (boolean): T (true) hay F (false). Nếu B=T thì chơng trình sẽ hiển thị thời điểm chạy chơng trình (tức lúc bạn truy cập trang web) ở bên dới thời gian countdown (xem phần ví dụ minh họa). Giá trị mặc định là F. |
sfd=B |
| timezone=X |
Chỉ định múi giờ. Giá trị timezone chỉ có tác dụng khi thông số display có giá trị clock, date hay countdown. Giá trị của timezone đợc chỉ định bằng cách chỉ định độ lệch (offset) so với múi giờ số 0 (GMT). Ví dụ: timezone=GMT+0700 timezone=GMT-0530 |
|
| tformat=X | Thông số này dùng để chỉ định dạng thức của giờ sẽ đợc hiển thị. Giá trị của nó có thể là 12 hoặc 24. nếu tformat=12, chơng trình sẽ hiển thị AM hay PM theo sau tùy theo buổi sáng hay buổi chiều. | tformat=12 |
| dformat=X |
Thông số này chỉ có tác dụng khi display=date, dùng để định dạng hiển thị của ngày tháng. Giá trị hợp lệ của thông số này là một chuổi ký tự tạo thành bằng cách kết hợp của các chuổi DD (ngày), MM (tháng) và YY (năm). Ví dụ: dformat=MMDDYY dformat=DDMMYY dformat=YYMMDD Để hiển thị năm với 4 chữ số bạn dùng YYYY thay vì YY. Ví dụ: dformat=DDMMYYYY |
dformat=MMDDYY |
| md=X | Chỉ định chiều dài của chuổi số hiển thị. Giá trị hợp lệ là số nguyên dơng từ 5 đến 80. | md=6 |
| pad=B |
Nếu pad=T, các số 0 sẽ đợc điền thêm vào bên tráI cho đủ chiều dài md ký tự. Giá trị của B là giá trị luận lý. |
pad=F (Nếu không chỉ định thông số md) pad=T (Nếu có chỉ định thông số md) |
| comma=B | Nếu comma=T, chơng trình sẽ dùng dấu phẩy (,) làm dấu phân cách nhóm 3 chữ số hàng đơn vị, hàng nghìn, hàng triệu,... | comma=F |
| ft=X |
Chỉ định độ dày của đờng viền. Nếu muốn ảnh không có đờng viền, bạn chỉ định giá trị ft=0. |
ft=4 |
|
hoặc: frgb=RRGGBB hoặc: frgb=color_name |
Chỉ định màu của đờng viền. trong hệ RGB (Red Green Blue). Mỗi thành phần R, G, B là một số nguyên thập phân từ 0 đến 255 và ngăn cách bởi dấu chấm phẩy (;). Nếu bạn dùng định dạng RRGGBB thì các thành phần RR, GG, BB là các số hex 2 chữ số. Bạn cũng có thể chỉ định màu bằng cách cho biết tên của màu, nh red, green, blue, yellow, cyan,... Ví dụ: frgb=255;0;0 (màu đỏ) hay frgb=ff0000 (màu đỏ) hay frgb=red |
frgb=100;139;216 hay frgb=648bd8 |
| tr=B | Bạn dùng thông số này để chỉ định chơng trình có làm màu nền của counter trở nên trong suốt hay không. Nếu tr=T, chơng trình sẽ làm trong suốt ảnh bằng cách dùng màu trong suốt lấy từ thông số trgb. | tr=F (Không làm trong suốt) |
|
hoặc: trgb=RRGGBB hoặc: trgb=color_name |
Chỉ định màu sẽ đợc áp dụng khi làm trong suốt ảnh. Định dạng của thông số giống nh định dạng fgrb. |
trgb=0;0;0 hay trgb=000000 |
|
srgb=R;G;B hoặc: srgb=RRGGBB hoặc: srgb=color_name
prgb=R;G;B hoặc: prgb=RRGGBB hoặc: prgb=color_name |
Thay đổi màu ảnh của counter, từ màu srgb thành màu prgb. |
srgb=00ff00 (green) prgb=00ffff (cyan) |
| chcolor=B | Thông số này thờng dùng để thay đổi màu mặc định từ xanh lục (green) sang màu xanh lam (cyan). | chcolor=F |
| negate=B | Đảo ngợc màu ảnh. | negate=F (không đảo màu) |
|
degrees=X hoặc: angle=X |
Xoay ảnh đi một góc X độ, theo chiều ngợc kim đồng hồ, giá trị của X có thể là 90, 180 hay 270. | degrees=270 (nếu rotate=T) |
| rotate=B |
Xoay ảnh đi một góc 90 độ theo chiều kim đồng hồ (270 độ theo chiều ngợc kim đồng hồ). Khi bạn chỉ định bằng thông số degrees thì thông số rotate không cần thiết. |
rotate=F (không xoay ảnh) |
