Restrict a portion of content.
Common Attributes:
- id – Identifier for this portion of content.
- unlock_by – Defines how users can get access to this portion of content. Accepts:
expend_points
,points_balance
,achievement
,achievement_type
,all_achievement_type
,rank
Default:expend_points
- granted_roles – Manually grant access to this portion of content to users by role. Accepts any registered role or a comma-separated list of roles
- granted_users – Manually grant access to this portion of content to the users you want. Accepts any user ID or a comma-separated list of user IDs
- message – Text that is shown to users that haven’t unlocked this portion of content.
- guest_message – Text that is shown to non logged in users.
Important: Remember that you need to close the shortcode:
[gamipress_restrict_content]{content}[/gamipress_restrict_content]
Unlock by expending points (unlock_by=”expend_points”)
Setting unlock_by attribute to expend_points will restrict the portion of content through expending points. A button will be displayed in order to let user expend the amount if they want to see this portion of content.
Attributes:
- points – Points amount required to unlock this portion of content.
- points_type – The points amount points type required to unlock this portion of content. Accepts any registered points type slug
Example: [gamipress_restrict_content id="content-123" unlock_by="expend_points" points="100" points_type="credits" message="This content is restricted"]
Content to show to users that got access
[/gamipress_restrict_content]
Unlock by reaching a points balance (unlock_by=”points_balance”)
Setting unlock_by attribute to points_balance will restrict the portion of content requiring to the user reach a specific points balance. At the moment that user reaches the total balance, will be able to see the portion of content.
Important: If user expends or gets deducted points and doesn’t meets the conditions, access will be revoked automatically.
Attributes:
- points – Points amount required to unlock this portion of content.
- points_type – The points amount points type required to unlock this portion of content. Accepts any registered points type slug
Example: [gamipress_restrict_content id="content-123" unlock_by="points_balance" points="100" points_type="credits" message="This content is restricted"]
Content to show to users that got access
[/gamipress_restrict_content]
Unlock by unlocking achievement(s) (unlock_by=”achievement”)
Setting unlock_by attribute to achievement will restrict the portion of content requiring to the user to earn a specific achievement or a group of specific achievements. At the moment that user unlocks all of this achievements, will be able to see the portion of content.
Important: If user lost any of the achievements required (eg, get them revoked or by transfer them) and doesn’t meets the conditions, access will be revoked automatically.
Attributes:
- achievement – A comma-separated list of the achievement(s) required to unlock this portion of content.
Single achievement example: [gamipress_restrict_content id="content-123" unlock_by="achievement" achievement="1" message="This content is restricted"]
Content to show to users that got access
[/gamipress_restrict_content]
Multiple achievement example: [gamipress_restrict_content id="content-123" unlock_by="achievement" achievement="1,2,3" message="This content is restricted"]
Content to show to users that got access
[/gamipress_restrict_content]
Unlock by unlocking any achievements of type (unlock_by=”achievement_type”)
Setting unlock_by attribute to achievement_type will restrict the portion of content requiring to the user to earn a specific amount of achievements of a specific type. At the moment that user unlocks the required amount of this achievements, will be able to see the portion of content.
Important: If user lost any of the achievements required (eg, get them revoked or by transfer them) and doesn’t meets the conditions, access will be revoked automatically.
Attributes:
- achievement_type – The achievement type required to unlock this portion of content.
- achievement_count – Number of achievements required to unlock this portion of content.
Example: [gamipress_restrict_content id="content-123" unlock_by="achievement_type" achievement_type="badge" achievement_count="5" message="This content is restricted"]
Content to show to users that got access
[/gamipress_restrict_content]
Unlock by unlocking all achievements of type (unlock_by=”all_achievement_type”)
Setting unlock_by attribute to all_achievement_type will restrict the portion of content requiring to the user to earn all the achievements of a specific type. At the moment that user unlocks all of this achievements, will be able to see the portion of content.
Important: If user lost any of the achievements required (eg, get them revoked or by transfer them) and doesn’t meets the conditions, access will be revoked automatically.
Attributes:
- achievement_type – The achievement type required to unlock this portion of content.
Example: [gamipress_restrict_content id="content-123" unlock_by="all_achievement_type" achievement_type="badge" message="This content is restricted"]
Content to show to users that got access
[/gamipress_restrict_content]
Unlock by reaching a specific rank(s) (unlock_by=”rank”)
Setting unlock_by attribute to rank will restrict the portion of content requiring to the user to reach a specific rank or a group of specific ranks. At the moment that user reaches all of them, will be able to see the portion of content.
Important: If user gets downgraded to a lower priority rank that required one (eg, get them revoked or by transfer them) and doesn’t meets the conditions, access will be revoked automatically.
Attributes:
- rank – A comma-separated list of the rank(s) required to unlock this portion of content.
Single rank example: [gamipress_restrict_content id="content-123" unlock_by="rank" rank="1" message="This content is restricted"]
Content to show to users that got access
[/gamipress_restrict_content]
Multiples ranks example: [gamipress_restrict_content id="content-123" unlock_by="rank" rank="1,2,3" message="This content is restricted"]
Content to show to users that got access
[/gamipress_restrict_content]