Item - Edit using template portlet


Jump to: navigation, search
Item - Edit using template portlet
module: Content module
supplier: VYRE Ltd.

The Item - Edit using template portlet is used to edit items in the same way the Item edit portlet but using somewhat different methods. While the Item edit portlet is still good for making simple edit forms, the edit using template portlet gives you much more flexibility in both form layout and functionality.

The main functionality of this type of portlet will be controlled by the chosen content template so read up on those to learn how to create dynamic item editing forms using the portlet.

If the item you are editing is checked out, the portlet will load checked out version data. Otherwise, it will load active item data.



The portlet edit screen is split into four tabs:

  • Content store - where you can choose what type of items to edit and how
  • Redirect settings - where you can control the portlets behaviour after saving
  • Message settings - where you can set up automated messaging module for editing events
  • Cache settings - where you can set certain pages to cache flush after editing items

Content store

Edit mode allows you to control whether or not users can edit existing items or create new ones. Using this option you have full control over what options users have in either case and can be sure your users do not mistakingly edit an item using a form intended only to create new ones or vice versa.

The two dropdown boxes allow you to choose what store this portlet can edit items from, and the Content template used to edit them. Both these options use shortcut functionality.

Redirect settings

Redirect settings

You can instruct the portlet to redirect the user to a different page after creating, editing or deleting an item. The first checkbox controls weather or not to redirect after the specific action and the Find page button allows you to choose a page to redirect to. Simply click on the page you want in the tree and close the popup window.

Ticking Redirect to referer makes the portlet ignore the chosen page and always redirect back to the page the user arrived from. Send item will make the portlet assume the page you are redirecting to is a item display page and use that to display the same item. This feature is useful to make wizards or chains of edit forms.

Since Unify 4.6.3 there is the option to specify redirect by path. Tick the checkbox provided and use the text input to write the page path you want the portlet to redirect to.

Message settings

Message settings are similar to redirect settings in that you can choose to send or not send messages after creating, editing or deleting items. You will be able to choose from a dropdown of item related message templates and the template will be filled in with information from the relevant item.

Cache settings

The cache setting panel is to allow you to ensure changes to items are delivered to the pages they are published on as soon as possible. Without setting any cache flushing your changes made to items or new items will not appear on cached pages until their cache expires.

For example if you are setting up an portlet that creates new news items you would set it to flush your main news headline list page by putting that pages ID into the ID input and choosing page in the Type dropdown.

The Attribute option allows you to dynamically flush the relevant page based on a attribute value in the item being edited.

Personal tools