Install as usual using the Joomla! installer.
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.
The number of articles to display in the module.
The number of articles visible in the scroll window.
The order in which the articles are displayed. The choices are:-
The authoring of the articles allowed. The choices are:-
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, or the K2 content component if this option is selected instead.
Choose whether front page or articles marked as 'featured' (when using Resources and K2) are included in module.
The section(s) from which the articles are selected. Use control-click to select more than one item. This applies when the Joomla content component is used as the content source only.
The category(s) from which the articles are selected. Use control-click to select more than one item. This applies when the Joomla content component is used as the content source only
The articles that you want to select. Use control-click to select more than one item. This applies when the Joomla content component is used as the content source only.
The category(s) from which the articles are selected. Use control-click to select more than one item. This applies when the Mighty Extensions resources component is used as the content source only.
The type(s) from which the articles are selected. Use control-click to select more than one item. This applies when the Mighty Extensions resources component is used as the content source only.
The articles (records) that you want to select.Use control-click to select more than one item. This applies when the Mighty Extensions resources component is used as the content source only.
The fields that you want to select. Use control-click to select more than one item. This is 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.
Image Field Size - Choose the size of K2 image field to use, the default is extra small. If you are using images embedded in the article instead then use the image options below to choose the thumbnail size.
The category(s) from which the articles are selected. Use control-click to select more than one category.
The articles that you want to select. Use control-click to select more than one item.
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 .).
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.
Choices are horizontal and vertical.
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.
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'.
If set to 'yes', the images are clickable.
If set to 'yes', each article includes a clickable 'read more' link.
Choose whether to include a thumbnail image along with the article extract.
The maximum size of the image (in pixels).
Choose whether to display the image to the left or right of the article.
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.
These are the dimensions in pixels of the individual article extract.
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.
Add text here that you wish to display at the head and foot of the module.
This is used mainly to set a common style for modules.
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:-
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.