Hướng dẫn sử dụng GTA-26002
1. Cài đặt
- Tải toàn bộ file lên cùng một thư mục trên hosting (kể cả
.htaccess). Cần PHP 8.1+ vớipdo_sqlitevàmbstring. - Cấp quyền ghi cho thư mục để ứng dụng tạo được
26002.db. - Mở
26002.install.phptrên trình duyệt, nhập tên sổ tay, khẩu hiệu, tên đăng nhập và mật khẩu (tối thiểu 8 ký tự). - Cài xong, file cài đặt tự xoá và bạn được đăng nhập luôn. Nếu trang báo không tự xoá được, hãy xoá
26002.install.phpthủ công.
.htaccess, nên phải tự chặn truy cập trực tiếp vào CSDL và thư viện:
location ~ ^/(.*/)?26002\.(db.*|lib\.php|ui\.php)$ { deny all; }
Nếu dùng rewrite URL, thêm:
rewrite ^/p/([^/]+)/?$ /26002.php?p=$1 last;2. Đăng nhập
Vào 26002.admin.php và nhập tài khoản đã tạo. Sai 5 lần liên tiếp sẽ bị khoá 15 phút. Khi đã đăng nhập, trang ngoài có thêm nút Quản trị, bạn xem được mọi bài (kể cả riêng tư) và lượt xem của bạn không bị tính.
3. Viết bài
Vào Viết bài ở thanh bên của trang quản trị. Cột bên phải chứa phần xuất bản.
- Tiêu đề bắt buộc. Đường dẫn (slug) để trống thì tự tạo từ tiêu đề (bỏ dấu tiếng Việt), nếu trùng sẽ tự thêm
-2,-3… - Định dạng: Văn bản thuần, Markdown (mặc định) hoặc HTML. Với HTML, các thẻ
<script>,<style>, thuộc tínhon…và liên kếtjavascript:bị loại bỏ khi hiển thị;<iframe>chạy trong khung sandbox. - Thanh công cụ bọc phần chữ đang chọn bằng in đậm, nghiêng, tiêu đề, liên kết, danh sách, trích dẫn hoặc mã.
- Xem trước: bấm Xem trước để thấy bài hiển thị thật, bấm Soạn để quay lại.
- Nhấn
Ctrl/⌘+Sđể lưu nhanh. Dưới ô soạn có bộ đếm từ và thời gian đọc ước tính.
4. Cú pháp Markdown
| Bạn gõ | Kết quả |
|---|---|
# Tiêu đề lớn
## Tiêu đề nhỏ | Tiêu đề (từ # đến ######) |
**đậm** *nghiêng* ~~gạch~~ | đậm nghiêng |
[chữ](https://example.com) | Liên kết (mở tab mới) |
 | Ảnh |
- mục một
- mục hai
- mục con | Danh sách, thụt 2 dấu cách để lồng |
1. bước một
2. bước hai | Danh sách đánh số |
> trích dẫn | Khối trích dẫn |
`mã nội dòng` | Mã trong dòng |
```
khối mã
``` | Khối mã nhiều dòng |
--- | Đường kẻ ngang |
| A | B |
|---|--:|
| 1 | 2 | | Bảng (:-- căn trái, --: căn phải, :-: căn giữa) |
Liên kết có giao thức lạ (như javascript:) không được chuyển thành link.
5. Chế độ hiển thị
| Chế độ | Ở danh sách | Ai xem được |
|---|---|---|
| Công khai | Có | Mọi người |
| Không liệt kê | Không | Ai có đường link |
| Riêng tư | Không | Chỉ quản trị viên (người khác thấy 404) |
| Mật khẩu | Không | Ai nhập đúng mật khẩu của bài; trình duyệt nhớ trong phiên |
Mọi bài không công khai đều gắn noindex. Khi sửa bài đã có mật khẩu, để trống ô mật khẩu nếu muốn giữ mật khẩu cũ.
6. Layout danh sách bài ở trang ngoài
Vào Cài đặt → Giao diện trang ngoài và chọn một trong năm kiểu:
- Thẻ: mỗi bài một thẻ lớn kèm trích đoạn.
- Lưới: nhiều cột, mỗi bài có ảnh bìa tự tạo từ chữ cái đầu của tiêu đề.
- Danh sách: dạng blog tối giản, ngày ở bên trái.
- Lưu trữ: chỉ tiêu đề, gom theo tháng; hợp với sổ tay nhiều bài.
- Nổi bật: bài mới nhất hiển thị lớn, các bài còn lại dạng lưới.
Đó là kiểu mặc định. Khách truy cập có thể tự đổi bằng nhóm nút ở trên danh sách, lựa chọn được nhớ trong phiên của họ. Số bài mỗi trang chỉnh ở cùng mục Cài đặt.
8. Nội dung đầu trang và cuối trang chủ
Vào Cài đặt → Nội dung trang chủ.
- Đầu trang: hiện trong khối giới thiệu lớn ở trang 1 của trang chủ, ngay dưới tên sổ tay và khẩu hiệu.
- Cuối trang: hiện thành một khối riêng dưới danh sách bài.
Mỗi phần chọn riêng định dạng (văn bản thuần, Markdown hoặc HTML). Để trống thì không hiển thị. Khi khách đang tìm kiếm hoặc ở trang 2 trở đi, các khối này được ẩn để kết quả gọn hơn.
9. Thống kê
Trang Tổng quan cho số bài, tổng lượt xem, hôm nay, 7 ngày qua, biểu đồ 14 ngày và 5 bài xem nhiều nhất. Trang Thống kê mở rộng ra 30 ngày và bảng xếp hạng đầy đủ.
Cách tính: mỗi người xem chỉ được tính một lần cho mỗi bài trong một phiên, và lượt xem của quản trị viên đã đăng nhập không được tính. Đây là số ước lượng, không phải số người truy cập duy nhất.
10. Cài đặt khác
- Tên sổ tay, khẩu hiệu, số bài mỗi trang.
- Tông màu: 10 màu, mặc định
#0053ee. - Rewrite URL: link bài dạng
/p/ten-bai. Cần Apache bậtmod_rewritevàAllowOverride; Nginx xem mục 1. Nếu bật mà ra lỗi 404, hãy tắt tuỳ chọn này. - Đổi mật khẩu: cần nhập mật khẩu hiện tại; mật khẩu mới tối thiểu 8 ký tự.
- Nhiều bản cài đặt: mỗi thư mục là một bản độc lập (CSDL và cookie riêng). Sao lưu chỉ cần chép
26002.db.
11. Xử lý sự cố
Trang trắng hoặc lỗi 500
Kiểm tra PHP từ 8.1 trở lên, đã bật pdo_sqlite và mbstring; xem log lỗi của máy chủ.
“Không tạo được 26002.db”
Thư mục chưa có quyền ghi cho tài khoản chạy PHP.
Giao diện mất kiểu
Kiểm tra 26002.css đã được tải lên cùng thư mục.
Quên mật khẩu quản trị
php -r "echo password_hash('MẬT_KHẨU_MỚI', PASSWORD_DEFAULT), PHP_EOL;"
sqlite3 26002.db "UPDATE settings SET value='MÃ_BĂM_VỪA_TẠO' WHERE key='admin_pass_hash';"
26002.db và cài lại, nhưng toàn bộ bài viết sẽ mất.Bị khoá vì đăng nhập sai
Đợi 15 phút rồi thử lại.