From e824b35dc546c391b8b0279c9edbcf74b1c8e35b Mon Sep 17 00:00:00 2001
From: Colin Kuskie <colink@perldreamer.com>
Date: Fri, 20 Aug 2010 08:46:52 -0700
Subject: [PATCH] Document what changes need to be made to the PayDriver for
 cart changes in 7.9.4. Change how the upgrade sub dies if a custom plugin is
 found. Fixes bug #11799.

---
 docs/changelog/7.x.x.txt     |  1 +
 docs/gotcha.txt              |  7 +++++++
 lib/WebGUI/Shop/PayDriver.pm | 15 +++++++++++++++
 3 files changed, 23 insertions(+)

diff --git a/docs/changelog/7.x.x.txt b/docs/changelog/7.x.x.txt
index 51b7db24a..68b9efd43 100644
--- a/docs/changelog/7.x.x.txt
+++ b/docs/changelog/7.x.x.txt
@@ -6,6 +6,7 @@
  - fixed #11777: Thingy search on yes no field fails
  - fixed #11787: Gallery resolutions wrongly ordered
  - fixed #11785: Article title / URL with äÄöÖüÜ (reopen #11683)
+ - fixed #11799: 7.8.24->7.9.11 upgrade breaks on custom Paydrivers
 
 7.9.12
  - webgui.org homepage gives 404  (#11778)
diff --git a/docs/gotcha.txt b/docs/gotcha.txt
index 8cffc0eee..5450d3231 100644
--- a/docs/gotcha.txt
+++ b/docs/gotcha.txt
@@ -63,6 +63,13 @@ save you many hours of grief.
      * The Cart will now work without javascript.  Javascript is used to make parts of the cart easier,
      and to automatically update the user's cart so they don't have to manually update it.
 
+     * All custom Payment drivers have to be rewritten.  Please read the POD for
+     WebGUI::Shop::PayDriver for information about the update.  The upgrade script for 7.9.4
+     is designed to die if a non-core payment driver is detected, so after updating your custom
+     driver you will need to change the upgrade script.
+
+     * Custom cart templates will need to be updated to accomodate the new cart design.
+
 7.9.3
 --------------------------------------------------------------------
      * Test:Deep, which had been an optional dependency for testing, has been used
diff --git a/lib/WebGUI/Shop/PayDriver.pm b/lib/WebGUI/Shop/PayDriver.pm
index e33ee7d0d..337127354 100644
--- a/lib/WebGUI/Shop/PayDriver.pm
+++ b/lib/WebGUI/Shop/PayDriver.pm
@@ -783,5 +783,20 @@ sub www_editSave {
     return undef;
 }
 
+=head2 CHANGES ( )
+
+=head3 7.9.4
+
+In 7.9.4, the base PayDriver class was changed to accomodate the new Cart.  The Cart is now in
+charge of gathering billing information.  The PayDriver's job is to summarize all the payment
+information for the user to review (www_getCredentials) and provide the user a button to complete
+the checkout process (getButton), and then to complete the checkout.  PayDrivers can
+do additional things beyond those steps, like the PayPal driver.
+
+PayDrivers also now have a defult template for displaying that screen, the summaryTemplate.
+While each core driver has its own template, custom drivers can use any existing one that
+meets its needs.
+
+=cut
 
 1;