Check out the Latest Articles:

Documentation

By admin

osCommerce Flash Carousel 3.0.1 Documentation (Updated: 13.01.2009)

Quick Demo
For osCommerce Store Demo, Click Here.

Download Files
You can download new version of osCommerce Flash Carousel at http://addons.oscommerce.com/info/6123 with title osCommerce Flash Carousel 3.0.

Download Flash Source Files (fla)
You need to be sign up in order to download sources.
osCommerce Flash Carousel 3.0 Fla Sources (1214)

Installation osCommerce Flash Carousel 3.0.1

Upgrade osCommerce Flash Carousel 3.0.1 from osCommerce Flash Carousel3.0

Usage

Audience

This guide is intended for osCommerce store owner who want to use osCommerce Flash Carousel to deliver selected products to the customers.

Required Knowledge

In order to install osCommerce Flash Carousel you need to edit some files. If you have unmodified store you can easily install it. If you have modified store and don’t know code editing you can buy installation service.

Requirement

You need to have osCommerce Online Merchant v2.2 RC2.

What is osCommerce Flash Carousel?

This intruction to osCommerce Flash Carousel is intended to give you summary of this addon.
osCommerce Flash Carousel is an addon for serve products with fashionable flash styles. It makes you to deliver your selected products to your customers with an attractive way.
osCommere Flash Carousel delivers your selected products, which were selected at your store managemant panel, not only at main page but also all categories page.
More powerful, more configurable…

Installation

Step 1:
Before you begin please backup all your store files and database.

Step 2:
Copy all files and folders from new_files folder to your store. You can use the FTP to transfer all files and folders to your server.

Step 3:
If your store is new and you have not made any modifications, please copy all files from modified_files to your store. Then go to the Step 14. If your store is modified please follow the manual edits from Step 4.

Step 4:
Add the following lines to /catalog/admin/includes/filenames.php

?View Code PHP
1

define('FILENAME_FLASH_CAROUSEL', 'flash_carousel.php');

Step 5:
Add the following line to /catalog/admin/includes/database_tables.php

?View Code PHP
1

define('TABLE_FLASH_CAROUSEL', 'flash_carousel');

Step 6:
Edit the file /catalog/admin/includes/boxes/catalog.php
Find below code:

?View Code PHP
1

'<a href="' . tep_href_link(FILENAME_PRODUCTS_EXPECTED, '', 'NONSSL') . '" class="menuBoxContentLink">' . BOX_CATALOG_PRODUCTS_EXPECTED . '</a>');

Add before:

?View Code PHP
1

'<a href="' . tep_href_link(FILENAME_FLASH_CAROUSEL, '', 'NONSSL') . '" class="menuBoxContentLink">'.BOX_FLASH_CAROUSEL_PRODUCTS.'</a><br />' .

Step 7:
Edit the file /catalog/admin/includes/functions/general.php
End of the file before ?> tag add below code:

?View Code PHP
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

  function tep_cfg_pull_down_flash_styles($style_name) {
	if ($handle = opendir(DIR_FS_DOCUMENT_ROOT.'kampanya')) {
    	while (false !== ($file = readdir($handle))) {
        	if ($file != "." && $file != ".." && is_dir(DIR_FS_DOCUMENT_ROOT.'kampanya/'.$file)) {
              	$handle_deep = opendir(DIR_FS_DOCUMENT_ROOT.'kampanya/'.$file);
              	while (false !== ($file_deep = readdir($handle_deep))) {
              		if ($file_deep != "." && $file_deep != ".." && is_dir(DIR_FS_DOCUMENT_ROOT.'kampanya/'.$file.'/'.$file_deep)) {
              			$files_deep[]= array('id' => $file.'::'.$file_deep,
        	                   	             'text' => $file.'('.$file_deep.')');
              		}        		
              	}
              	closedir($handle_deep);
         	}
    	}
    closedir($handle);
	}
    return tep_draw_pull_down_menu('configuration_value', $files_deep, $style_name);
  }

Step 8.1:
Edit the file /catalog/admin/includes/languages/english.php
Find:

?View Code PHP
1

define('BOX_CATALOG_PRODUCTS_EXPECTED', 'Products Expected');

Add before:

?View Code PHP
1

define('BOX_FLASH_CAROUSEL_PRODUCTS', 'Flash Carousel');

Step 8.2:
Edit the file /catalog/admin/includes/languages/espanol.php
Find:

?View Code PHP
1

define('BOX_CATALOG_PRODUCTS_EXPECTED', 'Pr&oacute;ximamente');

Add before:

?View Code PHP
1

define('BOX_FLASH_CAROUSEL_PRODUCTS', 'Flash Carousel');

Step 8.3:
Edit the file /catalog/admin/includes/languages/german.php
Find:

?View Code PHP
1

define('BOX_CATALOG_PRODUCTS_EXPECTED', 'erwartete Artikel');

Add before:

?View Code PHP
1

define('BOX_FLASH_CAROUSEL_PRODUCTS', 'Flash Carousel');

Step 8.4:
Edit the file /catalog/admin/includes/languages/turkish.php (if you have)
Find:

?View Code PHP
1

define('BOX_CATALOG_PRODUCTS_EXPECTED', 'Beklenen Ürünler');

Add before:

?View Code PHP
1

define('BOX_FLASH_CAROUSEL_PRODUCTS', 'Flash Carousel');

Step 9:
Add the following line to /catalog/includes/database_tables.php

?View Code PHP
1

define('TABLE_FLASH_CAROUSEL', 'flash_carousel');

Step 10:
Add the following line to /catalog/includes/filenames.php

?View Code PHP
1

define('FILENAME_FLASH_CAROUSEL', 'flash_carousel.php');

Step 11:
Edit the file /catalog/includes/application_top.php
Find below line:

?View Code PHP
1

tep_expire_specials();

Add below lines after:

?View Code PHP
1
2
3

// auto expire flash carousel products
require(DIR_WS_FUNCTIONS . 'flash_carousel.php');
tep_expire_flash_carousel();

Step 12:
Edit the file /catalog/include/functions/general.php
End of the file before ?> tag add below code:

?View Code PHP
1
2
3
4
5
6
7
8
9
10
11

  function tep_array_values_to_string_flash_carousel($array, $separator = ',') {
	$get_string = '';
	if (sizeof($array) > 0) {
		while (list($key, $value) = each($array)) {
				$get_string .= $value . $separator;
		}
		$remove_chars = strlen($separator);
		$get_string = substr($get_string, 0, -$remove_chars);
	}
	return $get_string;
  }

Step 13:
Edit /catalog/index.php (two instances)
Find below lines:

?View Code PHP
1
2
3

<tr>
<td><?php include(DIR_WS_MODULES . FILENAME_NEW_PRODUCTS); ?></td>
</tr>

Add before:

?View Code PHP
1
2
3

<tr>
<td><?php include(DIR_WS_MODULES . FILENAME_FLASH_CAROUSEL); ?></td>
</tr>

Step 14:
Create the database table for flash carousel products. Open database_sql folder and choose appropriate file.
For English run flash_carousel_english.sql file with sql program like phpMyAdmin.
For Turkish run flash_carousel_turkish.sql file with sql program like phpMyAdmin.

For other languages you can use flash_carousel_english.sql. If you translate this file please send us. We can put this file further osCommerce Flash Carousel releases.

Step 15:
Chmod 777 catalog/kampanya folder.

Upgrade osCommerce Flash Carousel 3.0.1 from 3.0

If you installed osCommerce Flash Carousel 3.0 please download new version from http://addons.oscommerce.com/info/6123 address with titled osCommerce Flash Carousel 3.0.1.

Please backup your store files before starting upgrade.

Open osCommerce Flash Carousel 3.0.1.zip file. You will find [b]update_from_3.0_to_3.0.1[/b] directory. Please follow below instructions.

Upgrade Step 1:
Open your store catalog/index.php file. Find below lines and delete them. If you have already unmodified osCommerce RC2a catalog/index.php file, you can copy index.php file from update_from_3.0_to_3.0.1/modified_files/catalog to your store catalog/index.php file (replace it).

?View Code PHP
1
2
3
4
5
6
7

<script type="text/javascript" src="kampanya/swfobject.js"></script> 
<style type="text/css" media="screen"> 
    object { outline:none; } 
</style> 
<script type="text/javascript"> 
    swfobject.registerObject("flash_carousel", "9.0.0", "kampanya/expressInstall.swf") 
</script>

Upgrade Step 2:
Go update_from_3.0_to_3.0.1/new_files/catalog/includes/modules directory copy [b]flash_carousel.php[/b] to your catalog/includes/modules directory (replace it).

Usage:

osCommerce Flash Carousel Configuration Page

Configuration Screen

  • Display Flash Carousel :If you want to use osCommerce Flash Carousel, select configuration true.
  • Display Maximum Number of Products :Please enter maximum number of product to show in Flash Carousel.
  • Flash Carousel xml/image Store Directory :Please enter directory name where osCommerce Flash Carousel addon stores files (xml, small image etc.) produced by osCommerce Flash Carousel.
  • Want to Resize Images? :Do you want to resize images which Flash Carousel addon shows? Ideal image dimension 100px X 75px. If your image larger than 100px X 75px, you can configure true.
  • Flash Carousel Style :Select Flash Carousel addon style that you want to use. Now osCommerce Flash Carousel supplies two sytle. osCommerce Flash Carousel has plugin structure. Later you can download new styles and install it to your existing store without changing any code.
  • Flash Carousel Background Color :You can enter background color for osCommerce Flash Carousel addon. Also you need to modify flash_carousel.php file in the modules directory.
  • Want to Show Sub-category Pages? :If you want to use osCommerce Flash Carousel in any sub-category page, select configuration true. In other words when you are visiting a sub-category page osCommerce Flash Carousel will show products only releated with this sub-category.
  • Don’t Show Products Below :If you select few products maybe osCommerce Flash Carousel can not show nicely. If you specify number of products in here, osCommerce Flash Carousel can not show products below this number (0 ineffective).

Adding Product to osCommerce Flash Carousel

  • Click Catalog->Flash Carousel link.
  • Than click new product button.

osCommerce Flash Carousel Main Screen

  • Choose Product from pull-down menu and Expiry Date if you want.
  • Click insert button.

osCommerce Flash Carousel Product Adding Screen

  • You can add as many as products you want.

osCommerce Flash Carousel Main Screen With Products