Installation

Installation steps

Run composer require novactive/ezmailingbundle to install the bundle and its dependencies:

Register the bundle

Activate the bundle in app\AppKernel.php file.

// app\AppKernel.php

public function registerBundles()
{
   ...
   $bundles = array(
       new FrameworkBundle(),
       ...
       // NovaeZMailingBundle
       new Novactive\Bundle\eZMailingBundle\NovaeZMailingBundle(),
   );
   ...
}

Add routes

_novaezmailing_routes:
    resource: '@NovaeZMailingBundle/Resources/config/routing.yml'

Add configuration

You need to declare a template for the view novaezmailingfull

ezpublish:
    system:
        default:
            content_view:
                novaezmailingfull:
                    folder:
                        template: yourtemplatepath
                        match:
                            Identifier\ContentType: [a_content_type]

Adapt according to your configuration

You also need 2 mailers, 1 in charge to send the Mailings, the other to send the service emails.

nova_ezmailing:
    system:
        default:
            simple_mailer: "swiftmailer.mailer.local_mailer"
            mailing_mailer: "swiftmailer.mailer.remote_mailer"
            # Default email values
            email_subject_prefix: "[NovaeZMailing]"
            email_from_address: "no-reply@novactive.com"
            email_from_name: "Novactive"
            email_return_path: "return-path@novactive.com"

Example in dev mode

swiftmailer:
    default_mailer: myfirst_mailer
    mailers:
        myfirst_mailer:
            transport: 'smtp'
            host: 127.0.0.1
            port: 1025
            spool: { type: memory }
        mysecond_mailer:
            transport: 'smtp'
            host: 127.0.0.1
            port: 1025
            spool: { type: memory }

nova_ezmailing:
    system:
        default:
            simple_mailer: "swiftmailer.mailer.myfirst_mailer"
            mailing_mailer: "swiftmailer.mailer.mysecond_mailer"

Add the tables

bin/console novaezmailing:install

Specify the Default Mailing List Id

To be able to implement the subscription form by doing subrequest to novaezmailing_registration_default_create route the default Mailing List Id should be specified in the configuration file. It should be added to the default section under the nova_ezmailing namespace.

If you need to the other mailing list id value for some particular site access it should be added to the corresponding section in the configuration file.

Troubleshooting

If the bundle web assets (css, js etc.) are missing in the public directory it can be fixed by running the following commands:

bin/console assets:install --symlink --relative
bin/console assetic:dump

That will install bundles web assets under a public directory and dump them to the filesystem.