Nhúng widget của taomavach.online vào website, blog hoặc trang nội bộ của bạn chỉ cần hai dòng mã, với bất kỳ công cụ nào: một thẻ div chọn công cụ và một thẻ script tải embed.js. Widget hiện trong iframe tự co theo nội dung, chạy hoàn toàn trong trình duyệt người xem, miễn phí và không cần đăng ký; dòng ghi nhận “Công cụ bởi taomavach.online” ở cuối widget là điều kiện sử dụng duy nhất.
Mã nhúng
Dán đoạn sau vào nơi muốn hiện công cụ (trình soạn thảo HTML của WordPress, khối Custom HTML, hoặc mã nguồn trang). Thay code128 bằng id công cụ trong bảng dưới.
<div class="tmv-embed" data-tool="code128"></div>
<script src="https://taomavach.online/wp-content/plugins/taomavach-tools/assets/js/embed.js" async></script>Thẻ script chỉ cần một lần trên trang; có thể đặt nhiều div với data-tool khác nhau. Không muốn dùng script, chèn trực tiếp iframe tới https://taomavach.online/embed/code128/ với chiều cao cố định khoảng 700 px.
Id các công cụ
| Nhóm | Id (data-tool) |
|---|---|
| Mã 1D | code128, ean13, ean8, upca, upce, code39, code93, itf14, itf, codabar, msi, pharmacode, isbn, issn, gs1-128, databar, rare-1d |
| Mã 2D & GS1 | datamatrix, gs1-datamatrix, pdf417, aztec, gs1-digital-link, maxicode, micro-qr |
| Hàng loạt & in tem | batch, print-a4, print-roll, serial, tem-gia, tem-kho, tem-tai-san, gsheet, tem-hsd |
| Kiểm tra, tính, chuyển đổi | check-digit, validate, scan, gtin-structure, country, gtin-convert, upce-convert, isbn-convert, gs1-parser, sscc, gln, size, chooser, compare |
| Theo mục đích | san-pham, noi-bo, san-tmdt, thung-carton, the-ve |
Id trùng với phần cuối địa chỉ trang nhúng: mở công cụ trên taomavach.online, thay đường dẫn bằng /embed/<id>/ để xem trước, ví dụ /embed/ean13/.
Cách hoạt động và điều kiện
- Kỹ thuật: embed.js tạo iframe tới /embed/<id>/, trang nhúng gửi chiều cao bằng postMessage để iframe tự co; không cookie, không theo dõi, không lưu dữ liệu người xem (xem Chính sách bảo mật).
- Camera trong widget quét: chỉ chạy khi trang của bạn dùng https và iframe được cấp quyền camera (thuộc tính allow=”camera” do embed.js đặt sẵn).
- Điều kiện: giữ dòng “Công cụ bởi taomavach.online” và liên kết trong widget; không dùng widget để giả danh dịch vụ đăng ký mã vạch GS1.
- Cập nhật: widget luôn dùng phiên bản mới nhất của công cụ; thay đổi lớn được ghi tại Cập nhật.
- Giới hạn: trang nhúng đặt noindex nên không ảnh hưởng SEO trang của bạn; mỗi lần tải widget là một lượt tải trang tới taomavach.online, không giới hạn số lượt.
Câu hỏi thường gặp
Nhúng vào WordPress bằng cách nào?
Thêm khối Custom HTML (HTML tùy chỉnh) trong trình soạn thảo, dán hai dòng mã, cập nhật trang. Với trình soạn cổ điển, chuyển sang tab Văn bản rồi dán. Một số trình dựng trang chặn thẻ script trong nội dung; khi đó dùng widget HTML của trình dựng hoặc chèn iframe trực tiếp tới trang /embed/.
Có thể đổi màu, ẩn logo hay bỏ dòng ghi nhận không?
Widget dùng giao diện mặc định của taomavach.online, tự co theo bề rộng vùng chứa; hiện chưa có tùy chọn màu. Dòng “Công cụ bởi taomavach.online” là điều kiện sử dụng miễn phí nên không được ẩn. Cần giao diện riêng, hãy gửi yêu cầu qua trang Liên hệ.
Dữ liệu người dùng website của tôi có bị gửi đi không?
Không. Công cụ trong iframe chạy trong trình duyệt của người xem giống như trên taomavach.online: nội dung mã, tệp, ảnh, camera không rời thiết bị, không cookie theo dõi. Máy chủ chỉ ghi nhật ký kỹ thuật khi tải trang nhúng, tối đa 30 ngày.