# 💌 mailgo - a different mailto (WIP) ![mailgo screencast](/assets/video/mailgo-screencast.gif) (see it in action! ) See the docs on npm for a more stable version of mailgo, the README of GitHub is referencing to the latest WIP **mailgo**: 0.3.0. ## 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` is totally unstable, use `unpkg` or `npm` to test **mailgo**, thanks!) --- ## usage ### default **by default all the `mailto:` links will be enabled with mailgo automatically** (and with the default usage in the modal will appear also cc, bcc, subject and body parameter, if provided) **Do you want to prevent the spam? Use a _no-spam usage_ instead the default usage** to exclude a single mailto link add to the `` element the class `no-mailgo` like in this example ``` matteo@manzinello.dev ``` ### 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 --- ## examples This is a complete **mailgo** example with the no-spam usage #1: `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)