Download the PHP package netglue/zf-postmark without Composer
On this page you can find all versions of the php package netglue/zf-postmark. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download netglue/zf-postmark
More information about netglue/zf-postmark
Files in netglue/zf-postmark
Package zf-postmark
Short Description Zend Framework Module to receive Webhooks sent by Postmark
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package zf-postmark
Zend Framework Module: Postmark Inbound & Events Webhook
Purpose
This module/package can be added to a ZF3 application in order to easily process webhooks sent by Postmark such as delivery, click, open and bounce events. It can also be used to process inbound email messages.
It hasn’t been tested on a ZF2 app, so YMMV. Probably the dependencies are too recent for it to work but it wouldn't be difficult to port for ZF2.
Install
Install with composer using "netglue/zf-postmark", enable the module in your application.config.php using the
module name 'NetgluePostmark' and add custom configuration to change the route url perhaps or set up
Basic HTTP Auth (Recommended).
Zend's component installer should inject the module name automatically for you during composer installation.
Configure Basic Auth
In order to mitigate random post requests to your inbound or event webhook endpoint, you should configure basic auth,
so create a local config file based on the contents of config/postmark.local.php.dist and configure to suit.
Given a username and password of postmark and Pa55w0rd, by default, your webhook url would be
https://postmark:[email protected]/postmark-outbound-webhook
Setup Webhooks at your Postmark account
Assuming you've used the default routes, and enabled basic auth, your endpoints will be:
https://username:[email protected]/postmark-outbound-webhook for bounces, clicks, deliveries etc and
https://username:[email protected]/postmark-inbound-webhook for inbound email messages.
Go to your account on Postmark and select the server you want to configure, click settings and enter the correct URL for either the inbound or outbound webhooks and optionally provide the basic auth credentials if you have configured them.
The outbound webhook accepts Delivery, Bounce, Spam Complaint, Open and Click events whereas the inbound webhook only accepts inbound email events/messages.
Listening for events
The controller triggers consistent events that you can listen for using Zend's Event Manager package. Bounces are
subdivided into hard bounces and soft bounces, so, you may choose to log soft bounces and react in a different way to a
hard bounce. All of the event names are listed as constants in \NetgluePostmark\EventManager\AbstractEvent and are:
Example Logging Listener
There is an example, aggregate listener in \NetgluePostmark\Listener\LoggingListener that you can attach by reading the
comments in the dist config file config/postmark.local.php.dist.
Events are triggered by \NetgluePostmark\Service\EventEmitter - Using a delegator factory targeting that is the
easiest way of subscribing to events as your listeners will only be retrieved from the container if a post is made to
the webhook.
For docs on writing listeners, refer to the Zend Event Manager Docs.
Test
cd to wherever the module is installed, issue a composer install followed by a composer test.
Contributions
PR's are welcomed. Please write tests for new features.
Support
You're welcome to file issues, but please understand that finding the time to answer support requests is very limited so there might be a long wait for an answer.
About
Netglue makes websites and apps in Devon, England. We hope this is useful to you and we’d appreciate feedback either way :)
All versions of zf-postmark with dependencies
ext-json Version *
zendframework/zend-mvc Version ^3
zendframework/zend-modulemanager Version ^2
zendframework/zend-authentication Version ^2
zendframework/zend-view Version ^2
zendframework/zend-serializer Version ^2
zendframework/zend-eventmanager Version ^3.2
psr/log Version ^1.0
zendframework/zend-crypt Version ^2||^3