plugins/TODO.md

   1 https://github.com/shaarli/Shaarli/issues/181 -  Add Disqus or Isso comments box on a permalink page
   2
   3  * http://posativ.org/isso/
   4  * install debian package https://packages.debian.org/sid/isso
   5  * configure server http://posativ.org/isso/docs/configuration/server/
   6  * configure client http://posativ.org/isso/docs/configuration/client/
   7  * http://posativ.org/isso/docs/quickstart/ and add `<script data-isso="//comments.example.tld/" src="//comments.example.tld/js/embed.min.js"></script>` to includes.html template; then add `<section id="isso-thread"></section>` in the linklist template where you want the comments (in the linklist_plugins loop for example)
   8
   9
  10 Problem: by default, Isso thread ID is guessed from the current url (only one thread per page).
  11 if we want multiple threads on a single page (shaarli linklist), we must use : the `data-isso-id` client config,
  12 with data-isso-id being the permalink of an item.
  13
  14 `<section data-isso-id="aH7klxW" id="isso-thread"></section>`
  15 `data-isso-id: Set a custom thread id, defaults to current URI.`
  16
  17 Problem: feature is currently broken https://github.com/posativ/isso/issues/27
  18
  19 Another option, only display isso threads when current URL is a permalink (`\?(A-Z|a-z|0-9|-){7}`) (only show thread
  20 when displaying only this link), and just display a "comments" button on each linklist item. Optionally show the comment
  21 count on each item using the API (http://posativ.org/isso/docs/extras/api/#get-comment-count). API requests can be done
  22 by raintpl `{function` or client-side with js. The former should be faster if isso and shaarli are on ther same server.
  23
  24 Showing all full isso threads in the linklist would destroy layout
  25
  26 -----------------------------------------------------------
  27
  28 http://www.git-attitude.fr/2014/11/04/git-rerere/ for the merge