Path

ezpublish / documentation / ez publish / technical manual / 5.x / features / notifications / granting access to notifica...


Caution: This documentation is for eZ Publish legacy, from version 3.x to 6.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 on 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.

    Editors User Group

    Editors User Group

     
    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.

    Roles and Policies

    Roles and Policies

  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.
    Notification Role

    Notification Role

  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.
     
    New Role Interface

    New Role Interface

  7. Click "Save" to save your changes and go back the role view interface.

    New Policy Saved

    New Policy Saved

     
    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 and click on the "OK" button.
     
    Granting Access to User Group

    Granting Access to User Group

  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).
    List of Role Users

    List of Role Users

     

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)

Andrea Melo (16/11/2012 10:18 am)

Geir Arne Waaler, Andrea Melo


Comments

  • notification/use versus content/view

    Hi

    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 ?

    *-pike