PHPackages asdoria/sylius-facet-filter-plugin - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Search & Filtering](/categories/search) 4. / 5. asdoria/sylius-facet-filter-plugin ActiveSylius-plugin[Search & Filtering](/categories/search) asdoria/sylius-facet-filter-plugin ================================== A Simply Facet filter plugin for Sylius 0.1.2(3y ago)127.4k↓33.3%13[1 PRs](https://github.com/asdoria/AsdoriaSyliusFacetFilterPlugin/pulls)1MITPHPPHP ^7.4|^8.0 Since Jul 5Pushed 3y agoCompare [ Source](https://github.com/asdoria/AsdoriaSyliusFacetFilterPlugin)[ Packagist](https://packagist.org/packages/asdoria/sylius-facet-filter-plugin)[ RSS](/packages/asdoria-sylius-facet-filter-plugin/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (3)Dependencies (30)Versions (4)Used By (1) [![Asdoria Lgoo](doc/asdoria.jpg)](doc/asdoria.jpg) Asdoria Facet Filter Bundle =========================== [](#asdoria-facet-filter-bundle) This plugin allows to to link facets to specific resources in your Sylius Shop Sylius offers a system of products' attribute, options and some more. However, there's no native way to only use them on product from specific taxons(categories). This may be a problem when/if you wish to let the user filter your catalog by using these facets. Our plugin allows you to link specific attributes, options and other facets to specific taxons. This way, you can easily decide which filters to display and where Features -------- [](#features) - Create groups of facets - Create customizable facet filters tied to specific products' characteristics - Easily create facet collections - Attach the facet filters to your taxons or other resources [![Example of a product's facets customization](doc/plugin_demo.gif)](doc/plugin_demo.gif) Installation ------------ [](#installation) --- 1. run `composer require asdoria/sylius-facet-filter-plugin` 2. Add the bundle in `config/bundles.php`. You must put it ABOVE `SyliusGridBundle` ``` Asdoria\SyliusFacetFilterPlugin\AsdoriaSyliusFacetFilterPlugin::class => ['all' => true], [...] Sylius\Bundle\GridBundle\SyliusGridBundle::class => ['all' => true], ``` 3. Import routes in `config/routes.yaml` ``` asdoria_facet_filter: resource: "@AsdoriaSyliusFacetFilterPlugin/Resources/config/routing.yaml" prefix: /admin ``` 4. add the facets\_filters filter into you grid config exemple for in `config/packages/grids/sylius_shop_product.yaml` but is already configure into the bundle for this grid ``` sylius_grid: grids: sylius_shop_product: filters: facets_filters: type: facets_filters label: false options: owner: taxon # filterBy: owner | funnel # this option "filterBy" is optional but if you specify funnel, the different filters will be filled with the rest of the filtered products. # this option "filterBy" is optional but if you specify owner, the different filters will be filled with the list of attributes of the category. # This option "filterBy" is optional but if you don't specify it, the different filters will be filled with the list of attributes of all shops. ``` 5. Import the plugin's config and add new config for `sylius.shop.product.index.search` event in `config/packages/_sylius.yaml` ``` imports: - { resource: "@AsdoriaSyliusFacetFilterPlugin/Resources/config/config.yaml"} ... sylius_ui: events: sylius.shop.product.index.search: blocks: search: template: "@SyliusUi/Block/_legacySonataEvent.html.twig" priority: 30 context: event: sylius.shop.product.index.disabled_search ``` 6. Implement the Facet Interface and Trait in your Taxon Entity `App/Entity/Taxonomy/Taxon.php`. ``` // ... use Asdoria\SyliusFacetFilterPlugin\Model\Aware\FacetFilterCodeAwareInterface; use Asdoria\SyliusFacetFilterPlugin\Traits\FacetFilterCodeTrait; use Doctrine\ORM\Mapping as ORM; use Sylius\Component\Core\Model\Taxon as BaseTaxon; use Sylius\Component\Taxonomy\Model\TaxonTranslationInterface; /** * @ORM\Entity * @ORM\Table(name="sylius_taxon") */ class Taxon extends BaseTaxon implements FacetFilterCodeAwareInterface { use FacetFilterCodeTrait; protected function createTranslation(): TaxonTranslationInterface { return new TaxonTranslation(); } } ``` 7. Override or create if not already existing the Taxon Form template in `templates/bundles/SyliusAdminBundle/Taxon/_form.html.twig`. ``` {% from '@SyliusAdmin/Macro/translationForm.html.twig' import translationFormWithSlug %} {{ form_errors(form) }} {{ form_row(form.code) }} {{ form_row(form.parent) }} {{ form_row(form.facetFilterCode) }} {{ form_row(form.enabled) }} {{ translationFormWithSlug(form.translations, '@SyliusAdmin/Taxon/_slugField.html.twig', taxon) }} {% include '@SyliusAdmin/Taxon/_media.html.twig' %} ``` 8. Override or create if not already existing the Product Index template in `templates/bundles/SyliusShopBundle/Product/index.html.twig` ``` {% extends '@SyliusShop/layout.html.twig' %} {% block content %} {% include '@SyliusShop/Product/Index/_header.html.twig' %} {% include '@SyliusShop/Product/Index/_sidebar.html.twig' %} {% include '@SyliusShop/Product/Index/_search.html.twig' %} {% include '@SyliusShop/Product/Index/_main.html.twig' %} {% endblock %} ``` 9. run `php bin/console do:mi:mi` to update the database schema 10. Finally, add translations to `config/packages/translation.yaml` : ``` framework: default_locale: '%locale%' translator: paths: - '%kernel.project_dir%/translations' fallbacks: - '%locale%' - 'en' ``` Demo ---- [](#demo) You can see the result for the user here with caps: [here](https://demo-sylius.asdoria.fr/en_US/taxons/category/caps). If you want to try to create filters, go on [the admin authentication page](https://demo-sylius.asdoria.fr/admin/) and connect with: > **Login:** asdoria > **Password:** asdoria Then go on [facet filters page in back office](https://demo-sylius.asdoria.fr/admin/facet-filters/). Note that we have developed several other open source plugins for Sylius, whose demos and documentation are listed on the [following page](https://asdoria.github.io/). Usage ----- [](#usage) 1. In the back office, inside the `Configuration` section, go to `Facet Filters`. 2. Click on `Edit Groups` and `Create` buttons and create a new one. Fill the fields with a code that will identify your facet group. Of course, this will not be the name on the user side: you can specify a name in each language below in the form. Groups will help you organize your filters and group them when displaying on your site. 3. Once back on the previous page, click on `Configure children` linked to your new facet group. Fill the form in the same way as previously. 4. Return to the `Facet Filter` page, and click `Create` to initialize Filters targetting a specific Taxon. Inside the Code input, enter the code of a taxon you wish to create a filter for. This code can be found in the taxon's edit page at `{your-domain}/admin/taxons/{id}/edit` under Slug. 5. The interesting part begin here. Go on `Facet Filters` page, and click on `Edit facets` associated to your new filter. Several choices are available, let select `Create an attribute facet`. [![Edit facts](doc/editfacets.png)](doc/editfacets.png) You can now fill the form with some cool things such as: - attribute to filter - segment, which represent the filter's group. Obviously, you can change the facet's name for each language to adapt your content by country. 6. Go on the "Taxons" admin page and click on the three grey dots next to each other linked to the category of products you want to filter. Then, click on "Edit" button. [![Taxon interface](doc/taxon.png)](doc/taxon.png) You can choose the facet filter to be used on your products. [![Taxon interface](doc/facetfiltertaxon.png)](doc/facetfiltertaxon.png) 7. Finally, see the results on the user side of your shop! [![Facet filter on taxon page](doc/shop_facet_filter_results.png)](doc/shop_facet_filter_results.png) ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity33 Limited adoption so far Community19 Small or concentrated contributor base Maturity44 Maturing project, gaining track record Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~88 days Total 3 Last Release 1231d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a3c3d21a7e6143706fae64e77ded0b43dd880f3caa348009c1b9177ed51dc4d6?d=identicon)[Asdoria](/maintainers/Asdoria) ![](https://www.gravatar.com/avatar/aeca9135fef7a04d30fb78cb641e4f3eb27cd61e9bf839b153bf17565372af75?d=identicon)[pvasdoria](/maintainers/pvasdoria) --- Top Contributors [![hdasdoria](https://avatars.githubusercontent.com/u/42731924?v=4)](https://github.com/hdasdoria "hdasdoria (5 commits)")[![pvasdoria](https://avatars.githubusercontent.com/u/36963822?v=4)](https://github.com/pvasdoria "pvasdoria (3 commits)")[![anddezu](https://avatars.githubusercontent.com/u/14094625?v=4)](https://github.com/anddezu "anddezu (2 commits)")[![bdasdoria](https://avatars.githubusercontent.com/u/106087927?v=4)](https://github.com/bdasdoria "bdasdoria (2 commits)")[![RemyLasseigne](https://avatars.githubusercontent.com/u/104015106?v=4)](https://github.com/RemyLasseigne "RemyLasseigne (1 commits)") --- Tags ecommercefaceted-searchphpsyliussylius-pluginsyliussylius-pluginasdoriafacet-filtermonofony ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Psalm Type Coverage Yes ### Embed Badge ![Health badge](/badges/asdoria-sylius-facet-filter-plugin/health.svg) ``` [![Health](https://phpackages.com/badges/asdoria-sylius-facet-filter-plugin/health.svg)](https://phpackages.com/packages/asdoria-sylius-facet-filter-plugin) ``` ### Alternatives [monsieurbiz/sylius-search-plugin A search plugin using Elasticsearch for Sylius. 49121.5k](/packages/monsieurbiz-sylius-search-plugin)[webgriffe/sylius-akeneo-plugin Plugin allowing to import products data from Akeneo PIM to your Sylius store. 2477.8k](/packages/webgriffe-sylius-akeneo-plugin)[webgriffe/sylius-table-rate-shipping-plugin Provides table rate shipping calculator. 1490.4k](/packages/webgriffe-sylius-table-rate-shipping-plugin)[asdoria/sylius-product-document-plugin Asdoria Product Document 104.6k](/packages/asdoria-sylius-product-document-plugin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)