Installation

Take a look at deploy/prepare-fork-cms.sh which executes these steps as part of the demo app.

1. Upload the module

Install this module as usual, by copying the Commerce folder from the Backend and Frontend folders to your project.

2. Install dependencies

This module requires extra Composer dependencies, you can install these by running:

composer require tetranz/select2entity-bundle "v2.10.1"
composer require knplabs/knp-snappy-bundle "v1.6.0"
composer require h4cc/wkhtmltopdf-amd64 "^0.12.4"
composer require gedmo/doctrine-extensions "^3.0"
composer require jeroendesloovere/sitemap-bundle "^2.0"
composer require tbbc/money-bundle "^4.1"
composer require mollie/mollie-api-php "^2.0"

# In case you want to load the demo fixtures or run unit tests
composer require --dev doctrine/doctrine-fixtures-bundle
composer require --dev zenstruck/foundry

On macOS you can skip installing h4cc/wkhtmltopdf-amd64 and install wkhtmltopdf using:

brew install --cask wkhtmltopdf

Enable the bundles in your kernel:

// app/AppKernel.php
public function registerBundles()
{
    $bundles = [
        //...
        new \Tetranz\Select2EntityBundle\TetranzSelect2EntityBundle(),
        new \Knp\Bundle\SnappyBundle\KnpSnappyBundle(),
        new \Backend\Modules\Sitemaps\Sitemaps(),
        new \JeroenDesloovere\SitemapBundle\SitemapBundle(),
        new \Tbbc\MoneyBundle\TbbcMoneyBundle(),
    ];
}

Add the wkhtmltopdf path to your config file:

# app/config/config.yml
knp_snappy:
  pdf:
    enabled: true
    binary: %wkhtmltopdf.binary%

And update your parameters.yml with the following:

    # After installing h4cc/wkhtmltopdf-amd64
    wkhtmltopdf.binary: %kernel.root_dir%/../vendor/h4cc/wkhtmltopdf-amd64/bin/wkhtmltopdf-amd64

    # Or when installing wkhtmltopdf via brew on macOS:
    wkhtmltopdf.binary:     /usr/local/bin/wkhtmltopdf

3. Configure LiipImagineBundle filters

Configure the following filters to your config file, to use properly resized images in the frontend.

# app/config/config.yml
liip_imagine:
    filter_sets:
        ...
        product_thumbnail:
            filters:
                auto_rotate: ~
                strip: ~
                scale: { dim: [ 300, 380 ] }
        product_thumbnail_square:
            filters:
                auto_rotate: ~
                strip: ~
                thumbnail: { size: [ 250, 250 ], mode: outbound }
        product_large:
            filters:
                auto_rotate: ~
                strip: ~
                scale: { dim: [ 600, 800 ] }
        product_slider_thumbnail:
            filters:
                auto_rotate: ~
                strip: ~
                scale: { dim: [ 100, 100 ] }

4. Add a Twig extension to parse script/link tags

The frontend theme builds assets to a dist/ folder. To include these assets, Twig can use a manifest.json file. The included ViteAssetExtension.php should help do that. However, a theme cannot register Symfony services (yet), so we have to add it manually to config.yml.

services:
    ...

    # Configure the twig extension for ViteJS to easily switch between dev and prod script tags
    Frontend\Themes\CommerceDemo\ViteAssetExtension:
      autowire: true
      arguments:
        $environment: '%kernel.environment%'
      tags:
        - { name: twig.extension }
        - { name: kernel.event_listener, event: kernel.exception }

Now simply build the frontend:

cd src/Frontend/Themes/CommerceDemo
npm run build # or npm run dev to watch for changes

Start selling

After setting up Mollie or Buckaroo you are able to sell your products!

But to increase sales and SEO we added some tools.

1. Sitemap generator

Install the sitemap generator build bij jeroondesloovere: https://github.com/friends-of-forkcms/fork-cms-module-sitemaps

When you create a Cronjob you should be able to generate a sitemap each day.

2. Google Shopping Feed

When you assign Google Shopping Categories to your categories you would be able to display products in Google Shopping.

Setup is really easy:

1. Assign the right categories
2. Create a cronjob which generates the feed daily, the cronjob command is: php bin/console catalog:generate-merchant-feed
3. Add the feed to your Google Mechant Center
4. Start selling products

This feeds also works for Bing!