Tutorial:

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, authors, language, 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, LanguageAuthorsCustom 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

Language

Language Select the language to limit the articles by. Only articles assigned to this language will be available to select in the select list.
You can also select 'current' to make it use the language set in the article.

Authors

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

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.
You can limit articles for up to 3 custom fields.

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.

Order

Order Order items will be displayed in.

Options: Ordering, Title, Alias, Hits, Created Date, Modified Date, Published Date
Direction Sort order. Descending is highest to lowest. Ascending is lowest to highest.

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.
Use Separator Choose a separator for repeated elements. You can also opt to not have any separator.
%MCEPASTEBIN%
Free vs Pro:

Single/Multiple::You can make the custom articles field accept only one article or a selection of articles.
Link Articles::Show a list of other articles you want to link to.
Different Layouts::By default the title of the articles will be shown. But you can also choose to show the value of another custom field.
Filters
Filter by Categories::You can limit the articles shown in the custom articles select field based on categories.

Show Linked Articles::Show a list of articles linking to the current article.
Custom Layout::You can take full controll over what data is output by using the Custom HTML layout option.
Filters
Filter by Tags::You can limit the articles shown in the custom field based on tags.
Filter by Users::You can limit the articles shown in the custom field based on users.
Filter by Custom Fields::You can limit the articles shown in the custom field based on the value of other custom fields.

%MCEPASTEBIN%

With the Regular Labs Articles Field you can create links between articles.

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.