Implementing the Rendering

Create Magento App Create ScandiPWA App User Manual GitHub
Search…
Define how your widget appears in the Scandi theme
Now that a <widget> element can appear in the CMS content, we need to implement parsing it and rendering a custom React element in its place. Luckily, as outlined in the intro section, Scandi already parses all CMS content – all we need to do is define a new widget type!
Create a Component
We need to create a Component for the widget. This will just be a regular Scandi React component that takes the widget attributes (only data-title in this case) as props.
To create a new widget, you can just use the ScandiPWA CLI utility:
1
scandipwa create component NewsletterWidget
Copied!
Our widget needs to let the user subscribe to the newsletter. Thankfully, this functionality is already implemented in the NewsletterSubscription component, so we can re-use that. All we need to do is add the widget title. Hence, the implementation is pretty simple:
src/component/NewsletterWidget/NewsletterWidget.component.js
1
/** @namespace TutorialCsaApp/Component/NewsletterWidget/Component/NewsletterWidgetComponent */
2
export class NewsletterWidgetComponent extends PureComponent {
3
    static propTypes = {
4
        'data-title': propTypes.string.isRequired
5
    };
6
​
7
    render() {
8
        const { 'data-title': title } = this.props;
9
​
10
        return (
11
            <div block="NewsletterWidget">
12
                <h2>{ title }</h2>
13
                <NewsletterSubscription />
14
            </div>
15
        );
16
    }
17
}
Copied!
Now we have a component that can render out the Newsletter widget. However, it is not integrated into the Scandi widget system yet. Let's do that next!
Configure the Newsletter Widget
As mentioned in the intro, the WidgetFactory is responsible for determining the widget type and rendering an appropriate component. This mapping is configured in the renderMap:
node_modules/@scandipwa/scandipwa/src/component/WidgetFactory/WidgetFactory.component.js
1
    renderMap = {
2
        [SLIDER]: {
3
            component: HomeSlider,
4
            fallback: this.renderSliderFallback
5
        },
6
        [NEW_PRODUCTS]: {
7
            component: NewProducts
8
        },
9
        [CATALOG_PRODUCT_LIST]: {
10
            component: ProductListWidget
11
        },
12
        [RECENTLY_VIEWED]: {
13
            component: RecentlyViewedWidget
14
        }
15
    };
Copied!
Note that each key is a string constant that corresponds to the widget type. This means that slider-type widgets will use the HomeSlider component, for example.
We want to add our own configuration entry for the newsletter widget. To do this, let's override the WidgetFactory component:
1
scandipwa override component WidgetFactory
Copied!
Only select the WidgetFactory class to override it, and leave the other options blank - we don't need to override anything else!
1
? Choose things to extend in WidgetFactory.component.js WidgetFactory
2
? What would you like to do with styles? Keep
3
? Choose things to extend in WidgetFactory.config.js 
4
​
5
NOTE!
6
​
7
     The following files have been created:
8
     src/component/WidgetFactory/WidgetFactory.component.js
Copied!
Now, we can update the configuration:
src/component/WidgetFactory/WidgetFactory.component.js
1
import NewsletterWidget from 'Component/NewsletterWidget';
2
import {
3
    HomeSlider,
4
    NewProducts,
5
    ProductListWidget,
6
    RecentlyViewedWidget,
7
    WidgetFactory as SourceWidgetFactory
8
} from 'SourceComponent/WidgetFactory/WidgetFactory.component';
9
​
10
import {
11
    CATALOG_PRODUCT_LIST,
12
    NEW_PRODUCTS,
13
    RECENTLY_VIEWED,
14
    SLIDER
15
} from './WidgetFactory.config';
16
​
17
export {
18
    ProductListWidget,
19
    NewProducts,
20
    HomeSlider,
21
    RecentlyViewedWidget
22
};
23
​
24
/** @namespace TutorialCsaApp/Component/WidgetFactory/Component/WidgetFactoryComponent */
25
export class WidgetFactoryComponent extends SourceWidgetFactory {
26
    renderMap = {
27
        [SLIDER]: {
28
            component: HomeSlider,
29
            fallback: this.renderSliderFallback
30
        },
31
        [NEW_PRODUCTS]: {
32
            component: NewProducts
33
        },
34
        [CATALOG_PRODUCT_LIST]: {
35
            component: ProductListWidget
36
        },
37
        [RECENTLY_VIEWED]: {
38
            component: RecentlyViewedWidget
39
        },
40
        newsletter: { // note: "newsletter" is the widget type
41
            component: NewsletterWidget
42
        }
43
    };
44
}
45
​
46
export default WidgetFactoryComponent;
Copied!
Now, if you test out your widget, you should see that it shows up as a title+subscription box! You can now use it anywhere widgets are supported.
Creating a Magento Widget
Next - Tutorials
Video Tutorials
Last modified 10mo ago
Copy link
Contents
Create a Component
Configure the Newsletter Widget