You can place different images using the dedicated image data tags. This includes Intro & Full Article images, images from content, category images and even custom fields of type media.

Image Types

Intro & Full Article Images

You can output the article Intro Image with [image-intro], or the Full Article Image with [image-fulltext].

To output the url of these images instead - for instance to create your own custom <img> tag - simply add :url to the tag: [image-intro:url] or [image-fulltext:url].

Images from content PRO

The Pro version gives you the ability to place images that have been placed inside the content of the article's text:

  • To place the first image, simply use [image-1]. To place the fifth image found in the content, use [image-5].
  • You can even use [image-random] to output a random image from the content of the article.
  • To output the url of these images instead - for instance to create your own custom <img> tag - add :url to the tag. So [image-1:url] for the url of the first image and [image-5:url] for the url of the fifth image.
  • And you can use the [image-count] data tag to output the total number of images found in the text, which is also available to be used in If Structures.

When placing images from content, you are also able to filter images by adding a filter attribute. This will then only return the image matching your filter. Let's say the first image in the article is cats.jpg, the second guinea-pigs.jpg and the third is pigs.jpg. Using [image-2 filter="pigs"] will show you pigs.jpg, as that is the second image matching the filter.

The Filter attribute supports Regular Expressions. For example, to only show the first image from the article that contains either "dog", "hound" or "pug", you can use: [image-1 filter="(dog|hound|pug)"].

YouTube Thumbnail PRO

The Pro version gives you the ability to get the youtube thumbnail image from YouTube videos that have been placed inside the content of the article's text (via the youtube iframe code).

You can output the thumbnail image itself with [youtube-...:thumb], or just the url with [youtube-...:thumb-url].

Category Image PRO

The Pro version allows you to output the image attached to the category of the article.

You can output the image itself with [category:image], or just the url with [category:image:url].

Tag Image PRO J4

When using Tags as part of the Foreach Structure, you can also output the teaser image and full image of each tag. For example:

{foreach data="tags"}
[row:image-intro]
[row:image-fulltext]
{/foreach}

Read: Using the Foreach Structure to output Tags in a Custom Layout.

Media Custom Fields PRO

The Pro version also allows you to output the image from a custom field of type media attached to the article.

You can do so by simply using the name of the custom field, such as: [my-image-field].

To instead output the url of the image, as saved in the database, you can do: [my-image-field:value].

Image Attributes PRO

For any of these image types, you can also output their other parameters or attributes found inside the <img> tags, such as:

[image-intro:alt], [image-fulltext:caption], [image-1:width], [image-2:height]. etc...

For instance, [image-1:width] will output whatever is found in the width="..." attribute of the first image in the article. If the attribute is not found in the <img> tag, it will simply return nothing.

Adding or overriding attributes

In any [image-...] tag, you can override any attribute or set extra attributes to be used in the final <img> tag.

For instance, you can set the width and height attributes, or override the class name:

[image-3 class="my-new-class-name"]
[image-intro width="200" height="150"]

When you set width and height attributes, Articles Anywhere Pro will take advantage of the image resizing feature.

Auto Alt/Title Attributes PRO

The Pro version comes with the ability to automatically set the Alt and Title Attributes for any [image-...] tag placed through Articles Anywhere, with options to base them on the image File Name, the Article Title, the Category Title, and more.

The preference can be set for each image type in the Articles Anywhere Plugin Settings. And it can also be individually overruled for a specific {articles} tag via a auto-titles="..." attribute.

The Auto Alt/Title Attributes only apply when the image doesn't already have its own attributes specified.

When basing the attributes on the image file name, you can also select how they should be Cased. You can set them to be lowercase, UPPERCASE, Uppercase only the first letter, Uppercase All Words, or Smart Titlecase (which allows you to input a list of words that should remain lowercase).

For example, this allows the Alt/Title attributes for an image called soft-and-fluffy.jpg to be automatically set to “Soft and Fluffy”.

The Case setting can also be set in the Articles Anywhere Plugin Settings, or individually overruled via auto-titles-case="..." attribute. 

Image Resizing PRO

The Pro version of Articles Anywhere has the ability to automatically create resized images with your specified width/height, instead of outputting the original image files.

Settings

You can control the default behavior of the "Resize Images" feature via the Articles Anywhere system plugin settings, with three alternative options:

  • No - Don't resize images
    Images will NOT be resized when setting width/height attributes in [image-...] data tags.
    The original image file will always be used, and will only be shrinked to the specified dimensions..

  • Standard (default setting) - Only resize when dimensions are given
    Images will be resized and output based on the width/height attributes in [image-...] data tags.
    If no width or height attributes are found in the data tag, the original image will be used.

  • Yes - Always resize images
    Images will be always resized.
    If no specific width or height attributes are found in the data tag, the image will be resized based on the dimensions in the default settings.

In any case, you can also individually override/force this setting in a specific [image-...] data tag by adding a resize="..." attribute with either a true (Yes) or false (No) value:

[image-fulltext resize="true"]

In the Default Settings you can also set the quality of the resized images, select the filetypes to do resizing on (gif, jpg, png), and decide whether you want the images to be cropped or not.

Resized image files are stored inside a subfolder of the location containing your original image. By default, the folder name is resized, but you can customize it however you want.

Note: Only internal images hosted on your website will be resized. External images will not be resized or saved, and the original external images will be used regardless of the settings.

Data Tags Syntax

When resizing images via the [image-...] data tag, you don't need to specify both width and height attributes. You can also just specify one dimension, and the image will be resized maintaining its aspect ratio:

[image-fulltext width="240"]
<img src="/images/gallery/resized/apples_240x180.jpg" srcset="/images/gallery/resized/apples_480x360.jpg 1.5x, /images/gallery/resized/apples_240x180.jpg 1x" alt="Apples" title="Apples" width="240" height="180" />

Apples

When you specify both width and height attributes, resized images will be created with the exact width and height, meaning that if proportions are different, the image will be cropped to fill the specified dimensions:

[image-fulltext width="240" height="240"]
<img src="/images/gallery/resized/apples_240x240.jpg" srcset="/images/gallery/resized/apples_480x480.jpg 1.5x, /images/gallery/resized/apples_240x240.jpg 1x" alt="Apples" title="Apples" width="240" height="240" />

Apples

Using the [image-random] tag described in "Images from content", you can make cool stuff like this:

[image-random width="130" height="40"][image-random width="30" height="40"][image-random width="80" height="40"]
[image-random width="200" height="80"][image-random width="40" height="80"]
[image-random width="60" height="60"][image-random width="40" height="60"][image-random width="140" height="60"]

ApplesStrawberriesApples
LimesApples
BananasStrawberriesOranges

(Refresh the page to see the above images change on every pageload)

Alternative Layout

If you want to output the Intro Image or Full Article Image through the respective Joomla content layouts you can do:

[image-intro layout="true"]
[image-fulltext layout="true"]

This would output the Intro Image and Full Article Image through their respective default layouts, which are located at these paths:

/layouts/joomla/content/intro_image.php
/layouts/joomla/content/full_image.php

Alternatively, in the data tag you are also able to override the default layout with a different one.

You can use the default layouts listed above as your starting base, copy the file to templates/[my template]/html/layouts/joomla/content/my-image-layout.php , and edit the code to meet your needs.

Now, in the data tag, you can set to use the alternative layout by inserting the path to your file starting from the layouts folder of your template. The subdirectories must be separated with dots:

[image-intro layout="joomla.content.my-image-layout"]
[image-fulltext layout="joomla.content.my-image-layout"]

Custom Images / Suffixes

You can also output images with a suffix of your choice added to their filenames. You will need to create these images yourself, and name them using the given suffix.

Let's say you have this <img> tag in your content: <img src="/images/my-image.jpg" />.

Then you can do [image-1 suffix="-custom"] to output: <img src="/images/my-image-custom.jpg" />.

This could be useful to be used in If Structures to conditionally output alternative custom images in certain situations. This example will show a different image to guest users:

{if user:guest}[image-1 suffix="-guest"]
{else}[image-1]
{/if}

Visible to guests:
Apples

Visible to logged in users:
Apples

List of Data Tags

SyntaxExampleDescription
image-intro The intro image of the article.
image-intro:url /images/fruit/apples_s.jpg The URL of the intro image.
image-intro:alt
image-intro:caption
image-intro:float
Apples Any attribute related to the intro image.
image-fulltext The full article image of the article.
image-fulltext:url /images/fruit/apples_full.jpg The URL of the full article image.
image-fulltext:alt
image-fulltext:caption
image-fulltext:float
Apples Article Any attribute related to the full article image.
image-... PRO

 

The image by given number found inside the article text. For example image-2 to get the 2nd image found.
image-1:width
image-2:height
image-3:alt
etc. PRO
200, 150, My Image Any attribute related to the image found inside the article text by the given number.
image-random PRO   To output a random image from the content of the article.
category:image PRO The image of the category attached to the article.
category:image:url PRO /images/fruit/bananas_s.jpg The URL of the image of the category attached to the article.
my-image-field PRO   The image from a Custom Field of type media.
youtube-1-thumb PRO   The thumbnail for the YouTube video by given number found inside the article text. For example [youtube-2-thumb] to get the thumbnail of the 2nd video found.