Simple WooCommerce Order Approval FAQ

Licensing

1) How to transfer the license to another domain?

You should ask for the domain change in your customer area, next to the original order details.

After you get the reply from us stating that the license key is free, you should go to the plugin configurations on the old website, remove the key and save. Then go to the new website configurations, insert the key, and save. If the website was transferred with the key already on the database, you need to remove it, save, and insert it again.

Styling

1) How to style the “Pay for this order” link in the approved email?

The link has the swoa-email-payment-button ID and you can add CSS to the WooCommerce emails with the woocommerce_email_styles filter.

2) How to style the checkout or the order received messages?

The message divs have the swoa-checkout-needs-approval and swoa-thank-you-needs-approval IDs, that you target on your custom CSS.

Developer hooks

As stated in our policy, the usage of developer hooks is not covered by technical support, yet we provide some usage examples below.

1) Apply your own order approval rules with the swoa_needs_approval filter

If the cart/order does not fall into any of the rules set in the configurations, you can use the swoa_needs_approval filter to return true or false based on your own rules.

The filter has 4 parameters:

  • $needs_approval – true or false as defined by the plugin rules;
  • $cart_or_order – WC_Cart or WC_Order object depending on whether we’re looking at the cart or at the order after checkout;
  • $applied_rule – the applied rule (‘global’, ‘billing_country’, ‘shipping_country’, ‘billing_state’, ‘shipping_state’, ‘shipping_zone’, ‘product_cat’, ‘product’, or ‘product_on_backorder’) if $needs_approval is true or null if $needs_approval is false;
  • $object_id – the applied rule object id (country, state, shipping zone, category, or product) if $needs_approval is true or null if $needs_approval is false or the $applied_rule is ‘global’;

Check these examples: https://gist.github.com/webdados/15ae368bc5f1ee3b4a04f3b111052947

2) Other hooks

  • swoa_product_cat_ids_for_approval – change the product category IDs that need approval, if that’s the applied rule;
  • swoa_needs_approval_checkout_message – change the message shown on the checkout if the cart needs approval;
  • swoa_needs_approval_order_received_message – change the message on the “thank you” page if the order needs approval;
  • swoa_settings_tab_settings – manipulate the plugin settings fields (for extensions)
  • swoa_admin_list_show_column – return false not to show the “needs approval” column and filter on the products and categories list;