This plugin allows SocialMagick to integrate with Joomla article categories. You must have this plugin enabled for this integration to function.
This integration plugin only applies to article categories. It does not apply to categories used by other core and third party components such as Banners, Contacts, News Feeds etc.
The plugin is responsible for rendering the OpenGraph tab when you are editing a Joomla article category.
When your frontend page is displaying a Joomla category (e.g. any of the default category blog or category list view options), this plugin makes the following information available to SocialMagick:
The category title can be used as the OpenGraph image template text when you enable Use Content Title.
The category's Image can be used as the Extra Image in the OpenGraph image template.
The Template shows the options Full Article Image and Intro Image. Either of these settings returns the category Image for category items.
A Joomla custom Field can be used as the Extra Image in the OpenGraph image template.
The configuration options in the Plugin tab are:
The default Extra Image source for Joomla article categoris. This can be overridden at the category, and menu item level. The available options are:
None. No Extra Image will be used.
Category. The article category's Image will be used, if present. Otherwise, no Extra Image will be used.
Custom Field. The image provided by the category custom field whose name is set up below will be used, if present. Otherwise, no Extra Image will be used.
Custom Field, or Category. The image provided by the custom field whose name is set up below will be used, if present. If there is no custom image field, or it's empty, the article category's image will be used, if present. If it's not present, no Extra Image will be used.
The Name of the Joomla Field of the article category which has the Extra Image to use in the OpenGraph image template. This must be a Media or Text field, or an equivalent third party field type. The contents of the field MUST be the absolute or relative filesystem path to an image hosted on your web server. You cannot use URLs, or images hosted externally to your site such as a CDN, Amazon S3, Dropbox, etc.
Tells SocialMagick to use the article category's title as the text overlay source. If disabled, the Use Content Title option will have no effect by default.
Tells SocialMagick to use the category's Meta Description as the OpenGraph description. You can override this in categories and menu items. If this is disabled, SocialMagick will instead use the Meta Description set up in the currently used menu item.
The Advanced tab allows you to specify who for and where the OpenGraph tab will be visible when editing a Joomla article category.
All users who belong to the Super User group are NOT limited by the options in this tab. Super User accounts can always see the OpenGraph tab. The reason is that Super Users in Joomla have, by definition, all privileges explicitly Allowed to them, i.e. the should and can do anything and everything on the site.
Should the OpenGraph settings tab show up when editing an article category in the frontend of the site?
If this is empty, any user who can edit an article category will see the OpenGraph tab. Otherwise, only users belonging to one or more of the groups specified here –or one of their child groups– will be see that tab.