https://github.com/Sylius/AdminOrderCreationPlugin

Create orders in Sylius as an Administrator
https://github.com/Sylius/AdminOrderCreationPlugin

ecommerce hacktoberfest php sylius sylius-plugin symfony

Last synced: 7 days ago
JSON representation

Create orders in Sylius as an Administrator

• Host: GitHub
• URL: https://github.com/Sylius/AdminOrderCreationPlugin
• Owner: Sylius
• License: mit
• Created: 2018-04-17T10:06:27.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2024-06-10T11:52:08.000Z (5 months ago)
• Last Synced: 2024-08-09T22:52:47.520Z (3 months ago)
• Topics: ecommerce, hacktoberfest, php, sylius, sylius-plugin, symfony
• Language: PHP
• Homepage:
• Size: 863 KB
• Stars: 56
• Watchers: 16
• Forks: 50
• Open Issues: 35
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        


    

        

          

          

          

        

    



Admin Order Creation Plugin




This plugin allows to create an order in admin panel.


![Screenshot showing the order creation page, Shipments&Payments section](docs/screenshot.png)

## Business value

So far it was up to the Customer to place an order using available product variants as well as payment and shipping

methods.

The whole process of placing an order is not that obvious, however. For some reason a Customer may feel a little bit

confused when a promotion is no longer available or shipping method is not eligible for given area. Here comes

Admin Order Creation Plugin.

Briefly speaking, it allows an Administrator to place or reorder an order in the name of a Customer. It helps them solve

even more of Customers' fundamental problems and equips an Administrator with basic tools making creating an 

order possible.

Admin Order Creation Plugin processes are strongly based on standard Order model taken from SyliusCoreBundle.

The only things that differ are order creation context and business requirements. Right now it is up to the Administrator

to provide a channel, locale and currency in which an Order is created. What's more, the Administrator is able to add

a discount for any item or the whole Order, which is, technically speaking, a new type of Sylius Adjustments.

After creating an Order via Admin panel, this new Order is listed like any other order placed via Sylius.

## Installation

#### Beware!

> This installation instruction assumes that you're using Symfony Flex. If you don't, take a look at the

[legacy installation instruction](docs/legacy_installation.md). However, we strongly encourage you to use

Symfony Flex, it's much quicker! :)

1. Require plugin with composer:

    ```bash

    composer require sylius/admin-order-creation-plugin

    ```

    

    > Remember to allow community recipes with `composer config extra.symfony.allow-contrib true` or during plugin installation process

2. Copy Sylius templates overridden in plugin to your templates directory (e.g `templates/bundles/`):

    ```bash

    mkdir -p templates/bundles/SyliusAdminBundle/

    cp -R vendor/sylius/admin-order-creation-plugin/src/Resources/views/SyliusAdminBundle/* templates/bundles/SyliusAdminBundle/

    ```

3. Override repositories

   1. Create repository classes

      ```bash

      mkdir src/Repository

      touch src/Repository/CustomerRepository.php

      touch src/Repository/ProductVariantRepository.php

      ```

   2. Paste the following content to the `src/Repository/CustomerRepository.php`:

      ```php