Haraka plugin that allows you to use postfix milter
npm install haraka-plugin-milter[![Build Status][ci-img]][ci-url]
[![Code Climate][clim-img]][clim-url]
[![Greenkeeper badge][gk-img]][gk-url]
[![NPM][npm-img]][npm-url]
Clone me, to create a new plugin!
These instructions will not self-destruct after use. Use and destroy.
See also, How to Write a Plugin and Plugins.md for additional plugin writing information.
Haraka plugins are named like haraka-plugin-something. All the namespace
after haraka-plugin- is yours for the taking. Please check the [Plugins]() page and a Google search to see what plugins already exist.
Once you've settled on a name, create the GitHub repo. On the repo's main page, click the _Clone or download_ button and copy the URL. Then paste that URL into a local ENV variable with a command like this:
``sh`
export MY_PLUGIN_NAME=haraka-plugin-SOMETHING
export MY_PLUGIN_REPO=git@github.com:SOME_ORG/haraka-plugin-SOMETHING.git
Clone and rename the milter repo:
`sh`
git clone git@github.com:haraka/haraka-plugin-milter.git
mv haraka-plugin-milter $MY_PLUGIN_NAME
cd $MY_PLUGIN_NAME
git remote rm origin
git remote add origin $MY_PLUGIN_REPO
Now you'll have a local git repo to begin authoring your plugin
Replaces all uses of the word milter with your plugin's name.
./redress.sh [something]
You'll then be prompted to update package.json and then force push this repo onto the GitHub repo you've created earlier.
- [ ] visit your Travis-CI profile page and enable Continuous Integration testing on the repo
- [ ] enable Code Climate. Click the _code climate_ badge and import your repo.
`sh`
cd /path/to/local/haraka
npm install haraka-plugin-milter
echo "milter" >> config/plugins
service haraka restart
If the default configuration is not sufficient, copy the config file from the distribution into your haraka config dir and then modify it:
`sh``
cp node_modules/haraka-plugin-milter/config/milter.ini config/milter.ini
$EDITOR config/milter.ini
[ci-img]: https://travis-ci.org/haraka/haraka-plugin-milter.svg
[ci-url]: https://travis-ci.org/haraka/haraka-plugin-milter
[ci-win-img]: https://ci.appveyor.com/api/projects/status/CHANGETHIS?svg=true
[ci-win-url]: https://ci.appveyor.com/project/haraka/haraka-CHANGETHIS
[cov-img]: https://codecov.io/github/haraka/haraka-plugin-milter/coverage.svg
[cov-url]: https://codecov.io/github/haraka/haraka-plugin-milter
[clim-img]: https://codeclimate.com/github/haraka/haraka-plugin-milter/badges/gpa.svg
[clim-url]: https://codeclimate.com/github/haraka/haraka-plugin-milter
[gk-img]: https://badges.greenkeeper.io/haraka/haraka-plugin-milter.svg
[gk-url]: https://greenkeeper.io/
[npm-img]: https://nodei.co/npm/haraka-plugin-milter.png
[npm-url]: https://www.npmjs.com/package/haraka-plugin-milter