ExpressionEngine Docs

Front-end Editing

Overview

For users with the appropriate level of access, ExpressionEngine Pro adds “front edit” links ( pro edit icon ) on the site’s front-end that allow editing the contents of each entry field individually. This is done directly on front-end without going to the Control Panel.

Clicking the link opens a popup with the field that can be modified and saved. Along with editing, users can also use front edit popup to access the full entry for editing with live preview showing the current page you are on.

edit popup

The links are being placed in your HTML right before the field’s tag (or opening tag if field tag pair is used).

Permissions: Users must be logged-in on the front-end of your site and must have a role assigned to them which allows them to access and edit content for that entry’s channel.

channel access.

Saving Content

After editing data, content can be saved by one of two ways:

save

save without reload

Unsaved Changes

When a user edits data and has unsaved changes, Pro will create an autosave of the entry and alert the user via a notification on the edit window with unsaved changes. The autosave is triggered based on the default autosave interval of 60 seconds. If you want to ensure users do not accidentally lose unsaved changes adjust the [autosave_interval_seconds] system config override to a lower interval between autosaves. A setting of 10 seconds is the recommendation.

unsaved changes

Note: If the [autosave_interval_seconds] system config value was not previously changed, Pro will set this value at 10 seconds upon install.

Example Usage:

$config['autosave_interval_seconds'] = '10'; 

Conditional Tags

{if frontedit}

{if frontedit} content {/if}

This special conditional allows you to display content if front-end editing is enabled.

Enable/Disable The Front Edit Link

There are several ways to disable front-end editing links:

Enable/Disable Front Edit Link in the template

ExpressionEngine Comment

Anything content wrapped in {!-- disable frontedit --} ... {!-- //disable frontedit --} HTML comment will not have edit links in it.

<h1>{!-- disable frontedit --}{title}{!-- //disable frontedit --}</h1>

Hint: If you need to disable front-end edit on large number of templates completely, you can wrap these comments around layout template.

HTML Comment

Anything content wrapped in <!-- disable frontedit --> ... <!-- //disable frontedit --> HTML comment will not have edit links in it.

<h1><!-- disable frontedit -->{title}<!-- //disable frontedit --></h1>

Hint: If you need to disable front-end edit on large number of templates completely, you can wrap these comments around layout template.

Field tag parameter

Use disable="frontedit" parameter on field tag to disable link for a certain field.

{page_content disable="frontedit"}

Customizing The Link Location

The edit link for each field can be placed manually using :frontedit modifier on the field or using the frontedit_link tag if you need to have a link in a different section of a template, custom styled, or you can even place a link for a field that is currently not on the page.

:frontedit

Inside {exp:channel:entries} tag, using the field name postfixed with :frontedit will generate an edit link for that field within displayed entry.

You may find it useful if disable_frontedit_links configuration override is set and you need to place the links individually.

Example usage:

{title:frontedit}

{frontedit_link}

Can be used to place edit link in arbitrary place (also outside or exp:channel:entries tag). The link can have custom CSS class applied to it.

Parameter Description
entry_id ID of entry to edit. Required.
field_name Short name of field to edit. Required, unless field_id is specified.
field_id ID of field to edit. Required, unless field_name is specified.
site_id Extra CSS class to apply to link HTML.
class Extra CSS class to apply to link HTML.

Example usage:

<h1>
    <!-- disable frontedit -->{title}<!-- //disable frontedit -->
    {frontedit_link entry_id="{entry_id}" field_name="title"}
</h1>

{page_content disable="frontedit"}
{frontedit_link entry_id="{entry_id}" field_name="page_content" class="extra-styles"}

Label Custom Front-end Edit Links

When using custom links, it may be useful to label these links for the user. One way of accomplishing this is by using the special {if frontedit} conditional

Example:

{if frontedit}Edit Entry Title{/if}{frontedit_link entry_id="{entry_id}" field_name="title"}

Reinitialize ExpressionEngine Pro Javascript

There may be times, such as when using AJAX, that page content is loaded after ExpressionEngine Pro has been initialized on a page. When this happens edit links may not work or even render. To fix this, you need to included EE.pro.refresh(); in your script.

Example usage:

function getData() {
    $.ajax({
        url : 'example.com',
        type: 'GET',
        success : reInitPro
    })
}

function reInitPro(){
    EE.pro.refresh();
}