<commit_before>EmailTrack
======

[![GitHub License](https://img.shields.io/badge/License-MIT%20License-blue.svg)](https://github.com/theshka/EmailTrack/blob/master/LICENSE)
[![Software Version](https://img.shields.io/badge/version-0.3.5-red.svg)](https://github.com/theshka/EmailTrack/archive/master.zip)
[![Github Downloads](https://img.shields.io/github/downloads/theshka/EmailTrack/latest/total.svg)](https://github.com/theshka/EmailTrack/releases)

---

**EmailTrack** This simple PHP class outputs a 'ghost' image/tracking-pixel then
uses PDO & SQLite to track whether or not an email has been seen.

## Download
* [Dev-Master](https://github.com/theshka/EmailTrack/archive/master.zip)
* [Version 0.3.5](https://github.com/theshka/EmailTrack/archive/v.0.3.5.zip)

### Old Versions
* [Version 0.3.0](https://github.com/theshka/EmailTrack/archive/V.0.3.zip)

## Demo
Working Demo: http://tyrexi.us/EmailTrack

## Usage

__Requires__ `PHP 5.3+` & `PDO_SQLITE` driver

- Full instructions and examples are located in the `examples` folder.

- The class file resides in `src/blank.php`

- __You may need to edit paths to the SQLite database/gif in the class settings.__

Note:
> SQLite databases can pose a security risk, and may be downloaded with a direct link! Please take precautions to secure the file. You can so this with Apache `.htaccess` or by making the file hidden.*

This simple PHP class can record opened email messages using tracking pixels. It can serve an image file that would be displayed in an email message when the user opens the message.

The class records each access to the tracking image in a SQLite database accessed using PDO.

It then takes the current request parameters/message-tracking values that are stored in the database like the timestamp, email address and message subject.

Only the first access to the tracking image is recorded. Subsequent access to the same image will be ignored.

## Parameters

```php
$message .= '<img src="/src/blank.php?log=true&subject='.urlencode($subject).'&email='.urlencode($to).'" alt="EmailTrack"/>';
```

|   **Key**   |     **Value**       |
|-------------|---------------------|
| ?log        | true                |
| &subject    | urlencode($subject) |
| &email      | urlencode($to)      |

## License
This project is licensed under the [MIT LICENSE](https://github.com/theshka/EmailTrack/blob/master/LICENSE)

## Contributing
If you would like to help make this software better, please follow our guidelines found in [CONTRIBUTING.md](https://github.com/theshka/EmailTrack/blob/master/CONTRIBUTING.md)

...and a special thank-you to all our  [contributors](https://github.com/theshka/EmailTrack/graphs/contributors)!

## Contact
* Homepage: http://heshka.com
* Alternate:http://www.phpclasses.org/package/9228-PHP-Record-opened-email-messages-using-tracking-pixels.html
* E-mail: <EMAIL>
* KeyBase: https://keybase.io/theshka<commit_msg>Update for Version 0.3.5<commit_after>EmailTrack
======

[![GitHub License](https://img.shields.io/badge/license-MIT%20License-blue.svg)](https://github.com/theshka/EmailTrack/blob/master/LICENSE)
[![Software Version](https://img.shields.io/badge/version-0.3.5-red.svg)](https://github.com/theshka/EmailTrack/archive/master.zip)
[![Github Downloads](https://img.shields.io/github/downloads/theshka/EmailTrack/latest/total.svg)](https://github.com/theshka/EmailTrack/releases)

---

**EmailTrack** This simple PHP class outputs a 'ghost' image/tracking-pixel then
uses PDO & SQLite to track whether or not an email has been seen.

## Download
* [Dev-Master](https://github.com/theshka/EmailTrack/archive/master.zip)
* [Version 0.3.5](https://github.com/theshka/EmailTrack/archive/v.0.3.5.zip)

### Old Versions
* [Version 0.3.0](https://github.com/theshka/EmailTrack/archive/V.0.3.zip)

## Demo
Working Demo: http://tyrexi.us/EmailTrack

## Usage

__Requires__ `PHP 5.3+` & `PDO_SQLITE` driver

- Full instructions and examples are located in the `examples` folder.

- The class file resides in `src/blank.php`

- __You may need to edit paths to the SQLite database/gif in the class settings.__

Note:
> SQLite databases can pose a security risk, and may be downloaded with a direct link! Please take precautions to secure the file. You can so this with Apache `.htaccess` or by making the file hidden.*

This simple PHP class can record opened email messages using tracking pixels. It can serve an image file that would be displayed in an email message when the user opens the message.

The class records each access to the tracking image in a SQLite database accessed using PDO.

It then takes the current request parameters/message-tracking values that are stored in the database like the timestamp, email address and message subject.

Only the first access to the tracking image is recorded. Subsequent access to the same image will be ignored.

## Parameters

```php
$message .= '<img src="/src/blank.php?log=true&subject='.urlencode($subject).'&email='.urlencode($to).'" alt="EmailTrack"/>';
```

|   **Key**   |     **Value**       |
|-------------|---------------------|
| ?log        | true                |
| &subject    | urlencode($subject) |
| &email      | urlencode($to)      |

## License
This project is licensed under the [MIT LICENSE](https://github.com/theshka/EmailTrack/blob/master/LICENSE)

## Contributing
If you would like to help make this software better, please follow our guidelines found in [CONTRIBUTING.md](https://github.com/theshka/EmailTrack/blob/master/CONTRIBUTING.md)

...and a special thank-you to all our  [contributors](https://github.com/theshka/EmailTrack/graphs/contributors)!

## Contact
* Homepage: http://heshka.com
* E-mail: <EMAIL>
* KeyBase: https://keybase.io/theshka
{'fraction_non_alphanumeric': 0.1416114405301709, 'fraction_numerical': 0.00749912800837112, 'mean_word_length': 3.9739809193408497, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 9, 'https://': 26, 'lorem ipsum': 0, 'www.': 1, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 8, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3557497', 'n_tokens_mistral': 1798, 'n_tokens_neox': 1718, 'n_words': 521}