designpond/newsletter

Newsletter building tool for UniNE websites

Newsletter module for laravel 5.2

Newsletter interface builder and send via mailjet api, _(*1)

!!! WARNING work in progress this is a specific package for specific content !!!, _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require designpond/newsletter, <sub>(*4)</sub>

## Require

``` json
"intervention/image": "dev-master",
"inlinestyle/inlinestyle": "1.*",
"maatwebsite/excel": "~2.0.0",
"mailjet/mailjet-apiv3-php": "^1.1"

Usage

This package is used with Laravel 5.2 adn Mailjet API v3 Created for multiple websites of La Faculté de droit de l'Université de Neuchâtel. The content is meant to be used with arrets, analyse, categories and multi sites, <sub>(*5)</sub>

Configuration

• Publish with php artisan vendor:publish, <sub>(*6)</sub>

  Required, <sub>(*7)</sub>

  • Assets --tag=assets
  • Migrations --tag=migrations
  • Seeders --tag=seeds

  Optionnal, <sub>(*8)</sub>

  • Views --tag=views
  • Master layout --tag=layouts
  • Config --tag=config

• In newsletter.php define building blocs to use if you enable "groupe" you have to enable "arret", both go with another!, <sub>(*9)</sub>

• Define the models and files/images paths.
• Add Mailjet credentials to your .env file
• Migrate tables and seed types with php artisan db:seed --class=TypeSeeder

Usage simple

If you want routes with prefix set it in env.js in newsletter/js, <sub>(*10)</sub>

Master layout dependencies

Javascript and css + jquery.js v2.2 + jquery-ui.js v1.11 + bootstrap.css v3 + bootstrap.js v3, <sub>(*11)</sub>

Elements to add, <sub>(*12)</sub>

In the head, <sub>(*13)</sub>

@if(isset($isNewsletter))
    @include('newsletter::Style.main', ['campagne' => isset($campagne) ? : null])
    @include('newsletter::Style.redactor')
@endif

Before end of the body, <sub>(*14)</sub>

@include('newsletter::Script.config')

@if(isset($isNewsletter))
    @include('newsletter::Script.date')
    @include('newsletter::Script.redactor')
    @include('newsletter::Script.angular')
    @include('newsletter::Script.datatables')
    @include('newsletter::Script.main')
@endif

You have to implement upload routes for wysiwyg redactor.js, <sub>(*15)</sub>

Route::post('uploadRedactor', 'UploadController@uploadRedactor');
Route::post('uploadJS', 'UploadController@uploadJS');
Route::get('imageJson/{id?}', ['uses' => 'UploadController@imageJson']);
Route::get('fileJson/{id?}', ['uses' => 'UploadController@fileJson']);

Usage with Arrets and Categories

You have to Implement ajax routes: ``` php Route::get('arret/{id}', 'ArretController@simple'); // build.js Route::get('arrets/{id?}', 'ArretController@arrets'); // build.js Route::get('categories/{id?}', 'CategorieController@categories'); // utils.js, <sub>(*16)</sub>

And configure the path to you routes for angular`in newsletter/js/env.js

```javascript
// Admin url
window.__env.adminUrl = 'http://dev.local/admin/';
// Base url
window.__env.ajaxUrl = 'http://dev.local/admin/ajax/';

Navigation menu items

• Newsletters list: build/newsletter
• Subscribers: build/subscriber
• Import subscribers: build/import
• External email lists: build/liste

Change log

Please see CHANGELOG for more information what has changed recently., <sub>(*17)</sub>

Security

If you discover any security related issues, please email cindy.leschaud@gmail.com instead of using the issue tracker., <sub>(*18)</sub>

Credits

Cindy Leschaud, <sub>(*19)</sub>

License

The MIT License (MIT). Please see License File for more information., <sub>(*20)</sub>