Filtering options

[murmelbahn]

Hi,
really great project!

I have some applications which sends HTML encoded mails to mailrise.
Sadly matrix is not able to output the content correct. So I get some random gibbish in the notification.

Would it be possible to only pass through the subject of the mail? Most of the informations are in there so
it's okay when i don't get the body of the message. I think this solution is way easier then removing the HTML content.

[YoRyan]

I'm curious: How badly does Matrix mangle the HTML? I wonder if it merits filing an upstream bug with Apprise.

As to filtering content, I have a more general solution in mind. How about allowing users to specify template strings to construct the title and body with? This is how they would look assuming the current behavior:

configs:
  my_matrix:
    urls:
      - matrix://whatever
    mailrise:
      title_template: "$subject ($from)"
      body_template: "$content"

In your case, you could specify body_template: "" to suppress the body. I'm thinking it could also be useful to have a $content_plain variable that would strip any HTML markup.

[murmelbahn]

Hi,
as you can see in the wiki of apprise, matrix is only capable of plain text messages:
https://github.com/caronc/apprise/wiki/Notify_matrix

So you see the whole HTML code in the message mailrise is forwarding.

The solution by using template strings would be nice. Stripping the HTML markup is unnecessary I think. If you have some really fancy HTML mail, the stripping would not be able to make the mail/message readable.

[YoRyan]

According to the developer docs, Apprise is supposed to "do the right thing" if it receives HTML or Markdown for a service that only supports plain text:

Developers should know that Apprise passes everything it gets as is which will work for most circumstances. However sometimes it's useful to let apprise know the data you're feeding it. This information is used to guarantee that the upstream provider can handle the content, and if it can't, it will be modified so that it does.

In my opinion that should include stripping any markup, but Apprise clearly isn't doing that for us. 🤷 I'll leave it to upstream to implement that if there is demand for it.

[YoRyan]

Template strings are now implemented and documented!