Quick HOWTO for integrating KFM 1.3 into Tikiwiki (UNIX like systems)
Why KFM ?
- Very easy integration with FCK or TinyMCE Editor under Tikiwiki (AJAX + PHP)
- Display folders in a navigation tree (ie: /home/tikiwiki/img/KFM)
- Images are shown as thumbnails while browsing
- Images editor (Crop, resize, rotate...)
- files management (delete, rename, move, search engine...)
- Multi-languages
- ... more at http://kfm.verens.com
HowTo:
A-/ Install KFM :
Unzip http://kfm.verens.com/f/kfm-1.3.1.zip
under MyTikiwiki_PROJECT/lib/fckeditor/editor/plugins/kfm
B-/ Configure KFM (configuration.php):
cp -p configuration.dist.php configuration.php
Then edit configuration.php according to your needs (example below) :
- Add the TIKIWIKI's database access :
$kfm_db_prefix = 'kfm_'; // default prefix of the tables of KFM $kfm_db_name = 'My_DB'; $kfm_db_username = 'My_DB_user'; $kfm_db_password = 'My_DB_pwd';
- Define the folder ROOT to browse :
$kfm_userfiles_address = '/home/tikiwiki/img/KFM';
In a console, create the ROOT directory :
mkdir /home/tikiwiki/img/KFM chown -R apache:apache /home/tikiwiki/img/KFM
- Specify the ROOT of the URL returned to the WYSIWYG editor (FCK or TinyMCE) when the user double-click on an image or a file
$kfm_userfiles_output = 'http://www.MyDomain.com/tikiwiki/lib/fckeditor/editor/plugins/kfm/get.php';
(You can also use your OWN "image viewer" and "File Downloader")
- Hide some features :
ie: $kfm_hidden_panels = 'logs,widgets,directory_properties,file_details';
C-/ Include authentication management of TIKIWIKI:
(KFM has his own session management which is disabled by default)
- activate the authentication management :
cp -p api/config.php.dist api/config.php
- Uncomment the last line of api/config.php
$kfm_api_auth_override=1;
- Paste above the previous uncommented line the authentication management of TW :
=> insert the message displayed when the authentication failed :
echo 'ERROR : session not initialized or expired'; exit;
(This generate a white page containing the text above)
D-/ Call KFM from a link : (note the language preference in the parameters)
<a href="javascript:;" onClick="javascript: window.open('http://www.MyDomain.com/tikiwiki/lib/fckeditor/editor/plugins/kfm/index.php?mode=selector&lang=fr&type='+type,'kfm','modal,width=800,height=600');">Browse directories</a>
E-/ Integrate KFM within FCK or TinyMCE (http://kfm.verens.com/Documentation)
Sorry, the example below concerns TinyMCE
The KFM window is displayed when using the buttons Insert an image and Insert a link
<script language="JavaScript" type="text/javascript"> // <!-- Hide script function kfm_for_tiny_mce(field_name, url, type, win){ window.SetUrl=function(url,width,height,caption){ win.document.forms[0].elements[field_name].value = url; if(caption){ win.document.forms[0].elements["alt"].value=caption; win.document.forms[0].elements["title"].value=caption; } } window.open('http://www.MyDomain.com/tikiwiki/lib/fckeditor/editor/plugins/kfm/index.php?mode=selector&lang=fr&type='+type,'kfm','modal,width=800,height=600'); } tinyMCE.init({ mode : "none", language : 'fr', ... ... file_browser_callback : "kfm_for_tiny_mce", }); //End script hiding --> </script>
See also Help
https://www.ohloh.net/p/kfm