Hướng dẫn AI Web

AI Web (AIPage) là nền tảng PHP + SQLite giúp triển khai landing page + blog + shop trên một domain — tối ưu cho người làm marketing, agency và team dùng AI coding agent.

Chi tiết từng điểm mạnh

Tính năng	Bạn được gì	Xem thêm
🤖 Tối ưu AI Agent	Tạo key aiw_… trên site → kiểm tra kết nối trong Cài đặt → agent gọi REST API: tạo/sửa landing, đăng blog, quản lý shop. Skill aiweb_skill trên GitHub cho Cursor/Codex.	API Agent
🌐 Đa ngôn ngữ	Cài đặt chung: chọn ngôn ngữ UI Blog & Shop. Bật Google Translate trên trang chi tiết bài — khách tự chọn English hoặc ngôn ngữ khác.	Blog · Cài đặt
💳 VietQR & đơn 1-click	Khách đặt hàng → hiện mã VietQR + số tiền + nội dung CK. Admin nhận Telegram → bấm link mở đơn, cập nhật trạng thái, in hóa đơn — không cần vào menu nhiều bước.	Shop
📈 SEO	SEO global + ghi đè từng landing/bài viết; ảnh OG; URL thân thiện (/blog/slug, /shop/slug, /san-pham redirect); sitemap tự sinh khi publish.	SEO
🧩 Landing kết hợp Blog & Shop	Editor landing: nút Blog/Shop chèn widget động — dữ liệu luôn mới từ DB. Giỏ hàng dùng chung trên mọi trang shop.	Landing · Widget
👑 Sở hữu hoàn toàn	Mua một lần — không phí thuê bao hàng tháng. Toàn quyền sửa giao diện, HTML, CSS/JS global, cơ sở dữ liệu SQLite. Copy lên hosting PHP (XAMPP, cPanel…) là dùng; không Docker, không MySQL bắt buộc.	Cài đặt · Tùy chỉnh

Làm lần lượt từng bước — mỗi bước 2–5 phút. Chi tiết xem mục tương ứng bên dưới.

Bước	Việc cần làm	Ở đâu
① Cài đặt	Chọn trang chủ, thương hiệu, giao diện	Cài đặt
② Landing	Tạo trang → dán HTML hoặc AI → Xuất bản	Landing
③ Shop	Thêm sản phẩm → cấu hình VietQR → chèn widget shop	Shop
④ Blog	Viết bài → bật CTA / chia sẻ → widget blog	Blog
⑤ Theo dõi	Telegram / email khi có đơn → menu Đơn hàng	Shop

Sau khi đăng nhập, vào Hệ thống → Cài đặt theo thứ tự tab:

Nhóm	Tab	Làm gì
Thiết lập cơ bản	Cài đặt chung	Trang chủ mặc định, ngôn ngữ UI Blog/Shop, Google Translate trên bài blog
	Thương hiệu	Tên, logo, favicon
	Phong cách giao diện	Theme site-wide (blog, shop, admin)
	SEO	Title, mô tả, OG image mặc định
Blog & Shop	Trang xem Blog	Hero, CTA cuối bài, số bài/trang
	Thiết lập Shop	Ngân hàng + STK → bật VietQR
	Thông báo đơn hàng	Telegram Bot + email admin
Hệ thống	Cơ sở dữ liệu	Backup / chuyển DB
	Cập nhật	Upload gói ZIP phiên bản mới
Nâng cao	Tài khoản Admin	Đổi mật khẩu, email
	API Agent	Tạo key aiw_…, dùng Kiểm tra kết nối — mục 10
	Code tùy chỉnh	Global CSS/JS, Analytics

Thao tác	Cách làm
Tạo	Trang web → Tạo trang mới — nhập tên, slug tự sinh
Nội dung	Dán full HTML (tab Sửa) hoặc sinh section bằng AI
Chỉnh trực quan	Tab Xem & Sửa: click chữ / link / ảnh để sửa → Lưu trang
Widget	Toolbar Blog / Shop — chèn khối động (mục 5)
Publish	Bật Publish → khách vào /{slug-trang}
SEO riêng	Editor → ⚙ Cài đặt trang → SEO / Schema / Code

Trong editor landing: nút Blog / Shop → chọn danh mục, số lượng → Chèn widget → Lưu trang.

Khu vực	Hướng dẫn
Soạn bài	Blog → Bài viết: TinyMCE, ảnh đại diện, danh mục, xuất bản
Trang /blog	Cài đặt → Trang xem Blog: hero, bài nổi bật, phân trang
Chi tiết bài	Mục lục tự động, thời gian đọc, bài liên quan
Chia sẻ	Facebook, Sao chép link, Chia sẻ app (mobile — Zalo, Messenger…)
Đa ngôn ngữ	Cài đặt chung: UI VI/EN + tùy chọn Google Translate trên bài
CTA cuối bài	Cài đặt → Blog → CTA cuối bài (Zalo, link shop…) — có preview

Bước	Chi tiết
Sản phẩm	Bán hàng → Sản phẩm: tên, giá, ảnh, slug, còn/hết hàng
Thanh toán	Cài đặt → Thiết lập Shop: ngân hàng, STK, chủ TK → QR sau khi đặt hàng
Chia sẻ SP	Trang chi tiết: Facebook, Copy link, Chia sẻ app (mobile)
Thông báo	Thông báo đơn hàng: @BotFather → Token + Chat ID → Gửi test
URL shop	/shop danh sách · /shop/{slug} chi tiết (/san-pham redirect 301)
Thêm đơn (mobile)	/order-quick — chủ shop tạo đơn nhanh; nút + trong trang Đơn hàng
Web App	Trên điện thoại: Add to Home Screen từ /shop hoặc /order-quick
Quản lý đơn	Đơn hàng (admin) hoặc link /order-access?token=... từ Telegram
Hóa đơn	/order-invoice?token=... — in / gửi khách

Menu sidebar Cài đặt đã sắp theo nhóm Thiết lập cơ bản → Blog & Shop → Hệ thống → Nâng cao. Tóm tắt mục hay bỏ sót:

• Trang chủ mặc định — bắt buộc nếu muốn domain trỏ vào landing (không phải trang quản lý)
• CTA blog — một cấu hình cho mọi bài; có preview trực tiếp trong form
• Cơ sở dữ liệu — backup vào data/backups/, đổi DB qua dropdown (mỗi DB có admin/API key riêng)
• API Agent — tạo key trên đúng site đang chạy, dán vào Kiểm tra API key trước khi cấu hình Cursor/Codex (chi tiết)
• Cập nhật — upload ZIP từ nhà phát hành, không sửa file tay trên production

URL	Mô tả
/blog	Danh sách blog
/blog/{slug}	Chi tiết bài
/shop	Danh sách sản phẩm (/san-pham redirect)
/shop/{slug}	Chi tiết + mua hàng
/{slug-landing}	Landing đã publish
/order-quick	Tạo đơn nhanh (mobile / chủ shop)
/order-access?token=…	Quản lý đơn qua link Telegram
/order-invoice?token=…	Hóa đơn in / gửi khách
/api/agent.php	API Agent (cần .htaccess rewrite — mục 10)
/aiweb_core/api/agent.php	API Agent (đường dẫn trực tiếp, luôn hoạt động nếu chưa có rewrite)
/sitemap.xml	Sitemap tự động

Menu admin: Trang web · Thư viện ảnh · Blog · Sản phẩm · Đơn hàng · Cài đặt · Hướng dẫn · Bản quyền

API Agent

Kết nối Cursor, Codex hoặc script tự động qua REST API. Endpoint chính: /api/agent.php (tương thích /api/migration.php). Auth: Authorization: Bearer aiw_… hoặc X-Api-Key: aiw_….

Bước	Thao tác
1. License	Site phải đã kích hoạt bản quyền trên đúng domain. Thiếu license → HTTP 403 JSON License required.
2. Tạo key	Cài đặt → API Agent → Tạo API key mới. Key aiw_… chỉ hiện một lần — copy ngay. Key lưu dạng hash trong DB; không thể copy key từ máy local sang production — phải tạo key mới trên server đích.
3. Kiểm tra	Tab API Agent → Kiểm tra API key: dán key, chọn agent.php hoặc migration.php, bấm Kiểm tra kết nối. Sau khi tạo key mới có nút Test key này. Công cụ kiểm tra DB + gọi HTTP thật tới ?action=status.
4. Cấu hình Agent	Đặt AIWEB_BASE trỏ tới thư mục aiweb_core của site (xem ví dụ bên dưới). Dùng key vừa tạo trên site đó.

URL endpoint:

• https://domain.com/api/agent.php — cần file .htaccess ở thư mục gốc có rule rewrite /api/* → aiweb_core/api/*
• https://domain.com/aiweb_core/api/agent.php — đường dẫn trực tiếp, luôn dùng được khi chưa deploy .htaccess mới

config.env (skill migrate / script):

Xử lý lỗi thường gặp:

Triệu chứng	Nguyên nhân & cách xử lý
HTML Trang không tồn tại (404)	Request /api/agent.php bị router landing nuốt. Upload .htaccess mới hoặc dùng /aiweb_core/api/agent.php và set AIWEB_BASE=…/aiweb_core.
HTTP 401 Unauthorized	Key sai, đã thu hồi/tắt, hoặc key thuộc DB/site khác. Tạo key mới trên admin site đích và test lại trong tab API Agent.
HTTP 403 License required	Chưa kích hoạt bản quyền trên domain đó. Vào Bản quyền → kích hoạt key license.
DB valid, HTTP lỗi	Thường do URL sai hoặc thiếu HTTPS. Xem URL thực tế trong kết quả Kiểm tra kết nối.

Shop qua Agent: list_orders, get_order, update_order_status, create_order (scope shop.read / shop.write). Xem đầy đủ action: GET ?action=list_actions.

Skill migrate (GitHub)

Repo riêng: github.com/slimsoftvietnam/aiweb_skill — clone → copy skill vào Cursor/Codex → cấu hình config.env với AIWEB_BASE trỏ …/aiweb_core và key tạo trên site production.

Cơ sở dữ liệu

Cấu hình AI

Trang Cấu hình AI: Gemini, OpenAI, Claude, Groq — cần API key để sinh section trong editor. Có thể dán HTML từ ChatGPT ngoài mà không dùng API trong app.

SEO & Sitemap

SEO từng landing ghi đè SEO global. /sitemap.xml + /robots.txt tự động. Global CSS/JS tại tab Code tùy chỉnh.

Bản quyền

• 1 key — 1 domain tại một thời điểm
• Chuyển domain: Bản quyền → Hủy kích hoạt trên site cũ → kích hoạt site mới
• API Agent / Migration chỉ chạy khi license đã kích hoạt trên domain đó