Documentation
Feedback
Guides
VTEX IO Apps

VTEX IO Apps
Availability Subscriber
vtex.store-components
Version: 3.151.2
Latest version: 3.178.4

This page is about version 3.151.2 of the app, which is not the most recent version. The latest stable version is 3.178.4.

Description

AvailabilitySubscriber is a VTEX Component that shows the availability subscriber form that is shown when the product isn't available. This Component can be imported and used by any VTEX App.

This component only creates a list of the users that subscribe to this product. Currently it doesn't send an automatic email to these users when the product becomes available. It only collects the emails of the users that show interest on the products.

:loudspeaker: Disclaimer: Don't fork this project, use, contribute, or open issue with your feature request.

Table of Contents

Usage

You should follow the usage instruction in the main README.

Then, add availability-subscriber block into your app theme, as we do in our Product Details app.

To collect the emails correctly, this feature needs a special configuration on Master Data. Otherwise, the subscriber form won't be properly saved with user emails. For more info, access the recipe on Creating a product availability form.

Blocks API

When implementing this component as a block, various inner blocks may be available. The following interface lists the available blocks within AvailabilitySubscriber and describes if they are required or optional.


_10
"availability-subscriber": {
_10
"component": "AvailabilitySubscriber"
_10
}

For now this block does not have any required or optional blocks.

Configuration

Before configuring the Availability Subscriber block in your theme, make sure you've already configured a JSON schema in Master Data, otherwise the subscriber form won't be properly saved with user emails. To more info, access the recipe on Creating a product availability form.

  1. Import the vtex.store-component app to your theme's dependencies in the manifest.json;

_10
"dependencies": {
_10
"vtex.store-components": "3.x"
_10
}

  1. Add the availability-subscriber block to your theme’s product template (store.product). For example:

_10
"store.product": {
_10
"children": [
_10
"availability-subscriber”
_10
]
_10
}

Once the block is added, the component will be rendered without the need for further configurations, since the availability-subscriber block does not have any props.

Note the following: the availability-subscriber block simply renders a form component highlighting user interest in a particular product. For the collected emails to actually be stored in the store's Master Data, you’ll need to implement some advanced settings in the Master Data module.

Styles API

You should follow the Styles API instruction in the main README.

CSS Namespaces

Below, we describe the namespace that are defined in the AvailabilitySubscriber.

Class nameDescriptionComponent Source
subscriberContainerAvailabilitySubscriber containerindex
titleAvailabilitySubscriber titleindex
subscribeLabelAvailabilitySubscriber subscribe labelindex
formAvailabilitySubscriber form containerindex
contentAvailabilitySubscriber form content containerindex
inputAvailabilitySubscriber form input containterindex
inputNameAvailabilitySubscriber form input nameindex
inputEmailAvailabilitySubscriber form input emailindex
submitAvailabilitySubscriber form submit buttonindex
successAvailabilitySubscriber success feedback messageindex
errorAvailabilitySubscriber error feedback messageindex
See also
Vtex.store Components
VTEX IO Apps
VTEX App Store
VTEX IO Apps
Was this helpful?