10 — Cấu hình Website Settings 🛡️
10 — Cấu hình Website Settings 🛡️
Phần này chỉ dành cho Website Manager / System Manager. Content Editor sẽ không thấy trang này trong Desk.
Trang /app/website-settings chứa các cấu hình chung: brand, navbar, footer, SEO,
Analytics, reCAPTCHA. Các trường tuỳ biến riêng cho Mantis Tech có prefix mt_*.
1. Brand & Identity (phần chuẩn của Frappe)
- Brand HTML — logo + tên brand hiển thị ở navbar. Khuyến nghị để SVG logo inline.
- Favicon — file
.svghoặc.ico. Dùng logo vuông bo tròn. - Splash Image — ảnh loading. Có thể dùng luôn logo chính.
App Mantis Tech đã set sẵn:
favicon=/assets/mantistech_web/images/favicon.svgbrand_name= "Mantis Tech"brand_color=#DB0000
2. Navbar
- Top Bar Items — bảng các mục menu. Mỗi dòng:
- Label — tên hiển thị.
- URL — đường dẫn (nội bộ:
/solutions; ngoại bộ:https://...). - Parent — để trống cho menu cấp 1; điền
Labelcủa menu cha để tạo submenu dropdown. - Right Item — tick để căn phải (dùng cho CTA "Request Demo").
Mantis Tech mặc định có: Home · About · Solutions (dropdown 4 trụ cột) · Products · Services · Blog · Contact · Request Demo (CTA phải).
3. Footer
- Footer Items — bảng tương tự Top Bar Items, nhưng có thêm Column để chia cột (Company / Solutions / Resources / Contact).
- Footer Address — địa chỉ văn phòng hiển thị cuối footer.
- Footer Powered — dòng "© Mantis Tech 2026" (có thể đổi).
- Hide Footer Signup — tick để ẩn form đăng ký newsletter mặc định nếu không dùng.
4. Section "Mantis Tech Analytics" (tuỳ biến của app)
Section collapsible này xuất hiện ngay sau trường google_analytics_id mặc định.
| Field | Ý nghĩa |
|---|---|
Google Analytics 4 Measurement ID (mt_ga4_measurement_id) |
ID dạng G-XXXXXXXXXX từ GA4 console. Dán vào để toàn site bắn event page_view. |
Google Tag Manager Container ID (mt_gtm_container_id) |
ID dạng GTM-XXXXXXX. Dán để nạp GTM snippet. |
reCAPTCHA v3 Site Key (mt_recaptcha_site_key) |
Public key Google reCAPTCHA v3. Secret key phải được dev đặt trong site_config.json key recaptcha_secret_key — không phải ở đây. |
Lead Notification Email (mt_lead_notification_email) |
Email (có thể nhiều, phân tách dấu ,) nhận thông báo khi có Lead mới. Mặc định contact@mantistech.vn. |
Enable Lead Form Rate Limit (mt_enable_lead_rate_limit) |
Tick để bật rate limit 5 submit/phút/IP (mặc định BẬT). Chỉ tắt khi chạy test. |
4.1. Cấu hình GA4 lần đầu
- Vào Google Analytics 4 → Admin → Data Streams → Web.
- Copy Measurement ID
G-XXXXXXXXXX. - Dán vào Google Analytics 4 Measurement ID → Save.
- Mở site ở tab ẩn danh, truy cập 1 trang → vào GA4 Real-time để xác nhận có session.
4.2. Cấu hình GTM
- Có thể dùng thay cho (hoặc song song với) GA4.
- Dán GTM container ID → Save.
- Kiểm tra bằng Tag Assistant.
4.3. Cấu hình reCAPTCHA v3
- Vào Google reCAPTCHA Admin → tạo key v3.
- Copy Site Key → dán vào trường trong Website Settings → Save.
- Copy Secret Key → gửi cho dev để đặt vào
site_config.json:{ "recaptcha_secret_key": "6Lxxxxxxxxxxxxxxxxxxxxx" } - Kiểm tra: gửi thử 1 form
/contact→ phải có Lead mới; điểm reCAPTCHA hiển thị ở/app/error-lognếu bị từ chối.
5. SEO & Social (phần chuẩn của Frappe)
- Default Meta Title / Description — fallback cho trang không override.
- Open Graph Image — fallback khi trang không có OG image riêng.
- Social Links (child table) — Facebook, LinkedIn, YouTube, Zalo… Xuất hiện ở footer.
6. Sau khi đổi Website Settings
Phần navbar/footer/brand thường cập nhật ngay sau 1–2 refresh. Nếu không, chạy:
bench --site <site> clear-website-cachehoặc nhờ dev (xem 12 — Troubleshooting).
GA4/GTM được inject ở cả template
mantis_base.html— cần Hard Refresh (Ctrl+Shift+R) ở trình duyệt để tải lại JS.