# 💌 mailgo, a different mailto: more possibilities, less spam (WIP) ![mailgo screencast](/assets/video/mailgo-screencast.gif) (see it in action! ) docs: npm [![Open Source Helpers](https://www.codetriage.com/manzinello/mailgo/badges/users.svg)](https://www.codetriage.com/manzinello/mailgo) ## what? mailgo will substitute all the `mailto:` links with the **mailgo modal** [![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.0/dist/mailgo.min.js)

--- ## 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 _no-spam usage_ instead the default usage** ### no-spam usage #1 (recommended) `write me!` - add `href="#mailgo"` to `` - add `data-address` and `data-domain` to re-create your email address ### no-spam usage #2 `write me!` - add `class="mailgo"` to `` - add `data-address` and `data-domain` to re-create your email address ### no-spam usage #3 `write me!` - add the attribute `mailgo` to `` - add `data-address` and `data-domain` to re-create your email address ### cc, bcc, body and subject **mailgo** also supports cc, bcc, subject and body in no-spam 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 --- ## examples this is a complete **mailgo** example with the no-spam usage #1 (and cc, bcc, subject and body): `write me!` This is a more simple example (also with no-spam #1 usage): `write me!` --- ## browsers support // WIP --- [![NPM](https://nodei.co/npm/mailgo.png?stars=true)](https://www.npmjs.com/package/mailgo)