SOQVER Chuẩn bị nguồn
Tiếng Việt

SO4AG Facts cho WordPress

Plugin miễn phí giúp quý vị công bố thông tin doanh nghiệp ngay trên website của mình để trợ lý AI và các chương trình khác hiểu đúng nội dung áp dụng, đối tượng áp dụng và thời hạn hiệu lực. Thông tin bao gồm giá, giờ hoạt động, thanh toán, giao hàng, hủy và bảo hành.

Tải xuống plugin (ZIP, phiên bản 0.1.0) Đọc hướng dẫn

Miễn phí, không cần tài khoản, không có tính năng trả phí. Tương thích với WooCommerce. Yêu cầu WordPress 6.4 trở lên và PHP 7.4 trở lên. Giấy phép GPL-2.0-or-later.

Plugin bổ sung gì cho website của quý vị

Tệp dành cho chương trình

https://your-site.com/so4ag.json

Mọi thông tin đều ở định dạng mở SO4AG. Bất kỳ ai cũng có thể đọc mà không cần khóa truy cập hay đăng ký.

Trang dành cho người đọc

Bảng "Thông tin và điều khoản" có thể đặt trên bất kỳ trang nào, hiển thị từng mục thông tin, giá trị, đối tượng áp dụng và thời hạn hiệu lực.

Thêm bằng một khối hoặc mã ngắn [so4ag_facts].

Dữ liệu có cấu trúc

Các thông tin đó cũng được đưa vào mã của trang dưới dạng JSON-LD (schema.org) để công cụ tìm kiếm và các công cụ đã hỗ trợ JSON-LD có thể đọc.

Cách thức hoạt động

1. Quý vị nhập dữ kiện

Thao tác trong phần quản trị WordPress. Với WooCommerce, quý vị chỉ cần nhấn một nút để bắt đầu. Plugin đề xuất phí giao hàng và phương thức thanh toán dựa trên cài đặt của cửa hàng.

2. Quý vị xác nhận dữ kiện

Không có nội dung nào tự động được công khai. Quý vị phải xác nhận rõ ràng rằng thông tin là chính xác trước khi công bố.

3. Dữ kiện được công khai dưới ba hình thức

Tệp, trang và JSON-LD luôn hiển thị cùng một phiên bản đã được xác nhận gần nhất. Các chỉnh sửa chưa hoàn tất vẫn được giữ riêng tư.

4. Plugin theo dõi thời hạn

Mỗi mục thông tin đều có ngày cuối cùng còn hiệu lực. Hai tuần trước ngày đó, phần quản trị sẽ nhắc quý vị xem lại và xác nhận lại.

Mỗi mục thông tin gồm những gì

Hướng dẫn từng bước

Tên các thẻ và nút dưới đây được ghi đúng như hiển thị trong plugin.

Mục lục: 1. Cài đặt · 2. Doanh nghiệp của quý vị · 3. Thêm dữ kiện · 4. Điều kiện · 5. WooCommerce · 6. Công bố · 7. Trang dữ kiện · 8. Kiểm tra · 9. Duy trì dữ kiện cập nhật · 10. llms.txt · 11. Khắc phục sự cố

1. Cài đặt plugin

  1. Tải tệp ZIP từ trang này. Trong phần quản trị WordPress, mở Plugins → Add New → Upload Plugin, chọn tệp vừa tải xuống rồi chọn Install Now.
  2. Chọn Activate. Mục mới SO4AG Facts sẽ xuất hiện trong menu quản trị.

2. Giới thiệu doanh nghiệp của quý vị

Trong thẻ Business, kiểm tra tên doanh nghiệp, chọn loại hình doanh nghiệp và thêm mã định danh đăng ký nếu muốn (gồm hệ thống định danh và giá trị, ví dụ ein và mã EIN của quý vị, hoặc vat và mã số VAT). Quý vị có thể để trống thông tin liên hệ để yêu cầu chỉnh sửa. Nếu cung cấp, thông tin liên hệ này sẽ được công khai.

3. Thêm thông tin của quý vị

Trong thẻ Facts, chọn loại thông tin rồi chọn Add. Với mỗi mục, quý vị cần điền bốn phần sau:

  1. Giá trị, hoặc We do not state this, hoặc It does not apply to us.
  2. Điều kiện (Applies to). Chỉ điền các điều kiện thực sự ảnh hưởng đến thông tin.
  3. Ngày cuối cùng còn hiệu lực (Applies until).
  4. Trang trên website có nêu thông tin đó (Page that states it). Nếu quý vị để trống, thông tin sẽ được công bố dưới dạng tuyên bố của chính quý vị.
Thông tinNơi tìm thông tinĐiều kiện bắt buộcTối đa
Đơn vị vận hànhchân trang, điều khoản–400 ngày
Địa điểmtrang liên hệ: địa chỉ và giờ hoạt động–180 ngày
Liên hệtrang liên hệchannel180 ngày
Giábảng giáitem60 ngày
Phương thức thanh toánđiều khoản, trang thanh toán–180 ngày
Yêu cầu đặt trước, Thời gian phản hồitrang đặt trước, trang liên hệ–90 ngày
Hủy miễn phí, Phí hủychính sách hủy–90 ngày
Bảo hànhchính sách bảo hành–180 ngày
Tiếp nhận khách hàng mớitrang liên hệ–30 ngày
Phí giao hàngtrang thông tin giao hàngcountry, delivery_method60 ngày
Miễn phí giao hàng cho đơn từ, Phí thanh toán khi nhận hàngtrang thông tin giao hàngcountry / –60 ngày
Thời hạn trả hàng, Thời hạn bảo hànhchính sách trả hàng, điều khoản–180 ngày

Tiện ích cung cấp 25 mục thông tin cho mọi doanh nghiệp và 10 mục cho cửa hàng trực tuyến. "Lâu nhất" là thời hạn tối đa có thể xác nhận cho mỗi mục thông tin trong một lần. Tiện ích không chấp nhận ngày muộn hơn giới hạn này.

4. Cách sử dụng điều kiện

5. Cửa hàng sử dụng WooCommerce

Nút Suggest from the shop đọc cài đặt cửa hàng của quý vị và chuẩn bị các đề xuất sau:

Với mỗi đề xuất, quý vị có thể Accept, Complete hoặc Dismiss. Các đề xuất không được công khai. Plugin sẽ ghi chú những nội dung không đọc được từ phần cài đặt, như giá tính theo công thức, miễn phí vận chuyển chỉ khi dùng mã ưu đãi hoặc đơn vị vận chuyển do plugin khác cung cấp.

6. Xác nhận và công bố

Thẻ Confirm and publish hiển thị nội dung sẽ được công khai và các thay đổi kể từ lần trước. Đánh dấu ô xác nhận rằng các dữ kiện chính xác tại thời điểm hôm nay rồi chọn Confirm and publish. Sau đó, mọi chỉnh sửa sẽ được giữ riêng tư cho đến khi quý vị xác nhận lại.

Để gỡ dữ kiện khỏi chế độ công khai, hãy dùng Withdraw trên cùng thẻ. Các dữ kiện quý vị đang soạn vẫn được lưu.

7. Hiển thị thông tin trên một trang

Trên thẻ Output and check, chọn Create a draft page "Facts and terms", xem lại trang, xuất bản rồi thêm liên kết đến trang đó ở chân trang. Để đưa dữ kiện lên trang của riêng quý vị, hãy thêm khối Facts and terms hoặc shortcode sau:

[so4ag_facts]
[so4ag_facts heading="no"]
[so4ag_facts level="h3"]

Plugin không thêm liên kết hay huy hiệu vào trang web của quý vị và không thay đổi nội dung do các plugin khác tạo ra. JSON-LD chỉ xuất hiện trên các trang quý vị đặt dữ kiện.

8. Kiểm tra kết quả

  1. Trên thẻ Output and check, chọn Check the public addresses too. Công cụ sẽ kiểm tra cấu trúc tệp, các mốc ngày và đối chiếu để bảo đảm trang và tệp chứa cùng các dữ kiện.
  2. Mở địa chỉ tệp trong trình duyệt: https://your-site.com/so4ag.json
  3. Để kiểm tra thêm, hãy dán địa chỉ đó vào công cụ xác thực công khai.

9. Duy trì thông tin cập nhật

Khi hết hạn, mục thông tin vẫn nằm trong tệp. Các chương trình coi đó là dữ liệu lịch sử và mục này được đánh dấu trong bảng. Giao diện quản trị sẽ cảnh báo quý vị trước 14 ngày. Lịch cập nhật phù hợp:

10. llms.txt

Plugin có thể trả về một tệp ngắn tại /llms.txt để chỉ đến các dữ kiện của quý vị. Tính năng này mặc định tắt và có thể bật tại thẻ Output and check. Nếu trang web của quý vị đã có llms.txt, plugin sẽ giữ nguyên tệp đó và hiển thị các dòng quý vị có thể tự thêm.

11. Khắc phục sự cố

Hiện tượngCách xử lý
/so4ag.json trả về “không tìm thấy”Máy chủ web chưa chuyển yêu cầu đến địa chỉ đó cho WordPress. Hãy bật đường dẫn tĩnh thân thiện (Settings → Permalinks) hoặc yêu cầu nhà cung cấp dịch vụ lưu trữ chuyển các yêu cầu truy cập tệp không tồn tại cho WordPress. Trong thời gian đó, quý vị vẫn có thể dùng địa chỉ /?so4ag_facts=json.
Kết quả kiểm tra báo dữ kiện trên trang khác với dữ kiện trong tệpBộ nhớ đệm đang lưu bản cũ của trang. Hãy xóa bộ nhớ đệm rồi kiểm tra lại.
Trang không có JSON-LDTrang thiếu cả khối lẫn shortcode, hoặc giao diện không gọi wp_footer().
Plugin không chấp nhận ngày đã chọnMỗi loại dữ kiện có thời hạn xác nhận tối đa. Hãy chọn ngày sớm hơn và xác nhận lại sau.
Trang web chạy qua httpMáy chủ vẫn cung cấp tệp, nhưng các chương trình cần truy cập tệp qua https.

Những việc plugin không thực hiện

Dành cho nhà phát triển và đơn vị cung cấp dịch vụ

Quý vị xây dựng hoặc bảo trì trang web cho khách hàng? Quý vị tự tính phí cho việc thiết lập dữ kiện. Vì dữ kiện có thời hạn hiệu lực, cần có người rà soát định kỳ. Nếu khách hàng đăng ký thêm tính năng giám sát của SOQVER, chương trình đối tác sẽ chia cho quý vị một phần phí đăng ký. Tài khoản và dữ kiện thuộc về khách hàng.

Chương trình đối tác Định dạng và công cụ dành cho nhà phát triển

Mã nguồn của plugin nằm trong gói cài đặt và được cấp phép theo GPL-2.0-or-later. SO4AG là định dạng mở đang ở giai đoạn dự thảo. Đặc tả, công cụ xác thực và các trình đọc đều miễn phí. Đặc tả · GitHub

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

Tôi có cần tài khoản hoặc dịch vụ trả phí không?

Không. Quý vị chỉ cần plugin để nhập và công bố dữ kiện, tạo tệp, trang và JSON-LD, cũng như chạy kiểm tra.

Plugin này có tương thích với plugin SEO của tôi không?

Có. Plugin không can thiệp vào nội dung do các plugin khác tạo ra. Plugin chỉ thêm khối JSON-LD riêng vào các trang quý vị đặt dữ kiện.

Điều gì xảy ra khi dữ kiện hết hiệu lực?

Dữ kiện vẫn nằm trong tệp, nhưng các chương trình sẽ coi đó là dữ kiện lịch sử và bảng sẽ đánh dấu là hết hiệu lực. Hãy rà soát dữ kiện, đặt ngày mới rồi xác nhận lại.

Những gì sẽ bị xóa khi tôi xóa plugin?

Cài đặt của plugin, các dữ kiện đang soạn và phiên bản đã công bố. Các trang quý vị đã tạo vẫn còn, nhưng bảng dữ kiện sẽ biến mất.

Tải xuống plugin (ZIP, phiên bản 0.1.0)