Download the PHP package team-nifty-gmbh/laravel-rocket-chat-notifications without Composer
On this page you can find all versions of the php package team-nifty-gmbh/laravel-rocket-chat-notifications. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download team-nifty-gmbh/laravel-rocket-chat-notifications
More information about team-nifty-gmbh/laravel-rocket-chat-notifications
Files in team-nifty-gmbh/laravel-rocket-chat-notifications
Package laravel-rocket-chat-notifications
Short Description Rocket.Chat Notifications for laravel
License MIT
Informations about the package laravel-rocket-chat-notifications
laravel-rocket-chat-notifications
Introduction
This package makes it easy to send notifications using RocketChat with Laravel 9.0+.
Contents
- Installation
- Setting up the RocketChat service
- Usage
- Available Message methods
- Adding Attachment
- Available Attachment methods
- Sending messages without notification
- Sending messages via connection
- Credits
- License
Installation
You can install the package via composer:
Setting up the RocketChat service
In order to send message to RocketChat channels, you need to create a bot user with an access token in your RocketChat Application
You can publish the config file with:
The config file looks as follows:
If you have published the config file, you can add your RocketChat API server's base url, access token and user Id to config/rocket-chat.php.
You can also create additional connections if you wish to serve multiple RocketChats in your application.
Usage
You can use the channel in your via() method inside the notification:
In order to let your notification know which RocketChat channel you are targeting, add the routeNotificationForRocketChat method to your Notifiable model:
Available Message methods
connection(): Sets the connection.
domain(): Sets the domain of your rocket chat server.
from(): Sets the sender's access token and user id.
to(): Specifies the channel id to send the notification to (overridden by routeNotificationForRocketChat if empty).
content(): Sets a content of the notification message. Supports Github flavoured markdown.
alias(): This will cause the message’s name to appear as the given alias, but your username will still display.
avatar(): This will make the avatar use the provided image url.
attachment(): This will add a single attachment.
attachments(): This will add multiple attachments.
clearAttachments(): This will remove all attachments.
Adding Attachment
There are several ways to add one or more attachments to a message
Available Attachment methods
color(): The color you want the order on the left side to be, any value background-css supports.
text(): The text to display for this attachment, it is different than the message’s text.
timestamp(): Displays the time next to the text portion. ISO8601 Zulu Date or instance of any \DateTime
thumbnailUrl(): An image that displays to the left of the text, looks better when this is relatively small.
messageLink(): Only applicable if the ts is provided, as it makes the time clickable to this link.
collapsed(): Causes the image, audio, and video sections to be hiding when collapsed is true.
author($name, $link, $icon): shortcut for author methods
authorName(): Name of the author.
authorLink(): Providing this makes the author name clickable and points to this link.
authorIcon(): Displays a tiny icon to the left of the Author’s name.
title(): Title to display for this attachment, displays under the author.
titleLink(): Providing this makes the title clickable, pointing to this link.
titleLinkDownload(): When this is true, a download icon appears and clicking this saves the link to file.
imageUrl(): The image to display, will be “big” and easy to see.
audioUrl(): Audio file to play, only supports what html audio does.
videoUrl(): Video file to play, only supports what html video does.
fields(): An array of Attachment Field Objects.
Sending messages without a notification
Sending messages via connection
connection must be defined in config/rocket-chat.php
Credits
- [Steffen Franz]
- All Contributors
License
The MIT License (MIT). Please see License File for more information.