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

NEWS SHOW PRO GK1

Copyright 2009 GavickPro - http://www.gavick.com This manual cannot be redistributed without permission from GavickPro More info at: http://www.gavick.com

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

Introduction Introduting News Show Pro GK1 module Key Features

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

Notices and Recommendations Notices and Recommendations

Overview files Overview files

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

Modules Variations Modules variations

Examples screenshots

20

NEWS SHOW PRO GK1

News Show Pro Examples

19

Introducing

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

How to impress? Heres a hint. Just be a Pro!

Congratulations!!! You just found another amazing Joomla!1.5 extension. From probably the most powerful tool of exposure news, articles and content in Joomla, and without any doubt one of the most popular, acclaimed and sucessfull extension ever created, the Gavick News Show module is now a team. So, give welcome to the new News Show Pro GK1 module, ready to impress even more your website visitors. Especially for you, another gift from GavickPro. Now, you have two perfect partners, ready to help you achieve the more demanding standard of presentation, that all successful sites require. And guess what? Its free! How about that?!... You dont believe it!?... Well... So, its not free...but we will give you 100% discount! What? You want more?! Get it know on tools.gavick.com.

An overview of News Show Pro GK1 module key features:

Joomla!1.5 Native Content control display from any section, category or articles IDs Left, right or bottom selection position of articles list with links. Horizontal and vertical news presentation (columns and rows configuration). Slide tabs pages on main block and list link block display. Show text, image, author, date, section/category name and button read more option, with customizable order. Display News author, categories, date, hits and more in on article info. Images display by resize dimension from article, with images generated using PhotoSlide Plugin or automatic creation of thumbnails with image quality control (Important! Please be sure that cache directory is rewriteable) News content sorted by date, order, frontpage, random, hits or title. Standard or Category module mode options. Use of multiple modules on same page with unique ID module configuration. Date format and native language of month/days customization. Easy native user language translation support on file. Native partnership with PhotoSlide GK3 plugin. On/Off front page articles display in modules. Nofollow and target atribute options to links. Clean (X)HTML in content. Module or Template built-in CSS styles. Easy and friendly administration. SEF URLs. Used Javascript Framework: Mootools 1.11 Option of compressed JS engine. Fully compatible: Firefox, IE7+, Opera 9.5, Safari, Netscape, Google Chrome, Camino, Flock 0.7+. XHTML & CSS Validation: W3C XHTML 1.0 Transitional. W3C CSS Valid.

NEWS SHOW PRO GK1

Notices and Recommendations

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.

Do you have some problems with our tools?

Some usual problems reported on our support forum are originated from script conflict with 3th party tools. If you know Joomla suficient enough, you already know that there is a huge amount of solutions and extensions available for free or some commercial from other team or developers. Naturally, you will search others extension to complete some particular funcionality and your website needs, but understand that we are responsable only for our templates and tools; and we cannot garantee that all 3th party extensions will work perfectly along with our tools. So, it is your hands and it is your responsabity to choose those extensions on Joomla Comunity. Anyway, you always can ask for support in our forum and if is possible, we will try to help you. Another usual problem reported in our forum, is related with permissons on files and directory. Some tools need that some specific files are set with rewrite or read permissions, so you can find some problems if you dont have this permissions set. Take note that we cannot control your server security configuration, but we can point you directions were you must change this permissions. If you are unable to change it, we recommend that you contact your host server provider.

Keep always updated!

We strongly recommend that you visit us regularly on update.gavick.com, were you can see the latest updates of our templates, components, plugins and modules. If you have any problem, be sure the solution is not already available and you will avoid waste time searching or asking for solutions in our forum support.

Need some small CSS style customizations adjustments?

You can always request some support from our Moderators or Developers, but you need to take in mind that this is customization and not regular support service. We are considerating in the future to create personnal customization and installation services support for those who need it. Nevertheless, we will always available to try to help you. If you have some experience in CSS styling, we strongly recommend the use one of the most powerful tool for WebDesigners, available for free in FireFox browser - The FireBug addon - a perfect ally and work tool.

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.

Need to contact Us?

Besides our official forum support, you can also contact us by Skype. Please check our contact page and we will reply to you as soon as posible.

NEWS SHOW PRO GK1

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.

mod_news_pro_gk1.zip (Installation: use the Joomla

Installer). This file is the module and must be installed using the Joomla Installer.

doc!!!
Contains the present HelpFile document.

NEWS SHOW PRO GK1

News Show Pro GK1

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

News Show Pro GK1 Installation

Using your Joomla! Administrator, navigate to the administrative panel on your website. From the top menu, select Extensions > Install/Uninstall Click the browse button, select the mod_news_pro_gk1.zip file and press Upload File & Install. If all goes well, a message will appear saying Upload Module - Success

After installation is set, it will display an overview of the module.

NEWS SHOW PRO GK1

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.

News Show Pro GK1 configuration

From the top menu, navigate to select Extensions > Module Manager, find the News Show Pro GK1 module on the available list and click on it to edit configuration.

News Show Pro GK1

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

GAJ O O M L A ! D E V E LO P M E N T S T U D I O VICKPRO CREATIVE

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:

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.

Show Show Show Show Show

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

GAJ O O M L A ! D E V E LO P M E N T S T U D I O VICKPRO CREATIVE

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

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

Logical values to enable nofollow atribute on respective links elements.

target target target target target target in in in in in in head links: image links: text links: info links: list links: readmore links:

Select target _seft or _blank to respestive links elements.

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.

Module advanced parameters:

12

MODULE ADVANCED PARAMETERS

GA VICKPRO GAJ O O M L A ! D E V E LO P M E N T S T U D I O VICKPRO CREATIVE

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 advanced parameters:

Use Mootools:
Now modules support new technique of assets JavaScripts files. Use this option only if you have a problem with scripts on your site. In other situations option automatic is strongly recommended. If you want to run more than one copy of this module on one page then set this value for disabled. Also if you have an mootools framework in version 1.11 included on your site then disable this option.

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.

Clean plugins code:

Enable this option if you want to clean all {plugin} texts from article content. IMPORTANT! This option can cause problems with encoding.

Use compressed engine:

To minimalize filesize you can use compressed version of engine, but for debugging you should use uncompressed version of engine script (then disable this option). Additionaly - when you use more than one copy of this module per one page then you must set this same value of this option for all instances of module.

Use module CSS:

Disable this option when you are using template with built-in styles for this module.

News Show Pro GK1 Thumbnails generation

This is a new feature added on this version and its on experimental stage. Most probably, it will be considerated stable on next version of News Show Pro GK1 - 1.3.0, along with new possible features to be added.
NEWS SHOW PRO GK1

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.

Integration with PhotoSlide GK3

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

Using News Show Pro plugin on PhotoSlide GK3

Some considerations for Image display using the plugin for the PhotoSlide
Like the thumbnails feature, the plugin can be essential to optimize the cache loading time of your internet page, in case you need to use large amount of module and number of article with image display. By using this tool, you can display a different and smaller image by creating a specific group on PhotoSlide GK3 with each image related to respective article. So, with this tool you will be able to speed up the page loading, but also gives another important option to stylish differently your front end articles announcements. The News Show Pro plugin allows you to create different images dimensions for each image. So besides the main group image dimension, on each slide added on the group, you can change the values for that specific image. Naturally, you need to have support enable on the module parameters and leave the dimensions fields on the module with 0 value, to avoid overrule dimensions. Also, when you enable the plugin support, with the respective list of news configurated to be display on the module, some mixed with those set on the PhotoSlide group, if you leave width and height 0 values, the ones not selected on PhotoSlide will display the first image of the article with default image size.

How to create group on PhotoSlide for News Show Pro GK1

Naturally, PhotoSlide GK3 component is needed and if you dont have it, you can get it on our free download section on gavick.com. Since PhotoSlide GK3 component have is own HelpFile, we will only provide orietation to create the group.
NEWS SHOW PRO GK1

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

NEWS PRO GK1 PLUGIN

GA VICKPRO GAJ O O M L A ! D E V E LO P M E N T S T U D I O VICKPRO CREATIVE

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

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).

Select group type:

Most Important! Here you must be sure to select from the drop down Image quality: list the Group for News Show Pro GK1 ... type. You can control image quality in percentage (Recommended 95%).

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.

NEWS SHOW PRO GK1

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

NEWS PRO GK1 PLUGIN

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:

NEWS SHOW PRO GK1

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

NEWS PRO GK1 PLUGIN

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

NEWS PRO GK1 PLUGIN

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.

News Pho GK1 plugin on PhotoSlide GK2 version.

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.

Or you can just set only display the block list.

NEWS SHOW PRO GK1

20