Provides a simple but powerful contact form built onto the Observer Pattern. Plug any listener you want to your contact form's submission
- Add mongodb configuration files
- Add unit tests
- Comment methods and attributes
- Cleanup
(Quite the same as for GithubBundle, we are sorry for that methodology but we'll correct that soon).
- Compatible with Doctrine ORM and ODM thanks to a generic repository.
- Model is extensible at will
- Observer Pattern designed for more flexibility
- Every class is customizable
Using submodules If you prefer instead to use git submodules, the run the following:
$ git submodule add git://github.com/rz/ContactBundle.git src/Rz/ContactBundle
Using the vendors script
Add the following lines in your deps file:
[RzContactBundle]
git=git://github.com/rz/ContactBundle.git
target=bundles/Rz/ContactBundle
If you want to connect the email listener, install SwitfMailer and configure it
$ git submodule add git://github.com/swiftmailer.git src/vendor/swiftmailer
or via deps file
[swiftmailer]
git=http://github.com/swiftmailer/swiftmailer.git
version=v4.1.2
In your config, add :
swiftmailer.config:
transport: smtp
encryption: ssl
auth_mode: login
host: domain.tld
username: [email protected]
password: your_secret
// app/autoload.php
$loader->registerNamespaces(array(
'Rz' => __DIR__.'/../vendor/bundles',
// your other namespaces
);
// app/AppKernel.php
public function registerBundles()
{
return array(
// ...
new Rz\ContactBundle\RzContactBundle(),
// ...
);
}
app/console doctrine:schema:update --force
In your template, you just have to add (if you are using Twig)
{% render "RzContactBundle:Contact:form" with { 'method': app.request.method }, { 'query': app.request.request.all } %}
Since version 2.0.13 of Symfony you must send your form "POST" data using "query" parameter. That's because "render" tag is being processed as a sub-request. And since that version all sub-requests are forced to use "GET" method therefore your embedded ContactController will loose all "POST" data if you miss it. As well you should explicitly specify the request method in "method" parameter to let the embedded ContactController recognize that your form is submitted.
In your app/config.yml (given you are using YAML for your configuration file)
rz_contact:
contact:
form:
type: rz_contact_contact
handler: rz_contact.contact.form.handler.default
name: rz_contact_contact_form
validation_groups: [Contact]
form: ~ # (optional) class managing the contact form
model: ~ # (optional) class managing the model
connectors: # the list of "listeners" (or connectors here)
email: # connecting the email listener
recipients: [email protected] # giving him the recipient(s) email(s)
database: # connecting the database listener
db_driver: orm # giving him the database driver
file: ~ # connecting the file logger listener
If you want a simple contact form only sending an email to you contact mailbox, then you just have to add to your configuration file
rz_contact:
connectors:
email:
recipients: [email protected]
It you want to use a custom template/view instead of the default one (RzContactBundle:Contact:form.html.twig), you can add the view parameter with the name of your view. Example:
rz_contact:
contact:
form:
view: CompanyExampleBundle:Contact:form.html.twig
skip the step if you dont want to check for spam, by default no spam will be detected. Install the OrnicarAkismentBundle and configure it properly. see the docs for more information.
define the service in your service container
rz_contact:
spam_detector:
service: ornicar_akismet
now all your Contact Request will be checked by Akismet.
if you want to implement your own Detector simply set the class for the detector
rz_contact:
spam_detector:
class: My\Bundle\MyDetector
note that the class should implement the SpamDetectorInterface
or if you want a whole new service:
rz_contact:
spam_detector:
service: my_detector_service
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent