# Prestashop Knowledge Patch > PrestaShop - Skill: `nevaberry/prestashop-knowledge-patch` (Agent Skill, multi-file: 6 files) - Install (CLI): `npx skillmds@latest add nevaberry/prestashop-knowledge-patch` - Raw SKILL.md: https://api.skillmd.com/api/skills/nevaberry/prestashop-knowledge-patch/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - License: MIT - Author: nevaberry (https://skillmd.com/u/nevaberry) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/nevaberry/prestashop-knowledge-patch --- # PrestaShop Knowledge Patch Use this skill when upgrading PrestaShop, developing modules or themes, integrating the Admin API, or checking current storefront and order behavior. Start with the quick references below, then open the task-specific reference for the complete guidance. ## Reference index | Reference | Topics | | --- | --- | | [platform-upgrades-security.md](references/platform-upgrades-security.md) | Runtime and build requirements, Update Assistant, installation and debugging security, maintenance releases, distribution packages | | [themes-storefront-seo.md](references/themes-storefront-seo.md) | Hummingbird, front-office presentation services, media, search, URLs, redirects, and indexing | | [admin-api-extensions.md](references/admin-api-extensions.md) | Admin API, Symfony-rendered back office, hooks, module entities, and Extra Properties | | [catalog-checkout-orders.md](references/catalog-checkout-orders.md) | Product management, experimental discounts and shipments, checkout, payments, countries, and one-page checkout | ## Breaking changes and upgrade checks ### Theme default changed Fresh PrestaShop 9.1 installations use Hummingbird 2.0 instead of Classic. Code that needs the distribution default should call: ```php Theme::getDefaultTheme() ``` Do not hard-code `classic` for that purpose. Theme activation can also unhook modules designated by the theme. ### Legacy product page removed In PrestaShop 9.0.0, the new back-office product page is the only product page; the legacy page has been removed. ### Major-version compatibility PrestaShop 9 is based on Symfony 6.4 LTS. Because it is a major release, existing modules and themes may need compatibility updates and should be tested before a shop upgrade. ### Runtime and build matrix | Context | Requirements | | --- | --- | | PrestaShop 9.0.0 | PHP 8.1 through 8.4 | | PrestaShop 9.1.0 | PHP 8.1 through 8.5; Composer 2; Node.js 20; NPM 10 | | 9.1 core assets | Node.js 20.19.5 by default | ### Upgrade-path constraints Update Assistant 7.6 supports upgrades from 9.0.x to 9.1. It checks installed modules against the target version and automatically uninstalls modules it finds incompatible. Beta and RC1 installations cannot be upgraded to final 9.1 with Update Assistant; they require a fresh installation. Regular module upgrades separate download from installation into two steps in 9.1.0. ## Experimental and prerelease functionality ### Shipment-based order management Feature flags under **Advanced Parameters > New & Experimental Features** expose shipment-based order management for non-production testing in 9.1.0. A single order can have shipments split, merged, and switched between carriers instead of duplicating the order for each carrier. A shipment with a tracking number cannot be split. ### Discount model The feature-flagged 9.1.0 discount system replaces legacy cart rules with four discount types: - Catalog - Cart - Free Shipping - Free Gift It supports priorities, validity dates, automatic or promo-code application, customer and group limits, product-combination selection, and combined product, category, brand, supplier, country, and attribute conditions. Customizable products cannot be selected as free gifts. ### Front-office container An experimental Symfony container is available in the front office as of 9.0.0. Modules using it should treat it as experimental. ### Native one-page checkout PrestaShop 9.2 introduces the native `ps_onepagecheckout` module, placing the entire checkout flow on one page. It first appears in the 9.2 beta and should be treated as prerelease functionality until the stable release. ## Admin API checks PrestaShop 9.0.0 introduces a REST/JSON Admin API built on API Platform for store-management integrations and automation. Endpoint coverage is still a work in progress, so integrations must verify that every required resource and operation is available. In 9.1.0, the Admin API adds a `discountType` endpoint, position-update handling, and refinements to combination endpoints. Integrations targeting the 9.0 API should retest these resources against 9.1. ## Theme migration snapshot Hummingbird in 9.0.0 is optional rather than the default. Its foundation uses: - Bootstrap 5 - TypeScript - BEM naming - a directory layout that moves away from the legacy `_dev` structure - layered SCSS based on CSS `@layer` Bootstrap and PrestaShop-specific styles are separated for overrides. Bootstrap dark mode can be enabled with an SCSS variable. ## Storefront behavior to preserve PrestaShop 9.0.0 adds native WebP and AVIF support, an option to notify a visitor when the viewed product is already in their cart, and guest ordering even when an account already exists. Product breadcrumbs follow the category through which the product was accessed. Search queries accept special characters in 9.1.0. Custom search integrations should preserve them instead of assuming core search rejects or strips them. Product URLs omit the category by default in 9.0.0. Shops can remove the default-language prefix to avoid redirects when another language is added. Inactive categories can issue either 301 or 302 redirects, and filtered product-listing pages are excluded from indexing. ## Extension quick reference PrestaShop 9.1.0 adds `actionUpdateDefaultCombinationAfter` and hooks around: - module enable, disable, and upgrade events - `Configuration::updateValue` - free-shipping price calculation - front-office country or currency selection Doctrine auto-mapping for modules recognizes every subfolder under `src/Entity`, rather than only the first one. PrestaShop 9.2 introduces native Extra Properties. They attach custom data fields to any PrestaShop entity without overrides, support multistore and multilingual data, and are available across the Back Office, Front Office, and Admin API. ## Maintenance CLI PrestaShop 9.1.0 provides console commands for thumbnail regeneration, search indexing, and module-translation export: ```bash php bin/console prestashop:thumbnails:regenerate php bin/console prestashop:search:index php bin/console prestashop:module:export-translations --help ``` ## Security and maintenance snapshot PrestaShop 9.1.0 fixes stored XSS in back-office templates (`GHSA-35pf-37c6-jxjv`), improper use of the validation framework (`GHSA-283w-xf3q-788v`), and exposure of sensitive product attributes in the front office. Ajax controllers are marked `noindex` to keep internal endpoints out of search indexes. PrestaShop 9.1.5 fixes five security issues and closes the 9.1.x release line ahead of 9.2. Shops remaining on the 8.2 branch should update to 8.2.8, which fixes five reported vulnerabilities.