Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
INSTRUCTION MANUAL
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
COPYRIGHT DISCLAIMER GavickPro NEWS SHOW PRO GK1 - Joomla!1.5 Module Instruction Manual - version News Show Pro GK1 v.1.2.0 Copyright 2009 GavickPro - http://www.gavick.com This manual cannot be redistributed without permission from GavickPro More info at: http://www.gavick.com Author: Paulo Seichinha - GavickPro FOR INFO, UPDATES, REQUESTS & CONTACT Check out Gavick.com, the official website of this Joomla! Module and home to high quality and professional templates, componen-ts and modules. Keep updated about all templates, components and modules by visiting our update.gavick.com Copyright 2009 GavickPro - http://www.gavick.com
Table of Contents
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
4 4 4 5 5 6 6 7 7 8 9 - 10 - 11 - 12 13 13 14 14 14 - 1 5 - 16 - 17 - 18 18 19 19
News Show Pro GK1 Installation News Show Pro GK1 Installation
News Show Pro GK1 Configuration Module Parameters Module Advanced parameters News Show Pro GK1 Thumbnails Generation
Integration with PhotoSlide GK3 Plugin Some considerations for News Show Pro use plugin How to create group on PhotoSlide Gk3 for News Pro GK1 News Show Pro plugin for PhotoSlide GK2
Examples screenshots
20
19
Introducing
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
Here are some recommendations that you should considerate and might help you.
What is the better way for me to place a problem in the support forum?
If you need help in some issue, please post it in our forum support in the most objective way, preference in english language and with an URL to show us the problem. This way, we will be able to give you the needed help in faster way.
Overview files
The first step to start working with our free Joomla !1.5 module is downloading the News Show Pro GK1 package, available on our free download extension section. The installation is quite simple and it should not be a problem, if you follow correctly this instrutions.
Overview files
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
IMPORTANT!!! Be sure to unpack the file first, before start working on it.
After the download is done, you need to unpack the news_show_pro_ gk1_pack.zip file. Lets get started by showing a brief overview of the files available inside the News Show Pro GK1 pack.
doc!!!
Contains the present HelpFile document.
Installation
GA GA VICKPRO VICKPRO
C R E A T IIV E JJO O M L A !! D E V E LO P M E N T S T U D IIO C R E A T V E O O M L A D E V E LO P M E N T S T U D O
Now that the News Show Pro GK1 is available on your Modules Manager, lets take a look inside of the module configuration and see whats able to do.
Configuration
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
Find the News Show Pro GK1 module on the available list and click on it to edit the module configuration.
Inside, you will be able to configurate the different parameters that will allow to select to articles to display on the module and also to style its content.
NEWS SHOW PRO GK1
Start by selecting on the details panel (on left side) the option to enable the module, set it on the desired module position on your template and also, set menu assignment to determine the pages were the module will be show. Next, lets get to the right side of this page, were you find all the module parameters. We will explain in detail each of the parameters available.
MODULE PARAMETERS
Module parameters:
Configurate the following parameters fields. Module Class Suffix: A suffix to be applied to the css class of the module (table. moduletable), this allows individual module styling. Module unique ID: Unique ID for module (must be unique if you have two or more modules on one page) (i.e. newspro1). Main block width: The width of main articles block. It must be always integer value (in pixels) (i.e. 400). Links block width: The width of links block. It must be always integer value (in pixels) (i.e. 300). Table cell padding: Set padding for table cells. Add px or % suffix ! (i.e. 3px). Section: Section which will be source of news headings. Category: Category which will be source of news headings. Sections: Sections which will be source of news. IDs separated by comma.... (i.e. 2,5). Categories: Categories which will be source of news. IDs separated by comma... (i.e. 3,5)
NEWS SHOW PRO GK1
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
MODULE PARAMETERS
IDs: IDs of news, separated by comma... (i.e. 3,5) Module mode: In category mode links are connected with main articles. Main articles and links have always one page (amount of pages depends on amount of categories). In category mode field IDs will not work ! Amount of articles pages: Max. amount of articles pages. (it works only in standard mode). Amount of links pages: Max. amount of links pages. (it works only in standard mode). Amount of columns: The amount of columns in one table with main articles (columns per page)... Amount of rows: The amount of rows in one table with main articles (rows per page)... Links amount: Amount of links per page (in category mode - amount of links per one category). News sort value:
NEWS SHOW PRO GK1
Show unauthorize links: If you want to show all articles without getting informations about user permissions. Show only frontpage articles: Enable this option if you want to show only frontpage links. Number of first news: It is usable when you need articles in tabmods - you can show first 5 news from categor and in other instance you can show next 5 articles (then set this option as 5). Show list with links: Enable it if you want to show list with links. Select position of list with links: Set list links to bottom, float left or right position. Show category name: Enable it to display category name on category mode. Readmore: News readmore button text. News header - link: News image - link: News text - link: Logical values to display respective links from elements.
Value to sort in database by Date, Title, Order, Random, Frontpage order or Hits. News sort order: Order of sort in database by asceding or descending. Showing frontpage articles: Enable it if you want to show frontpage articles.
news author: news categories: news date: news hits: More in text:
Logical values to display news information elements.odule. Date format: All special chars will be replaced: D-full day name, s-short
10
MODULE PARAMETERS
day name, d - day (number without 0 prefix), z - day (number with 0 prefix), M - full month name, S - short month name, m - month (number without 0 prefix), Z - month (number with 0 prefix), Y year, H - hour in 24h format, h - hour in 12h format.
News Date: Select creating or publishing date of news. Author name: Options by Name, Username or Alias.
News News News News News content content content content content header position: image position: text position: info position: readmore position:
With the previous fields you can set styling positions of different elements.
News News News News content content content content header order: image order: text order: info order:
The previous fields represent the news content order elements that are set graphically by checking each radio buttons with diferent values. This will set the order of display.
nofollow nofollow nofollow nofollow nofollow nofollow in in in in in in head links: image links: text links: info links: list links: readmore links:
News text limit type: Set here the text limit type, by words or characters to be displayed on main block. Maximal amout of words or characters: Value of words or characters to be display for each news. Maximal amount of characters in title: Set value of characters to be display in the news title.
NEWS SHOW PRO GK1
11
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
MODULE PARAMETERS
Max. amount of chars in list element title: Set value of characters to be display in the list links title. Max. amount of chars in list element text: Set value of characters to be display in the list links text. Show description in list: Enable this option if you want to display description on link list. Clean (X)HTML in content: If you load part of news content then we recommend to turn ON this option. Plugin support: If you want to use images (for example, as thumbnails) from groups build on Photoslide. Enable ONLY if you have installed Photoslide GK3 Component (see respective chapter). Use only plugin images: If you want to use only images from Photoslide GK3 group and not from articles. Use default image: You can use default image from group to be displayed on every articles without images on their content. Create Thumbnails:
NEWS SHOW PRO GK1
News image width: Set width value of the image. Add px or % suffix ! (example 100px). If you leave this value as 0, the original image width will be assumed. News image margin: The margin of the news image. Add px or % suffix ! (i.e. 3px or 0 3px). The first example, you will provide full sides margin. The second one, you will atribute margin only for left and right side of image. Thumbnails background: Set background color in hex value for generated thumbnails (i.e.) #FFFFFF. Thumbnails stretch: Enable if you want to generated thumbnails stretching according to images dimensions set on the module. Thumbs quality: Set generated thumbnails quality in percentage (i.e.) 95%. Cache time: Set cache time for thumbnails in minutes. 0 value means no cache. Autoanimation: Enable this option if you want autoanimation in main block articles. Animation speed: Specify animation speed in ms. (i.e 500). Animation interval: Specify time animation interval in ms. (i.e. 5000).
Enable if you want to generate thumbnails from the article image. This option will reduze substancialy page time loading. Very Important! Please insure rewrite permissions on cache folder on module directory. News image height: Set height value of the image. Add px or % suffix ! (example 100px). If you leave this value as 0, the original image height will be assumed.
12
Parse plugins:
If you want to enable parsing plugins in article content - please enable this option.
Use script:
Now modules support new technique of assets JavaScripts files. In other situations option automatic is strongly recommended. Use this option only if you have a problem with scripts on your site. If you want to run more than one copy of this module on one page then set this value for disabled.
Most important information that you should have in considerate, if you have any problem of thumbnails generation, you need to insure that cache directory on module have rewrite permissions or otherwise, you probably will have problems with this. So, if this is the case, use your FTP software to access your files and change permissions to 755. Joomla!1.5.12 Users - This version of Joomla brings a bug on moving files system. So, its strongly recommended that you update your joomla to the latest version, or otherwise you also will have problems with this feature.
13
Those are the parameters available for the module configuration. Most important ones are section, category or articles IDs identification for content display, the unique module ID and the use of script or mootools on advanced parameters. All the rest are also important also, even those for styling design, but as long as you make some pratice and gain some experience, all the configuration process will become very easy to understand. Our team will release video tutorials were we will show some examples of configurations possibles. Keep in touch by making regular visits on http://tools.gavick.com/demo or http://blog. gavick.com. Anyway, if you have any doubts, please feel free to ask support on our official forum. Next, we will explain in detail how to use on PhotoSlide GK3 the special plugin support for News Show Pro GK1 module.
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
Notice! There no need to install any plugin on PhotoSlide GK3 version, since interface is already installed by default on the component.
So, navigate to Components > Gavick ProtoSlide GK3 and click on Add Group button:
14
H
Set the following parameters of the group and save it. Group name:
Set you group ID by providing a name.
Image height:
Set height value for image in px.
Group description:
Give description of the group.
Background:
Set background color for image display in hex code (i.e. #FFFFFF).
Image width:
Set width value for image in px.
The News Show Pro GK1 group built on PhotoSlide GK3 is done. Now, you need to add slide content on it. So, press on the group name News Show Pro.
15
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
Start by adding your first slide by clicking on Add Slide button, set the following parameters and save.
Name:
Give name ID for your image.
Image height:
Set height of image, if you want to display with different dimensions set on the group configuration by default. If not, leave it with 0 value.
Image:
Patch you image for uploading .
Access:
You can set special access for User level display on each image.
Article:
Select the article for image display.
Style:
If your source image have different dimensions from the group configuration, recommend stretch option, for size automatic Set width of image, if you want to display with different dimensions adjustment. set on the group configuration by default. If not, leave it with 0 value.
Image width:
WARNING!!! It is very important to have set ONLY one image in Photoslide connected with one article - if you set more images connected to same article, most probally will cause some problems. The only exception is when is created with diferent level access.
After you build your News Show Pro GK1 group on PhotoSlide GK3, now its time to see how we can display on the module. So, navigate to Extensions > Module Manager > News Pro GK1 and click on it.
16
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
Remember the module parameters chapter? So, how do we display those images added on the PhotoSlide GK3 group? Naturally, you need to configurate your module in way to display the article that you select on the group to have images from PhotoSlide. After this is done, go to Plugin Support parameter and select Enable option.
Save the module configuration and lets see the result on front page. As you know the native Jooma Newsflash 1 article from basic installation doesnt have any image. Now, as you can see on the screenshot, there the one that we add on the PhotoSlide GK3 group..
NEWS SHOW PRO GK1
17
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
Simple, isnt it? Lets test the different image dimension feature. So, i return to the PhotoSlide GK3 group for News Pro GK1 and i will add another image with different dimensions front the group.
And there you have it. The Newsflash 2 article have now its own image on PhotoSlide with a different dimensions set by default on the group. So, this feature gives you a great control for styling your News Show Pro GK1 content display.
For some reason, if you need to use the News Show Pro GK1 plugin on the previous version of PhotoSlide GK2, you will need to install the plugin on the component to have available this feature. So, see the respetive HelpFile of PhotoSlide GK2 version and you will see how to install the respective plugin. Important! The Plugin must be installed using the PhotoSlide GK2 plugin installer. Do not use the Joomla Installer.
NEWS SHOW PRO GK1
Even if you have need to use the PhotoSlide GK2 version, for example, because you like some specific News Image module style that is not available on PhotoSlide GK3 version, you can have both component installed on your Joomla Website. Please, request this plugin on our forum support.
18
Module Variations
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
Modules Variations
Theres 2 module variations styles for News Show Pro GK1 module. The following screenshot were picked from our MusicTube Joomla Template and you can see them working on http://demo.gavick.com and also http://tools.gavick.com/demo
On the right screenshoot, you see an example with main block news display on the left and the list block set on the right side. Module variation: If you leave blank the Module Class Suffix field, this will be the style that you will get (lite version).
In this next screenshoot, you can see the same module, but with different variation style. Module variation: If you set [space]dark the Module Class Suffix field, this will be the style that you will get (dark version). Important! Please, leave a space before dark word, like [space]dark.
NEWS SHOW PRO GK1
19
Examples
GA VICKPRO
C R E A T I V E J O O M L A ! D E V E LO P M E N T S T U D I O
Block list is set in the left position and the main block on the right.
You can also only display the only main block, with 4 news on each slide page.
Module with main block on top and block list at the bottom.
20