sokolnikov911 / laravel-sendy
Service provider for Sendy API in PHP Laravel 5+
Requires
- php: >=7.3
- illuminate/support: ^6.0
Requires (Dev)
- orchestra/testbench: ~3.7.0
- phpunit/phpunit: ^7.0
This package is auto-updated.
Last update: 2024-11-09 01:00:33 UTC
README
Package description: Laravel simple integration with Sendy API to subscribe/unsubscribe users to list.
Installation
Install via composer
composer require sokolnikov911/laravel-sendy
Register Service Provider
Note! This step is optional if you use laravel >= 5.5 with package auto discovery feature.
Add service provider to config/app.php
in providers
section
sokolnikov911\LaravelSendy\ServiceProvider::class,
Register Facade
Register package facade in config/app.php
in aliases
section
'LaravelSendy' => sokolnikov911\LaravelSendy\Facades\LaravelSendy::class,
Add env variables
SENDY_API_KEY=your-api-key SENDY_URL=your-sendy-url SENDY_LIST_ID=your-list-id
LIST ID can be found encrypted & hashed in View all lists section under the column named ID
Customizing or extending
Publish configuration file
You can publish configuration file to edit the variables, in case you don't want to use ENV. File will pe published in /config/larave-sendy.php
php artisan vendor:publish --provider="sokolnikov911\LaravelSendy\ServiceProvider" --tag="config"
Publish translations
You can publish translations to edit them. Files will be published in /resources/lang/vendor/laravel-sendy
.
Note: You can extend translations by creating a new file in /resources/lang/vendor/laravel-sendy/{lang}/messages.php
using the format from en
language file.
Usage examples
Before any usage add Namespace to file.
use sokolnikov911\LaravelSendy\LaravelSendy;
Subscribe
Subscribes a new email to list. This can be used to edit already subscribed users. (eg. change name)
// initialize LaravelSendy $sendy = new LaravelSendy(); // Simple email subscribe $subscribe = $sendy->subscribe('email@example.com'); // Add subscriber with email and name $subscribe = $sendy->subscribe('email@example.com', 'John Doe'); // Full subscribe method $subscribe = $sendy->subscribe($email, $name = null, $listId = null, $json = false, $customFields = []); // Response example $subscribe = [ "success" => true "message" => "You have been subscribed." ]
Unsubscribe Examples
Marks email as unsubscribed from the list.
// initialize LaravelSendy $sendy = new LaravelSendy(); // Simple unsubscribe $unsubscribe = $sendy->unsubscribe('email@example.com'); // Full unsubscribe method $unsubscribe = $sendy->unsubscribe($email, $listId = null, $json = false); // Response example $unsubscribe = [ "success" => true "message" => "You have been unsubscribed." ]
Delete Example
Deletes email from list. Action is definitive.
// initialize LaravelSendy $sendy = new LaravelSendy(); // Simple delete $delete = $sendy->delete('email@example.com'); // Full unsubscribe method $delete = $sendy->delete($email, $listId = null, $json = false); // Response example $delete = [ "success" => true "message" => "You have been deleted from the list." ]
Security
If you discover any security related issues, please email instead of using the issue tracker.
Contribute
If you wish to contribute to translations for the package in your language you can submit a PR request with the lang files copied from en resources/lang/en/messages.php
.