Download the PHP package atournayre/confirmation-bundle without Composer
On this page you can find all versions of the php package atournayre/confirmation-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package confirmation-bundle
Confirmation Bundle
This bundle provide confirmation for entities.
Install
Composer
Bundles
Configuration
Create file and copy content below.
Routing
Create file and copy content below.
Services
Usage
Configure entity
- Entity needs to implement
Atournayre\Bundle\ConfirmationBundle\Contracts\ConfirmableInterface
. - Add
Atournayre\Bundle\ConfirmationBundle\Traits\ConfirmableTrait
to your entity.
Create a provider
For each entity/mapping, you must :
- Create a provider
- It must extend from
Atournayre\Bundle\ConfirmationBundle\Provider\AbstractProvider
- You need to implement abstract methods
- You can override public methods
NOTE
It's discouraged to override
updateEntity()
.Prefer using
updateAfterConfirmation()
inside the entity to update it after confirmation (example: update status from 'pending' to 'valid').
Generate confirmation code
When you want to generate a confirmation code, just use Atournayre\Bundle\ConfirmationBundle\Service\GenerateConfirmationService
, call the __invoke()
method.
Following actions will be performed :
- A confirmation code will be generated
- Entity will be tagged as "unconfirmed"
- The recipient will be notified.
Tip : If you use both id and uuid in your entity, you can specify the id to use as 3rd parameter.
As code are required for verification purpose, the service only send it and don't return it.
Verify confirmation code
Verification can be performed using 2 ways :
- Direct link
- Form
Direct link
Using app_confirmation_code_with_code
route, the user only needs to follow the link and entity will be validated.
Form
Using app_confirmation_code
route, the user needs to fill-in a form with the code provided to him (via notification) so the entity could be validated.
Templating
It is possible to override any template thanks to Symfony.
Contributing
Of course, open source is fueled by everyone's ability to give just a little bit of their time for the greater good. If you'd like to see a feature or add some of your own happy words, awesome! Tou can request it - but creating a pull request is an even better way to get things done.
Either way, please feel comfortable submitting issues or pull requests: all contributions and questions are warmly appreciated :).
All versions of confirmation-bundle with dependencies
doctrine/doctrine-bundle Version ^2.7
doctrine/orm Version ^2.11
symfony/config Version 6.2.*
symfony/dependency-injection Version 6.2.*
symfony/form Version 6.2.*
symfony/http-foundation Version 6.2.*
symfony/routing Version 6.2.*
symfony/uid Version 6.2.*
symfony/yaml Version 6.2.*
twig/twig Version ^3.4