Differences

This shows you the differences between two versions of the page.

--- cartintegration:magento:magento [2010/10/21 19:56] – earlyimpact
+++ cartintegration:magento:magento [2012/09/24 04:07] (current) – matt
@@ Line 1: / Line 1: @@
+~~NOTOC~~
+<note>
+The Magento Add-On is no longer supported in-house by Early Impact.  The Add-On is now Open Source and available for your custom development projects.  The source code can be downloaded via the developers section of this wiki. While we no longer maintain the source code we do still offer full support and consultation related to SubscriptionBridge.
+</note>
 ====== SubscriptionBridge Extension for Magento (BETA) ======
 ===== Overview =====
@@ Line 4: / Line 13: @@
 {{ :cartintegration:magento-logo.png|Magento is integrated with SubscriptionBridge}}
-The **[[http://www.magentocommerce.com/magento-connect/Early+Impact%2C+Inc./extension/4755/earlyimpact_subscriptionbridge|SubscriptionBridge Extension for Magento]]** allows you to sell subscriptions directly from your Magento-powered online store. During checkout, Magento will detect that the product/service being purchased is a subscription and will pass all necessary information to SubscriptionBridge, which will crate a recurring billing profile for the customer.
+The **[[http://www.magentocommerce.com/magento-connect/Early+Impact%2C+Inc./extension/4755/earlyimpact_subscriptionbridge|SubscriptionBridge Extension for Magento]]** allows you to sell subscriptions directly from your Magento-powered online store.
+During checkout, Magento will detect that the product/service being purchased is a subscription and will pass all necessary information to SubscriptionBridge, which will crate a recurring billing profile for the customer.
 Features include:
+  * Quick install via Magento Connect Manager
   * Easily activate a **live connection** between your Magento-powered store and your SubscriptionBridge Merchant account
   * **Map items** in your Magento store catalog to subscription packages that have been setup in SubscriptionBridge
   * Automatically display subscription terms when showing product details and during checkout, via the **built-in [[developer_guide:developer_guide:terms_widget|subscription terms widget]]**
-  * Automatically create a subscription in the recurring payment system associated with your SubscriptionBridge store
+  * Define Terms & Conditions at the product level so that the correct terms are shown during checkout, before the order for the subscription can be placed.
+  * Automatically create a subscription in the recurring payment system associated with your SubscriptionBridge store (e.g. Authorize.Net, PayPal Website Payments Pro).
   * Manage subscription billing and recurring payments through SubscriptionBridge
+The extension is now in **BETA** simply because it needs to be used in "real life" environments for a bit longer to ensure that everything is working as expected. We will remove the BETA label as soon as possible.
 ===== Screen shots =====
@@ Line 122: / Line 137: @@
 Note that the regular price for this subscription-based product or service is not shown in this window. Only the trial price is (if any). That's because the "regular" price is the price that you entered when you created it. Edit it now if you need to. It should be consistent with the regular subscription price that you have specified for this subscription package in SubscriptionBridge.
 ==== Listing existing subscription Packages ====
 You can now view a list of the items that you have linked to subscription packages by selecting //SubscriptionBridge > View/Modify Subscription Packages//. You can edit existing product-package associations by clicking on "//Edit//".
+===== Subscription Terms Widget =====
+The Subscription Terms Widget allows you to show terms for the subscription in the Magento storefront, dynamically retrieving them from SubscriptionBridge. You can style the widget using simple CSS.
+To show the widget, you need to edit a few files in the Magento storefront. This is because "design" pages cannot be altered through an extension (so we can't take care of this automatically for you, unfortunately). In each of the following cases, make sure to create a backup copy of the original file before editing it.
+==== Edit "product\view.phtml" ====
+  * Download the file "\app\design\frontend\default\default\template\catalog\product\view.phtml" via FTP
+  * Open it in Notepad or your favorite HTML editor
+  * Locate the following code around line 68 <code><?php echo $this->getTierPriceHtml() ?></code>
+  * Add the following code right after that line: <code><?php
+// start code to add
+if($_product->getSbLinkid()) echo $this->helper('subscriptionbridge')->getSbApiWidget($_product->getSbLinkid());
+// end code to add
+?></code>
+  * Save the file and upload it back to the Web server.
+==== Edit "cart\item\default.phtml" ====
+  * Download the file "\app\design\frontend\default\default\template\checkout\cart\item\default.phtml" via FTP
+  * Open it in Notepad or your favorite HTML editor
+  * Locate the following code around line 52 <code><!-- / --></code>
+  * Add the following code right after that line: <code><?php
+// start code to add
+if($_item->getSbLinkid()) echo $this->helper('subscriptionbridge')->getSbApiWidget($_item->getSbLinkid());
+// end code to add
+?></code>
+  * Save the file and upload it back to the Web server.
+==== Edit "onepage\review\item.phtml" ====
+  * Download the file "\app\design\frontend\default\default\template\checkout\onepage\review\item.phtml" via FTP
+  * Open it in Notepad or your favorite HTML editor
+  * Locate the following code around line 49 <code><!-- / --></code>
+  * Add the following code right after that line: <code><?php
+// start code to add
+if($_item->getSbLinkid()) echo $this->helper('subscriptionbridge')->getSbApiWidget($_item->getSbLinkid());
+// end code to add
+?></code>
+  * Save the file and upload it back to the Web server.
+==== Edit "renderer\default.phtml" ====
+  * Download the file "\app\design\frontend\default\default\template\sales\order\items\renderer\default.phtml" via FTP
+  * Open it in Notepad or your favorite HTML editor
+  * Locate the following code around line 29 <code><td><h5 class="title"><?php echo $this->htmlEscape($_item->getName()) ?></h5></code>
+  * Add the following code right after that line: <code><?php
+    // start code to add
+    $_sbOrder = $this->getOrder();
+    $_sbPayment = $_sbOrder->getPayment();
+    if($_sbPayment->getMethod() == 'subscriptionbridge') :
+    	 echo $this->helper('subscriptionbridge')->getSbCustomerCenterLinkDeatils($_sbPayment->getCcTransId(),$_sbOrder->getCustomerEmail());
+    endif;
+    // end code to add
+?></code>
+  * Save the file and upload it back to the Web server.
+===== Other notes =====
+==== Product Type ====
+If you are selling a subscription-based service (i.e. non-shipping, typically non-taxable), make sure to setup the product in Magento as a //Virtual// product. Otherwise Magento will consider it a shipping product. You can't change the product type after creating a product.
+==== Current Limitations ====
+  * One subscription \\ You can only purchase one subscription product/service at a time. The message that informs customers of this scenario can be edited in the Magento administration area.
+  * Either a subscription or regular products \\ You cannot put in the shopping cart, at the same time, a subscription product with one or more regular products. Subscriptions must be purchased separately. The message that informs customers of this scenario can be edited in the Magento administration area.
+  * PayPal Express Checkout \\ PayPal Express Checkout is not supported at this time.