Introduction
This guide may seem overwhelming at first, especially if this is your first time running an E-commerce shopping cart. Don't fear though. In order to get started, we recommend you first view the demo store and click the links, mess around, try the different features out.
After you finish with that, try logging into the administration and clicking the various links to see what they do. Don't try changing anything yet, especially the configuration section. After you have clicked on the various links and see what's available, you can go through this guide to understand better what the features do. You will find that our Rental E-commerce system has lots of features to help you run your store, market your website, and make a fun shopping experience for your customers.
We offer consulting and support services, as well as E-commerce packages if you find need additional help with your store.
Index
How Do I Backup My Store?
Adding Products to the Catalog
General
Pricing
Shipping Modules
Onetime Pay Per Rental Shipping
Customer Edit Page
Setting Up A Rental Membership Account Manually
Rental Memberships Area
Rental Queue Rental History
Label maker
Pay Per Rental Area
Calendar Blackout Dates
Send Onetime Rentals
Return Rentals By Bar Code
Label maker
Customizing Your Store
Changing Web Site Text for Information Pages
Populating the Product Inventory and Rental Inventory Via Spreadsheet
Template Admin/Changing Site Look/Logo
Infobox Admin (little boxes on left and right column of site)
Location/Taxes
Adjusting Email Text (order receipts, rental sent, site welcome email)
Using With Other Languages
Extra Features
Referral Reports and Setup
Site Search Reports (Know what your customers are searching for)
Rental Memberships Customer Side
Multi-Inventory Centers (Add-on)
Config settings
Inventory zone delivery areas
Check if customer is in inventory zone page
Setting product inventory by zone
Point of Sale (Add-on)
Streaming/Downloads (Add-on)
Membership Rental Plans Streaming Options
Adding Streams/Downloads To A Product
Viewing A Customers Stream/Download History
Converting DVDs to a streaming video format
Getting permission to stream videos
Multi-Store (Add-on)
Setting Up New Stores
Setting categories and products to show by store
Quick Setup Guide:
1. Go to configure > my store – set your store name, owner, email address, etc. You can also set different options under admin > config > rentals. Set your shipping info under admin > config > shipping/packaging.
You are done with the initial setup!
How Do I Configure My Store?
Go to admin > configuration > My Store and admin > configuration > rental > general. Here you will be able to configure many things having to do with your store, such as your store name, rental feature options, etc. In this guide we don't tell you what each option does because this is shown to you on the administration.
For example, if you go to admin > configuration > my store and click on "Ignore Words In Product Listing Alphabetical List" it will tell you on the right side box what this feature does: "Put here the words that you want to be ignored by the alphabetical product listings. Useful so that products with "the" in the title or words like that don't get alphabetized under "t" Ignored Words: (seperate multiple words with a comma)"
Then you can click on "edit" and edit that configuration setting.
How Do I Backup My Store?
The first step is to backup all your files. You will need to download a free FTP program like Filezilla.
1. Open up your FTP program and put in your connection settings (provided to you by your web host).



Many of the fields for adding products to the catalog are self-explanatory. Here we discuss fields that may be confusing.
Products Type: check the checkbox for the type of product you want the product to be.
Date Available: Set the date your product will be released if it is not yet available.
Products Model: SKU for item, not related to barcode
Products URL: put in url here if you want a weblink shown on the product info page for that product shown to your customer.
product weight: make sure to give the product a weight if you want to charge shipping for a product (even if you are using table rate shipping).
Tax Class: set this to taxable goods if you want to charge sales tax.
Products Price (Net): put in your product price here for your product types
Product Price (Gross): don't edit this. It is auto-calculated based on if the item is taxed.
Special Authorization Charge: If you put something here, your product will only be authorized this amount to the credit card rather than the actual price of the item. Authorization means their credit card is only authorized, not actually charged. You must also have admin > modules > payment > (your credit card processor) set to "authorize only" for this to work
Pay Per Rental Pricing - this is the pricing for onetime pay per rentals based on time period rented.
Description
Product Name
Product Description
Choose Product Type: This connects to admin > catalog > product types. The goal of this feature is to allow you to enter in custom product fields since all stores are different. For example, you may have a product type movies and here you would enter actors, director, etc. and another product type books, so here you would enter author, ISBN, etc. After you setup your product types, the entry fields will appear after you select your product type from the drop down menu.
Meta Tag Information - these 4 items are for search engines. You can leave them blank if you like and they will be auto-generated.
Inventory
1. First select the product type tab: new/used/pay per rental/rental members for which you want to add inventory
2. Next chose the inventory tracking method: quantity or barcode. For barcode tracking you must enter barcodes for each product sold or rented. Barcode is the only option available for rental membership inventory. If you have the multi-inventory module installed, you can check the checkbox "inventory centers" to make it track by inventory center.
Box Set
you don't need to adjust anything here, if you generate a box set this info will be filled in for you
Packaged
This is where you setup pay per rentals products that can include multiple quantities of different products. For example, you might make the main product "movie rental package" within this product under the "packaged" area you setup the movies that are part of the package.
To add products to a package, first start to type the name of the product you want to add and select it when it appears. then put the quantity, select type "pay per rental" and click add. The product you added now forms part of the rental package.
Downloads/Streaming
Discussed here: downloads/streaming
Pay Per Rental
Credit Card via Authorize.net: Credit card number is stored in the admin > customer area and customers are automatically billed on their bill date via the member_update.php cron.
Credit Card via USAePay: Credit card number is stored in the admin > customer area and customers are automatically billed on their bill date via the member_update.php cron.
Credit/Debit Card (via PayPal): PayPal transactions will be recorded as recurring billing transactions automatically by PayPal. Rental Free trial periods are not compatible with PayPal, though PayPal claims to support them, they have errors in their integration code causing it to not be able to be supported. Also, coupons and gift vouchers are not compatible with PayPal rental signups, so on checkout_payment.php the coupon/gift voucher entry box will not appear when signup up for rental memberships. We hope that PayPal will support them in the future, if they do we will upgrade your store. Make sure that paypal ipn is set in admin > modules > payment to "aggregate" mode for the coupons/gift vouchers to work with buying regular products.
Cash On Delivery: if enabled, this module only works for regular shopping cart purchases, not rental memberships
Check/Money Order: if enabled, this module only works for regular shopping cart purchases, not rental memberships
There are also some other payment modules, but we do not officially support them.
You will be able to see a customer's billing history by going to admin > customer > edit and looking at their account. You can also view details of each recurring billing in customers > orders, and customers > membership billing reports
You can go to customers > edit customer to make a regular customer a rental membership customer. You click “set customer to rental membership customer,” then chose their package, set their status to active, and put in the payment method you want to use for them.
Cancellation and Package Upgrades: If a member cancels their membership or upgrades their package you will be sent an email alert. Their account will automatically be deactivated at the end of their billing cycle.
If request a upgrade/downgrade on their next billing cycle the web site will automatically update their account and their new membership plan will take effect (note you must have the cron job or scheduled task setup to run everyday for the automatic upgrade/downgrade to take effect).
Rental Memberships Area
Package name: what you want the package to be called
Membership Days: number of days in the membership – at the end of the membership the member will be charged the price for the membership again.
Membership Months: number of months in the membership, use months or days, try to avoid using a combination of both.
Free Trial: how many free trial days are in the membership
Free Trial Authorization Amount: Amount to authorize (but not charge) your customers credit card during the free trial period if using authorize.net or usaepay credit card payments. This is to ensure they are using a valid credit card.
Number of titles: how many products they can have checked out at a time
Tax Class: Set to taxable goods if you want to charge tax on rental memberships.
Here you can review and respond to rental issues that customers have reported.
Sending Rentals
To send rentals you go to rent > rental queue. You can view which members need rentals to be sent. Click the view rental queue link. Now click the checkbox next to the titles you want to send out. Then you select the barcode of the movie in inventory you are sending. Then you click rent. If you want to adjust the estimated arrival or return dates you click the arrow and set the date.
Returning Rentals
Go to Rent > return rentals. You can return rentals by scanning the barcodes of the rentals into the boxes and clicking return. You can also return rentals by clicking the box in the return rentals column, adding any comments if you want, then clicking the remove button at the bottom.
Onetime Pay Per Rental Area
Calendar Blackout Dates
Found under admin > modules > extensions > pay per rentals > edit. This is to select dates that are not selectable on the calendar for onetime rentals. These might be days where your store is closed on the weekends, holidays, or vacation periods. For the blackout dates input boxes, if you select "repeats" these days will be blacked out every year. If not checkboxed repeats, it will be for that year only.
Send Onetime Rentals
1. Here you will select the from and to date for when the customer is supposed to receive their rental item. Click "Get Reservations"
2. Click the checkbox next to the reservations you want to send, and then click the "Send Selected" button at the bottom of the page to send the rentals
1. Chose the start and end dates for when the reservation is supposed to be returned. You will then be presented with the rentals that should be returned during that time. It will also show how many days late the rental is. You can here enter in comments on each rental inventory item about the condition of the item if desired.
Put your cursor in each barcode box and scan it or type in the barcode number. Add comments about the rental inventory item if you like. Check the broken checkbox if the rental inventory item is broken or lost so that the rental inventory item will no longer be available for rent. Check the box "return rentals" for the rentals you want to return, then click the button at the bottom of the page to return them.
Configuring Your Store
Populating the site Via Spreadsheet
Go to admin > import/export > products
1. download EP & Froogle Files heading, chose Download Complete tab-delimited .txt file to edit
2. download the file to your desktop. Open it with your spreadsheet program. For Excel, right click the file, and click "open with Excel"
3. fill in the fields on the spreadsheet. Make sure you put in a unique v_products_model (this is like a SKU) for each product, or uploading/updates will not work.
4. make sure the last row of each product has EOREOR
5. Now save the file, if it asks, make sure to keep it in tab delimited format
6. upload the file by using "upload EP file" browse to chose the file on your hard drive, then click insert into DB. If it times out while importing your file, instead chose the "split EP file" option.
Adjusting Site Text
The text in your information pages can be easily edited in the admin, please see above "changing web site text." Not all text can be edited there though. A lot of the text for the pages is usually in includes/languages/(your language)/filename.php
For example, if the url bar of the browser says "yoursite.com/checkout_success.php" (the checkout success page) then the language file would be includes/languages/(your language)/checkout_success.php
Be careful about editing the text, if you need to use a apostrophe, make sure to backslash it like \’ or it will put in a premature end of field.
Adjusting Meta Tags
You can adjust the meta tags for your pages like your home page, specials page, category pages, and product pages. As part of the SEO features, your category and product pages will automatically get meta tags, but you can override them. You can adjust the index, specials, etc. pages meta tags in admin > header tags > text control. To add/remove pages from the header tags control system you can go to admin > header tags > page control and follow the instructions on the page. Admin > header tags > fill tags will auto-fill the meta tags for your products, manufacturers, and products.
Template Admin/Changing Site Look/Logo
You can also set the template you want to use in admin > config > my store > default template directory to the name of the template. In order to make adjustments to the template, we suggest copying all the files in templates/red to a new directory, like templates/mytemplate, then making your changes so that you always have a backup in case something goes wrong. Then in admin > config > my store you can change your default template directory to this new template.
To adjust the look of your web site page, the main template file is in templates/templatename/main_page.tpl.php (templatename is the name of the currently selected template you are using, by default it is the red template. The code for the pages themselves is in templates/fallback/content. There is also template code in the rest of the files like templates/templatename/footer, header, page_nav, etc.
In order to change the colors of the website, we suggest installing Firefox web developer toolbar from here: https://addons.mozilla.org/en-US/firefox/addon/60/ after that click the CSS > View Style Information, then you can click on any element on the webpage and know where the style definitions come from. Then you can edit that css file. Some of the styles come from templates/templatename/stylesheet.css and main_layout.css, but there are also many that come from ext/JQuery/themes/smoothness/ui.all.css
There is a built in text editor for your web site under admin > content management > manage pages. here you can edit the text appearing on the contact us page, about us, or your other pages. You can also insert new pages and have them appear in your Information area.
Infoboxes are the little boxes on the left and right column of your web site like “shopping cart” or “rental queue.” These can be turned on and off through admin > content management > manage side columns. When you are on this page, chose from the top right your template (by default the template you are using is called "red"). After that you can drag and drop to the side columns the infoboxes that you want to show. You can also click to drag infoboxes up and down in the list, or drag them to the trash can to remove them. If you click the "pencil" icon you can re-title the name of the infobox, or put in text for other languages if you run a multi-language site.
Go to Admin > location/taxes click “zones” edit the zone and set it to your State or Area. Then click “details” and set it to your State or Area.
Now click Admin > location/taxes > tax rates and edit your tax rate.
For items to be taxable or rental packages to be taxable, you need to set them to the “taxable goods” tax class when you edit them.
Email templates can be adjusted under tools > email template manager. when you edit a template, you will see in red text the template tags you can insert into the email that will be filled in with the field shown.
By default English is supported, but it can work with other languages with a little work. To use with other languages:
1. In admin > localization > languages insert your new language if it doesn't already exist. If your language does already exist, just click the "green light" button to enable it. After you have installed your language, it will take some work to translate the content of your website. You can do this by going to includes/languages/your_language/ and editing the files there to edit the text for your language. Careful not to insert ' characters, if you have to use an apostrophe, backslash it like \'
You will also need to copy /templates/email/english/ to /templates/email/italian/ or whatever the name of your language is and translate the email templates. This can also be translated from admin > tools > email template manager but you need to make sure to give 777 permissions to the email template files.
IF YOUR LANGUAGE IS NOT ALREADY INSTALLED
FIRST backup your Files/DB, we recommend you pay for support to add other languages
**option 1 - start with language files from the contributions area of Oscommerce. The language contribution must be in UTF-8 database format. Some languages such as Korean, Japanese do not have a UTF-8 language pack and may require extra billed time to install (about 1 - 2 hours)
2. install the files from your language pack: http://www.oscommerce.com/community/contributions/category,7 read the readme file that comes with it. IMPORTANT, DO NOT run any php script, or SQL query that comes with the language pack. These can corrupt your store config settings, and make your store not run. Only copy over the language files to the languages directory.
3. It will require some work to insert the extra language files for the rental module. These include files in includes/languages/english like rental_billing_history.php or other files beginning with rental_ there are also other files like wishlist, affiliate_ that don't come with the system by default, so therefor you will need to make the language files. You can start by copying over any missing language files from includes/languages/english to includes/languages/yourlanguage and then translate the files.
4. You will also need to edit includes/languages/your_language.php (replace your_language.php with your language name) for the extra defines that our system uses, for example BOX_HEADING_TITLE means you are missing the language define for that item.
5. make the new buttons for your site in includes/languages/(your language)/images/buttons
**option 2 - copy english files and translate
2. copy all the files from includes/languages/english to a new directory, like includes/languages/korean and copy includes/languages/english.php to includes/languages/korean.php
3. make the new buttons for your site in includes/languages/(your language)/images/buttons
You can setup your coupons under the Vouchers/Coupons box in the admin area. Click Insert, and it will give you different options for your coupon like valid products, valid categories, coupon amount (% or fixed amount) etc.
To add gift vouchers you need to add a new product to your product catalog. In the model field for the product, put GIFT, and you can set the price to any amount. Now people will be able to buy a gift certificate from the product you created. If you want to have to approve gift voucher purchases, go to Modules > order total > gift vouchers > edit – set queue purchases to false if you want people to get instant access to their gift vouchers. If you set it to true, you will need to approve gift vouchers when you get orders under Vouchers/Coupons > gift voucher queue.
You can access recover cart sales at tools > recover cart sales. Clicking on that page will show you a page of people with shopping carts that have not purchased them. Chose the date range and people you want to contact and then click send email at the bottom. These people will be sent an email reminding them about their shopping carts.
To check the results of your recover cart sales go to tools > recover cart sales results. Here you can track by date range how much $ in sales you have recovered.
People can signup to be your affiliates and you pay them a percent of sales when they buy something. You can set the options in admin > config > affiliates, most options are self-explanatory and can be left as default, these ones are crucial:
Pay per sale %: how much to pay per sale
Payment threshold: how much $ affiliate has to earn before you pay them
Billing Time: how old order has to be before you pay your affiliate (to cover returned items, etc.)
Now in admin > marketing > affiliates here is where you can view your affiliates and click throughs. You can create affiliate banners under admin > affiliates > banners. Under admin > affiliates > payment you can run a payment cycle to see how much you owe them. Affiliates won’t show up here until the billing time (see above) has past, and their order status is “delivered”
Fun Ways To Browse
The purpose of fun ways to browse is to give your customers interesting ways of viewing your products. For example, say you want to have a holiday section, or a academy award winners section, this allows you to do this. You would also use it to show products from $10 - $50 or something like that.
Inserting a Category: insert the categories you want, such as "Academy Award Winners"
Inserting Products: you can insert products from your catalog into each category
Inserting a URL Link: you can also insert URL links. To insert a URL link, click insert category, and put a URL in the URL input box.
Linking to advanced search results: you can also link to advanced search results. For example, go to your advanced search page, put price from $5 to $10, then click search. Now copy this url and paste it in the URL box when you insert a category.
The purpose of admin access levels is so that you can have multiple admin accounts, each with access to different parts of your admin. Say one person is the master admin - they can access all files. Then you have a marketing person who can only access your reports area, polls, and articles.
To make a new administrator with certain permissions, click on "administrator" on the top left of the admin menu. Then click "member groups" and then "groups." Here you will see your admin groups. Add a new group, then click "new permission" then you will be shown a checklist of what areas of the admin you want that access group to have access to.
Polls are in the admin > marketing > polls. You can create new polls here. If you click a current poll and click edit, you can view the current poll results, comments, and you can also delete current comments. Under admin > marketing > polls > configuration you can set some different configuration options for polls.
Trouble Tickets
Customers can reports issues with products that are in their rental queue. You will get a report of this in your email. To respond, go to the admin > customers > customer edit page to respond. There is also a reply link in the admin email.
You can add articles to your site under admin > content management > article manager. First create your article topics (categories) then add your articles to each topic. You can set various configuration options under articles manager > configuration.
Referral setup is useful for telling where your customers found your web site. You first need to setup referral sources under marketing > reports > referral sources. Here you can setup the sources that will appear on the drop down box for “How did you hear about us” on the create account page. You might put in like “google” or “friend” or “magazine ad” here. To view the results of the referral sources, you go to Reports > referral sources. If you click twice on “other” (assuming someone on your site has signed up and put other) you can view what people typed in that field.
Site Search Reports (Know what your customers are searching for)
You will find this under: tools > keyword manager
Rental Memberships Customer Side
Signing up for customers is easy. They simply go to add a movie to their queue, and then it will ask them to sign in or create an account. When creating an account they can set the package that they want to purchase. The next page gives them payment options and then they confirm their order.
Adding Rentals to Queue and Managing Queue
The movie rental queue is managed by going to each product page and clicking the add to queue button. Rentals can be adjusted by priority order, and removed from the queue by clicking the checkbox and clicking update.
Members can cancel their memberships by going to my account > cancel membership. Admin will be notified when a user cancels their membership. The customer's account will be automatically deactivated on their next billing cycle. For paypal, you may have to manually set their membership to inactive.
Members can upgrade their memberships by going to my account > upgrade membership. Admin will be notified when a member wants to upgrade their account. The customer account will be auto-upgraded or downgraded on their next billing cycle.
Viewing Their Billing Info
Members can view their billing info by going to my account > billing info. It will show them the package they are signed up for, the billing date, and price.
Changing Their Rental Shipping Address
This is available from the my account page > Change Rental Shipping Address link
Changing Their Credit Card and Billing Address
If you take credit card payments, your rental customers can change their credit card and billing address for their rental account by going to my account > update rental account credit card and billing address
Rental items pre-registration: whether to show the page to the customer that makes the register their address on the customer side to see if they are in a inventory center zone before they rent something
Admin > configuration > streaming and Admin > configuration > downloads
There are several areas to be aware of in the setup of your store for streaming/downloads. The first 2 area in the configuration area:
Converting DVDs to a streaming video format
You will need to convert your dvd files to a streaming video format. The streaming video player can play FLV, MP4, and H.264 files. To do so, you will need a software program to rip the dvd, then convert it. Please checkout the following resources:
10 Free video rippers, encoders, and converters
Blaze Media Pro software
DVD ripping tools
Getting permission to stream videos
To stream videos, you need to get permission and rights from the video producers. This would be one of the major studios if you want to stream a Hollywood release, it is easier to get permission for independent movies.
Multi-Store (Add-on)
Setting Up New Stores
Go to admin > config > multi stores > setup stores > new store button