Path / documentation / ez publish / technical manual / 4.6 / features / notifications / granting access to notifica...

Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

Granting access to notifications

The built-in permission system controls whether users are allowed to use notifications or not. The following text explains how you can check and assign the necessary permissions.

Checking the access rights

The following text explains how you can view a user or a user group and check if the user or the group is allowed to access the "notification" module.

  1. Log in to the administration interface and click the "User accounts" tab. You should see your users and groups on the left.
  2. Select the target user/group using the tree or the "Sub items" window.

    The screenshot above shows a situation when the "Editors" user group is selected. You can bring up a list of roles and policies assigned to this group by enabling the "Roles" and "Policies" windows using the menu at the top.

  3. Look at the "Module" column in the table of policies. As long as the "notification" module is not listed here, the selected user/group is not allowed to use notifications. Please refer to the next sections for information about how you can create a new role (that grants access to the module) and assign it to a user/group.

Creating a new role

The following text reveals how you can create a new role for granting access to notifications.

  1. Click the "User accounts" tab in the administration interface and then access the "Roles and policies" link on the left. You should see the list of existing roles as shown in the screenshot below.

  2.  Let's create a new role called for example "My notification role". Click the "New role" button under the list of roles. You will be taken to the role edit interface as shown in the following screenshot.
  3.  Specify the name of the role and click the "New policy" button.
  4.  The wizard will help you to create a new policy.

    Select the "notification" module from the "Module" drop-down list. Choose the "use" function from the "Function" drop-down list. Please note that you shouldn't choose the "administrate" function because it grants access to the "runfilter" view of the "notification" module.
  5. Click the "Grant full access" button. (There is no point clicking the "Grant limited access" button because the functions of the "notification" module do not support limitations.)
  6. The new policy will appear in the role edit interface as shown in the following screenshot.
  7. Click "Save" to save your changes and go back the role view interface.

    The new policy will appear in the role view interface as shown in the screenshot above. You can now assign this role to any user or group (this is explained in the next section).

Assigning a role to a user and/or a user group

A role can be viewed by clicking on its name in the list of existing roles in the role interface (select "Roles and policies" from within the "User accounts" to bring up the role interface).

When you're looking at a role, there should be a list of users/groups towards the bottom of the page. This list reveals the users and groups that the role which is being viewed has been assigned to. The following text explains how to use this list in order to assign the role that is currently being viewed to the "Editors" user group.

  1.  Click the "Assign" button located under the list of users in the role view interface.
  2.  Select the "Editors" user group as shown in the following screenshot and click the "OK" button.
  3. The "Editors" user group will appear in the list of users. The screenshot below shows the role view interface for "My notification role" that is assigned to the "Editors" user group (this means that all users that belong to this group are allowed to use notifications).

Please note that you can assign the role to a single user in the same way as to a user group.

Svitlana Shatokhina (14/09/2010 11:50 am)

Geir Arne Waaler (29/09/2010 6:53 am)


  • notification/use versus content/view


    Could someone clarify, if, when you have the right to 'use notifications', you have the right to get notifications of nodes for which you don't have content/view rights ?.
    Or if not, can you describe here how that is handled if people receive digest notifications ?