SocialMagick generates OpenGraph data and images for all pages of your site. To do that it needs to somehow retrieve the text to be used for the OpenGraph image template (if you select to use a text overlay), and the image to be used as the Extra Image for the OpenGraph image template. Moreover, it needs to have different kinds of integration code to display the OpenGraph options tab when editing categories, content items, and menu items.
While older versions of SocialMagick had these integrations hardcoded, SocialMagick 3 and later versions use integration plugins. These are standard Joomla plugins in the socialmagick group.
This plugin allows SocialMagick to integrate with Joomla articles. You must have this plugin enabled for this integration to function.
The plugin is responsible for rendering the OpenGraph tab when you are editing a Joomla article.
When your frontend page is displaying a Joomla article, this plugin makes the following information available to SocialMagick:
The article title can be used as the OpenGraph image template text when you enable Use Content Title.
The article's Intro Image and Full Text Image can be used as the Extra Image in the OpenGraph image template.
A Joomla custom Field can be used as the Extra Image in the OpenGraph image template.
The Access for this plugin MUST always be set to Public. See the Advanced tab for options limiting access to the OpenGraph tab to specific user groups.
The configuration options in the Plugin tab are:
The default Extra Image source for Joomla articles. This can be overridden at the category, article, and menu item level. The available options are:
None. No Extra Image will be used.
Intro Image. The article's Intro Image will be used, if present. Otherwise, no Extra Image will be used.
Full Article Image. The article's Full Article Image will be used, if present. Otherwise, no Extra Image will be used.
Custom Field. The image provided by the custom field whose name is set up below will be used, if present. Otherwise, no Extra Image will be used.
Full Article, or Intro Image. The article's Full Article Image will be used, if present. If it's not present, the article's Intro Image will be used. If neither image is present, no Extra Image will be used.
Intro, or Full Article image. The article's Intro Image will be used, if present. If it's not present, the article's Full Article will be used. If neither image is present, no Extra Image will be used.
Custom Field, Full Article, or Intro Image. 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's Full Article Image will be used, if present. If it's not present, the article's Intro Image will be used. If none of these images is present, no Extra Image will be used.
Custom Field, Intro, or Full Article Image. 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's Intro Image will be used, if present. If it's not present, the article's Full Article Image will be used. If none of these images is present, no Extra Image will be used.
The Name of the Joomla Field of the article 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'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 article's Meta Description as the OpenGraph description. You can override this in categories, articles, and menu items. If this is disabled, SocialMagick will instead use the Meta Description set up in the currently used menu item. Please note that in if you have a Category List or Category Blog menu item and click on an article this category view menu item will be used by Joomla even if you have a different menu item for the specific article you clicked on. This is a deliberate choice in Joomla; it's what allows Modules to be so flexible and powerful.
The Advanced tab allows you to specify who for and where the OpenGraph tab will be visible when editing a Joomla article.
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 in the frontend of the site? Super Users are not limited by this setting.
If this is empty, any user who can edit an article 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. Super Users are not limited by this setting.