The following options cover which/how elements are going to be included in the image.

Configuration
Logo - Text - Credentials Logo - Text - Credentials
Credentials - Text - Logo Credentials - Text - Logo
Width (px) The width of the image in pixels
Height (px) The height of the image in pixels
Top margin (px) The empty space between the top border and the inside elements in pixels
Right margin (px) The empty space between the right border and the inside elements in pixels
Bottom margin (px) The empty space between the bottom border and the inside elements in pixels
Left margin (px) The empty space between the left border and the inside elements in pixels

Background

Color The color to use as a background
New
Default picture
The picture or the directory where the default background will come from.
  • None the background defaults to the color
  • Picture
  • Directory .png or .jpg images inside that directory are selected randomly
Picture The default picture to use as default background
New
Image directory
The '/images' sub-folder path containing the images to show (leave '/' to stay at the /images directory level)
Use full article image If full article image exists and the plugin does not exclude articles with full article images, the full article image will be used as background rather than the selected picture

Logo

Picture The picture to use as a logo
Alignment The alignment of the logo in the created image
  • Left
  • Center
  • Right
Max height (%) The maximum height in percentage the logo can take out of the canvas.
Note The logo will be resized to make sure it does not take over the max height AND that it will fit if the overall image is cropped by social media sites into a square image

Text

New
Text
The text that will show in the image
  • Title (default)
  • Intro The article's intro text
  • Intro -> meta description If the intro text is missing, use the meta description
  • Meta description The article's meta description
  • Meta description -> intro If the meta description is missing, use the intro text
  • custom fields Joomla 3.7+ Any custom field from the article context of type text or textarea
New
Letter count max
The maximum amount of letters that the text can use (useful when dealing with large amount of text).
Leave blank to show everything, 0 to show nothing (although what's the point?)
Max height (%) The maximum height in percentage the text will cover the canvas
Offset y (px) The amount of pixels to add or remove to the automatic vertical alignment of the text (depending on the fonts used, the text may need to be offset a little). Use negative numbers to move the text up
Font The font to use (default or TrueType).
Note Additional TrueType fonts can be placed into the folder media/syw_imagefromarticle/fonts/
Font size (px) The initial font size in pixels (does not apply to the default font). The text will resize automatically to fit the image, starting from the initial font size
Spacing (px) The space between lines in pixels
Color The text color

Credentials

Credentials Any fine print you want to add to the credentials section. It can be plain text (not internationalized) and/or use the specific keywords:
  • {author} to show the author of the article
  • {author_alias} to show the author alias of the article (if missing, will be replaced by the user name)
  • {date_created} to show the article’s creation date
  • {date_modified} to show the article’s modified date
  • {date_published} to show the article’s published date
Note Use new lines to produce separate lines for credentials and keep the text centered if the social networks that you use crop images
Alignment The alignment of the credentials in the created image
  • Left
  • Center
  • Right
Font The font to use (default or TrueType).
Note Additional TrueType fonts can be placed into the folder media/syw_imagefromarticle/fonts/
Font size (px) The initial font size in pixels (does not apply to the default font). The text will resize automatically to fit the image, starting from the initial font size
Spacing (px) The space between lines in pixels
Color The text color

Preview

Text The text to use for testing purposes
Notes
  • If you want to test the output without affecting the public side of the site, set the categories to None, enable the plugin and save your configuration. The preview DOES NOT refresh by itself, you need to save the parameters before seeing any change in the preview image (make sure there is no cache service/extension that would prevent the view from updating).
  • All elements composing the image are resized to fit a cropped version of it (squared). It is to ensure the content will always show in social media services that crop images before sharing content.
  • If the temporary image folder is set to be the cache, the preview image is stored at /administrator/cache.