
外掛標籤
開發者團隊
② 後台搜尋「ProofPass – Safety Data Sheets (SDS) & GPSR Info」→ 直接安裝(推薦)
原文外掛簡介
This plugin puts the safety data sheet (SDS, often still searched as MSDS) of each product where your customers look for it: on the WooCommerce product page, in the order email and on any WordPress page. The same goes for technical data sheets (TDS), declarations of performance, EU declarations of conformity and other product documents, and for the manufacturer and safety information that belongs to a product.
The documents come from ProofPass, a data sheet portal for manufacturers and dealers. You upload a PDF there once. ProofPass keeps every version, creates a QR code per product and delivers new versions to your customers with proof of delivery. The plugin links the current version each time, so no outdated PDF stays behind in your media library.
What you need
A ProofPass account. The Basis plan is free; the link “Create a free ProofPass account” is on the settings page.
Without an API key: the document list of a product, the document search and the product passport appear as the official ProofPass embed. That works in every plan, including Basis, and so does the WooCommerce catalogue scan with a scan key.
With an API key (ProofPass plans from Start): the documents are rendered in your theme as real links, readable for search engines and screen readers. The QR code, the single document button, the documents for your quote, the Proposition 65 warning, the email updates link and the document links in order emails need the key as well.
The optional order report needs a key with write permission (plans from Start) and the data processing agreement concluded in ProofPass.
WooCommerce is optional. Easy Digital Downloads, SureCart, BigCommerce for WordPress and WP EasyCart are set up automatically, any other shop by its product post type. Blocks, shortcodes, the widget and page builder elements work on any WordPress site.
Safety data sheets and other documents of a product
Document list of one product: type, language, revision date, version and PDF link. Safety data sheets for the USA (OSHA HazCom) show their emergency phone number.
Single document button, for example “Safety data sheet (PDF)”, in the language of the page if it exists.
Document search of the whole catalogue by product name, article number or GTIN: a search form that works without JavaScript, results with their documents, pagination.
Documents for your quote: the documents of several products or of the cart, with a button to your own quote page.
Updates by email: a link to the subscription on ProofPass (double opt-in).
GPSR: manufacturer, responsible person, safety information
Below the documents the plugin shows the manufacturer with postal address and electronic address, the responsible person in the EU, the warnings and safety information of the product, and an active recall notice. These are the details the General Product Safety Regulation (GPSR) names for online offers. The plugin prints what you maintain in ProofPass; it does not check your offer and does not make a shop compliant.
Product passport and QR code
Product passport: identifiers (article number, GTIN, UFI, brand, model, batch, CE marking), documents, manufacturer, safety information and QR code on one page.
QR code of a product, linking to its documents on ProofPass.
Proposition 65
For products sold to California the plugin shows the Proposition 65 (Prop 65) warning exactly as the manufacturer stored it: above the add-to-cart button and with the item in cart and checkout (classic and block checkout), or anywhere as an element.
WooCommerce
Placement on the product page: own tab, collapsible section or open list in the summary, or below the add-to-cart button.
Mapping, first hit wins: the field “ProofPass product” (tab “ProofPass” in the product data), the GTIN or EAN (WooCommerce field, Germanized, Google for WooCommerce, CTX Feed, EAN for WooCommerce, WP-Lister, Yoast WooCommerce SEO, a product attribute or a meta key you name), the SKU as article number, the manufacturer part number. Variations can have their own documents; the list switches when a variation is chosen. A variable or grouped product without its own match shows the documents of its children.
Links to the documents of the bought products in the customer’s order emails and on the order-received page.
Catalogue scan (WooCommerce → ProofPass): which products are in ProofPass and which documents are missing, with a column and a filter “ProofPass” in the product list, a mapping screen with suggestions by name, and a hint when the catalogue is larger than your plan.
Optional order report (off by default): paid orders go to ProofPass in the background; ProofPass sends professional buyers the current safety data sheets and records the delivery. You decide who counts as professional: company name, VAT ID or customer role.
Compatible with High-Performance Order Storage, block themes and the cart and checkout blocks. Translated products (WPML, Polylang) use the identifiers of their original; the page language also comes from Weglot and TranslatePress.
Other shop systems
Easy Digital Downloads, SureCart, BigCommerce for WordPress and WP EasyCart: the plugin finds the ProofPass product by the GTIN (BigCommerce’s own field, or a custom field you name), then by the article number (SKU) of the shop product, and shows its documents on the product page.
Any other shop that keeps its products as a custom post type: choose the post type and the custom fields with article number and GTIN under Settings → ProofPass.
The catalogue scan covers these products as well (Tools → ProofPass; with WooCommerce active it stays under WooCommerce → ProofPass). Order emails and the order report are WooCommerce only.
Block editor, page builders, shortcodes
Block editor: block “ProofPass” with a variation per element, product search against your ProofPass catalogue and a live preview.
Elementor: eight widgets in the category “ProofPass”.
Beaver Builder: module “ProofPass”.
SiteOrigin Page Builder and classic themes: widget “ProofPass” for sidebars, footers and widget areas.
Bricks: element “ProofPass”. Divi and WPBakery: element “ProofPass” (see FAQ: these three are written against their documented APIs, not tested without a licence). In every builder the shortcodes work as well.
Shortcodes, with a generator button in the classic editor: [proofpass_documents], [proofpass_catalog], [proofpass_qr], [proofpass_document], [proofpass_passport], [proofpass_quote], [proofpass_prop65], [proofpass_updates]. [proofpass] works as in version 1.
All of them render through one core on the server, so the output is the same everywhere.
Built with care
The API key stays on your server; it is never printed in HTML or passed to JavaScript.
Stale-while-revalidate cache: answers are kept for 6 hours (adjustable), then served while a background job asks ProofPass again. A page view makes at most one request to ProofPass. “Clear cache” button and wp proofpass cache flush.
No JavaScript on the front end, except a few lines on variable products whose variations have their own documents, and the optional Proposition 65 region check. The stylesheet loads only where an element renders. Logical CSS properties, so right-to-left languages work.
Accessible markup: table captions, labelled links and form fields, a search landmark, page navigation with aria-current.
Document language follows the page language (WPML and Polylang included) and falls back to the other languages.
WP-CLI: wp proofpass status, wp proofpass scan, wp proofpass map, wp proofpass cache flush.
Site Health test (connection, key permission, data processing agreement for order reports) and a suggested text for your privacy policy.
No tracking, no cookies. One admin notice while the plugin is not set up, on the dashboard and the plugins screen only, dismissible.
The line “Provided via ProofPass” is off unless you switch it on. The plans Basis and Start include it; to render the documents in your theme in those plans you agree to show it, otherwise the plugin uses the ProofPass embed, which shows it itself.
External services
This plugin connects to ProofPass, a service of EA Digital Solutions e.U., Liebenauer Hauptstraße 41, 8041 Graz, Austria. It cannot show anything without it.
Every request from your server (1 to 3 below, and the connection test) also carries the host name of your site and the major versions of WordPress, WooCommerce and PHP (headers X-ProofPass-Site and X-ProofPass-Env), so ProofPass can count the installations in use and keep them compatible.
1. ProofPass API (your server, with an API key)
What it is for: reads the current documents and manufacturer information of products, the product search of the catalogue and the plan of your account (to explain what the plugin can do).
What is sent: your API key (HTTP header Authorization: Bearer …), the product identifiers being looked up (GTIN, article number/SKU, ProofPass product ID, slug or short code) and search words. Your server’s IP address is visible to ProofPass. No visitor data is sent.
When: when a page with a ProofPass element is viewed and the cache has no fresh answer (at most once per page view; the rest in the background), when an editor searches for a product, and when you click “Test connection”.
Address: https://www.proofpass.eu/api/v1.
2. ProofPass order report (your server, only when switched on)
What it is for: ProofPass sends the buyer of a paid order the current safety data sheets of the ordered products and records the delivery; professional buyers are added to the manufacturer’s distribution list in ProofPass.
What is sent: your write key, the order number, the identifiers of the ordered products, whether the buyer counts as professional, and the buyer’s billing email address, company, name and language.
When: once per order, in the background after the order status changes to “processing” or “completed”, with up to five retries after an error.
Address: https://www.proofpass.eu/api/v1/orders.
3. ProofPass catalogue scan (your server, when you start it)
What it is for: shows which products of your shop (WooCommerce or another shop system set up under Settings → ProofPass) are in ProofPass and which documents are missing.
What is sent: your key and, for each product, its GTIN, SKU and name. ProofPass does not store the list.
When: when you click “Scan catalogue”, run wp proofpass scan, or the first time “Test connection” succeeds with WooCommerce active.
Address: https://www.proofpass.eu/api/v1/catalog/scan.
4. Files and pages of ProofPass in the visitor’s browser
The ProofPass embed (frame or the script widget.js), when the output is set to the embed or no API key is saved: the browser loads it from www.proofpass.eu and sends the address of the frame (manufacturer, language, product identifier) and, as with every web request, the visitor’s IP address and browser data. Inside the frame ProofPass counts search terms and document opens anonymously for the manufacturer (no cookie, no identifier).
PDF documents, the QR code image of the elements “QR code” and “Product passport”, and the links to product pages on ProofPass load from www.proofpass.eu when the visitor opens or sees them.
Proposition 65 region check, only if you switch it on: the browser asks www.proofpass.eu/api/us/warnung whether the warning applies at the visitor’s location and, when the warning becomes visible, posts the page address, a random page-view ID and a signed token to www.proofpass.eu/api/us/anzeige. ProofPass stores time, country and region from its own request headers, the page and the page-view ID; no IP address, no user agent, no cookie.
No cookies are set by any of these.
About the script mode
In the embed mode “Script” the page loads widget.js from www.proofpass.eu. This is the embed script of the ProofPass service itself, not a library from a CDN, and it only builds the frame that shows the documents. It is printed where the element stands, with wp_get_script_tag(), because it reads its settings from its own data- attributes. Its address carries ?via=wordpress, so ProofPass can count script embeds that come from this plugin; nothing else about your site or the visitor is added. The default embed mode “Frame (iframe)” loads no script. The plugin never downloads or runs code from ProofPass on your server.
The connection test without API key requests https://www.proofpass.eu/einbetten/
Terms of service: https://www.proofpass.eu/agb
Privacy policy: https://www.proofpass.eu/datenschutz
