README

Sylius Homepages

This plugins allows you to manage your homepages using the Rich Editor.

If you want to know more about our editor, see the Rich Editor Repository

Compatibility

ℹ️ For Sylius 1.x, see our 1.x branch and all 1.x releases.

Installation

If you want to use our recipes, you can configure your composer.json by running:

composer config --no-plugins --json extra.symfony.endpoint '["https://api.github.com/repos/monsieurbiz/symfony-recipes/contents/index.json?ref=flex/master","flex://defaults"]'

composer require monsieurbiz/sylius-homepage-plugin

If you do not use the recipes :

Change your config/bundles.php file to add the line for the plugin :

<?php

return [
    //..
    MonsieurBiz\SyliusHomepagePlugin\MonsieurBizSyliusHomepagePlugin::class => ['all' => true],
];

Then create the config file in config/packages/monsieurbiz_sylius_homepage_plugin.yaml :

imports:
    - { resource: "@MonsieurBizSyliusHomepagePlugin/Resources/config/config.yaml" }

Finally import the routes in config/routes/monsieurbiz_sylius_homepage_plugin.yaml :

monsieurbiz_sylius_homepage_admin:
    resource: "@MonsieurBizSyliusHomepagePlugin/Resources/config/routes/admin.yaml"
    prefix: /%sylius_admin.path_name%

monsieurbiz_sylius_homepage_homepage:
    path: /{_locale}/
    methods: [GET]
    requirements:
        _locale: ^[a-z]{2}(?:_[A-Z]{2})?$
    defaults:
        _controller: monsieurbiz_homepage.controller.homepage::indexAction
        _sylius:
            template: '@MonsieurBizSyliusHomepagePlugin/Homepage/index.html.twig'
            repository:
                method: findOneByChannelAndLocale
                arguments:
                    - "expr:service('sylius.context.channel').getChannel()"
                    - "expr:service('sylius.context.locale').getLocaleCode()"

Migrations

Make a doctrine migration diff :

bin/console doctrine:migrations:diff

Then run it :

bin/console doctrine:migrations:migrate

Example of homepage

Admin grid

Admin form with preview

Front display

Create custom elements

You can customize and create custom elements in your page.
To do that, you can check the Rich Editor custom element creation

SEO Friendly

You can define for your homepage the meta title, meta description and meta keywords.

Contributing

You can open an issue or a Pull Request if you want! 😘
Thank you!