Blog CMS
XenForo's Addons

[VNXF] Easy Portal

✍ Tuấn · 16/06/2026 13:50
[VNXF] Easy Portal

[VNXF] Easy Portal

Tiện ích mở rộng (Add-on) tạo trang Portal (Trang chủ) đơn giản, nhẹ nhàng và tối ưu cho diễn đàn XenForo 2.3.

🌟 Tính năng nổi bật

  • Quản lý bài viết đề cử (Promoted Threads):
    • Cho phép người điều hành (Moderator) đẩy bài viết lên trang chủ Portal (Promote to Easy Portal).
    • Hỗ trợ chọn/chỉnh sửa ngày giờ hiển thị bài viết đề cử (được sắp xếp theo thứ tự mới nhất).
    • Dễ dàng gỡ bài viết khỏi trang chủ Portal (Demote from Easy Portal).
  • Tùy chỉnh SEO & Cấu hình linh hoạt:
    • Tùy chỉnh tiêu đề trang Portal (Portal Title).
    • Thiết lập thẻ Meta Description cho trang Portal để tối ưu hóa SEO.
    • Tùy chỉnh số lượng bài viết hiển thị trên mỗi trang (Threads per page).
  • Giao diện tối ưu:
    • Trang Portal được ẩn header và breadcrumb mặc định của XenForo để tạo không gian rộng rãi, chuyên nghiệp giống như một trang tin tức thực thụ.
    • Thêm class CSS riêng biệt (vnxfEp-page) để dễ dàng tùy biến giao diện qua .less.
  • Hỗ trợ 5 vị trí Widget phong phú:
    • Easy Portal: Above (full width) (vnxf_ep_top): Nằm ngang toàn màn hình ở vị trí Breadcrumb Top (được chèn trước vị trí quảng cáo container_breadcrumb_top_above).
    • Easy Portal: Below (full width) (vnxf_ep_bottom): Nằm ngang toàn màn hình ở vị trí Breadcrumb Bottom (được chèn trước vị trí quảng cáo container_breadcrumb_bottom_above).
    • Easy Portal: Above content (vnxf_ep_content_top): Phía trên danh sách bài viết trang chủ.
    • Easy Portal: Below content (vnxf_ep_content_bottom): Phía dưới danh sách bài viết trang chủ.
    • Easy Portal: Sidebar (vnxf_ep_sidebar): Cột bên (Sidebar) của trang chủ Portal.

🛠️ Cấu trúc Add-on

  • Đường dẫn Route mặc định: /easy-portal/ (ví dụ: https://yourdomain.com/easy-portal/)
  • Database Table: xf_vnxf_ep_promoted (Lưu thông tin các bài viết được đề cử bao gồm thread_id, promote_date, và promote_user_id).
  • Developer Workflow: Đã xuất đầy đủ thư mục dữ liệu phát triển (_output), hỗ trợ đầy đủ các lệnh phát triển của XenForo:
    • php cmd.php xf-dev:import --addon VNXF/EasyPortal
    • php cmd.php xf-dev:export --addon VNXF/EasyPortal

🚀 Hướng dẫn cài đặt & Cấu hình

1. Cài đặt Add-on

  1. Tải và giải nén mã nguồn của add-on vào thư mục của diễn đàn tại: src/addons/VNXF/EasyPortal.
  2. Truy cập vào ACP > Add-ons tìm và nhấn nút Install cho [VNXF] Easy Portal.
    • Hoặc chạy lệnh sau qua terminal: <br/> ``bash <br/> php cmd.php xf:addon-install VNXF/EasyPortal <br/> ``

2. Thiết lập quyền hạn (Permissions)

  1. Truy cập ACP > Groups & permissions > User group permissions (chọn Nhóm Admin/Mod/SMC).
  2. Tìm đến phần [VNXF] Easy Portal và bật quyền:
    • Can promote / demote threads: Cho phép đề cử hoặc gỡ bài viết trên trang Portal.

3. Cấu hình Options

  1. Truy cập ACP > Setup > Options > VNXF Easy Portal.
  2. Thiết lập các giá trị sau:
    • Portal title: Tiêu đề hiển thị trên trang chủ Portal.
    • Portal meta description: Mô tả meta dùng cho SEO.
    • Threads per page: Số lượng bài viết hiển thị trên một trang (Mặc định là 20).

4. Thiết lập Widgets

  1. Truy cập ACP > Appearance > Widgets.
  2. Tạo mới hoặc di chuyển các Widget mong muốn hiển thị trên trang Portal vào một trong các vị trí sau:
    • Easy Portal: Above (full width)
    • Easy Portal: Below (full width)
    • Easy Portal: Above content
    • Easy Portal: Below content
    • Easy Portal: Sidebar

📝 Nhật ký cập nhật (Changelog)

Phiên bản 1.1.1

  • Tính năng mới: Chuyển đổi vị trí 2 widget ngoài (vnxf_ep_top và vnxf_ep_bottom) sang Breadcrumb Top & Bottom (được chèn chuẩn theo hệ thống quảng cáo ads breadcrumb của template PAGE_CONTAINER).
  • Developer tools: Xuất toàn bộ dữ liệu cấu hình ra thư mục _output phục vụ quá trình import/export qua dòng lệnh CLI của XenForo.
  • Tối ưu CSS: Đóng gói giao diện sạch sẽ và chuẩn hóa các lớp class CSS.

← Về trang chủ