Installation

Install as usual using the Joomla! installer.

Example Usage

• To show selected articles from any section of the site, leave the section and category ID parameters blank, and list the article IDs
• To show random articles from a category (section), set the category (section) ID, leave the article IDs blank, and choose the random ordering.
• To show the most read articles from a category (section), set the category (section) ID, leave the article IDs blank, and choose the most popular ordering.
• To show the most recent articles from a category (section), set the category (section) ID, leave the article IDs blank, and choose the recently modified first ordering.

Module Parameters

You can set the parameters for the module using the Joomla! module manager. The module uses sensible defaults, so to get you started you may only need to pick the articles that you wish to display. The parameters are shown below.

Count

The number of articles to display in the module.

Visible Count

The number of articles visible in the scroll window.

Ordering

The order in which the articles are displayed. The choices are:-

• Recently added first
• Recently modified first
• Most popular
• Least popular
• Default ordering
• Random

Authoring

The authoring of the articles allowed. The choices are:-

• Anyone
• Added or modified by me (ie the logged in user)
• Not added or modified by me
• Added or modified by profiled user (JomSocial/Mighty Touch integration)

Content Source

Choose from which Joomla component you wish the articles to be taken. The default is the Joomla core component, however the module can also read content from the Mighty Extensions resources component if this option is selected instead.

Front Page Articles

Choose whether front page articles are included in module. This applies when the Joomla content component is used as the content source only.

Section ID

The section(s) from which the articles are selected. This can be blank to include all sections, or be a comma-separated list for more than one. This applies when the Joomla content component is used as the content source only.

Category ID

The category(s) from which the articles are selected. This can be blank to include all categories, or be a comma-separated list for more than one. This applies when the Joomla content component is used as the content source only

Article ID

The IDs of the articles that you want to select. This can be blank, or a comma-separated list. If the section and category IDs are blank, then you can choose articles from all sections of the content. This applies when the Joomla content component is used as the content source only.

Resources Category ID

The category(s) from which the articles are selected. This can be blank to include all categories, or be a comma-separated list for more than one. This applies when the Mighty Extensions resources component is used as the content source only.

Resources Type ID

The type(s) from which the articles are selected. This can be blank to include all types, or be a comma-separated list for more than one. This applies when the Mighty Extensions resources component is used as the content source only.

Resources Article ID

The IDs of the articles (records) that you want to select. If the type and category IDs are blank, then you can choose articles from all types and categories of the content. This applies when the Mighty Extensions resources component is used as the content source only.

Resources Fields ID

The IDs of the fields (records) that you want to select. If the type and category IDs are blank, then you can choose fields from all types and categories of the content. This is also useful when you want to display articles but you don't want all the fields to be displayed in the module. This applies when the Mighty Extensions resources component is used as the content source only.

The module can display text taken from the text, textarea and html field types, and thumbnails taken from the image or picture field types, as well as images embedded in html fields.

Count Characters

This determines whether the module counts characters or sentences when determining the length of the extract to display. If characters are used the extract length will be rounded to the nearest whitespace character, if sentences are used the extract will use characters up until the next terminating punctuation (!? or .).

Layout

Choose the layout for the modules, choices are: default and thumbnails only. The layouts can be edited if you wish, by editing the module template files, which are in the module folder 'tmpl'. You can edit any of the html in these files, but be careful not to edit the php variables. It is a good idea to keep a backup of the templates.

Scroll Direction

Choices are horizontal and vertical.

Scroll Event

These are the mouse events to which the scrolling responds. Choices are mouseover and click. If 'click' is chosen the scroll arrows will show, otherwise they will not.

Colour scheme

Choose the background colours for the module. The choices available are:silver, blue, green, black, dark grey, white, dark blue, user. The last one is to allow the option for the user to edit the css, though actually any of the styles can be edited. The stylesheets can be found in the module folder 'css/colors'.

Link Images

If set to 'yes', the images are clickable.

Read more link

If set to 'yes', each article includes a clickable 'read more' link.

Show images

Choose whether to include a thumbnail image along with the article extract.

Max Image size

The maximum size of the image (in pixels).

Image Position

Choose whether to display the image to the left or right of the article.

Use GD

If selected, the GD graphics module is used to resize the image. This is preferable, because it does result in better image quality and smaller download size. However it does require that your PHP installation includes the GD module. If the GD option is not used, the images can still be displayed as thumbnails, but the actual image files will be used, just displayed at a smaller size.

Item width, item height and item margin

These are the dimensions in pixels of the individual article extract.

Fixed width and fixed height

These parameters are used to set a fixed width and height in pixels to the pane holding the articles. Usually it is not necessary to set this parameter, as the sizes will adjust automatically, but sometimes layout problems can be avoided by setting this width or height.

Intro Text and Footer Text

Add text here that you wish to display at the head and foot of the module.

Module Class suffix

This is used mainly to set a common style for modules.

Tags

A new feature of the module is that you can optionally display special information about the article inside html comment tags. This information will be read and displayed by the module. However because it is placed inside comment tags these will not be visible when the main article is viewed.

The available display tags are:-

• <!--heading:[ heading goes here]-->
• <!--author:[author goes here]-->
• <!--synopsis:[synopsis goes here]-->
• <!--comment:[comment goes here]-->
• <!--image:[image path goes here]-->
• <!--alt:[alternate text for image]-->

The [ ] and the text inside can be replaced by anything you want. The author tag includes an optional %date placeholder, which will be replaced by the date of the article. It also includes an optional %author placeholder, which replaces this with the name of the user who created the article.

These tags can be used to optionally replace the default information displayed in the module, for example you can specify a different thumbnail image to display using the <!--image:--> tag, and replace the article text using the synopsis tag, giving you great control over the module display.