Kramar – Toolkit for eCommerce: Invoices, Email, Compliance & More

Built for the EU

Kramar was designed from the ground up for EU and Dutch law. The compliance modules consider the GDPR, the Consumer Rights Directive, the Omnibus Directive, and Dutch civil-code requirements. They are entirely optional — the invoicing, email, product, performance, and order tools work for any store, anywhere.

Modular

Enable only what you need. Disabled modules have zero overhead — no hooks, no queries, no assets loaded.

For Developers

Kramar’s Email Manager module exposes a small PHP API for sending and scheduling custom emails from themes or other plugins. No code is needed to create a custom email — use Kramar → Emails → Add New Email in the admin to build and configure it. Once it exists you can trigger it programmatically.

Finding a custom email’s id

Every custom email created through the UI gets an id of the form kramar_custom_{slug} , where the slug is derived from the email name: spaces become underscores, all characters are lowercased, and the result is passed through sanitize_key() . Example: an email named “Review Request” becomes kramar_custom_review_request . The exact id is shown in the Custom Emails table on Kramar → Emails.

Sending immediately

kramar_send_email( string $id, mixed $context = null ): bool

Sends the custom email right now. Returns true if the email was dispatched (the email was found, is enabled, and passed the send filters). $context may be a WC_Order object, an order id (integer or numeric string), or null . null is only for emails of the “General” type; an order email given no order returns false and sends nothing, rather than an email with an empty body.

kramar_send_email( 'kramar_custom_review_request', $order_id );

Scheduling for later

kramar_schedule_email( string $id, mixed $context, int $timestamp ): bool

Schedules the email via Action Scheduler at the given Unix timestamp. Returns true if the action was queued (or was already queued). Requires WooCommerce’s bundled Action Scheduler.

kramar_schedule_email( 'kramar_custom_review_request', $order_id, time() + 7 * DAY_IN_SECONDS );

Idiomatic do_action aliases

Both functions are also wired to do_action so callers that prefer hooks over direct function calls can use:

do_action( 'kramar_send_email', $id, $context ); do_action( 'kramar_schedule_email', $id, $context, $timestamp );

Filters

kramar_email_recipient — Override the To address before the email is sent.

apply_filters( 'kramar_email_recipient', string $recipient, string $id, WC_Order|null $order )

kramar_email_should_send — Return false to prevent a send entirely.

apply_filters( 'kramar_email_should_send', bool $should, string $id, WC_Order|null $order )

kramar_email_merge_field_values — Add or replace merge-field values used inside email content.

apply_filters( 'kramar_email_merge_field_values', array $replacements, WC_Order $order )

kramar_email_default_blocks — Contribute blocks to an email’s default template, before the footer is appended. Used by the Refund & Return module to place the withdrawal button.

apply_filters( 'kramar_email_default_blocks', array $blocks, string $email_id, string $context )

kramar_withdrawal_link_emails — Which emails carry the withdrawal link. Defaults to the processing, on-hold and completed customer emails.

apply_filters( 'kramar_withdrawal_link_emails', array $email_ids, WC_Order|null $order )

kramar_suppress_withdrawal_link — Return true to skip the automatic withdrawal link for the current render. Set automatically while rendering a template that places {withdrawal_link} itself.

apply_filters( 'kramar_suppress_withdrawal_link', bool $suppress )

Visitor IP behind a proxy or CDN

Rate limits (back-in-stock signup, order tracking, account creation, the withdrawal form) and the VAT evidence record use the address of whoever opened the connection. X-Forwarded-For and X-Real-IP are only believed when that connection comes from a trusted proxy: a loopback or private-network address, or an address listed in KRAMAR_TRUSTED_PROXY . A shop behind Cloudflare or a hosted load balancer should list its ranges in wp-config.php, otherwise all visitors share a few edge addresses:

define( 'KRAMAR_TRUSTED_PROXY', '203.0.113.10, 198.51.100.0/24' );

Behind Cloudflare, the keyword cloudflare trusts Cloudflare’s published ranges and reads CF-Connecting-IP :

define( 'KRAMAR_TRUSTED_PROXY', 'cloudflare' );

If your proxy sets one specific header, pin it so no other forwarding header is read:

define( 'KRAMAR_CLIENT_IP_HEADER', 'X-Real-IP' );

Rate limits treat an IPv6 visitor’s whole /64 network as one visitor.

kramar_trusted_proxies — The trusted proxy list (IPs and CIDR ranges, private ranges included so they can be removed).

apply_filters( 'kramar_trusted_proxies', array $proxies, string $remote_addr )

kramar_client_ip — Replace the resolved visitor IP. A value that is not a valid IP is ignored.

apply_filters( 'kramar_client_ip', string $ip, string $remote_addr )

Worked example: review request 7 days after order completion

add_action( 'woocommerce_order_status_completed', function ( $order_id ) { kramar_schedule_email( 'kramar_custom_review_request', $order_id, time() + 7 * DAY_IN_SECONDS ); } );

Note: The WooCommerce mailer caches its email list per request. A custom email created in the same PHP request as your kramar_send_email() call will not yet be registered and the call will return false . In normal use — emails created in the admin, triggered later by frontend or cron events — this is never a concern.

Delivery time (template tag)

Display a product’s delivery-time estimate anywhere in your theme:

kramar_get_delivery_time( int $product_id = 0 ): string

Returns the product’s own delivery-time term, falling back to the shop-wide default set in the EU Product Compliance module (or an empty string when neither is set). Works even when the automatic front-end display is turned off. Pass 0 to use the current global $product .

echo esc_html( kramar_get_delivery_time( $product->get_id() ) );

kramar_delivery_time_label — Filter the resolved label.

apply_filters( 'kramar_delivery_time_label', string $label, int $product_id )

kramar_delivery_time_html — Filter the rendered <span class="kramar-delivery-time"> markup (escape your own output).

apply_filters( 'kramar_delivery_time_html', string $html, string $label, WC_Product $product )