JExtBOX Login to Read More

Version 3.24.0. Sun Oct 29, 2023

1. Joomla 5 compatibility with the B/C plugin
2. Used session instead of cookie to store authorization data.

Version 3.23.0. Fri Feb 11, 2022

1. Added the new feature that controls article visibility based on a percentage calculation of content size.

Version 3.22.3. Mon Nov 23, 2021

1. Integrated cache control

Version 3.22.2. Mon Oct 18, 2021

1. Patches for the new update server.
2. A minor bug that the close button in the JS popup window is hidden on hover has been fixed.
3. A bug that is the CSS popup window is not centered horizontally has been fixed.

Version 3.22.1. Sun Aug 8, 2021

1. Minor patches for Joomla 4.
2. The logical error of the category and ID-based filter was solved. And its user interface was improved.
3. The HTML structure of the integrated login module was changed for Joomla 4 compatibility.
4. The list of modules includes names and positions of only published and front-end modules.
5. The module position field type was changed to 'sql' due to the Joomla 4 compatibility.
6. The code in the file 'K2/base.php' was edited due to the compatibility of PHP.

Version 3.22.0. Sat Jun 6, 2020

1. The new feature Logout link was added.
2. Solved HTML ID duplications between the integrated login module and the Joomla login module.
3. Modified several parameters' default values.

Version 3.21.0. Fri Dec 14, 2018

1. Supported the module "K2 Content".
2. Updated functions for K2.

Version 3.20.0. Thu Nov 8, 2018

1. The issue for reCaptcha of Joomla 3.9.0 was solved.
2. The description 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 (a new feature of Joomla 3.7) have been supported.

Version 3.15.0. Tue Jan 17, 2017

1. The new parameter "Hide attachments" has been added for K2 attachments.

Version 3.14.0. Sat May 21, 2016

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

Version 3.13.0. Tue Apr 5, 2016

1. The concept of exclusion has been changed.

Version 3.12.0. Sun Mar 11, 2016

1. The new parameter "Skip Count" has been added.
2. The algorithm for hash has been changed.

Version 3.11.0. Sun Mar 11, 2016

1. The new option "reCaptcha" has been added.
2. Auto enabling during installation.

Version 3.10.0. Fri Mar 4, 2016

1. Added a new option that helps hide login messages in non-article view mode /category or featured etc./.

Version 3.9.1. Mon Sep 28, 2015

1. The logical operator "or" was replaced by "||" for the PHP bug.

Version 3.9.0. Fri May 22, 2015

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

Version 3.8.0. 2015-04-21

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

Version 3.7.1. 2015-04-21

1. Bugfix

Version 3.7.0. 2015-03-28

1. Integrated Login Module
2. Fixed a bug in K2 functionality.

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 error notices related to full text, etc., have been solved.
2. The K2 installation check has been modified, and the Joomla warning has been removed.

Version 3.2.0. 2014-04-25

1. K2 is fully supported now.
2. Improved several core functions.
3. Added new parameters (mode, remove empty paragraphs).

Version 3.1.0. 2013-11-29

1. The major bug in K2 functionality has been fixed.
2. K2 support has been improved.
3. The limit parameter has been added for the intro text.
4. The name changed to JExtBOX Login to Read More.

Version 3.0.0. 2013-10-01

1. K2 supported.

Version 2.0.1

1. The minor bug at the default value of the Login option has been fixed.
2. The major bug in full-text detection for the 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. Bugfix - bot detection.

Version 1.2.0

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

Version 1.1.2:

1. Bugfix - Excluded or included articles option.

Version 1.1.1:

1. Bugfix - 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.

General Instruction

We recommend you set the order of this plugin as 1st in the content type. Because the plugin changes the text of an article when it is preparing for front-end display.

Search Engine Optimization

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

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

Supported Components

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

Mixing Categories and Articles Lists

It's about the following plugin parameters: "The Primary Selection of Content" and "The Additional Filters of Content". In general, "Article Selection" overrides "Category Selection". See below.

For example, let the ID of an article is 24, it is included in the category "Uncategorized" and the category selection type is "Exclude", the article ID is included in the "Articles" list, the article selection type is "Include". In this case, the login message is displayed.

Additional Filters

These filters are used to make a more complex selection from articles or K2 items which are selected by the primary selection. The compatibility of available filters is described in the following table.

* - 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 pair of values and raw values.

To configure the custom field and the extra field parameters of this plugin can be activated in debug mode. In the debug mode, you can see custom or extra fields of an article or a K2 item.

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, 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 consist of internal ID and value. But a value of text fields and text areas consists of text value only (in this case, the 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 the 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/). The other way to see it, is to access database table "#__k2_extra_fields".

Login Options

1. Integrated Login Module
   Visitors redirect back to the current article or item after successful login.
2. Joomla! Default Login
   Link to the 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
   Load 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.

The relation between Login options and other parameters is illustrated in the following table. The login options are numbered as the above list.

Article Visibility Options

• Intro text only
  Text which is placed above the separator "Read More". In this case, you have to insert the separator in your article manually. The button for inserting the separator can be found on the toolbar of the default editor TinyMCE.
• 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 it on your website, we recommend this option.
  Attention: HTML tags and format are stripped when the options "words" or "characters" are chosen.
• Hide text
  The entire text of an article isn't displayed.

Other Settings

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

Access Level
This plugin doesn't override the 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 search engine bots. So we suggest this plugin to Joomla users. 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 the default value of the access level.

K2 Content Module Support

To use this plugin for items that are displayed by the "K2 Content" module, you need to enable the modules option "Enable Joomla content plugins".

Cache-Control

The extension has its own plugin which controls the Joomla cache for com_content and com_k2 components. The plugin temporarily disables the cache when a user browses an article or a list of articles. Thus this extension always can hide the main part of articles from unauthorized users.

Finally, don't disable the cache controller plugin which is called "System - JExtBOX Login to Read More" when you use the extension.

Frequently Asked Questions

• Q. The extension is not doing the expected.
  A. Did you enable the plugin or set the plugin order properly?
• Q. How do I enable the plugin?
  A. First open the page "Plugins". Then click the "Enable Plugin" button in the "Status" row.
• Q. How to check and set Ordering?
  A. 1. Open the "Plugin" page 2. Set the corresponding filter as content 3. Click the Ordering button /up-down arrows/ 4. Set order by using dragging.
• Q. What about core options such as Status, Access, and Ordering?
  A. These parameters are very important for working properly. You have to set Status = Enabled, Access = Public, and Ordering = "Read related FAQ item".
• Q. After creating a new category that requires login, the plugin doesn't show the login form when someone clicks that article.
  A. Maybe you need to configure the plugin again.
• 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 it. In another case such as "Load Module", it depends on your login module. For example, this is possible for the core log-in module of Joomla. Just you need the 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 that is registered to the "Search Engine Bots" list, can crawl an article is controlled by this extension.
• Q. Does it support K2?
  A. Yes. We have tested our extension with a newer version of K2.
• Q. Does it support other CCK except K2?
  A. Not yet. But maybe in the next release.
• Q. I can't see reCaptcha.
  A. Did you enable and configure the core plugin reChaptcha?
• Q. How can I update to the latest version by using Joomla Updater?
  A. You should enter your payment or invoice ID into the plugins configuration. Then if a newer version is released, you will see a notification message about it on the dashboard or update center of your website.

Reason*

Report a bug

Suggest a new feature

Your email address*

Message*

JExtBOX Login to Read More is the Joomla extension.
Copyright (©) 2011 - 2023 Galaa

JExtBOX Login to Read More is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

JExtBOX Login to Read More is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see www.gnu.org/licenses.