PHOENIX SITE-WIDE BRAND BANNER V1.1
===================================

For CE Phoenix Cart 1.1.0.6 and PHP 8.2.

This small content module displays one responsive banner image above the
navigation bar on every shop page. It uses Phoenix's existing Advert Manager
and makes no core file changes.


INSTALLATION
------------

1. Copy the contents of the catalog folder into the root of your Phoenix shop.
   No existing files are overwritten.

2. In Phoenix Admin, go to Tools > Advert Manager.

3. Create an advert for the banner:
   - Enter a title, such as Brand Banner.
   - Enter a group name, such as BRAND_BANNER.
   - Select or upload the banner image.
   - Leave the URL empty if the banner should not be clickable.
   - Ensure the advert is active.

4. Go to Modules > Content and click Install Module.

5. Install Site-Wide Brand Banner.

6. Edit the module and select the advert group created in step 3.

The banner will now appear above the navigation bar on every shop page. It
fills the normal store width and scales down automatically on smaller screens.
It is outside the standard pale-grey Phoenix header wrapper. While the module
is enabled, the navigation bar is also constrained to the same responsive site
width rather than stretching across the full browser window.


POSITION
--------

The banner is deliberately fixed above the navigation bar. Phoenix content
module sort order cannot move an ordinary header module above the navigation,
so this add-on uses a site-wide hook for the display. The Module Load Order
setting does not alter the banner's visible position.


CHANGING THE BANNER
-------------------

Change the image by editing the advert in Tools > Advert Manager. There is no
need to reinstall or edit this module.

If more than one active advert is placed in the selected group, only the first
advert according to its Advert Manager sort order is displayed.


UPDATING FROM V1.0
------------------

Copy the V1.1 catalog folder over the existing installation. The only changed
file is:

includes/hooks/shop/siteWide/brandBanner.php

There is no need to uninstall or reinstall the content module.


UNINSTALLATION
--------------

Remove Site-Wide Brand Banner from Modules > Content, then delete these files:

includes/modules/content/header/cm_header_brand_banner.php
includes/modules/content/header/templates/tpl_cm_header_brand_banner.php
includes/languages/english/modules/content/header/cm_header_brand_banner.php
includes/hooks/shop/siteWide/brandBanner.php

Removing the module does not delete the banner from Advert Manager.


VERSION HISTORY
---------------

V1.1
- Navigation bar now follows the banner and active store width automatically.
- Supports container-fluid and custom Visual Designer maximum widths.
- Alignment updates automatically when the browser or store width changes.
- Removed the fixed Bootstrap breakpoint width limits used in V1.0.

V1.0
- First public release.
- Responsive, site-wide display of one Advert Manager banner.
- Banner is positioned above the navigation and outside the grey header area.
- Navigation bar is aligned to the same responsive width as the site.
- Optional link inherited from the advert.
- No core file changes.
