cleidigh/thunderstorm

Tips, Tricks & Examples for Thunderbird E-mail New Add-On Development

ThunderStorm

Tips, Tricks & Examples for Thunderbird E-mail New Add-On Development

The goal of this repository is to provide examples in order to better "weather" the transition to Thunderbird's new extension structure. The new paradigm follows the WebExtension standard followed by most browsers these days.

Obviously Thunderbird has different requirements from a browser extension even if Thunderbird relies and is based on Mozilla's Gecko core framework. Focus will be on the differences and transition issues. The new structure adapted to Thunderbird is termed MailExtension.

To get started with MailExtensions, we suggest to check out these resources first:

• Comparison between XUL/XPCOM Extensions and WebExtensions
• Thunderbird Add-On Developer Guide
• MailExtension API Documentation

The approach I have taken is not so much a tutorial, but rather a set of references including working examples and other transition information. Hopefully this approach will help both new and seasoned developers. For both, pointers to other tutorials or related documentation is also included.

Table of Contents

• TB78 MailExtension Examples - How to get things done
• TB60 to TB68 Conversion Examples
• Scaffolding: Bare metal folder & file structures - Copy and go!

Credits

Icons made by Freepik from www.flaticon.com is licensed by CC 3.0 BY

thunderstorm's Issues

C-style line comment in scaffolding manifest.json?

In:
https://github.com/cleidigh/ThunderStorm/blob/master/examples/scaffolds/tb-mail-ext-bare/manifest.json

there's a line beginning with //. Is that intentional? Is that valid? Even if it is - it merits some explanation.

Default Content Security Policy in Thunderbird 78.0.1 blocking loading of the javascript

Hello Christopher,

first thank you for those hello world mail Extention. I was trying to test those mail Extention yesterday and found that the simplest one i.e. Hello world one is not working in the latest Thunderbird 78.0.1. I manage to get it going only after i edited the default content security policy in the manifest.json to

"content_security_policy": "script-src 'self' 'unsafe-eval'; object-src 'self';",

I am sure this is not the best one and in fact is most likely wrong, but for some reason the JavaScript code was not executing with CSP "self". Maybe you can advice a better CSP that we can use per default in the hello world mail Extension?

Scaffolding page - dead links

The bottom links on the "scaffolding" page of this repo:

https://github.com/cleidigh/ThunderStorm/blob/master/examples/scaffolds/README.md

are dead...