This WordPress plugin is intended as a connector to Magic Subscriptions subscription box management system. It does require an account with Magic Subs …

ronniebarker

<p>This WordPress plugin is intended as a connector to <a href="https://magicsubscriptions.com" rel="nofollow ugc">Magic Subscriptions</a> subscription box management system. It does require an account with <a href="https://magicsubscriptions.com" rel="nofollow ugc">Magic Subscriptions</a> in order to be useful.</p>
<p>The intention is to keep users on the primary WordPress site as much as possible, only redirecting off to MagicSubscriptions portal when necessary; and bringing them back. To facilitate this, there are connectors that pull subscription and order information in to the plugin to display on the primary WordPress site.</p>
<p>For any technical support please contact: <a href="mailto:wp-support@magicsubsriptions.com" rel="nofollow ugc">wp-support@magicsubsriptions.com</a></p>
<h3>Components</h3>
<p>All blocks are shown under a <strong>Magic Subscriptions</strong> folder in the block editor.</p>
<h3>Plans</h3>
<p><strong>Name</strong>: PlansComponent<br />
<strong>Block name</strong>: Plans<br />
<strong>Block identifier</strong>: magic-subscriptions/plans<br />
<strong>Shortcode</strong>: [ MagicSubscriptions_Plans code=’<code>code</code>‘ ]<br />
<strong>Widget</strong>: Magic Subs (Plans)</p>
<p>The <strong>Plans</strong> component displays the subscription plans currently available within the <strong>LandingPage</strong> <code>code</code></p>
<p>The <code>code</code> is optional and, if missing, the <code>Default</code> <em>LandingPage</em> will be used</p>
<h3>ConnectButton</h3>
<p><strong>Name</strong>: ConnectButtonComponent<br />
<strong>Block name</strong>: Connect<br />
<strong>Block identifier</strong>: c-subscriptions/connect<br />
<strong>Shortcode</strong>: [ MagicSubscriptions_Connect ]<br />
<strong>Widget</strong>: Magic Subs (Connect)</p>
<p>The <strong>ConnectButton</strong> component displays a button to link (via a cookie) to a MagicSubscriptions login</p>
<p>If a valid connected cookie exists then this component is empty.</p>
<h3>Summary</h3>
<p><strong>Name</strong>: SummaryComponent<br />
<strong>Block name</strong>: Summary<br />
<strong>Block identifier</strong>: magic-subscriptions/summary<br />
<strong>Shortcode</strong>: [ MagicSubscriptions_Summary ]<br />
<strong>Widget</strong>: Magic Subs (Summary)</p>
<p>The <strong>Summary</strong> component shows a ‘shopping cart’ style summary of the <em>connected</em> customer’s active subscriptions, pending orders and ‘open-box’ added items.</p>
<p>If the system is not connected to a login then this component is empty</p>
<h3>Wide Summary</h3>
<p><strong>Name</strong>: WideSummaryComponent<br />
<strong>Block name</strong>: Wide Summary<br />
<strong>Block identifier</strong>: magic-subscriptions/widesummary<br />
<strong>Shortcode</strong>: [ MagicSubscriptions_WideSummary ]<br />
<strong>Widget</strong>: Magic Subs (Wide Summary)</p>
<p>The <strong>Wide Summary</strong> component is a landscape version of the <strong>Summary</strong> component</p>
<h3>Shop</h3>
<p><strong>Name</strong>: ShopComponent<br />
<strong>Block name</strong>: Shop<br />
<strong>Block identifier</strong>: magic-subscriptions/shop<br />
<strong>Shortcode</strong>: [ MagicSubscriptions_Shop tag=’<code>tag</code>‘ ]<br />
<strong>Widget</strong>: Magic Subs (Shop)</p>
<p>The <strong>Shop</strong> component shows a product list that can be <strong>add</strong>ed to the next order that is scheduled.</p>
<p>The <code>tag</code> is required (or nothing will display) and relates to the tag set up in the products list in your Magic Subscriptions portal.</p>
<h3>Attributes</h3>
<p><strong>Name</strong>: AttributeComponent</p>
<p>The <strong>Attributes</strong> component adds a section to Gutenberg blocks supporting the following options:</p>
<h4>Visible when:</h4>
<ul>
<li><strong>Always</strong> -> This is just the default (visibility not configured or controlled by the component.</li>
<li><strong>When connected</strong> -> Only show this block if the user has connected to their Magic Subscriptions account.</li>
<li><strong>When NOT connected</strong> -> Only show this block if the user has NOT connected to their Magic Subscriptions account.</li>
</ul>
<h3>Elementor</h3>
<p><strong>Name</strong>: ElementorComponent</p>
<p>The <strong>Elementor</strong> component adds a visibility option to the <em>Advanced</em> tab on the <em>Edit Section</em> -> <em>Advanced</em> panel:</p>
<h4>Magic Subscriptions – visible when:</h4>
<ul>
<li><strong>Tick-Tick (Always)</strong> -> This is just the default (visibility not configured or controlled by the component.</li>
<li><strong>Tick (Connected)</strong> -> Only show this block if the user has connected to their Magic Subscriptions account.</li>
<li><strong>Cross (Not connected)</strong> -> Only show this block if the user has NOT connected to their Magic Subscriptions account.</li>
</ul>
<h3>Hooks</h3>
<h3>MagicSubscriptions_OverrideRenderPlan (filter)</h3>
<h3>Parameters</h3>
<p><strong>$metal</strong>: The current Metal as configured in <strong>Magic Subscriptions</strong><br />
**$code$: The **Landing Page* code being rendered<br />
**: New <em>Metal</em> Value. Any unknown [non-stndard] <em>Metal</em> values will result in the <code>MagicSubscriptions_RenderPlan</code> action to be called to render the plan.</p>
<h3>Example:</h3>
<pre><code>add_filter( "MagicSubscriptions_OverrideRenderPlan", function( $metal, $code ) {
    return "MyNewMetalName";
}, 10, 2 );
</code></pre>
<h3>MagicSubscriptions_RenderPlan (action)</h3>
<h3>Parameters</h3>
<p><strong>$metal</strong>: The <strong>Metal</strong> (theme) that is being rendered (as returned from the <code>MagicSubscriptions_OverrideRenderPlan</code> action)<br />
<strong>$code</strong>: The <strong>Landing Page* code being rendered<br />
**$plan</strong>: Object representing the plan (TODO: Document object properties)<br />
<strong>$action</strong>: URL Action for POSTing a form to => hands control over to <strong>Magic Subscriptions</strong> (note the <code>$code</code>, <code>$plan->code</code> [named <code>plan</code>] and <code>$token</code> should be included as hidden form post elements)<br />
<strong>$token</strong>: Security token to be POSTed to <strong>Magic Subscriptions</strong></p>
<h3>Use:</h3>
<p>This action is called for every plan being rendered within a section for an unknown [non-standard] <em>Metal</em> value.</p>
<h3>Example:</h3>
<pre><code>add_action( "MagicSubscriptions_RenderPlan", function( $metal, $code, $plan, $action, $token ) {
    ?>
    <form class="plan" method='post' action='<?= $action ?>'>
        <input type='hidden' name='token' value='<?= $token ?>'>
        <input type='hidden' name='code' value='"<?= $code ?>'>
        <input type='hidden' name='plan' value='<?= $plan->code ?>'>
        <p><?= $plan->name ? $plan->name : $plan->scheduleName ?></p>
        <p><?= $plan->title ? $plan->title : $plan->scheduleTitle ?></p>
        <p><?= $plan->headline ? $plan->headline : $plan->scheduleHeadline ?></p>
        <p>£ <?= number_format( $plan->dayOnePrice, 2, '.', ',' ) ?></p>
        <p>£ <?= number_format( $plan->recurringPrice, 2, '.', ',' ) ?></p>
        <button type='submit'><?= $plan->actionLabel ?></button>
    </form>
    <?php
}, 10, 5 );
</code></pre>


Alternatives to Magic Subscriptions

Top alternatives