Content Plugin

1 - Content Plugin

The media content plugin displays media in Joomla articles, and other content areas of your Joomla site which support content plugins. The plugin has a number of alternative layouts to provide flexibility in the display.

Enable the plugin

You should visit the Joomla plugin manager, and check the media content plugin is enabled.

To make it easier to add media to articles, you should also enable the media editor button plugin, that will place a useful button under your editor which can be used to find and select media.

Configure the plugin parameters

You can also edit the media content plugin, and review the parameters are setup as needed.

Default layout Parameter

This option allows you to choose the default layout option for media. However, the layout can be changed for each media that is added to an article. 

2 - Showing media in articles

Now the plugin is installed and enabled it can be used to insert media into your Joomla content articles. To display display media, you insert a specially constructed code into the article editor. When the article is viewed in the website, this code will be converted to display the media by the plugin.

You can use the media button under the editor window to locate and insert media. The button will automatically generate the necessary code to show the media.

Available layout options

The following is a list of current layout templates for the plugin. More are add frequently. See below for examples of each layout.

• Blog - Shows the title with a full width media player underneath
• Details - Standard media listing
• Details (lightbox) - Standard media listing, that opens in a lightbox
• Documentation - Centrally aligned thumbnail that opens in a lightbox, with title and description underneath
• Solo - Just the media on its own
• Thumbnail - Just the thumbnail, which links to the main media page.
• Thumbnail (lightbox) - Just the thumbnail, that opens media in a lightbox 

Shortcode example of the Blog layout

{media id=XX,layout=blog}

Shortcode example of the Details layout

{media id=XX,layout=details}

Shortcode example of the Details (lightbox) layout

{media id=XX,layout=details-lightbox}

Shortcode example of the Documentation layout

{media id=XX,layout=documentation}

Shortcode example of the Solo layout

{media id=XX,layout=solo}

Shortcode example of the Thumbnail layout

{media id=XX,layout=thumbnail}

Shortcode example of the Thumbnail (lightbox) layout

{media id=XX,layout=thumbnail-lightbox}

Create your own media code

The code needed to insert media has the following syntax.

{media id=XX,layout=XX ... }

You then pass your required parameters in a comma separated list within the braces or curly brackets { }.

Required parameters:

Name	Parameter	Format	Description
ID (Required)	id	integer	Defines the ID of the media you want to insert. {media id=XX}
Layout	layout	string	Defines the layout to be used when displaying the media. Possible values: See examples above. {media layout=blog}
Width	width	integer	Defines the maximum width of the media player, or thumbnail. {media width=XX}
Autoplay	media_autoplay	integer	Sets autoplay to be on (1) or off (0). {media media_autoplay=1}

3 - Showing media in modules

If you want to show media in modules, then you should use the numerous modules available for JoomMedia to achieve this.

However, there may be times when you want to use the content plugin in a module. To do this, create a new Custom HTML module. Setup the module to show as you want, and then enter the necessary media code into the editor. In order for the video to be displayed, you must set the "Prepare Content" option to "Yes" in the Options tab of the module editor, as shown below.

{ media id=116,layout=documentation,list_thumbnail_aspect=0} 

4 - Showing albums in articles

Now the plugin is installed and enabled it can be used to insert albums into your Joomla content articles. To display display an album, you insert a specially constructed code into the article editor. When the article is viewed in the website, this code will be converted to display the album by the plugin.

{media load=album,id=XX,layout=details}

You can use the media button under the editor window to locate and insert media. The button will automatically generate the necessary code to show the media. 

Available layout option

The following is a list of current layout templates for the plugin. More are add frequently. See below for examples of each layout.

• Details
• Gallery
• List 

Shortcode example of the album gallery

{media load=album,id=XX,layout=gallery}