Zum Inhalt springen
WooCommerce & WordPress Plugin Docs

Getting started

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

Tipping ships enabled with three percentage presets (5%, 10%, 15%), so a fresh install already shows a tip control on the checkout. This page covers the install, the settings worth changing first, and how to confirm the fee behaves.

Before you start

Section titled “Before you start”
  • WordPress 6.5 or newer
  • WooCommerce 8.0 or newer
  • PHP 8.1 or newer

WooCommerce must be active. If it is missing, Tipping stays inactive and shows an admin notice rather than erroring.

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install Tipping from the plugin directory (when live on WordPress.org), or upload the tipping folder to /wp-content/plugins/.
  3. Activate the plugin.

There is nothing to configure to see it work: the packaged defaults enable tipping with percentage presets 5, 10, 15.

First configuration

Section titled “First configuration”

Open WooCommerce → Tipping. Everything lives on this one screen, stored in the tipping_settings option:

  • Enable tipping, the master switch. When off, the control never renders and no CSS or JavaScript loads on the storefront.
  • Label, the heading above the buttons, e.g. Add a tip or Support our shelter. Leave blank to fall back to “Add a tip”.
  • Description, optional supporting line under the label.
  • Preset type, Percentage of cart or Fixed amount.
  • Preset values, comma-separated numbers. For percentages use whole numbers (5, 10, 15); for fixed amounts use currency values (2, 5, 10).

The settings page shows a live preview of the preset pills as the customer will see them, so you can read the effect of your values without opening the storefront.

What the presets mean

Section titled “What the presets mean”
  • Percentage, a 5 preset adds 5% of the pre-tip items subtotal (tax-exclusive). A larger order means a larger tip, and the amount recalculates if the cart changes.
  • Fixed, a 5 preset adds a flat 5 in your store currency, whatever the cart total.

Up to eight presets are kept; any beyond that, and any zero or negative value, are dropped on save. Leave the field empty and the control is hidden until you add at least one preset.

Verify on the checkout

Section titled “Verify on the checkout”
  1. Add a product to the cart and open the checkout (the classic shortcode checkout, see the note below).
  2. The tip control appears just above the payment methods, with No tip preselected.
  3. Choose a preset, the order total updates live, with the tip shown as a fee line.
  4. With a percentage preset selected, change the cart quantity; the tip recalculates against the new subtotal.
  5. Place a test order, the tip appears as a fee in the order totals and emails, and the amount is saved as _tipping_amount order meta.

A note on block checkout

Section titled “A note on block checkout”

The control renders on the classic (shortcode) checkout via woocommerce_review_order_before_payment. Tipping declares compatibility with the Cart/Checkout Blocks feature so it does not trigger an incompatibility warning, but the buttons are not drawn on a block-based checkout. If your store uses the Checkout block, keep a classic checkout to show the control.

Free vs Pro

Section titled “Free vs Pro”

The free edition is the complete tipping control: percentage or fixed presets, live totals, editable copy, the non-taxable cart fee and order meta. Tipping Pro (planned) builds on the tipping/fee_amount filter and the tipping/admin_after_cards action for amount adjustments like round-up tipping, it does not gate basic tipping. See Configuration.

Need help?

Section titled “Need help?”