[TASK] Initial commit

.github/CODEOWNERS

@@ -0,0 +1 @@
+* @Sylius/core-team

.gitignore

@@ -0,0 +1,11 @@
+/vendor/
+/node_modules/
+/composer.lock
+
+/etc/build/*
+!/etc/build/.gitignore
+
+/tests/Application/yarn.lock
+
+/behat.yml
+/phpspec.yml

.travis.yml

@@ -0,0 +1,77 @@
+language: php
+
+dist: trusty
+
+sudo: false
+
+php:
+    - '7.2'
+    - '7.3'
+
+cache:
+    yarn: true
+    directories:
+        - ~/.composer/cache/files
+        - $SYLIUS_CACHE_DIR
+
+env:
+    global:
+        - APP_ENV=test
+        - SYLIUS_CACHE_DIR=$HOME/.sylius-cache
+        - SYLIUS_BUILD_DIR=etc/build
+
+before_install:
+    - phpenv config-rm xdebug.ini
+    - echo "memory_limit=4096M" >> ~/.phpenv/versions/$(phpenv version-name)/etc/conf.d/travis.ini
+    - mkdir -p "${SYLIUS_CACHE_DIR}"
+
+install:
+    - composer install --no-interaction --prefer-dist
+    - (cd tests/Application && yarn install)
+
+before_script:
+    - (cd tests/Application && bin/console doctrine:database:create -vvv)
+    - (cd tests/Application && bin/console doctrine:schema:create -vvv)
+    - (cd tests/Application && bin/console assets:install public -vvv)
+    - (cd tests/Application && bin/console cache:warmup -vvv)
+    - (cd tests/Application && yarn build)
+
+    # Configure display
+    - /sbin/start-stop-daemon --start --quiet --pidfile /tmp/xvfb_99.pid --make-pidfile --background --exec /usr/bin/Xvfb -- :99 -ac -screen 0 1680x1050x16
+    - export DISPLAY=:99
+
+    # Download and configure ChromeDriver
+    - |
+        if [ ! -f $SYLIUS_CACHE_DIR/chromedriver ] || [ "$($SYLIUS_CACHE_DIR/chromedriver --version | grep -c 2.34)" = "0" ]; then
+            curl http://chromedriver.storage.googleapis.com/2.34/chromedriver_linux64.zip > chromedriver.zip
+            unzip chromedriver.zip
+            chmod +x chromedriver
+            mv chromedriver $SYLIUS_CACHE_DIR
+        fi
+
+    # Run ChromeDriver
+    - $SYLIUS_CACHE_DIR/chromedriver > /dev/null 2>&1 &
+
+    # Download and configure Selenium
+    - |
+        if [ ! -f $SYLIUS_CACHE_DIR/selenium.jar ] || [ "$(java -jar $SYLIUS_CACHE_DIR/selenium.jar --version | grep -c 3.4.0)" = "0" ]; then
+            curl http://selenium-release.storage.googleapis.com/3.4/selenium-server-standalone-3.4.0.jar > selenium.jar
+            mv selenium.jar $SYLIUS_CACHE_DIR
+        fi
+
+    # Run Selenium
+    - java -Dwebdriver.chrome.driver=$SYLIUS_CACHE_DIR/chromedriver -jar $SYLIUS_CACHE_DIR/selenium.jar > /dev/null 2>&1 &
+
+    # Run webserver
+    - (cd tests/Application && bin/console server:run 127.0.0.1:8080 --quiet > /dev/null 2>&1 &)
+
+script:
+    - composer validate --strict
+    - vendor/bin/phpstan analyse -c phpstan.neon -l max src/
+
+    - vendor/bin/phpunit
+    - vendor/bin/phpspec run
+    - vendor/bin/behat --strict -vvv --no-interaction || vendor/bin/behat --strict -vvv --no-interaction --rerun
+
+after_failure:
+    - vendor/lakion/mink-debug-extension/travis/tools/upload-textfiles "${SYLIUS_BUILD_DIR}/*.log"

README.md

@@ -0,0 +1,88 @@
+<p align="center">
+    <a href="https://sylius.com" target="_blank">
+        <img src="https://demo.sylius.com/assets/shop/img/logo.png" />
+    </a>
+</p>
+
+<h1 align="center">Plugin Skeleton</h1>
+
+<p align="center">Skeleton for starting Sylius plugins.</p>
+
+## Installation
+
+1. Run `composer create-project sylius/plugin-skeleton ProjectName`.
+
+2. From the plugin skeleton root directory, run the following commands:
+
+    ```bash
+    $ (cd tests/Application && yarn install)
+    $ (cd tests/Application && yarn build)
+    $ (cd tests/Application && bin/console assets:install public -e test)
+
+    $ (cd tests/Application && bin/console doctrine:database:create -e test)
+    $ (cd tests/Application && bin/console doctrine:schema:create -e test)
+    ```
+
+To be able to setup a plugin's database, remember to configure you database credentials in `tests/Application/.env` and `tests/Application/.env.test`.
+
+## Usage
+
+### Running plugin tests
+
+  - PHPUnit
+
+    ```bash
+    $ vendor/bin/phpunit
+    ```
+
+  - PHPSpec
+
+    ```bash
+    $ vendor/bin/phpspec run
+    ```
+
+  - Behat (non-JS scenarios)
+
+    ```bash
+    $ vendor/bin/behat --tags="~@javascript"
+    ```
+
+  - Behat (JS scenarios)
+ 
+    1. Download [Chromedriver](https://sites.google.com/a/chromium.org/chromedriver/)
+    
+    2. Download [Selenium Standalone Server](https://www.seleniumhq.org/download/).
+    
+    2. Run Selenium server with previously downloaded Chromedriver:
+    
+        ```bash
+        $ java -Dwebdriver.chrome.driver=chromedriver -jar selenium-server-standalone.jar
+        ```
+        
+    3. Run test application's webserver on `localhost:8080`:
+
+        ```bash
+        $ (cd tests/Application && bin/console server:run localhost:8080 -d public -e test)
+        ```
+
+    4. Run Behat:
+
+        ```bash
+        $ vendor/bin/behat --tags="@javascript"
+        ```
+
+### Opening Sylius with your plugin
+
+- Using `test` environment:
+
+    ```bash
+    $ (cd tests/Application && bin/console sylius:fixtures:load -e test)
+    $ (cd tests/Application && bin/console server:run -d public -e test)
+    ```
+
+- Using `dev` environment:
+
+    ```bash
+    $ (cd tests/Application && bin/console sylius:fixtures:load -e dev)
+    $ (cd tests/Application && bin/console server:run -d public -e dev)
+    ```

UPGRADE-1.3.md

@@ -0,0 +1,28 @@
+# UPGRADE FROM `v1.2.X` TO `v1.3.0`
+
+## Application
+
+* Run `composer require sylius/sylius:~1.3.0 --no-update`
+
+* Add the following code in your `behat.yml(.dist)` file:
+
+    ```yaml
+    default:
+        extensions:
+            FriendsOfBehat\SymfonyExtension:
+                env_file: ~  
+    ```
+    
+* Incorporate changes from the following files into plugin's test application:
+
+    * [`tests/Application/package.json`](https://github.com/Sylius/PluginSkeleton/blob/1.3/tests/Application/package.json) ([see diff](https://github.com/Sylius/PluginSkeleton/pull/134/files#diff-726e1353c14df7d91379c0dea6b30eef)) 
+    * [`tests/Application/.babelrc`](https://github.com/Sylius/PluginSkeleton/blob/1.3/tests/Application/.babelrc) ([see diff](https://github.com/Sylius/PluginSkeleton/pull/134/files#diff-a2527d9d8ad55460b2272274762c9386))
+    * [`tests/Application/.eslintrc.js`](https://github.com/Sylius/PluginSkeleton/blob/1.3/tests/Application/.eslintrc.js) ([see diff](https://github.com/Sylius/PluginSkeleton/pull/134/files#diff-396c8c412b119deaa7dd84ae28ae04ca))
+
+* Update PHP and JS dependencies by running `composer update` and `(cd tests/Application && yarn upgrade)`
+
+* Clear cache by running `(cd tests/Application && bin/console cache:clear)`
+
+* Install assets by `(cd tests/Application && bin/console assets:install web)` and `(cd tests/Application && yarn build)`
+
+* optionally, remove the build for PHP 7.1. in `.travis.yml`

UPGRADE-1.4.md

@@ -0,0 +1,86 @@
+# UPGRADE FROM `v1.3.X` TO `v1.4.0`
+
+First step is upgrading Sylius with composer
+
+- `composer require sylius/sylius:~1.4.0`
+
+### Test application database
+
+#### Migrations
+
+If you provide migrations with your plugin, take a look at following changes:
+
+* Change base `AbstractMigration` namespace to `Doctrine\Migrations\AbstractMigration`
+* Add `: void` return types to both `up` and `down` functions
+
+#### Schema update
+
+If you don't use migrations, just run `(cd tests/Application && bin/console doctrine:schema:update --force)` to update the test application's database schema.
+
+### Dotenv
+
+* `composer require symfony/dotenv:^4.2 --dev`
+* Follow [Symfony dotenv update guide](https://symfony.com/doc/current/configuration/dot-env-changes.html) to incorporate required changes in `.env` files structure. Remember - they should be done on `tests/Application/` level! Optionally, you can take a look at [corresponding PR](https://github.com/Sylius/PluginSkeleton/pull/156/) introducing these changes in **PluginSkeleton** (this PR also includes changes with Behat - see below)
+
+Don't forget to clear the cache (`tests/Application/bin/console cache:clear`) to be 100% everything is loaded properly.
+
+---
+
+### Behat
+
+If you're using Behat and want to be up-to-date with our configuration
+
+* Update required extensions with `composer require friends-of-behat/symfony-extension:^2.0 friends-of-behat/page-object-extension:^0.3 --dev`
+* Remove extensions that are not needed yet with `composer remove friends-of-behat/context-service-extension friends-of-behat/cross-container-extension friends-of-behat/service-container-extension --dev`
+* Update your `behat.yml` - look at the diff [here](https://github.com/Sylius/Sylius-Standard/pull/322/files#diff-7bde54db60a6e933518d8b61b929edce)
+* Add `SymfonyExtensionBundle` to your `tests/Application/config/bundles.php`:
+    ```php
+    return [
+        //...
+        FriendsOfBehat\SymfonyExtension\Bundle\FriendsOfBehatSymfonyExtensionBundle::class => ['test' => true, 'test_cached' => true],
+    ];
+    ```
+* If you use our Travis CI configuration, follow [these changes](https://github.com/Sylius/PluginSkeleton/pull/156/files#diff-354f30a63fb0907d4ad57269548329e3) introduced in `.travis.yml` file
+* Create `tests/Application/config/services_test.yaml` file with the following code and add these your own Behat services as well:
+    ```yaml
+    imports:
+        - { resource: "../../../vendor/sylius/sylius/src/Sylius/Behat/Resources/config/services.xml" }
+    ```
+* Remove all `__symfony__` prefixes in your Behat services
+* Remove all `<tag name="fob.context_service" />` tags from your Behat services
+* Make your Behat services public by default with `<defaults public="true" />`
+* Change `contexts_services ` in your suite definitions to `contexts`
+* Take a look at [SymfonyExtension UPGRADE guide](https://github.com/FriendsOfBehat/SymfonyExtension/blob/master/UPGRADE-2.0.md) if you have any more problems
+
+### Phpstan
+
+* Fix the container XML path parameter in the `phpstan.neon` file as done [here](https://github.com/Sylius/PluginSkeleton/commit/37fa614dbbcf8eb31b89eaf202b4bd4d89a5c7b3)
+
+# UPGRADE FROM `v1.2.X` TO `v1.4.0`
+
+Firstly, check out the [PluginSkeleton 1.3 upgrade guide](https://github.com/Sylius/PluginSkeleton/blob/1.4/UPGRADE-1.3.md) to update Sylius version step by step.
+To upgrade to Sylius 1.4 follow instructions from [the previous section](https://github.com/Sylius/PluginSkeleton/blob/1.4/UPGRADE-1.4.md#upgrade-from-v13x-to-v140) with following changes:
+
+### Doctrine migrations
+
+* Change namespaces of copied migrations to `Sylius\Migrations`
+
+### Dotenv
+
+* These changes are not required, but can be done as well, if you've changed application directory structure in `1.2.x` to `1.3` update
+
+### Behat
+
+* Add `\FriendsOfBehat\SymfonyExtension\Bundle\FriendsOfBehatSymfonyExtensionBundle()` to your bundles lists in `tests/Application/AppKernel.php` (preferably only in `test` environment)
+* Import Sylius Behat services in `tests/Application/config/config_test.yml` and your own Behat services as well:
+    ```yaml
+    imports:
+        - { resource: "../../../../vendor/sylius/sylius/src/Sylius/Behat/Resources/config/services.xml" }
+    ```
+* Specify test application's kernel path in `behat.yml`:
+    ```yaml
+     FriendsOfBehat\SymfonyExtension:
+        kernel:
+          class: AppKernel
+          path: tests/Application/app/AppKernel.php
+    ```

behat.yml.dist

@@ -0,0 +1,47 @@
+imports:
+    - vendor/sylius/sylius/src/Sylius/Behat/Resources/config/suites.yml
+    - tests/Behat/Resources/suites.yml
+
+default:
+    extensions:
+        Lakion\Behat\MinkDebugExtension:
+            directory: etc/build
+            clean_start: false
+            screenshot: true
+
+        Behat\MinkExtension:
+            files_path: "%paths.base%/vendor/sylius/sylius/src/Sylius/Behat/Resources/fixtures/"
+            base_url: "http://localhost:8080/"
+            default_session: symfony
+            javascript_session: chrome
+            sessions:
+                symfony:
+                    symfony: ~
+                chrome:
+                    selenium2:
+                        browser: chrome
+                        capabilities:
+                            browserName: chrome
+                            browser: chrome
+                            version: ""
+                            marionette: null # https://github.com/Behat/MinkExtension/pull/311
+                            chrome:
+                                switches:
+                                    - "start-fullscreen"
+                                    - "start-maximized"
+                                    - "no-sandbox"
+                firefox:
+                    selenium2:
+                        browser: firefox
+            show_auto: false
+
+        FriendsOfBehat\SymfonyExtension:
+            bootstrap: tests/Application/config/bootstrap.php
+            kernel:
+                class: Tests\Acme\SyliusExamplePlugin\Application\Kernel
+
+        FriendsOfBehat\VariadicExtension: ~
+
+        FriendsOfBehat\SuiteSettingsExtension:
+            paths:
+                - "features"