General

  eZ Systems Website
  Developer documentation


  Editor documentation

  Back to the top

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: updated for v1.5
Panel
bgColor#ffffff
titleBGColor#dddddd
titleOverview
Section

Flex Workflow allows you to send Content to be reviewed by other users.

 

Flex Workflow is a functionality which manages the process of reviewing Content and collaborating. You can use it to send Content items to other users for review. They will be notified of your request and will be able to look through your work and either publish or modify it and send for further review.

Note

Flex Workflow is a functionality of eZ Enterprise, but it is also accessible from the Content mode.

Panel
bgColor#FFFFFF
titleBGColor#dddddd
titleIn this topic

Table of Contents
maxLevel3

 

 

 

 

Flex Workflow basics

 

Flex Workflow operates on drafts of Content items.

After creating a new Content item or making changes to it, you do not publish it, but instead send a draft to be reviewed by a different user. This user will then be notified of your request for review and will be able to view your draft. Then they can introduce their own modifications, creating a new draft, or leave your draft as it is. Finally, they can publish the latest draft (yours or their own) or send it on to another reviewer.

 

Sending Content for review

Panel
bgColor#ffffff
titleBGColor#ffffff
titleTo send a Content item for review:

1. Go to the Content mode and either:

  • navigate to the Content item you want to modify and introduce your changes or
  • create a new Content item.

2. Click Send for Review in the Action bar.

3. Choose the reviewer for your draft. Type part of their name and you will see a menu with users whose names match this part. Select one of the reviewers.

4. Optionally, type in a message that will be sent alongside your request for review.

Dialog for selecting a reviewer

5. Click Confirm.

Info
iconfalse

You automatically leave Edit mode and a new draft of the Content item is created. This is equivalent to clicking Save in the Action bar.

Section
Column
width36px

Video icon

Column
Expand
titleSee a video on how to send Content for review

Widget Connector
width640
urlhttps://www.youtube.com/watch?v=gSoFGGzUq9A
height360

Panel
bgColor#ffffff
titleBGColor#ffffff
titleTo send a Landing Page for review:

Status
colourYellow
titlev1.5

1. Go to the Page mode of the Landing Page and switch to Edit mode.

2. Expand the Publish drop-down menu and select Send for Review.

3. Continue as above.

 

Reviewing Content

Notification about requests for review

When you are selected as a reviewer for a Content item, you receive a notification about it by email. The message contains a direct link to the draft.

As a reviewer you also receive notifications in your user profile. When you are logged in, a number appears next to your profile picture (in the top right corner of the screen) which shows how many requests for review you have received.

Request for review notification in profile

Click your profile and choose View notifications. You can see a Notifications window with a list of all requests.

Notifications about requests for reviewNotifications window

 

Additionally, a message bar appears at the bottom of the screen as soon as a request is sent to you. It contains a link to the Content item to review.

Approval Timeline

When you enter the Edit mode of a Content item which has been sent to review, you will see the Approval Timeline at the top of the screen:

Approval Timeline

Approval Timeline

This timeline lists all review requests that have been sent out for this Content item.

Introducing changes

You can modify or publish the draft in the same way you edit a standard Content item. If you want to send it on to another reviewer, the procedure is the same as when sending the initial draft.

 

Tip

It is possible to modify the template of the email which is sent with the notification.

Expand
titleHow to modify the template of the notification email

The template must be defined in the Twig templating language in a file named send_to_review.html.twig and placed in the vendor/ezsystems/flex-workflow/bundle/Resources/views/email folder in your installation.

Read more about overriding templates in Symfony and about Twig.