{"id":20696013,"url":"https://github.com/laravel-notification-channels/pushover","last_synced_at":"2025-05-16T15:06:48.865Z","repository":{"id":10377538,"uuid":"65543497","full_name":"laravel-notification-channels/pushover","owner":"laravel-notification-channels","description":"📱 Pushover notifications channel for Laravel","archived":false,"fork":false,"pushed_at":"2025-03-01T09:08:00.000Z","size":138,"stargazers_count":57,"open_issues_count":1,"forks_count":33,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-12T14:17:11.730Z","etag":null,"topics":["laravel","pushover","pushover-notifications","pushover-notifications-channel"],"latest_commit_sha":null,"homepage":"http://laravel-notification-channels.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/laravel-notification-channels.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-08-12T10:00:31.000Z","updated_at":"2025-04-06T15:34:30.000Z","dependencies_parsed_at":"2024-03-11T12:26:47.173Z","dependency_job_id":"4b649399-dfb8-494e-8b02-cd26039e2d73","html_url":"https://github.com/laravel-notification-channels/pushover","commit_stats":{"total_commits":64,"total_committers":12,"mean_commits":5.333333333333333,"dds":0.25,"last_synced_commit":"91dc3eef855a25261f731b9fe0089794eb136590"},"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laravel-notification-channels%2Fpushover","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laravel-notification-channels%2Fpushover/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laravel-notification-channels%2Fpushover/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/laravel-notification-channels%2Fpushover/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/laravel-notification-channels","download_url":"https://codeload.github.com/laravel-notification-channels/pushover/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254190352,"owners_count":22029628,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["laravel","pushover","pushover-notifications","pushover-notifications-channel"],"created_at":"2024-11-17T00:12:14.895Z","updated_at":"2025-05-16T15:06:48.849Z","avatar_url":"https://github.com/laravel-notification-channels.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pushover notifications channel for Laravel\n\n[![Latest Version on Packagist](https://img.shields.io/packagist/v/laravel-notification-channels/pushover.svg?style=flat-square)](https://packagist.org/packages/laravel-notification-channels/pushover)\n[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE.md)\n[![Build Status](https://img.shields.io/github/actions/workflow/status/laravel-notification-channels/pushover/test.yml?style=flat-square)](https://github.com/laravel-notification-channels/pushover/actions)\n[![StyleCI](https://styleci.io/repos/65543497/shield)](https://styleci.io/repos/65543497)\n[![Quality Score](https://img.shields.io/scrutinizer/g/laravel-notification-channels/pushover.svg?style=flat-square)](https://scrutinizer-ci.com/g/laravel-notification-channels/pushover)\n[![Code Coverage](https://img.shields.io/scrutinizer/coverage/g/laravel-notification-channels/pushover/master.svg?style=flat-square)](https://scrutinizer-ci.com/g/laravel-notification-channels/pushover/?branch=master)\n[![Total Downloads](https://img.shields.io/packagist/dt/laravel-notification-channels/pushover.svg?style=flat-square)](https://packagist.org/packages/laravel-notification-channels/pushover)\n\nThis package makes it easy to send Pushover notifications with Laravel Notifications.\n\n## Contents\n\n- [Installation](#installation)\n    - [Setting up your Pushover account](#setting-up-your-pushover-account)\n- [Usage](#usage)\n    - [Advanved usage and configuration](#advanced-usage-and-configuration)\n    - [Available Message methods](#available-message-methods)\n- [Changelog](#changelog)\n- [Testing](#testing)\n- [Security](#security)\n- [Contributing](#contributing)\n- [Credits](#credits)\n- [License](#license)\n\n## Installation\n\nYou can install the package via composer:\n\n```bash\ncomposer require laravel-notification-channels/pushover\n```\n\n### Setting up your Pushover account\n\nTo start sending messages via Pushover, you have to [register an application](https://pushover.net/apps/build).\nAdd the generated Pushover application token to the services config file:\n\n```php\n// config/services.php\n'pushover' =\u003e [\n    'token' =\u003e 'YOUR_APPLICATION_TOKEN',\n],\n```\n\n## Usage\n\nNow you can use the channel in your `via()` method inside the notification as well as send a push notification:\n\n```php\nuse NotificationChannels\\Pushover\\PushoverChannel;\nuse NotificationChannels\\Pushover\\PushoverMessage;\nuse Illuminate\\Notifications\\Notification;\n\nclass AccountApproved extends Notification\n{\n    public function via($notifiable)\n    {\n        return [PushoverChannel::class];\n    }\n\n    public function toPushover($notifiable)\n    {\n        return PushoverMessage::create('The invoice has been paid.')\n            -\u003etitle('Invoice paid')\n            -\u003esound('incoming')\n            -\u003elowPriority()\n            -\u003eurl('http://example.com/invoices', 'Go to your invoices');\n    }\n}\n```\n\nTo send Pushover notifications to the notifiable entity, add the `routeNotificationForPushover` method to that model. \nUsually, this is the User model. The `pushover_key` could be a database field and editable by the user itself.\n\n```php\npublic function routeNotificationForPushover()\n{\n    return $this-\u003epushover_key;\n}\n```\n\n### Advanced usage and configuration\n\nIf you want to specify specific devices, you can return a `PushoverReceiver` object.\n\n```php\npublic function routeNotificationForPushover() {\n    return PushoverReceiver::withUserKey('pushover-key')\n        -\u003etoDevice('iphone')\n        -\u003etoDevice('desktop')\n        // or, if you prefer:\n        -\u003etoDevice(['iphone', 'desktop']);\n}\n```\n\nIf you want to (dynamically) overrule the application token from the services config, e.g. because each user holds their\nown application token, return a `PushoverReceiver` object like this:\n\n```php\npublic function routeNotificationForPushover() {\n    return PushoverReceiver::withUserKey('pushover-key')\n        -\u003ewithApplicationToken('app-token');\n}\n```\n\nYou can also send a message to a Pushover group:\n\n```php\npublic function routeNotificationForPushover() {\n    return PushoverReceiver::withGroupKey('pushover-group-key');\n}\n```\n\n### Available Message methods\n\n| Method | Description |\n|--------|-------------|\n| `content($message)`    | Accepts a string value for the message text.  |\n| `html()`               | Sets the message type to [HTML](https://pushover.net/api#html). |\n| `monospace()`          | Sets the message type to monospace. |\n| `plain()`              | Sets the message type to plain text, this is the default. |\n| `title($title)`        | Accepts a string value for the message title. |\n| `time($timestamp)`     | Accepts either a `Carbon` object or a UNIX timestamp. |\n| `url($url[, $title])`  | Accepts a string value for a [supplementary url](https://pushover.net/api#urls) and an optional string value for the title of the url. |\n| `sound($sound)`        | Accepts a string value for the [notification sound](https://pushover.net/api#sounds). |\n| `image($image)`        | Accepts a string value for the image location (either full or relative server path or a URL). If there is any error with the file (too big, not an image) it will silently send the message without the image attachment. |\n| `priority($priority[, $retryTimeout, $expireAfter])` | Accepts an integer value for the priority and, when the priority is set to emergency, also an integer value for the retry timeout and expiry time (in seconds). Priority values are available as constants | `PushoverMessage::LOWEST_PRIORITY`, `PushoverMessage::LOW_PRIORITY`, `PushoverMessage::NORMAL_PRIORITY` and `PushoverMessage::EMERGENCY_PRIORITY`. |\n| `lowestPriority()`     | Sets the priority to the lowest priority. |\n| `lowPriority()`        | Sets the priority to low. |\n| `normalPriority()`     | Sets the priority to normal. |\n| `highPriority()`       | Sets the priority to high. |\n| `emergencyPriority($retryTimeout, $expireAfter)` | Sets the priority to emergency and accepts integer values for the retry timeout and expiry time (in seconds). |\n| `callback($callbackUrl)` | Sets a publicly-accessible URL that Pushover will send a request to when the user has acknowledged your notification for an emergency notification. |\n\n## Changelog\n\nPlease see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.\n\n## Testing\n\n``` bash\n$ composer test\n```\n\n## Security\n\nIf you discover any security related issues, please email mail@casperboone.nl instead of using the issue tracker.\n\n## Contributing\n\nPlease see [CONTRIBUTING](CONTRIBUTING.md) for details.\n\n## Credits\n\n- [Casper Boone](https://github.com/casperboone)\n- [All Contributors](../../contributors)\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaravel-notification-channels%2Fpushover","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flaravel-notification-channels%2Fpushover","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flaravel-notification-channels%2Fpushover/lists"}