Git Product home page Git Product logo

notifyme's Introduction

NotifyMe

StyleCI Build Status

Common interface for notification services.

Installation

Either PHP 5.5+ or HHVM 3.6+ are required.

To get the latest version of NotifyMe, simply require the project using Composer:

$ composer require notifymehq/notifyme

Instead, you may of course manually update your require block and run composer update if you so choose:

{
    "require": {
        "notifymehq/notifyme": "^1.0"
    }
}

If you want, you can require only a single adapter. This works rather like the component system of laravel or symfony. We currently have the following adapters:

  • Ballou (notifymehq/ballou)
  • Campfire (notifymehq/campfire)
  • Gitter (notifymehq/gitter)
  • Hipchat (notifymehq/hipchat)
  • Pagerduty (notifymehq/pagerduty)
  • Pushover (notifymehq/pushover)
  • Slack (notifymehq/slack)
  • Twilio (notifymehq/twilio)
  • Webhook (notifymehq/webhook)
  • Yo (notifymehq/yo)

Also, note, that our other components are:

  • Contracts (notifymehq/contracts)
  • Factory (notifymehq/factory)
  • Http (notifymehq/http)
  • Manager (notifymehq/manager)
  • Support (notifymehq/support)

Finally, we have a totally seperate Laravel bridge available for use by installing notifyme/laravel, then adding our service provider: NotifyMeHQ\Laravel\NotifyMeServiceProvider.

Usage

  • Create a factory : $factory = new NotifyMeHQ\Factory\NotifyMeFactory();
  • Make a notifier : $notifier = $factory->make($config);
  • Notify : $response = $notifier->notify($to, $message);
  • Check the response : $response->isSent();

Example

Here is an example of a notification with Slack:

<?php

// Create a factory for notifications
$notifierFactory = new NotifyMeHQ\Factory\NotifyMeFactory();

// Create the new notification for slack
$slackNotifier = $notifierFactory->make([
  // Specify that we will use slack
  'driver' => 'slack',
  // Add api token to get access to slack API
  'token'  => '',
  // Who send this message, here is a bot called 'Super Bot'
  'from'   => 'Super Bot',
]);

/* @var \NotifyMeHQ\Contracts\ResponseInterface $response */
$response =  $slackNotifier->notify('#sandbox', 'test message');

echo $response->isSent() ? 'Message sent' : 'Message going nowhere';

License

NotifyMe is licensed under The MIT License (MIT).

notifyme's People

Contributors

grahamcampbell avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.