This picture shows the permission settings after a set of per-group settings have been added. Two new user groups, 'Technical people' and 'Design people', have been added and the administrator of the site wants to give them different polls that better reflect their knowledge.
This table has four new entries. They are explained below.
Allow those in group 'Technical people' to comment on the poll about operating systems.
Group 'Technical people'. This is the group of people in the system that understand technical issues
Component 'Polls::'. This matches anything with the component 'Polls::'
Instance 'What Operating System Should This Site Run On\?::.*'. This is a very specific instance, and will only match to polls that have this question as the title. Note that the '?' in the title has to be escaped, as this is a regular expression.
By looking at the instance schema for the polls it can be seen that an alternative way to express this would have been '.*:3', where '3' in this case is the unique ID of this poll. Using IDs is quicker and ensures uniqueness, but is a lot harder to understand when looking at the permissions system. The choice to use names or IDs is left to the individual site administrator It is also possible to use both title and ID if desired in this case the resultant instance would be 'What Operating System Should This Site Run On\?::3'
Level 'Comment'. This allows access up to the level of commenting. Any attempts to do things beyond this, such as editing or deleting the poll, will be refused
Don't allow anyone else to comment on the poll about operating systems.
Group 'All groups'. This is a special group that includes every user on the site that is a member of a group, and also the unregistered (anonymous) user
Component 'Polls::'. This matches anything with the component 'Polls::'
Instance 'What Operating System Should This Site Run On\?::'. The specific instance for this poll, as has been explained above
Level 'None'. This means that no access at all will be allowed; in the case of the poll this just means that it will not be displayed
Allow those in group 'Design people' to comment on the poll about the site design.
Group 'Design people'. This is the group of people in the system that understand design issues
Component 'Polls::'. This matches anything with the component 'Polls::'
Instance 'Should This Site Be Redesigned\?::.*'. This is a very specific instance, and will only match to polls that have this question as the title. Note that the '?' in the title has to be escaped, as this is a regular expression.
See above for more information on specific instances.
Level 'Comment'. This allows access up to the level of commenting. Any attempts to do things beyond this, such as editing or deleting the poll, will be refused
Don't allow anyone else to comment on the poll about the site design.
Group 'All groups'. This is a special group that includes every user on the site that is a member of a group, and also the unregistered (anonymous) user
Component 'Polls::'. This matches anything with the component 'Polls::'
Instance 'Should This Site Be Redesigned\?::.*'. The specific instance for this poll, as has been explained above
Level 'None'. This means that no access at all will be allowed; in the case of the poll this just means that it will not be displayed
Note that any poll which does not explicitly fit the instance information is treated is ignored by these rules, so with this setup the normal poll will still show up in addition to the specialised polls.