FCKeditor 2.x/Developers Guide/Configuration/Built in File Browser - Revision history

Fredck at 09:14, 13 June 2008

2008-06-13T09:14:42Z

Fredck at 09:13, 13 June 2008

2008-06-13T09:13:29Z

Fredck at 10:33, 21 May 2008

2008-05-21T10:33:13Z

Fredck at 11:41, 9 February 2008

2008-02-09T11:41:42Z

W.olchawa at 13:49, 16 January 2008

2008-01-16T13:49:35Z

W.olchawa at 13:46, 16 January 2008

2008-01-16T13:46:38Z

W.olchawa at 13:44, 16 January 2008

2008-01-16T13:44:40Z

W.olchawa at 13:40, 16 January 2008

2008-01-16T13:40:22Z

W.olchawa at 13:34, 16 January 2008

2008-01-16T13:34:21Z

W.olchawa at 13:31, 16 January 2008

2008-01-16T13:31:33Z

@@ Line 45: / Line 45: @@
 #You can use the '''UserFilesAbsolutePath''' setting to specify the local path for the folder where the files will be stored, and then in UserFilesPath you can use an absolute url like <nowiki>"http://www.example.com/myfiles/</nowiki>".
-== Returning Full URLs ==
+== Returning Full URLs  ==
-You can configure the File Browser to return full URLs to FCKeditor, like "http://www.example.com/userfiles/", instead of absolute URLs, like "/userfiles/". To do that, you must configure the connector, combining the '''UserFilesPath''' and '''UserFilesAbsolutePath''' settings:
+You can configure the File Browser to return full URLs to FCKeditor, like "<nowiki>http://www.example.com/userfiles/</nowiki>", instead of absolute URLs, like "/userfiles/". To do that, you must configure the connector, combining the '''UserFilesPath''' and '''UserFilesAbsolutePath''' settings:
-*'''UserFilesPath''': include here the '''full URL''' for the user files directory. For example, set it to "http://www.example.com/userfiles/".
+*'''UserFilesPath''': include here the '''full URL''' for the user files directory. For example, set it to "<nowiki>http://www.example.com/userfiles/</nowiki>".
 *'''UserFilesAbsolutePath''': include here the '''server path''' to reach the above URL directory. For example, in a Windows environment, you could have something like "C:/inetpub/mysite/userfiles/", while on Linux, something like "/usr/me/public_html/mysite/userfiles/".

@@ Line 36: / Line 36: @@
 </pre>
-== Uploading Files ==
+== Uploading Files  ==
 To upload files to the server you will also need to:
-# chmod 0777 the directory you want to upload to (insecure).<br> '''NOTE''': It is advisable to change the group ownership of the directory to the same user as apache and add group write permisions instead.
+#chmod 0777 the directory you want to upload to (insecure).<br> '''NOTE''': It is advisable to change the group ownership of the directory to the same user as apache and add group write permisions instead.
-# In the connector configuration file (editor/filemanger/connectors/php/config.php) set '''$Config['Enabled']''' to '''true'''.'''<br>NOTE''': this is highly insecure unless you have protected the access to this directory with some kind of authentication. You can use session variables to avoid this problem.
+#In the connector configuration file (editor/filemanger/connectors/php/config.php) set '''$Config['Enabled']''' to '''true'''.'''<br>NOTE''': this is highly insecure unless you have protected the access to this directory with some kind of authentication. You can use session variables to avoid this problem.
-# Set in '''$Config['UserFilesPath']''' the url relative to the web site root where the files will be stored and retrieved from the web. For example "/userfiles/" if the files are supposed to be saved and retrieved from "http://www.example.com/userfiles/".<br>
+#Set in '''$Config['UserFilesPath']''' the url relative to the web site root where the files will be stored and retrieved from the web. For example "/userfiles/" if the files are supposed to be saved and retrieved from "http://www.example.com/userfiles/".<br>
-# You can use the '''UserFilesAbsolutePath''' setting to specify the local path for the folder where the files will be stored, and then in UserFilesPath you can use an absolute url like <nowiki>"http://www.example.com/myfiles/</nowiki>".
+#You can use the '''UserFilesAbsolutePath''' setting to specify the local path for the folder where the files will be stored, and then in UserFilesPath you can use an absolute url like <nowiki>"http://www.example.com/myfiles/</nowiki>".
 == Allow and deny extensions settings for filetypes ==

@@ Line 64: / Line 64: @@
 For versions up to 2.4.3, if you have to integrate FCKeditor in an existing project, there may be no possibility to use the standard filebrowser folders based on the filetype: ''Image'', ''Flash'', ''Media'' and ''File''. In this case, the following comment may help you: http://sourceforge.net/tracker/index.php?func=detail&amp;aid=1312834&amp;group_id=75348&amp;atid=543655
-== Using the File Browser outside of FCKeditor ==
+== Using the File Browser outside of FCKeditor  ==
-You can use the File Browser in your pages using this code as was described here: https://sourceforge.net/tracker/index.php?func=detail&amp;aid=1369609&amp;group_id=75348&amp;atid=543655
+You may use the File Browser in your pages directly. Even if this feature is not supported by default, you may find some information about it here:<br>https://sourceforge.net/tracker/index.php?func=detail&amp;aid=1369609&amp;group_id=75348&amp;atid=543655

@@ Line 40: / Line 40: @@
 To upload files to the server you will also need to:
-# chmod 0777 the directory you want to upload to (insecure).<br> '''NOTE''': It is advisable to change the group ownership of the directory to the same user as apache and add group write permisions instead
+# chmod 0777 the directory you want to upload to (insecure).<br> '''NOTE''': It is advisable to change the group ownership of the directory to the same user as apache and add group write permisions instead.
-# in .../connectors/php/config.php You have to set '''$Config['Enabled']''' to TRUE<br> '''NOTE''': this is highly insecure unless you have protected the access to this directory with some kind of authentication. You can use session variables to avoid this problem.
+# In the connector configuration file (editor/filemanger/connectors/php/config.php) set '''$Config['Enabled']''' to '''true'''.'''<br>NOTE''': this is highly insecure unless you have protected the access to this directory with some kind of authentication. You can use session variables to avoid this problem.
-# Set in '''$Config['UserFilesPath']''' the url relative to the root where the files will be stored (example: /userfiles/)
+# Set in '''$Config['UserFilesPath']''' the url relative to the web site root where the files will be stored and retrieved from the web. For example "/userfiles/" if the files are supposed to be saved and retrieved from "http://www.example.com/userfiles/".<br>
-# You can use the UserFilesAbsolutePath setting to specify the local folder where the files will be stored, and then in UserFilesPath you can use an absolute url like <nowiki>http://www.mydomain.com/myfiles/</nowiki>
+# You can use the '''UserFilesAbsolutePath''' setting to specify the local path for the folder where the files will be stored, and then in UserFilesPath you can use an absolute url like <nowiki>"http://www.example.com/myfiles/</nowiki>".
 == Allow and deny extensions settings for filetypes ==

@@ Line 35: / Line 35: @@
 var _QuickUploadLanguage = 'php'&nbsp;;
 </pre>
 == Uploading Files ==
@@ Line 67: / Line 66: @@
 == Using the File Browser outside of FCKeditor ==
-You can use the File Browser in your pages using this code as was described here: https://sourceforge.net/tracker/index.php?func=detail&aid=1369609&group_id=75348&atid=543655
+You can use the File Browser in your pages using this code as was described here: https://sourceforge.net/tracker/index.php?func=detail&amp;aid=1369609&amp;group_id=75348&amp;atid=543655
 Download the code (''pick.js'') and put it in your website directory. You have to include this file in the page where you want to use the File Browser in.
 Example: if you put ''pick.js'' in the same directory as the file in which you refer the file browser you can put this code in your heading:
-<pre>
+<pre>&lt;script language="JavaScript" src="pick.js" type="text/javascript"&gt;&lt;/script&gt;
-<script language="JavaScript" src="pick.js" type="text/javascript"></script>
+</pre>
 Put a button to launch the File Browser and pass the reference to the input that will receive the selected image:
-<pre>
+<pre>&lt;button type="button" onclick="BrowseServer('txtId');"&gt;Pick Image&lt;/button&gt;
-<button type="button" onclick="BrowseServer('txtId');">Pick Image</button>
+&lt;input type="text" id="txtId"/&gt;
-<input type="text" id="txtId"/>
+</pre>
 The only thing you will have to do is modify the path to the upload connector - it is currently set for the ASP.NET version.
-<pre>
+<pre>// File Picker modification for FCK Editor v2.0 - www.fckeditor.net
-// File Picker modification for FCK Editor v2.0 - www.fckeditor.net
+// by: Pete Forde &lt;pete@unspace.ca&gt; @ Unspace Interactive
 var urlobj;
 function BrowseServer(obj)
+{
-        urlobj = obj;
+urlobj = obj;
-        OpenServerBrowser(
+OpenServerBrowser(
-                '/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Image&Connector=connectors/aspx/connector.aspx',
+'/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Image&amp;Connector=connectors/aspx/connector.aspx',
-                screen.width * 0.7,
+screen.width * 0.7,
-                screen.height * 0.7 ) ;
+screen.height * 0.7 )&nbsp;;
+}
 function OpenServerBrowser( url, width, height )
+{
-        var iLeft = (screen.width  - width) / 2 ;
+var iLeft = (screen.width - width) / 2&nbsp;;
-        var iTop  = (screen.height - height) / 2 ;
+var iTop = (screen.height - height) / 2&nbsp;;
-        var sOptions = "toolbar=no,status=no,resizable=yes,dependent=yes" ;
+var sOptions = "toolbar=no,status=no,resizable=yes,dependent=yes"&nbsp;;
-        sOptions += ",width=" + width ;
+sOptions += ",width=" + width&nbsp;;
-        sOptions += ",height=" + height ;
+sOptions += ",height=" + height&nbsp;;
-        sOptions += ",left=" + iLeft ;
+sOptions += ",left=" + iLeft&nbsp;;
-        sOptions += ",top=" + iTop ;
+sOptions += ",top=" + iTop&nbsp;;
-        var oWindow = window.open( url, "BrowseWindow", sOptions ) ;
+var oWindow = window.open( url, "BrowseWindow", sOptions )&nbsp;;
+}
 function SetUrl( url, width, height, alt )
+{
-        document.getElementById(urlobj).value = url ;
+document.getElementById(urlobj).value = url&nbsp;;
-        oWindow = null;
+oWindow = null;
+}
 </pre>
 E.g. if you want to use PHP as a connector instead of ASP.NET use:
-<pre>
+<pre>'/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Image&amp;Connector=connectors/php/connector.php'
 </pre>

← Older revision		Revision as of 13:40, 16 January 2008
Line 78:		Line 78:

	For versions up to 2.4.3, if you have to integrate FCKeditor in an existing project, there may be no possibility to use the standard filebrowser folders based on the filetype: ''Image'', ''Flash'', ''Media'' and ''File''. In this case, the following comment may help you: http://sourceforge.net/tracker/index.php?func=detail&aid=1312834&group_id=75348&atid=543655		For versions up to 2.4.3, if you have to integrate FCKeditor in an existing project, there may be no possibility to use the standard filebrowser folders based on the filetype: ''Image'', ''Flash'', ''Media'' and ''File''. In this case, the following comment may help you: http://sourceforge.net/tracker/index.php?func=detail&aid=1312834&group_id=75348&atid=543655
		+
		+	== Using the File Browser outside of FCKeditor ==
		+
		+	You can use the File Browser in your pages using this code as was described here: https://sourceforge.net/tracker/index.php?func=detail&aid=1369609&group_id=75348&atid=543655
		+
		+	Download the code (''pick.js'') and put it in your website directory. You have to include this file in the page where you want to use the File Browser in.
		+
		+	Example: if you put ''pick.js'' in the same directory as the file in which you refer the file browser you can put this code in your heading:
		+	<pre>
		+	<script language="JavaScript" src="pick.js" type="text/javascript"></script>
		+	</pre>
		+	Put a button to launch the File Browser and pass the reference to the input that will receive the selected image:
		+	<pre>
		+	<button type="button" onclick="BrowseServer('txtId');">Pick Image</button>
		+	<input type="text" id="txtId"/>
		+	</pre>
		+	The only thing you will have to do is modify the path to the upload connector - it is currently set for the ASP.NET version.
		+	<pre>
		+	// File Picker modification for FCK Editor v2.0 - www.fckeditor.net
		+	// by: Pete Forde <pete@unspace.ca> @ Unspace Interactive
		+	var urlobj;
		+	function BrowseServer(obj)
		+	{
		+	urlobj = obj;
		+	OpenServerBrowser(
		+	'/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Image&Connector=connectors/aspx/connector.aspx',
		+	screen.width * 0.7,
		+	screen.height * 0.7 ) ;
		+	}
		+	function OpenServerBrowser( url, width, height )
		+	{
		+	var iLeft = (screen.width - width) / 2 ;
		+	var iTop = (screen.height - height) / 2 ;
		+	var sOptions = "toolbar=no,status=no,resizable=yes,dependent=yes" ;
		+	sOptions += ",width=" + width ;
		+	sOptions += ",height=" + height ;
		+	sOptions += ",left=" + iLeft ;
		+	sOptions += ",top=" + iTop ;
		+	var oWindow = window.open( url, "BrowseWindow", sOptions ) ;
		+	}
		+	function SetUrl( url, width, height, alt )
		+	{
		+	document.getElementById(urlobj).value = url ;
		+	oWindow = null;
		+	}
		+	</pre>
		+
		+	E.g. if you want to use PHP as a connector instead of ASP.NET use:
		+	<pre>
		+	'/FCKeditor/editor/filemanager/browser/default/browser.html?Type=Image&Connector=connectors/php/connector.php'
		+	</pre>

← Older revision		Revision as of 13:34, 16 January 2008
Line 72:		Line 72:

	Denying extensions will show all files except for the ones with the specified extensions, while allowing extensions will show no files except for the ones with the specified extensions. To allow all extensions for a filetype, leave both of the arrays empty for that filetype.		Denying extensions will show all files except for the ones with the specified extensions, while allowing extensions will show no files except for the ones with the specified extensions. To allow all extensions for a filetype, leave both of the arrays empty for that filetype.
		+
		+	== Set a specific directory for each file type ==
		+
		+	In the current SVN and in 2.5 it will be possible to specify if each file type should use a custom folder using the '''FileTypesPath''' and '''FileTypesAbsolutePath'''. The QuickUpload folders can be controlled with '''QuickUploadPath''' and '''QuickUploadAbsolutePath'''.
		+
		+	For versions up to 2.4.3, if you have to integrate FCKeditor in an existing project, there may be no possibility to use the standard filebrowser folders based on the filetype: ''Image'', ''Flash'', ''Media'' and ''File''. In this case, the following comment may help you: http://sourceforge.net/tracker/index.php?func=detail&aid=1312834&group_id=75348&atid=543655

← Older revision		Revision as of 13:31, 16 January 2008
Line 59:		Line 59:
	# Set in '''$Config['UserFilesPath']''' the url relative to the root where the files will be stored (example: /userfiles/)		# Set in '''$Config['UserFilesPath']''' the url relative to the root where the files will be stored (example: /userfiles/)
	# You can use the UserFilesAbsolutePath setting to specify the local folder where the files will be stored, and then in UserFilesPath you can use an absolute url like http://www.mydomain.com/myfiles/		# You can use the UserFilesAbsolutePath setting to specify the local folder where the files will be stored, and then in UserFilesPath you can use an absolute url like http://www.mydomain.com/myfiles/
		+
		+	== Allow and deny extensions settings for filetypes ==
		+
		+	In editor/filemanager/connectors/(your server side language extension)/config.(extension) you can configure what extensions are allowed or denied for specific filetypes.
		+
		+	The filetypes you can configure are:
		+
		+	* Files, e.g. : 'htm', 'html', 'php', 'php3', 'php5', 'phtml', 'asp', 'aspx', 'ascx', 'jsp', 'cfm', 'cfc', 'pl', 'bat', 'exe', 'dll', 'reg', 'cgi', 'asmx'
		+	* Images, e.g. : 'jpg', 'gif', 'jpeg', 'png'
		+	* Flash, e.g. : 'swf'
		+	* Media, e.g. : 'swf', 'fla', 'jpg', 'gif', 'jpeg', 'png', 'avi', 'mpg', 'mpeg'
		+
		+	Denying extensions will show all files except for the ones with the specified extensions, while allowing extensions will show no files except for the ones with the specified extensions. To allow all extensions for a filetype, leave both of the arrays empty for that filetype.