# 💌 mailgo, a different mailto: more possibilities, less spam (WIP) ![mailgo screencast](/assets/video/mailgo-screencast.gif) (see it in action! ) docs: npm ![npm](https://img.shields.io/npm/v/mailgo.svg?style=flat-square) [![mailgo.min.js size](https://img.shields.io/github/size/manzinello/mailgo/dist/mailgo.min.js.svg?label=mailgo.min.js&style=flat-square)](https://unpkg.com/mailgo@0.3.2/dist/mailgo.min.js) ## what? mailgo will substitute all the `mailto:` links with the **mailgo modal**

--- ## installation add at the end of the `` ``` ... ``` you can also import mailgo in `` using `defer` ``` ... ``` (note: the GitHub `/dist` folder is totally unstable, use `unpkg` to test **mailgo**, thanks!) --- ## usage **by default all the `mailto:` links will be enabled with mailgo automatically** and will appear also cc, bcc, subject and body parameter, if provided (to exclude a single mailto link add to the `` element the class `no-mailgo`) **do you want to prevent the spam? Use a _spam-less usage_ instead the default usage** ### spam-less usage #1 (recommended) `write me!` - add `href="#mailgo"` to `` - add `data-address` and `data-domain` to re-create your email address ### spam-less usage #2 `write me!` - add `class="mailgo"` to `` - add `data-address` and `data-domain` to re-create your email address ### spam-less usage #3 `write me!` - add the attribute `mailgo` to `` - add `data-address` and `data-domain` to re-create your email address ### cc, bcc, body, subject and multiple email addresses **mailgo** also supports cc, bcc, subject and body in spam-less installation using the parameters: - `data-cc-address` and `data-cc-domain` to recreate cc: `data-cc-address@data-cc-domain` - `data-bcc-address` and `data-bcc-domain` to recreate bcc: `data-bcc-address@data-bcc-domain` - `data-subject` for the subject of the email - `data-body` for the body of the email for the default installation you can use the classic mailto parameters and they will appear in the modal mailgo doesn't support multiple email addresses in to, cc and bcc at the moment, but there is an issue for this! --- ## examples this is a complete **mailgo** example with the spam-less usage #1 (and cc, bcc, subject and body): `write me!` This is a more simple example (also with spam-less #1 usage): `write me!` --- ## browsers support // WIP --- ## connected projects ### mailgo Chrome extension (WIP) ### mailgo React component (WIP) --- ## open source helpers [![Open Source Helpers](https://www.codetriage.com/manzinello/mailgo/badges/users.svg)](https://www.codetriage.com/manzinello/mailgo) --- [![NPM](https://nodei.co/npm/mailgo.png?stars=true)](https://www.npmjs.com/package/mailgo)