Loading...
 
Skip to main content

History: PluginTogether

Source of version: 39

Copy to clipboard
            ! Plugin Together
This ((wiki plugin)) is an experimental service for your website from Mozilla Labs called TogetherJS, that makes it surprisingly easy to collaborate in real-time: notify unique urls, co-write, talk, follow pages visited by your buddies. It was formerly known as TowTruck. It was added in ((Tiki12)) and improved in ((Tiki15)), ((Tiki19)) and ((Tiki21)).
Since ((Tiki22)) you can specify a diffeernt server through a new parameter added to the plugin, in case the server side code needed for this plugin to work is no longer working with the default server provided by Mozilla.

You can easily use this plugin in your Tiki installation by means of applying the [https://profiles.tiki.org/Together|Together profile].

__Note__: Together is alpha-quality software. We do not recommend using it in production at this time, even if it looks promising as a Real Time Collaboration (RTC) tool.

{kaltura id="0_k15wunh9"}
!!Parameters
{pluginmanager plugin="together"}
!! Current Limitations
* Before ((Tiki15)): You need to deactivate "__Warn on edit conflict__"  in __Settings -> Wiki -> General preference__  Otherwise, you will get this annoying message: "Override lock and carry on with edit"
* If you are permitting anonymous edits, you'll want to turn off "Anonymous editors must enter anti-bot code (CAPTCHA) " Settings -> Security -> Spam protection
!! Where does it work?
In theory, TogetherJS can work with any feature in Tiki. However, some features in Tiki may need adjusting. The following table is to keep track of the state of each feature.
|| __Version__ | __Feature__ | __Works or not__
12.2 | Wiki pages with wiki syntax | yes
12.2 | Spreadsheet | no
12.2 | Tracker Items | yes (textareas)
12.2 | Drawing with SVG-edit | No
12.2 | Slideshow in view mode | No
12.2 | Slideshow in edit mode | Yes
||
!! Examples
''This code added to a custom module, or a module menupage in a side column:''
{CODE(colors="tiki")}
{together}
{CODE}

''Would produce a TogetherJS button. Once clicked by a user, it will add a TogetherJS widget in the right margin of the window, as in the following image:''

{img src="display842" link="display842" width="600" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

In this example, 
# user Mary has clicked at the button "__CoWrite with Together__" (formerly known as "TowTruck", like in the screenshots)
# the TogetherJS widget is shown up in the right margin of the window
# Once you click at the icon to invite friends, you will get a unique url that you can send over email, sms or any means to your buddies, so that they can start cowriting with you in that Tiki page (tracker item in this example)
# You can also change your default username in Together, set your own avatar, color, etc. In this example Mary sets the avatar to a puppy, and keeps the default brownish-redish font color.
* Additionally you can talk (experimental) or chat with your buddies.


Once you sent the link to your buddy (let's say, user John), and he clicks on it, he will see a window like the following requesting him to accept the collaborative session:

{img src="display843" link="display843" width="300" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

Once accepted, he can log in that Tiki site (if needed), and he will see something similar to Mary. 

{img src="display844" link="display844" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

Clicking at the avatar of your user you will be able to see the options to rename your user, set avatar, font color, etc.

{img src="display845" link="display845" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

In this example, John renamed his Together username accordingly, choose a tennis ball avatar and did set his font color to orange. After that, he continued editing the contents of the tracker item, that became updated in real time in Mary's browser also.

{img src="display846" link="display846" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

!!# Setup up your own server
See:
https://togetherjs.com/docs/#hosting-the-hub-server

On Ubuntu 16.04 servers, you also need to:
# install npm (npm v 3.5.2; node version 4.2.6 are the default versions, and they seem to be ok for PluginTogether to work)

On Ubuntu 16.04 servers, you also need to:
# clone togetherjs code
# symlink /usr/bin/nodejs to /usr/bin/node
# run server binding it to a domain, eventually with https (ideally), using apache proxy to server the node server in port 8080 to users visiting that domain with http or https.
** enable mod proxy proxy_http proxy_wstunnel

Run the server with 
* -+cd /var/www/togetherjs/; node hub/server.js &+-

Check the process with:
+ +ps aux | grep node+-
+ +ps aux | grep hub+-
** http://example.com/status > should say "OK"


!! Related links
* https://togetherjs.com/
* https://blog.mozilla.org/labs/2013/09/reintroducing-togetherjs-formerly-known-as-towtruck/
* https://hacks.mozilla.org/2013/10/introducing-togetherjs/
* http://www.ianbicking.org/blog/2014/03/towards-next-level-of-collaboration.html
* http://www.ianbicking.org/blog/2013/11/nouning-the-verb-of-browsing-and-activity.html
!!Aliases
(alias(PluginTowTruck)) | (alias(Together)) | (alias(Realtime)) | (alias(Mozilla Together)) | (alias(Mozilla TowTruck)) | (alias(TogetherJS))
        

History

Information Version
Marc Laporte 50
Marc Laporte 49
Marc Laporte 48
Marc Laporte 47
Marc Laporte 46
Marc Laporte 45
Marc Laporte 44
Xavier de Pedro 43
Xavier de Pedro minor fixes typos and such 42
Xavier de Pedro minor fixes typos and such 41
Xavier de Pedro improved documentation about new server setup and why, and example url for the new param serverurl (thanks kroky6) 40
Xavier de Pedro 39
Xavier de Pedro quick instructions added from the communication with kroky6 (thanks Victor!) 38
Marc Laporte AutoTOC 37
Marc Laporte 36
Marc Laporte 35
Xavier de Pedro Edit restored by rescue script 2017-04-24T18:09:12+00:00 34
Xavier de Pedro 33
Xavier de Pedro 32
lindon 31
Marc Laporte 30
Marc Laporte 29
Marc Laporte 28
Marc Laporte 27
Marc Laporte 26
Marc Laporte 25
Torsten Fabricius 24
Torsten Fabricius 23
lindon 22
Marc Laporte 21
Marc Laporte 20
Marc Laporte 19
Marc Laporte 18
Marc Laporte 17
Marc Laporte 16
Marc Laporte 15
Marc Laporte Realtime is a good alias 14
Marc Laporte 13
Marc Laporte 12
Marc Laporte Previous name 11
Xavier de Pedro renamed towtruck to together or TogetherJS 10
Marc Laporte 9
Marc Laporte 8
Xavier de Pedro 7
Xavier de Pedro 6
Marc Laporte 5
Xavier de Pedro 4
Xavier de Pedro 3
Xavier de Pedro 2
Xavier de Pedro 1