DokuWiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== Synchronization Plugin ======

---- plugin ----
description: Synchronize two Wiki installs via XMLRPC
author     : Andreas Gohr
email      : andi@splitbrain.org
type       : admin
lastupdate : 2010-03-22
compatible : 2009-12-25+
depends    : 
conflicts  : 
similar    : 
tags       : sync, xmlrpc

downloadurl: http://github.com/splitbrain/dokuwiki-plugin-sync/zipball/master
sourcerepo : http://github.com/splitbrain/dokuwiki-plugin-sync/
bugtracker : http://github.com/splitbrain/dokuwiki-plugin-sync/issues
donationurl: http://donate.dokuwiki.org/Sync
----

===== Download and Installation =====

To download and install the plugin through the plugin manager or manually, please use the download link given above.

==== Changes ====

{{rss>http://github.com/feeds/splitbrain/commits/dokuwiki-plugin-sync/master date}}

===== Usage =====

The plugin needs to be installed on one side only (we're calling it the //local// side) eg. your laptop. The other wiki (the //remote// side) needs to have the [[config:xmlrpc]] enabled.

Once installed, the plugin is available in the admin interface.

==== Profiles ====

{{ http://www.splitbrain.org/_media/blog/2009-03/sync/screen02.jpg?450 }}

Before syncing you need to create a Synchronization profile. The following options can be set:

Hint: you can define multiple profiles accessing the same remote wiki to be able to selectively sync different parts.

==== Syncing ====

{{ http://www.splitbrain.org/_media/blog/2009-03/sync/screen04.jpg?400}}

When you select a profile and hit "Start Synchronization", the plugin will gather a list of files that are different between the local and the remote wiki. It automatically suggests in which direction files should be synced if possible. Files can be:

* copied from the remote to the local wiki (overwriting existing local pages)
  * copied to the remote from the local wiki (overwriting existing remote pages)
  * or both versions can be kept as is

A link labeled "Diff" next to each page will open a [[:diff|difference view]] in a popup.

Below the list of changed files a [[:summary]] can be given which will be used for the recent changes view in the remote and local wiki.

==== Notes ====
 
  * the remote Wiki needs to have the [[config:XMLRPC]] interface to be enabled
  * if the remote Wiki uses the [[config:xmlrpcuser]] option, you need to specify a privileged user in the login config of the sync profile
  * it is not possible to sync a remote namespace to a differently named local namespace as this would break links and such, if you want to sync multiple wikis, it is recommended to install mutliple local wiki instances on your laptop
  * to get through .htaccess password protection, use http://username:password@yourserver.com/dokuwiki/lib/exe/xmlrpc.php as the URL
  * The plugin only syncs content (pages and media) not templates or configuration data

===== Discussion =====

:!: Please don't report any bugs or feature requests here but instead use the [[http://github.com/splitbrain/dokuwiki-plugin-sync/issues|bug tracker]]!  :!:

Please fill all the letters into the box to prove you're human. C O G C G Please keep this field empty:

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International