Documentation

How to use ShopMagic with Flexible Subscriptions?

Requirements#

  • WordPress 6.4+ (tested up to 6.9).
  • WooCommerce 10.0+ (tested up to 10.4).
  • PHP 7.4+.
  • ShopMagic for WooCommerce 4.5+.
  • Flexible Subscriptions 1.7.1+.

The plugin extends ShopMagic with events, actions, filters, and placeholders related to Flexible Subscriptions. Configuration happens in the ShopMagic automation editor.

Where to find the features#

Go to: ShopMagic > Automations. In the automation editor you select an Event, optionally add Filters, Actions, and use placeholders in messages or actions.

Events and fields#

  • New Subscription – no additional fields.
  • Subscription Status Changed – fields: Status changes from (status list, default Any status), Status changes to (status list, default Any status), Recheck subscription status before run (checkbox).
  • Subscription Before End – field: Days before end (number of days before end).
  • Subscription Before Renewal – field: Days before renewal (number of days before renewal).
  • Subscription Trial End – field: Days before trial end (number of days before trial end).

Actions and fields#

  • Subscription Change Date – fields: Date type (Created Date, Trial End Date, Next Payment Date, End Date), Change date to (date).
  • Subscription Change Status – field: Change status to (status list).
  • Subscription Change to Manual – no additional fields.

Filters and fields#

Filters use standard ShopMagic fields: operator/condition selector plus value. Below is the field type you will see in the UI:

  • Customer - Has Active Subscription – Yes/No value.
  • Customer - Subscriptions Count – numeric value.
  • Subscription - Billing Period – list: Day, Week, Month, Year.
  • Subscription - Date Completed – date field.
  • Subscription - Date Created – date field.
  • Subscription - Date Paid – date field.
  • Subscription - ID – ID list (text/number string).
  • Subscription - Item Categories – product category selector.
  • Subscription - Item Count – numeric value.
  • Subscription - Last Paid Renewal Date – date field.
  • Subscription - Custom Field – meta key + value.
  • Subscription - Items – product selector.
  • Subscription - Parent Order Status – order status selector.
  • Subscription - Payment Gateway – active payment gateways selector.
  • Subscription - Requires Manual Renewal – Yes/No value.
  • Subscription - Shipping Method – shipping methods selector.
  • Subscription - Status – subscription status selector.
  • Subscription - Total – numeric value (amount).

Placeholders (in message/action content) and fields#

  • Order Type – order type in relation to subscription (parent/renewal/regular).
  • Subscription Admin URL – admin edit link.
  • Subscription Billing Address – formatted billing address.
  • Subscription Change Payment Method URL – add/change payment method link.
  • Subscription End Date – end date (supports date format parameters).
  • Subscription ID – subscription identifier.
  • Subscription Items – field Template: Comma separated list or Bullet list.
  • Subscription Last Payment Date – last payment date (date format parameters).
  • Subscription Meta – field The meta key to retrieve.
  • Subscription Next Payment Date – next payment date (date format parameters).
  • Subscription Payment Count – count of paid renewals.
  • Subscription Payment Method – subscription payment method.
  • Subscription Shipping Address – formatted shipping address.
  • Subscription Start Date – start date (date format parameters).
  • Subscription Status – subscription status.
  • Subscription Total – field Format: HTML or Raw.
  • Subscription Trial End Date – trial end date (date format parameters).
  • Subscription View URL – customer My Account subscription link (ShopMagic UTM parameters).
Not the solution you are looking for?

Please check other articles or open a support ticket.