Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ijsto/strapi-provider-email-postmark
Strapi Email service provider for Postmark
https://github.com/ijsto/strapi-provider-email-postmark
Last synced: about 2 months ago
JSON representation
Strapi Email service provider for Postmark
- Host: GitHub
- URL: https://github.com/ijsto/strapi-provider-email-postmark
- Owner: ijsto
- License: mit
- Created: 2020-06-10T00:02:57.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-01-30T15:58:56.000Z (over 1 year ago)
- Last Synced: 2024-07-14T20:21:45.323Z (2 months ago)
- Language: JavaScript
- Size: 37.1 KB
- Stars: 9
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-strapi - Postmark - Postmark email provider. (Strapi v3 / Plugin & Providers - v3)
README
# strapi-provider-email-postmark
[Strapi](http://strapi.io/) email service for [Postmark](https://postmarkapp.com/)
# Prerequisites
You will need to have the plugin `strapi-plugin-email` installed in you Strapi project.
# Installation
```
# using yarn
yarn add strapi-provider-email-postmark
# using npm
npm i strapi-provider-email-postmark
```
# Configuration
| Variable | Type | Description | Required | Default |
| ----------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | --------- |
| provider | string | The name of the provider you use | yes | |
| providerOptions | object | Provider options | yes | |
| providerOptions.apiKey | string | Postmark API key. Please refer to [postmark docs](https://www.npmjs.com/package/postmark) for more | yes | |
| settings | object | Settings | no | {} |
| settings.defaultMessageStream | string | Send through a specific message stream. Please refer to [postmark docs](https://postmarkapp.com/support/article/1207-how-to-create-and-send-through-message-streams) for more | no | undefined |
| settings.defaultFrom | string | Default sender mail address | no | undefined |
| settings.defaultTo | string | Default receiver mail address | no | undefined |
| settings.defaultReplyTo | string | Default address the receiver is asked to reply to | no | undefined |
| settings.defaultVariables | object | Default set of variables to be used in template emails | no | {} |
### Example
Path - `config/plugins.js`
```javascript
module.exports = ({ env }) => ({
// ...
email: {
config: {
provider: "strapi-provider-email-postmark",
providerOptions: {
apiKey: "your-postmark-api-key",
},
settings: {
defaultMessageStream: "my-stream",
defaultFrom: "[email protected]",
defaultTo: "[email protected]",
defaultReplyTo: "[email protected]",
defaultVariables: {
sentBy: 'strapi',
},
},
}
},
// ...
});
```
**IMPORTANT:** With Strapi v4, you have to set `email.config.provider` to "strapi-provider-email-postmark", instead of "postmark". This is intended in Strapi v4: https://github.com/strapi/strapi/issues/11879.
Additionally, the structure of `plugins.js` has changed:
- In v3: `"email": {"provider": "", ...}`
- In v4: `"email": {"config": {"provider": "", ...}}`
### Usage
Call the `send` function on the email service, as you would for any strapi email service.
```javascript
await strapi.plugins.email.services.email.send({
to: "[email protected]",
text: "Hello John"
});
```
To send an email via a template, set `templateId` or `templateAlias` (and `variables`) to use the `sendEmailWithTemplate` method.
```javascript
await strapi.plugins.email.services.email.send({
to: "[email protected]",
templateAlias: "code-your-own",
variables: {
name: "John"
}
});
```
# Licence
- [MIT](https://github.com/ijsto/strapi-provider-email-postmark/blob/master/LICENSE.md)