> For the complete documentation index, see [llms.txt](https://docs.norrnext.com/osmap-for-phoca-cart/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.norrnext.com/osmap-for-phoca-cart/osmap-for-phoca-cart.md).

# OSMap for Phoca Cart

{% embed url="<https://norrnext.com/ecommerce/phoca-cart/phoca-cart-sitemap-for-osmap>" %}

### System Requirements

| Minimal         | Recommended     |
| --------------- | --------------- |
| Joomla 5.4.x+   | Joomla 6.1.x+   |
| Phoca Cart 6.x+ | Phoca Cart 6.1+ |

### Installation

This plugin can be installed as a standard Joomla plugin.

[How to install an extension](https://docs.norrnext.com/joomla-tutorials/how-to-install-an-extension)\
[How to enable one-click update for NorrNext commercial extensions](https://docs.norrnext.com/joomla-tutorials/how-to-enable-one-click-update-for-norrnext-commercial-extensions)

When a menu item pointing to Phoca Cart (Categories, Category, or Items view) is selected in OSMap sitemap settings, this plugin automatically expands the menu item into full categories, products, and optional manufacturer trees in both HTML and XML sitemaps.

### Plugin Settings

The plugin parameters can be configured under the plugin settings page (**Extensions -> Plugins -> OSMap - Phoca Cart Integration**).

#### Basic Options

**Root category ID** — The parent ID used to find top level categories when expanding the shop's home (Categories) menu item. Default: `0`.

**Expand categories** — *Never* / *Always* / *XML sitemap only* / *HTML sitemap only*. Controls whether Phoca Cart categories are expanded into the sitemap. Default: *Always*.

**Maximum category level** — *All* / *1* to *10*. Limits the maximum depth level when expanding subcategories. Default: *All*.

**Category ordering column** — *Ordering* / *Title* / *ID*. Defines the sorting column for categories in the sitemap. Default: *Ordering*.

**Expand products** — *Never* / *Always* / *XML sitemap only* / *HTML sitemap only*. Controls whether Phoca Cart products are added to the sitemap under their categories. Default: *Always*.

**Products: only show under their main category** — *Yes* / *No*. If set to *Yes*, products are matched using the product's single `catid` field. Keep set to *No* (recommended) unless `catid` is reliably set for every product; setting to *No* uses the Phoca Cart categories mapping table, ensuring multi-category products are correctly nested under their assigned categories. Default: *No*.

**Products ordering column** — *Ordering* / *Title* / *Created date* / *Modified date* / *ID*. Sorting column for products within categories. Default: *Ordering*.

**Maximum products per category (0 = no limit)** — Limits how many products are listed for each category (and for the 'All products' listing). Use `0` for no limit. Default: `0`.

**Expand manufacturers** — *Never* / *Always* / *XML sitemap only* / *HTML sitemap only*. Off by default. Controls whether manufacturer filter pages are exposed as extra leaf nodes in the sitemap. Default: *Never*.

**Manufacturer filter parameter name** — The GET parameter Phoca Cart uses to filter products by manufacturer on the Items view. Must match the 'Manufacturer Alias' setting configured in Phoca Cart Options > Filter. Default: `manufacturer`.

**Manufacturers ordering column** — *Ordering* / *Title* / *ID*. Sorting column for manufacturers. Default: *Ordering*.

**Show links only visible to some users** — *Never* / *Always*. If enabled (*Always*), categories and products restricted by access level will still be added to the sitemap. Default: *Never*.

**News keywords** — *Meta keywords* / *None*. Controls whether product meta keywords are included in news sitemap output. Default: *Meta keywords*.

#### XML Sitemap Settings

**Category priority** — Priority value (`0.0` to `1.0`) for category URLs in the XML sitemap, or *Use parent menu item value* (`-1`). Default: *Use parent menu item value*.

**Category change frequency** — *Always* / *Hourly* / *Daily* / *Weekly* / *Monthly* / *Yearly* / *Never*, or *Use parent menu item value* (`-1`). Default: *Use parent menu item value*.

**Product priority** — Priority value (`0.0` to `1.0`) for product URLs in the XML sitemap, or *Use parent menu item value* (`-1`). Default: *Use parent menu item value*.

**Product change frequency** — *Always* / *Hourly* / *Daily* / *Weekly* / *Monthly* / *Yearly* / *Never*, or *Use parent menu item value* (`-1`). Default: *Use parent menu item value*.

**Manufacturer priority** — Priority value (`0.0` to `1.0`) for manufacturer filter URLs in the XML sitemap, or *Use parent menu item value* (`-1`). Default: *Use parent menu item value*.

**Manufacturer change frequency** — *Always* / *Hourly* / *Daily* / *Weekly* / *Monthly* / *Yearly* / *Never*, or *Use parent menu item value* (`-1`). Default: *Use parent menu item value*.

**Add product images** — *Yes* / *No*. Adds the product's main image to the XML image sitemap. Default: *No*.

**Product images base path** — Relative path (from the site root) where Phoca Cart stores full-size product images. Default: `images/phocacartproducts/`.