Editor Parameters

Parameters in the Editor Parameters Tab set the basic features of the editor for this profile. The settings are divided into 4 sections: Cleanup & Output, Typography, Filesystem and Advacned.

Cleanup & Output

Relative URLs

Use relative urls for images, links etc. Default value of Yes is recommended. Set to No when using the editor with a newsletter component.

Validate HTML

Set to Yes (recommended) to format and cleanup content based on the Doctype selected below. If Inherit is selected the Global Configuration settings for this parameter will be used.

Doctype

Doctype to validate HTML with (if Validate HTML is set to Yes)

• HTML4 : Validate using the HTML4 Transitional specification
• HTML5 : Validate using the HTML5 specification
• Mixed : Validate using a combination of the HTML4 and HTML5 specification
• Inherit : Use the Doctype set in the Global Configuration

Typography

Container Element & Enter Key

Select Container Element and Enter Key behaviour :

• Paragraph Container & Paragraph on Enter
  All Text and non-block elements will be wrapped in a Paragraph, and pressing the Enter key will create a new Paragraph. SHIFT+Enter creates a linebreak.
• Div Container & Div on Enter
  All Text and non-block elements will be wrapped in a DIV, and pressing the Enter key will create a new DIV. SHIFT+Enter creates a linebreak.
• No Container & Paragraph on Enter
  Text and non-block elements will not be wrapped. Pressing the Enter key will create a new Paragraph. SHIFT+Enter creates a linebreak.
• No Container & Linebreak on Enter
  Text and non-block elements will not be wrapped. Pressing the Enter key will create a linebreak. SHIFT+Enter creates a paragraph.
• Inherit (Default)
  Use Global Configuration settings.

Editor Styles

Specify how to integrate the Custom CSS files and Custom Styles with the Editor Styles set in the Editor Global Configuration.

• Add - Add the Custom CSS Files to the Editor Styles. Add the Custom Styles to the Styles list.
• Overwrite - Replace the Editor Styles with the Custom CSS Files and Custom Styles.
• Inherit - Use the Editor Styles set in the Editor Global Configuration only (Default)

Custom Colours

A comma separated list of colours to be used by the ColourPicker, in Hex format, eg: #ff0000.

Filesystem

This section sets global options for plugins like the Image Manager.

File Directory Path

Relative path to file directory. Defaults to images if left blank. This path can contain the variables :

• $id - Will be replaced with the user ID
• $username - Will be replaced with the user username
• $usertype - Will be replaced with the user usertype eg: author
• $profile - Will be replaced with the profile name
• $year - Will be replaced with current year, eg: 2010
• $month - Will be replaced with current month number, eg: 06
• $day - Will be replaced with the day number, eg: 10

Directory Filter

Remove or restrict access to the following folders in the File Directory Path. Values with a leading + character will allow access to the folder, values without will remove access to them.

Filesystem

Select the filesystem to use. The default is the Joomla! filesystem. 

Allow Root Access

If the Joomla filesystem is selected, this will allow access to the Filesystem root directory. Setting this option to Yes will ignore any value set in the File Directory Path. This is not recommended for security reasons. If set to No and if the File Directory Path value is blank, the File Directory Path will default to images.

Upload file size (KB)

Maximum allowed size in kilobytes of uploaded files. Cannot be greater than the listed Server Upload Size. Default value is 1024 KB.

Upload Conflict Action

Select the action for dealing with upload conflicts (where a file of the same name as the uploaded file already exists in the target folder)

File Browser Position

Position of the File Browser in the plugin dialog. 

Folder Tree

Show or hide the Folder Tree view in the File Browser. 

File Browser List Size

Number of files and folders to display in the File Browser list.

Validate Mimetype

Set whether the mimetype of uploaded files should be checked and validated against the file extension.

Websafe File Names

Format to use when creating websafe file and folder names. UTF-8 will allow full UTF-8 characters and A-Za-z0-9._-~ in the name, ASCII will convert some UTF-8 Latin characters into ASCII equivalents, eg: ë -> e, õ -> o etc. and will only allow A-Za-z0-9._-~ characters in the name.

Allow spaces in file/folder names

Set to Yes to allow spaces in file and folder names or select a character to use as a replacement for the space.

Text Case

Select the text case to use for file/folder names.

Random upload file name

Append a 5 character random string to the name of uploaded files, eg: fish.jpg might become fish_7qG2B.jpg

Date Format

Date Format to use when displaying the Modified date of Files and Folders, eg: %d/%m/%Y, %H:%M will display as 13/12/1984, 14:00

Total Files Limit

Set a limit on the total number of files the File Directory Path can contain (including all sub-folders), eg: 50. Uploads will be restricted when this limit it reached. Leave blank for no limit.

Total File Size Limit

Set a limit on the total size the File Directory Path can be, in Mb, eg: 10. Uploads will be restricted when this limit it reached. Leave blank for no limit.

View Mode

View items in the File Browser list as text items or thumbnail icons.

Cache Icons

Cache File Browser icons to speed up loading of the file list when in Image modes. Caching requires at least 32MB of available PHP memory. Disable this option if icons don't display.

Cache Folder

Folder for File Browser Icons cache and for temp images produced by the Image Editor. Default is Joomla! tmp folder. Must be writeable. Will be created if it does not exist.

Cache Size (MB)

Maximum size of the cache folder in MB

Cache Age (Days)

Maximum lifetime of a cache file in days

Cache File Limit

Maximum number of files in the cache folder.

Advanced

Prohibited Elements

Comma separated list of prohibited elements. For security purposes the following elements will always be removed unless an appropriate plugin or configuration setting is installed or enabled - applet, iframe, object, embed, script, style, body, bgsound, base, basefont, frame, frameset, head, html, id, ilayer, layer, link, meta, name, title, xml. Only applies if Cleanup HTML is Yes

Prohibited Attributes

Comma separated list of prohibited attributes, eg: dynsrc,lowsrc. Can accept regular expression values, eg: on([a-z]+) will remove all event attributes (onclick, onmouseover etc.). Only applies if Cleanup HTML is Yes

Prohibited Attribute Values

Comma separated list of prohibited attribute values in the CSS Attribute Selector format, eg: img[title='test'] will remove the title attribute value from all img tags with the value "test".
Accepts the CSS 2.1 and CSS 3 Attribute Selectors :

• Attribute starts with value : tag[name^='value']
  eg: img[src='data:image'] will remove all base64 encoded paths from img src attributes
• Attribute equals value : tag[name='value']
• Attribute is not equal to value : name!='value'
• Attribute ends with value : tag[name$='value']
  eg: img[src$='.jpg'] will remove all img src values that contain paths with the .jpg extension

Only applies if Cleanup HTML is Yes

Extended Elements

Extend functionality by adding in extra elements here, in the form element[attribute1|attribute2], separated by a comma, eg: em[id|title|class],i[id|title|class]. Elements added here will be removed from the Prohibited Elements list. Only applies if Cleanup HTML is Yes

Validate Styles

Allow only a valid CSS syntax for the style atttribute value on all elements.

Allow Javascript

Allow Javascript code insertion in the source code tab

Allow CSS

Allow CSS code (style elements) in the source code tab

Allow PHP

Allow PHP code insertion in the source code tab. If Yes, full support may require an additional frontend content or system plugin to be installed.

Word Count Limit

When a limit above 0 is set, the Word Count will display the number of words of the limit remaining, showing a negative number when limit is exceeded. Set as 0 for no limit.

Word Count Alert

Show an alert message when the word count limit is reached.

Object Resizing

Allow media objects - images, video, tables - to be drag resized in the editor window