xref: /dokuwiki/lib/exe/xmlrpc.php (revision 9b41be2446ea725a496f34b28ac4db84bece57c9)
1797c0d11SAndreas Gohr<?php
27aec69d1SGuy Brandif(!defined('DOKU_INC')) define('DOKU_INC',dirname(__FILE__).'/../../');
3797c0d11SAndreas Gohr
4797c0d11SAndreas Gohr// fix when '< ?xml' isn't on the very first line
5797c0d11SAndreas Gohrif(isset($HTTP_RAW_POST_DATA)) $HTTP_RAW_POST_DATA = trim($HTTP_RAW_POST_DATA);
6797c0d11SAndreas Gohr
7445e8084SAndreas Gohr/**
8445e8084SAndreas Gohr * Increased whenever the API is changed
9445e8084SAndreas Gohr */
10e6f4c9d4SGeorges-Etienne Legendredefine('DOKU_XMLRPC_API_VERSION',4);
11797c0d11SAndreas Gohr
12797c0d11SAndreas Gohrrequire_once(DOKU_INC.'inc/init.php');
13797c0d11SAndreas Gohrsession_write_close();  //close session
14593bf8f6SMichael Klier
153ee5b583SAndreas Gohrif(!$conf['xmlrpc']) die('XML-RPC server not enabled.');
16593bf8f6SMichael Klier
17797c0d11SAndreas Gohr/**
18797c0d11SAndreas Gohr * Contains needed wrapper functions and registers all available
19797c0d11SAndreas Gohr * XMLRPC functions.
20797c0d11SAndreas Gohr */
21797c0d11SAndreas Gohrclass dokuwiki_xmlrpc_server extends IXR_IntrospectionServer {
22797c0d11SAndreas Gohr    var $methods       = array();
233ee5b583SAndreas Gohr    var $public_methods = array();
243ee5b583SAndreas Gohr
253ee5b583SAndreas Gohr    /**
263ee5b583SAndreas Gohr     * Checks if the current user is allowed to execute non anonymous methods
273ee5b583SAndreas Gohr     */
283ee5b583SAndreas Gohr    function checkAuth(){
293ee5b583SAndreas Gohr        global $conf;
303ee5b583SAndreas Gohr        global $USERINFO;
313ee5b583SAndreas Gohr
323ee5b583SAndreas Gohr        if(!$conf['useacl']) return true; //no ACL - then no checks
333ee5b583SAndreas Gohr
343ee5b583SAndreas Gohr        $allowed = explode(',',$conf['xmlrpcuser']);
353ee5b583SAndreas Gohr        $allowed = array_map('trim', $allowed);
363ee5b583SAndreas Gohr        $allowed = array_unique($allowed);
373ee5b583SAndreas Gohr        $allowed = array_filter($allowed);
383ee5b583SAndreas Gohr
393ee5b583SAndreas Gohr        if(!count($allowed)) return true; //no restrictions
403ee5b583SAndreas Gohr
413ee5b583SAndreas Gohr        $user   = $_SERVER['REMOTE_USER'];
423ee5b583SAndreas Gohr        $groups = (array) $USERINFO['grps'];
433ee5b583SAndreas Gohr
443ee5b583SAndreas Gohr        if(in_array($user,$allowed)) return true; //user explicitly mentioned
453ee5b583SAndreas Gohr
463ee5b583SAndreas Gohr        //check group memberships
473ee5b583SAndreas Gohr        foreach($groups as $group){
483ee5b583SAndreas Gohr            if(in_array('@'.$group,$allowed)) return true;
493ee5b583SAndreas Gohr        }
503ee5b583SAndreas Gohr
513ee5b583SAndreas Gohr        //still here? no access!
523ee5b583SAndreas Gohr        return false;
533ee5b583SAndreas Gohr    }
543ee5b583SAndreas Gohr
553ee5b583SAndreas Gohr    /**
563ee5b583SAndreas Gohr     * Adds a callback, extends parent method
573ee5b583SAndreas Gohr     *
583ee5b583SAndreas Gohr     * add another parameter to define if anonymous access to
593ee5b583SAndreas Gohr     * this method should be granted.
603ee5b583SAndreas Gohr     */
613ee5b583SAndreas Gohr    function addCallback($method, $callback, $args, $help, $public=false){
623ee5b583SAndreas Gohr        if($public) $this->public_methods[] = $method;
633ee5b583SAndreas Gohr        return parent::addCallback($method, $callback, $args, $help);
643ee5b583SAndreas Gohr    }
653ee5b583SAndreas Gohr
663ee5b583SAndreas Gohr    /**
673ee5b583SAndreas Gohr     * Execute a call, extends parent method
683ee5b583SAndreas Gohr     *
693ee5b583SAndreas Gohr     * Checks for authentication first
703ee5b583SAndreas Gohr     */
713ee5b583SAndreas Gohr    function call($methodname, $args){
723ee5b583SAndreas Gohr        if(!in_array($methodname,$this->public_methods) && !$this->checkAuth()){
733ee5b583SAndreas Gohr            return new IXR_Error(-32603, 'server error. not authorized to call method "'.$methodname.'".');
743ee5b583SAndreas Gohr        }
753ee5b583SAndreas Gohr        return parent::call($methodname, $args);
763ee5b583SAndreas Gohr    }
77797c0d11SAndreas Gohr
78797c0d11SAndreas Gohr    /**
79797c0d11SAndreas Gohr     * Constructor. Register methods and run Server
80797c0d11SAndreas Gohr     */
81797c0d11SAndreas Gohr    function dokuwiki_xmlrpc_server(){
82797c0d11SAndreas Gohr        $this->IXR_IntrospectionServer();
83797c0d11SAndreas Gohr
84797c0d11SAndreas Gohr        /* DokuWiki's own methods */
85797c0d11SAndreas Gohr        $this->addCallback(
86445e8084SAndreas Gohr            'dokuwiki.getXMLRPCAPIVersion',
87445e8084SAndreas Gohr            'this:getAPIVersion',
88445e8084SAndreas Gohr            array('integer'),
893ee5b583SAndreas Gohr            'Returns the XMLRPC API version.',
903ee5b583SAndreas Gohr            true
91445e8084SAndreas Gohr        );
92445e8084SAndreas Gohr
93445e8084SAndreas Gohr        $this->addCallback(
94797c0d11SAndreas Gohr            'dokuwiki.getVersion',
95797c0d11SAndreas Gohr            'getVersion',
96797c0d11SAndreas Gohr            array('string'),
973ee5b583SAndreas Gohr            'Returns the running DokuWiki version.',
983ee5b583SAndreas Gohr            true
99797c0d11SAndreas Gohr        );
100797c0d11SAndreas Gohr
1011b11c097SAndreas Gohr        $this->addCallback(
102445e8084SAndreas Gohr            'dokuwiki.login',
103445e8084SAndreas Gohr            'this:login',
104445e8084SAndreas Gohr            array('integer','string','string'),
1053ee5b583SAndreas Gohr            'Tries to login with the given credentials and sets auth cookies.',
1063ee5b583SAndreas Gohr            true
107445e8084SAndreas Gohr        );
108445e8084SAndreas Gohr
109445e8084SAndreas Gohr        $this->addCallback(
1101b11c097SAndreas Gohr            'dokuwiki.getPagelist',
1111b11c097SAndreas Gohr            'this:readNamespace',
1121b11c097SAndreas Gohr            array('struct','string','struct'),
1131b11c097SAndreas Gohr            'List all pages within the given namespace.'
1141b11c097SAndreas Gohr        );
1151b11c097SAndreas Gohr
1161b11c097SAndreas Gohr        $this->addCallback(
117f71f4f53SAndreas Gohr            'dokuwiki.search',
118f71f4f53SAndreas Gohr            'this:search',
119f71f4f53SAndreas Gohr            array('struct','string'),
120f71f4f53SAndreas Gohr            'Perform a fulltext search and return a list of matching pages'
121f71f4f53SAndreas Gohr        );
122f71f4f53SAndreas Gohr
123f71f4f53SAndreas Gohr        $this->addCallback(
1241b11c097SAndreas Gohr            'dokuwiki.getTime',
1251b11c097SAndreas Gohr            'time',
1261b11c097SAndreas Gohr            array('int'),
1271b11c097SAndreas Gohr            'Return the current time at the wiki server.'
1281b11c097SAndreas Gohr        );
1291b11c097SAndreas Gohr
13028ec3c76SAndreas Gohr        $this->addCallback(
13128ec3c76SAndreas Gohr            'dokuwiki.setLocks',
13228ec3c76SAndreas Gohr            'this:setLocks',
13328ec3c76SAndreas Gohr            array('struct','struct'),
13428ec3c76SAndreas Gohr            'Lock or unlock pages.'
13528ec3c76SAndreas Gohr        );
13628ec3c76SAndreas Gohr
137e6f4c9d4SGeorges-Etienne Legendre
138e6f4c9d4SGeorges-Etienne Legendre        $this->addCallback(
139e6f4c9d4SGeorges-Etienne Legendre            'dokuwiki.getTitle',
140e6f4c9d4SGeorges-Etienne Legendre            'this:getTitle',
141e6f4c9d4SGeorges-Etienne Legendre            array('string'),
142e6f4c9d4SGeorges-Etienne Legendre            'Returns the wiki title.',
143e6f4c9d4SGeorges-Etienne Legendre            true
144e6f4c9d4SGeorges-Etienne Legendre        );
145e6f4c9d4SGeorges-Etienne Legendre
146797c0d11SAndreas Gohr        /* Wiki API v2 http://www.jspwiki.org/wiki/WikiRPCInterface2 */
147797c0d11SAndreas Gohr        $this->addCallback(
148797c0d11SAndreas Gohr            'wiki.getRPCVersionSupported',
149797c0d11SAndreas Gohr            'this:wiki_RPCVersion',
150797c0d11SAndreas Gohr            array('int'),
1513ee5b583SAndreas Gohr            'Returns 2 with the supported RPC API version.',
1523ee5b583SAndreas Gohr            true
153797c0d11SAndreas Gohr        );
154797c0d11SAndreas Gohr        $this->addCallback(
155797c0d11SAndreas Gohr            'wiki.getPage',
156797c0d11SAndreas Gohr            'this:rawPage',
157797c0d11SAndreas Gohr            array('string','string'),
158797c0d11SAndreas Gohr            'Get the raw Wiki text of page, latest version.'
159797c0d11SAndreas Gohr        );
160797c0d11SAndreas Gohr        $this->addCallback(
161797c0d11SAndreas Gohr            'wiki.getPageVersion',
162797c0d11SAndreas Gohr            'this:rawPage',
163797c0d11SAndreas Gohr            array('string','string','int'),
164797c0d11SAndreas Gohr            'Get the raw Wiki text of page.'
165797c0d11SAndreas Gohr        );
166797c0d11SAndreas Gohr        $this->addCallback(
167797c0d11SAndreas Gohr            'wiki.getPageHTML',
168797c0d11SAndreas Gohr            'this:htmlPage',
169797c0d11SAndreas Gohr            array('string','string'),
170797c0d11SAndreas Gohr            'Return page in rendered HTML, latest version.'
171797c0d11SAndreas Gohr        );
172797c0d11SAndreas Gohr        $this->addCallback(
173797c0d11SAndreas Gohr            'wiki.getPageHTMLVersion',
174797c0d11SAndreas Gohr            'this:htmlPage',
175797c0d11SAndreas Gohr            array('string','string','int'),
176797c0d11SAndreas Gohr            'Return page in rendered HTML.'
177797c0d11SAndreas Gohr        );
178797c0d11SAndreas Gohr        $this->addCallback(
179797c0d11SAndreas Gohr            'wiki.getAllPages',
180797c0d11SAndreas Gohr            'this:listPages',
181797c0d11SAndreas Gohr            array('struct'),
182797c0d11SAndreas Gohr            'Returns a list of all pages. The result is an array of utf8 pagenames.'
183797c0d11SAndreas Gohr        );
184797c0d11SAndreas Gohr        $this->addCallback(
18526bec61eSMichael Klier            'wiki.getAttachments',
18626bec61eSMichael Klier            'this:listAttachments',
187c63d1645SGina Haeussge            array('struct', 'string', 'struct'),
18826bec61eSMichael Klier            'Returns a list of all media files.'
18926bec61eSMichael Klier        );
19026bec61eSMichael Klier        $this->addCallback(
191797c0d11SAndreas Gohr            'wiki.getBackLinks',
192797c0d11SAndreas Gohr            'this:listBackLinks',
193797c0d11SAndreas Gohr            array('struct','string'),
194797c0d11SAndreas Gohr            'Returns the pages that link to this page.'
195797c0d11SAndreas Gohr        );
196797c0d11SAndreas Gohr        $this->addCallback(
197797c0d11SAndreas Gohr            'wiki.getPageInfo',
198797c0d11SAndreas Gohr            'this:pageInfo',
199797c0d11SAndreas Gohr            array('struct','string'),
200797c0d11SAndreas Gohr            'Returns a struct with infos about the page.'
201797c0d11SAndreas Gohr        );
202797c0d11SAndreas Gohr        $this->addCallback(
203797c0d11SAndreas Gohr            'wiki.getPageInfoVersion',
204797c0d11SAndreas Gohr            'this:pageInfo',
205797c0d11SAndreas Gohr            array('struct','string','int'),
206797c0d11SAndreas Gohr            'Returns a struct with infos about the page.'
207797c0d11SAndreas Gohr        );
2083a1dad2dSDennis Ploeger        $this->addCallback(
20973056168SMichael Klier            'wiki.getPageVersions',
21073056168SMichael Klier            'this:pageVersions',
21173056168SMichael Klier            array('struct','string','int'),
21273056168SMichael Klier            'Returns the available revisions of the page.'
21373056168SMichael Klier        );
21473056168SMichael Klier        $this->addCallback(
2153a1dad2dSDennis Ploeger            'wiki.putPage',
2163a1dad2dSDennis Ploeger            'this:putPage',
217222572bfSMichael Klier            array('int', 'string', 'string', 'struct'),
218fdd2e9d6SMichael Klier            'Saves a wiki page.'
2193a1dad2dSDennis Ploeger        );
220beccd742SMichael Klier        $this->addCallback(
221beccd742SMichael Klier            'wiki.listLinks',
222beccd742SMichael Klier            'this:listLinks',
223beccd742SMichael Klier            array('struct','string'),
224fdd2e9d6SMichael Klier            'Lists all links contained in a wiki page.'
225beccd742SMichael Klier        );
22663dd0d58SMichael Klier        $this->addCallback(
22763dd0d58SMichael Klier            'wiki.getRecentChanges',
22863dd0d58SMichael Klier            'this:getRecentChanges',
22963dd0d58SMichael Klier            array('struct','int'),
23099c8d7f2Smichael            'Returns a struct about all recent changes since given timestamp.'
23199c8d7f2Smichael        );
23299c8d7f2Smichael        $this->addCallback(
23399c8d7f2Smichael            'wiki.getRecentMediaChanges',
23499c8d7f2Smichael            'this:getRecentMediaChanges',
23599c8d7f2Smichael            array('struct','int'),
23699c8d7f2Smichael            'Returns a struct about all recent media changes since given timestamp.'
23763dd0d58SMichael Klier        );
238e62b9ea5SMichael Klier        $this->addCallback(
239e62b9ea5SMichael Klier            'wiki.aclCheck',
240e62b9ea5SMichael Klier            'this:aclCheck',
241c63d1645SGina Haeussge            array('int', 'string'),
242e62b9ea5SMichael Klier            'Returns the permissions of a given wiki page.'
243e62b9ea5SMichael Klier        );
2442aca132fSMichael Klier        $this->addCallback(
2452aca132fSMichael Klier            'wiki.putAttachment',
2462aca132fSMichael Klier            'this:putAttachment',
2472aca132fSMichael Klier            array('struct', 'string', 'base64', 'struct'),
2482aca132fSMichael Klier            'Upload a file to the wiki.'
2492aca132fSMichael Klier        );
250cfef3001SGina Haeussge        $this->addCallback(
251f01ff8c1SGina Haeussge            'wiki.deleteAttachment',
252f01ff8c1SGina Haeussge            'this:deleteAttachment',
253f01ff8c1SGina Haeussge            array('int', 'string'),
254f01ff8c1SGina Haeussge            'Delete a file from the wiki.'
255f01ff8c1SGina Haeussge        );
256f01ff8c1SGina Haeussge        $this->addCallback(
257cfef3001SGina Haeussge            'wiki.getAttachment',
258cfef3001SGina Haeussge            'this:getAttachment',
259c63d1645SGina Haeussge            array('base64', 'string'),
260cfef3001SGina Haeussge            'Download a file from the wiki.'
261cfef3001SGina Haeussge        );
2625672e868SGina Haeussge        $this->addCallback(
2635672e868SGina Haeussge            'wiki.getAttachmentInfo',
2645672e868SGina Haeussge            'this:getAttachmentInfo',
265c63d1645SGina Haeussge            array('struct', 'string'),
2665672e868SGina Haeussge            'Returns a struct with infos about the attachment.'
2675672e868SGina Haeussge        );
268797c0d11SAndreas Gohr
269bb32615dSMichael Klier        /**
270bb32615dSMichael Klier         * Trigger XMLRPC_CALLBACK_REGISTER, action plugins can use this event
271bb32615dSMichael Klier         * to extend the XMLRPC interface and register their own callbacks.
272bb32615dSMichael Klier         *
273bb32615dSMichael Klier         * Event data:
274bb32615dSMichael Klier         *  The XMLRPC server object:
275bb32615dSMichael Klier         *
276bb32615dSMichael Klier         *  $event->data->addCallback() - register a callback, the second
277bb32615dSMichael Klier         *  paramter has to be of the form "plugin:<pluginname>:<plugin
278bb32615dSMichael Klier         *  method>"
279bb32615dSMichael Klier         *
280bb32615dSMichael Klier         *  $event->data->callbacks - an array which holds all awaylable
281bb32615dSMichael Klier         *  callbacks
282bb32615dSMichael Klier         */
283bb32615dSMichael Klier        trigger_event('XMLRPC_CALLBACK_REGISTER', $this);
284bb32615dSMichael Klier
285797c0d11SAndreas Gohr        $this->serve();
286797c0d11SAndreas Gohr    }
287797c0d11SAndreas Gohr
288797c0d11SAndreas Gohr    /**
289797c0d11SAndreas Gohr     * Return a raw wiki page
290797c0d11SAndreas Gohr     */
291797c0d11SAndreas Gohr    function rawPage($id,$rev=''){
292797c0d11SAndreas Gohr        if(auth_quickaclcheck($id) < AUTH_READ){
293797c0d11SAndreas Gohr            return new IXR_Error(1, 'You are not allowed to read this page');
294797c0d11SAndreas Gohr        }
2952c176304SMichael Klier        $text = rawWiki($id,$rev);
2962c176304SMichael Klier        if(!$text) {
297fe17917eSAdrian Lang            return pageTemplate($id);
2982c176304SMichael Klier        } else {
2992c176304SMichael Klier            return $text;
3002c176304SMichael Klier        }
301797c0d11SAndreas Gohr    }
302797c0d11SAndreas Gohr
303797c0d11SAndreas Gohr    /**
304cfef3001SGina Haeussge     * Return a media file encoded in base64
305c63d1645SGina Haeussge     *
306c63d1645SGina Haeussge     * @author Gina Haeussge <osd@foosel.net>
307cfef3001SGina Haeussge     */
308cfef3001SGina Haeussge    function getAttachment($id){
309c63d1645SGina Haeussge        $id = cleanID($id);
310cfef3001SGina Haeussge        if (auth_quickaclcheck(getNS($id).':*') < AUTH_READ)
311cfef3001SGina Haeussge            return new IXR_Error(1, 'You are not allowed to read this file');
312cfef3001SGina Haeussge
313cfef3001SGina Haeussge        $file = mediaFN($id);
314cfef3001SGina Haeussge        if (!@ file_exists($file))
315cfef3001SGina Haeussge            return new IXR_Error(1, 'The requested file does not exist');
316cfef3001SGina Haeussge
317cfef3001SGina Haeussge        $data = io_readFile($file, false);
318cfef3001SGina Haeussge        $base64 = base64_encode($data);
319cfef3001SGina Haeussge        return $base64;
320cfef3001SGina Haeussge    }
321cfef3001SGina Haeussge
322cfef3001SGina Haeussge    /**
3235672e868SGina Haeussge     * Return info about a media file
3245672e868SGina Haeussge     *
3255672e868SGina Haeussge     * @author Gina Haeussge <osd@foosel.net>
3265672e868SGina Haeussge     */
3275672e868SGina Haeussge    function getAttachmentInfo($id){
3285672e868SGina Haeussge        $id = cleanID($id);
3295672e868SGina Haeussge        $info = array(
3305672e868SGina Haeussge            'lastModified' => 0,
3315672e868SGina Haeussge            'size' => 0,
3325672e868SGina Haeussge        );
3335672e868SGina Haeussge
3345672e868SGina Haeussge        $file = mediaFN($id);
3355672e868SGina Haeussge        if ((auth_quickaclcheck(getNS($id).':*') >= AUTH_READ) && file_exists($file)){
3365672e868SGina Haeussge            $info['lastModified'] = new IXR_Date(filemtime($file));
3375672e868SGina Haeussge            $info['size'] = filesize($file);
3385672e868SGina Haeussge        }
3395672e868SGina Haeussge
3405672e868SGina Haeussge        return $info;
3415672e868SGina Haeussge    }
3425672e868SGina Haeussge
3435672e868SGina Haeussge    /**
344797c0d11SAndreas Gohr     * Return a wiki page rendered to html
345797c0d11SAndreas Gohr     */
346797c0d11SAndreas Gohr    function htmlPage($id,$rev=''){
347797c0d11SAndreas Gohr        if(auth_quickaclcheck($id) < AUTH_READ){
348797c0d11SAndreas Gohr            return new IXR_Error(1, 'You are not allowed to read this page');
349797c0d11SAndreas Gohr        }
350797c0d11SAndreas Gohr        return p_wiki_xhtml($id,$rev,false);
351797c0d11SAndreas Gohr    }
352797c0d11SAndreas Gohr
353797c0d11SAndreas Gohr    /**
354797c0d11SAndreas Gohr     * List all pages - we use the indexer list here
355797c0d11SAndreas Gohr     */
356797c0d11SAndreas Gohr    function listPages(){
357dfd13e55SMichael Klier        $list  = array();
358*9b41be24STom N Harris        $pages = idx_get_indexer()->getPages();
359*9b41be24STom N Harris        $pages = array_filter(array_filter($pages,'isVisiblePage'),'page_exists');
360dfd13e55SMichael Klier
361dfd13e55SMichael Klier        foreach(array_keys($pages) as $idx) {
362dfd13e55SMichael Klier            $perm = auth_quickaclcheck($pages[$idx]);
363a0070b52SAdrian Lang            if($perm < AUTH_READ) {
364a0070b52SAdrian Lang                continue;
365a0070b52SAdrian Lang            }
366dfd13e55SMichael Klier            $page = array();
367dfd13e55SMichael Klier            $page['id'] = trim($pages[$idx]);
368dfd13e55SMichael Klier            $page['perms'] = $perm;
369dfd13e55SMichael Klier            $page['size'] = @filesize(wikiFN($pages[$idx]));
370e070c6f3SGina Haeussge            $page['lastModified'] = new IXR_Date(@filemtime(wikiFN($pages[$idx])));
371dfd13e55SMichael Klier            $list[] = $page;
372dfd13e55SMichael Klier        }
373dfd13e55SMichael Klier
374dfd13e55SMichael Klier        return $list;
375797c0d11SAndreas Gohr    }
376797c0d11SAndreas Gohr
377797c0d11SAndreas Gohr    /**
3781b11c097SAndreas Gohr     * List all pages in the given namespace (and below)
3791b11c097SAndreas Gohr     */
3801b11c097SAndreas Gohr    function readNamespace($ns,$opts){
3811b11c097SAndreas Gohr        global $conf;
3821b11c097SAndreas Gohr
3831b11c097SAndreas Gohr        if(!is_array($opts)) $opts=array();
3841b11c097SAndreas Gohr
3851b11c097SAndreas Gohr        $ns = cleanID($ns);
3861b11c097SAndreas Gohr        $dir = utf8_encodeFN(str_replace(':', '/', $ns));
3871b11c097SAndreas Gohr        $data = array();
3886fc3aa1aSAndreas Gohr        $opts['skipacl'] = 0; // no ACL skipping for XMLRPC
3891b11c097SAndreas Gohr        search($data, $conf['datadir'], 'search_allpages', $opts, $dir);
3901b11c097SAndreas Gohr        return $data;
3911b11c097SAndreas Gohr    }
3921b11c097SAndreas Gohr
3931b11c097SAndreas Gohr    /**
394f71f4f53SAndreas Gohr     * List all pages in the given namespace (and below)
395f71f4f53SAndreas Gohr     */
396f71f4f53SAndreas Gohr    function search($query){
397f71f4f53SAndreas Gohr        require_once(DOKU_INC.'inc/fulltext.php');
398f71f4f53SAndreas Gohr
399f71f4f53SAndreas Gohr        $regex = '';
400f71f4f53SAndreas Gohr        $data  = ft_pageSearch($query,$regex);
401f71f4f53SAndreas Gohr        $pages = array();
402f71f4f53SAndreas Gohr
403f71f4f53SAndreas Gohr        // prepare additional data
404f71f4f53SAndreas Gohr        $idx = 0;
405f71f4f53SAndreas Gohr        foreach($data as $id => $score){
406f71f4f53SAndreas Gohr            $file = wikiFN($id);
407f71f4f53SAndreas Gohr
408f71f4f53SAndreas Gohr            if($idx < FT_SNIPPET_NUMBER){
409f71f4f53SAndreas Gohr                $snippet = ft_snippet($id,$regex);
410f71f4f53SAndreas Gohr                $idx++;
411f71f4f53SAndreas Gohr            }else{
412f71f4f53SAndreas Gohr                $snippet = '';
413f71f4f53SAndreas Gohr            }
414f71f4f53SAndreas Gohr
415f71f4f53SAndreas Gohr            $pages[] = array(
416f71f4f53SAndreas Gohr                'id'      => $id,
417f71f4f53SAndreas Gohr                'score'   => $score,
418f71f4f53SAndreas Gohr                'rev'     => filemtime($file),
419f71f4f53SAndreas Gohr                'mtime'   => filemtime($file),
420f71f4f53SAndreas Gohr                'size'    => filesize($file),
421f71f4f53SAndreas Gohr                'snippet' => $snippet,
422f71f4f53SAndreas Gohr            );
423f71f4f53SAndreas Gohr        }
424ac1ffddeSGeorges-Etienne Legendre        return $pages;
425f71f4f53SAndreas Gohr    }
426f71f4f53SAndreas Gohr
427e6f4c9d4SGeorges-Etienne Legendre    /**
428e6f4c9d4SGeorges-Etienne Legendre     * Returns the wiki title.
429e6f4c9d4SGeorges-Etienne Legendre     */
430e6f4c9d4SGeorges-Etienne Legendre    function getTitle(){
431e6f4c9d4SGeorges-Etienne Legendre        global $conf;
432e6f4c9d4SGeorges-Etienne Legendre        return $conf['title'];
433e6f4c9d4SGeorges-Etienne Legendre    }
434f71f4f53SAndreas Gohr
435f71f4f53SAndreas Gohr    /**
43626bec61eSMichael Klier     * List all media files.
4373275953aSGina Haeussge     *
4383275953aSGina Haeussge     * Available options are 'recursive' for also including the subnamespaces
4393275953aSGina Haeussge     * in the listing, and 'pattern' for filtering the returned files against
4403275953aSGina Haeussge     * a regular expression matching their name.
4413275953aSGina Haeussge     *
4423275953aSGina Haeussge     * @author Gina Haeussge <osd@foosel.net>
44326bec61eSMichael Klier     */
4443275953aSGina Haeussge    function listAttachments($ns, $options = array()) {
44526bec61eSMichael Klier        global $conf;
44626bec61eSMichael Klier        global $lang;
44726bec61eSMichael Klier
44826bec61eSMichael Klier        $ns = cleanID($ns);
44926bec61eSMichael Klier
4506fc3aa1aSAndreas Gohr        if (!is_array($options)) $options = array();
4516fc3aa1aSAndreas Gohr        $options['skipacl'] = 0; // no ACL skipping for XMLRPC
4523275953aSGina Haeussge
4533275953aSGina Haeussge
45426bec61eSMichael Klier        if(auth_quickaclcheck($ns.':*') >= AUTH_READ) {
45526bec61eSMichael Klier            $dir = utf8_encodeFN(str_replace(':', '/', $ns));
45626bec61eSMichael Klier
45726bec61eSMichael Klier            $data = array();
458224122cfSAndreas Gohr            search($data, $conf['mediadir'], 'search_media', $options, $dir);
459224122cfSAndreas Gohr            $len = count($data);
460224122cfSAndreas Gohr            if(!$len) return array();
46126bec61eSMichael Klier
462224122cfSAndreas Gohr            for($i=0; $i<$len; $i++) {
463224122cfSAndreas Gohr                unset($data[$i]['meta']);
464224122cfSAndreas Gohr                $data[$i]['lastModified'] = new IXR_Date($data[$i]['mtime']);
46526bec61eSMichael Klier            }
466224122cfSAndreas Gohr            return $data;
46726bec61eSMichael Klier        } else {
46826bec61eSMichael Klier            return new IXR_Error(1, 'You are not allowed to list media files.');
46926bec61eSMichael Klier        }
47026bec61eSMichael Klier    }
47126bec61eSMichael Klier
47226bec61eSMichael Klier    /**
473797c0d11SAndreas Gohr     * Return a list of backlinks
474797c0d11SAndreas Gohr     */
475beccd742SMichael Klier    function listBackLinks($id){
47686228f10SDominik Eckelmann        return ft_backlinks(cleanID($id));
477797c0d11SAndreas Gohr    }
478797c0d11SAndreas Gohr
479797c0d11SAndreas Gohr    /**
48063dd0d58SMichael Klier     * Return some basic data about a page
481797c0d11SAndreas Gohr     */
482797c0d11SAndreas Gohr    function pageInfo($id,$rev=''){
483797c0d11SAndreas Gohr        if(auth_quickaclcheck($id) < AUTH_READ){
484797c0d11SAndreas Gohr            return new IXR_Error(1, 'You are not allowed to read this page');
485797c0d11SAndreas Gohr        }
486797c0d11SAndreas Gohr        $file = wikiFN($id,$rev);
487797c0d11SAndreas Gohr        $time = @filemtime($file);
488797c0d11SAndreas Gohr        if(!$time){
489797c0d11SAndreas Gohr            return new IXR_Error(10, 'The requested page does not exist');
490797c0d11SAndreas Gohr        }
491797c0d11SAndreas Gohr
492797c0d11SAndreas Gohr        $info = getRevisionInfo($id, $time, 1024);
493797c0d11SAndreas Gohr
494797c0d11SAndreas Gohr        $data = array(
495797c0d11SAndreas Gohr            'name'         => $id,
496797c0d11SAndreas Gohr            'lastModified' => new IXR_Date($time),
497797c0d11SAndreas Gohr            'author'       => (($info['user']) ? $info['user'] : $info['ip']),
498797c0d11SAndreas Gohr            'version'      => $time
499797c0d11SAndreas Gohr        );
50063dd0d58SMichael Klier
50163dd0d58SMichael Klier        return ($data);
502797c0d11SAndreas Gohr    }
503797c0d11SAndreas Gohr
504797c0d11SAndreas Gohr    /**
5053a1dad2dSDennis Ploeger     * Save a wiki page
506222572bfSMichael Klier     *
507222572bfSMichael Klier     * @author Michael Klier <chi@chimeric.de>
5083a1dad2dSDennis Ploeger     */
509222572bfSMichael Klier    function putPage($id, $text, $params) {
5103a1dad2dSDennis Ploeger        global $TEXT;
511a6a229ceSMichael Klier        global $lang;
512593bf8f6SMichael Klier        global $conf;
5133a1dad2dSDennis Ploeger
514222572bfSMichael Klier        $id    = cleanID($id);
51556523eecSAndreas Gohr        $TEXT  = cleanText($text);
516222572bfSMichael Klier        $sum   = $params['sum'];
517222572bfSMichael Klier        $minor = $params['minor'];
518222572bfSMichael Klier
519222572bfSMichael Klier        if(empty($id))
520fdd2e9d6SMichael Klier            return new IXR_Error(1, 'Empty page ID');
521222572bfSMichael Klier
52256523eecSAndreas Gohr        if(!page_exists($id) && trim($TEXT) == '' ) {
52351597811SMichael Klier            return new IXR_ERROR(1, 'Refusing to write an empty new wiki page');
52451597811SMichael Klier        }
52551597811SMichael Klier
526055b0144SChris Smith        if(auth_quickaclcheck($id) < AUTH_EDIT)
527222572bfSMichael Klier            return new IXR_Error(1, 'You are not allowed to edit this page');
5283a1dad2dSDennis Ploeger
5293a1dad2dSDennis Ploeger        // Check, if page is locked
530222572bfSMichael Klier        if(checklock($id))
531222572bfSMichael Klier            return new IXR_Error(1, 'The page is currently locked');
532222572bfSMichael Klier
533a6a229ceSMichael Klier        // SPAM check
5343a1dad2dSDennis Ploeger        if(checkwordblock())
535222572bfSMichael Klier            return new IXR_Error(1, 'Positive wordblock check');
5363a1dad2dSDennis Ploeger
537a6a229ceSMichael Klier        // autoset summary on new pages
538a6a229ceSMichael Klier        if(!page_exists($id) && empty($sum)) {
539a6a229ceSMichael Klier            $sum = $lang['created'];
540a6a229ceSMichael Klier        }
541a6a229ceSMichael Klier
542a6a229ceSMichael Klier        // autoset summary on deleted pages
543a6a229ceSMichael Klier        if(page_exists($id) && empty($TEXT) && empty($sum)) {
544a6a229ceSMichael Klier            $sum = $lang['deleted'];
545a6a229ceSMichael Klier        }
546a6a229ceSMichael Klier
547222572bfSMichael Klier        lock($id);
5483a1dad2dSDennis Ploeger
549222572bfSMichael Klier        saveWikiText($id,$TEXT,$sum,$minor);
5503a1dad2dSDennis Ploeger
551222572bfSMichael Klier        unlock($id);
5523a1dad2dSDennis Ploeger
553593bf8f6SMichael Klier        // run the indexer if page wasn't indexed yet
554593bf8f6SMichael Klier        idx_addPage($id);
555593bf8f6SMichael Klier
5563a1dad2dSDennis Ploeger        return 0;
557beccd742SMichael Klier    }
5583a1dad2dSDennis Ploeger
559beccd742SMichael Klier    /**
5602aca132fSMichael Klier     * Uploads a file to the wiki.
5612aca132fSMichael Klier     *
5622aca132fSMichael Klier     * Michael Klier <chi@chimeric.de>
5632aca132fSMichael Klier     */
564f01ff8c1SGina Haeussge    function putAttachment($id, $file, $params) {
5652aca132fSMichael Klier        global $conf;
5662aca132fSMichael Klier        global $lang;
5672aca132fSMichael Klier
568f01ff8c1SGina Haeussge        $auth = auth_quickaclcheck(getNS($id).':*');
5692aca132fSMichael Klier        if($auth >= AUTH_UPLOAD) {
570f01ff8c1SGina Haeussge            if(!isset($id)) {
5712aca132fSMichael Klier                return new IXR_ERROR(1, 'Filename not given.');
5722aca132fSMichael Klier            }
5732aca132fSMichael Klier
574c77fa67bSMichael Hamann            $ftmp = $conf['tmpdir'] . '/' . md5($id.clientIP());
5752aca132fSMichael Klier
5762aca132fSMichael Klier            // save temporary file
5772aca132fSMichael Klier            @unlink($ftmp);
5782aca132fSMichael Klier            $buff = base64_decode($file);
5792aca132fSMichael Klier            io_saveFile($ftmp, $buff);
5802aca132fSMichael Klier
5812aca132fSMichael Klier            // get filename
582ecebf3a8SAndreas Gohr            list($iext, $imime,$dl) = mimetype($id);
583f01ff8c1SGina Haeussge            $id = cleanID($id);
5842aca132fSMichael Klier            $fn = mediaFN($id);
5852aca132fSMichael Klier
5862aca132fSMichael Klier            // get filetype regexp
5872aca132fSMichael Klier            $types = array_keys(getMimeTypes());
5882aca132fSMichael Klier            $types = array_map(create_function('$q','return preg_quote($q,"/");'),$types);
5892aca132fSMichael Klier            $regex = join('|',$types);
5902aca132fSMichael Klier
5912aca132fSMichael Klier            // because a temp file was created already
5922aca132fSMichael Klier            if(preg_match('/\.('.$regex.')$/i',$fn)) {
5932aca132fSMichael Klier                //check for overwrite
59499c8d7f2Smichael                $overwrite = @file_exists($fn);
59599c8d7f2Smichael                if($overwrite && (!$params['ow'] || $auth < AUTH_DELETE)) {
596224122cfSAndreas Gohr                    return new IXR_ERROR(1, $lang['uploadexist'].'1');
5972aca132fSMichael Klier                }
5982aca132fSMichael Klier                // check for valid content
5992aca132fSMichael Klier                $ok = media_contentcheck($ftmp, $imime);
6002aca132fSMichael Klier                if($ok == -1) {
601224122cfSAndreas Gohr                    return new IXR_ERROR(1, sprintf($lang['uploadexist'].'2', ".$iext"));
6022aca132fSMichael Klier                } elseif($ok == -2) {
6032aca132fSMichael Klier                    return new IXR_ERROR(1, $lang['uploadspam']);
6042aca132fSMichael Klier                } elseif($ok == -3) {
6052aca132fSMichael Klier                    return new IXR_ERROR(1, $lang['uploadxss']);
6062aca132fSMichael Klier                }
6072aca132fSMichael Klier
6082aca132fSMichael Klier                // prepare event data
6092aca132fSMichael Klier                $data[0] = $ftmp;
6102aca132fSMichael Klier                $data[1] = $fn;
6112aca132fSMichael Klier                $data[2] = $id;
6122aca132fSMichael Klier                $data[3] = $imime;
61399c8d7f2Smichael                $data[4] = $overwrite;
6142aca132fSMichael Klier
6152aca132fSMichael Klier                // trigger event
6162aca132fSMichael Klier                return trigger_event('MEDIA_UPLOAD_FINISH', $data, array($this, '_media_upload_action'), true);
6172aca132fSMichael Klier
6182aca132fSMichael Klier            } else {
6192aca132fSMichael Klier                return new IXR_ERROR(1, $lang['uploadwrong']);
6202aca132fSMichael Klier            }
6212aca132fSMichael Klier        } else {
6222aca132fSMichael Klier            return new IXR_ERROR(1, "You don't have permissions to upload files.");
6232aca132fSMichael Klier        }
6242aca132fSMichael Klier    }
6252aca132fSMichael Klier
6262aca132fSMichael Klier    /**
627f01ff8c1SGina Haeussge     * Deletes a file from the wiki.
628f01ff8c1SGina Haeussge     *
629f01ff8c1SGina Haeussge     * @author Gina Haeussge <osd@foosel.net>
630f01ff8c1SGina Haeussge     */
631f01ff8c1SGina Haeussge    function deleteAttachment($id){
632f01ff8c1SGina Haeussge        $auth = auth_quickaclcheck(getNS($id).':*');
633f01ff8c1SGina Haeussge        if($auth < AUTH_DELETE) return new IXR_ERROR(1, "You don't have permissions to delete files.");
634f01ff8c1SGina Haeussge        global $conf;
635f01ff8c1SGina Haeussge        global $lang;
636f01ff8c1SGina Haeussge
637f01ff8c1SGina Haeussge        // check for references if needed
638f01ff8c1SGina Haeussge        $mediareferences = array();
639f01ff8c1SGina Haeussge        if($conf['refcheck']){
640f01ff8c1SGina Haeussge            $mediareferences = ft_mediause($id,$conf['refshow']);
641f01ff8c1SGina Haeussge        }
642f01ff8c1SGina Haeussge
643f01ff8c1SGina Haeussge        if(!count($mediareferences)){
644f01ff8c1SGina Haeussge            $file = mediaFN($id);
645f01ff8c1SGina Haeussge            if(@unlink($file)){
64699c8d7f2Smichael                addMediaLogEntry(time(), $id, DOKU_CHANGE_TYPE_DELETE);
647f01ff8c1SGina Haeussge                io_sweepNS($id,'mediadir');
648f01ff8c1SGina Haeussge                return 0;
649f01ff8c1SGina Haeussge            }
650f01ff8c1SGina Haeussge            //something went wrong
651f01ff8c1SGina Haeussge               return new IXR_ERROR(1, 'Could not delete file');
652f01ff8c1SGina Haeussge        } else {
653f01ff8c1SGina Haeussge            return new IXR_ERROR(1, 'File is still referenced');
654f01ff8c1SGina Haeussge        }
655f01ff8c1SGina Haeussge    }
656f01ff8c1SGina Haeussge
657f01ff8c1SGina Haeussge    /**
6582aca132fSMichael Klier     * Moves the temporary file to its final destination.
6592aca132fSMichael Klier     *
6602aca132fSMichael Klier     * Michael Klier <chi@chimeric.de>
6612aca132fSMichael Klier     */
6622aca132fSMichael Klier    function _media_upload_action($data) {
6632aca132fSMichael Klier        global $conf;
6642aca132fSMichael Klier
66599c8d7f2Smichael        if(is_array($data) && count($data)===5) {
6662aca132fSMichael Klier            io_createNamespace($data[2], 'media');
6672aca132fSMichael Klier            if(rename($data[0], $data[1])) {
6682aca132fSMichael Klier                chmod($data[1], $conf['fmode']);
6692aca132fSMichael Klier                media_notify($data[2], $data[1], $data[3]);
67099c8d7f2Smichael                // add a log entry to the media changelog
67199c8d7f2Smichael                if ($data[4]) {
67299c8d7f2Smichael                    addMediaLogEntry(time(), $data[2], DOKU_CHANGE_TYPE_EDIT);
67399c8d7f2Smichael                } else {
67499c8d7f2Smichael                    addMediaLogEntry(time(), $data[2], DOKU_CHANGE_TYPE_CREATE);
67599c8d7f2Smichael                }
6762aca132fSMichael Klier                return $data[2];
6772aca132fSMichael Klier            } else {
6782aca132fSMichael Klier                return new IXR_ERROR(1, 'Upload failed.');
6792aca132fSMichael Klier            }
6802aca132fSMichael Klier        } else {
6812aca132fSMichael Klier            return new IXR_ERROR(1, 'Upload failed.');
6822aca132fSMichael Klier        }
6832aca132fSMichael Klier    }
6842aca132fSMichael Klier
6852aca132fSMichael Klier    /**
686e62b9ea5SMichael Klier    * Returns the permissions of a given wiki page
687e62b9ea5SMichael Klier    */
688e62b9ea5SMichael Klier    function aclCheck($id) {
689e62b9ea5SMichael Klier        return auth_quickaclcheck($id);
690e62b9ea5SMichael Klier    }
691e62b9ea5SMichael Klier
692e62b9ea5SMichael Klier    /**
693beccd742SMichael Klier     * Lists all links contained in a wiki page
69463dd0d58SMichael Klier     *
69563dd0d58SMichael Klier     * @author Michael Klier <chi@chimeric.de>
696beccd742SMichael Klier     */
697beccd742SMichael Klier    function listLinks($id) {
698beccd742SMichael Klier        if(auth_quickaclcheck($id) < AUTH_READ){
699beccd742SMichael Klier            return new IXR_Error(1, 'You are not allowed to read this page');
700beccd742SMichael Klier        }
701beccd742SMichael Klier        $links = array();
702beccd742SMichael Klier
703beccd742SMichael Klier        // resolve page instructions
704beccd742SMichael Klier        $ins   = p_cached_instructions(wikiFN(cleanID($id)));
705beccd742SMichael Klier
706beccd742SMichael Klier        // instantiate new Renderer - needed for interwiki links
707beccd742SMichael Klier        include(DOKU_INC.'inc/parser/xhtml.php');
708beccd742SMichael Klier        $Renderer = new Doku_Renderer_xhtml();
709beccd742SMichael Klier        $Renderer->interwiki = getInterwiki();
710beccd742SMichael Klier
711beccd742SMichael Klier        // parse parse instructions
712beccd742SMichael Klier        foreach($ins as $in) {
713beccd742SMichael Klier            $link = array();
714beccd742SMichael Klier            switch($in[0]) {
715beccd742SMichael Klier                case 'internallink':
716beccd742SMichael Klier                    $link['type'] = 'local';
717beccd742SMichael Klier                    $link['page'] = $in[1][0];
718beccd742SMichael Klier                    $link['href'] = wl($in[1][0]);
719beccd742SMichael Klier                    array_push($links,$link);
720beccd742SMichael Klier                    break;
721beccd742SMichael Klier                case 'externallink':
722beccd742SMichael Klier                    $link['type'] = 'extern';
723beccd742SMichael Klier                    $link['page'] = $in[1][0];
724beccd742SMichael Klier                    $link['href'] = $in[1][0];
725beccd742SMichael Klier                    array_push($links,$link);
726beccd742SMichael Klier                    break;
727beccd742SMichael Klier                case 'interwikilink':
728beccd742SMichael Klier                    $url = $Renderer->_resolveInterWiki($in[1][2],$in[1][3]);
729beccd742SMichael Klier                    $link['type'] = 'extern';
730beccd742SMichael Klier                    $link['page'] = $url;
731beccd742SMichael Klier                    $link['href'] = $url;
732beccd742SMichael Klier                    array_push($links,$link);
733beccd742SMichael Klier                    break;
734beccd742SMichael Klier            }
735beccd742SMichael Klier        }
736beccd742SMichael Klier
73763dd0d58SMichael Klier        return ($links);
73863dd0d58SMichael Klier    }
73963dd0d58SMichael Klier
74063dd0d58SMichael Klier    /**
74163dd0d58SMichael Klier     * Returns a list of recent changes since give timestamp
74263dd0d58SMichael Klier     *
74399c8d7f2Smichael     * @author Michael Hamann <michael@content-space.de>
74463dd0d58SMichael Klier     * @author Michael Klier <chi@chimeric.de>
74563dd0d58SMichael Klier     */
74663dd0d58SMichael Klier    function getRecentChanges($timestamp) {
74763dd0d58SMichael Klier        if(strlen($timestamp) != 10)
74863dd0d58SMichael Klier            return new IXR_Error(20, 'The provided value is not a valid timestamp');
74963dd0d58SMichael Klier
75099c8d7f2Smichael        $recents = getRecentsSince($timestamp);
75163dd0d58SMichael Klier
75299c8d7f2Smichael        $changes = array();
75363dd0d58SMichael Klier
75499c8d7f2Smichael        foreach ($recents as $recent) {
75599c8d7f2Smichael            $change = array();
75699c8d7f2Smichael            $change['name']         = $recent['id'];
75799c8d7f2Smichael            $change['lastModified'] = new IXR_Date($recent['date']);
75899c8d7f2Smichael            $change['author']       = $recent['user'];
75999c8d7f2Smichael            $change['version']      = $recent['date'];
76099c8d7f2Smichael            $change['perms']        = $recent['perms'];
76199c8d7f2Smichael            $change['size']         = @filesize(wikiFN($recent['id']));
76263dd0d58SMichael Klier            array_push($changes, $change);
76399c8d7f2Smichael        }
76499c8d7f2Smichael
76599c8d7f2Smichael        if (!empty($changes)) {
76699c8d7f2Smichael            return $changes;
76763dd0d58SMichael Klier        } else {
76863dd0d58SMichael Klier            // in case we still have nothing at this point
76963dd0d58SMichael Klier            return new IXR_Error(30, 'There are no changes in the specified timeframe');
7703a1dad2dSDennis Ploeger        }
77199c8d7f2Smichael    }
77299c8d7f2Smichael
77399c8d7f2Smichael    /**
77499c8d7f2Smichael     * Returns a list of recent media changes since give timestamp
77599c8d7f2Smichael     *
77699c8d7f2Smichael     * @author Michael Hamann <michael@content-space.de>
77799c8d7f2Smichael     * @author Michael Klier <chi@chimeric.de>
77899c8d7f2Smichael     */
77999c8d7f2Smichael    function getRecentMediaChanges($timestamp) {
78099c8d7f2Smichael        if(strlen($timestamp) != 10)
78199c8d7f2Smichael            return new IXR_Error(20, 'The provided value is not a valid timestamp');
78299c8d7f2Smichael
78399c8d7f2Smichael        $recents = getRecentsSince($timestamp, null, '', RECENTS_MEDIA_CHANGES);
78499c8d7f2Smichael
78599c8d7f2Smichael        $changes = array();
78699c8d7f2Smichael
78799c8d7f2Smichael        foreach ($recents as $recent) {
78899c8d7f2Smichael            $change = array();
78999c8d7f2Smichael            $change['name']         = $recent['id'];
79099c8d7f2Smichael            $change['lastModified'] = new IXR_Date($recent['date']);
79199c8d7f2Smichael            $change['author']       = $recent['user'];
79299c8d7f2Smichael            $change['version']      = $recent['date'];
79399c8d7f2Smichael            $change['perms']        = $recent['perms'];
794a4da2756Smichael            $change['size']         = @filesize(mediaFN($recent['id']));
79599c8d7f2Smichael            array_push($changes, $change);
79699c8d7f2Smichael        }
79799c8d7f2Smichael
79899c8d7f2Smichael        if (!empty($changes)) {
79999c8d7f2Smichael            return $changes;
80099c8d7f2Smichael        } else {
80199c8d7f2Smichael            // in case we still have nothing at this point
80299c8d7f2Smichael            return new IXR_Error(30, 'There are no changes in the specified timeframe');
80399c8d7f2Smichael        }
80499c8d7f2Smichael    }
8053a1dad2dSDennis Ploeger
8063a1dad2dSDennis Ploeger    /**
80773056168SMichael Klier     * Returns a list of available revisions of a given wiki page
80873056168SMichael Klier     *
80973056168SMichael Klier     * @author Michael Klier <chi@chimeric.de>
81073056168SMichael Klier     */
81173056168SMichael Klier    function pageVersions($id, $first) {
81273056168SMichael Klier        global $conf;
81373056168SMichael Klier
81473056168SMichael Klier        $versions = array();
81573056168SMichael Klier
81673056168SMichael Klier        if(empty($id))
81773056168SMichael Klier            return new IXR_Error(1, 'Empty page ID');
81873056168SMichael Klier
81973056168SMichael Klier        $revisions = getRevisions($id, $first, $conf['recent']+1);
82073056168SMichael Klier
82173056168SMichael Klier        if(count($revisions)==0 && $first!=0) {
82273056168SMichael Klier            $first=0;
82373056168SMichael Klier            $revisions = getRevisions($id, $first, $conf['recent']+1);
82473056168SMichael Klier        }
82573056168SMichael Klier
82645c63471SMichael Klier        if(count($revisions)>0 && $first==0) {
82745c63471SMichael Klier            array_unshift($revisions, '');  // include current revision
82845c63471SMichael Klier            array_pop($revisions);          // remove extra log entry
82945c63471SMichael Klier        }
83045c63471SMichael Klier
83173056168SMichael Klier        $hasNext = false;
83273056168SMichael Klier        if(count($revisions)>$conf['recent']) {
83373056168SMichael Klier            $hasNext = true;
83473056168SMichael Klier            array_pop($revisions); // remove extra log entry
83573056168SMichael Klier        }
83673056168SMichael Klier
83773056168SMichael Klier        if(!empty($revisions)) {
83873056168SMichael Klier            foreach($revisions as $rev) {
83973056168SMichael Klier                $file = wikiFN($id,$rev);
84073056168SMichael Klier                $time = @filemtime($file);
84145c63471SMichael Klier                // we check if the page actually exists, if this is not the
84245c63471SMichael Klier                // case this can lead to less pages being returned than
84345c63471SMichael Klier                // specified via $conf['recent']
84473056168SMichael Klier                if($time){
84573056168SMichael Klier                    $info = getRevisionInfo($id, $time, 1024);
84673056168SMichael Klier                    if(!empty($info)) {
84773056168SMichael Klier                        $data['user'] = $info['user'];
84873056168SMichael Klier                        $data['ip']   = $info['ip'];
84973056168SMichael Klier                        $data['type'] = $info['type'];
85073056168SMichael Klier                        $data['sum']  = $info['sum'];
85173056168SMichael Klier                        $data['modified'] = new IXR_Date($info['date']);
85273056168SMichael Klier                        $data['version'] = $info['date'];
85373056168SMichael Klier                        array_push($versions, $data);
85473056168SMichael Klier                    }
85573056168SMichael Klier                }
85673056168SMichael Klier            }
85773056168SMichael Klier            return $versions;
85873056168SMichael Klier        } else {
85973056168SMichael Klier            return array();
86073056168SMichael Klier        }
86173056168SMichael Klier    }
86273056168SMichael Klier
86373056168SMichael Klier    /**
864797c0d11SAndreas Gohr     * The version of Wiki RPC API supported
865797c0d11SAndreas Gohr     */
866797c0d11SAndreas Gohr    function wiki_RPCVersion(){
867797c0d11SAndreas Gohr        return 2;
868797c0d11SAndreas Gohr    }
8691b11c097SAndreas Gohr
87028ec3c76SAndreas Gohr
87128ec3c76SAndreas Gohr    /**
87228ec3c76SAndreas Gohr     * Locks or unlocks a given batch of pages
87328ec3c76SAndreas Gohr     *
87428ec3c76SAndreas Gohr     * Give an associative array with two keys: lock and unlock. Both should contain a
87528ec3c76SAndreas Gohr     * list of pages to lock or unlock
87628ec3c76SAndreas Gohr     *
87728ec3c76SAndreas Gohr     * Returns an associative array with the keys locked, lockfail, unlocked and
87828ec3c76SAndreas Gohr     * unlockfail, each containing lists of pages.
87928ec3c76SAndreas Gohr     */
88028ec3c76SAndreas Gohr    function setLocks($set){
88128ec3c76SAndreas Gohr        $locked     = array();
88228ec3c76SAndreas Gohr        $lockfail   = array();
88328ec3c76SAndreas Gohr        $unlocked   = array();
88428ec3c76SAndreas Gohr        $unlockfail = array();
88528ec3c76SAndreas Gohr
88628ec3c76SAndreas Gohr        foreach((array) $set['lock'] as $id){
88728ec3c76SAndreas Gohr            if(checklock($id)){
88828ec3c76SAndreas Gohr                $lockfail[] = $id;
88928ec3c76SAndreas Gohr            }else{
89028ec3c76SAndreas Gohr                lock($id);
89128ec3c76SAndreas Gohr                $locked[] = $id;
89228ec3c76SAndreas Gohr            }
89328ec3c76SAndreas Gohr        }
89428ec3c76SAndreas Gohr
89528ec3c76SAndreas Gohr        foreach((array) $set['unlock'] as $id){
89628ec3c76SAndreas Gohr            if(unlock($id)){
89728ec3c76SAndreas Gohr                $unlocked[] = $id;
89828ec3c76SAndreas Gohr            }else{
89928ec3c76SAndreas Gohr                $unlockfail[] = $id;
90028ec3c76SAndreas Gohr            }
90128ec3c76SAndreas Gohr        }
90228ec3c76SAndreas Gohr
90328ec3c76SAndreas Gohr        return array(
90428ec3c76SAndreas Gohr            'locked'     => $locked,
90528ec3c76SAndreas Gohr            'lockfail'   => $lockfail,
90628ec3c76SAndreas Gohr            'unlocked'   => $unlocked,
90728ec3c76SAndreas Gohr            'unlockfail' => $unlockfail,
90828ec3c76SAndreas Gohr        );
90928ec3c76SAndreas Gohr    }
91028ec3c76SAndreas Gohr
911445e8084SAndreas Gohr    function getAPIVersion(){
912445e8084SAndreas Gohr        return DOKU_XMLRPC_API_VERSION;
913445e8084SAndreas Gohr    }
914445e8084SAndreas Gohr
915445e8084SAndreas Gohr    function login($user,$pass){
916445e8084SAndreas Gohr        global $conf;
917445e8084SAndreas Gohr        global $auth;
918445e8084SAndreas Gohr        if(!$conf['useacl']) return 0;
919445e8084SAndreas Gohr        if(!$auth) return 0;
920445e8084SAndreas Gohr        if($auth->canDo('external')){
921445e8084SAndreas Gohr            return $auth->trustExternal($user,$pass,false);
922445e8084SAndreas Gohr        }else{
923445e8084SAndreas Gohr            return auth_login($user,$pass,false,true);
924445e8084SAndreas Gohr        }
925445e8084SAndreas Gohr    }
9263ee5b583SAndreas Gohr
9273ee5b583SAndreas Gohr
928797c0d11SAndreas Gohr}
929797c0d11SAndreas Gohr
930797c0d11SAndreas Gohr$server = new dokuwiki_xmlrpc_server();
931797c0d11SAndreas Gohr
9322aca132fSMichael Klier// vim:ts=4:sw=4:et:enc=utf-8:
933