# 💌 mailgo - a different mailto (WIP)

![mailgo screencast](/assets/video/mailgo-v0.2.1-screencast.gif)
(see it in action! <https://mailgo.js.org>)

## what?

mailgo will substitute all the `mailto:` links with the **mailgo modal**, in less than 7KB

[![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://cdn.jsdelivr.net/npm/mailgo@latest/dist/mailgo.min.js)

<img src="assets/img/screen-1.png" alt="mailgo modal" width="200"/>

---

## installation

add at the end of the `<body>`

```
<body>
...
<script src="https://cdn.jsdelivr.net/npm/mailgo@latest/dist/mailgo.min.js"></script>
</body>
```

or

```
<body>
...
<script src="https://unpkg.com/mailgo@latest/dist/mailgo.min.js"></script>
</body>
```

or download the script <a download href="https://unpkg.com/mailgo@latest/dist/mailgo.min.js">here</a> and

```
<body>
...
<script src="path/to/mailgo/mailgo.min.js"></script>
</body>
```

you can also import mailgo in `<head>` using `defer`

```
<head>
...
<script src="https://cdn.jsdelivr.net/npm/mailgo@latest/dist/mailgo.min.js" defer></script>
</head>
```

---

## usage

### default

**by default all the `mailto:` links will be enabled with mailgo only importing the script!**

(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

### no-spam usage #1 (recommended)

`<a href="#mailgo" data-address="matteo" data-domain="manzinello.dev">write me!</a>`

- add `href="#mailgo"` to `<a>`
- add `data-address` and `data-domain` to re-create your email address

### no-spam usage #2

`<a class="mailgo" data-address="matteo" data-domain="manzinello.dev">write me!</a>`

- add `class="mailgo"` to `<a>`
- add `data-address` and `data-domain` to re-create your email address

#### exclude a mailto

to exclude a mailto link add to the `<a>` element the class `no-mailgo` like in this example:

```
<a class="no-mailgo" href="mailto:matteo@manzinello.dev">matteo@manzinello.dev</a>
```

---

[![NPM](https://nodei.co/npm/mailgo.png)](https://nodei.co/npm/mailgo/)

<https://mailgo.js.org>
