X-Sell for CE Phoenix Cart V1.0 - Installation
===============================================

Requirements
------------
* CE Phoenix Cart 1.1.0.6
* PHP 8.2

New installation
----------------
1. Back up the Phoenix files and database.
2. Copy the contents of the catalog folder into the matching Phoenix catalog
   folder. Rename the package's "admin" folder first if your admin directory
   has a different name.
3. Sign in to Phoenix Admin.
4. Open Cross-Sell > Install / Check and click "Install / Check Table".
5. Open Modules > Content, select the Product Info group, install
   "Cross-Sell Products", and set its options.
6. Open Cross-Sell > Cross-Sell Products, search for the main product and
   click "Add / Manage Cross-Sells" to assign recommendations.

Migration from X-Sell for osCommerce 2.3.1
------------------------------------------
The Phoenix version intentionally uses the original table and columns:

  products_xsell.ID
  products_xsell.products_id
  products_xsell.xsell_id
  products_xsell.sort_order

Import the old products_xsell table/data into the Phoenix database after the
products have been migrated and their product IDs have been preserved. Then
open Cross-Sell > Install / Check. The installer does not drop or empty an
existing table.

Do not run the SQL file from the old package on Phoenix: it begins with
DROP TABLE and would delete existing relationships.

Upgrade / file replacement
--------------------------
Copy the catalog folder over the existing V1.0 files. Cross-sell data and
content-module settings are not changed by replacing files.

Uninstall
---------
To stop displaying cross-sells, uninstall Cross-Sell Products from
Modules > Content. This preserves the products_xsell table and all links.

To permanently delete all cross-sell data, open Cross-Sell > Install / Check,
tick the explicit confirmation box, then click "Delete Cross-Sell Data".
This cannot be undone without restoring a database backup.

No Phoenix core files are changed by this package.
