Beskrivelse
ProofPass is a data sheet portal for manufacturers and dealers. You upload safety data sheets (SDS), technical data sheets, declarations of performance and other product documents once. ProofPass keeps every version, creates a QR code per product and delivers new versions to your customers with proof of delivery.
This plugin shows those documents on your WordPress website and in WooCommerce. 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. Without one, the plugin uses the official ProofPass embed, which works in every plan including the free Basis plan.
Elements
- Documents of one product: type, language, revision date, version and PDF link, plus manufacturer, responsible person, safety information and an active recall notice.
- Document search of the whole catalogue: a search form that works without JavaScript, results with their documents, pagination.
- QR code of a product.
- Single document button, for example “Safety data sheet (PDF)”, in the language of the page if it exists.
- Product passport: identifiers (article number, GTIN, UFI, brand, model, batch, CE marking), documents, manufacturer, safety information, QR code.
- Documents for your quote: the documents of several products or of the cart, with a button to your own quote page.
- Proposition 65 warning, exactly as the manufacturer stored it.
- Updates by email: a link to the subscription on ProofPass (double opt-in).
Where you can use them
- 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”.
- Divi and WPBakery: element “ProofPass” (see FAQ: 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.
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 (WooCommerce field, common GTIN plugins or a meta key you name), the SKU as article number. Variations can have their own documents; the list switches when a variation is chosen.
- Links to the documents of the bought products in the customer’s order emails and on the order-received page.
- Proposition 65: the warning above the add-to-cart button and with the item in cart and checkout (classic and block checkout).
- 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. Works with any ProofPass key, also a scan key of the free Basis 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 and the cart and checkout blocks.
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.
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 WooCommerce products 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 fromwww.proofpass.euand 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.euwhen the visitor opens or sees them. - Proposition 65 region check, only if you switch it on: the browser asks
www.proofpass.eu/api/us/warnungwhether 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 towww.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. 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/<manufacturer>/widget.js once from your server. The link “Create a free ProofPass account” opens the sign-up page of ProofPass with the parameter cta=wordpress.plugin.settings, so ProofPass can tell that the sign-up came from the plugin; nothing about your site is sent.
- Terms of service: https://www.proofpass.eu/agb
- Privacy policy: https://www.proofpass.eu/datenschutz
Skærmbilleder










Blokke
Dette plugin giver 1 blok.
- ProofPass Safety data sheets and product documents from ProofPass: one product, the whole catalogue, a QR code, a single document, the product passport or documents for a quote.
Installation
- Install the plugin from the Plugins screen, or upload the folder
proofpassto/wp-content/plugins/, and activate it. - Open Settings ProofPass. No account yet: “Create a free ProofPass account”.
- Enter your manufacturer (your ProofPass address
https://www.proofpass.eu/hersteller/your-companyor onlyyour-company) and an API key (ProofPass dashboard Einbinden API-Schlüssel), then click “Test connection”. With WooCommerce the catalogue scan runs right after. - Add the block “ProofPass” to a page, use a page builder element or a shortcode. With WooCommerce the documents appear on the product page by themselves.
FAQ
-
Do I need a paid ProofPass plan?
-
No. The embed works in every plan, including Basis, and the catalogue scan works with a scan key of the Basis plan. Documents rendered in your theme need an API key, from the Start plan.
-
Can I remove the line “Provided via ProofPass”?
-
It is off by default. The plans Basis and Start include it: in the embed ProofPass shows it; for documents rendered in your theme you agree to show it under Settings ProofPass, otherwise the plugin uses the embed. From the Pro plan it is optional.
-
Which page builders are supported?
-
Block editor, Elementor and Beaver Builder are tested with this release. Divi (module API of Divi 4, which Divi 5 runs in its compatibility mode) and WPBakery (
vc_map) are written against their documented developer APIs but were not run, because both are commercial. If the element does not appear there, put a shortcode such as[proofpass_documents product="art:SN-310"]into a Code or Text module; that always works. -
How does the WooCommerce mapping work?
-
First the field “ProofPass product” of the product or variation, then the GTIN, then the SKU as article number. A variation tries its own identifiers first, then those of its parent. Developers can change the order with the filter
proofpass_product_lookup_keys. The scan and the mapping screen (WooCommerce ProofPass Mapping) help with products that are not found. -
Where does the plugin read the GTIN?
-
From the WooCommerce field (since WooCommerce 9.2), from the meta keys
_wpm_gtin_code,_alg_ean,_ts_gtin,_gtin,_eanand from a meta key you enter under Settings ProofPass. -
A new document version does not show up.
-
Answers are cached for 6 hours by default, then refreshed in the background. Save the product, click “Clear cache” under Settings ProofPass or run
wp proofpass cache flush. -
No. The optional Proposition 65 region check sends ProofPass, from the visitor’s browser, a random page-view ID and the page address when the warning was visible, and ProofPass stores country and region; no IP address and no cookie. It is off by default.
-
Can visitors subscribe to new versions?
-
Yes, with the element “Updates by email” or the link under the document list. It opens the product page on ProofPass, where the visitor subscribes with double opt-in; the address then appears in your distribution list in ProofPass. The plugin itself collects no personal data.
-
Which data does an order report send?
-
The order number, GTIN or SKU (or the ProofPass product ID) of each ordered product, whether the buyer counts as professional, and the buyer’s billing email address, company, name and the site language. No prices, no addresses, no payment data. ProofPass accepts order reports only after the current data processing agreement is concluded in its dashboard; until then the plugin says so in its settings, in Site Health and in the order note.
-
Does the plugin store personal data?
-
No. The order report job carries only the order ID and reads the address from the WooCommerce order when it runs. The plugin keeps only a status per order (queued, done, skipped, failed).
-
Does the plugin make my shop compliant?
-
No. It shows the documents and information you maintain in ProofPass. It is not legal advice.
Anmeldelser
Der er ingen anmeldelser for denne widget.
Bidragsydere & udviklere
“ProofPass” er open source-software. Følgende personer har bidraget til dette plugin.
BidragsydereOversæt “ProofPass” til dit eget sprog.
Interesseret i udvikling?
Gennemse koden, tjek SVN repository, eller abonner på udviklerloggen via RSS.
Ændringslog
2.0.0
- New: documents rendered in your theme as real links (API key), for every element; the embed stays available per element and as the fallback.
- New elements: document search of the whole catalogue, QR code, single document button, product passport, documents for your quote, Proposition 65 warning, updates by email.
- New: block “ProofPass” with variations, product search and live preview (the block of version 1 keeps working); Elementor widgets; Beaver Builder module; Divi module and WPBakery element (untested, see FAQ); shortcode generator in the classic editor.
- New WooCommerce placements (tab, collapsible section, summary, below the add-to-cart button), “ProofPass” tab in the product data, mapping per variation, documents in order emails and on the order-received page, documents of the cart.
- New: Proposition 65 warnings on the product page and in cart and checkout, US safety data sheets with emergency number.
- New: column and filter “ProofPass” in the product list from the scan, mapping screen with suggestions by name, WP-CLI commands, Site Health test, privacy policy text.
- New: order report counts chosen customer roles as professional; the settings, Site Health and the order note say when the data processing agreement is missing.
- New: onboarding with a free sign-up link; the scan is the first screen after connecting.
- Cache: stale-while-revalidate with background refresh, at most one request to ProofPass per page view.
- Settings of version 1 are kept: existing sites keep the embed and the product tab until you change the output.
- Translations are no longer bundled; they come as language packs from translate.wordpress.org.
1.1.1
- Order report: when ProofPass is still processing the same order (HTTP 409), the plugin asks again later instead of giving up. A repeated report no longer leaves the note that no product has a current safety data sheet.
1.1.0
- New: optional order report. Paid WooCommerce orders go to ProofPass in the background (Action Scheduler, WP-Cron as fallback); ProofPass sends professional buyers the current safety data sheets and records the delivery.
- New: WooCommerce ProofPass scan.
- The connection messages name a key that lacks the permission for a request.
1.0.0
- First release: settings page with connection test, shortcode
[proofpass], block “ProofPass data sheets”, WooCommerce product tab with automatic mapping (GTIN, SKU, override field), API v1 document list with cache, embed fallback, German translation.
