PHPackages                             3brs/sylius-contact-form-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. [Utility &amp; Helpers](/categories/utility)
4. /
5. 3brs/sylius-contact-form-plugin

ActiveSylius-plugin[Utility &amp; Helpers](/categories/utility)

3brs/sylius-contact-form-plugin
===============================

Contact form plugin for Sylius.

v2.0.1(8mo ago)42194[1 PRs](https://github.com/3BRS/sylius-contact-form-plugin/pulls)MITPHPPHP ^8.2

Since Nov 29Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/3BRS/sylius-contact-form-plugin)[ Packagist](https://packagist.org/packages/3brs/sylius-contact-form-plugin)[ RSS](/packages/3brs-sylius-contact-form-plugin/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)Dependencies (39)Versions (9)Used By (0)

 [ ![](https://camo.githubusercontent.com/bb0c16caf210bea68e0e59fc11e0844dc47097f9aeb8b388c3de5f1414d4d1c0/68747470733a2f2f33627273312e667261312e63646e2e6469676974616c6f6365616e7370616365732e636f6d2f336272732f6c6f676f2f334252532d6c6f676f2d73796c6975732d3230302e706e67) ](https://www.3brs.com)

Contact Form Plugin
 [ ![](https://camo.githubusercontent.com/326db36cd77a1d8a8f62f6d53c12d4f160b88714df26f7d3b9d9381b4b778002/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f336272732f73796c6975732d636f6e746163742d666f726d2d706c7567696e2e737667) ](https://packagist.org/packages/3brs/sylius-contact-form-plugin "License") [ ![](https://camo.githubusercontent.com/bbf8b953ef0bc698f8f544d8e4975e03d900f0f5757fd64a110f055860f64131/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f336272732f73796c6975732d636f6e746163742d666f726d2d706c7567696e2e737667) ](https://packagist.org/packages/3brs/sylius-contact-form-plugin "Version") [ ![](https://camo.githubusercontent.com/6042e2e89e36522078a0e3aabc1de71e12837fa3e6fe90d43cfa857621c6b1f4/68747470733a2f2f636972636c6563692e636f6d2f67682f334252532f73796c6975732d636f6e746163742d666f726d2d706c7567696e2e7376673f7374796c653d736869656c64) ](https://circleci.com/gh/3BRS/sylius-contact-form-plugin "Build status")
===================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#contact-form-plugin------------------------------------------------)

Features
--------

[](#features)

- Extend contact form
- Add a ReCaptcha Verification to the contact form (only supports invisible ReCaptcha V2)
- Add Message administrative panel
    - conversation history
    - Possibility to respond instantly

 [![](https://github.com/3BRS/sylius-contact-form-plugin/raw/sylius_2_upgrade_AK/doc/contact_form.PNG?raw=true)](https://github.com/3BRS/sylius-contact-form-plugin/blob/sylius_2_upgrade_AK/doc/contact_form.PNG?raw=true)

 [![](https://github.com/3BRS/sylius-contact-form-plugin/raw/sylius_2_upgrade_AK/doc/messages_management_admin_menu.PNG?raw=true)](https://github.com/3BRS/sylius-contact-form-plugin/blob/sylius_2_upgrade_AK/doc/messages_management_admin_menu.PNG?raw=true)

 [![](https://github.com/3BRS/sylius-contact-form-plugin/raw/sylius_2_upgrade_AK/doc/messages_management_admin_answer_menu.PNG?raw=true)](https://github.com/3BRS/sylius-contact-form-plugin/blob/sylius_2_upgrade_AK/doc/messages_management_admin_answer_menu.PNG?raw=true)

 [![](https://github.com/3BRS/sylius-contact-form-plugin/raw/sylius_2_upgrade_AK/doc/messages_management_account_menu.PNG?raw=true)](https://github.com/3BRS/sylius-contact-form-plugin/blob/sylius_2_upgrade_AK/doc/messages_management_account_menu.PNG?raw=true)

Installation
------------

[](#installation)

1. Run `composer require 3brs/sylius-contact-form-plugin`.
2. Register `\ThreeBRS\SyliusContactFormPlugin\ThreeBRSSyliusContactFormPlugin` in your Kernel.

    ```
    // config/bundles.php
    ThreeBRS\SyliusContactFormPlugin\ThreeBRSSyliusContactFormPlugin::class => ['all' => true],
    ```
3. Add resource to `config/packages/_sylius.yaml`

    ```
    imports:
         # ...
         - { resource: "@ThreeBRSSyliusContactFormPlugin/config/config.yml" }
    ```
4. Add routing to `config/routes.yaml`

    ```
    threebrs_sylius_contact_form_plugin:
        resource: "@ThreeBRSSyliusContactFormPlugin/config/routing.yml"
    ```
5. Define parameters in `.env` file (or whenever you keep your environment variables):

    ```
    # Recaptcha public key setter for contact form
    GOOGLE_RECAPTCHA_SITE_KEY=
    # Recaptcha secret key setter for contact form
    GOOGLE_RECAPTCHA_SECRET=

    ```
6. Create and run doctrine database migrations.

For the guide how to use your own entity see [Sylius docs - Customizing Models](https://docs.sylius.com/the-customization-guide/customizing-models)

### Usage

[](#usage)

- Parameters can be left empty if you want to run the plugin without recaptcha verification.
- The plugin is made to work with invisible V2 recaptcha, it is essential to select this version during their creation.
- The plugin defines the contact email of the channel (configurable in the `Channels` tab of the `configuration` section in the administration panel) as the manager's email address.

Configuration
-------------

[](#configuration)

```
 threebrs_sylius_contact_form_plugin:
     # Define if an email should be sent to the manager when contact form is send
       send_manager_mail: true/false
     # Define if an email should be sent to the customer when contact form is send (copy)
       send_customer_mail: true/false
     # Define 'name' field requirement in contact form
       name_required: true/false
     # Define 'phone' field requirement in contact form
       phone_required: true/false
```

Usage
-----

[](#usage-1)

- Log into admin panel as administrator or account panel as registered customer
- Go into `Messages` section
- Select the conversation you want to answer to
- Write your reply message
- Click `Send` button below

Development
-----------

[](#development)

### Setup

[](#setup)

Initialize the development environment:

```
make init
```

This command installs dependencies, sets up the database, and prepares frontend assets (or follow related steps in Makefile).

### Usage

[](#usage-2)

- Develop your plugin logic inside `/src`
- See `bin/` for useful dev tools

### Testing

[](#testing)

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

```
make tests
# Or run individual commands:
make static  # phpstan, ecs, lint
make behat   # behat tests
```

License
-------

[](#license)

This library is under the MIT license.

Credits
-------

[](#credits)

Developed by [3BRS](https://3brs.com)
Forked from [manGoweb](https://github.com/mangoweb-sylius/SyliusContactFormPlugin).

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance79

Regular maintenance activity

Popularity20

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 62.1% of commits — single point of failure

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 ~227 days

Recently: every ~50 days

Total

7

Last Release

259d ago

Major Versions

v1.3.0 → v2.0.02025-06-09

PHP version history (4 changes)v1.0.0PHP ^7.3|^8.0

v1.1.0PHP ^8.0

v1.3.0PHP ^8.1

v2.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/ab23998c28b111996e4b3357f20929d6904a97ac21724750e1dfafd6a09791e4?d=identicon)[ondrej-kuhnel](/maintainers/ondrej-kuhnel)

---

Top Contributors

[![jaroslavtyc](https://avatars.githubusercontent.com/u/2290225?v=4)](https://github.com/jaroslavtyc "jaroslavtyc (18 commits)")[![ondrej-kuhnel](https://avatars.githubusercontent.com/u/6840281?v=4)](https://github.com/ondrej-kuhnel "ondrej-kuhnel (6 commits)")[![AdhamKandeel27](https://avatars.githubusercontent.com/u/108978262?v=4)](https://github.com/AdhamKandeel27 "AdhamKandeel27 (5 commits)")

---

Tags

syliussylius-plugin

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StyleECS

Type Coverage Yes

### Embed Badge

![Health badge](/badges/3brs-sylius-contact-form-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/3brs-sylius-contact-form-plugin/health.svg)](https://phpackages.com/packages/3brs-sylius-contact-form-plugin)
```

###  Alternatives

[sylius/refund-plugin

Plugin provides basic refunds functionality for Sylius application.

691.7M14](/packages/sylius-refund-plugin)[stefandoorn/sitemap-plugin

Sitemap Plugin for Sylius

851.0M](/packages/stefandoorn-sitemap-plugin)[monsieurbiz/sylius-rich-editor-plugin

A Rich Editor plugin for Sylius.

75380.8k6](/packages/monsieurbiz-sylius-rich-editor-plugin)[synolia/sylius-scheduler-command-plugin

Scheduler Command Plugin.

34361.5k](/packages/synolia-sylius-scheduler-command-plugin)[odiseoteam/sylius-blog-plugin

This plugin add blog capabilities to your Sylius project

37104.5k](/packages/odiseoteam-sylius-blog-plugin)[webgriffe/sylius-table-rate-shipping-plugin

Provides table rate shipping calculator.

1490.4k](/packages/webgriffe-sylius-table-rate-shipping-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
