99 lines
2.2 KiB
Markdown
99 lines
2.2 KiB
Markdown
|
Mail RSS
|
||
|
========
|
||
|
|
||
|
This application allows you to transform emails into an RSS feed without connecting to a mailbox.
|
||
|
|
||
|
![](https://upload.deblan.org/u/2020-11/5fad5081.svg)
|
||
|
|
||
|
Installation
|
||
|
------------
|
||
|
|
||
|
Requirements:
|
||
|
|
||
|
* PHP 7.4
|
||
|
* [Symfony requirements](https://symfony.com/doc/4.2/reference/requirements.html)
|
||
|
* MySQL, PostgreSQL or SQLite
|
||
|
* Mailparse module (php-mailparse)
|
||
|
|
||
|
```
|
||
|
$ git clone https://gitnet.fr/deblan/mail-rss.git
|
||
|
$ cd mail-rss
|
||
|
$ cp .env env.local
|
||
|
$ composer install
|
||
|
```
|
||
|
|
||
|
Populate `.env.local`:
|
||
|
|
||
|
- `APP_ENV`: `prod` or `dev`
|
||
|
- `DATABASE_URL`: [read the documentation](https://symfony.com/doc/5.3/doctrine.html#configuring-the-database)
|
||
|
- `APP_DEFAULT_URI`: URI of the application (without trailing slash)
|
||
|
|
||
|
Be sure that the webserver can read/write `private/`, `var/` and `migrations/`.
|
||
|
|
||
|
```
|
||
|
$ php bin/console -e dev doctrine:migrations:diff
|
||
|
$ php bin/console -e dev doctrine:migrations:exe --up DoctrineMigrations\\VersionXXXXXXXXXXXXX
|
||
|
```
|
||
|
|
||
|
And read the doc to publish a symfony app: https://symfony.com/doc/5.3/deployment.html
|
||
|
|
||
|
Usage
|
||
|
-----
|
||
|
|
||
|
Use case: you want to create a feed of a newsletter named "Foo Bar".
|
||
|
|
||
|
```
|
||
|
$ sudo mkdir /var/lib/mailrss
|
||
|
$ sudo chmod 0770 /var/lib/mailrss
|
||
|
$ sudo chown you-web-user:nogroup
|
||
|
```
|
||
|
|
||
|
Add an alias into your mailserver:
|
||
|
|
||
|
```
|
||
|
# /etc/aliases
|
||
|
mailrss-foobar: "| > /var/lib/mailrss/foobar-$(date +%s) && chmod o+rw /var/lib/mailrss/foobar-$(date +%s)"
|
||
|
```
|
||
|
|
||
|
Then run `$ sudo newaliases`.
|
||
|
|
||
|
Add a mailing in the app:
|
||
|
|
||
|
```
|
||
|
$ php bin/console mailing:new "Fo Bar"
|
||
|
|
||
|
# Oops, you made a mistake in the label, let's fix it
|
||
|
|
||
|
$ php bin/console mailing:list
|
||
|
$ php bin/console mailing:rename xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx "Foo bar"
|
||
|
```
|
||
|
|
||
|
With `mailing:list`, you retrieve the URL of the feed.
|
||
|
|
||
|
In case of you want to delete the mailing:
|
||
|
|
||
|
```
|
||
|
$ php bin/console mailing:delete xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
|
||
|
```
|
||
|
|
||
|
Finally, create a script run in a cron:
|
||
|
|
||
|
```
|
||
|
#!/bin/sh
|
||
|
|
||
|
cd "/path/to/app"
|
||
|
|
||
|
find /var/lib/mailrss -name "foobar-*" | while read MAIL_FILE; do
|
||
|
cat "MAIL_FILE" | php bin/console mail:import xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
|
||
|
|
||
|
rm "MAIL_FILE"
|
||
|
done
|
||
|
```
|
||
|
|
||
|
If you wan create another feed then:
|
||
|
|
||
|
* Create an aliase
|
||
|
* Create a mailing
|
||
|
* Update your script run in the cron
|
||
|
* Get the URI using `mailing:list`
|