2017 © Pedro Peláez
 

library fluent

Client side wrapper to the Fluent Web Service

image

fivesqrd/fluent

Client side wrapper to the Fluent Web Service

  • Wednesday, January 10, 2018
  • by christianjburger
  • Repository
  • 1 Watchers
  • 2 Stars
  • 0 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 10 Versions
  • 33 % Grown

The README.md

Fluent for PHP

Programmatic approach to generating and sending responsive user notifications via e-mail, (*1)

Benefits

  • Easy API to generate HTML based e-mail bodies in your app
  • Less time wrestling with CSS inlining
  • Automatically responsive

Install

php composer.phar require fivesqrd/fluent:4.0

For Laravel projects there is an easy to install package available, (*2)

composer require fivesqrd/fluent-laravel

Register

To send messages you'll first need to register Fluent account. Once registered, you'll receive API key to start sending messages immediately., (*3)

Quick Examples

Create and send a message:, (*4)

$messageId = Fluent\Factory::message()->create()
    ->title('My little pony')
    ->paragraph('Lorem ipsum dolor sit amet, consectetur adipiscing elit. Praesent ornare pellentesque neque non rutrum. Sed a sagittis lacus.')
    ->number(['caption' => 'Today', value => date('j M Y')])
    ->button('http://www.mypony.com', 'Like my pony')
    ->paragraph('Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.')
    ->when(date('D') == 'Sun', function ($message) {
        $message->paragraph('Something that will only display on Sundays');
    })
    ->teaser('This is a teaser')
    ->subject('Testing it')
    ->header('Reply-To', 'me@myapp.com')
    ->to('user@theirdomain.com')
    ->send();

The following methods are provided to set up the delivery of the message:, (*5)

header($key, $value) or headers($values)

/* Add a header to the message */
$message->header('Reply-To', 'me@myapp.com');

/* Add multiple headers to the message */
$message->headers(array(
    'Reply-To', 'me@myapp.com',
    'X-Fluent', 'lorem'
));

from($address, $name = null)

/* Set the sender address and name */
$message->from('me@myapp.com', 'My App');

attach($filename, $mimetype, $blob) or attachments($values)

/* Add an attachment to the message */
$message->attach('My-Attachment.pdf', 'application/pdf', file_get_contents($file))

/* Only add an attachment if the condition is satisfied */
$message->attachWhen(file_exists($file), 'My-Attachment.pdf', 'application/pdf', file_get_contents($file))

/* Add multiple attachments to the message */
$message->attachments(array(
    ['name' => 'My-First-File.pdf', 'type' => 'application/pdf', 'content' => file_get_contents($file)],
    ['name' => 'My-2nd-File.jpg', 'type' => 'image/jpg', 'content' => file_get_contents($file2)],
));

send()

Send is the final method of the chain and should always be called last. It delivers to message to the Fluent Web Service and returns a unique message ID., (*6)

/* Send the message */
$messageId = $message->send();

Plain Text

$messageId = Fluent\Factory::message()
    ->create('This is a plan text email body')
    ->subject('Testing it')
    ->header('Reply-To', 'me@myapp.com')
    ->to('user@theirdomain.com')
    ->send();

Find problematic events related to a user's email adress:, (*7)

$response = Fluent\Factory::event()->find()
    ->to('user@theirdomain.com')
    ->since(date('Y-m-d H:i:s', $timeframe))
    ->type(['hard_bounce', 'soft_bounce', 'reject'])
    ->fetch();

The Versions

10/01 2018

dev-master

9999999-dev

Client side wrapper to the Fluent Web Service

  Sources   Download

MIT

by Christian Burger

10/01 2018

3.0.x-dev

3.0.9999999.9999999-dev

The Fluent Messaging client library

  Sources   Download

MIT Click Science License

by Christian Burger

21/10 2017

4.0.x-dev

4.0.9999999.9999999-dev

Client side wrapper to the Fluent Web Service

  Sources   Download

by Christian Burger

10/10 2017

3.3.x-dev

3.3.9999999.9999999-dev

The Fluent Messaging client library

  Sources   Download

MIT

by Christian Burger

29/09 2017

v1

1.0.0.0

  Sources   Download

27/09 2017

3.4.x-dev

3.4.9999999.9999999-dev

The Fluent Messaging client library

  Sources   Download

MIT

by Christian Burger

27/06 2017

3.2.x-dev

3.2.9999999.9999999-dev

The Fluent Messaging client library

  Sources   Download

MIT

by Christian Burger

27/06 2017

3.1.x-dev

3.1.9999999.9999999-dev

The Fluent Messaging client library

  Sources   Download

MIT Click Science License

by Christian Burger

30/01 2017

2.1.x-dev

2.1.9999999.9999999-dev

The Jifno PHP SDK

  Sources   Download

Five Squared License

by Christian Burger

12/12 2015

2.0.x-dev

2.0.9999999.9999999-dev

The Jifno PHP SDK

  Sources   Download

Click Science License

by Christian Burger