====== RSS al Wiki ======

===== Introducció =====


Sobre l'us de l'RSS el millor és fer un petit experiment:

Obriu dues solapes al navegador

  * A la primera (WIKI) entreu a la pàgina: https://eapc.continguts.cat/doku.php  \\ (Si esteu loginat tanqueu la sessió)
  * A la segona (RSS): https://eapc.continguts.cat/feed.php

Si teniu la sessió tancada, llavors veureu que a la segona (RSS) només apareix el títol:  **EAPC Wiki**

Ara bé, si obriu una nova sessió a la primera (WIKI) i recarregueu la segona (RSS). Tindreu accés al contingut.

<note important>
Es a dir, el wiki es un espai privat (amb accés controlat per usuari i
contrasenya) i l'RSS es un sistema públic d'accés a la informació.
</note>

Per això s'ha de tenir present que: 

<note warning>
Al wiki hi ha permisos de document, de carpeta i d'usuari i **l'RSS ha de respectar 
aquest permisos**.
</note>

===== Un segon exemple =====


A l'EAPC Wiki es pot veure al namespace "wiki" dues pàgines d'accés públic, aquestes pàgines
son: 
  * l'**Avís legal** i 
  * una altra amb el títol **"sobre el wiki"**, 

Si entreu a: https://eapc.continguts.cat/feed.php?ns=wiki&mode=list

Veureu l'RSS del namespace **independentment de si teniu una sessió oberta o no**


===== Llavors... com podem fer servir els lectors de RSS amb el wiki? =====

El wiki permet un sistema d'autenticació a l'url ([[http://en.wikipedia.org/wiki/Basic_access_authentication|basic access authentication]]):

<code>
https://eapc.continguts.cat/feed.php?u=EL_TEU_USUARI&p=LA_TEVA_CONTRASENYA
</code>

Es a dir: 

<note>
Podeu introduir el vostre nom d'usuari i contrasenya a l'url.
</note>

Com veureu de seguida, el fet de posar el teu usuari i la teva contrasenya a una
url sense encriptar ni cap altre mesura de seguretat és com molt arriscat... però funciona! \\ (gominoles way of life!). 

Si el teu lector de RSS es segur, podeu posar l'url d'aquesta manera i així llegir 
les novetats al wiki segons el vostre nivell de permisos

===== Opcions =====

Una breu descripció de les opcions:

  * Per veure les modificacions de tot el wiki (Canvis recents): https://eapc.continguts.cat/feed.php
  * Per veure les modificacions d'un namespace: 
    * https://eapc.continguts.cat/feed.php?ns=01_cursos_virtuals
    * https://eapc.continguts.cat/feed.php?ns=01_cursos_virtuals:riscos_laborals
  * Podem afegir més opcions:
    * https://eapc.continguts.cat/feed.php?ns=01_cursos_virtuals&linkto=page (els enllaços aniran a la pàgina i no a les diferències)
    * https://eapc.continguts.cat/feed.php?ns=01_cursos_virtuals&linkto=page&content=html (es mostrarà tot el contingut html de la pàgina)

Opcions:
  * ?ns=01_cursos_virtuals  (Namespace)
  * &type=rss2              (Tipus de Feed: rss, rss1, rss2, atom, atom1)
  * &mode=recent            (Modus: recent, list, search)
  * &linkto=page            (Pàgina destí: page, current, rev, diff)
  * &content=html           (Contingut de cada item al Feed: html, htmldiff, diff, abstract)
  * &num=5                  (Numero de items del feed)
  * &u=EL_TEU_USUARI        (El nom d'usuari wiki)
  * &p=LA_TEVA_CONTRASENYA  (La teva contraseña wiki)



===== Referències =====

Documentació oficial a: http://www.dokuwiki.org/syndication

===== RSS dels comentaris del fòrum d'una pàgina =====
El wiki té un connector que permet crear un enllaç per llegir el RSS dels fòrums.

Només cal afegir un enllaç en una pàgina i fer servir l'URL dels comentaris amb la sintaxi següent:

<code>
{{commentsfeed>.|RSS dels comentaris del fòrum}}
</code>

Aquest enllaç es pot afegir a qualsevol pàgina amb fòrum on es vulgui que els usuaris es puguin sindicar als comentaris

<note important>
**El punt de (commentsfeed>.|) és important!**

El punt és per indicar que es vol els comentaris de la mateixa pàgina. 

Naturalment es pot substituir per l'espai de qualsevol pàgina wiki que tingui un fòrum associat.
</note>

Normalment recomanem posar l'enllaç al costat del fòrum, sota la variable que l'activa, com per exemple:

<code >
~~DISCUSSION~~
\\  \\
{{commentsfeed>.|RSS dels comentaris del fòrum}}
</code>