Setup

Storefront Compatibility Package

The Storefront Compatibility Package contains changes to the Adobe Commerce 2.4.7 codebase that enable drop-in component functionality.

Most of these changes enhance the Adobe Commerce GraphQL schema. However, miscellaneous bugfixes are also included. The drop-in components require this package.

Major features

This package defines the following queries and mutations:

confirmCancelOrder mutation - Cancels the specified order for a guest.
confirmReturn mutation - Confirms a guest or customer return request.
estimateTotals mutation - Estimates totals for cart based on the address.
generateCustomerToken mutation - Creates a new customer token.
guestOrder query - Retrieves information about a guest order using an order number, email, and billing last name as input.
guestOrderByToken query - Retrieves information about a guest order based on an order token.
recaptchaFormConfig query - Returns information about the reCaptcha configuration for the specified form type.
requestGuestOrderCancel mutation - Cancels the specified guest order.
requestGuestReturn mutation - Requests a return for a specified order on behalf of a guest.
resendConfirmationEmail mutation - Resends a confirmation email to the specified customer upon request.

Release information

Latest version: 4.7.0

Release date: December 13, 2024

Installation

Cloud infrastructure
On premises

Use this method to install the Storefront Compatibility Package using the Cloud infrastructure.

On your local workstation, change to the project directory for your Adobe Commerce on cloud infrastructure project.
Check out the environment branch to update using the Adobe Commerce Cloud CLI.
Terminal window
```
magento-cloud environment:checkout <environment-id>
```

Add the Storefront Compatibility module.

composer require adobe-commerce/storefront-compatibility

Update package dependencies.

composer update "adobe-commerce/storefront-compatibility"

Commit and push code changes for the composer.json and composer.lock files.
Add, commit, and push the code changes for the composer.json and composer.lock files to the cloud environment
Terminal window
```
git add -A
git commit -m "Add module"
git push origin <branch-name>
```
Pushing the updates to the cloud environment initiates the Commerce cloud deployment process to apply the changes. Check the deployment status from the deploy log.

Use this method to install the Storefront Compatibility Package for an on-premises instance.

Use Composer to add the package module to your project:
Terminal window
```
composer require adobe-commerce/storefront-compatibility
```
Upgrade Adobe Commerce:
Terminal window
```
bin/magento setup:upgrade
```

Update the package

Use the following procedure to update patch versions of the Storefront Compatibility Package.

Run the following command to update the package:
Terminal window
```
composer update adobe-commerce/storefront-compatibility
```
Run the following commands to upgrade Adobe Commerce and clear the cache.
Terminal window
```
bin/magento setup:upgrade && bin/magento cache:clean
```