JV-Relatives - Component Configuration

There are 2 different types of settings that must be configured in JV-Relatives. First is the component configuration and the other is the module/plugin/field configuration. In this article you will learn to configure settings in the JV-Relatives component configuration in back-end.

IN THIS ARTICLE

To get started, please login to your site back-end, and go to Components - JV-Relatives. Click on the "Configuration" menu to the left. 

Common Settings:

Select Style

You can select the style that will be used for JV-Relatives in site frontend while displaying related articles. Style determines the set of files to be used to render the related articles output. Currently there are 3 different types of styles. They do not differ in the output or the layout. 

  • Default: Use this if your Joomla template is using Twitter Bootstrap 2.3.2 version.
  • Defaultbs3: Use this if your Joomla template is using Twitter Bootstrap 3.x version.
  • Legacy: Use this if your Joomla template does not use Twitter Bootstrap.

You need to check with your template provider to know the version of Twitter Bootstrap that is used in the template.

Open in new window

Decide if you want to open the related article in new window when clicked?

Sorting Criteria

Related articles are sorted when they are displayed. You can decide the criteria to be used for sorting with this option. We recommend RANDOM display to rotate the articles in display. Options available are,

  • Select Random Articles
  • Hits - Ascending Order
  • Created Date - Ascending Order
  • Modified Date - Ascending Order
  • Article Title - Ascending Order
  • Hits - Descending Order
  • Created Date - Descending Order
  • Modified Date - Descending Order
  • Article Title - Descending Order
  • Relevance - Descending Order

No Related Articles Text

This will be the text that will be displayed when no related articles, and no articles from same category (if that option is enabled) are found. If you leave this blank, then nothing will be displayed (including the caption) if no related articles are found. Please note that, this text will be shown only for those users who have the permission to manage JV-Relatives component (typically administrators) and not to guests or others.

Show No Related Articles Text

If yes, then a message to administrator that the article does not have related articles will not be displayed.

No Keywords Text

This is the text that will be displayed when there are no meta keywords configured for the displayed article. If you leave this blank, then nothing will be displayed (including the caption) if there are no meta keywords configured for the article. Please note that, this text will be shown only for those users who have the permission to manage JV-Relatives component (typically adminstrators) and not to guests or others.

Show No keywords Text

If yes, then a message to administrator that the article does not have meta keywords will not be displayed

Meta keywords to ignore

Provide a comma separated list of keywords, that you want to ignore during scanning of related articles. Please leave it blank, if you do not want to use this feature.

Include author Id of

This option restricts the related articles scan to articles of specific author. Please provide the ID of the user here. Give a value of 0 to disable this option.

Age of related articles

With this option, you can display related articles which have been published anytime in the last n days from today. For example, if you set the value for this option to 60, then only those related articles which have been published in the last 60 days will be displayed. This ensures that, displayed related articles are recent ones as well!


Thumbnail Settings

JV-Relatives can generate and display thumbnails of images inside related articles and show them alongside the related article listing. Following are the settings available for thumbnail generation and display. You may switch off or switch on thumbnail display and also configure additional parameters from individual module/plugin/field configuration.

Hyperlink Thumbnail

If yes, then the thumbnail will be hyperlinked just like the title of the related article.

Default Thumbnail Image

You may choose a default thumbnail image that can be displayed when the related article does not have an image in it. If you leave this field empty, then the default thumbnail image will not be shown when the related articles does not have an image.


Social Media Buttons Settings

Social Icons Code

Provide the html code to display social icons. You can get the html code by creating a free account at www.addthis.com or shareaholic.com.

Instructions for addthis.com:

Login to your account at addthis.com

  1. Click on Tools menu at the top.
  2. Scroll down the page and go to the Share Tools section.
  3. Select the "Share Tool" that you want to display and click on "Get Code" for it.
  4. A pop up will appear from where you will see two sets of javascript codes in step-1 and step-2 boxes.
  5. Copy those 2 sets of code and paste them into the above text area field in JV-Relatives field.

Instructions for shareaholic.com:

  1. Login to your account at shareaholic.com
  2. If you have already not added your site, then please do that first.
  3. Go to Website Dashboard and click on "Get Setup Code"
  4. Copy the javascript code that will appear in a popup and paste it in the JV-Relatives field.
  5. Click on "Add App Location" and choose "Share Buttons"
  6. In the next screen configure the buttons as you wish and then "Save Settings".
  7. Then click on the "Code Snippet" icon and copy and append the Javascript code to JV-Relatives field.

End of Page Slide Out Box Settings

These determine the settings for the related articles slider that comes out from right bottom of the page, as visitor reaches the end of the article. Please read the "End of Page Slide Out Box" article for configuring these settings.


Advanced Settings:

Load Bootstrap CSS?

Set to Yes, only if your Joomla template is not loading Twitter Bootstrap CSS. If yes, JV-Relatives will load Twitter bootstrap 2.3.2 css file that is bundled with Joomla. If in doubt, please contact support at jv-extensions.com.

Load Bootstrap JS?

Set to Yes, only if your Joomla template is not loading Twitter Bootstrap JS. If yes, JV-Relatives will load Twitter bootstrap 2.3.2 js file that is bundled with Joomla. If in doubt, please contact support at jv-extensions.com

Display Powered By?

If yes, then "Powered by JV-Relatives" will be displayed below the related articles block of display in site frontend.

Enable Debug?

If Yes, then JV-Relatives will log all debug output to a file in your temp folder. To view the log file, go to JV-Relatives Dashboard and click on "View Debug Log". You also have the option to delete the debug log from with in the debug log area, and export it while contacting support.

Enable Caching?

If yes, then the related articles output of JV-Relatives will be cached and the cache output will be displayed on further page refreshes of the displayed article.

Cache Expiry Duration

This value is in minutes. The cache will be recreated once this duration elapses. You may also clear the cache using "Clear Cache" link in back-end dashboard.

Still need help? Contact Support Contact Support