Updates: Release Youtube Feed Pro v5.8.7 🥳
Use coupon code EASTER24 at checkout and start saving today!

JLex Comment Documentation

Content:

Installation

1. Requirements

  • Joomla version: 3 OR 4
  • PHP:
    • PHP Extensions: ZIP Library
    • PHP Extensions: GD Library
    • PHP: [magic_quotes_gpc = Off]

2. Download & Install

Apply for new installations & upgrades. Before proceeding, always remember to BACKUP your site first.

Get the latest version of the JLex Comment at the download page: https://www.jlexart.com/downloads

At the admin section of your website, follow these steps:

  • Joomla 2.5 & 3: Extension > Manage
  • Joomla 4: System > Install > Extensions
Select Upload Package File tab > Select the downloaded file to install.

3. Activate The Extension

* Applicable from version 2 and above.

After a successful installation, access component: Components > JLex Comment

This extension is required to activate for use. You need to go to the download page https://www.jlexart.com/downloads, COPY the License key (Click Create button if not already) and PASTE it in the activation window.

You can not activate? Please add Domain + Site access at the download page and open a private topic HERE.
Note: This activation occurs only when the new installation or upgrade.

Use

Integration with available extensions such as VirtueMart, K2...

  • Visit the Add-ons page, find your extension and follow the instructions.
  • If the extension is not on the list, please open the request HERE.

Data Import

You can import data from CSV files or directly from supported extensions, including:

  • CComment
  • JComment
  • K2
  • Komento
  • VirtueMart

With CSV, make sure the file contains enough of the basic fields:

  • Comment
  • Author Name
  • Date

Once you have the CSV file, GOTO JLex Comment > Import/Migrators > Select File and follow the instructions OR import data directly from the above extensions.

Create your own comments page

  1. Admin Site > Menus > Main Menus > Add New Menu Item
  2. At Menu Item Type > Select > JLex Comment > Discussion
  3. Fill Menu Name and Alias > Save

You want to create a review page but through the module? See here.

Comment Form

Formatted Text

By enabling this feature, users can use popular text formats such as: Bold; Italic; Underline; Strike; Insert Link; Quote; Code
GOTO Settings > Layout > Comment Form > Format Text: Yes.

Upload Photos & Files

This feature helps users to attach photos and files to their comments.
To enable this feature, GOTO Settings > Layout > Comment Form > Media: Yes.
You also turn on it in ACL Manage (Media: Upload Files). See HERE.

Related parameters:

Property Default Value Description
File Extensions jpg,jpeg,png,gif,zip,rar File extension allowed. Separate each other with commas and no spaces.
Max File Size (Mb) 2 The maximum size of the file that can be uploaded.
Attachment path media/jcm The directory where the upload file is stored.
Photo Max size 1000 The system will resize the image if its width or height exceeds this value.

Location Sharing

Attach your location to the comments. GOTO Settings > Layout > Comment Form > Location: Enable
You also need a Google Map Key for the feature to work.

Sticker

Insert sticker into comments. The sticker can be available (added by admin) or added by the user.
GOTO Settings > Layout > Comment Form > Sticker: Enable

In order to add new sticker, from admin area, GOTO Sticker > New, select your file and save it.
Users can also use their photo as a sticker if you activate it: Settings > Layout > Comment Form > Sticker Photo: Yes.

Comment Style

! You need to know the CSS code to start this section. This feature is used to add style to comments.

GOTO Settings > Layout > Comment Form > Comment Style: Yes.

GOTO Style to add new and manage these styles.

Emoji

Emoji Picker use to insert ideograms and smileys into comment

To enable it, GOTO Settings > Layout > Comment Form > Emoji: Enable. This extension use Twemoji OpenSource to render these emoji.

GIPHY

Insert GIF image from GIPHY gallery into comment.

To enable it, you need:

  • GOTO Settings > Layout > Giphy: Yes
  • Visit page developers.giphy.com to get key and fill it in the Giphy API key field.

Anti-Spam

Captcha

CAPTCHAs provide challenges that are difficult for computers to perform but relatively easy for humans. Used to limit spam.
reCaptcha See instructions for installation and usage in the Add-ons section.
Image Captcha Here

Blacklist

Tools to block members or guests (by IP address)
GOTO Blacklist > New to add new row:

Anyone on this list cannot write comment.

Report

The tool recognizes feedback on reviews or comments that are not positive.

Activate this feature by going to Settings > Permission > Report a Comment

Notification

Administrator

Property Value Default Value
Email
Email address to receive notifications
Blank Blank
Include reply Yes | No No
Sending Method Immediately | CronJob CronJob
Begin Date Date to begin send notification - Just apply for CronJob Sending Method. Blank
Quick Moderation
View, delete or publish comments from email.
Yes | No Yes
Send an Email to owner
Send email to user who write a comment
Yes | No No

User

Property Value Default Value
When mention
When someone mentioned in the comment
Yes | No Yes
When replied
Get notified when someone replies to your comment
Yes | No Yes
Alert front-end
Send a notification to profile page
Enable | Disable Disable

CronJob Setup

To enable notification for members, or admin (if you choose CronJob) you must add the CronJob command in the notifications section to CronTab.
Most Hosting or Server UI provide this tool.

Notice: If you are using Akeeba Admin Tools, please open .htaccess file and remove the line contain:

SetEnvIf user-agent "(?i:Wget)" stayout=1

Login & Social Integrations

Login

The default login system of JLex Commeny is a dialog box.
You can switch this login method to a custom URL address.
GOTO Settings > General > Login Type: Dialog | URL

Note: If you want the comments to be enable only to guests, you need GOTO Settings > General > Login Site: No | SignUp: No

Social Integrations

GOTO Configuration > User to get started:

Facebook

  1. Visit https://developers.facebook.com/
  2. Login to Facebook
  3. Click My Apps in top right of screen
  4. Click Create App
  5. Choose Build Connected Experiences
  6. Fill App Display Name and App Contact Email > Click Create App
  7. At Products Page , select Facebook Login > Setup
  8. In the sidebar > Facebook Login > Settings
  9. Add the value taken from Admin Site (JLex Comment Settings > General > Facebook Login > OAuth Redirect URIs) to Valid OAuth Redirect URIs of Facebook settings > Save Changes
  10. From Sidebar > Settings > Basic > Fill all informations
  11. Switch In developement to Live mode
  12. Copy App ID and App Secret to JLex Comments Settings.

Google

  1. Visit https://console.cloud.google.com/
  2. Login to Google
  3. Select Manage Project > New Project > Fill Project Name > Create
  4. Wait for the project creation process to complete > Select newly created project to continue
  5. Navigation Menu > APIs & Service > Credentials > OAuth consent screen
  6. Set User Type is External
  7. Fill out all required information > Save and Continue
  8. Click Add or Remove Scopes
  9. Select userinfo.email and userinfo.profile > Update
  10. From Sidebar > Credentials > Create Credentials > OAuth Client ID
  11. Select Application type is Web application
  12. Add the value to URIs in Authorized redirect URIs. (This value is taken from JLex Comment Settings > General > Google Login > Google Redirect URIs )
  13. Click Create button to complete
  14. Copy Your Client ID, Your Client Secret to JLex Comment Settings

Twitter

  1. Visit https://developer.twitter.com/en/portal/dashboard
  2. Login to Twitter
  3. From the sidevar > Projects & Apps > Overview > Create App
  4. Enter App Name
  5. Copy App key and API secret key to JLex Comment Configuration
  6. From Twitter App > Click App Settings
  7. Scroll page to Authentication settings > Edit
  8. Enable Enable 3-legged OAuth
  9. Add the value to Callback URLs - This value taken from JLex Comment Settings > General > Twitter Login > Twitter Callback URLs
  10. Enter Website URL > Save

VKontakte

  1. Visit https://vk.com/apps?act=manage
  2. Login to VKontakte
  3. Click Create button
  4. Fill out all required information
  5. After the application is successfully created, from sidebar of app page > Settings
  6. Copy Secure key and Service token to JLex Comment Settings

Profile Extensions Integrations

JLex Comment supports sync of avatar & link to profile with the following extensions:

  • JLex Review
  • EasySocial
  • EasyBlog
  • EasyDiscuss
  • EasyProfile
  • K2
  • Community Builder
  • Gravatar (Avatar only)
  • JomSocial
  • Kunena

GOTO Settings > Layout > Profile Integration to get started.

Configuration

Below are the main features. See full in the admin section of The Demo Site.

Property Description
Template Default(Light) | Dark
Load Default CSS
Font Awesome Icon Support Font Awesome 4 & 5
RSS Enable web feed that allows users and applications to access updates to websites in a standardized, computer-readable format.
Author Avatar Show/Hide user avatar
Author Name Use Username or Name as a nickname
People listing Displays a list of users interacting in a conversation
Comment Date Show the date of the comment.
Date Format Time Ago | m/d/Y | d/m/Y | ...ect
Collapse Collapse comment if its content is too long.
Format link Auto wrap a link in Comment content
Sharing Share comment to social network platform
Form position Top or bottom of the comment listing
Filter Bad Words Yes | No
Filter by Language Show only comments with the current language of the page.
Import/Export Setting Backup or Recover JLex Comment settings.

Module & Add-ons

Download and See how to use Modules & Addons at page jlexart.com/addons/jlex-comment

Module positions

JLex Comment support three positions to embed modules:

  • jcm-form-top
  • jcm-form-bottom

The screenshot below is preview position:

Advanced

Roles

Used to label a group of members or meet an optional condition.
Access Roles to add new and manage:

Input Output

Reaction

You can replace the button interact with comments such as Up/Down by the reaction buttons.
GOTO Settings > Layout > Voting Type: Reaction. Then add reaction button in the Reaction data field.

Input Output

Terms/Rules

Remind users of the terms of use before they post a comment.
To enable it, GOTO Settings > Layout > Comment Rule: Yes.

Access Control List Manage

Used to control permissions according to groups of users. GOTO Settings > Permission to get started

User Admin
Write/Edit/Delete Comment Edit/Delete Any Comment
Media: Upload Files Publish/UnPublish Any Comment
Download File Show author IP/Email address
Mention Featured/UnFeatured Any Comemnt
Vote a Comment See author's email or IP address
Report Comment
Subscribe discussion
Automatically Publish Comment

Developer

Before read these sections, make sure you know PHP language firstly.

Replacer

Using to replace a structured string in comment.

Example: You want to preview image based link attached in review
GOTO JLex Comment > Replacer > New to add new replacement item. Fill form as image below:

Then, select User Group you want apply and save this form.

Synchronization

This part will solve some issues:

  • Sync title & url of item in JLex Comment when it is changed by parent extension
  • Make something when the number comment of item is changed
  • Author of item will be subscribe automatically, and they will receive a nofitication when someone post a new review.
We will go to a specific example:

You have integrated JLex Comment with K2, and now you want solve above issues.

First, you need access to Synchronization menu in back-end. Click "New" button to go Sync form.

At here, you will see 3 corresponding items to solve the above problems.

  • Update entry details
  • Callback when number comemnt of item is changed
  • The author keeps track of their posts

Firstly, you need set value of Object field is k2 (lower).

Update Entry Details

Global variable: $object_id. In this part, you need write a program to get title & link of K2 item. The ID of K2 item is $object_id
Return an array include two properties title and url, return deleted (string) if item not found.

Callback when number comment of item is changed

If the number comment of item is changed and you want make something (eg: update value of a field of database). Global variable include $object_id, $comment_count, $all_comment_count. The ID of K2 item is $object_id

The author keeps track of their posts

When author post an article, you need click to subscribe button to get latest comment about this article. It will better if system auto add this user to subscription list.
In order to do that, you need enable The author keeps track of their posts. In Code editor, you need write a program to get USERID of author based on ID of item (here is $object_id).

Templates

Install New Themes

In order to create new theme, you should do following steps:

  • Go to directory: components/com_jlexcomment/themes
  • Copy default forder and rename by new name.
  • Now, you can custom your theme by modify file in this folder
  • Last, Go to Settings > General > Template > Select your theme

Template Overrider

JLex Comment sub-templates extend the templating capabilities of Joomla! by allowing the creation of multiple, named sets of view overrides for JLex Comment.

JLex Comment component sub-templates are created by copying the contents of components/com_jlexcomment/themes to /templates/DEFAULTTEMPLATE/html/com_jlexcomment/, where DEFAULTTEMPLATE is the name of your site's default template.

Each template pack will include:

  • - default.php
  • - default_comment.php
  • - default_comment_flex.php
  • - default_comments.php
  • - default_form.php
  • - default_header.php
  • - style.css (Option)

To create a new JLex Comment component sub-temple, make a copy of /templates/DEFAULTTEMPLATE/html/com_jlexcomment/default and rename it appropriately, such as /templates/DEFAULTTEMPLATE/html/com_jlexcomment/mytheme (or keep is "default"). The files in this new sub-template can now be customized as needed.

Last, make sure that you set new theme in Setting.

Email Template

All email templates stored in path administrator/components/com_jlexcomment/libraries/email_templates

This folder include 6 files:

  1. admin.php Notification for admin when have a new comment
  2. mention.php Notifications for users mentioned in comments
  3. subscription.php Notifications for user when item that they subscribed have a new comment
  4. subscriber_verify.php Confirm user's email address when they subscribe
  5. user.php Send Thanks Email to User who wroten comment
  6. body.php The HTML page use to send email.

You can clone this folder to create new email template but must enter new directory in JLex Comment > Settings > Advanced > Email Template Path.

Integration Into Other Extensions

Same as popular components like as JLex Review, JComments, Komento... JLex Comment allow you integrate it to your component. It contain two parts:

Comment Counter

Using to display number comment of item

<?php
$loader = JPATH_ROOT . '/components/com_jlexcomment/load.php';
if(file_exists($loader))
{
    require_once $loader;
    echo JLexCommentLoader::count_cm($extension, $id);
}
	

Parameters:

  1. $extension: (type:string) - name of component (without com_ prefix) : k2, virtuemart or easyblog ....
  2. $id: (type:integer} - ID of item (maybe is article, blog item...)

Example:

<?php
$loader = JPATH_ROOT . '/components/com_jlexcomment/load.php';
if(file_exists( $loader ))
{
    require_once $loader;
    echo JLexCommentLoader::count_cm('k2', $item->id);
}
	

Comment Listing & Form

Put code bellow where you want show full comment page:

<?php
$loader = JPATH_ROOT . '/components/com_jlexcomment/load.php';
if(file_exists($loader))
{
    require_once $loader;
    echo JLexCommentLoader::init($extension, $id, $title="" , $url=null );
}

Parameters:

  1. $title (type:string) - name of reviewed item. If this param is blank, the JLex Comment will find title automatically
  2. $extension (type:string) - name of component (without com_ prefix) : k2, virtuemart or easyblog ....
  3. $id (type:integer} - ID of item (maybe is article, blog item...)
  4. $url: (type:string | default:null} - Url to comment item. If this param is blank, the JLex Comment will find url automatically
Example:
<?php
$loader = JPATH_ROOT . '/components/com_jlexcomment/load.php';
if (file_exists ( $loader )) {
    require_once $loader;
    echo JLexCommentLoader::init ( 'k2', $this->item->id , $this->item->title );
}
TOP
Sign in to your account

Use your social accounts to sign in