This tutorial show you how to install Ma2 Slideshow module and configure Ma2 Slideshow free version.
We assume that your site url is http://domain.tld/ and the backend url is http://domain.tld/index.php/admin/.
1. Install Ma2 Slideshow
- After downloaded module package, please extract the compressed package file on your computer.
- Copy or upload all folders (app, skin, js) to your root directory of your Magento store installation. It can be /www or /public_html or /htdocs, etc. (*)
- Login into store backend, flush all cache or disable all cache in System -> Cache Management.
- Logout from backend.
- Login into backend again. The extensions should be installed and you can use it
(*) Please notice that you should rename the design packge and themes folder to match your design package and theme directory name before upload. Please see below example directory structure:
+---app
| +---code
| |
| +---design
| | \---frontend
| | \---default (rename this folder to your design package name)
| | \---default (rename this folder to your design theme name)
| | +---layout
| | +---template
| |
| +---etc
|
\---skin
\---frontend
\---default (rename this folder to your design package name)
\---default (rename this folder to your design theme name)
\---...
2. Configure Ma2 Slideshow Free
After installed module successfully, go to System -> Configuration and find the Ma2 Slideshow Free configuration tab in the left navigation. You can quickly go to there by navigate from main menu MA2 -> Ma2 Slideshow free -> Slideshow Configuration.
Open MA2 Slideshow free configuration page
In General section, you will configure the slideshow to fit your need. After configured, please click Save Config button. See below screenshot and the configuration options for more details.
Ma2 Slideshow Free configuration page
| Configuration option | Values | Default | Description |
|---|---|---|---|
| Slider height (px) | a number | 300 | The height of slider |
| Display title of slide | YES/NO | YES | Choose YES to show the slide's title |
| Display description text of slide | YES/NO | YES | Choose YES to show the slide's description text |
| Auto play | YES/NO | YES | Choose YES, slideshow will auto play when page loaded. |
| Interval (ms) | a number | 3000 | The interval or delay in mili-seconds. |
| Transition type | Slide / Fade | Slide | |
| Transition time (s) | a number | 1.5 | The time of transition to the next slide |
| Manual Transition time (s) | a number | 0.5 | The time of transition to the next slide when user manually click control button (next / previous) or navigation buttons. |
| Navigation | YES/NO | YES | Choose YES to show the navigation buttons |
| Control buttons | YES/NO | YES | Choose YES to show the control buttons (Next / Previous / Play-Pause) |
| Pause on hover | YES/NO | NO | Choose YES to enable pause the slideshow when user hover the mouse over slideshow. This should be NO if you choose to show Control buttons. |
3. Slideshow Management: Create and edit slideshow items
From backend, navigate to Ma2 -> Ma2 Slideshow free -> Manage Items to open Slideshow Items Manager page.
Ma2 Slideshow items manager
From here, you can create new slideshow item or edit the existing one. To create new an item, click Add Item button at the right-top side.
Ma2 Slideshow - create or edit item
4. Create a Slideshow widget to show to the world
Ways to display out a slideshow at frontend:
4.1. Create and display a Ma2 Slideshow widget in a CMS page content
Edit a CMS page, use insert widget button to insert the widget module "Ma2 Slideshow free" and in the Widget Options, please select the slideshow items which you want to show.
4.2. Create a Ma2 Slideshow widget instance to display somewhere
Go to CMS -> Widgets and create a new widget instance from module ( widget type ) "Ma2 Slideshow free".
Add Layout update to specify in which page and at where position the slideshow widget will be displayed.
At Widget Options tab, choose slideshow items which you want to show.
./.
