Revision as of 13:29, 27 October 2010

CKEditor allows you to add Adobe Flash files to your documents in an easy and intuitive way.

To insert a Flash object simply press the button on the toolbar. The Flash Properties dialog window that will open lets you set configuration options that define the Flash object's source, its size, display properties, or other advanced properties.

The Flash Properties dialog window includes four tabs that group Flash object options:

• General
• Upload
• Properties
• Advanced

All tabs contain the and buttons that let you accept the changes or close the dialog window without performing any changes, respectively.

Once inserted into the document, the Flash object can be edited at any time by double-clicking it. The Flash Properties dialog window will open again and you will be able to introduce changes to the Flash object configuration options.

If you attempt to close the Flash Properties dialog window without saving the changes, you will be prompted to do so:

You can either proceed without saving your changes by choosing OK or close the alert window with the Cancel command and save the changes.

General

The General tab is the default tab that opens after you press the button on the toolbar. It allows you to set the URL of the Flash object and configure the way it will appear in the document.

General tab of the Flash Properties window

Below is an overview of all General tab elements:

• URL — the web address of the Flash object. The object may be located on the same server as the web site you are now in or on an external server.
  • External server: If you want to use an external address, use the full absolute path.

    Example:

    http://example.com/flash1.swf

  • Local server: If the image is located on the same server, you can use an absolute path that omits the domain name and starts with a slash.

    Example:

    /animations/flash2.swf

    If CKEditor is integrated with a file browser (like CKFinder), you can also use the Browse Server button to select a Flash object from the ones that are available on the server.

• Width — the width of the Flash object in pixels.
• Height — the height of the Flash object in pixels.

• HSpace — the horizontal spacing (or margin) between the Flash object and other document elements that surround it, in pixels.
• VSpace — the vertical spacing (or margin) between the Flash object and other document elements that surround it, in pixels.

• Preview — a preliminary view of the selected Flash object formatted according to the options chosen above.

Upload

The Upload tab of the Flash Properties dialog window allows you to send your own Flash objects to the server. It is only visible if the server accepts files uploaded by the users and CKEditor is integrated with a file browser (like CKFinder).

Upload tab of the Flash Properties window

To upload a Flash file, click the file input field or the Browse button next to it. When the file browser of your operating system opens, navigate to an appropriate folder and choose a file by double clicking it or using the Open button. To send the file to the server, click the Send it to the Server button of CKEditor.

Properties

The Properties tab lets you configure various Flash options that control the behavior of the inserted object. They also give access to Adobe Flash Player settings that enable the object to play automatically or loop.

Properties tab of the Flash Properties window

Below is an overview of all Properties tab elements:

• Scale — the parameter that controls the scaling, stretching or shrinking of the Flash object when the browser window is resized (scale attribute). You can choose between the following options:
  • Show all — the entire object is visible with original aspect ratio retained. Borders may be present.
  • No Border — the object is scaled to fit within the specified area without any borders, with original aspect ratio retained (the sides of the object may be cropped).
  • Exact Fit — the entire object is visible within the specified area, but the original aspect ratio might not be reatined thus making the object distorted.
• Script Access — the parameter that controls the ability of the Flash object to communicate with the page it is embedded in (allowScriptAccess attribute). You can choose between the following options:
  • Always — the Flash object can communicate with the HTML page it is embedded in even if they are from different domains.
  • Same domain — the Flash object can communicate with the HTML page it is embedded in only if they are from the same domain.
  • Never — the Flash object cannot communicate with the HTML page it is embedded in.
• Window mode — the parameter that controls the layering of the Flash object in the browser window (wmode attribute). You can choose between the following options:
  • Window — the Flash object plays in its own window on a document.
  • Opaque — the Flash object hides everything underneath.
  • Transparent — the document background shows through all transparent parts of the Flash object.
• Quality — the parameter that controls the relation between the speed of the object and its appearance (quality attribute). You can choose between the following options:
  • Best — best appearance, speed is unimportant.
  • High — appearance is favored over speed.
  • Auto High — speed and appearance are equally emphasized.
  • Medium — speed is favored over quality, but some anti-aliasing is applied.
  • Auto Low — speed is favored over quality, but quality is improved whenever possible.
  • Low — speed is favoured over quality and anti-aliasing is never applied.
• Align — the parameter that controls the alignment of the Flash object in the document (align attribute). You can choose between the following options: Left, Abs Bottom, Abs Middle, Baseline, Bottom, Middle, Right, Text Top, or Top.

The Properties tab lets you configure four additional options pertaining to the Flash Player:

• Enable Flash Menu — the parameter that controls whether the Flash context menu is enabled.
• Auto Play — the parameter that controls whether the Flash object will start playing automatically right after you open the document.
• Loop — the parameter that controls whether the Flash object will play continuously in a loop.
• Allow Fullscreen — the parameter that controls whether the Flash object may be played in the full screen mode.

Advanced

The Advanced tab lets you configure additional Flash object options such as assign it an ID, a class, a tooltip or CSS style properties. It is meant for advanced users with knowledge of HTML and CSS and gives nearly endless possibilities as far as the presentation of the Flash object is concerned.

Advanced tab of the Flash Properties window

Below is the overview of all Advanced tab elements:

• Id — a unique identifier for an element in the document (id attribute).
• Advisory Title — the text of the tooltip that is shown when the mouse cursor hovers over the Flash object (title attribute).
• Background color — the color that is visible beneath the transparent portions of the Flash object.
• Stylesheet Classes — a class of the element (class attribute). Note that an element might be assigned more than one class. If this is a case, separate class names with spaces.
• Style — CSS style definitions. Note that each value must end with a semi-colon and individual properties should be separated with spaces (style attribute).