Kensan.it

𝒞ome creare un semplicissimo addon per Firefox usando una distribuzione Linux come Mageia. Prima di tutto ho installato node.js dai repository di Mageia, dentro node dovrebbe esserci npm e quindi dentro npm dovrebbe esserci jpm. In pratica ho installato solo node.js e poi ho dato da root il comando:

# npm install jpm --global

senza ottenere errori, ovviamente ci si può assicurare che npm sia installato con un $ which npm. Quindi ho dato il comando da utente:

$ jpm

ottenendo l'help del comando, in alternativa si può dare un $ which jpm. Quindi ho iniziato a costruire l'addon con:

$ cd
$ mkdir addon
$ cd addon
$ jpm init

jpm init è l'inizializzatore dell'addon che fa una serie di domande generiche per i dati generali dell'addon, premere return se si accetta l'impostazione di default. Questi dati sono messi in package.json dentro la nostra cartella addon.

Quindi si parte con la costruzione dell'addon premettendo che io ho index.js come file per lo script, quindi usando nano come editor si da:

$ nano index.js

e si inserisce il codice che nel mio caso è:

var contextMenu = require("sdk/context-menu");
var tabs = require("sdk/tabs");
 var menuItem = contextMenu.Item({
  label: "Translation (en=>it)",
  context: contextMenu.SelectionContext(),
  contentScript: 'self.on("click", function () {' +
                 ' var text = window.getSelection().toString();' +
                 ' self.postMessage(text);' +
                 '});',
  onMessage: function (selectionText) {
    tabs.open("http://it.dicios.com/enit/" + selectionText);
  }
});

Questo addon nel caso di un testo selezionato e della pressione del tasto destro del mouse sopra il testo selezionato, visualizza nel menù contestuale una voce dal nome contenuto in "label" e cioè "Translation (en=>it)". Selezionando questa voce dal menù contestuale apre un tab nuovo con dentro il sito "http://it.dicios.com/enit/" + selectionText, dove selctionText è il testo selezionato. Tale sito visualizza la traduzione in italiano dell'eventuale parola in inglese selezionata.




Il codice per il menù contestuale è stato copiato da qui, mentre il codice per l'apertura del nuovo tab da qui.

Ora si passa a provare l'addon con un:

$ jpm run -b /usr/bin/firefox

dove occorre indicare il path di Firefox ($ which firefox). Viene usato un profilo nuovo ad ogni avvio di questo comando, non viene usato il profilo presente in ~/.mozilla. Se tutto va bene allora si può passare alla fase seguente:

$ jpm xpi

crea il file xpi dentro la nostra cartella addon e quindi possiamo installarlo nel nostro Firefox. Questo è il file xpi che ho fatto, il nome è Translate.xpi. Questo invece è il file xpi firmato da Mozilla che richiede di essere firmato dalla versione 44 in poi, il nome è my_translation_addon-0.0.1-fx+an.xpi