Updating to Venta Theme 1.8.0 (Hyvä Checkout 3 and Magewire 3)
1.8.0 moves Hyvä Checkout from 1.3.15 to 3.0.1 and the checkout from Magewire 1 to Magewire 3 (magewirephp/magewire ~3.7.2), and adds Hyvä's v1bc compatibility module (hyva-themes/magento2-hyva-checkout-v1bc ^1.0.1). If you use Mollie, Hyvä Checkout 3's Mollie integration requires mollie/magento2 ^3.2, mollie/magento2-hyva-checkout ^3.0.4 and mollie/magento2-hyva-compatibility 3.2.0 or newer. If you use Hyvä Commerce, Venta is built against Commerce 1.4. The theme pins Hyvä Checkout 3.0.1 exactly, so the update does not resolve while your root composer.json keeps the 1.7.4 pins. Hyvä PayPal has no Checkout 3 release yet and needs a temporary branch alias. The work is in your child theme's Hyva_Checkout overrides, in project Magewire code on the checkout, and in the root composer.json. Does this affect you? shows what applies to your project.
Recommended reading:
- Updating to 1.7.4, if you are not on it yet
- Hyvä Checkout: Upgrading to 3.0.0, for every upstream change this guide does not list
- Hyvä Checkout: Upgrading to 3.0.1, for compiled Magewire views
- Hyvä Checkout: Migrating to Magewire 3, for porting components and templates
- Hyvä Checkout: v1bc, the backward compatibility module
- Hyvä Checkout changelog
- Hyvä Commerce: Upgrading to 1.4.0, if you run Hyvä Commerce
- File Review, for the override reconciliation routine
Released packages:
| Package | Contains | Changes |
|---|---|---|
magento2-venta-theme 1.8.0 | Templates, layout XML, Tailwind CSS, JS bundle | 1.7.4...1.8.0 |
magento2-venta-theme-module 1.8.0 | PHP classes, plugins, config defaults, seeded content | 1.7.4...1.8.0 |
magento2-venta-theme-smile-elasticsuite-module 1.8.0 | Search templates and scripts | 1.7.4...1.8.0 |
magento2-venta-theme-paypal 2.0.0 | PayPal Express | 1.0.4...2.0.0 |
magento2-venta-theme-back-in-stock-module 1.2.0 | Back in Stock notifications | 1.1.3...1.2.0 |
magento2-venta-theme-user-type-switcher 1.1.0 | Private and Business customer switcher | 1.0.2...1.1.0 |
Known issues in 1.8.0
Theme fixes for 1.8.0 are available as an optional pre-release, and Hyvä PayPal needs a branch alias until Hyvä tags its Checkout 3 release. See Known issues.
Does this affect you?
| Impact | Change | Affects you if |
|---|---|---|
| High | Checkout template overrides | your child theme overrides Hyva_Checkout or Magewirephp_Magewire templates |
| High | Own Magewire components | project or third-party Magewire components run on the checkout |
| High | Hyvä PayPal | you use PayPal Express or extend PaypalExpress |
| Medium | Custom checkout JavaScript | your scripts or Playwright tests use Magewire events or update URLs |
| Medium | Address and guest form customizations | you have form modifiers, AbstractForm subclasses or required custom address attributes |
| Medium | Payment and place-order integrations | a payment module has its own place-order endpoint or activates methods in the browser |
| Medium | Event observers | you observe magewire_* or hyva_checkout_layout_process_before |
| Medium | Removed Venta plugins and changed plugins | project DI or plugins touch Venta's Magewire or checkout plugins |
| Medium | Removed template overrides and layout blocks | your child theme copied them or targets header-content or logo in the checkout |
| Medium | Issuer block removed | code extends Magebit\VentaTheme\Block\Checkout\Payment\Issuer |
| Medium | Search plugin replaced | code extends or disables Plugin\CatalogSearch\ResultPlugin |
| Medium | Hyvä Enterprise checkout | you run the Hyvä Enterprise or B2B checkout modules |
| Medium | Hyvä Commerce 1.4 theme build | you run Hyvä Commerce and your child theme has its own Tailwind config or icons.css |
| Low | Removed Alpine component and event | scripts use hyvaCheckoutAddressListForm or check-terms |
| Low | ACL tree position | roles, fixtures or ADMIN_RESOURCE parents depend on the old Venta ACL position |
| Low | Hyvä email defaults | you run Hyvä Commerce emails with product images or an SVG email logo |
The pre-flight checklist finds most of these in your project.
Backward incompatible changes
Each entry starts with who is affected, then says what breaks and what to do. Upstream changes that a Venta project is not likely to hit are on Hyvä's upgrade page and are not repeated here.
Runtime and Composer
- A root
composer.jsonthat pins the checkout stack - a pin ofhyva-themes/magento2-hyva-checkoutto1.3.15or ofhyva-themes/magento2-hyva-checkout-paypalto^1.2keeps Composer from reaching Checkout 3 or the PayPal Checkout 3 branch. If you use Mollie, a lockedmollie/magento2-hyva-checkout1.x release, even under a*constraint, stays on Checkout 1.3 unless you raise it to^3.0.4and include it in the update, and amollie/magento2pin below^3.2(for example~3.0.2) blocks Hyvä Checkout 3's Mollie integration. If you use Hyvä Commerce, raise a~1.3.0pin to~1.4.0with the update.composer updatealone keeps Checkout at1.3.15. Raise the pins withcomposer require --no-updatein §1, then update with dependencies. Do not use-W.
Checkout templates and project code
Child-theme overrides of
Hyva_Checkouttemplates - Venta ported its own overrides to Magewire 3. Copies in a child theme still use the Magewire 1 API (wire:modeldeferral changes,emitTo,Magewire.hook, deferred components) and no longer match the Checkout 3 templates. Upstream lists 12 new, 56 updated and 4 removed templates in its template changes. Compare each override with Venta's version and with Hyvä Checkout 3.0.1: usewire:model.livewhere you want live sync, anddispatchToinstead ofemitTo. Also review overrides ofmagewire/component/form.phtml,Magento_Customer/form/login-component.phtmland the init JS templates. §2 has the routine.Child copies of templates Venta no longer overrides - Venta drops its overrides of the
Magewirephp_Magewiremessenger, theHyva_Checkoutloader bindings, the Magewire error plugin, the multi-tabs compatibility template and the shippingmethod-activatescripts. Upstream deletedaddress-list/form.phtmlandmulti-tabs-compatibility.phtml. Delete your copies, or port them against the upstream template.Layout XML that targets
header-contentor the defaultlogoblock in the Venta checkouts - both blocks are removed fromhyva_checkout_venta.xml, and the children ofheader-contentgo with it. Targetventa.checkout.headerandventa.checkout.logoinstead.Templates or scripts that use
hyvaCheckoutAddressListFormor listen tocheck-terms- thehyvaCheckoutAddressListFormAlpine component fromaddress-view/address-list.phtmlis no longer defined. Thecheck-termswindow event is no longer dispatched: the merged agreement checkbox accepts all agreements in one Magewire commit.Project or third-party Magewire components on the checkout - Magewire 3 changes the component contract:
- public properties are restored before
boot(), so defaults assigned inboot()overwrite the browser state - the arguments of
updating()andupdated()swap order redirect()returns nothing and drops$paramsdispatchBrowserEvent()needs array data, andemit()takes one associative array- a template that starts with a condition or loop must render its root element unconditionally
- a
<script>added only by a re-render no longer runs - auto-save and
canAutoSave()are gone DataObjectinstances and models in public properties are refused
Port migrated checkout components with
#[HandleBackwardsCompatibility(enabled: false)], useupdatedFoo($value), build redirect URLs withUrlInterface, and move defaults to the property declarations,mount()orbooted(). Hyvä's Magewire 3 migration guide has the details.- public properties are restored before
Custom checkout JavaScript and Playwright tests - on plain Checkout 3,
magewire:loadandmagewire:availableare not dispatched; with v1bc they fire after Alpine. PositionalMagewire.on()parameters arrive as one array. Updates post to/magewire/updatewith acomponentsbody, and Alpine components must register inalpine:init. Register hooks inmagewire:initwith the Magewire 3 names and send named payloads. In Playwright, match/magewire/updateandJSON.parse(options.body).componentsinstead of/livewire/message/<name>. Server-side detection readsgetParam('components').Form modifiers,
AbstractFormsubclasses and required custom address attributes -submit()refuses an empty required field on the server. Modifier listeners typed on 1.x address form classes are skipped. Plainwire:modelstays deferred on the address and guest forms. The 1.3 signatures ofAbstractEntityForm::init,AbstractAddressForm::edit,EvaluationResultFactory::createEventandWithAttributes::removeAttributesStartingWithno longer load. Leave the listener's component parameter untyped, usewire:model.livefor live fields, overriderequiresOnSubmit()to opt a field out, and update the signatures. See Hyvä's customizations that need a change.Observers for
magewire_<event>orhyva_checkout_layout_process_before-magewire_*events fire only whileHyva_CheckoutV1bcis enabled.hyva_checkout_layout_process_beforeis now dispatched, so existing observers of it start running. Venta keeps v1bc enabled. Move observers tohyva_checkout_*or component events before you ever disable it.Payment modules with their own place-order endpoint, client-side method activation, REST totals readers,
stepfirstorsteplaststep names, and Magewire components outside the checkout - Place Order reCAPTCHA applies to checkout placements and to carts whose checkout showed the challenge. The server activates the method saved on the quote after each method list refresh. REST cart totals no longer carry Hyvä's tax details. A checkout or step name ending instepfirstorsteplastis rejected, and Magewire starts only on checkout pages. Guard your own endpoints withPlaceOrderScope::run(), activate methods server-side, rename such steps, and add<update handle="hyva_checkout_magewire_startup"/>to module pages that render components.Projects running
hyva-themes/magento2-ee-hyva-enterprise-checkoutor-b2b- their releases before the Checkout 3 ones need Checkout 1.3. Use the Checkout 3 compatible releases named on Hyvä's upgrade page.
Venta classes and plugins
Code or DI that extends, disables or references Venta's Magewire 1 plugins -
Plugin\Magewire\Component\EmitTotalsChangedEvent(DI nameemit_totals_changed_event),Plugin\Magewire\InjectSvgSprite(DI nameMagebit_VentaTheme::inject_svg_sprite_magewire) andPlugin\Hyva\Checkout\Magewire\Checkout\PriceSummary\RefreshOnTotalsChanged(DI namerefresh_on_totals_changed) no longer exist. The page pluginPlugin\InjectSvgSpritestays. Totals refresh and sprite injection now live inModel/Magewire/Features/. Remove your references.Your own plugins on the same targets as
PreventGuestCheckoutPlugin, the shippingMethodListorTermsConditionsPlugin-PreventGuestCheckoutPluginis now an around plugin. It stops the controller for a refused guest and defers to Hyvä's own refusal when one-page checkout is off.MethodListandTermsConditionsPluginuse the Checkout 3 method list and evaluation result API. Re-test your sibling plugins and their sort orders.Projects that extend
Magewire/Payment/Method/PaypalExpress.phpor pinhyva-themes/magento2-hyva-checkout-paypal- Venta's PayPal Express component follows the Hyvä PayPal Checkout 3 branch: the constructor changes, andedit()andcancel()returnvoid. The Hyvä pluginhyva-paypal-express-redirect-to-reviewis disabled inetc/frontend/di.xml, and the checkout express button sendsbutton=1. Venta's PayPal module requiresmagewirephp/magewire~3.7.2and Hyvä Checkout^3.0.1. The stock Hyvä PayPal 1.2.x requires Checkout^1.3; Hyvä's Checkout 3 branch allows^1.3 || ^3.0. Require the branch as described in §1 and port your override to the new constructor.Code that extends
Magebit\VentaTheme\Block\Checkout\Payment\Issueror callsgetListType()- the class and the method are gone. Mollie's own issuer block selects the template: a list, a dropdown or none, per the method's "Issuer List Type". Use Mollie's block andpayment/mollie_methods_<method>/issuer_list_type.Code that extends or disables
Plugin\CatalogSearch\ResultPlugin- it is replaced byPlugin\Result\Index\RedirectSearchResult. The DI namemagebit_redirect_if_one_resultis kept on Magento's search controller (Magento\CatalogSearch\Controller\Result\Index) and points at the new class there. Venta's own search controller, the one that serves the search page, uses the new DI namemagebit_redirect_search_result, so disablingmagebit_redirect_if_one_resultalone no longer turns the redirect off; disable both names. Smile'ssearch_term_and_single_result_redirectis disabled next toredirect_if_one_result. Re-point your extensions toRedirectSearchResult.Roles, fixtures or
ADMIN_RESOURCEparents that depend on the old top-level ACL position - the Theme and Elasticsuite resources now sit underMagento_Backend::stores>Magento_Backend::stores_settings>Magento_Config::config>Magebit_Core::config(title "Magebit", declared by Venta in bothacl.xmlfiles). The resource ids are unchanged. Saved roles need nothing: the data patchesKeepRoleAccessToThemeAclandKeepRoleAccessToElasticsuiteAclgive them the rows they need onsetup:upgrade.
Emails
Hyvä Commerce stores that show product images in emails built with the Hyvä editor -
hyva_email_templates/email_template/show_product_imagesnow defaults to0, and Venta emails use Magento's classic items table. Set the path to1to bring the thumbnails back.Stores whose only email logo is an SVG, or that have none - the "Venta - Email Logo" block never renders an SVG, because Gmail and Outlook ignore SVG: without a raster email logo or header logo it uses
Magento_Email::logo_email.png. Hyvä's own Header block still falls back to the theme'slogo.svg. Upload a raster email logo under Content > Design > Configuration: edit the store view, then Other Settings > Transactional Emails > Logo Image.
Hyvä Commerce 1.4
Venta covers only the three items below. Everything else is in Hyvä's Commerce 1.4.0 upgrade notes.
Commerce 1.4 deploy -
setup:upgradecan fail withError while checking if topic "hyva.ai_worker.job.chunk" is synchronous. Runbin/magento cache:flushfirst, see §3.Commerce 1.4 with a child theme that has its own
web/tailwind/utilities/icons.css- the Tailwind build fails withCannot apply unknown utility class `after:icon-asterisk`. Copy the@utility icon-asteriskblock from the theme'sicons.css.Commerce 1.4 with
Hyva_LinkedProductsenabled and a child theme that has its ownweb/tailwind/hyva.config.json- the module's unscoped.swatch-optionstyles turn text swatches in the grid listing into bordered boxes. Venta's theme build excludes the module's CSS. Add the same entry toexcludein your file, then rebuild:json{ "src": "vendor/hyva-themes/commerce-module-linked-products/src", "keepSource": true }
Prerequisites
- Venta Theme 1.7.4 with Hyvä Checkout 1.3.15. If you are further back, work through Updating to 1.7.4 first.
hyva-themes/magento2-hyva-checkout3.0.1 andhyva-themes/magento2-hyva-checkout-v1bc1.0.1 installable from your Composer repositories.- Hyvä Commerce 1.4 (
hyva-themes/commerce~1.4.0) if your project runs Hyvä Commerce. - Checkout 3 compatible releases of the Hyvä Enterprise and B2B checkout modules, if you use them.
Pre-flight checklist
Run this while the project is still on 1.7.4, from the project root. Replace app/design and app/code with your theme and module paths if they differ, and include packages installed under vendor/<client>/. The patterns are built from Venta's and Hyvä's sources, not from a client project, so review each hit. Checks 3, 5 and 11 are heuristics and produce false positives.
1. Check your root Composer pins
grep -n -e 'magento2-hyva-checkout' -e 'hyva-themes/commerce' -e 'mollie/' -e 'magewirephp' composer.jsonA pin on Checkout 1.3.15 or Hyvä PayPal ^1.2 blocks the update. With Mollie, a mollie/magento2 pin below ^3.2 or a locked mollie/magento2-hyva-checkout 1.x blocks it too. With Hyvä Commerce, raise a ~1.3.0 pin with the update. Root Composer pins has the fix.
2. Inventory your checkout and Magewire template overrides
find app/design -path '*Hyva_Checkout/*' -type f; find app/design -path '*Magewirephp_Magewire/*' -type fEvery hit is a template to port or delete. See checkout template overrides and removed template overrides. Snapshot the Venta theme package now, before the Composer update, so §2 can list every changed file you override:
cp -R vendor/magebitcom/magento2-venta-theme /tmp/venta-theme-1.7.43. Find Magewire 1 API in project code
grep -rn -e 'emitTo' -e 'emitUp' -e '$wire.emit' -e 'Magewire.hook(' -e 'Magewire.emit' -e 'magewire:load' -e 'magewire:available' -e 'wire:model.defer' -e 'wire:model.lazy' -e 'x-defer' -e 'canAutoSave' -e 'dispatchBrowserEvent' appA hit is code to port. See checkout template overrides, own Magewire components and custom checkout JavaScript.
4. Find references to the removed Venta plugins
grep -rn -e 'Plugin\\Magewire\\Component\\EmitTotalsChangedEvent' -e 'Plugin\\Magewire\\InjectSvgSprite' -e 'RefreshOnTotalsChanged' -e 'emit_totals_changed_event' -e 'inject_svg_sprite_magewire' -e 'refresh_on_totals_changed' appThe page plugin Plugin\InjectSvgSprite is not matched on purpose. A hit is a reference to remove. See removed Venta plugins.
5. Find layout updates on the removed checkout blocks
grep -rn -e 'name="header-content"' -e 'name="logo"' app --include='hyva_checkout*.xml'Review each hit: a logo block also exists outside the checkout. See layout blocks.
6. Find the removed Alpine component and window event
grep -rn -e 'check-terms' -e 'hyvaCheckoutAddressListForm' appSee removed Alpine component and event.
7. Find PayPal Express overrides
grep -rn -e 'PaypalExpress' -e 'hyva-paypal-express-redirect-to-review' appA hit is an override to port to the new constructor, or a reference to the disabled Hyvä plugin. See Hyvä PayPal.
8. Find uses of the removed Issuer block
grep -rn -e 'Checkout\\Payment\\Issuer' -e 'getListType' appSee Issuer block removed.
9. Find extensions of the removed search plugin
grep -rn -e 'CatalogSearch\\ResultPlugin' -e 'magebit_redirect_if_one_result' -e 'magebit_redirect_search_result' app10. Find Magewire and checkout event observers
grep -rn -e 'magewire_' -e 'hyva_checkout_layout_process_before' app --include=events.xmlSee event observers.
11. Find ACL parents and fixtures tied to the Venta tree
grep -rn -e 'Magebit_VentaTheme::' -e 'Magebit_VentaSmileElasticSuite::' app --include='*.xml' --include='*.php'Template references match too. Look only at hits in an acl.xml parent, a fixture or an ADMIN_RESOURCE constant. Saved roles need nothing. See ACL tree position.
12. Check your theme build files for Hyvä Commerce 1.4
grep -n 'linked-products' app/design/frontend/*/*/web/tailwind/hyva.config.json; grep -n 'utility icon-asterisk' app/design/frontend/*/*/web/tailwind/utilities/icons.cssOnly relevant with Hyvä Commerce. An empty result for a file your child theme has means the entry is missing. See icon-asterisk and Linked Products CSS.
What changed
Breaking changes are listed above and not repeated here.
Checkout
- Theme, modules and extensions run on Hyvä Checkout 3.0.1 and Magewire 3. Venta's checkout templates are ported, and the header is the
venta.checkout.headerblock. - Express payments show on the entry step only.
- A zero tax line, a failure dialog, a merged agreement checkbox and a quote item notice follow Checkout 3.
- Custom address attributes get placeholders and field overrides.
- Magewire updates post to
/<store_code>/magewire/updateon store-code URLs. - The cart drawer has an
extra_actionscontainer, which holds the Mollie Apple Pay mini cart button. - Mollie is optional.
Magebit_VentaThemecompiles without it. See Removing Mollie.
Emails
Magebit_VentaThemeprovides blocks and presets for the Hyvä email editor: the blocks "Venta - Email Logo", "Venta - Email Footer Links" and "Venta - Email Social Links", and Venta presets for a Header Template or Footer Template. An admin adds the blocks or starts a template from the preset. The Venta header and footer render the classic frame in Open Sans.Magebit_VentaTheme::email/default_chrome.phtmldraws the Venta header and footer that Hyvä uses as its default header and footer in the editor preview and in newsletters. Header and Footer Templates built from the Venta preset keep their own block tree; edit them in the Hyvä editor.etc/module.xml- the module sequence gainsHyva_EmailTemplates. Stores without Hyvä Commerce stay on classic emails, andsetup:upgradeanddi:compilesucceed.- Emails already built in the Hyvä editor change their look. No email is remapped and no stored content changes.
- Classic footer - the social icons come from
venta_theme/social/*_url, the Shipping Policy link opensshipping-policy, and footer link titles are translated.
Catalog and listing
- Notify Me takes the Add To Cart slot on grid and widget cards, and in list view after an out-of-stock pick. Out-of-stock swatch combinations with no product are disabled, a pick in one card no longer leaks into other cards, and the image blur is fixed.
- With Hyvä Commerce Linked Products, the product page swatches get Venta styling.
- List-mode tier prices show the divider on mobile only and read
<price> per piece. The grid keeps "each". The list layout, spacing and rating stars on loaded pages are fixed. - Infinite scroll uses the
productListPagingStateAlpine component anddata-more-pages. The Show More button is centred, with new mobile spacing. - The product page zoom reuses the framed fullscreen renditions, so it keeps the slide's white frame while gallery white bars are on. Deferred slides use the desktop rendition from 768px unless a tablet row exists.
Search: magento2-venta-theme-smile-elasticsuite-module
- The single-result redirect follows Smile's "Redirect to product page if only one result" (on by default). Search term redirects reach the Elasticsuite tracker, the "only product matching" message shows only after that redirect, and the header search opens the search page directly.
- The popular-term fallback needs
Magebit_VentaSmileElasticSuite. Term links open the search page, andsearch_data.phtmlchanges.
Theme build and scripts
short:andmedium:variants now compile (@custom-variant). The cart drawer hides the cross-sell slider at heights up to 674px, and the checkout summary column changes at 768px and wider when the window is up to 980px tall.- The browser JIT generator keeps its config after a quoted single-star
@sourceglob. - SnapSlider - opt-in drag (
x-snap-slider.drag,data-drag, thedragoption), translatable pager marker labels anddestroy()cleanup. scroll-lock-bleedutility - the page no longer shifts sideways when a drawer, modal or the mobile menu hides the scrollbar.- Directory data (regions, country options, checkout regions and the
directory-datasection) is cached per store and locale. - Playwright - the
MAGENTO_CSP_DEFAULT_STORE_CODEenvironment variable sets the store for the CSP twin store spec.
Smaller packages
- Back in Stock - the "Venta - Back in Stock Products" Hyvä email block and the Stock Alert preset (greeting plus products block, with the same products, prices and unsubscribe links).
- User Type Switcher - requires Hyvä Checkout
^3.0.1. The server also hides the business fields for a Private submission. - PayPal - follows the Hyvä PayPal Checkout 3 branch, see Hyvä PayPal.
- Style Guide - version bump only.
1. Update Composer dependencies
Dev environment and production
Do steps 1 to 3 on a branch in a dev environment and commit composer.json, composer.lock, app/etc/config.php, app/etc/hyva-themes.json and your ported overrides. Deploy through your pipeline and run the sequence there: composer install, setup:upgrade, setup:di:compile, setup:static-content:deploy -f, cache:flush.
Run the commands of this step in one shell session. Each block raises its pins with composer require --no-update and adds the packages to PACKAGES, the list the final composer update moves. Run only the blocks that apply to your project: composer require adds a package the project does not have, and composer update refuses a package the project does not require.
Raise the Hyvä Checkout stack and the two core Venta packages. A plain composer update keeps the old 1.3.15 pin, so the pins change first:
composer require --no-update \
hyva-themes/magento2-hyva-checkout:^3.0.1 \
hyva-themes/magento2-hyva-checkout-v1bc:^1.0.1 \
hyva-themes/magento2-theme-module:^1.3.16 \
magewirephp/magewire:~3.7.2 \
magebitcom/magento2-venta-theme:1.8.0 \
magebitcom/magento2-venta-theme-module:1.8.0
PACKAGES=(
hyva-themes/magento2-hyva-checkout
hyva-themes/magento2-hyva-checkout-v1bc
hyva-themes/magento2-theme-module
magewirephp/magewire
magebitcom/magento2-venta-theme
magebitcom/magento2-venta-theme-module
)If the project uses Mollie:
composer require --no-update \
mollie/magento2:^3.2 \
mollie/magento2-hyva-checkout:^3.0.4
PACKAGES+=(mollie/magento2 mollie/magento2-hyva-checkout)If the project runs Hyvä Commerce:
composer require --no-update hyva-themes/commerce:~1.4.0
PACKAGES+=(hyva-themes/commerce)If the project uses the ElasticSuite module:
composer require --no-update magebitcom/magento2-venta-theme-smile-elasticsuite-module:1.8.0
PACKAGES+=(magebitcom/magento2-venta-theme-smile-elasticsuite-module)If the project uses Back in Stock:
composer require --no-update magebitcom/magento2-venta-theme-back-in-stock-module:1.2.0
PACKAGES+=(magebitcom/magento2-venta-theme-back-in-stock-module)If the project uses the Style Guide:
composer require --no-update magebitcom/magento2-venta-theme-style-guide:1.0.4
PACKAGES+=(magebitcom/magento2-venta-theme-style-guide)If the project uses the User Type Switcher:
composer require --no-update magebitcom/magento2-venta-theme-user-type-switcher:1.1.0
PACKAGES+=(magebitcom/magento2-venta-theme-user-type-switcher)If the project uses PayPal, require Hyvä's PayPal Checkout 3 branch, pinned to the commit Venta 1.8.0 was tested with (see Known issues):
composer require --no-update \
"hyva-themes/magento2-hyva-checkout-paypal:dev-feature/checkout-3-compat#89a3dd8374a8e73319d7ab98bdefc436a2d7673f as 3.0" \
magebitcom/magento2-venta-theme-paypal:2.0.0
PACKAGES+=(hyva-themes/magento2-hyva-checkout-paypal magebitcom/magento2-venta-theme-paypal)Update everything in PACKAGES with its dependencies. Do not use -W:
composer update "${PACKAGES[@]}" --with-dependencies
composer show hyva-themes/magento2-hyva-checkout # must report 3.0.1
composer show magewirephp/magewire # must report 3.7.2 or a later 3.7.x
composer show hyva-themes/magento2-hyva-checkout-v1bc # must report 1.0.1 or newerWith Mollie, composer show mollie/magento2-hyva-compatibility must report 3.2.0 or newer. Review the composer.lock diff before you commit.
Removing Mollie
To remove Mollie, skip the Mollie block above, list hyva-themes/magento2-mollie-theme-bundle, mollie/magento2-hyva-compatibility and mollie/magento2 under replace in the root composer.json, and drop any requirement of your own on mollie/magento2-hyva-checkout. In Venta's own installation these packages provide the modules Hyva_MollieThemeBundle, Mollie_Payment, Mollie_HyvaCompatibility and Mollie_HyvaCheckout. Rebuild the theme afterwards (§3).
2. Port your overrides and project code
Compare the snapshot from pre-flight check 2 with the updated package, and keep the files that exist in your child theme:
THEME=app/design/frontend/<Vendor>/<ProjectTheme>
git -C "$THEME" ls-files | sort > /tmp/overrides.txt
git diff --no-index --name-status /tmp/venta-theme-1.7.4 vendor/magebitcom/magento2-venta-theme \
| awk '{print $NF}' | sed -e 's#^/tmp/venta-theme-1.7.4/##' -e 's#^vendor/magebitcom/magento2-venta-theme/##' \
| sort -u | comm -12 - /tmp/overrides.txtEvery override that check 2 found goes on the list too, whether Venta changed the file or not, because Hyvä Checkout 3 changed the templates underneath it. Work through the list with the File Review routine. What each group needs:
Hyva_Checkout/**andMagewirephp_Magewire/**- port to Magewire 3 per checkout template overrides. Delete the copies listed under removed template overrides.hyva_checkout_venta.xml- retargetheader-contentandlogoper layout blocks.- List-mode product cards and tier prices, infinite scroll pager templates,
search_data.phtml, SnapSlider and the cart drawer - rebase on the vendor files. What changed lists the changes in each.
Then port project PHP, JavaScript, observers and plugins from the checkout and project code entries that pre-flight checks 3 to 11 found.
Alternative: Venta Upgrade Tool
With access to the magebitcom GitHub organization, magebitcom/venta-upgrade-tool does this per file with a three-way merge.
3. Upgrade and deploy
bin/magento cache:flush
bin/magento setup:upgrade
bin/magento setup:di:compileHyvä Commerce
Keep cache:flush before setup:upgrade in your deploy pipeline too.
setup:upgrade enables Hyva_CheckoutV1bc and adds it to app/etc/config.php and app/etc/hyva-themes.json. On a 1.7.4 project this is a new module. Commit both files and keep the module enabled: the Hyvä PayPal Checkout 3 branch renders its scripts in a Magewire 1 container. Projects that ran Hyvä Checkout 3.0.0 or the 1.4.0 beta have Hyva_CheckoutMwv1bc instead, which Hyvä renames to Hyva_CheckoutV1bc.
The same run applies Hyvä's ClearCompiledMagewireViews data patch, which deletes the storefront's compiled Magewire views once. If that fails, it logs a warning and the upgrade goes on. Clear them by hand then:
bin/magento magewire:compile:clear --area=frontendRun that command on every server whose var/magewire the setup:upgrade host does not share, and reset OPcache where it does not check file timestamps.
Rebuild the theme assets in your child theme. The build picks up the ported templates, so it runs after §2:
cd app/design/frontend/<Vendor>/<ProjectTheme>/web/tailwind
npm run build-prodDeploy the rebuilt assets:
bin/magento setup:static-content:deploy -f
bin/magento cache:flush4. Review settings
- Checkout address fields - the address field configuration is the same before and after
setup:upgrade. Verification item 2 checks it. - Single-result search redirect - check Smile's redirect setting, see Search.
- Mollie issuers - check each method's "Issuer List Type", see Issuer block removed.
- Admin roles - nothing to do for saved roles, see ACL tree position.
- Hyvä emails - decide on product thumbnails and the email logo, see email defaults and email logo.
Known issues
Venta Theme 1.8.0 has a few known issues:
- Configurable product cards on category pages lose the tier price table and the quantity input in list mode, and read "each" instead of "per piece" in grid mode.
- The checkout address grid throws an error for customers with two or fewer saved addresses.
- Cart drawer product images shrink next to long product names.
They are fixed in the 1.8.1-rc.1 pre-release. Install it with Composer, or use its changes to build your own vendor patch. The next release includes the same fixes, so this step is optional.
composer require --no-update magebitcom/magento2-venta-theme:1.8.1-rc.1
composer update magebitcom/magento2-venta-themeUse the exact version: with minimum-stability: stable, Composer does not install a pre-release from a version range. Rebuild the theme afterwards (§3).
Hyvä PayPal on Checkout 3
Venta PayPal 2.0.0 requires a Checkout 3 release of hyva-themes/magento2-hyva-checkout-paypal, and Hyvä has not tagged one yet. Until it does, install the Checkout 3 branch at commit 89a3dd8, the commit the Venta 1.8.0 demo runs:
composer require --no-update \
"hyva-themes/magento2-hyva-checkout-paypal:dev-feature/checkout-3-compat#89a3dd8374a8e73319d7ab98bdefc436a2d7673f as 3.0" \
magebitcom/magento2-venta-theme-paypal:2.0.0
composer update hyva-themes/magento2-hyva-checkout-paypal magebitcom/magento2-venta-theme-paypal --with-dependenciesWhen Hyvä tags the release, switch to it:
composer require --no-update hyva-themes/magento2-hyva-checkout-paypal:^3.0
composer update hyva-themes/magento2-hyva-checkout-paypalKnown limitations
These apply to emails built with the Hyvä editor:
- Hyvä writes mapped templates to
design/email/*_template. - Newsletters ignore a mapped Header or Footer Template.
Post-upgrade verification
- The checkout runs on Magewire 3. Open each checkout your stores use. The browser console has no errors, and Magewire requests go to
/<store_code>/magewire/updateon store-code URLs. - Orders place. Place an order as a guest and as a customer with each payment method you offer. The same address fields show and are required as before.
- Totals refresh. Change the shipping method. The price summary updates and the checkout icons render.
- Agreements accept in one go. With terms and conditions on, one checkbox accepts all agreements.
- Express payments show on the entry step only. With PayPal and One-Click Express Checkout on, the express button places the order and shows the success page. With it off, an approved shortcut payment is no longer sent to the separate PayPal review page.
- Mollie issuers render. With Mollie, each method shows a list, a dropdown or nothing, per its "Issuer List Type".
Hyva_CheckoutV1bcis enabled.bin/magento module:status Hyva_CheckoutV1bcreports it enabled, andapp/etc/config.phpandapp/etc/hyva-themes.jsonare committed.- Search redirects. A search with one result opens the product page while Smile's redirect setting is on, and the "only product matching" message shows once.
- Admin roles keep access. A restricted role that had Theme or Elasticsuite access still opens those sections under Stores > Configuration > Magebit.
- Emails render. Send a test order email. Classic emails keep their look, and with Hyvä Commerce an email built from the Venta header and footer presets shows them and a raster logo.
- The theme build passes. With Hyvä Commerce 1.4,
npm run build-prodreports noicon-asteriskerror. With Linked Products, grid listing text swatches are not bordered boxes. - Listing behaves. On a category with out-of-stock products, Notify Me sits in the Add To Cart slot, and the Show More button loads the next page.