i4w_subscription_order
Usage
This shortcode is a one-click "subscription" order processor designed to perform its assigned tasks with no user interaction.
It can be used as a regular purchase tool as well as an upsell tool. In either case, the only requirement is that users be logged in the membership site and that their credit card information be stored in Keap.
In every example listed below, the default user information used is from the user currently logged in. All the parameters used in the examples can be mixed.
Please note that in addition to the tag "filters" available within the shortcode, this shortcode may be embedded within other conditional shortcodes, such as [i4w_onlyfor], [i4w_hidefrom], [i4w_ifget], [i4w_ifpost], etc.
You may include this shortcode several times on a page or post. However, only the first instance of the shortcode matching the requirements will actually run. This enables you to set up a single page with different tag-based rules triggering different subscription orders.
[ELSE_subscription_order] conditional branching is NOT supported.
Shortcode nesting is NOT supported.
Parameters
| Parameter | Description | Default | Required |
|---|---|---|---|
| subid | The subscription ID of the subscription that should be used as the basis for an order. | - | Yes |
| subprice | An override for the subscription price. | - | No |
| allowduplicate | Whether to allow this purchase if the subscription has already been purchased by this user. | false | No |
| allowtax | Allow sales tax to be charged for this subscription. | application default | No |
| tagid | A single or comma separated list of tag ID's that a user must possess in order to complete an order. | - | No |
| require_all_tags | Modifies the use of the "tagid" parameter from having to match at least one to having to match all tags. | - | No |
| excl_tagid | A single or comma separated list of tag ID's that a user may not possess in order to complete an order. | - | No |
| merchantid | Allows an alternate merchant ID to be specified. | - | No |
| affid | Specifies the Sale Affiliate who should get credit for this transaction. | - | No |
| daystillcharge | Number of days to wait before charging for the subscription. | 0 | No |
| actionsuccess | The action set ID to be executed upon successful processing of the order. | - | No |
| actionfail | The action set ID to be executed upon failed processing of the order. | - | No |
| urlsuccess | The URL to which to redirect users upon a successful purchase. | home page | No |
| urlfail | The URL to which to redirect users upon a failed purchase. | home page | No |
| deletefailed | Whether an "orphaned" (or incomplete) order is allowed to remain in Keap if the order failed. | yes | No |
Example
[i4w_subscription_order subid='36']
[i4w_subscription_order subid='36' subprice='9.90']
[i4w_subscription_order subid='36' tagid='123,234']
[i4w_subscription_order subid='36' actionsuccess='17' actionfail='23']
[i4w_subscription_order subid='36' urlsuccess='/buyanotherone/' urlfail='/youbroke/']