Articles Field

Connect other articles to your content item

  • Last updated: 21-Apr-2018
  • Version: 1.1.2
  • Type: Custom Field plugin

Do you like Articles Field?

Rate it!

Tutorial for Articles Field

There is a Free and a Pro version of Articles Field.
The parts in this tutorial that only concern the Pro version will be marked with: Pro only

Introduction

Articles Field is a Joomla! custom field plugin that greatly extends the capabilities of custom fields.

With the native Joomla! lists fields, the values are only treated as plain text and cannot be linked to any other content.

The Regular Labs “Articles Field” (articles) is a Joomla custom field that gives you the ability to choose from a list of articles (based on the selected filters), allowing you to directly connect articles to each other.
The result displayed on the frontend article is a list of titles of the selected articles, that can be hyperlinked to the respective articles, and even displayed along with the value of another custom field.

You can determine which articles show up in the custom field select list by optionally filtering it by categories.The Pro version allows you to also filter the list of articles by tags, users and other custom field values.

The Pro version also adds the ability to show in an article all the other articles that are linking to it via other instances of this Articles Field, by using the alternative “Show Linked Articles” Field Type.

Usage Example

Here is an example of how you can use this Articles Field.

Movies

You have a movie website. You have 3 main categories with articles: one for the "Movies", one for the "Actors" and one for the "Directors".

On each movie page you want to list the Actors and the Director(s) associated with that movie.

So you can create 2 custom field instances of Articles Field, both assigned to the "Movies" category:

  • Name the first "Actors" and set the Filter by Categories to "Actors".
  • Name the second "Directors" and set the Filter by Categories to "Directors".

Now when you go to a movie article, you will see the 2 custom fields. One will list all the "Actors" articles and the other all "Directors" articles. You can select the actors and the director(s) from those list fields.

When you go to the movie article on your website, you will now see the output of the 2 custom fields. Each listing the selected articles (actors and directors) as clickable titles. Clicking on one of these will take you to the respective article.

If you want to also show in the Actors page all the Movies linked to each actor (so that both category items link back and forth to each other), you can do this with the Pro version of Articles Field.

Simply create a new instance of the Articles Field, name it "Movies" and assign it to the "Actors" category. Set the Field Type to "Show Linked Articles" and select the "Movies" field as the Linked Fields value.

Now in each actor article page you have the ability to switch on the field to show the linked movie articles.

Field Types

Articles Field has a Field Type setting which has 2 settings: "Link Articles" and Show Linked Articles". The second is only available in the Pro version.

Link Articles

This field enables you to select other articles to link to.

When you create/edit an article, this field will show you a selection of articles you can select.

The selected articles will then be displayed as a list of linked titles in the frontend article view (in the custom fields section).

When you create a custom field of this type, you can select different filters to limit down the available articles the article editor can choose from.

With the Free version you can filter the articles by one or more Categories.
You can even tell it to use the category currently selected in the article where you place the custom field.

Articles Field: Link Articles: Categories

The Pro version also offers other filters: Tags, Users, Custom Fields.

Articles Field: Link Articles: Pro Filters

Show Linked Articles Pro only

If you have already created one or more "Linked Article" fields, you might want to also show articles that are linking to the current article via those fields.

You can do this with the "Show Linked Articles" type.

You can tell this field to only show linked articles from specific"Linked Article" fields.

Articles Field: Show Linked Articles

Layout

By default, Articles Field will output the list of articles as linked titles. But you can change this behavior.

You can choose to switch off the Link Title setting.

There is also an option to show the value of another custom field after the title.

Articles Field: Layout

Custom HTML Pro only

In the Pro version you can even define a custom HTML output for every list item.

The default example value will show a linked title and the number of views (hits).

<a href="/[url]">[title]</a> ([hits])

Articles Field: Layout: Custom HTML

As you can see, there are placeholder [data] tags in there.

You can use any data available in the article. So those are the field values you see in the article edit form.

This includes other custom field value.
So if you have a custom field called "Location" (with name location) and you only want to show that as the output, without a link to the article, simply use:

[location]

Articles Field will filter out any duplicate values.

Settings

Type: Link Articles

This field enables you to select other articles to link to.

Multiple Allow multiple values to be selected.

Options: Global, Yes, No

Filters

Categories

Filter by Categories Select the categories to limit the articles by. Only articles under these categories will be available to select in the select list.
You can also select 'current' to make it use the category set in the article.
Include child items Also include child items of the selected items?

Options: No, Yes, Only

Tags

Tags Select the tags to limit the articles by. Only articles that have any of these tags will be available to select in the select list.
Include child items Also include child items of the selected items?

Options: No, Yes, Only

Users

Users Select the users to limit the articles by. Only articles created by these users will be available to select in the select list.

Custom Fields

Filter by Custom Fields Select the custom fields to limit the articles by. Only articles having the given values for the given custom fields will be available to select in the select list.

Type: Show Linked Articles Pro only

This field will show articles linking to the current article (via other Articles fields).

Linked Fields Select the Articles fields through which other articles are linking to the current article.

Layout

Layout Select the layout to use. You can override this layout in the component or template.

Options: Title, Title + Custom Field, Custom HTML Pro only
Link Title Select to add a link to the article titles. (for Layout: Title, Title + Custom Field)
Custom Field Select the custom field value to use. (for Layout: Title + Custom Field)
Custom HTML Set a custom HTML as the layout for each element. You can use [data] tags to output available article data.
Separator Choose a separator for repeated elements.
%MCEPASTEBIN%

Installation

You can either install Articles Field by using the core extension manager available in the Joomla! Administrator Control Panel, or by using the powerful Regular Labs Extension Manager.

Note: When updating Articles Field, you do not need to uninstall it first. The package will update all the files automatically.

Keep in mind that when you update to a major new version (or uninstall first), you might lose some configuration settings.

Regular Labs Extension Manager

It is very easy to install/update any Regular Labs Extension using the Regular Labs Extension Manager.

Please see the Tutorial for the Regular Labs Extension Manager for more detailed information...

Joomla! Extension Manager

To install via the Joomla! Extension Manager, just follow these steps:

  1. Log into your Joomla administrator;
  2. In the menu, choose: Extensions >> Extensions;
  3. Choose the tab: Install from Web (or enable it if you haven't done so yet);
  4. Select the search field and enter Articles Field and hit enter;
  5. Click on the Articles Field listing;
  6. Click on Install;
  7. Click on Install to confirm.
Joomla! Installer - Install from Web

Or if you need to install the Pro version or cannot install via the 'Install via Web' method for some reason:

  1. Download the extension install file (.zip);
  2. Log into your Joomla administrator;
  3. In the menu, choose: Extensions >> Extensions;
  4. Choose the tab: Upload Package File;
  5. Click on the Choose File button and select the extension zip;
  6. Click on Upload & Install.
Joomla! Installer - Upload Package File

If you have problems installing Articles Field, please try the manual installation process as described here: docs.joomla.org/Installing_an_extension