Demosphere Project

The firefox extension is meant to help you:

• highlight future dates and keywords on any page on the web
• copy/paste from a web page to the editor in a demosphere event
• create an event simply by selecting text on any web page and hitting a shortcut (or menu)
• import documents (pdf, word, images) found on the web
• a few other small tools (gmap, next ...)

The firefox extension is here: https://demosphere.eu/source-code/firefox-extension/demosphere-firefox-e...
To install it or update it, just click on the link.

Actually an .xpi is just a zip file. So you can unzip it to see the source code.

User Doc

Most features are available from the context menu (right click inside a web page). Two keyboard shortcuts are available for each feature:

• control-shift + key : this works on windows
• "win" + key : this works on linux (the win key is the key between control and alt)

Configuration:

you have to enter the url of your demosphere site in the “preferences†of the plugin. (Firefox menu: Tools→add-ons ; click on “demosphere inputâ€, click on preferences).

Shortcuts

You can configure your shortcuts thru Firefox menu: Tools→add-ons ; click on “demosphere inputâ€, click on preferences.

If you need more key configuration, use keyconfig extension.

Highlight

This will highlight any future dates and keywords on any page on the web. You can then click on future dates and will get a popup with a list of events on that date. This useful, for example, to see if you already have that event.

Shortcuts: control-shift-S ; win-space

This feature is very heavily used in daily editorial work on demosphere.eu.

Note: you have to be logged in to your demosphere site so the highlighting can work.

Technical note: To highlight, the web page is sent to the server, and the server sends it back to the browser. If your server is slow, or if the web page you want to highlight is very big, the highlighting can take some time. If you are running a web server on your local computer with a copy of demosphere, you can speed this up a lot, by entering your local webserver's url (for example http://localhost/demosphere) in the local_site preference.

copy/paste

When you edit an event in the editor of the event form, you can copy text and images from any other web page. You copy / paste two ways:

1. using the normal copy - paste (ctrl-c ctrl-v).
2. using demosphere copy and normal paste (“winâ€-c ctrl-v) (or ctrl-shift-c ctrl-v)

The first method (normal copy/paste) can introduce strange formating problems in your editor. You can fix this by clicking on the “wand†tool (tidy). This method may also have potential security problems (XSS attacks)… though I (Marcel) am not 100% sure of this.

The second method processes the selection when you do the copy (this can take a few seconds if there are large images). When you paste into the editor,the html will already be cleaned up. The second method also adds a “Source†link to so poeple know where your text came from. It can also transfer some other useful information (ex: email addresses, when copying from the email component).

import documents

You can right click on an image or on a link to a pdf,word,rtf,OpenOffice… document. This will help you import the document into demosphere.

gmap

When you go to google maps, you will find a red “copy to demosphere†button. This will copy the link to the current map to the demosphere event that you are currently editing. This just saves a few clicks.

feed import : "next" button

In feed import, there is a “next†button that helps you scroll through highlighted dates and keywords. For technical (security) reasons, this can't be implemented in ordinary javascript. So you will need this firefox plugin so that the button will work.