obieAD - Chương trình quản lí  banner quảng cáo

Hướng dẫn s dụng
(Vietnamese)


Nội dung

  1. Cài đặt
  2. Cấu hình obieAD
  3. Sử dụng Admin control panel
  4. Hiển thị AD banner 
  5. FAQ(Frequently Asked Question)
  6. Một số thông tin thêm về obieAD
  7. Bản quyển tác giả

1 . Cài đặt

a . Để cài đặt trước tiên bạn phải download file obiead.rar (117Kb)  từ địa chỉ  obiewebsite.sourceforge.net hoặc bất kì một Website nào khác phân phối obieAD

b . Giải nén bằng phần mềm tương thích (ví dụ  winRAR : www.rarsoft.com ....) tới một thư mục (Ví dụ : obiead/)

c . Sử dụng phần mềm FTP như : cuteFTP hoặc WSFTP....để upload thư mục vừa giải nén lên server của bạn.Ví dụ đường dẫn sau khi upload lên server là : http://tenmien.com/bin/obiead

Bạn không phải CHMOD  các file này, obieAD sẽ kiểm tra và CHMOD file nếu cần thiết

Nếu server của bạn không hỗ trợ PHP4 hoặc bạn muốn tự CHMOD các file, các giá trị CHMOD là:

  1. inc/database.db : 744
  2. inc/submiter_database.db : 744
  3. inc/term.htm : 744
  4. inc/config.bak.php : 444
  5. config.php : 744
  6. index.php : 744
  7. obiead.js : 744

Bây giờ công việc cài đặt đã thành công.Hãy chắc chắn là bạn đã thực hiện đúng các bước trên.

2 . Cấu hình obieAD

a . Truy nhập vào  obieAD admin control panel  bằng liên kết: http://tenmien.com/bin/obiead/cp.php

b . Đăng nhập với username mặc định là : "admin" và mật khẩu mặc định : "admin

c . Click vào liên kết  "Edit configuration" để mở obiePAD và chỉnh sửa file

d . Trong quá trình chỉnh sử file config.php bạn phải chú ý không thay đổi dạng  format của file. Bạn chỉ được thay đổi các biến bắt đầu bằng kí tự "$" và kết thúc bằng kí tự ";"

Bảng 1 : Các biến chương trình obieAD

(Bạn chỉ thay đổi chữ màu nâu trong cột variable )

Variable Miêu tả Giá trị (Nên là)
$script_path='http://obiewebsite.sourceforge.net';

Đường dẫn  obieAD trên server của bạn

$adsfile='inc/database.db';

Đường dẫn tới dữ liệu chính

Không thay đổi
$submitfile='inc/submiter_database.db'; Đường dẫn tới dữ liệu đợi Không thay đổi
$max=100; Số lỗi  banner lớn nhất cho phép   100
$yesmail=1; Gửi thư sau khi thêm vào dữ liệu chính 1: Bật; 0: Tắt
$readterm=1; Yêu cầu người sử dụng phải đọc quy định 1: Bật; 0: Tắt
$termcontent='inc/term.htm'; Đường dẫn tới file "term of service" 
$admin_username='1'; Tên truy nhập của Admin
$admin_password='1'; Mật khẩu của Admin
$admin_email='admin@admin.com'; Địa chỉ thư điện tử của Admin
$entry_on_page=20 Số lần tối đa được hiển thị tại trang web 20
$admin_website='http://toolzone.info/'; Địa chỉ website của Admin
$background_color='white' Màu nền của  icons bar Your BODY bgcolor 
$w=100; Bề rộng của banner
$h=40; Độ cao của banner
$style=1; Dạng obieAD  (Xem chi tiết bảng 2) 1, 2 hoặc 3
$auto_error=1; Tự động phát hiện banner mắc lỗi
(Chỉ dành cho dạng 1)
1: Bật 0: Tắt
$numicons=3; Số banner tại trình duyệt máy khách
(Chỉ dành cho dạng  2 hoặc 3)
 

BẢNG 2 : Các dạng obieAD 

Kiểu 1

Một banner lớn

Kiểu 2

Nhiều icons (xếp đứng)

Kiểu 3

Nhiều icons (nằm ngang)

3 .Sử dụng Admin controlpanel

A . Admin control panel

Go to admin.php.

Tên truy nhập và mật khẩu mặc định là "admin" . Sau khi bạn đã đưng nhập vào, bạn có thể thay đổi lại mật khẩu bằng cách  click vào liên kết "Edit config.php", bạn tìm dòng : "$admin_username" và "$admin_password" sửa lại bằng mật khẩu và tên truy nhập bạn mong muốn

Sau khi đăng nhập vào control panel, bạn thấy một menu bên trái bao gồm các nội dung sau:.

Command

Miêu tả

Database manager

Quản trị dữ liệu của bạn. Bạn có thể chỉnh sửa hay xoá các cơ sở dữ liệu.

Submiter DB management

Quản trị cơ sở dữ liệu đợi của bạn.Bạn có thể chỉnh sửa hay xoá cơ sở dữ liệu đợi này

Đó là dữ liệu đợi xem xét

Generete code

Công cụ giúp bạn có thể tạo được mã hiển thị cho obieAD. Bạn sử dụng công cụ này khi có các thay đổi sau:

  • Thay đổi về kích thước banner

  • Thay đổi Style của obieAD

  • Thay đổi về số icons hiển thị (với style 1 và style 2)

Bạn chỉ cần thay đổi trong admin CP, mọi trang đã có lệnh gọi tới obieAD đều không phải sửa lại.

Edit config.php file

Mở ra obiePAD (Công cụ text editor online)để chỉnh sửa cấu hình file. Bạn không phải sử dungj bất cứ một trình FTP nào

Edit term of service file

Chỉnh sửa file "term of service". Bạn có thể dùng mã HTML với file này
File được lưu tại đường dẫn : inc/term.htm

Edit welcome file (index.php)

obieAD không cần file index.php. Bạn có thể chỉnh sửa hay thậm chí xoá hẳn file này.

Backup your data

Sao lưu lại dữ liệu của bạn

Manual

Xem phần hướng dẫn

Test

Thử nghiệm obieAD

B . obieAD functions

  • Chức năng đăng kí thành viên : signup.php

  • Chức năng đăng nhập : login.php

  • Chức năng xem tất cả các banner đã đăng kí (trong cơ sở dữ liệu chính) : func.php?action=showall

  • Chức năng xem tất cả các banner đang đợi xét duyệt (trong cơ sở dữ liệu đợi) : func.php?action=showsubmiters

Ví dụ: Bạn có thể tạo một liên kết và đặt tại bất cứ nơi nào trong trang web của bạn

Ví dụ: <a href="func.php?action=showall">Xem toàn bộ các banner đã đăng kí</a>

4 . Hiển thị AD banner

Để hiển thị AD banner tại trang web của bạn, bạn có thể chọn 2 cách dưới đây:

a . Cách thông thường (Bạn nên sử dụng cách này): nhúng obieAD sử dụng mã HTML

Sử dụng với các loại: *.html, *.htm, *.shtml, *.php, *.phtml, *.php3, *.asp, *.cgi ....
Đây là một cách dễ dàng,Obie sử dụng nó cho website của mình

<script src="PATH_TO_obieAD/obiead.js"></script>

Chú ý: Hàm "include" ở header của file : ad.php phải là : include "config.php";

b .Cách nâng cao : nhúng obieAD sử dụng mã PHP

Bước1 : Mở  file ad.php (Sử dụng một Text editor bất kì: Notepad...) thay thế dìng

include "config.php";
bằng dòng
include "SERVER_PATH/config.php";

Bước 2 : Thêm dòng này vào phàn mã trang web : <? include "SERVER_PATH/ad.php"; ?>

c . CHÚ Ý :

 Bạn có thể thấy SERVER_PATH ở Admin control panel

Bạn nên chỉ chọn 1 trong 2 cách trên.

5 . FAQ(Frequently Asked Question)

Chưa có câu hỏi nào được cập nhật.

Nếu bạn gặp vấn đề  hay phát hiển ra lỗi nào khi sử dụng ObieAD, xin liên hệ với tôi theo E-Mail:obie4web@yahoo.com

Mọi sự đóng góp của các bạn sẽ góp phần làm cho chương trình được tốt hơn.

Xin chân thành cám ơn

6 . Một số thông tin thêm  về obieAD

Cấu trúc dữ liệu của obieAD:

 

Name

Site name

User's email

User's URL

Banner URL

Username

Password

Number of clicks

Number of errors

Types of variables

String

String

String

String

String

String

Integer

Integer

Đặc biệt chú ý : obieAD sử dụng 2 cơ sở dữ liệu là các file dạng ".db". Cơ sở dữ liệu chính và cơ sở dữ liệu đợi, các file này có thể được chỉnh sửa bằng bất kì một Text Editor nào nhưng 2 file này phải bắt đầu bằng dòng : 

root|root|root|root|root|root|root|0|

 

Mô hình hoạt động của obieAD 

7. Bản quyền tác giả

ObieAD là một chưong trình quản lí banner có nhiều tính năng sử dụng mới. ObieAD yêu cầu UNIX server hỗ trợ PHP (tốt nhất là PHP4),đặc biệt là obieAD không đòi hỏi sử dụng bất cứ một SQL database server nào

Ứng dụng được thiết kế hoàn toàn bởi  Nguyễn Dương Minh

Đẩ là một ứng dụng hoàn toàn FREE , mã nguồn là hoàn toàn mở ,bạn có thể sử dụng,chỉnh sửa,hay giới thiệu cho bạn bè hay người khác sử dụng nhưng các dòng thông tin trong mỗi file *.php của obieAD cần được giữ lại và website phân phối phải liên kết trở lại obiewebsite.sourceforge.net.

Xem thêm thông tin về GNU tại : http://www.gnu.org


Vietnamese manual is translated by Linux


obieAD version 1.2
Copyright (c) 2003 Obie. All right reserved.