{"id":24780413,"url":"https://github.com/webgriffe/syliusupgradeplugin","last_synced_at":"2025-10-12T05:30:34.807Z","repository":{"id":39888880,"uuid":"339091115","full_name":"webgriffe/SyliusUpgradePlugin","owner":"webgriffe","description":"This plugin helps you to upgrade your Sylius app to a new version.","archived":false,"fork":false,"pushed_at":"2024-12-16T09:07:35.000Z","size":193,"stargazers_count":12,"open_issues_count":4,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-10T02:33:46.693Z","etag":null,"topics":["sylius","template","theme"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webgriffe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-15T13:45:28.000Z","updated_at":"2024-12-16T09:07:39.000Z","dependencies_parsed_at":"2024-01-15T17:02:11.908Z","dependency_job_id":"920dbb7c-df49-4c9b-ba25-e3dd91a90e34","html_url":"https://github.com/webgriffe/SyliusUpgradePlugin","commit_stats":{"total_commits":71,"total_committers":3,"mean_commits":"23.666666666666668","dds":0.3661971830985915,"last_synced_commit":"624d98317c42eb1e885e04b097aaed5e42a150bf"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webgriffe%2FSyliusUpgradePlugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webgriffe%2FSyliusUpgradePlugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webgriffe%2FSyliusUpgradePlugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webgriffe%2FSyliusUpgradePlugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webgriffe","download_url":"https://codeload.github.com/webgriffe/SyliusUpgradePlugin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236165522,"owners_count":19105652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["sylius","template","theme"],"created_at":"2025-01-29T10:30:29.395Z","updated_at":"2025-10-12T05:30:29.512Z","avatar_url":"https://github.com/webgriffe.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://sylius.com\" target=\"_blank\"\u003e\n        \u003cimg src=\"https://demo.sylius.com/assets/shop/img/logo.png\" /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eUpgrade Plugin\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003eThis plugin helps you to upgrade your Sylius app to a new version.\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/webgriffe/SyliusUpgradePlugin/actions\"\u003e\u003cimg src=\"https://github.com/webgriffe/SyliusUpgradePlugin/workflows/Build/badge.svg\" alt=\"Build Status\" /\u003e\u003c/a\u003e\u003c/p\u003e\n\n\n## Table of Contents\n\n- [Table of Contents](#table-of-contents)\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Usage](#usage)\n- [License](#license)\n- [Credits](#credits)\n\n## Requirements\n\n* PHP `^8.0`\n* Sylius `^1.11.2 || ^1.12 || ^1.13`\n\n## Installation\n\n1. Run `composer require --dev webgriffe/sylius-upgrade-plugin`\n\n2. Add the plugin to the `config/bundles.php` file:\n\n    ```php\n    Webgriffe\\SyliusUpgradePlugin\\WebgriffeSyliusUpgradePlugin::class =\u003e ['dev' =\u003e true, 'test' =\u003e true],\n    ```\n\n## Usage\n\nAll features are implemented as **console commands**.\n\n### Template changes\n\n    bin/console webgriffe:upgrade:template-changes \u003cfrom-version\u003e \u003cto-version\u003e [--theme=PATH_TO_YOUR_THEME] [--legacy] \n\nPrint a list of template files (with extension .html.twig) that changed between two given Sylius versions and that have been overridden in your project: in root \"templates\" folder and/or in a custom theme.\n\nYou have to specify both the versions **from** and **to** you want to compute the changes.\n\nThere are two optional parameters:\n* **--theme=PATH_TO_YOUR_THEME**, specify the theme folder in which to search for changed files. The path must be relative to the **kernel.project_dir** of your project. You can specify multiple themes by repeating the **--theme** parameter, see the related example in the proper section below;\n* **--legacy**, use legacy theme folder structure. From v2.0 of the [SyliusThemeBundle](https://github.com/Sylius/SyliusThemeBundle/) the theme folder structure has changed. The old structure has been deprecated and will be removed in v3.0 as stated [here](https://github.com/Sylius/SyliusThemeBundle/blob/master/UPGRADE.md#upgrade-from-1x-to-20). \n\n\n#### Examples\n\n* List of templates that changed between Sylius v1.8.4 and v1.8.8 and that were overridden in your root **templates** folder:\n\n    ```bash\n    bin/console webgriffe:upgrade:template-changes v1.8.4 v1.8.8\n    ```\n\n* List of templates that changed between Sylius v1.8.8 and v1.9.3 and that were overridden in your root **templates** folder and/or in your **my-website-theme** folder:\n\n    ```bash\n    bin/console webgriffe:upgrade:template-changes v1.8.8 v1.9.3 --theme=themes/my-website-theme\n    ```\n\n* Like the previous example, but it computes changes for multiple themes, one of which is in the vendor folder:\n\n    ```bash\n    bin/console webgriffe:upgrade:template-changes v1.8.8 v1.9.3 --theme=themes/my-website-theme --theme=themes/my-other-theme --theme=vendor/acme/my-vendor-theme\n    ```\n\n### Decorated services changes\n\n    bin/console webgriffe:upgrade:service-changes \u003cfrom-version\u003e \u003cto-version\u003e [--theme=PATH_TO_YOUR_THEME] [--legacy] \n\nPrint a list of services that changed between two given Sylius versions and that have been decorated/overridden in your project.\n\nYou have to specify both the versions **from** and **to** you want to compute the changes.\n\nThere are two optional parameters:\n* **--namespace-prefix=NAMESPACE-PREFIX**, the first part of the namespace of your app services, like \"App\" in \"App\\Calculator\\PriceCalculator\". Default: \"App\".\n* **--alias-prefix=ALIAS-PREFIX**, the first part of the alias of your app services, like \"app\" in \"app.calculator.price\". Default: \"app\".\n\n\n#### Examples\n\n* List of services that changed between Sylius v1.11.0 and v1.13.0 and that were decorated in your project:\n\n    ```bash\n    bin/console webgriffe:upgrade:service-changes v1.11.0 v1.13.0\n    ```\n\n* List of services that changed between Sylius v1.11.0 and v1.13.0 and that were decorated in your project but with custom namespace and alias prefixes:\n\n    ```bash\n    bin/console webgriffe:upgrade:service-changes v1.11.0 v1.13.0 --namespace-prefix=\"Webgriffe\" --alias-prefix=\"webgriffe\"\n    ```\n\n\n## Contributing\n\nTo contribute to this plugin clone this repository, create a branch for your feature or bugfix, do your changes and then make sure al tests are passing.\n\n    ```bash\n    $ (cd tests/Application \u0026\u0026 yarn install)\n    $ (cd tests/Application \u0026\u0026 yarn build)\n    $ (cd tests/Application \u0026\u0026 APP_ENV=test bin/console assets:install public)\n\n    $ (cd tests/Application \u0026\u0026 APP_ENV=test bin/console doctrine:database:create)\n    $ (cd tests/Application \u0026\u0026 APP_ENV=test bin/console doctrine:schema:create)\n    ```\n\nTo be able to setup a plugin's database, remember to configure you database credentials in `tests/Application/.env` and `tests/Application/.env.test`.\n\n### Running plugin tests\n\n  - PHPUnit\n\n    ```bash\n    vendor/bin/phpunit\n    ```\n\n  - PHPSpec\n\n    ```bash\n    vendor/bin/phpspec run\n    ```\n\n  - Static Analysis\n\n    - Psalm\n\n      ```bash\n      vendor/bin/psalm\n      ```\n\n    - PHPStan\n\n      ```bash\n      vendor/bin/phpstan analyse\n      ```\n\n  - Coding Standard\n\n    ```bash\n    vendor/bin/ecs check\n    ```\n\n## License\n\nThis plugin is under the MIT license. See the complete license in the LICENSE file.\n\n## Credits\n\nDeveloped by [Webgriffe®](https://www.webgriffe.com/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebgriffe%2Fsyliusupgradeplugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebgriffe%2Fsyliusupgradeplugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebgriffe%2Fsyliusupgradeplugin/lists"}