Theme PMISuite
The technical addon name is theme_pmisuite.
Odoo 18 storefront presentation and website-editor extensions built on pmis_theme_base. The theme supplies QWeb layouts, SCSS, legacy JavaScript widgets, editor options, and the controllers that render PMISuite-only fragments.
Product, catalog-card and slider offer metadata follows PMIS and OCA price visibility. Quotation-only, zero-priced and hidden prices do not advertise a free offer. Existing quotation actions and native canonical URLs remain intact.
Dependencies
Direct dependencies include OCA's website_sale_product_attribute_value_filter_existing, pmis_theme_base, website_mass_mailing, website_sale_wishlist, website_sale_stock_wishlist, and website_sale_comparison_wishlist.
Brand data and filtering come from OCA's website_sale_product_brand through the base addon. The auto-installed pmis_website_sale_product_brand_fix bridge guards shop responses. PMISuite no longer provides its own brand model, brand listing pages, or brand-slider implementation.
Functionality and Setup
Apply the theme to the target website using Odoo's theme-selection workflow. Installing a theme module and applying it to a website are distinct operations.
Use the website editor for header/footer layouts, shop/product/cart options, product and category snippets, mega-menu styles, ribbons, and image hotspots. Options are defined in templates/theme_customise_option.xml and the editor assets, not solely in the Python models.
Open the website record's Theme PMISuite tab for shared search, stock, B2B, country-selection, pagination, and PWA configuration. See the base addon's README for settings and access restrictions.
Configure products, attributes, categories, pricelists, tabs, and ribbons before using their corresponding snippets or storefront widgets.
The templates extend the shop, product, cart, wishlist, and comparison pages. Frontend widgets implement quick view, similar products, mobile category/search sidebars, cart popovers, sticky product controls, attribute image swatches, collection interactions, and carousel rendering. These widgets depend on the matching template markup and data attributes. Closing a quick view retires pending responses; selecting another product keeps older responses from replacing it. Menu events follow the native widget lifecycle through repeated opening and page editing.
Attribute controls extend OCA's value-filter views. Counts, value search, per-attribute clearing, and “See All” decorate the inherited controls. Attribute expansion reveals already rendered values without replacing OCA's markup. Native select, radio, pills, multi, and color behavior remains available on both desktop and mobile. OCA grouping, selected-value ordering, and manual submission can be enabled separately.
Popup sign-in links use Bootstrap's modal lifecycle, including sticky header copies and keyboard dismissal. Login destinations come from the inherited authentication chain. Buy Now styles the inherited action instead of creating a separate stock decision outside the native purchase controls.
Wishlist and comparison stock labels use the inherited website availability hook, including warehouse selection, fractional stock and backorder rights. Services and untracked goods are not labeled as sold out. Upgrades repair recognized saved quantity and stock-label expressions while retaining customized layouts and their independently stored translations.
Controller Ownership
controllers/main.py inherits the base controller classes and owns these theme-specific routes:
/select_collection_modal_data — public JSON route rendering the collection popup fragment.
/get_product_info — public JSON route rendering the product-pager fragment.
/see_all — public JSON POST route rendering expanded attribute or tag filters, including the mobile attribute variant.
/get-pop-up-product-details — public HTTP route rendering hotspot content.
/search_sidebar_pmis — public HTTP route rendering the search sidebar.
The routes return fragments rather than complete storefront pages. The /see_all count maps pass through the inherited literal-mapping validator; they are display input, not executable expressions or authoritative inventory.
Keeping these controllers here avoids a reverse Python-controller dependency from the base addon to PMISuite-only templates. It does not eliminate every presentation dependency in the base addon.
Developer Map
templates/: server QWeb views and website-editor options, including inheritance of base quick-view/cart placeholders.
static/src/js/frontend/: legacy publicWidget extensions and the bundled Owl Carousel plugin. This directory is loaded by a manifest glob.
static/src/js/editor/ and static/src/js/website_sale_editor.js: editor menu/options, hotspot dragging, and ribbon editing.
static/src/snippets/s_dynamic_snippet_category/options.js: category snippet configuration; product/category RPC behavior lives in the base addon.
static/src/scss/ and static/lib/para_size.scss: storefront styling and helper variables. Odoo bundles provide Bootstrap/Odoo functions and mixins; do not add standalone Sass imports merely to silence IDE notices.
static/src/xml/: browser QWeb templates, separate from server templates.
models/theme_utils.py: disables three custom header views and the first footer view before delegating to Odoo's default theme reset.
static/description/index.html: manually maintained technical Apps description. It is not generated from this README.
Theme view XML IDs may resolve to theme.ir.ui.view definitions. Odoo applies them as website-specific ir.ui.view copies. Use theme.utils and the normal theme workflow rather than treating the definitions as live views.
The dynamic-carousel override delegates base rendering once, then initializes the theme's carousel plugin.
Cart and account interactions
Free-shipping progress follows the selected carrier's rules. Cart popovers show loyalty adjustments without exposing hidden catalog prices. Collections retain hidden products while rendering only the current visitor catalog. Product tabs use native Odoo documents and their guarded download route.
Manual mini-cart opens and automatic cart refreshes share Odoo's latest-request handling. Older fragments cannot replace newer quantity, total, or currency content. Popup login and password reset submit asynchronously with the native CSRF token, block repeated pending submissions, and restore controls on failure.
The theme tab extends the inherited website editor menu. Product ribbon options retain native save, creation, and removal behavior while adding PMISuite positions. Other addons can extend the same position maps and save hooks.
Limits
Applying the theme does not change the shared collection access limitation or provide offline shopping. See Website Collections and Website PWA for their behavior and limits.
The theme uses OCA brands; it supplies no independent brand model, brand listing, or brand-slider implementation. Existing saved pages containing retired snippets are not rewritten automatically. Theme fragment routes require their matching markup and are not general-purpose catalog APIs.
Bug Tracker
Bugs are tracked on PMISuite Repository Issues.
Credits
Contributors
Matjaž Mozetič
Maintainers
Current maintainer:
Luxim is an independent R&D and deployment company focused on solving complex problems in the Odoo ecosystem.
Luxim is an active member of OCA (Odoo Community Association).





