PHP

It is very easy to use FCKeditor in your php web pages. Just follow these steps.

Contents

Integration step by step

Step 1

The first thing to do is to include the "PHP Integration Module" file in the top of your page as in the example below:

<?php
include_once("fckeditor/fckeditor.php") ;
?>

Of course the include path refers to the place where you have installed your FCKeditor.

Step 2

Now the FCKeditor is available and ready to use. So, just insert the following code in your page to create an instance of the editor inside a <FORM>:

<?php
$oFCKeditor = new FCKeditor('FCKeditor1') ;
$oFCKeditor->BasePath = '/fckeditor/' ;
$oFCKeditor->Value = '<p>This is some <strong>sample text</strong>. You are using <a href="http://www.fckeditor.net/">FCKeditor</a>.</p>' ;
$oFCKeditor->Create() ;
?>

Step 3

The editor is now ready to be used. Just open the page in your browser to see it at work.

Complete Sample

<?php
include_once("fckeditor/fckeditor.php") ;
?>
<html>
<head>
  <title>FCKeditor - Sample</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body>
  <form action="sampleposteddata.php" method="post" target="_blank">
<?php
$oFCKeditor = new FCKeditor('FCKeditor1') ;
$oFCKeditor->BasePath = '/fckeditor/' ;
$oFCKeditor->Value = '<p>This is some <strong>sample text</strong>. You are using <a href="http://www.fckeditor.net/">FCKeditor</a>.</p>' ;
$oFCKeditor->Create() ;
?>
    <br>
    <input type="submit" value="Submit">
  </form>
</body>
</html>

"FCKeditor1" is the name used to post the editor data on forms.

Configuration Options

You can pass Configuration Options using the Config array. This way you can overwrite the default setting from fckconfig.js for selected users.

<?php
$oFCKeditor = new FCKeditor('FCKeditor1') ;
$oFCKeditor->BasePath = '/fckeditor/' ;

//set the EnterMode to "br" (overwrites the default configuration from fckconfig.js)
$oFCKeditor->Config['EnterMode'] = 'br';

$oFCKeditor->Value = '<p>This is some <strong>sample text</strong>. You are using <a href="http://www.fckeditor.net/">FCKeditor</a>.</p>' ;
$oFCKeditor->Create() ;
?>


Handling the posted data

The editor instance just created will behave like a normal <INPUT> field in a form. It will use the name you've used when creating it (in the above sample, "FCKeditor1"). So, if you have magic quotes enabled, retrieve its value by doing something like this:

$sValue = stripslashes( $_POST['FCKeditor1'] ) ;

Additional information

  • You can find some samples on how to use the editor in the "_samples/php" directory of the distributed package.
This page was last modified on 18 April 2008, at 17:40.