Support for WebDAV was added to Tiki5 and has been improved in Tiki 6.x. It requires PHP 5.2
WebDAV is very client & environment-dependent. Thus while it works is some conditions for some people, it doesn't work reliably for others. If it's not working for you, please get the most recent 6.x proposals from the Daily Builds. If that doesn't work, please report a bug.
WebDAV is very client & environment-dependent. Thus while it works is some conditions for some people, it doesn't work reliably for others. If it's not working for you, please get the most recent 6.x proposals from the Daily Builds. If that doesn't work, please report a bug.
WebDAV (or "Web Folders")
Web-based Distributed Authoring and Versioning, or WebDAV, is a set of extensions to the Hypertext Transfer Protocol (HTTP) that allows computer-users to edit and manage files collaboratively on remote World Wide Web servers. This feature has been introduced in Tiki5, using eZ Components's implementation of WebDAV. (Thanks eZ Components!)
Purpose: permits a user to access the File Gallery (There is also WebDAV access to Wiki Pages) via a WebDAV client such as Nautilus from Gnome (GNU/Linux), Konqueror or Dolphin from KDE (GNU/Linux or MS Windows), or the Open As Webfolder Firefox plugin in MS Windows. This means also the ability to drag & drop files from your favorite file manager in your desktop computer directly to the WebDAV-powered file gallery in Tiki. Or re-arranging files in subfolders, etc. in the Tiki file galleries directly from your favourite file manager desktop application:
With WebDAV and Category Transitions, Tiki can be considered as a DMS
Note:
If you plan to test the WebDAV features in some server, please ensure that your test site is online, and that it has the basic configuration requirements set. As an example, the site http://demo.tiki.org/5x/ where most of the following screenshots were taken isno longer available online as of October 2010. back online
If you plan to test the WebDAV features in some server, please ensure that your test site is online, and that it has the basic configuration requirements set. As an example, the site http://demo.tiki.org/5x/ where most of the following screenshots were taken is
1. Server requirements
You need DOMDocument. (php5-xmlrpc, php-xml-parser, php-pear, or similar;)DOMDocument missing
Fatal error: Class 'DOMDocument' not found in /var/www/html/lib/ezcomponents/Webdav/src/tools/xml.php on line 132
and DateTime
DateTime is missing
Fatal error: Class 'DateTime' not found in /var/www/html/lib/ezcomponents/Webdav/src/tools/date_time.php on line 22
I (sylvieg) thinks mod_dav must be activated on apache
For ubuntu:
{CODE()}
a2enmod dav_fs
a2enmod dav
/etc/init.d/apache2 reload
2. Configuration requirements
Go to "Admin > Features" and enable "File galleries" and "WebDAV".Then you have to set perms on file galleries properly. The important
permissions are:
- for viewing
- view_file_gallery
- list_file_gallery
- for writing
- upload_files
- admin_file_galleries
If you want to allow file versioning in the file gallery, you have to change in (assuming your file gallery is ID number 1) tiki-list_file_gallery.php?edit_mode=1&galleryId=1 :
| Param | Values & Description
|
| "Maximum number of archives for each file" | -1 (none), 0 (unlimited), or any number of your choice. |
3. Basic Usage
Once properly connected to a WebDAV folder, you can double click a file, edit (in your desktop software) and when you save, the file is saved to your Tiki directory.If file versionning is activated in that file gallery ("Maximum number of archives for each file" set to something different than -1), a copy of each save is conserved.
Example:
You could have an .odt or .doc file in a file gallery. That user would be able to open that file from KWord or MS Office directly
Note: OpenOffice.org doesn't seem to work with any version of WebDAV - neither OOo 3.x, 2.x or 1.x, even if you select that OOo uses its own file dialogues, from "Tools > Options > General"
In this example we edited the file "Testing_webdav_from_office_apps.odt" from KWord:
and when we click in the tool icon on the left of each file, we can see the "Archives" section of the popup box, which indicates that this file has 3 prior versions in this Tiki WebDAV-powered file gallery. If you click on archives, you can access to the previous versions of that file, with the username of each editor, edit date, etc.
4. Usage through file managers
You need to write the URL with the appropriate syntax for the tiki file galleries in order to connect to the WebDAV folder.Once connected, you can double click on the file name (or click with alternate mouse button and select the program of your choice).
Edit that file, and when you click on save, the file will be directly saved to the file gallery.
Special feature: Access any version
- If you activate versioning for the files in file gallery, you can access whichever version you like, the default is the last one.
- To access a precise version just add this part:
?version_number
at the end of the file name...
The different versions are not shown in the file listing in order to keep the user interface simpler.
4.1. Nautilus (GNOME - GNU/Linux)
Type in the location bar of nautilus something like:dav://user@yourdomain.org/tiki-webdav.php/
where user is your username in Tiki (with enough global permissions or local on that file gallery; see above), and yourdomain.org is the base URL of your site online. You will be prompted you password, and then, you'll be able to see and browse your file galleries as folders, etc.
Drag and drop works, editing documents in WebDAV enabled applications (such as plain text files with gedit, etc.)
In case of concurrent editing, the latest user willing to save a modified file concurrently will see a message like:
Quote:
"The file dav://user@yourdomain...yourfile.txt has been modified since reading it."
[Save Anyway] or [Don't Save]
"If you save it, all the external changes could be lost. Save it anyway?"
[Save Anyway] or [Don't Save]
"If you save it, all the external changes could be lost. Save it anyway?"
4.2. Konqueror or Dolphin (KDE - GNU/Linux & MS Windows)
Can be used in conjunction with Konqueror as browser, Dolphin as file manager, Kate as simple text editor, KWord as an Office application for advanced text edition, etc.Similar to the description in Nautilus/Gnome above but using this type of syntax for the URL instead, to be typed in the location bar: of nautilus something like:
webdav://yourdomain.org/tiki-webdav.php/
You will be prompted for your password, and then, you'll be able to see and browse your file galleries as folders, etc.
Drag and drop works, editing documents in WebDAV enabled applications (such as plain text files with gedit, etc.)
In this case, you can edit Office documents (.odt, .doc, ...) with KWord from KOffice (tested with KWord 2.1.0 and KDE 4.4.2 on GNU/Linux)
KDE can also be installed on other operating systems. It has been proven to work on MS Windows, where some of the same applications as in GNU/Linux can be used for accessing files and folders on WebDAV-powered tiki file galleries (Dolphin, Kate, ...):
4.3. Finder (Mac OSX)
Mac OSX has the ability to connect to WebDAV folders, through "Finder > Go > Connect to server"
For instance url: http://demo.tiki.org/9x/tiki-webdav.php and the user/password that can reads files, wiki page
Once connected, files can be edited with WebDAV compatible applications, such as TextEdit (Add other applications if you know them)
4.4. BitKinex
BitKinex is a freeware-client for Windows XP/Vista/7 and available under http://www.bitkinex.com/ .Most of the setting are the defaults or obvious except:
If you run in trouble with other clients, give BitKinex a try!
4.5. Cyberduck
"Open source FTP, SFTP, WebDAV, Cloud Files, Google Docs & Amazon S3 Browser for Mac & Windows"http://cyberduck.ch/
Cyberduck is part of Tiki Suite.
5. Usage through web browsers
You need to log in as usual to your tiki site, and go to the WebDAV file gallery to see the links to open that file as in a WebDAV folder.5.1. Internet Explorer (MS Windows)
- Go with your web browser to tiki-webdav.php. You will see the link Open Tiki WebDAV as WebFolder .
You have this type of link also if you click on the context menu in that file gallery ("Open in WebDAV"; see screenshot above), It works ok with OpenOffice.org 2.x, KOffice and IE/MS Office, for instance.
For OpenOffice.org 3.x the file is open in read-only mode (known issue of eZ Components). - IE displays the following message:
- Click OK. The login window appears.
- Enter your username and password and click OK.
5.2. Firefox with extensions (MS Windows)
5.2.1. Trail-Mix extension
Trail-Mix extension allows to:- Organize Files in a Firefox explorer
- Drag & drop to WebDAV servers, among others.
Instructions on how to set it up:
- Open the Show menu and select "Online Files"
(Click the cute little squirrel on the right.) - Click the "WebDAV Server" toolbar button in the sidebar
- Enter the name you want to use for the server
- Enter the "DAV" URL, check the list above or ask your admin.
- Click ok - the top-most site directory will be displayed
Some servers redirect to login pages, and that can cause setup issues. If you get an error saying "Redirected", you may have to login first on a single-sign-on web page, but once you set it up it should work. Some servers may require https: instead of http: to use a secure SSL connection.
Also, you can set the DAV URL to any folder on the server, and only folders contained will be displayed.
More information at:
http://www.trail-mix.com/wordpress/2009/07/using-online-files-withyour-document-server/
The documentation didn't say anything that it was specific to MS Windows, but it has been proven to work under MS Windows, and not, under GNU/Linux, so far.
5.2.2. Other extensions
Note: Some users reported that the Firefox extension "Open as WebDAV extension" (for MS Windows) allowed them to connect to Tiki WebDAV file galleries (using Win XP). Other users failed to reproduce that with Firefox 3.5 and 3.6 on Win XP SP2). Therefore, some more information is needed on how to use that extension or its requirements to work properlyOpen As Webfolder 0.25 extension for firefox on Windows.
Related:
Microsoft Software Update for Web Folders (KB907306)
6. Note about Apache with PHP as fcgi or cgi
In Tiki6 an authentication problem has been identified with Apache when PHP is used in FCGI or CGI mode.If Apache is calling PHP in CGI mode, authentication HTTP Headers are not set.
In this case, you have to add the following lines inside your Apache VirtualHost config :
RewriteEngine on
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule ^(.*) - [E=HTTP_AUTHORIZATION:%1]7. WebDAV access to Wiki Pages
Added in Tiki7. Please see WebDAV access to Wiki Pages- KWord: http://www.koffice.org/kword/
- KDE on Windows: http://windows.kde.org/
- Nautilus: http://www.gnome.org/projects/nautilus/
