Liên hệ

mh v1.6.0

Kết nối WordPress với storefront Next.js.

Biên tập viên vẫn sửa trang, sản phẩm, menu và SEO trong wp-admin. Storefront đọc tất cả qua một cổng REST, và tự làm mới đúng trang vừa đổi.

  • Một cổng REST cho trang, menu, sản phẩm, danh mục và SEO
  • Sửa trong wp-admin, storefront cập nhật sau vài giây
  • Mật khẩu của storefront chỉ dùng được cho cổng này

Tính năng

Dữ liệu đúng dạng storefront cần

Tên trường kiểu camelCase, ảnh kèm kích thước và chữ thay thế, link nội bộ là đường dẫn tương đối, giá là số nguyên VND. Storefront không phải đoán dạng dữ liệu.

Làm mới cache theo đúng trang

Lưu trang, sản phẩm, danh mục, menu hay redirect thì plugin gửi danh sách tag cần làm mới tới storefront. Giá và tồn kho đổi qua KiotViet hay Odoo cũng được báo.

Section khai báo trong code storefront

Danh sách field của từng section được đẩy từ code sang MONA Fields. Biên tập viên nhập nội dung trong wp-admin như mọi trang khác.

Mẫu bố cục cho sản phẩm và danh mục

Tạo mẫu "Mẫu bố cục", chọn mẫu mặc định, rồi gán mẫu riêng cho từng sản phẩm hoặc danh mục. Xem trước bằng sản phẩm thật, kể cả sản phẩm hết hàng.

Xem trước bản nháp trên storefront

Nút Xem trước trong wp-admin mở thẳng trang trên storefront, hiện đúng nội dung chưa lưu, kể cả các section.

Chạy nhanh trên kho hàng lớn

Danh sách sản phẩm đọc qua bảng tra cứu của MONA Ecommerce, đo trên kho 200.000 sản phẩm: một trang danh mục khoảng 55 ms, danh sách bán chạy dưới 5 ms.

Bắt đầu trong 3 bước

  1. Tài khoản máy cho storefront

    Tạo một tài khoản và một Application Password, cấp quyền đọc trong màn Kết nối, rồi khoá mật khẩu đó vào cổng của plugin.

  2. Địa chỉ storefront và hai secret

    Nhập địa chỉ storefront, tạo secret xoá cache và secret xem trước, rồi chép hai secret sang file .env của storefront.

  3. Đẩy field từ storefront

    Chạy lệnh đẩy field trong repo storefront. Trang Cài đặt storefront và khung section hiện ra trong wp-admin, sẵn để nhập nội dung.

Một lần sửa giá đi tới storefront

Bên trái là thứ storefront hỏi, bên phải là thứ plugin trả và thứ plugin báo lại khi biên tập viên sửa giá trong wp-admin.

mona-headless — demo

1Storefront hỏi, bằng Application Password của tài khoản máy

GET /wp-json/mona-headless/v1/product?slug=dieu-hoa-av12

{
  "id": 1201,
  "slug": "dieu-hoa-av12",
  "name": "Điều hoà AV12 Inverter",
  "image": { "id": 884, "url": "https://…/av12.webp",
             "width": 1200, "height": 1200, "alt": "Điều hoà AV12" },
  "category": "dieu-hoa",
  "price": 8490000,
  "regularPrice": 9990000,
  "inStock": true,
  "template": "product:deal"
}

2Biên tập viên đổi giá trong wp-admin, plugin báo lại

POST https://shop.example.com/api/revalidate
Authorization: Bearer ••••••••

{ "tags": [
    "product:slug:dieu-hoa-av12",
    "product:id:1201",
    "products",
    "cat:id:508", "categories"
] }

Storefront đánh dấu các trang mang những tag này là cũ. Khách vẫn thấy bản cũ cho tới khi bản mới dựng xong, nên trang không bao giờ trắng.

Trọn bộ tính năng

Mọi thứ trong danh sách dưới đây bật sẵn trên mọi website, không cần license và không giới hạn số site. Không có bản rút gọn, cũng không có bản cao hơn để mua thêm.

  • Cổng REST cho trang, menu, cài đặt, sản phẩm, danh mục, bài viết, SEO và redirect
  • Section và trang cài đặt lưu trong MONA Fields
  • Mẫu bố cục cho sản phẩm và danh mục
  • Làm mới cache storefront theo tag, có hàng đợi gửi lại
  • Xem trước bản nháp trên storefront
  • Application Password khoá vào cổng của plugin
  • Cập nhật và hỗ trợ trọn đời

Cần license bản quyền?

License MONA không mở thêm tính năng nào — nó là giấy tờ bản quyền đứng tên website của bạn, dùng khi hồ sơ dự án, hợp đồng bàn giao hoặc bên kiểm toán yêu cầu chứng minh nguồn gốc phần mềm. Cấp theo domain cho MONA Headless.

Câu hỏi thường gặp

Website có cần đổi theme hay chuyển dữ liệu không?

Không. Trang, sản phẩm, menu và SEO vẫn nằm trong WordPress như cũ. Storefront chỉ là một cách hiển thị khác, đọc dữ liệu qua cổng REST của plugin.

Cổng REST có mở cho người ngoài không?

Không. Mọi đường dẫn đều cần đăng nhập bằng Application Password của tài khoản có quyền đọc. Mật khẩu đã khoá chỉ gọi được cổng của plugin và của MONA Fields, gọi nơi khác trong REST API đều bị từ chối và ghi lại.

Storefront biết khi nào cần làm mới?

Khi một trang, sản phẩm, danh mục, menu, cài đặt hay redirect thay đổi, plugin gom các tag liên quan và gửi một lần tới địa chỉ làm mới cache của storefront. Gửi chưa được thì tag được giữ lại và gửi lại sau.

Có dùng được với đa ngôn ngữ không?

Bản này đọc một ngôn ngữ. Các đường dẫn đã nhận tham số ngôn ngữ và dùng MONA Multilingual khi có, phần storefront đa ngôn ngữ sẽ đi cùng bản sau.

Phiên bản & tải về

Gói cài đặt chính thức do MONA phát hành và ký số. Website đã cài plugin thì cập nhật thẳng trong trang quản trị — tải tệp ở đây khi cài lần đầu, hoặc khi website không gọi được ra ngoài để tự cập nhật.

bản mới nhất v1.8.0
Tải MONA Headless v1.8.0

mona-headless-1.8.0.zip · 247 KB

Tệp .zip cài thẳng vào WordPress, không cần giải nén. Bản này dùng được ngay và đủ tính năng, không cần License.

Cài lần đầu — 4 bước

  1. Tải tệp mona-headless-1.8.0.zip về máy.
  2. Vào trang quản trị website: Plugin → Cài mới → Tải plugin lên.
  3. Chọn tệp .zip vừa tải, bấm Cài đặt.
  4. Bấm Kích hoạt. Menu MONA Headless xuất hiện ở thanh bên trái.

Yêu cầu

WordPress
5.8 trở lên
PHP
7.4 trở lên
License
không cần, kể cả để dùng

Đã cài rồi thì cập nhật thế nào?

  1. Vào MONA Headless → thẻ License → Kiểm tra bản mới, rồi bấm Cập nhật ngay. Website tự tải và tự kiểm tra chữ ký của gói.
  2. Website không gọi được ra ngoài thì tải tệp bên cạnh, vào Plugin → Cài mới → Tải plugin lên và cài đè lên bản cũ.

Cài đè không mất dữ liệu và không phải kích hoạt lại gì. Dù vậy, hãy sao lưu trước khi thao tác trên website đang chạy.

Lịch sử cập nhật

Plugin được cập nhật định kỳ — tính năng mới, cải tiến và vá lỗi. Phiên bản hiện tại: v1.6.0.

12 phiên bản
Vui lòng luôn dùng phiên bản mới nhất Thông báo ngày 24/07/2026

Mỗi bản phát hành đều mang theo bản vá bảo mật, cải thiện hiệu năng và cập nhật tương thích với WordPress / PHP mới. Website còn chạy bản cũ có thể gặp lỗi hiển thị, xung đột với plugin khác hoặc rủi ro bảo mật đã được xử lý ở bản sau. MONA chỉ bảo hành và hỗ trợ kỹ thuật trên phiên bản mới nhất đang phát hành — hiện tại là v1.6.0.

Cập nhật ngay trong trang quản trị: MONA Headless → thẻ License → Kiểm tra bản mới, quá trình chỉ mất vài giây và không ảnh hưởng dữ liệu. Muốn tải tệp cài đặt về máy thì lấy ở mục Phiên bản & tải về ngay phía trên. Nếu website đang dùng bản cũ, đã tuỳ chỉnh sâu hoặc bạn gặp vướng mắc khi nâng cấp, hãy liên hệ đội kỹ thuật MONA hoặc gọi 1900 636 648 để được hỗ trợ trước khi thao tác.

  1. v1.6.0 Hiện tại 15/10/2026
    • Mới Màn hình Kết nối có ô Tên dự án; công cụ đồng bộ field của storefront đọc tên này để không ghi nhầm sang website của dự án khác.
    • Cải tiến Đọc và ghi được khối nội dung lồng nhiều tầng (hàng, cột, khối) theo MONA Fields 1.13.0.
  2. v1.5.2 12/10/2026
    • Mới Bài viết có mẫu trang riêng như sản phẩm: tạo và sửa mẫu “Bài viết” trong trình dựng, chọn mẫu cho từng bài ở ô Template.
    • Cải tiến Mỗi bài viết trả về mẫu đang dùng, danh sách mẫu đếm được số bài của từng mẫu, và đổi mẫu thì storefront cập nhật ngay.
  3. v1.5.1 12/10/2026
    • Mới Trình dựng chọn được form MONA Smart Form theo tên: gõ để lọc, chọn xong lưu đúng mã form. Cần MONA Smart Form đang bật.
    • Cải tiến Thêm bộ lọc mh_picker_kinds để khai báo thêm loại nội dung chỉ dùng để chọn, không cần mở thành trang công khai.
  4. v1.5.0 12/10/2026
    • Mới Bài viết trả về chuyên mục và thẻ kèm đường dẫn đúng thị trường; danh sách bài lọc được theo chuyên mục và thẻ, và có route liệt kê chuyên mục kèm số bài.
    • Mới Bài viết trả về tác giả thật: tên hiển thị, giới thiệu ngắn và ảnh chọn từ thư viện media ở trang hồ sơ, không dùng Gravatar và không lộ tên đăng nhập hay email; tắt được bằng tuỳ chọn showAuthor trong cài đặt chung.
    • Mới Gắn tối đa 6 sản phẩm vào một bài viết (có sẵn khi cài MONA Ecommerce); storefront nhận danh sách theo đúng thứ tự đã chọn, bỏ sản phẩm nháp hoặc đã xoá.
  5. v1.4.0 12/10/2026
    • Mới Thanh quản trị có sẵn nút Mở builder và Xem website ở mọi màn của wp-admin và khi xem website WordPress; ở màn sửa trang thì nút Mở builder mở đúng trang đó.
    • Mới Tuỳ chọn Vào builder sau khi đăng nhập ở màn Kết nối: người sửa đăng nhập xong được chuyển thẳng sang builder, nút Chỉnh sửa trên website hiện ngay.
    • Cải tiến Chuyển hướng khách sang storefront là chuyển hướng tạm, trình duyệt không giữ lại nên đăng nhập xong mở lại địa chỉ cũ vẫn vào đúng màn hình của người sửa.
  6. Xem thêm 7 phiên bản cũ hơn
    1. v1.3.0 12/10/2026
      • Mới Trang tìm kiếm công khai cho website không bán hàng: route /site-search tìm trong trang, bài viết và các loại nội dung riêng, theo đúng ngôn ngữ, bỏ qua trang đã đặt noindex, trả đường dẫn storefront và đoạn trích ngắn quanh từ khoá.
      • Cải tiến MONA Ecommerce trở thành tuỳ chọn: website giới thiệu không cài cửa hàng vẫn dùng đủ trang, menu, bài viết, loại nội dung, biểu mẫu và tài khoản thành viên; các route của cửa hàng báo rõ là chưa có thay vì lỗi.
      • Cải tiến Không tạo bảng tìm sản phẩm hay lịch chạy nền khi website không có cửa hàng.
      • Cải tiến Hộp Loại trang của mẫu bố cục giải thích rõ khi chưa có loại nào dùng được mẫu.
    2. v1.2.0 12/10/2026
      • Mới Biểu mẫu nhận tệp đính kèm từ storefront, gắn bài gửi với thành viên đang đăng nhập và với nội dung liên quan; thêm danh sách các bài đã gửi của chính thành viên đó.
      • Mới Tài khoản thành viên cho website không bán hàng: đăng ký (theo cài đặt của WordPress), đăng nhập, quên và đặt lại mật khẩu, xem và sửa hồ sơ; dùng chung tài khoản với phần cửa hàng khi có.
      • Cải tiến Đăng nhập thành viên giới hạn theo từng tài khoản và theo địa chỉ khách, không để một khách làm khoá cả website.
    3. v1.1.0 12/10/2026
      • Mới Mở các loại nội dung riêng của website (sự kiện, dự án, dịch vụ, đội ngũ…) cho storefront: chọn ngay trên màn Kết nối hoặc khai bằng code, có route /content kèm lọc theo phân loại, theo trường và sắp xếp theo ngày hay số.
      • Mới Mỗi loại nội dung có đường dẫn riêng trên storefront, tự vào sơ đồ trang, menu, chuyển hướng khi đổi đường dẫn và xoá cache đúng trang.
      • Mới Mẫu bố cục dùng được cho mọi loại nội dung, không chỉ sản phẩm.
      • Cải tiến Bảng đường dẫn của storefront có thể để trống hoặc chỉ gửi những khoá cần dùng, không còn cảnh báo thiếu; khoá trùng đường dẫn được báo rõ.
      • Cải tiến Ô chọn nội dung trong builder nhận cả các loại nội dung riêng.
    4. v1.0.3 11/10/2026
      • Mới Thêm route /posts/archive cho trang danh sách bài viết có phân trang và /post cho trang một bài viết, kèm nội dung, SEO và đường dẫn bản dịch.
      • Cải tiến Mục License luôn nằm cuối menu MONA Headless.
    5. v1.0.2 11/10/2026
      • Cải tiến Website không bán hàng dùng được MONA Headless mà không cần cài MONA Ecommerce: Bảng tin và màn Plugin không còn hiện cảnh báo, màn MONA Headless chỉ ghi một dòng cho biết phần cửa hàng chưa có trên storefront.
    6. v1.0.1 11/10/2026
      • Cải tiến Website khoá cài đặt plugin từ trang quản trị giờ thấy hộp Cập nhật chỉ hiện phiên bản đang chạy, kèm dòng cho biết phiên bản do đơn vị vận hành quản lý, thay vì nút bấm không dùng được. Plugin cũng thôi tự kiểm tra cập nhật nền trên những website này.
    7. v1.0.0 10/10/2026
      • Mới Cổng REST mona-headless/v1 cho trang, cây trang, menu, cài đặt storefront, sản phẩm, danh mục, bài viết, SEO và redirect.
      • Mới Mẫu bố cục cho sản phẩm và danh mục, có mẫu mặc định, thống kê số mục đang dùng và sản phẩm mẫu để xem trước.
      • Mới Gửi tag làm mới cache tới storefront khi nội dung, giá hoặc tồn kho thay đổi, có hàng đợi gửi lại.
      • Mới Nút Xem trước trong wp-admin mở bản nháp trên storefront.
      • Mới Màn Kết nối: địa chỉ storefront, secret, tài khoản máy và khoá Application Password vào cổng của plugin.
      • Mới Nút Thêm khối chỉ hiện các section hợp với loại trang: section của trang sản phẩm chỉ có trong mẫu bố cục sản phẩm, section danh sách chỉ có trong mẫu danh mục.
      • Mới Chế độ headless: link của trang, sản phẩm, bài viết và danh mục chuyển sang địa chỉ storefront, khách vào giao diện WordPress được chuyển thẳng tới trang tương ứng.
      • Mới Sitemap cho storefront theo từng loại nội dung, mỗi phần 5.000 đường dẫn, bỏ qua nội dung đặt noindex.
      • Mới Dữ liệu có cấu trúc (JSON-LD) của MONA SEO cho từng trang trên storefront.
      • Mới Ghi nhận trang 404 của storefront vào nhật ký 404 của MONA SEO.
      • Mới Tự chuyển hướng link cũ khi đổi đường dẫn sản phẩm hoặc bài viết.
      • Mới Tự làm mới storefront đúng giờ hẹn hiện hoặc ẩn của từng section.
      • Mới Nút "Làm mới trên storefront" trong danh sách và thanh quản trị, nút làm mới toàn bộ ở màn Kết nối.
      • Mới Gửi lệnh làm mới tới nhiều địa chỉ storefront cùng lúc, như bản chính và bản staging.
      • Cải tiến Cảnh báo trên Bảng tin khi storefront nhiều lần liền không nhận lệnh làm mới.
      • Mới Trang trạng thái kết nối cho storefront: phiên bản, chế độ, tình trạng làm mới.
      • Cải tiến Link trong email đơn hàng, trang cảm ơn và giỏ hàng trỏ về storefront khi bật chế độ headless.
      • Mới Nút "Mở builder" trên trang và mẫu bố cục, mở builder của storefront bằng chính tài khoản WordPress, mỗi phiên dùng được 8 giờ.
      • Mới Lưu thẳng từ builder vào WordPress: section của trang, mẫu bố cục và cài đặt chung. Mỗi lần lưu tạo một bản lưu ghi đúng người sửa.
      • Mới Tạo trang nháp từ builder, xuất bản ngay hoặc hẹn giờ xuất bản.
      • Mới Báo khi có người vừa lưu cùng trang để không ghi đè bản của người khác.
      • Mới Xem và khôi phục bản lưu cũ, tải ảnh lên thư viện, tìm sản phẩm theo tên hoặc SKU ngay từ builder.
      • Mới Mục "Phiên builder" ở màn Kết nối, có nút đăng xuất mọi phiên builder.
      • Cải tiến Biên tập viên dùng được builder; Cài đặt chung vẫn do quản trị viên lưu.
      • Mới Liên kết trong builder có công tắc "Mở tab mới", giữ đúng lựa chọn đã đặt trong trang quản trị và ngược lại.
      • Mới Trang sản phẩm trả về các lựa chọn như màu, cỡ cùng từng phiên bản kèm giá, tồn kho và ảnh riêng.
      • Mới Gợi ý tìm kiếm theo tên, mã SKU và danh mục ngay khi khách gõ, phản hồi nhanh trên kho hàng trăm nghìn sản phẩm.
      • Cải tiến Chỉ mục tên sản phẩm tự cập nhật khi lưu, ẩn hoặc xoá sản phẩm.
      • Mới Builder biết ai đang sửa cùng trang hoặc mẫu bố cục, và người mở builder cũng hiện là đang sửa trong trang quản trị.
      • Mới Thêm cổng mua hàng cho storefront: giỏ hàng, tính phí giao hàng theo địa chỉ, đặt hàng chống gửi trùng, theo dõi trạng thái đơn và tra cứu đơn.
      • Mới Khách đăng nhập, đăng ký, đặt lại mật khẩu, xác minh email, xem và huỷ đơn, mua lại, quản lý sổ địa chỉ ngay trên storefront.
      • Mới Danh sách yêu thích cho cả khách chưa đăng nhập, tự gộp vào tài khoản khi đăng nhập.
      • Mới Gửi đánh giá sản phẩm và biểu mẫu liên hệ MONA Smart Form từ storefront.
      • Mới Thêm "Secret IP khách" để giới hạn số lần thử theo từng khách thay vì theo máy chủ storefront.
      • Cải tiến Link trong email tài khoản và trang cảm ơn sau thanh toán dẫn thẳng về storefront.
      • Cải tiến Storefront tự làm mới sản phẩm khi có đánh giá mới được duyệt.
      • Mới Trả về các ô nhập riêng của phương thức thanh toán và danh sách kỳ hạn trả góp theo ngân hàng đã chọn.
      • Mới Hỗ trợ nhiều thị trường cho storefront: mỗi thị trường có ngôn ngữ, tiền tệ và đường dẫn riêng, đồng bộ từ mã nguồn storefront.
      • Mới Mọi API nhận tham số ngôn ngữ và tiền tệ; danh sách sản phẩm, danh mục, bài viết, sitemap và gợi ý tìm kiếm chỉ trả nội dung của ngôn ngữ đang xem.
      • Mới Trả liên kết các bản dịch (hreflang) cho trang, sản phẩm, danh mục và bài viết.
      • Mới Link trong email, trang cảm ơn và permalink tự đi đúng thị trường theo ngôn ngữ của đơn hàng hay bài viết.
      • Cải tiến Tự làm mới cache storefront theo từng ngôn ngữ; giá và tồn kho làm mới mọi bản dịch cùng lúc.
      • Cải tiến Cài đặt storefront đọc theo bản dịch của từng ngôn ngữ; builder mở đúng bản dịch đang sửa.

Giữ WordPress để biên tập, dùng Next.js để hiển thị.

MONA dựng storefront và cấu hình kết nối cho website của bạn, kiểm tra từng trang với dữ liệu thật rồi bàn giao.

plugin tiếp theo MONA Fields Custom field không cần code — API get_field() quen thuộc, lưu ở meta cùng tên.