-
October.18.2013
This guide is intended for Sj K2 Frontpage module
When you buy the module the first time, you will have the latest version. After the first release, we will update this module regularly, then please check newer versions when informed
here.
REQUIREMENTS
Joomla! v2.5.x and Joomla! 3.x latest stable versions are highly recommended.
INSTALLATION
1. Prepare your module package (zip file; please UNZIP first if it is indicated in the file name)
2. All steps are in administrator backend of Joomla!:
- In your Administrator page, go to Extensions -> Extension Manager
In this page, click Choose File, select module package.
- Then click Upload & Install
- Please wait for module being installed, usually within several seconds
SETTINGS
1. This module with sample layout is below:
2. Configuration
NOTE: We used the images of module's installtion on joomla 3.x to illustrate
After installing, go to
Extension -> Module Manager and find
Sj K2 Frontpage to configure
Sj K2 Frontpage module are configured in 5 groups of parameters following:
- Basic Options
- Source Options
- Item Options
- Image Options
- Advanced Options
Let's look at the parameters in detail:
BASIC OPTIONS
- Theme - Allow to select a theme for module
- Open Link - Allow to select open link in the Sample/New/ Popup window.
For theme 3 (only operated when you set theme 3 for module)
- Total columns - Allow to set number of columns for small items
For theme 4 (only operated when you set theme 4 for module)
- Active Item on Load - Select a small items which to be shown at the first time
- Event - Allow to select click or hover to open each small item
- Waiting time - The waiting time for opening each small item when user hover on its title
- Speed of transition - the speed of transition of each small item when it opened
SOURCE OPTIONS
- Source - Select to get data from categories or specific items
From categories:
- Category filter - Allow to choose all or only selected categories
- Select one or more categories - If above choice is "select", you must to select categories that are used in this module
- Fetch items from children categories - Allow to get data from child categories or not
- Item count - Allow to set number of articles which will be displayed in the module. Set value "0" if you want to display all articles.
- Item ordering - Select the item ordering way:
- Default
- Oldest first (by date created)
- Most recent first (by date created)
- Most recent first (by date published)
- Title Alphabetical
- Title Reverse-Alphabetical
- Ordering
- Ordering reverse
- Most popular
- Highest rated
- Most commented
- Latest modified
- Random ordering
- Time Range - Allow to set time range. This is applied when "Item Ordering" = "Most Popular" or "Most Commented"
- Featured Items - Allow to show/hide/show only featured items
Specific items:
Add items - Allow to select items for showing.
You can drag and drop to re-order items. It also allows to remove item by click the remove icon.
ITEM OPTIONS
Large item Options
- Display title - Allow to display title or not
- Title Maxlength - Allow to set the max length of title can be shown (choose 0 to show full title)
- Ending character - Set ending charater when using the truncating the title
- Display Created - Allow to show created date of item or not
- Display Description - Allow to show description OR not
- Description Maxlength - Allow to set the max length of description, set 0 for showing full description
- Ending character - Set ending charater when using the truncating the description
- Tags Display - Allow to display tags for each article OR not
- Display Readmore Link - Allow to show readmore link OR not
- Read More Text - Set text for Readmore link
Small item options:
- Title Maxlength - Allow to set the max length of small item's title can be shown (choose 0 to show full title). This is applied to theme 1, theme 2, theme 3
- Ending character - Set ending charater when using the truncating the title
- Display Created - Allow to show/hide the created date of items
- Display Desciption - Allow to show description or not
- Description Maxlength - Allow to set the max length of description, set 0 for showing full description
- Ending character - Set ending charater when using the truncating the description
- Tags Display - Allow to display tags for each article OR not
IMAGE OPTIONS
Image sources will be got in K2 Item: Click HERE
Get Image From K2 Image
- K2 Image - Allow you to get image from K2 Image Tab OR not
- K2 Image size - Set size for image
Get Image From Inline Introtext
- Inline Introtext - Allow you to get image from Introtext OR not
Get Image From Inline Fulltext
- Inline Fulltext - Allow to get image from Fulltext OR not
Get Image From Extend Folder
- Extend Folder - Allow to extend folder or not
- External Folder - Set path to external image folder used by option above
- Order to Get - Set order: image_intro...,external OR not
- Use Default Image - Allow you to use a placeholder image when entries' image is empty
- Placeholder Path or Url - Allow to set path to placeholder image
Large Image Options
- Resize Mode - Allow you to choose the mode of image resizing
- None
- Center
- Fill
- Fit
- Strech
- Output Format - Allow to set format for all output file:
- Default - if you want to keep original format
- GIF
- JPEG
- PNG
- Keep Transparency - Allow to keep images transparent, for PNG and GIF format
- Width - Allow you to set the width of the image
- Height - Allow you to set the height of the image
- Background - Allow to set the color of image background. This is applied for showing images without full background. If the image with full background, you can see nothing to change
Small Image Options
- Resize Mode - Allow you to choose the mode of image resizing
- None
- Center
- Fill
- Fit
- Strech
- Output Format - Allow to set format for all output file:
- Default - if you want to keep original format
- GIF
- JPEG
- PNG
- Keep Transparency - Allow to keep images transparent, for PNG and GIF format
- Width/Height - Allow you to set the width/height of the image
- Background - Allow to set the color of image background. This is applied for showing images without full background. If the image with full background, you can see nothing to change
ADVANCED OPTIONS
- Alternative Layout - Allow to use a different layout from the supplied module or overrides in the templates
- Module Class Suffix - Allow you to choose another CSS class that suits your template
- Include jQuery - Allow you to include jQuery from this module or another one
- Pre-text - The content to show at the top of module
- Post-text - The content to show at the end of module
- Caching
- Use Global: Turn on caching
- No Caching: Turn off caching
- Cache Times - The time to cache
- Module Tag - Allow to select the HTML Tag for module
- Bootstrap Size - Allow to set the number of columns that module will use.
- Header Tag - Allow to select the HTML Tag for module header/title
- Header Class - Support the CSS Class for module header/title
- Module Style - Select module style
