Init Embed Posts – Stylish, Fast, Portable

Mô tả

Init Embed Posts cho phép bạn nhúng nội dung WordPress ra bên ngoài – với thẻ đẹp mắt, dữ liệu REST API theo thời gian thực, và không có rào cản.

Thay vì dùng iframe hoặc oEmbed cồng kềnh, plugin này cho bạn các đoạn mã <div> + <script> gọn gàng, tải bài viết hoặc sản phẩm động bằng REST API của WordPress. Được thiết kế vì tốc độ, phong cách, và toàn quyền kiểm soát – dùng JavaScript thuần và lưu đệm thông minh.

Thích làm việc trong Block Editor? Block Embed Button làm chính xác những gì shortcode [init_embed_code] làm – không cần shortcode nếu bạn muốn chèn trực quan, kèm bản xem trước trực tiếp ngay trong trình soạn thảo.

Đối với AI agent và công cụ tự động, dữ liệu nhúng (tiêu đề, đoạn trích, ảnh thu nhỏ, ảnh, và — với sản phẩm WooCommerce — giá) cũng được công khai dưới dạng ability Abilities API chỉ đọc (WordPress 6.9+), cùng dữ liệu dùng để dựng thẻ.

Plugin này là một phần của Init Plugin Suite — bộ sưu tập các công cụ WordPress tối giản, nhanh, và hướng tới lập trình viên.

Kho GitHub: https://github.com/brokensmile2103/init-embed-posts

Tính năng:

• Nhúng bất kỳ bài viết công khai hoặc sản phẩm WooCommerce nào
• Hoạt động ở mọi nơi: HTML thô, CMS, blog, landing page…
• Block Block Editor: “Embed Button”, tương đương với [init_embed_code], kèm bản xem trước trực tiếp trong trình soạn thảo
• Abilities API (WordPress 6.9+): ability chỉ đọc get-embed-data cho dữ liệu nhúng bài viết/sản phẩm, có thể phát hiện qua wp_get_abilities() và REST namespace wp-abilities/v1
• Bố cục thẻ đẹp mắt:
  • Tên site + favicon
  • Tiêu đề, đoạn trích, ngày (cho bài viết)
  • Ảnh đại diện, thư viện ảnh ngang (tùy chọn)
  • Tên sản phẩm, giá, giá khuyến mãi kèm gạch ngang
  • Nút kiểu “Thêm vào giỏ hàng” (tùy chọn)
  • Tự động chế độ tối, thích ứng với site nhúng
• Hiệu ứng khi di chuột và giao diện hiện đại
• Khung tải trong khi chờ dữ liệu
• Chỉ JS, không iframe, không jQuery, không phụ thuộc
• Tải chậm các thẻ nhúng khi chúng cuộn vào tầm nhìn
• Tự động phát hiện các mục nhúng được chèn động sau khi tải trang (AJAX/SPA)
• Giao diện modal để tạo mã nhúng cá nhân hóa
• Chuyển đổi <script> thông minh:
  • init-embed.js cho bài viết
  • init-embed-product.js cho sản phẩm Woo
• Thuộc tính nhúng:
  • data-theme="light|dark|auto" – buộc dùng hoặc tự động phát hiện theme
  • data-image, data-featured, data-cart – kiểm soát nội dung
• REST API được lưu đệm (1 năm, xác thực lại qua ETag khi bài viết/sản phẩm được cập nhật)
• Hiển thị khoảng giá cho sản phẩm biến thể WooCommerce
• Giới hạn ảnh thư viện và theme nhúng mặc định có thể cấu hình (trang Cài đặt)
• Filter dành cho lập trình viên để tùy chỉnh dữ liệu và HTML

Có gì mới trong Phiên bản 2.0.0

• Hỗ trợ Block Editor: block mới “Embed Button”, tương đương với shortcode [init_embed_code], kèm bản xem trước trực tiếp trong trình soạn thảo — tùy chọn, shortcode vẫn hoạt động chính xác như trước
• Hỗ trợ Abilities API (WordPress 6.9+): ability chỉ đọc mới init-embed-posts/get-embed-data cho dữ liệu nhúng bài viết/sản phẩm — tùy chọn và hoàn toàn tương thích ngược trên các phiên bản WordPress cũ hơn
• Requires at least được nâng từ 5.5 lên 6.9 để hỗ trợ Abilities API. Requires PHP vẫn giữ nguyên 7.4

Xem chi tiết đầy đủ trong nhật ký thay đổi bên dưới.

Abilities API (WordPress 6.9+)

Trên WordPress 6.9 trở lên, Init Embed Posts đăng ký một ability chỉ đọc trong danh mục init-embed-posts:

• init-embed-posts/get-embed-data — trả về dữ liệu nhúng (tiêu đề, đoạn trích, ảnh thu nhỏ, ảnh, và — với sản phẩm WooCommerce — giá) cho một bài viết hoặc sản phẩm đã xuất bản, với một id và type (post hoặc product) cho trước

Ability này có thể được phát hiện và thực thi qua PHP (wp_get_abilities()), và — với các site chọn công khai nó — qua REST namespace wp-abilities/v1, dùng chính xác dữ liệu như các endpoint REST bên dưới. Tích hợp này hoàn toàn tùy chọn: trên các phiên bản WordPress cũ hơn 6.9, nó sẽ không làm gì cả và phần còn lại của plugin không bị ảnh hưởng.

Filter dành cho lập trình viên

Các filter này cho bạn toàn quyền kiểm soát cách dữ liệu được hiển thị và trả về.

Ghi đè cấu hình JS (ưu tiên cao nhất):

• window.InitPluginSuiteEmbedPostsConfig
  Đặt đối tượng này trước khi trang hiển thị (ví dụ qua wp_add_inline_script trong theme) để ghi đè cài đặt giao diện nhúng trong JS, ưu tiên hơn trang Cài đặt của plugin. Hiện hỗ trợ:

  • theme – "light", "dark", hoặc "auto". Ghi đè cài đặt “Theme nhúng mặc định” cho nút/modal tạo mã nhúng.

  Ví dụ:
  window.InitPluginSuiteEmbedPostsConfig = { theme: ‘dark’ };

Filter phản hồi REST:

• init_plugin_suite_embed_posts_rest_response
  Chỉnh sửa phản hồi REST API cho bài viết.

• init_plugin_suite_embed_products_rest_response
  Chỉnh sửa phản hồi REST API cho sản phẩm Woo.

• init_plugin_suite_embed_posts_view_count_keys
  Tùy chỉnh danh sách meta key bài viết dùng để phát hiện lượt xem. Hỗ trợ mảng meta key, sắp xếp theo mức ưu tiên.

• init_plugin_suite_embed_posts_gallery_limit
  Ghi đè giới hạn ảnh thư viện (mặc định theo giá trị trang cài đặt, 1–10) dùng cho cả nhúng bài viết lẫn sản phẩm.

Filter đoạn trích:

• init_plugin_suite_embed_posts_excerpt
  Tùy chỉnh đoạn trích cho bài viết.

• init_plugin_suite_embed_products_excerpt
  Tùy chỉnh đoạn trích cho sản phẩm.

Kiểm soát ảnh:

• init_plugin_suite_embed_posts_images
  Lọc danh sách ảnh cho bài viết được nhúng.

• init_plugin_suite_embed_products_images
  Lọc danh sách ảnh cho sản phẩm được nhúng.

• init_plugin_suite_embed_posts_extracted_images
  Lọc các URL ảnh thô được trích xuất từ nội dung bài viết.

Favicon:

• init_plugin_suite_embed_posts_favicon_url
  Ghi đè favicon cho bài viết.

• init_plugin_suite_embed_products_favicon_url
  Ghi đè favicon cho sản phẩm.

Filter kết quả xuất HTML:

• init_plugin_suite_embed_posts_shortcode_html
  Tùy chỉnh kết quả xuất HTML của shortcode [init_embed_code]. Cho phép toàn quyền kiểm soát mã đánh dấu nút, kiểu dáng, và thuộc tính.

Vị trí tự động chèn:

• init_embed_insert_locations
  Tùy chỉnh hoặc lọc các vị trí tự động chèn hợp lệ (ví dụ: sau tiêu đề, trước nội dung, v.v.).

Giấy phép

Plugin này được cấp phép theo GPLv2 hoặc phiên bản mới hơn.
Bạn có toàn quyền sử dụng, chỉnh sửa, và phân phối lại theo cùng giấy phép.