Software

Edit This

Current Version: 3.0.0
  • Installation for EE 3.x

    1. Unzip the folder to a temporary location on your local hard drive.
    2. FTP the files from their local folders to the same locations in your EE install’s /system/user/addons/ folder on the server.
    3. Navigate to Add-ons in your EE control panel and install the add-on. That’s it!

  • Installation for EE 2.x

    1. Unzip the main file to a temporary location on your local hard drive.
    2. FTP the files from their local folders to the same locations in your EE install’s /system/expressionengine/third_party folder on the server.
    3. FTP the themes/edit_this/ directory to the /themes/third_party/ directory in your EE install: /themes/third_party/edit_this/

  • Installation for EE 1.x

    The Edit This zip file contains an earlier version of EditThis for people still using EE 1.x.

    1. Unzip the folder to a temporary location on your local hard drive.
    2. Unzip the EditThis 1.1.1.zip file.
    3. Open the EditThis 1.1.1 directory. FTP the pi.edit_this.php file to your EE install’s /system/plugins/ folder on the server.
    4. FTP the /edit_this_themes/ directory to the /themes/ directory in your EE 1.x install.

  • Usage

    This plugin will put small pencil icons in the live site, but only for users who are:

    • logged in
    • have an administrative session
    • and have permission to edit that particular resource.

    All parameters are required, except “icon.”

    The simplest usage is simply this tag without any enclosed text. Try placing this tag inside an exp:channel:entries tag:

    {exp:edit_this:entry entry_id="{entry_id}" channel_id="{channel_id}" author_id="{author_id}"}

    * Using weblog_id for channel_id will also work.

    That tag will return an image and link that looks like this:

    <a href="URL_TO_CP" title="Edit this" target="_blank"><img src="/themes/third_party/edit_this/images/default_icon.gif"
     height="14" width="14" class="edit_this" style="padding-left: 4px" alt="Edit this" align="top" border="0" /></a>

    You can then over-ride styles on the image using the .edit_this class.  Here are all the possible uses

    Entries:

    {exp:edit_this:entry entry_id="{entry_id}" channel_id="{channel_id}" author_id="{author_id}"}

    * Using weblog_id for channel_id will also work.

    Templates:

    {exp:edit_this:template template_id="42" template_group="2"}

    (There’s no way to dynamically insert the template_id or template_group from EE itself, sadly, so you will need to hard code it or fetch it some creative way such as with PHP.)

    Categories:

    {exp:edit_this:category category_id="{category_id}" category_group="{category_group}"}

    Gallery Images (1.x only):

    {exp:edit_this:image entry_id="{entry_id}"}

    If you wish to use a different icon image, several different colors are provided (in the /themes/edit_this_themes/images directory). You can even put your own image there, as long as the filename ends in “_icon.gif”. Call alternate icons like so:

    {exp:edit_this:template template_id="42" template_group="2" icon="blue"}

    Advanced Use:

    You can use the same tag, but enclose some text within it. The plugin will do the permission check, but leave the presentation of the link to you. This allows you to change the display to whatever you’d like, and you could have entire instructions or alternate content displayed by this plugin.

    For example, you can point to a front-end editing template (stand alone editing form) using this option.  Or you could make the link be straight text, not an image.

    {exp:edit_this:entry entry_id="{entry_id}" channel_id="{channel_id}" author_id="{author_id}"}
    <a href="{edit_this_url}">I can edit this</a>
    {/exp:edit_this:entry}
    {exp:edit_this:template template_id="42" template_group="2"}
    <a href="{edit_this_url}">I can edit this</a>
    {/exp:edit_this:template}
    {exp:edit_this:category category_id="{category_id}" category_group="{category_group}"}
    <a href="{edit_this_url}">I can edit this</a>
    {/exp:edit_this:category}
    {exp:edit_this:image entry_id="{entry_id}"}
    <a href="{edit_this_url}">I can edit this</a>
    {/exp:edit_this:image}

    Image editing only applies to images in the gallery module.

    Also, please note, you may need to set a cookie domain, or turn on cookies in the control panel, for edit_this to work.

  • Permissions Required

    • For entries, users must be authorized to edit entries in the specific channel they must have control panel access and they must have access to the edit tab.
    • For templates, users must be authorized to edit templates in the specific template group they must have control panel access and they must be authorized to administer templates.
    • For categories, users must have control panel access they must be authorized to access the admin tab and they must be authorized to administer channels.
    • For gallery entries, users must have access to the gallery module they must have control panel access and they must have access to the Modules tab.
    • For all types of content, users must have an authenticated administrative session.

  • Updating

    Updating is easy:

    1. Download a new version from this website, and extract on your hard drive.
    2. Upload the new files to their appropriate locations.

  • Uninstalling

    1. Navigate to the Add-Ons/Modules tab in your EE control panel and uninstall the module.
    2. Remove the add-on directory from your EE system folder on the server.

    Also:

    1. Remove the pi.edit_this.php file from your site’s plugins directory.
    2. Remove the edit_this_themes directory from your site’s /themes/ directory.

  • Version History

    3.0.0
    Updated for EE 3
    2.4
    Fixed issue with EE 2.9
    2.3
    Generates new control panel URLs for EE 2.8, and yet is also backwards compatible with EE 2.7 and lower.
    2.2
    Correctly deals with fingerprints instead of session IDs
    2.1
    Added an "edit_this" class to the icon for easier styling
    2.0.1
    Switched to using the third_party themes directory
    2.0.0
    Initial release for EE 2.x
    1.1.1
    Fixed a bug causing newlines and blank pages
    1.1.0
    Substantially modified/improved authz caching added support for session IDs modified tags to require more (and different) parameters.
    1.0.1
    Added session caching on security queries, and colored icons!
    1.0.0
    Initial Release

Have a Project for Us?

Get in Touch