PRODUCT DESCRIPTION COMMENTS V1.0 — COMPLETE PACKAGE
Standalone add-on for CE Phoenix Cart
Released under GNU GPL v2 or later

INSTALLATION — NEW INSTALL
1. Back up your files and database.
2. Upload the CONTENTS of catalog to your shop root.
3. Upload the CONTENTS of admin to your actual admin directory
   (for example November). Do not create a second admin directory.
   No Phoenix or Easy Product Manager core files are changed.
4. Open Catalog > Product Description Comments in admin.
   If the menu needs refreshing, sign out and back in. Alternatively open
   product_description_comments.php directly inside your admin directory.
5. Click Install Product Description Comments to create the independent
   product_description_comments table.
6. Add your comments with short button labels and leave Enabled ticked.
7. Open the product editor, or hard refresh it with Ctrl+F5.

UPGRADE FROM THE V1.0 TEST PACKAGE / PATCHES
Upload both folders as above, overwriting the add-on files. No reinstall or
SQL update is needed. Existing saved comments remain intact. Hard refresh
any open product editors with Ctrl+F5.
This complete package includes all the fixes; no separate patches are needed.

USING COMMENTS
Each supported description or long-description field has a row of comment
buttons immediately above it. Place the text cursor where you want the text,
then click a comment button. There is no popup selection step.
Buttons wrap onto additional rows if needed; hover to see the comment text.
Selecting existing text first replaces that selection.
Save/Update the product using the editor's normal controls afterwards.
Clicking a comment button does not itself save the product.
TinyMCE users can use the editor's normal Undo control after inserting.
Close any TinyMCE source-code popup before using the comment buttons.

MANAGING COMMENTS
Use Catalog > Product Description Comments to add, edit or delete comments.
Lower sort-order numbers appear first. Untick Enabled to hide a comment.
Reload open product editor pages after changing saved comments.
Each product field has its own insertion position. Language fields have their
own button rows; create separate saved comments for different languages.
Editing a template affects future insertions only. Product descriptions
already saved are not changed.

FORMATTING
Choose Plain text for ordinary comments. In TinyMCE, special characters are
escaped and new lines become line breaks. Raw textareas receive plain text
with its original line breaks.
Choose Formatted HTML for formatted blocks. For example:
<p><strong>Delivery information</strong></p>
<p>Please allow 3–5 working days for delivery.</p>
<ul><li>First point</li><li>Second point</li></ul>
<a href="https://example.com/instructions">View instructions</a>

Portable formatting tags and safe web/email/telephone links are supported.
Scripts, images, embedded media, inline styles, classes, event handlers and
unsafe links are removed during insertion. No placeholders are evaluated.

COMPATIBILITY
Supports the native Phoenix catalog.php product editor, older categories.php
product editors, and Easy Product Manager (easy_products.php).
Works with plain textareas and TinyMCE description editors, including existing
long-description fields. It does not create a long-description field.
SEO description fields are excluded.
The add-on is independent of Admin Comments and AOM; neither is required.
EPM is optional. No core file changes are required.

REMOVAL
Delete only the six add-on PHP/JavaScript files listed in FILES.txt.
Existing product descriptions remain unchanged. Retain the saved comments
table for reinstalling, or remove it only if you want to delete the templates.
