CUSTOMER BASKET MANAGER V1.0 — COMPLETE PACKAGE
CE Phoenix Cart 1.1.0.6 / PHP 8.2
12 November 2026

Includes the product-selection fix, clearer wording, author/licence headers
and the dedicated add-on language file.
No separate patches are needed.

INSTALL OR UPDATE
1. Back up your site files and database.
2. Upload the CONTENTS of catalog/ into the shop root, merging includes/ with
   the existing directory. Do not create a folder called catalog.
3. Upload the CONTENTS of admin/ into your actual administration directory.
   The package folder admin is a placeholder for your chosen admin folder.
4. Open Tools > Customer Basket Manager in Phoenix admin. If the menu entry
   is not visible, open customer_baskets.php in your administration directory.
5. NEW INSTALLATIONS ONLY: press Install Basket Manager.
   Existing installations need no database changes or reinstallation.

This package adds six PHP files and replaces no Phoenix core files. The three
add-on tables are cbm_jobs, cbm_links and cbm_redemptions. The installer requires
both existing core basket tables to use InnoDB for transaction safety; it does
not change their storage engines.

ADD PRODUCTS TO A REGISTERED CUSTOMER'S BASKET
1. Search for a customer by name, email or ID and select them.
2. Search for a product by name, model or ID and click its name.
3. Choose the quantity and any required product options.
4. Press Add to this customer's basket.
5. Check Basket changes below for its status.

Waiting for customer: the change is saved, ready for their next browsing visit.
Basket updated: the change has been completed.
Could not update basket: the change failed; the reason appears alongside it.
Cancelled: the change was stopped before it took effect.

The customer's basket updates when they next open a normal browsing page while
logged in, including the basket, home, product, account or search-results page.
A logged-out customer must log in first. Changes wait if the customer is already
checking out; checkout and payment-processing requests are deliberately skipped.
Up to 100 waiting changes are handled per eligible request, in creation order.

This customer's saved basket shows items currently stored by Phoenix. Changes
still waiting are listed separately. It does not display an anonymous guest's
browser basket or guarantee that another browser has saved its latest changes.

Use Save new quantity or Remove from basket to request changes to existing
items. You can cancel a change while it is still waiting. To change product
options, request removal of the old line and add the replacement with the new
options. Completed changes require a new change to reverse them.

CREATE A BASKET LINK — REGISTERED CUSTOMERS OR GUESTS
1. You can skip customer selection.
2. Choose a product, quantity and options, then press Add to basket-link list.
3. Repeat until the list contains the products you want to send.
4. Under Build a basket link, enter a customer-facing title and validity period
   of 1–90 days (default 7), then press Create basket link.
5. Copy the resulting link and send it yourself. No email is sent automatically.
6. The customer opens the link, reviews the items and presses Add these items
   to my basket, then completes the normal checkout.

Opening a link alone changes nothing. Existing basket items stay in place;
matching items have their quantities added together. Prices, quantities,
delivery and payment can be reviewed through the usual basket and checkout.
Guest checkout must already be available on your site; this tool does not
install it.

Links can be used by different people until they expire or you turn them off.
Repeat additions are blocked within the same PHP browser session, including
refreshes and double clicks. A new browser session can use the link again.
These are reusable basket links, not single-use payment links or vouchers.
Turning off a link blocks further additions but does not remove items already
added. Anyone with the link can see its title, products and option text; avoid
including personal information. Tokens use 256 bits of randomness.

PRODUCT OPTIONS AND CHECKOUT
Native dropdown attributes are supported. Option Types V2 radio and selection
options appear as dropdowns in admin; checkbox options can be left at None.
Option Types V2 text/textarea values are supported with character limits and
are retained when changing quantities. This tool requires text values.
Products requiring file uploads must be added through their normal product
page. They are blocked in this tool. Existing saved file-option lines can
still have their quantity changed or be removed.

This package retains your installed cart and Option Types V2 files. It does
not include or replace the Option Types V2 cart override.

Current Phoenix prices and product-option prices apply. The tool stores no
custom prices, discounts, shipping quotes or stock reservations. Normal stock
checks and checkout rules still apply. Shipping, payment and cart confirmation
are invalidated when a basket change is applied so the customer confirms them
again. No customer account is impersonated.

TESTING
PHP 8.2 syntax checks and simulated-database integration checks have passed
against the Phoenix 1.1.0.6 standard cart and the supplied Option Types V2 cart.
The checks covered quantity merging, native attributes, text preservation,
invalid input, product availability, CSRF, transaction/session rollback,
customer additions, skipping payment-processing requests, and the corrected
product-selection link encoding. The user confirmed the link fix works.
These checks do not replace live MariaDB, browser and payment-gateway testing
with the exact add-ons on your site.

Before live use, check a plain product, attributes, a text-option product,
quantity changes and removal; verify changes for a logged-in customer and one
who logs in later. Test a basket link in a guest window, repeat opening it,
turn it off, and complete a test checkout using your usual checkout modules.

UNINSTALL
Cancel waiting changes and turn off active links first. Remove only:
  shop/prepared_basket.php
  shop/includes/classes/prepared_baskets.php
  shop/includes/languages/english/customer_basket_manager.php
  shop/includes/hooks/shop/system/_22zCustomerBasket.php
  your-admin/customer_baskets.php
  your-admin/includes/boxes/tools_customer_baskets.php
The three cbm_* tables can be kept as history or dropped after backup.
Remove any translated copies of customer_basket_manager.php too.
Items already added to customer baskets are not removed by uninstalling.

LANGUAGES AND AUTHORSHIP
Author: Mort-Lemur. Every PHP file includes the author, version and GPL notice.
All add-on wording is in:
  catalog/includes/languages/english/customer_basket_manager.php
Upload this to includes/languages/english/ in the shop root. It supplies the
admin screen, Tools menu, customer page, buttons and validation messages.
See TRANSLATING.txt for adding other languages. English is the fallback for a
missing language file or individual entry. No changes to core language files
are needed. Product names/options and customer-entered basket titles continue
to use the existing product data and saved text. Older saved error messages
remain as originally recorded; new add-on failures can be displayed in the
admin's selected language.

Validation also covered language switching, partial/missing translations,
format placeholders, translated validation, Tools-menu translation, stored
failure translation, header presence and language-key coverage.

LICENSE
GPL-2.0-or-later.
