Expresso
Installation
Download and unzip Expresso, then follow the simple steps below:
- Upload the system/expressionengine/third_party/expresso folder
- Upload the themes/third_party/expresso folder
- Install the Expresso fieldtype (Control Panel > Add-Ons > Fieldtypes > Install)
- Open the Expresso fieldtype settings (Control Panel > Add-Ons > Fieldtypes > Expresso), enter your license number and make any customisations
- Create a custom channel field and select Expresso as the field type
Updating
Download and unzip the latest version of Expresso, then follow the steps below:
- Overwrite the system/expressionengine/third_party/expresso folder
- Overwrite the themes/third_party/expresso folder
- Open the Expresso fieldtype settings (Control Panel > Add-Ons > Fieldtypes > Expresso) and modify any newly available features
Global Field Settings
You can customise a number of things including the toolbar in the global field settings
(Control Panel > Add-Ons > Fieldtypes > Expresso):
- Background Color
- Any hexadecimal color (#A0B1BC default, #ECF1F4 for transparent)
- Height
- The height of the Expresso field in pixels
- Toolbar Icons
- Select the icons that should appear in the toolbar
- Header Styles
- Select the header styles that should appear in the toolbar
- CSS
- Any CSS code you add here will be applied to the Expresso WYSIWYG editor (it will not be applied to the rendered content)
- Custom Toolbar
-
You can create a custom toolbar by manually entering code in the following format (see the CKEditor toolbar docs for all toolbar icons)
[ "Bold", "Italic", "Underline", "Strike", "Subscript", "Superscript" ], [ "Link", "Unlink", "Anchor" ], [ "Image", "Flash", "Table", "HorizontalRule", "Iframe" ] - Styles
-
You can create custom styles by manually entering code in the following format (see the CKEditor styles docs)
{ name: "Red Title" , element: "h3", styles: { "color": "Red" } }, { name: "CSS Style", element: "span", attributes: { "class": "my_style" } }, { name: "Marker: Yellow", element: "span", styles: { "background-color": "Yellow" } }
Import/Export Settings
You can very quickly import and export your Expresso global field settings by clicking on the buttons at the top of the global field settings page. This makes it easy to deploy the same Expresso settings accross all of your Expressionengine sites.
Individual Field Settings
You can customise a number of things specific to an Expresso field in the individual field settings
(Control Panel > Admin > Channel Administration > Channel Fields):
- Toolbar
- Select whether to display the full (all selected icons), basic (only basic icons), light (minimal set of icons) or custom toolbar
- File Manager
- Select whether the file manager should be enabled for this field
- Height
- The height of the Expresso field in pixels (if set then it will override the height set in the global field settings)
- CSS
- Any CSS code you add here will be applied to the Expresso WYSIWYG editor in addition to any CSS code you added in the global field settings (it will not be applied to the rendered content)
Template Tag Parameters
You can use parameters to alter the output of your template tag.
{page_text strip_tags="true" allowable_tags="<em><strong>" word_limit="20"}
- strip_tags="true"
- Strips all html tags from the output
- allowable_tags="<em><strong>"
- If strip_tags is set to true then this parameter allows you to specify what html tags should not be stripped
- character_limit="100"
- Limits the output to the specified number of characters
- word_limit="20"
- Limits the output to the specified number of words
- paragraph_limit="1"
- Limits the output to the specified number of paragraphs