Integrating Etherpad

[Sammy]

Hi, I have a website where some documents have been uploaded. I am
interested in integrating etherpad such that these uploaded documents
can be opened as an Etherpad 'Pad' from my website. Any pointer?

[John McLear]

You would basically want to "pass" the document href to etherpad..

So basically, you want to generate an ID that you store, this is the ID of the pad.  You then want to pass the href of the document to the import API endpoint with the ID of the pad included in the request, something like...

http://youretherpad.com/p/padID/import?src=/yodawg.doc

Then store the padID with a relation to the documentID in your store.  That way the next time you try to access the document instead of importing you will hit the document.

This is all theoretical btw, someone will need to write the ability to pass a href to the import endpoint.

[Sammy]

Thanks John - this is helpful.
My website would be running on a separate server than Etherpad. Would
it still be feasible to pass documet href to etherpad?

> > can be opened as an Etherpad 'Pad' from my website. Any pointer?- Hide quoted text -
>
> - Show quoted text -

[John McLear]

yep

[Sammy]

As I am very new to Etherpad infrastructure, can you let me know or
point me to any documentation you might have on how the Etherpad
import function can be called from another application instance?

Many thanks!

> > > - Show quoted text -- Hide quoted text -

[John McLear]

You would mostly likely need to extend the API, have a look at the source on github.

https://github.com/Pita/etherpad-lite/blob/master/node/handler/APIHandler.js 

https://github.com/Pita/etherpad-lite/blob/master/node/handler/ImportHandler.js 

https://github.com/Pita/etherpad-lite/blob/master/node/utils/ImportHtml.js