Notes DokuWiki API XML-RPC

Voir :

Il vaut mieux utiliser JSON-RPC Voir https://www.dokuwiki.org/devel:remote_api

Généralités

Penser à restreindre l'accès à https://wiki.acme.fr/lib/exe/xmlrpc.php depuis le serveur web

Il faut activer l'option :

remote

Active l'API système distante. Ceci permet à d'autres applications d'accéder au wiki via XML-RPC ou d'autres mécanismes.

Voir aussi l'option :

remoteuser

Restreindre l'accès à l'API à une liste de groupes ou d'utilisateurs (séparés par une virgule). Laisser vide pour donner l'accès tout le monde.

Exemple en Python

pip3 install --user dokuwiki

import dokuwiki
 
wiki=dokuwiki.DokuWiki('https://wiki.acme.fr', 'remoteuser', 'P@ssw0rd')
wiki.version
wiki.send('dokuwiki.getVersion')
wiki.title
wiki.pages.list()
[page['id'] for page in wiki.pages.list('Tech')]
 
# Info
wiki.pages.info('Test')
wiki.send('wiki.getPageInfo','Test')
wiki.pages.versions('Test')
 
# Modification, ajout à une page existente
wiki.pages.append('Test', 'http://linuxfr.org/\n\n', sum='Via XML-RPC', minor=True)
 
# Création nouvelle page avec son lien
wiki.pages.set('Test1', 'Test1 : \n * http://linuxfr.org/')
wiki.pages.append('Test', '[[Test1]]', sum='Via XML-RPC', minor=True)
 
# Recherche motif textuel
[x['id'] for x in wiki.pages.search('linuxfr')]
 
# Effacement page ':Test1' et de son lien présent sur ':Test'
import re
wiki.pages.delete('Test1')
newpage=re.sub('\[\[Test1\]\]', '', wiki.pages.get('Test'))
wiki.pages.set('Test', newpage, sum='XML-RPC', minor=True)

Recherche par date

from datetime import datetime
wiki.pages.changes(datetime(2023, 9, 1).timestamp())

Trouver les pages non référencées

Avec l'extension Dokuwiki

orphanswanted plugin

Avec l'API

no_backlink = []
 
for page in wiki.pages.list():
    back_links = wiki.pages.backlinks(page['id'])
    #print(page['id'], '\t', back_links)
    if not back_links:
        no_backlink.append(page['id'])
        #print('\t\t\t', page['id'])
print(no_backlink)

En ligne de commande avec PHP

su - dokuwiki -s /bin/bash -c "php ${DOKUROOT}/bin/wantedpages.php |egrep -v 'playground:playground|sidebar|some:namespaces|wiki:nonexisting|wiki:pagename'"