Add descriptions, screenshots and screenshots

for 1.0 release! 🎉
This commit is contained in:
rugk 2018-12-17 16:16:37 +01:00
parent f13b1e4aec
commit 970f80f5c0
No known key found for this signature in database
GPG key ID: 05D40A636AFAB34D
23 changed files with 92 additions and 51 deletions

View file

@ -5,7 +5,7 @@
[![Mozilla Add-on users](https://img.shields.io/amo/users/mastodon-simplified-federation.svg)](https://addons.mozilla.org/de/firefox/addon/mastodon-simplified-federation/statistics/)
[![Mozilla Add-on stars](https://img.shields.io/amo/stars/mastodon-simplified-federation.svg)](https://addons.mozilla.org/de/firefox/addon/mastodon-simplified-federation/reviews/)
Simplifies following or interacting with other users on remote instances. Basically, it skips the "Enter your Mastodon handle" interface and takes you directly to your own "home" instance, when you click on a "Follow" button or a reply/retoot/fav button on another instance. :smile:
Simplifies following or interacting with other users on remote Mastodon instances in the Fediverse. Basically, it skips the "Enter your Mastodon handle" popup and takes you directly to your own "home" instance, saving you from cumbrously entering your Mastodon handle again and again in that input box when you click on a "Follow", "Retoot"/"Fav" or other remote interaction button on another instance. :smile:
[Idea by](https://social.wxcafe.net/@akkes/100550833588126733) [@akkes](https://social.wxcafe.net/@akkes).
@ -13,15 +13,19 @@ Simplifies following or interacting with other users on remote instances. Basica
**[![Get it for Firefox!](https://addons.cdn.mozilla.net/static/img/addons-buttons/AMO-button_1.png)](https://addons.mozilla.org/de/firefox/addon/mastodon-simplified-federation?src=external-github-download)**
### Why?
## In …
[![GIF demo showing how I click on a reply button and directly get to the toot site and how I click on follow and directly get to the page, where I can click Follow](assets/screencasts/mastodonSimplifiedFederationDemo.gif)]((assets/screencasts/mastodonSimplifiedFederationDemo.gif))
## Why?
You may wonder why to use this browser add-on. But actually, it's easy!
You do not need to enter your Mastodon account handle anymore! (except for login :wink:) This makes interacting with remote instances much simpler.
Additionally, this add-on makes sure to keep your Mastodon handle **private**. It will never expose it into any third-party site. As such, e.g., it does not literally enter your Mastodon ID into the input field you normally see, but basically "skips" this page. For the technical details, on how this works, see [How does it work?](#how-does-it-work) below.
Additionally, this add-on makes sure to keep your Mastodon handle **private**. It will never expose it to any third-party site. Therefore it does not literally enter your Mastodon ID into the input field you normally see, but basically "skips" this page. For the technical details, on how this works, see [How does it work?](#how-does-it-work) below.
### How does it work?
## How does it work?
1. It intercepts any remote interaction popup/request.
2. It tries to get the toot/account you want to interact with from the "Enter your Mastodon ID" popup.

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.2 MiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

Binary file not shown.

After

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Binary file not shown.

After

Width:  |  Height:  |  Size: 84 KiB

Binary file not shown.

Binary file not shown.

After

Width:  |  Height:  |  Size: 88 KiB

Binary file not shown.

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.9 KiB

View file

@ -1,21 +1,20 @@
This add-on makes it easier for you to follow or interact with other users on remote instances. Basically, it skips the "Enter your Mastodon handle" interface and takes you directly to your own "home" instance, when you click on a "Follow" button or a reply/retoot/fav button on another instance.
Dieses Add-on vereinfacht das Folgen und Interagieren mit Nutzern auf entfernten Instanzen im Fediverse. Im Grunde überspringt es einfach den "Gib dein Mastodon-Handle ein"-Popup und bringt dich direkt zu deiner eigenen "Heiminstanz" ohne die wiederkehrende umständliche Eingabe deines Mastodon-Handles in der Eingabebox, wenn du auf "Folgen", "Retoot"/"Fav" oder ähnliches Remote-Interaction-Knöpfen auf anderen Instanzen klickst.
<b>Why?</b>
You may wonder why to use this browser add-on. But actually, it's easy!
<b>Warum?</b>
Du magst dich wundern, warum du dieses Add-on nutzen solltest. Eigentlich ist es einfach!
You do not need to enter your Mastodon account handle anymore! (except for login ;) ) This makes interacting with remote instances much simpler.
Du musst, wenn du das Add-on nutzt, dein Mastodon-Handle <b>nicht mehr eingeben</b>! (abgesehen vom Login ;) ) Dies macht das Interagieren mit entfernten Instanzen im Fediverse sehr viel einfacher.
Additionally, this add-on makes sure to keep your Mastodon handle <b>private</b>. It will never expose it into any third-party site. As such, e.g., it does not literally enter your Mastodon ID into the input field you normally see, but basically "skips" this page. For the technical details, on how this works, see <a href="https://github.com/rugk/mastodon-simplified-federation#how-does-it-work" title="How does it work?">the detailed explanation on GitHub</a>.
Zusätzlich stellt dieses Add-on sicher, dass es dein Mastodon-Handle <b>privat</b> bleibt. Es wird es niemals in irgendeine Drittparteien-Seite senden. Deshalb gibt es beispielsweise auch nicht wortwörtlich deine Mastodon-ID in das Eingabefeld ein, dass du normalerweise siehst, sondern es überspringt diesen Schritt bzw. die Seite. Für die technischen Details, wie dies funktioniert schau dir die <a href="https://github.com/rugk/mastodon-simplified-federation#how-does-it-work" title="How does it work?">detaillierte Anleitung auf GitHub an</a>.
<b>How to use?</b>
After you have installed the add-on, you need to go into the settings, enter your Mastodon handle (that is <code>username@server</code>). After this is done, there is nothing to do anymore.
It will continue to work in the background and you do not need to do anything.
Just enjoy the simplified federation
<b>Wie benutze ich es?</b>
Nachdem du das Add-on installiert hast, gehe in die Einstellungen und gib dein Mastodon-Handle ein (dies lautet <code>Nutzername@Server</code>). Ist dies getan, gibt es nichts, was du weiter tun musst. Das Add-on wird automatisch im Hintergrund arbeiten und du musst nichts weiter tun.
Genieße einfach die vereinfachte Förderation, wenn du automatisch weitergelietet wirst, wenn du einem anderen Nutzer folgst oder mit ihm interagierst.
<b>What is Mastodon?</b>
Mastodon is a new and friendly social network that is decentralized. To be exact, it is "federated" meaning you can be on one server and follow another user on a different server.
For that, you usually need to enter your Mastodon ID on the "foreign" server. This add-on removes this step.
Find out more about Mastodon at <a href="https://joinmastodon.org/">joinmastodon.org</a>.
<b>Was ist Mastodon?</b>
Mastodon ist eine neues und freundlichen soziales Netzwerk, dass dezentralisiert arbeitet. Um genau zu sein, ist es "förderiert", dass heißt du hast dein Nutzerkonto auf einem Server und kannst mit diesem Konto aber Nutzern auf anderen Servern folgen und mit ihnen interagieren.
Um dies zu tun, musst du üblicherweise deine Mastodon-ID auf diesen anderen, "fremden" Server eingeben, damit sie wissen, zu welchem Server sie dich zum umleiten müssen. Dieses Add-on entfernt bzw. automatisiert diesen Schritt.
Du kannst mehr über Mastodon auf <a href="https://joinmastodon.org/">joinmastodon.org</a> heraus finden.

View file

@ -0,0 +1,5 @@
remoteFollow.png; "Wenn du jemanden auf einer entfernten Instanz folgen willst, …";
remoteFollowRedirectCropped.png; "…wird dies automatisch umgeleitet,";
interactWithToot.png; "…oder wenn du mit einem Toot von jemandem interagieren willst,";
interactWithTootRedirect.png; "…, wird dies auch umgeleitet.";
settings.png; "Alles geschieht automatisch im Hintergrund. Du musst nur dein Mastodon-Handle angeben.";
1 remoteFollow.png Wenn du jemanden auf einer entfernten Instanz folgen willst, …
2 remoteFollowRedirectCropped.png …wird dies automatisch umgeleitet,
3 interactWithToot.png …oder wenn du mit einem Toot von jemandem interagieren willst,
4 interactWithTootRedirect.png …, wird dies auch umgeleitet.
5 settings.png Alles geschieht automatisch im Hintergrund. Du musst nur dein Mastodon-Handle angeben.

View file

@ -0,0 +1 @@
Vereinfacht das Folgen und Interagieren mit Nutzern auf entfernten Mastodon-Instanzen im Fediverse. Es überspringt den "Gib dein Mastodon-Handle ein"-Popup und bringt dich ohne lästige Eingabe deines Mastodon-Handles direkt zu deiner eigenen Instanz.

View file

@ -1,25 +1,18 @@
# Erfragte Berechtigungen
Für eine allgemeine Erklärung von Add-on-Berechtigungen siehe [diesen Support-Artikel](https://support.mozilla.org/kb/permission-request-messages-firefox-extensions).
Für eine allgemeine Erklärung von Add-on-Berechtigungen siehe [diesen Support-Artikel]https://support.mozilla.org/de/kb/berechtigungsdialoge-der-firefox-erweiterungen).
## Berechtigungen bei Installation
Zurzeit werden bei Installation des Add-ons oder beim Update keine Berechtigungen abgefragt.
## Feature-spezifische (optionale) Berechtigungen
Diese Berechtigungen werden bei bestimmten Aktionen abgefragt, wenn sie dafür benötigt werden.
| Interne ID | Berechtigung | Abgefragt bei… | Erklärung |
|:------------|:-------------------------------------------------------------------|:-------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `downloads` | Dateien herunterladen und die Download-Chronik lesen und verändern | Speichern des QR-Codes als SVG | Benötigt um den SVG-Download zu starten und dem Nutzer eine Möglichkeit zur Auswahl des Speicherortes zu geben. Dieses Add-on greift nicht auf Downloads zu, es benötigt diese Berechtigung nur, um den Download des Bildes zu starten. |
| Interne ID | Berechtigung | Erklärung |
|:----------------------------|:-------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `http://*/*`, `https://*/*` | Auf Ihre Daten für alle Websites zugreifen | Benötigt um Zugriff auf jede Webseite eines Servers zu bekommen, die eine Mastodon-Instanz ist. Da jeder Server eine Mastodon-Instanz sein kann, benötigt dies Zugriff auf jede [HTTP](https://de.wikipedia.org/wiki/Hypertext_Transfer_Protocol)- und [HTTPS](https://de.wikipedia.org/wiki/Hypertext_Transfer_Protocol_Secure)-[URL](https://de.wikipedia.org/wiki/Uniform_Resource_Locator). |
## Versteckte Berechtigungen
Zusätzlich verlangt dieses Add-on folgende Berechtigungen, welche in Firefox aber nicht abgefragt werden, da sie keine tiefgreifenden Berechtigungen sind.
| Interne ID | Berechtigung | Erklärung |
|:------------|:----------------------------------|:------------------------------------------------------------------------------|
| `activeTab` | Auf aktuelle Webseite zugreifen | Benötigt, um die URL des aktuellen Tabs für den QR-Code zu erhalten |
| `storage` | Zugriff auf lokalen Speicher | Benötigt um Einstellungen abzuspeichern |
| `menus` | Browser-Kontextemnüs modifizieren | Benötigt um Kontextmenueinträge wie "QR-Code aus Auswahl" (etc.) hinzuzufügen |
| Interne ID | Berechtigung | Erklärung |
|:-------------|:-----------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `webRequest` | Zugriff auf Webanfragen | Benötigt um [URLs](https://de.wikipedia.org/wiki/Uniform_Resource_Locator) auf den Server, bei dem du deinen Mastodon-Account gespeichert hast, umzuleiten. |
| `storage` | Zugriff auf lokalen Speicher | Benötigt um Einstellungen abzuspeichern |

View file

@ -1,3 +1,20 @@
Dieses Add-on sendet keine Informationen zum Add-on-Autor oder einer Drittpartei.
Definitionen:
ADD-ON die Software, für die diese Datenschutzrichtlinie gilt
NUTZER der Nutzer dieses ADD-ON's
ENTFERNTER SERVER, ENTFERNTEN SERVER ein Server im Internet, identifiziert durch eine Serveradresse (Domain-Name)
ENTFERNTER NUTZER, ENTFERNTEN NUTZER ein Nutzeraccount gespeichert auf einem Server im Internet, bestehend aus dem Namen des Nutzers und der Server-Adresse auf der ein Nutzer registriert ist, dem ENTFERNTEN SERVER
ENTFERNTE NACHRICHT jede Form eine Nachricht, eingeschlossen aber nicht limitiert auf Text-, Multimedia-, Audio- und Videonachrichten; veröffentlicht durch einen ENTFERNTEN NUTZER, gespeichert auf einem ENTFERNTEN SERVER
Eine Erklärung aller Berechtigungen, die dieses Add-on erfragt kann auf https://github.com/rugk/offline-qr-code/blob/master/assets/texts/de/permissions.md gefunden werden.
Dieses ADD-ON sendet keine personenbezogene Informationen zum Autor des ADD-ONs.
EIGENER ACCOUNT, EIGENEN ACCOUNT ein Nutzerkonto gespeichert auf einem Server im Internet, bestehend aus dem Namen des Nutzers und der Server-Adresse auf der ein Nutzer registriert ist, der NUTZER des ADD-ONs hat dieses Nutzerkonto in den Einstellungen des ADD-ONs als sein eigenes angegeben
EIGENER SERVER, EIGENEN SERVER ein Server im Internet, identifiziert durch eine Serveradresse (Domain-Name); der NUTZER des ADD-ONs hat in den Einstellung des ADD-ON's dieses als den Server angegeben, auf dem sein EIGENER ACCOUNT gespeichert ist
Wenn eine Internetadresse (Uniform Resource Locator, URL) auf eine spezifischen Weise zugegriffen wird, die darauf hindeutet, dass der NUTZER einem ENTFERNTEN NUTZER folgen oder anderweitig mit ihm oder einer ENTFERNTEN NACHRICHT, veröffentlicht durch den ENTFERNTEN NUTZER auf dem ENTFERNTEN SERVER, interagieren will, kann es den NUTZER zu den in dem vom NUTZER in den Einstellungen des ADD-ONs als EIGENEN SERVER festgelegtem Server umleiten.
Um dies zu tun, kann das ADD-ON den ENTFERNTEN SERVER und EIGENEN SERVER kontaktieren und Informationen über den ENTFERNTEN NUTZER und die ENTFERNTE NACHRICHT senden.
Zusätzlich kann es Informationen über den EIGENEN ACCOUNT und EIGENEN SERVER and den EIGENEN SERVER senden.
Das ADD-ON wird keinerlei Informationen über den EIGENEN ACCOUNT oder EIGENEN SERVER an einen ENTFERNTEN SERVER senden. Falls dieser Fall unbeabsichtigt auftreten sollte, so wird dies als Sicherheitslücke im ADD-ON behandelt.
Es kann allerdings passieren, dass der ENTFERNTE SERVER der selbe ist wie der EIGENE SERVER. In diesem Fall arbeitet dass ADD-ON genauso und kann demzufolge alle Informationen an einen Server senden.
Eine Erklärung aller Berechtigungen, die dieses ADD-ON erfragt kann auf https://github.com/rugk/mastodon-simplified-federation/blob/master/assets/texts/de/permissions.md gefunden werden.

View file

@ -1,21 +1,20 @@
This add-on makes it easier for you to follow or interact with other users on remote instances. Basically, it skips the "Enter your Mastodon handle" interface and takes you directly to your own "home" instance, when you click on a "Follow" button or a reply/retoot/fav button on another instance.
This add-on simplifies following or interacting with other users on remote Mastodon instances in the Fediverse. Basically, it skips the "Enter your Mastodon handle" popup and takes you directly to your own "home" instance, saving you from cumbrously entering your Mastodon handle again and again in that input box when you click on a "Follow", "Retoot"/"Fav" or other remote interaction button on another instance.
<b>Why?</b>
You may wonder why to use this browser add-on. But actually, it's easy!
You do not need to enter your Mastodon account handle anymore! (except for login ;) ) This makes interacting with remote instances much simpler.
You do <b>not need to enter</b> your Mastodon account handle anymore! (except for login ;) ) This makes interacting with remote instances in the Fediverse much simpler.
Additionally, this add-on makes sure to keep your Mastodon handle <b>private</b>. It will never expose it into any third-party site. As such, e.g., it does not literally enter your Mastodon ID into the input field you normally see, but basically "skips" this page. For the technical details, on how this works, see <a href="https://github.com/rugk/mastodon-simplified-federation#how-does-it-work" title="How does it work?">the detailed explanation on GitHub</a>.
Additionally, this add-on makes sure to keep your Mastodon handle <b>private</b>. It will never expose it to any third-party site. Therefore it does not literally enter your Mastodon ID into the input field you normally see, but basically "skips" this page. For the technical details, on how this works, see <a href="https://github.com/rugk/mastodon-simplified-federation#how-does-it-work" title="How does it work?">the detailed explanation on GitHub</a>.
<b>How to use?</b>
After you have installed the add-on, you need to go into the settings, enter your Mastodon handle (that is <code>username@server</code>). After this is done, there is nothing to do anymore.
It will continue to work in the background and you do not need to do anything.
Just enjoy the simplified federation
After you have installed the add-on, you need to go into the settings, enter your Mastodon handle (that is <code>username@server</code>). After this is done, there is nothing you need to do anymore. The add-on will continue to work in the background and you do not need to do anything.
Just enjoy the simplified federation when you are getting redirected automatically when you want to follow or interact with a user.
<b>What is Mastodon?</b>
Mastodon is a new and friendly social network that is decentralized. To be exact, it is "federated" meaning you can be on one server and follow another user on a different server.
For that, you usually need to enter your Mastodon ID on the "foreign" server. This add-on removes this step.
Mastodon is a new and friendly social network that is decentralized. To be exact, it is "federated", i.e. you have your own user account on one server and can follow and interact with other users on different servers.
For that, you usually need to enter your Mastodon ID on these "foreign" server, so they know what server they have to redirect to. This add-on removes, respectively automates, this step.
Find out more about Mastodon at <a href="https://joinmastodon.org/">joinmastodon.org</a>.

View file

@ -0,0 +1,5 @@
remoteFollow.png; "If you follow someone from a remote instance…";
remoteFollowRedirectCropped.png; "…it gets redirected automatically,";
interactWithToot.png; "…or if you interact with a toot,";
interactWithTootRedirect.png; "…, it also gets redirected.";
settings.png; "Everything is done automatically in the background. You only need to enter one thing: your Mastodon handle.";
1 remoteFollow.png If you follow someone from a remote instance…
1 remoteFollow.png If you follow someone from a remote instance…
2 remoteFollowRedirectCropped.png …it gets redirected automatically,
3 interactWithToot.png …or if you interact with a toot,
4 interactWithTootRedirect.png …, it also gets redirected.
5 settings.png Everything is done automatically in the background. You only need to enter one thing: your Mastodon handle.

View file

@ -1 +1 @@
Simplifies following or interacting with other users on remote Mastodon instances. Basically, it skips the "Enter your Mastodon handle" popup and takes you directly to your own "home" instance, when you click on a "Follow" button on another instance.
Simplifies following or interacting with other users on remote Mastodon instances in the Fediverse. It skips the "Enter your Mastodon handle" popup and takes you to your own "home" instance, without entering your Mastodon handle on remote instances.

View file

@ -4,13 +4,14 @@ For a general explanation of add-on permission see [this support article](https:
## Installation permissions
Currently no permissions are requested at the installation or when updating.
| Internal Id | Permission | Explanation |
|:----------------------------|:----------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `http://*/*`, `https://*/*` | Access your data for all websites | Needed for getting access to any website of a server that could be a Mastodon instance. As any server could be a Mastodon instance, this needs to get access to all [HTTP](https://en.wikipedia.org/wiki/HTTP) and [HTTPS](https://en.wikipedia.org/wiki/HTTPS) [URLs](https://en.wikipedia.org/wiki/Uniform_Resource_Locator). |
## Hidden permissions
Additionally it requests these permission, which are not requested in Firefox when the add-on is installed, as they are not a serious permission.
| Internal Id | Permission | Explanation |
|:------------|:-----------------------------|:------------------------------------------------------------------|
| `activeTab` | Access current tab website | Needed for getting the URL of the current website for the QR code |
| `storage` | Access local storage | Needed for saving options |
| `menus` | Modify browser context menus | Needed for adding context menus "QR code from selection" (etc.) |
| Internal Id | Permission | Explanation |
|:-------------|:---------------------|:-------------------------------------------------------------------------------------------------------------------------------------------|
| `webRequest` | Access web requests | Needed for redirecting [URLs](https://en.wikipedia.org/wiki/Uniform_Resource_Locator) to the server, where you have your Mastodon account. |
| `storage` | Access local storage | Needed for saving options |

View file

@ -1,3 +1,20 @@
This add-on does not send any information to the add-on author or any third-party.
Definitions:
ADD-ON the software that this policy applies to
USER the USER of the ADD-ON
REMOTE SERVER a server in the internet, identified by a server address (domain name)
REMOTE USER a USER account saved on a server in the internet, consists of a USER's name and the server address a USER is registered on, the REMOTE SERVER
REMOTE MESSAGE any form of message, including but not limited to text, multimedia, audio and video; published by a REMOTE USER and saved on a REMOTE SERVER
An explanation of all permissions, this add-on requests, can be found at https://github.com/rugk/offline-qr-code/blob/master/assets/texts/en/permissions.md.
This ADD-ON does not send any personally identifiable information to the ADD-ON author.
OWN ACCOUNT a USER account saved on a server in the internet, consists of a USER's name and the server address, the USER of the ADD-ON has declared in the settings of this ADD-ON that this account is owned by them
OWN SERVER the server in the internet, identified by a server address (domain name); the USER of the ADD-ON has declared in the settings of this ADD-ON to have saved it's OWN ACCOUNT on this server
If an Uniform Resource Locator (URL) in a specified way is accessed, that indicates you are trying to follow REMOTE USER or otherwise interact with the REMOTE USER or a REMOTE MESSAGE published by a REMOTE USER on a REMOTE SERVER, it can redirect the USER to a server you have specified in the settings of the ADD-ON as an OWN SERVER.
To do so, the ADD-ON may contact the REMOTE SERVER and LOCAL SERVER and send information about the REMOTE USER and REMOTE MESSAGE.
Additionally, it may send information about the OWN ACCOUNT and OWN SERVER to OWN SERVER.
The ADD-ON will not send information about your OWN ACCOUNT or OWN SERVER to any REMOTE SERVER. If that case should inadvertently happen, it is considered a vulnerability in the ADD-ON.
It may happen, however, that the REMOTE SERVER is the same as the OWN SERVER. In such a case, the ADD-ON works the same and may thus send all the information to it's own server.
An explanation of all permissions, this ADD-ON requests, can be found at https://github.com/rugk/mastodon-simplified-federation/blob/master/assets/texts/en/permissions.md.