Easy Content Restriction - Joomla! Plugin - Logo


Name: Easy Content Restriction - Version: 3.4.3 / 3.5.2-PRO - Type: Plugin - License: GPLv3
Description: Protects content in articles with a special syntax from specified user groups or a password

Overview of all downloads of the extension: ECR - Easy Content Restriction Downloads

If you use ECR - Easy Content Restriction, please post a rating and a review at the Joomla! Extensions Directory.

Protects content in articles with a password or only displays it to approved user groups

Plugin: ECR - Easy Content Restriction
Function: With this plugin you can protect your content easily from being loaded by unauthorized users
Languages: English and German
Joomla! versions: 3.x

With this plugin you can hide text in your articles with a password or from specified user groups with a simple syntax call directly in the articles. Special features are the unusual syntax use (square brackets) and the Safe Mode to avoid hidden text to be showed in other components (e.g. search component). Because the typical plugin syntax is removed in calls from the outside, the plugin does not use curly brackets. In the Safe Mode the whole article is replaced with an empty string if ECR detects a call from outside the content component of an article which uses the plugin.


  • Protects content in articles
  • Password Mode - Protect your content with a password! No user account required to load the content - just the correct password
  • Easy syntax to call the plugin: [ecr]YOUR TEXT[/ecr]
  • Safe Mode: Content protection not only in the article view
  • Specify the allowed or disallowed user groups
  • Specify allowed users using their IDs
  • Set an individual replacement text
  • Languages: English and German


Install the plugin in the backend, then adjust and publish it in Extensions - Plugins - Content - ECR - Easy Content Restriction.

How to use

Password Mode

In this mode you can protect the content with a password, no user account is required to load the content - just the correct password.

[ecr|password=XXX]Hidden text[/ecr]

Replace XXX with a self-defined password, e.g. asdf?!*#123

Easy Content Restriction - Password Mode

If you want to modifiy the output of the form, then copy the file password.php from

plugins/content/easycontentrestriction/tmpl to templates/YOUR-TEMPLATE/html/plg_content_easycontentrestriction

and edit this file. Thus, your changes are not overwritten if you update the plugin!

Standard Mode

In the standard mode only global parameters from the settings are used in the execution of the plugin.

[ecr]Hidden text[/ecr]

Override Mode

IDs for groups which are allowed to access the hidden text

[ecr=8,5,3]Hidden text[/ecr]

You can also toggle the permission rights! IDs for user groups which are not allowed to access the hidden text

[ecr=8,5,3|toggle]Hidden text[/ecr]

The replacement text for groups with no permission can also be set individually

[ecr|You have to login to see the text!]Hidden text[/ecr]

Of course you can use all parameters together at once

[ecr=8,5,3|toggle|You have to login to see the text!]Hidden text[/ecr]


+ = Added - ! = Removed - ^ = Changed - # = Fixed

Joomla! 3.x

Version 3.5.2-PRO - 2019-09-22

  • + New option: Allowed Groups - Password Mode - User groups that are allowed to access the hidden text without a password if the Password Mode is used. Thanks for the request to Meschkam!

Version 3.5.1-PRO - 2019-08-16

  • + Multilingual Replacement Text - You may use a language override constant to allow a multilingual output in the option "Replacement Text"! Enter a self-defined constant into the option field in the settings of the plugin and then create your translations for this constant in Joomla!'s Language Manager. Thanks to Stefan O. B. for this suggestion!

Version 3.4.3 - 2019-06-23

  • + Custom Field - Pro Button
  • ^ Updated project page URL

Version 3.5.0-PRO - 2019-04-28

  • + First Pro release based on ECR version 3.4.2

Version 3.4.2 - 2018-07-26

  • ^ Changed replacement function to improve performance and avoid limit error "regular expression is too large at offset x" if the article text is too long - Thanks to Kirstin G. for reporting it!
  • ^ Updated Custom Field
  • ^ Code Style Optimization

Version 3.4.1 - 2017-08-14

  • ^ Updated custom field krtitle to 3.3.0
  • # User group ID was not handled properly which could lead to a wrong behavior under certain circumstances (if access right was set to guest or public in the global settings) - Thanks to Laurents M. for reporting it!

Version 3.4.0 - 2016-08-21

  • + Notification Message - If the password is incorrect, then a notice message is displayed to inform the user.

Version 3.3.0 - 2016-07-22

  • + Password Mode - Protects the content with a password! No user account required to load the content - just the correct password.
  • ^ Code optimizations
  • ^ Custom Field

Version 3.2.0 - 2015-07-31

  • + Donation Code Validation Process - Improved the validation process with a new server (HTTPS request) plus an independent, separated fallback server (HTTP request).
  • + New Download Server - Download packages are located independently of the project website on a new download server.
  • https://downloads.kubik-rubik.de/

    Version 3.1.0 - 2015-06-30

    • + Project page - Added project page on the official website for this extension
    • + Update Server - Added the Joomla! core functionality for the update checks
    • + Some code optimizations
    • ^ Semantic versioning - Switched to semantic versioning, see http://semver.org/ for more details. Please update manually since the core update server functionality will not recognize the new version!
    • ^ Updated Donation Code field - Uses the HTTP API for the requests and calls the check script via HTTPS
    • ^ Links in the language files - Updated outdated links to the JED (Joomla! Extensions Directory)
    • ! Removed Version Check field

    Version 3-2 - 2014-07-03

    • + Special treatment of @ character - the @ character can be used in the hidden text

    Version 3-1 - 2013-12-14

    • + First free, public version for Joomla! 3.x

    Joomla! 2.5

    Version 2.5-2 - 2014-07-03

    • + Special treatment of @ character - the @ character can be used in the hidden text

    Version 2.5-1 - 2013-12-14

    • + First free, public version for Joomla! 2.5

    Version 2.5-1 DEV-2013-10-04

    • + Toggle selection - with the toggle function you may toggle the ID selection. It means that the selected groups are not allowed to see the hidden text. This is for example very useful if you want to show a advertising banner or some extra information for visitors who are not in a specified user group (e.g. VIP users). Please read the description in the plugin how to use the toggle as a parameter in the syntax call!
    • ^ Optimized the user group determination - removed the loading of inherited groups
    • ^ Updated version check, donation code and krtitle fields

    Version 2.5-1 DEV-2013-06-07

    • + This is the first public test release. The language files are incomplete, also the description is very minimal but the functionality is fully implemented. Check the short description to see how to use the plugin. In fact, it is very simple: enter the described syntax in your articles to hide text from unauthorized groups. The plugin uses the unusual syntax with square brackets, not curly brackets, due to security reasons. Extensions, like the search component, remove plugin calls before they call the trigger. If the syntax is removed, the plugin can not be executed and the hidden text could become visible. Square brackets are not recognized as the typical plugin syntax and the plugin also works in these cases. The replacement text can be entered in the settings or via the override feature in the syntax. You may use HTML tags (e.g. to set a link to the registration page etc.). There is also a safe mode which completely hides the text when the article is not called from the content component (e.g. search component or modules). Use the options of the plugin to set global settings and the override functionality to set local settings. Additionally you may allow access to the hidden text passages to certain users by adding their user IDs into the settings. Enter the IDs separated by commas. Please report any bugs or send me your feature request via the contact form!


    Overview of all downloads of the extension: ECR - Easy Content Restriction Downloads