filp/nod

Notifications in PHP (notify-send, growl, etc) like that.

dev-master 2012-08-29 13:19 UTC

This package is not auto-updated.

Last update: 2024-03-16 10:04:29 UTC


README

Notifications in PHP (notify-send, growl, etc) like that.

##Examples

Letting Nod figure out the best Adapter to use (not recommend ATM, only works with some Linux environments):

#!/usr/bin/env php
<?php  

$notification = new Nod\Notification;
$notification
  ->setTitle('My rad notification')
  ->setMessage('Check it.')
  ->setUrgency('high')
  ->setExpiry(3000)
  ->setIcon('emblem-favorite.png')
  ->send();

Explicitly giving Nod an Adapter to work with:

#!/usr/bin/env php
<?php  

use Nod\Adapter\Terminal as TerminalAdapter;

$notification = new Nod\Notification(new TerminalAdapter);
$notification
  ->setTitle('Look at ya')
  ->setMessage('Let me see what ya got')
  // you can also specify the expiry directly in the send() method:
  ->send(5000);

Creating your own Adapters is also as easy as implementing Nod\Adapter\AdapterInterface:

<?php

namespace Nod\Adapter;
interface AdapterInterface
{
    /* bool */ public function canNotify();
    /* bool */ public function process($title, $message, $urgency, $expiry, $icon);
}

##Installation

Nod is available through composer (packagist page), just drop filp/nod into your composer.json and you're good to go:

{
    "require" : {
        "filp/nod" : "dev-master"
    }
}

The Nod library can be loaded directly through the composer autoloader, or with any PSR-0 compatible autoloader.

##TODOs, wishlist, etc

  • Platform support (OSX growl, Windows growl, etc)
  • Unit tests (soon!)
  • More adapters for all sorts of zany stuff.