Changes from Dhub (#59)

* Changes from Dhub

* Removed empty asset

---------

Co-authored-by: dhub-sync[bot] <145223974+dhub-sync[bot]@users.noreply.github.com>
Co-authored-by: J2Commerce <olivier@j2commerce.com>

Author: dhub-sync[bot]

…tensions/apps/j2commerce_advancedcart.md …nd-extensions/j2commerce_advancedcart.mdwebsite/docs-v6/apps-and-extensions/apps/j2commerce_advancedcart.md renamed to website/docs-v6/apps-and-extensions/j2commerce_advancedcart.md website/docs-v6/apps-and-extensions/apps/j2commerce_advancedcart.md renamed to website/docs-v6/apps-and-extensions/j2commerce_advancedcart.md

@@ -28,15 +28,21 @@ The plugin works in tandem with the companion **Advanced Cart Toggle** module, w
 
 You can install this **Advanced Cart** App using the Joomla installer. The following steps help you with a successful installation.
 
+:::info
+
+**IMPORTANT**: You will also have to install the **Advanced Cart Toggle** module that came with the package. Once installed, the **Advanced Cart Toggle** will enable itself automatically
+
+:::
+
 In the Joomla admin, go to **System -> Install -> Extensions**
 
 Upload the plugin file or use the Install from URL option.
 
 ![Install extensions](<../../../assets/app install1 (1) (1).webp>)
 
-## Enable the App
+## Enable the Plugin
 
-Once you have installed the App, you will need to enable it. There are **two** ways you can access the extension.&#x20;
+Once you have installed the plugin, you will need to enable it. There are **two** ways you can access the extension.&#x20;
 
 **Option A:** Go to the **J2Commerce** icon at the top right corner **-> Apps**
 
@@ -60,7 +66,7 @@ Select **Advanced Cart Toggle** from the module type list.
 
 ![](/img/advanced-cart-modules1.webp)
 
-Give it a title and assign it to a **module position** in your template (such as a header or navigation position). The most common position is in the upper right corner but every template is different
+Give it a **Title** and assign it to a **module position** in your template (such as a header or navigation position). The most common position is in the upper right corner but every template is different
 
 ![](/img/advanced-cart-modules2.webp)
 
@@ -222,10 +228,24 @@ Go to **Content** -> **Site Modules**, find the **Advanced Cart Toggle** module
 
 **Display Mode:** Whether to show a font icon or a custom image.
 
-**Icon Class:** Font Awesome or custom CSS class for the cart icon. Only visible when Display Mode is set to **Icon**.
+**Icon Class:** Font Awesome or custom CSS class for the cart icon. Only visible when Display Mode is set to **Icon**. The **Icon Class** field accepts any CSS class string your site's template already loads. Common choices: Below are the **Icon Library** and the **Example Class**
+
+![](/img/advanced-toggle-icon.webp)
+
+- **Font Awesome 6 Free:** `fa-solid fa-cart-shopping`
+
+- **Font Awesome 6 Free:** `fa-solid fa-bag-shopping`
+
+- **Font Awesome 6 Free:** `fa-solid fa-basket-shopping`
+
+- **Bootstrap Icons:** `bi bi-cart3`
+
+If your template does not load an icon library automatically, you may need to add one or use **Image** mode instead.
 
 **Cart Image:** Image to display when Display Mode is set to **Image**. Selected using the Joomla media picker.
 
+![](/img/advanced-toggle-image-1.webp)
+
 **Count Type:** Controls what number appears in the badge. **Sum Quantities** adds up the total quantity of all items (e.g., 3 units of one product + 2 of another = 5). **Line Items** counts the number of distinct product lines in the cart. Sum all item quantities, or count the number of distinct line items.
 
 **Hide Badge When Empty:** Hides the count badge entirely when the cart is empty instead of showing a zero.
@@ -244,6 +264,10 @@ Go to **Content** -> **Site Modules**, find the **Advanced Cart Toggle** module
 
 ## How It Works
 
+When the page loads, the module queries the current visitor's cart on the server and renders the badge with the live item count. After the page loads, the Advanced Cart Drawer plugin takes over: any time the cart changes (add, remove, quantity update), the plugin dispatches a browser event that updates all elements with the class `j2commerce-cart-badge` — including the badge from this module — instantly, with no page reload.
+
+Clicking the button calls `AdvancedCart.open()`, which slides the cart drawer into view.
+
 ### Drawer Lifecycle
 
 **When a page loads:**
@@ -278,6 +302,12 @@ All quantity changes made inside the drawer are debounced by 300ms and sent to t
 
 The coupon and voucher fields are collapsed behind toggle links by default. Once a customer clicks "Have a coupon?" or "Have a voucher?", the form expands inline. Applied discounts are shown immediately after the item list and reflected in the totals.
 
+## Placing the Button in a Navbar
+
+Most templates expose a module position inside the navbar — commonly named `nav-right`, `header-right`, `navbar-search`, or similar. Assign the module to that position with **Show Title** set to **Hide** for a clean icon-only button.
+
+If your template does not have a suitable built-in position, you can load the module inline using the `{loadmodule}` content plugin syntax in a Custom HTML module, or ask your template developer to expose an appropriate position.
+
 ## Template Overrides
 
 The drawer uses two PHP layout files: