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

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:

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

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:

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.