JExtBOX Login to Read More Documentation

This plugin hides a main part of contents and displays a custom notification such as a login form, a captcha and the other, when not logged in users visit Joomla articles or K2 items.

Author
Galaa
Home Page
Extension Home Page
JED Page
Page on The JED
Live Demo
demo.jextbox.com
Compatibility
Joomla 3.x
Extension
plugin
Version
3.20.0 on 8 Nov 2018

This plugin hides a main part of contents and displays a custom notification such as a login form, a captcha and the other, when not logged in users visit Joomla articles or K2 items. Also it has an integrated log-in module. The integrated log-in module redirects to current article or K2 item after successful log-in.

  1. Supported CCK: Content (com_content) J3.8 or newer, K2 (com_k2) version 2.8 or newer.
  2. White-list and Black-list of Categories and articles or items
  3. Additional Filters: Date (Published Up, Created, Modified), Featured Status, Content Tags, Custom Fields, K2 Extra Fields.
  4. Login options: Integrated Login Module, Joomla default log-in, Text message only, Custom URL with title, Load module by module name or module position with or without additional text message. Also reCaptcha.
  5. Article Visibility: Intro text only, Limited text /HTML tags, paragraphs, words, characters/ and Nothing.
  6. Source of Limited text: Intro text or Whole content.
  7. Type of Limited text: Number of HTML tags, Paragraphs, Words and Characters.
  8. Log-in Message and Title.
  9. Overrides read-more link.
  10. Hides K2 attachments.
  11. Search Engine Bots: Specify which search engine bot is allowed to crawle a full article or item.
  12. Meta-tag for Search Engine /SEO/: no-archive and no-index.
  13. Removes empty <p> tags, for example it removes an empty paragraph, that was added to content when the read-more separator was inserted by using a content editor.
  14. Skip count: The maximum number of articles (requests) will be allowed to full access.
  15. Multilingual ready.

Version 3.20.0. Thu Nov 8 2018

  1. The issue for reCaptcha of Joomla 3.9.0 was solved.
  2. Descirption and the language file were updated.
  3. The configuration form is improved.

Version 3.19.0. Fri Jan 5 2018

  1. Maintenance for K2 2.8.0 and Joomla 3.8.0.

Version 3.18.0. Mon May 1 2017

  1. Date filter was added.

Version 3.17.0. Mon Mar 27 2017

  1. Joomla Updater has been supported.

Version 3.16.0. Mon Mar 20 2017

  1. Custom fields (new feature of Joomla 3.7) have been supported.

Version 3.15.0. Tue Jan 17 2017

  1. New parameter "Hide attachments" has been added for K2 attachments.

Version 3.14.0. Sat May 21 2016

  1. New option "HTML tags" has been added for Limited text.

Version 3.13.0. Tue Apr 5 2016

  1. Concept for exclusion has been changed.

Version 3.12.0. Sun Mar 11 2016

  1. New parameter "Skip Count" has been added.
  2. Algorithm for hash has been changed.

Version 3.11.0. Sun Mar 11 2016

  1. New option "reCaptcha" has been added.
  2. Auto enabling during instatllation.

Version 3.10.0. Fri Mar 4 2016

  1. New option, that helps to hide login message in non article view mode /category or featured etc./, has been added.

Version 3.9.1. Mon Sep 28 2015

  1. Logical operator "or" was replaced by "||" for PHP bug.

Version 3.9.0. Fri May 22 2015

  1. New option "Override Read-More" has been added. A bug on "override" for K2 has been fixed.
  2. Some lines of code have been chenged to prevent possible PHP notice.

Version 3.8.0. 2015-04-21

  1. Bug fix
  2. Clean code
  3. Additional filters
  4. Joomla 2.5 hasn't been supported.

Version 3.7.1. 2015-04-21

  1. Bug fix

Version 3.7.0. 2015-03-28

  1. Integrated Login Module
  2. Major bug at K2 functinality has been fixed.

Version 3.6.0. 2015-02-21

  1. Mixed mode for Categories or Articles.

Version 3.5.0. 2014-12-26

  1. Plugin configuration fields have been improved: filter, url, module name and position name.

Version 3.4.0. 2014-12-24

  1. New options (module with login message) have been added by customer request.

Version 3.3.0. 2014-06-01

  1. All PHP notices, related to fulltext etc., has been solved.
  2. K2 installation check has been modified and Joomla warning has been solved.

Version 3.2.0. 2014-04-25

  1. K2 is fully supported now.
  2. Some major functions have been improved.
  3. New parameters (mode, remove empty paragraphs) have been added.

Version 3.1.0. 2013-11-29

  1. Major bug at K2 functinality has been fixed.
  2. K2 support has been improved.
  3. Limit parameter has been added for intro text.
  4. Name changed to "JExtBOX Login to Read More".

Version 3.0.0. 2013-10-01

  1. K2 supported.

Version 2.0.1

  1. Minor bug at default value of Login option has been fixed.
  2. Major bug at fulltext detection for Joomla 3 version has been fixed.

Version 2.0.0

  1. Additional login options.
  2. Visibility of article text.
  3. Search Engine Metatag.

Version 1.2.1

  1. Bug fix - bot detection.

Version 1.2.0

  1. Compatible with Joomla 2.5 and 3.0.
  2. Code optimization.
  3. Bug fix.

Version 1.1.2:

  1. Bug fix - Excluded or include articles option.

Version 1.1.1:

  1. Bug fix - Excluded categories list.

Version 1.1:

  1. Selection of usage type of Categories and Articles list: include or exclude.

Version 1.0:

  1. Initial version.

We recommend you to set the order of this plugin as 1'st in content type. Because the plugin changes text of an article when it is preparing.

It has two parameters: "Search Engine Bots" and "SEO meta-tag".

For "Search Engine Bots" you can enter search engines manually by bot name. If you leave it empty, the plugin loads the default search engine list (initial value). These search engines can crawle your web sites content. If you want to stop crawling, set the parameter "SEO Metatag" as "No-index". We are recommend to you the option "No-archive". Because if you select "No-archive", search engines crawle your site content but don't show any content such as cache on their search results.

The latest version of the plugin was developed and tested on core "Content" component and most popular content construction kit "K2" v2.6.9.

It's about the option "Both" of parameter "Article Selection". In general, "Article Options" override "Category Options". See below.

Category OptionsArticle OptionsResult: "Login Message"
includeincludeshow
excludeincludeshow
excludeexcludehide
includeexcludehide

For example, let an article has id 24 is included in the category Joomla and "Categories"="Joomla", "Selection"="Exclude", "Articles"="24", "Selection"="Include". In this case, the login message is displayed.

These filters are used to make more complex selection of articles or K2 items from specific (given by main filter) categories and articles. Compatibility of available filters is determined by the following table.

FiltersContent *K2
Featured Status
Content Tags
Custom Field
K2 Extra Fields

* - core component "com_content" of Joomla! CMS.

The input format of the custom field is {"id":"ID","value":"VALUE","rawvalue":"RAWVALUE"}. For example, {"id":"15","value":"Yes","rawvalue":"1"}. You have to enter at least one of value and rawvalue.

The input format of the extra field is {"id":"EXTRA_FIELD_ID","value":["VALUE_ID","VALUE_TEXT"]}.
For example, for drop-down selections, multi-select lists and radio buttons {"id":"15","value":["2","Yes"]}, for text fields and text-areas {"id":"16","value":["Premium","Premium"]}. As well as the value of drop-down selections, multi-select lists and radio buttons consists of internal id and value. But a value of text fields and text-areas consists of text value only (in this case, internal id of the value is NULL).
The internal id of the value is unseen in the debug message for item view mode. So you need to see (in debug message) the id (internal id of the value) open your K2 item in list view mode (categories, latest items, tag or user page /blog/). Another way to see it, is to access database table "#__k2_extra_fields".

  1. Integrated Login Module
    Visitors redirect back to current article or item after successful login.
  2. Joomla! Default Login
    Link to core login page.
  3. Text message only
    Text message below content.
  4. Custom Login URL
    Link to your custom login /or registration, subscription etc./ page.
  5. Load Module
    Loads your favorite module by its name.
  6. Load Module with Login Message
    "Text message only"+"Load Module"
  7. Load Module Position
    Loads your favorite module(s) by its position name.
  8. Load Module Position with Login Message
    "Text message only"+"Load Position Position"
  9. reCaptcha
    Loads core plugin reCaptcha.

Relation between the Login option and other parameters is given by the following table.

Option 1 2 3 4 5 6 7 8 9
Encrypt Login Form
Users Link
Show in Popup Window
Custom Login URL
Module Name
Module Position
Login Title
Login Message
  • Intro text only
    Text which is placed above the separator "Read More". In this case, you have to insert the separator in your article. The button for inserting the separator can be found in the toolbar (default editor TinyMCE) or below of the editor.
  • Limited text
    Some parts (HTML tags, paragraphs, words, characters) of an article. If you don't want to use the separator "Read More" anymore or never used in your web site, we recommend to you this option.
    Attention: HTML tags and format are stripped, when the options "words" or "characters" are chosen.
  • Hide text
    Entire text of an article isn't displayed.

Skip count
The maximum number of articles (requests) will be allowed to full access. Insert 0 to disable it. Do not set it too high.

Access Level
This plugin doesn't override access level. Instead of access level, you have to use other things: article ID, category, featured status, tags, K2 extra fields etc. The access level is very restrictive to incoming guests, readers, subscribers and also search engine bots. So we suggest this plugin to Joomla developers. In this case, you need to set the access level of an article as "Public". In other words, you don't need to change it. Because "Public" is default value of this field.

  • Q The extension is not doing the expected.
    A Did you enable the plugin or set the plugin ordering properly?
  • Q How do I enable the plugin?
    A First open an page Configure Extension. Then click the tab "Plugin" and read instruction.
  • Q How to check and set Ordering?
    A Check: 1. Open Plugin Manager 2. Set filter as content /from -Select Type-/ 3. Now you can see Ordering. Set Ordering: 4. Click Ordering button /up down arrows/ 5. Drag your plugins.
  • Q What about core options such as Status, Access, Ordering?
    A These parameters very important. You have to set to Status=Enabled, Access=Public, Ordering="Read related FAQ item".
  • Q After creating a category that requires login, the plugin doesn't show the login form when someone click that article.
    A Check following: 1. Mode=Categories 2. Categories="your categories" 3. Categories type=Include
  • Q Is there a way to have the visitor returned to the same page after Login?
    A You can use our "Integrated Login Module" to do this. In other case such as "Load Module", it depends your login module. For example, this is possible for core log-in module of Joomla. Just you need following options: 1. Login=Load Module 2. Module name="select name of the default login module /default name is Login/"
  • Q Would Google scan the entire article?
    A Yes. A bot, registered to Search Engine Bots list, can crawl an article which is controlled by this extension.
  • Q Is it supported K2?
    A Yes. We have tested our extension with newer version of K2.
  • Q Is it supported any other CCK?
    A Not yet. But maybe in next release.
  • Q I can't see reCaptcha.
    A Did you enable and configure core plugin reChaptcha?