Professional Documents
Culture Documents
Photoslide Gk3: GA Vickpro
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
INSTRUCTION MANUAL
PHOTOSLIDE GK3
Copyright 2009 GavickPro - http://www.gavick.com This manual cannot be redistributed without permission from GavickPro More info at: http://www.gavick.com
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 PHOTOSLIDE GK3 - Joomla!1.5 Component Instruction Manual 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! Component and home to most high quality and professional templates, components 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
1 Introduction Introduting PhotoSlide GK3 Key Features 2 Special Notice and Recommendations Notices and Recommendations 3 Keep Updated How to keep update 4 Overview Files Overview files 5 Component Installation PhotoSlide GK3 Component Installation 6 Component Configuration Component Administration Panel Overview Component Settings Settings Overview Adding Groups Adding Slides to Groups 7 GK Image Show Module GK Image Show Module Installation GK Image Show Module Configuration Module Parameters and Settings Examples User custom CSS Style Variations Style1 Settings Style1 Settings 7
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 8 9 9 10 - 11 12 13 14 - 15 - 16 17 17 17 - 18 18 - 19 - 20 - 21 -22 - 23 - 24 20 21 22 - 23 24
Adding groups for News Show Pro GK1 Adding image to groups for News Show Pro GK1
25 - 26 26 - 27
PHOTOSLIDE GK3
25
Introducing
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
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
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 link to show us the problem. This way, we will be able to give you the needed help in faster way.
PHOTOSLIDE GK3
Keep Updated
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
PHOTOSLIDE GK3
Overview files
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
Overview files
Download our PhotoSlide GK3 component package, available for free in www.gavick.com. After downloaded, be sure to unpack the file first, before start working on it. Lets get started by showing you a brief overview of the files available inside the PhotoSlide GK3 package, after you unpacked. You will find 3 folders, identified as component, module and doc.
com_gk3_photoslide.zip
This file is the component and must be installed using the Joomla Installer.
mod_gk_image_show.zip
This file is the module that will display on front end your images slides group, set on the component administraton. Use the Joomla installer to install it. Also, in this folder you will find some txt files like style_1_settings.txt and style_2_settings.txt, which contains the default styles settings for styling the module. This settings must be copy into textarea in module options text from the file connected with style which youre using. This will also allow easy style changes and future settings configurations to be added. Another advantage with this method is allowing easy support orientation for any user. Inside the Doc folder:
HelpFilePhotoSlideGK3.pdf
PHOTOSLIDE GK3
This is the present Helpfile that will help and orientate you.
Component
Installation
PHOTOSLIDE GK3
Notice!!! For those who already add experience with older versions of PhotoSlide component, you may notice that there are no plugins to install anymore. Thats because the plugins already were added during the Component installation. So, with this new version, no need to install plugins.
Component
Administration
You are now inside the Component and it will looks like the following screenshot. This is the new administration panel, very different from the previous one. More friendly and with easy navigation.
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
Despite on the Top Menu you will find the same and major options, the Main Menu block will be the most important and the one used. The Main Menu is set by two blocks: What do you want to do? block - Here you can manage by add/edit groups and slides in the most easiest way. Component Settings block - Here you can change component settings, check your system, how to get help and stay updated with the latest GavickPro Team News.
Component Settings
Check System (Very Important!!!)
PHOTOSLIDE GK3
Before start building your images slide groups, its very important to check your system, to insure that all conditions are set properly in joomla database tables and catalog permissions files. So, press Check System button and a modalbox (popup) will open, displaying the tables status of the component created on your database. If they exist, you should see on the right side the work Yes with green color. If not, you will see No in red color.
10
Files Permissions:
In the catalog files, if permissions are identified with red color, that means you must change permissions on those directories to enable writing permissions. You can use a FTP manager file to do this operation or directly from your joomla aplication, using specific extensions available for free on joomla.org. If you are unable to change them, them we recommend contact with your hosting server provider.
Database Tables:
In the case of database tables, that means your database does not have the necessary tables created on your joomla database. To fix this problem, you might try to uninstall the component and install again or you can add manually this tables, using the MyPhpAdmin available on your Cpanel Website. For this process, you can ask support in our forum if necessary.
GD Library information:
GD is an open source code library for the dynamic creation of images by programmers. GD is written in C, and wrappers are available for PHP and other languages. GD creates PNG, JPEG and GIF images, among other formats. The existing of this PHP module on your server is essential for the PhotoSlide and here, on the Check System panel, you can see if is enable, which version and if supports PNG image format. If you dont have this conditions, please contact your Host Server Provider. In the Check System report, you can also check if theres any updated version of the component, so you can update as soon as possible. Try it by pressing the Check for updates button.
PHOTOSLIDE GK3
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
Settings Overview
By pressing the Settings button, a new modalbox will open with the component features. Here you can disable some of the component features and set them according to your preferences.
The Modalbox effect is a new extension added to the component, a nice and very useful popup window that is available by default in the component administration. This extension provides you the possibility to manage your groups and slides more easier, like you will notice. If you prefer to work without it, using the normal page display, disable this option on Modalbox for GavickPro news and also on Modalbox for settings. You can also enable/disable the use of shortcuts links in groups and slides manager.
One of the new feature of the Component is the possibility to use an integrated WYSIWYG editor to create your custom content on slide text display. If you wish, you can disable it and use the normal text area. The colorpickers extensions is a nice tools that will allow you to pick easily your hex color code for stylize your slide. Finally, you can disable the display of GavickPro news if you dont want for some reason.
PHOTOSLIDE GK3
12
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
Group name: Add your slide group name. This is the name for identification on both component and module. Group description: Set your own group description. Select group type: Select your group type for Image Show module aplication or for News Show Pro GK1 interaction (this will be explained later). Image width: Set your main image width in pixels. Image height: Set your main image height in pixels.
Thumbnails width: Set your thumbnail width in pixels. Thumbnails height: Set your thumbnail height in pixels. Background: Set your background color using hex color code (example: #000000). Image quality:
PHOTOSLIDE GK3
Very important! This field allow you to determine the image quality on main block image display and thumbnails. These are generated images from PhotoSlide. If using many images in the slide show, the loading of the page will increase to unwanted values and your website will look too much slow. So, this is very important to fix this problem and without loosing too much image quality, you can keep fast loading pages by decreasing image quality.
13
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
After you set all the parameters of the group, this will be the result as the following screenshot.
PHOTOSLIDE GK3
Select the group from the Modalbox (since you have only one, this will be your only choice) and press Choose group button. You are now in add slide page configuration.
14
Link Type: Set if you want your own link or the direct link to an existent article.
Search and choose your original image on your computer to Link: upload. If you choose previously your own link type, set it here (ex. http://mylink.com). Access: This option determines the level of access for viewing. Title: Create the title you want to show on front end of the slide. Text: Take advantage of WYSIWYG editor to create your own text or other rich content to be displayed on text block. This is only used if you want to use your own content, besides the article text. If not filled and if the slide is set to article, the text block will display limit text content of article. Article: If you choose an article link, select here. If not leave it on Own article. Style: If you have an image smaller or bigger from the group configuration, choose Stretch image and this will automatically adjust image dimensions. This option may withdraw some quality image, we do recommend exact original dimensions and in this case set Dont strech image or if bigger, make it with same proportional dimension and set Stretch image option. You will get better results with this two suggestions.
PHOTOSLIDE GK3
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
We set 3 slides on the group as an example, so this will be the final view of the group content. Here you can edit directly the slide by clicking on the respective name of the slide (by editing you cannot change the image. If you need to change image, you need to add another one) and also, you have the following options.
Remove: You can easily remove any slide by just clicking on the X cross. Source Image: By clicking it, you can see in a modalbox the original image. Published: You can easily publish or unpublish the slide.
Access: Change the access level of the respetive slide. Click it the time needed to change it to your desired level. Order: Change your own order of slide display.
All this options are easy links to edit your slides, but you can also change them by clicking on the slide listed on name column and enter on the respective edit page.
PHOTOSLIDE GK3
Now that our group has been created, we want to see the result on frontpage. So we follow to the next stage, where we will install and configurate the Image Show module.
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
Next, you will see in detail all modules parameters and advanced parameters that you will need to edit. After all parameters configurations, set the module in the position that you want to display on your page and also set the Menu Assignment and enable it.
PHOTOSLIDE GK3
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
For those who have had past experiences with older versions of PhotoSlide, you will notice a big difference on the modules parameters. In this new version, the main amount of settings are placed inside the settings text area, like you can notice on the module page. By default, the settings are from style1 configuration and if you publish the module immediatly, this will be the result on frontpage.
Starting from the begging of the module parameters, you will have the following options:
Module Parameters:
Module Class Suffix: Suffix can be applied from the css class of the module (table. moduletable) an this will allow individual module CSS style. Module Unique ID: Unique ID for module (must be unique if you have two or more modules on one page) (i.e. newsimage1 or newsimage2). Slide group: Set the group with slides to display on the module (if the list is blank that means there no group created on the component Photoslide GK3) Module Style: Select type style for your module. There are 3 options to be set as follow:
PHOTOSLIDE GK3
18
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
Image with thumbnails block: This mode is be effected directly from the text area settings parameters content and will allow to use style variations easily. The basic settings are available on the text files style_1_settings.txt and style_2_settings.txt, located on the package inside the module folder. If you wish to use style 2 settings, you need to copy and replace the existing parameters on the text area settings. These are the main styles settings provided with the package. In the future, GavickPro Team will release more style settings to be added. The process of updating will be very simple, by just uploading via FTP the respetives new files and by providing the respective settings text to be copy into the settings text area: Style 1 Settings: thumbs_margin=0 5px 20px 0; thumbs_padding=3px; thumbs_border=; thumbs_border_width=1; thumbs_rows=3; thumbs_cols=1; thumbs_position=right; thumbs_tooltips=true; image_margin=0 20px 0 0; image_padding=0 0 0 0; image_border=; image_border_width=0; show_text_block=true; text_block_height=100; text_block_bgimage=false; text_block_bgcolor=#555; text_block_opacity=0.65; text_block_position=bottom; clean_xhtml=true; readmore_button=true; title=true; wordcount=30; title_link=true; readmore_text=See details; slide_links=true; preloading=true; animation_speed=500; animation_interval=5000; autoanimation=true; animation_type=opacity; Style 2 Settings: image_margin=0 0 0 0; image_padding=0 0 0 0; image_border=; image_border_width=0; slide_links=true; preloading=true; overlay=true; overlay_speed=250; overlay_opacity=0.75; animation_speed=500; animation_interval=5000; autoanimation=true; animation_type=opacity;
PHOTOSLIDE GK3
19
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
PHOTOSLIDE GK3
20
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
In resume, there are 2 styles settings available, with their respective engines scripts and 2 style variations for style1 settings and 1 style variation for style2 settings. Besides some changes or adjustments that can be done on the style settings, like the previous versions of News Image modules parameters, each user can also create his own css style variations. How can this be done? Ok, so lets imagine that we are working with style1 settings and we want to create our own style variation for this style. So, lets go to .. /modules/mod_gk_image_show/css/style1/ and you will the following files: index.html style1.css style2.css Now, copy the style1.css file and rename it to, for example, style3.css and make your own changes. I will make some small color changes on this file, write on the Style variation field style3 and lets see the result.
Notice that this style css variations files have some images related. So, if you look to their path, you will conclude that you can create your own images on the style3.css variations. So, go to ../modules/mod_gk_image_show/images/style1/ and create, for example ../modules/mod_gk_image_show/images/style1/variation3/ directory. Naturally, on style3.css file the paths must be related to here. The following diagrama show basic struture of each style setting, styles variations and their relationship.
PHOTOSLIDE GK3
21
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
Image Rotator: This mode offers you a very nice image rotator effect to display your images set on the PhotoSlide GK3 group, without thumbnails blockm but with a nice hover image effect. Template Style: If your template has built-in styles then please select template style. This means that by selecting this option mode, the module will work with css styles built-in on the CSS template files.
Style variation:
Like explain previously, select style variation for module - it is a CSS filename without extension.
Settings:
Returning to the style settings of each style, lets take a overview of each one. This text is a list of settings always with the same struture: OPTION = VALUE
Style1 Settings
thumbs_position=right; thumbs_margin=0 5px 20px 0; Margin of thumbnails [in px] thumbs_padding=3px; Thumbnails padding [in px] thumbs_border=; Thumbnails border style [example: solid, dashed, dotted] image_padding=0 0 0 0; thumbs_border_width=1; Thumbnails border width [without px].
PHOTOSLIDE GK3
Thumbnails bottom]
block
position
[right,
left
or
thumbs_tooltips=true; Display tumbnails toolstips? [true or false] image_margin=0 20px 0 0; Margin of slide images on main block [in px].
thumbs_rows=3; Amount of rows in thumbnails block. thumbs_cols=1; Amount of columns in thumbnails block.
Image border style [example: solid, dashed, dotted] image_border_width=0; Images border width [without px].
22
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
show_text_block=true; Display text block? [true or false] text_block_height=100; Text block height value [without px] text_block_bgimage=false; Show text block background image? [true or false] text_block_bgcolor=#555; Set background color in hex value. text_block_opacity=0.65; Set text block background opacity (values from 0.00 to 1.00). text_block_position=bottom; Set text block position [bottom or top]. clean_xhtml=true; You can clean your articles from any formatting [true or false]. readmore_button=true; Display read more buttom? [true or false]. title=true; Display text title? [true or false]. wordcount=30; Set amount of words from article content.
title_link=true; Enable link on title? [true or false] readmore_text=See details; Set your own read more text. slide_links=true; Enable slides as links? [true or false] preloading=true; Enable preloading of slides [true or false] animation_speed=500; Speed for animation effect of the slides (example: 1000 = 1 second). animation_interval=5000; Interval beetween slides (example: 5000 = 5 seconds). autoanimation=true; Enable auto animation on slides? [true or false] animation_type=opacity; Slide animation type [opacity, top, left, right or bottom].
PHOTOSLIDE GK3
23
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
Style2 Settings
image_margin=0 0 0 0; Margin of slide images on main block [in px]. image_padding=0 0 0 0; Images padding on main block. image_border=; Image border style [example: solid, dashed, dotted] image_border_width=0; Images border width [without px] slide_links=true; Enable slides as links? [true or false] preloading=true; Enable preloading of slides [true or false] overlay=true; Enable overlay effect? [true or false] overlay_speed=250; Set overlay speed in integer value. overlay_opacity=0.75; Set overlay opacity (values from 0.00 to 1.00). animation_speed=500; Speed for animation effect of the slides (example: 1000 = 1 second). animation_interval=5000; Interval beetween slides (example: 5000 = 5 seconds). autoanimation=true; Enable auto animation on slides? [true or false] animation_type=opacity; Slide animation type [opacity, top, left, right or bottom].
Use MooTools:
PHOTOSLIDE GK3
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.
24
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
Again, for those who already experience previous versions of PhotoSlide component, you might remember that you needed to install the respective plugin on the PhotoSlide to create specific group images to display on News Show Pro GK1 module. Now, in this new version of PhotoSlide its not necessary anymore, because this is already installed by default, like you might notice while creating a group, where you need to determine which type of group you select.
So Why should you create images groups on PhotoSlide GK3 for News Show Pro module ?
This can be essential to optimize the cache loading time of your website, in case you need to use large amount of module and number of article with image display. Basically, we means is that by default the News Show Pro will display a resized image from joomla content and not create (for know) real thumbnails with smaller weight. 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 you page loading and also, gives you another important tool to stylish differently your front end articles announcements.
Group name: Add your slide group name. This is the name for identification on the component. Group description: Set your own group description. Select group type: Select group type News Show Pro GK1. Image width: Set image width in pixels.
Image height: Set image height in pixels. Background: Set your background color using hex color code (example: #000000). Image quality:
Set the image quality for this group type. Again, this may be a very important option for loading optimization, but since you are using this option for using on News Show Pro Gk1 module, this feature may not be too much important because its assumed that you will used to decrease weight image or in other words, create thumbnails for image article display. PHOTOSLIDE GK3
25
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
After set all the parameters of the group, save it. Now, you have to group created on the PhotoSlide GK3.
Set the following fields: Name: Set name of the image. Image: Select your image for upload.
PHOTOSLIDE GK3
Image height: Set image height in pixels if differente from the group setting. If not, leave it to 0. Article: Select the corresponding article. Style:
Stretch or do not strech image option.
Access: Select group type News Show Pro GK1. Image width: Set image width in pixels if differente from the group setting. If not, leave it to 0.
26
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
After you add all your images on the group, go to the News Show Pro GK1 module and enable the following parameters on the module:
Plugin Support: You must enable this if you want to display the images created on the PhotoSlide GK3, related to the respective articles. Naturally, in the News Show Pro GK1 module configuration, section and category of news must include the added articles on the group. For those articles that are not set on the group, the images displayed are the ones from the article content. USe only plugin images: Like the parameter title indicates, by enable this option only images set on PhotoSlide group will be displayed. For those articles not related to the group, no image will be showed.
NOTICE!
For further informations about the News Show Pro GK1 module, please read the respetive HelpFile available on the respective package.
PHOTOSLIDE GK3
27