README

Extended Channels Plugin

Features

Duplicate product and product variant
Bulk action to set categories for products
Mark Taxon as an external link so taxonomy can be used for creating custom menus with links anywhere
Download current exchange rates
Update product prices using downloaded or custom exchange rates
Set channel timezone (see Optional bellow for loading timezones data)
Set channel phone (deprecated, use standard Sylius Contact phone number instead)
Send a copy of order email to a custom email address (BCC) per channel
When SMTP is unavailable, it prevents error 500 on order submit but logs the error and submits the order
Cancel unpaid orders for a certain payment method
Allows changing code for the product and product variant
Administration for Hello Bars (you can use your own types)

Installation

Run $ composer require mangoweb-sylius/sylius-extended-channels.

Add plugin classes to your config/bundles.php:

return [
   ...
   MangoSylius\ExtendedChannelsPlugin\MangoSyliusExtendedChannelsPlugin::class => ['all' => true],
];

Your Entity Channel has to implement \MangoSylius\ExtendedChannelsPlugin\Model\ExtendedChannelInterface. You can use Trait MangoSylius\ExtendedChannelsPlugin\Model\ExtendedChannelTrait.
Your Entity Taxon has to implement \MangoSylius\ExtendedChannelsPlugin\Model\ExternalLinkTaxonInterface. You can use Trait MangoSylius\ExtendedChannelsPlugin\Model\ExternalLinkTaxonTrait.
Add {{ form_row(form.externalLink) }} to template in @SyliusAdmin/Taxon/_form.html.twig.
Replace inner content of <div class="sylius-grid-nav__bulk"> ... </div> with {{ include('@MangoSyliusExtendedChannelsPlugin/Grid/bulkActions.html.twig') }} in @SyliusUi/Grid/Body/_navigation.html.twig.
Replace inner content of <div class="sylius-grid-nav__bulk"> ... </div> with {{ include('@MangoSyliusExtendedChannelsPlugin/Grid/bulkActions.html.twig') }} in @SyliusAdmin/Grid/_default.html.twig.

Add resource to config/packeges/_sylius.yaml

# config/packages/_sylius.yaml
imports:
     ...
     - { resource: "@MangoSyliusExtendedChannelsPlugin/config/resources.yaml" }

Add routing to config/routes.yaml

# config/routes.yaml
mango_extended_channels_plugin:
    resource: "@MangoSyliusExtendedChannelsPlugin/config/routing.yaml"
    prefix: "/%sylius_admin.path_name%"

For guide to use your own entity see Sylius docs - Customizing Models

Optional

Run src/Migrations/basic-data/timezones-data.sql for load the timezones table. (Recommended, otherwise the timezone select will be empty)

Usage

Commands

Updates exchange rates (you need to define currencies first in Sylius admin)
```
mango:exchange-rates:update
```
Update Product prices by exchange rates, from sourceChannel (primary value, won't be changed) to targetChannel. You can run this after the previous command to update by downloaded rates, or you can run it without the previous one to update the prices with your custom exchange rates set in Sylius admin.
```
mango:product:update-price sourceChannel targetChannel
```
Remove orders that are not paid for a configured period and for certain shipping methods. This allows to keep unpaid orders which are e.g. to be paid at personal pickup, therefore needs to stay unpaid for a couple of hours / days. Configuration parameters:
- sylius_order.order_expiration_period
- sylius_order.expiration_method_codes
```
mango:cancel-unpaid-orders
```
You can use events to modify an object when you duplicate it
- mango-sylius-extended-channels.duplicate.product.before-persist
- mango-sylius-extended-channels.duplicate.product.after-persist
- mango-sylius-extended-channels.duplicate.product-variant.before-persist
- mango-sylius-extended-channels.duplicate.product-variant.after-persist
You can use event after bulk category assignment
- mango-sylius-extended-channels.products.after_bulk_categories

You can change the types of Hello bars

parameters:
    mangoweb_sylius_extended_channels_hello_bar_types:
        error: 'Error'
        success: 'Success'
        info: 'Info'
        warning: 'Warning'

Use the Twig function for listing Hello Bars
- mangoweb_sylius_available_hello_bars()
- mangoweb_sylius_available_hello_bars_by_type(type)

Development

Usage

Create symlink from .env.dist to .env or create your own .env file
Develop your plugin in /src
See bin/ for useful commands

Testing

After your changes you must ensure that the tests are still passing.

$ composer install
$ bin/console doctrine:schema:create -e test
$ bin/behat
$ bin/phpstan.sh
$ bin/ecs.sh

License

This library is under the MIT license.

Credits

Developed by manGoweb.

mangoweb-sylius / sylius-extended-channels

Maintainers

Details

README

Extended Channels Plugin

Features

Installation

Optional

Usage

Commands

Development

Usage

Testing

License

Credits