redSHOP User Manual v 1 . 06 uk

1






redSHOP User Manual




 
 
 
 
 
 
 
 
 
 
 
© Copyright 2010 redWEB.dk. All rights reserved.
This guide can only be printed for your own use. You may not redistribute or sell it in any way or form
either in print or electronic without written consent from the publisher. You may not link to this guide
without written consent from the publisher. This guide is available without any form of payment and
without warranty of any kind. redWEB does not undertake any obligation to any loss or damage caused
by the use of this guide or the information the guide contains.
2

Foreword
First off we want to thank you for choosing redSHOP as your webshop solution. We are very
proud of our product and we hope you enjoy redSHOP.
The purpose of this guide is to give you a view into how you set up and maintain your
redSHOP webshop.
The manual is build up "chronological" which means we start out with the installation of the
webshop, followed by the configuration and setup after which we take you through the
maintenance of content and at the end of the manual the more advanced features of redSHOP
will be covered.
This manual is constantly being developed because redSHOP constantly under development
as well. Therefore we will be updating this manual and describe new functions or describe
already existing functions more thoroughly.
Please note that some screenshots in this manual are partly in Danish.
Enjoy your redSHOP.
3

Table of content
Foreword .................................................................................................................... 2
 
Table of content ........................................................................................................... 3
 
Installation and setup ................................................................................................... 6
 
Requirements for your server ...................................................................................... 6
 
Installation ............................................................................................................... 6
 
Advanced installation ................................................................................................. 7
 
Configuration ............................................................................................................ 8
 
Add categories and products ........................................................................................ 10
 
Templates .............................................................................................................. 10
 
Add categories ........................................................................................................ 10
 
Add product ............................................................................................................ 12
 
Add category- and productimages .............................................................................. 15
 
Product attributes .................................................................................................... 16
 
Attribute sets .......................................................................................................... 19
 
Accessory products and related products .................................................................... 20
 
redPRODUCTFINDER Association ................................................................................ 20
 
Stockroom ............................................................................................................. 20
 
Import categories and products ................................................................................. 20
 
Add quantity discount .............................................................................................. 21
 
Product overview ..................................................................................................... 21
 
Wrapper ................................................................................................................. 22
 
Customize the viewing of products and categories .......................................................... 25
 
Settings in the configuration ..................................................................................... 25
 
Templates .............................................................................................................. 25
 
Add to cart and Ajax cart .......................................................................................... 26
 
Editing your templates ............................................................................................. 27
 
More on templates ................................................................................................... 28
 
Fields .................................................................................................................... 28
 
Text library ............................................................................................................. 29
 
Advanced editing of redSHOPs language files ............................................................... 30
 
Overrides for redSHOP ............................................................................................. 31
 
VAT .......................................................................................................................... 32
 
Add manufacturers ..................................................................................................... 34
 
4

Catalogs and colour samples ........................................................................................ 35
 
Inventory management ............................................................................................... 37
 
Users and userregistration ........................................................................................... 38
 
Users ..................................................................................................................... 38
 
Shopper Groups ...................................................................................................... 39
 
Discounts, coupons and vouchers ................................................................................. 42
 
Discounts ............................................................................................................... 42
 
Coupon .................................................................................................................. 42
 
Voucher ................................................................................................................. 43
 
Giftcard ................................................................................................................. 44
 
Products on sale ...................................................................................................... 44
 
Order and order status ................................................................................................ 47
 
Order listing ........................................................................................................... 47
 
Update orders ......................................................................................................... 47
 
Offline orders .......................................................................................................... 48
 
Order status list ...................................................................................................... 49
 
Downloadable products ............................................................................................... 50
 
Mailcenter ................................................................................................................. 53
 
Newsletter ................................................................................................................ 54
 
Shipping setup ........................................................................................................... 57
 
Payment gateway setup .............................................................................................. 59
 
Integration with E-Conomic ......................................................................................... 63
 
Import / export data ................................................................................................... 65
 
Statistics................................................................................................................... 68
 
Integrate your Joomla site with redSHOP ....................................................................... 69
 
Modules and Components for redSHOP .......................................................................... 75
 
redPRODUCTFINDER ................................................................................................ 75
 
redSHOP Cart module .............................................................................................. 76
 
redSHOP Newsletter ................................................................................................ 76
 
redSHOP Search ...................................................................................................... 76
 
redSHOP Compare ................................................................................................... 77
 
redSHOP Productscroller ........................................................................................... 77
 
redSHOP featuredproduct ......................................................................................... 77
 
redSHOP Magic Magnify Plus ..................................................................................... 78
 
redSHOP Manufacturer ............................................................................................. 78
 
5

redSHOP Products ................................................................................................... 78
 
redSHOP Shoppergroup Category .............................................................................. 78
 
redSHOP Discount ................................................................................................... 78
 
Finally ...................................................................................................................... 79
 
Appendix 1 ................................................................................................................ 80
 
Tags reference list for templates ................................................................................ 80
 
Reference list for SEO tags ....................................................................................... 87
 
6

Installation and setup

Requirements for your server
These requirements must be met:
Installation of Joomla 1.5.15
Apache 1.3.x or higher
PHP 5.x or higher
MySQL 3.23.x or higher

Installation
To install redSHOP you must first download the installation archive which must be used in the
Joomla administration.
When you have downloaded the package, you must log into the Joomla administration and find
the item "Install/Uninstall" and click it.

Now you must find the installation archive on your computer by clicking on the browse button.

When the archive is selected you click on "Upload File & Install" after which this screen
appears if the installation has run with no problems.
7



To update to a new version of redSHOP, you follow the same procedure and choose the
updated installation archive. You do not need to uninstall redSHOP first.
Advanced installation
People using discount / lower end / conservatively configured hosts will often find that their
default limits for memory, execution time or upload sizes allowed in PHP is too low and will
need to update the PHP settings.

The php settings can typically be updated in one of 3 ways:

1) Using the hosts control panel
2) Adding the value changes directly into a .htaccess file
3) Adding the value changes directly into a php.ini file

How to tweak the php settings through .htaccess

Rename the file htaccess.txt to .htaccess in the root folder of your Joomla installation.

Input the below lines in the start of the document:

php_value memory_limit 64M
php_value upload_max_filesize 20M
php_value post_max_size 20M
php_value max_execution_time 200
php_value max_input_time 200

Notice some hosts may have hard limits on how big you can go if the above does not work try
lowering to:

php_value memory_limit 48M
php_value upload_max_filesize 8M
php_value post_max_size 8M
php_value max_execution_time 60
php_value max_input_time 60

8

To check if the setting changes works look under Help -> System Info -> PHP info and look for
the memory_limit etc.
Configuration
After the installation the settings for redSHOP must be set up after the demands you have for
your webshop. You can see the different groups of settings here

Under the general tab you will find the general settings for the shop. Among other things, you
can set up currency, currency symbol, welcome message, the name of the shop, home country
of the shop, which countries are available, default VAT and much much more.
Under layout you have the option to adjust the look of the webshop. This is where you decide
the size of the different picturetypes in the shop while you can also adjust other settings for
pictures. There is also other settings for the view of description for categories and products.
The newsletter can be setup to choose which sender name and sender e-mail that must be
shown when the newsletters are sent out as well as the template you will be using for the
newsletter. You can also choose to disable the newsletter functionality completely, which
means the user will not be prompted to join the newsletter during registration, if your shop
does not make use of it.
The E-conomic tab is for the integration with the webbased E-conomic accounting software.
You can type in your agreement number, username and password here. Read more about e-
conomic integration in the chapter Integration with E-Conomic.
Discount - in this section you can set the number of days which must be passed after a
completed order, before the customer gets a mail which offers a discount if they buy another
product. You can also type in the discount amount here - either a percentage or a total
amount. Of course you can also choose to turn the feature off completely.
Catalogue - in this tab you can set up the configuration for another type of action email. This
email is sent out to users that have received a catalogue from the shop. Here you can set up
how many days must pass, before the user receives an email reminding them that they have
received a catalogue. At the same time you can also set up how many days must pass before
the user receives a mail with a discount code for the shop.
Colour Sample - this feature works in the same way as above - only with colour samples
instead.
Under Google Analytics you can type in your Google Analytics tracker key and thereby get
the option to follow the visitor statistics with the Google Analytics tool.
If you want to search engine optimize your website you can enter the tab SEO. Here you are
able to make a standard template for search engine optimization so the product- and
categorypages that are dynamically created will get certain titles and metatags that are
created from the product- and categorynames.
9

In the modules tab you have the option to toggle different options for the user. These options
will appear if the user is logged in. Among the options is the opportunity to compare products
or make a wish list.
Shoppergroups
Under this tab you can set up whether you need to be logged in to use the webshop. It is also
possible to set a default shoppergroup, that shoppers will appear in when they register. You
can set a default shoppergroup for both private customers and businesses.
This concludes a very brief introduction to the configuration options in redSHOP. If you click
your way around in the settings, you can see the different options to set up the webshop after
your needs.
Wrapper
In redSHOP you have the option to add wrappers to your products and you can choose to show
a picture of the wrapper to the customer. In this area you can define the size of the images
that show the wrappers.
VAT
In this tab you have the option to configure the VAT settings in the shop. This is where you
choose the default settings like default VAT country, default VAT group and you choose what
the default VAT calculation should be based on.
Stockroom
This tab gives you the option to upload a specific image that is used when your stockroom
reaches a certain amount. E.g. you can set it up so a green image is displayed when the
stockroom amount is higher than 10, a yellow image when the stock room amount is below 10
and a red image is displayed when the amount reaches 0.
Unit
10

Add categories and products
In this chapter we will go through, how you add products and categories in the shop as well as
more advanced functions.
Templates
First it is important to know how redSHOP is build. The design of categories and products is set
up with templates. These templates can be administered in the Templates section where you
can add new templates for many areas of redSHOP - including categories and products.
The templates is build up with HTML and CSS so you can insert the common HTML tags in a
template to be able to customize the layout. Furthermore you can also customize the layout
with external stylesheets.
The content from redSHOP, e.g. productname, is displayed with "tags" that looks like this:
{product_name}.
We will explain further about the templates in this chapter.
Add categories
When you start out creating categories and products, it is generally a good idea, to start out
creating the productcategories you wish to create.
In the section Categories you can pick add category.

In the screen above, you can type in the information about the category. First you type in the
category name. Under parent you pick which category the category you are creating must
appear under. If it shouldn't appear under another category, you must select Top as the
category.
11

You can also choose how many products per page there must be shown. Next you must pick a
template for the category, which control how the category must be shown. Read more about
templates in the chapter Adjust the viewing of products and categories.
Finally you can choose which templates are available for the template selector. On your
website you have the option to add a template selector, so you can display the categories in
various ways. In this box you can decide which templates must be available for the selector.
Under the tab Images, you can add the picture you wish to represent the category. This
picture will be shown in an overview of the categories.
You can see an example here on how you can display the categories with category images.

Under SEO you have the option to search engine optimize the category page. This can be used
to if you want your visitors from Google to land on specific category pages if they search for
specific keywords.
Here you can see the fields you find under SEO:
12


Here you can make a unique pagetitle for the category page as well as add new meta
keywords, meta description and more. This option is also possible to use when you add a new
product.
If you are not familiar with using search engine optimization effectively, you can contact
redWEB on email@redweb.dk for an offer on a SEO package where we optimize a specified
number of your product pages.
Add product
When you have added the categories you wish, it is time to add products. Here you can see an
overview of the options you have for product creation.

In the first tab you type in the general information about the product. This is information such
as Product Name, Product Number and which Product Category the product belongs to.
13


The bottom options in the product creation give you the option to override the attributes with
an attribute set (explained later in the manual), indicate whether the product should be
shown in the front-end (Published), whether the product is on sale and whether the product
should be displayed in specific redSHOP modules (Special Product).
It is also possible to turn on Expired? - this option indicate whether the product is available
for purchase. The reason to choose this option instead of deleting or unpublish the product is,
that if you have gained a high ranking in Google with a specific product that is no longer sold,
you will still find a working page, if you search for it in Google, thereby giving the visitors the
option to move to other pages - for example related products that are still active.
You can also set up that the product is not for sale. This removes the add to cart function from
this specific product, while it is still present on other product pages.
14


On the other half of the production creation screen, you can type in price information, product
volume and weight as well as choose which template is used for the product view. Price
indicate the regular price for the product. Discount Price is the price that will be shown, if
you turn on the option Product on sale. Thereby enabling the option to make discount prices
for your products.
Product VAT Group should only be used if you have the need to make productspecific VAT.
This can be for countries where there are different VAT regulations for different product
groups. You can add new VAT rates under the area VAT group where you can add new VAT
groups and add rates for a specific country. Thereafter you will be able to select a VAT Group
under the product. You can read more about working with VAT in the VAT chapter.
Product Volume and Weight is primarily used in connection to shipping rates. As we will
describe later in the manual, it is possible to type in new rules for shipping rates, including
rules that indicuate a specific shipping rule according to the product weight or volume.
Product Length, Width and Height are also used for the shipping plugins, to calculate the
shipping rates.
Under Product Manufacturer and Supplier you can pick from a list of manufacturers and
suppliers. Later in the guide, we will show how to create manufacturers and suppliers.
You must also pick a Product Template you wish to use. The product templates are used to
decide how the products are displayed in the front-end.
Finally you are able to set a Minimum product quantity that specifies how many products
you must order as minimum to complete an order.
15

Add category- and productimages
It is of course possible to add pictures to both categories and products in redSHOP. There are
more ways to add images. One of the ways is to add them during the product- or category
creation.
In the product creation you will find a tab called Images. In this tab you can add pictures that
are already uploaded by clicking on Image. To upload the picture, you must click on the
button Add more images, after which you can add images to the product or category.

Here you can add and delete pictures as well as publish and unpublish them.
If you choose to add a new picture, you get the following options:

By clicking on browse, you can choose the picture you wish to upload. Remember to select
image under Media Type.
As you can see, you have the option to upload a zip file, so you can upload several product
images at the same time. In the shop there is the option to attach more product images to the
16

same product. The additional product images can be placed as smaller images on the product
detail page.
Furthermore you can attach a file for download. You can either choose to upload it through this
web-interface or upload it via FTP and select the file with the filebrowser.
Product attributes
In redSHOP you have the option to add more product attributes that can be selected by the
customer when he/she orders a product.

The first part of this process is to add the attributes you wish the customer can pick. In this
case there is created an option for the customer to choose a different size on the product. The
attribute is named Size and afterwards we can add properties that are attached to the
attribute.
These properties work as subattributes. If you want a new attribute you must click on New
Attribute.
At first you must pick whether the attribute is required which means that the user must pick
between the properties in the attribute to add the product to their cart. Furthermore there is
the option to adjust the order of the properties by filling out the numbers in the Order field
next to the name of the property.
17

You also have the option to add sub properties to those properties you have added. Thus
enabling you to adding a new property to a specific size, e.g. different colors only available for
that specific size.
Next to the different properties you can add an additional price for the property.

You can also attach images to the attributes. By clicking on browse you can attach a picture
that will be shown in a picture scroller on the product detail page. By clicking on the camera
next to browse, you can attach a larger image that will be shown when the user selects the
property.
18


Furthermore you can type in a Virtual Product Number for the attribute. This is used if you
wish to give the attribute a specific product number. E.g. if you wish to add a size that must be
considered to be an independent product.
The arrow icon next to the Virtual Product Number is for update of the stockroom. Thereby
giving you the option of updating stockroom status for attributes that appear as independent
products.
The piggy bank icon gives you the option of adding a quantity discount for the attribute. This
works in the same way as the normal quantity discount that is described below.
To have the attributes displayed, you must add a new attribute template and insert a tag on
your product template.
First you need to add a new template for attributes in the Template section.

Here you must select a name for the template and pick the template section: Attribute
template.
Then you can add a number of tags to the template, e.g.:
19

{attribute_title}: displays the name of an attribute. This could be color.
{property_dropdown}: This tag shows a dropdown box which shows the properties connected
to the attribute which the customer can select.
{property_image_scroller}: Shows images attached to the properties.
Attribute sets
There is another way to add attributes to your products. Under Attribute Bank you are able
to define a set of attributes you can attach to your products.
After having selected Add Attribute Set you set up the attributes as normal.

After the set is created, you can attach it to a certain product by setting it in the product
creation screen.

By doing it this way, the attributes you have created in the attribute set, will appear on the
product detail page along with the attributes you have created as normal.
20

Another possibility is, to copy the attributes from the attributeset directly onto the product.
You do this under the Product attribute tab after having selected the attribute set (as seen in
the picture above).

When you have checked yes to copying the attributes from the attribute set, you click save or
apply and then the attributes will be copied onto the product.
Accessory products and related products
You have the option to attach a product to another as accessory product. By clicking on the tab
Accessory Products under your desired product you will be sent to a screen where you can
type in the name of the product you wish to attach as accessory product - at the same page
there is also a list over products that are already added as accessory products.

To find the product you wish, you must type in the name of the product - you can just type in
the beginning of the name and then you will get one or more suggestions to products you can
add. When you click on one of them they will be added as accessory product.
Under the tab Related products you can add relations between products the same way.
redPRODUCTFINDER Association
This tab is related to the component redPRODUCTFINDER so if you are not using this
component, you don't need to use this tab.
You can read more about redPRODUCTFINDER in a future manual.
Stockroom
Under the tab stockroom, you can add how many items of the product is in stock. You need
to add a stockroom first though, which you can read about in the chapter: Inventory
management.
Import categories and products
If you have worked with the VirtuaMart webshop, you have the option to import the data you
have created here. By going in to Import / Export you can choose Import Data From VM.
After selecting this, all data from VirtuaMart is imported into redSHOP automatically. Under the
21

configuration of redSHOP you must select which templates that must be default in redSHOP.
These will be chosen for the categories and products that are imported.
You will also have the option to import products with a CSV file. You can read more about this
feature in the section Import / Export data.
Add quantity discount
If you wish to add a quantity discount on a specific product you must first select the product
and then click on Add price.

In here you can add the new quantity discount by clicking on New after which you will be
brought to a screen where you have the following options.

The first part is that you select which shoppergroup the discount must work on. (read more
about shoppergroups in the section Shoppergroups).
Then you select a new price that must be applied for the quantity you select.
The quantity is selected by setting a minmum amount of items that must be purchased
(Quantity Start) then you type in a maximum amount of items (Quantity End) applied for
this rule.
You can set a rule that an order between 100 and 500 items has a certain price for products
whereas an order for 500 to 1000 products gives another price.
Product overview
In the product overview you can see a list of the products that are added in redSHOP.
22


In the overview you can see some of the information about the products that are typed in. E.g.
product name, product number and which category the product is inserted into. Furthermore
you have the possibility to go into a media overview and see the media that is attached to your
product.
In the product overview, you can add wrappers specifically to certain products by clicking on
one of the icons in the Wrapper column.
Wrapper
As described in the above section you can add a wrapper to a specific product. After clicking on
an icon, a window appears where you can add wrapper to the product you have selected.
23


Here you must select a name and an image for the wrapper. Use to all products must be
selected if you wish to make the wrapper available for all products - in this case we have
selected that the wrapper should only be available for one product.
If you select the menu item Wrapper and then Wrapper listing in the left side of your
screen, you get an overview of all the wrappers that are available in the shop. Both the ones
that can be used on all products and those that a available for specific products.

In this area you can also add a new wrapper by clicking on New in the top right corner. The
editing window for the wrapper looks slightly different here since you can choose to select the
product you wish to add a wrapper to:

When you have added the wrappers you wish, the customer must of course have the option to
add the wrapper to the products they want to purchase.
24

This is done under Templates where you first must add a new templates:

This must be added to the template section Wrapper template. Here you can add the
following tags:
{wrapper_dropdown}: A selection box that shows the list of wrappers available for this
product.
{wrapper_image}: A visual presentation of the wrappers available for this product. The
pictures were added when you created the wrappers and the size of the images can be set
under the Configuration in the Wrapper tab.
{wrapper_add_checkbox}: This is a checkbox which the customer must check if he wants the
product to be wrapped. This tag must be part of the wrapper template.
When all this is done you find a product template and add the following tag:
{wrapper_template:wrapper}
In this case the title of the wrapper template is "wrapper" but if you have given it a different
name, the name in the tag must of course be changed.
25

Customize the viewing of products and categories

There are many possibilities to adjust the way redSHOP display products and categories. In the
next sections you will be guided through the ways you can adjust the viewing options you find
in the configuration after which you will be guided to how you create and edit Templates
that control the design of the detail pages for your categories and products.
Settings in the configuration
In the configuration you will find the options to adjust the size of your pictures. In the settings
where you have the option to type in both width and height, you can decide to just type in one
of the options - then the other option is automatically adjusted to the other setting after the
images original size so it is scaled correctly.
There is also the option to show the images in a lightbox. The lightbox is a large box which
the picture is shown in. Here you can select if a category image should be shown in a lightbox
when you click on it or if it should send the user along to the selected category. You can also
decide to adjust it for the product image in the category view and the product image on the
product detail page.
Templates
The templates are used to set the design of the different areas of your shop, including
Category detail view and Product detail view. But also many other areas such as
attributes, add to basket etc.
These templates build up in HTML and can also be adjusted in CSS - either with an external
CSS file or with a style tag in the source code of the redSHOP template. Beneath there is a
very simple example of a category view::
{category_loop_start}
{category_thumb_image}
<br />
{category_name}
<br />
{category_description}
<br /> <br />
{category_loop_end}
This piece of code starts a loop where it puts out all categories beneath eachother. It is started
with the {category_loop_start} tag and is closed with {category_loop_end}. Between
these tags it is defined how each category is shown. In this example the category image, name
and description is shown and then there is made extra space before the next category is
shown.
In the same template you also set up how the product overview in a category is shown.
Beneath there is simple example on how this can look:
26

{product_loop_start}
<br />
{product_thumb_image}
<br />
{product_name}
<br />
{product_s_desc}
<br />
{product_price}
<br /><br />
{product_loop_end}
The products for the selected category is shown beneath each other. The elements that are
shown is the product image in a small thumnail ({product_thumb_image}), the name of the
product ({product_name}), a short description of the product ({product_s_desc}) and the
price of the product ({product_price}).
To display products a simpel view can look like this:
{product_name}
<br />
{product_thumb_image}
<br />
{product_price}
<br />
{product_desc}
<br />
Here the products are shown with a name ({product_name}), a picture of the product
({product_thumb_image}), the price of the product ({product_price}) and a description
of the product ({product_desc}).
Add to cart and Ajax cart
You can also add an add to cart button - you must first make a template in the section Add to
cart. When it is created you can place the add to cart button on your product page by adding
the tag: {form_addtocart:templatename} and replace "templatenavn" with the name of the
template you have created.
27

You can also create template for your Ajax cart. An Ajax cart is a pop-up that is shown,
when you have added something to the basket. In the configuration you can activate Ajax cart
under the tab General.
This is what an Ajax cart can look like:

The cart appears when you have clicked on Add to cart and you can now choose to go to the
cart overview or continue shopping
If you have added attributes to your product, you will be able to select them in this window.
For products without attributes you must create a template in the section Ajax Cart Box. Here
the tags {show_cart_text}, {show_cart_button} and {continue_shopping_button} be added.
For products with attributes, you must create a template in the section Ajax Cart Detail Box.
Here you can add the tags: {attribute_template:attributes} (the templates for your attribute
selector) and {form_addtocart:add_to_cart} (the template for your add to cart button)
With these change you can now make use of the Ajax cart.
Editing your templates
You have several options to edit your templates. First off you can find the templates in the
administration under Templates. Here you can edit the content with Joomlas own editor.

28

You can also access the templates with your FTP client, download the files and edit them in an
editor such as Notepad++, Komodo Edit, Dreamweaver or any piece of software that can edit
HTML and PHP files.
You can find the files on the FTP server by accessing the folders Components > com_redshop
> views and then find the view you wish to edit. Afterwards you access the tmpl folder and
then the folder for the specific view you wish to edit. In the example below, we have shown
the path to the file where you edit the cart view.

More on templates
At the end of this manual, you will find a reference list for all the tags you can add in the
product templates and other templates you find in redSHOP.
In the templates you have the option to add HTML around the tags. You can set <H1>, <B>,
<I> and other html tags around your redSHOP tags. You could also build up the template in a
table and place the tags in the tablecells. You could of course also set it up with DIV elements
instead. This procedure demands a little bit of HTML and CSS knowledge but if you do know a
little about HTML and CSS, you have many options to build up a very nice category and
product display. There is a lot of tutorials for HTML and CSS on the internet that can help you
along.
Fields
The Fields option is used to add new product information. Maybe you need to add extra
information about your products other than the information that it is possible to type in by
default.
To do this you must go into Fields and pick Add field and then the next screen appears:
29


Here you can type in the information about the field you wish to create. There different options
for the fieldtype, as it can be a text field, a text area, a checkbox and several other options.
You can also decide which section the field should be used in. In this case it is for product
creation but it is also possible to make new fields for user creation, manufacturer and other.
Then you have the can set up that the field is displayed on the shop, by adding it in your
template - in the overview of product tags you will be able to see the tags for the fields you
have added yourself.

When the fields are created and added to your template it is now possible to use it under the
product creation. If you select a product template the new field appears in the tab Fields and
you have the option to type in the information about the field.


Text library
If you have text pieces that are re-used on your products, that you do not want to write again
and again, you can make use of redSHOPs Text Library In this part you can create Tags that
can be used in your templates.
30


Above there is an example of a tag that can be used on your templates. The tag name must be
inserted in your template where you want the text to appear. The tag name must be enclosed
by {} - in this case it will be {novat}.
You can choose to add tags to product templates, category templates or newsletter templates.
Advanced editing of redSHOPs language files
Besides these options there are some advanced editing options for redSHOP that involves
editing of the files installed with redSHOP. Therefore we recommend that only advanced users
with knowledge of editing files with FTP clients uses these options.
First off you have the option of editing the messages and texts that you find in redSHOP.
These can be edited in the installed language files.
If you wish to edit a language file you must log in with your FTP client and find the file:
language > en-GB >en-GB.com_redshop.ini (replace en-GB with the language you run
your shop in.)
This file contain the textmessages that are shown on the front of redSHOP. A text message can
look like this:
CREATE_ACCOUNT = Create Account
31

The text in front of the = is the "code" that tells redSHOP which text string must be used and
the text after the = is the message that is shown in the front of redSHOP.
On the other hand, if you wish to edit the text you see in the administration of redSHOP, you
must find the file here: administrator > language > en-GB > da-DK.com_redshop.ini.
PLEASE NOTICE! When you upgrade redSHOP, you language files will be overwritten.
So create a document where you note which strings you have changed, so you can
easily change them again.
Overrides for redSHOP
An advanced option is to edit the view of modules and components with overrides. Here you
must copy a specific file over to your template folder. If you wish to make an override on a
module, you must copy the file from modules > (module name) > tmpl. The file is called
default.php and copy it over to your templates folder under html > (module name)
If you wish to edit a view in the redSHOP component you must find the file components >
com_redshop > views > (view name) > tmpl. The file is called default.php and must be
copied over into the template folder under html > com_redshop > (view name).
Afterwards you can edit the files in their new folders and the changes will then affect the view
of the site. Please notice, if you update redSHOP and these files have been updated you must
go through this proces again, to get these changes. So remember to backup any overrides you
make.
32

VAT
When you edit VAT, you must first enter the configuration and open the tab VAT. Here you
select the default country, default state and the default VAT group. You can also select how the
VAT should be calculated.

Hereafter you can go into the VAT group menu and create a new VAT group. There is already
a group created called default which is chosen as the default VAT group in the configuration.

To add a new country specific VAT rate, you must click on the Tax icon in the top right corner.

Afterwards you will be taken to an overview of VAT rates for countries ands states. Right now
there probably is not anyone present on the list, but you can click on New and then create a
new VAT rate.

In these fields you must pick the country you wish to create a VAT rate for, then the state,
then select whether the country is member of EU and finally enter the VAT rate.
The VAT Groups can be used to differentiate between different product groups, if you need to
specify VAT for product groups.
If you go into a product, you can now select a VAT group for the product.
33

34

Add manufacturers

For some shops it can be important to show which product brands they have in stock. For
example it would be ideal to show which brands that are in stock for a clothing store. This can
be added under Manufacturers.
In this section you can also fill out information about the manufacturer in the Description
field. You can also add an image with the editor that is associated with your Joomla
installation.
The manufacturer detail view page can be edited in templates.
You can also edit the viewing of the manufacturer list under templates. The manufacturer
detail view is set up the same way as you set up templates for products and categories.
To edit the layout of the template that shows a list of manufacturers in redSHOP you must
create or edit a template which belong to the section Manufacturer. The detail view for
manufacturer is set up in the section Manufacturer detail while the viewing of the
manufactuers products is set up in the template section Manufacturer products.
35

Catalogs and colour samples

In redSHOP you can give your customers the option to have a catalog sent from your shop.
The advantage by doing this through redSHOP is, that on the same time you can set up the
possibility to use action mails which will be sent out after a certain number of days, after the
catalog has been sent.
The first step is to create a catalog, that you wish the customer can select. This is done under
the menuitem Catalog management and then on the item Catalog and finally by clicking on
New.

On the next screen the name of the catalog you wish to use, is added.
To add a catalog in PDF format, you go back to the overview of the catalogs.

Here you click on the media-icon next to the catalog you wish to edit. When you have clicked,
a list appears of the attached media to this catalog. Then you can click Add which brings you
to a screen where you can add media.
36


Select the media element from your server, by clicking on the icon next to Media Bank or add
the document or image you wish to use for the catalog. Remember to change the media type
depending on whether you wish to attach a document or image.
When you press save you are brought back to the list of mediafiles attached to the catalog.
Now the users are able to request catalogs, but first you need to create a template for the
page where this request is made. This template must be placed in the section Catalog. In here
you can add the tags: {catalog_select} (displays a list of available catalogs), {name} (field
used for typing in the name), {email_address} (field for typing in the email) and
{submit_button_catalog} (button for registering the request).
Afterwars you must add a menuitem in Joomla for the catalog (read more about this proces in
the chapter: Integrate your Joomla website with redSHOP.
When this is done, the users can go to the page where the request form to your catalog is and
order it. Then the catalog will be sent with a mail (you must create a template for this mail in
the mailcenter: it is in the mailsection: Catalog send mail)
In the configuration under the Catalog tab you can insert the number of days before the
person who has received the catalog, must get a reminder about you sending them a catalog.
You can create two different reminders and attach discounts to the reminders, which the users
can use if they wish to use your shop.
You are able to see a list of the persons who have ordered your catalog under Catalog
management and Catalog request.
37

Inventory management


In redSHOP you have the option of controlling your stockroom and adjust the number of items
you have in stock. Please note that you have to turn on stockroom management in the
redSHOP configuration, before you can use the stockroom feature. At first you must
create the stockrooms you wish to control. This is done by clicking on Stockroom, then on
Add stockroom and finally this screen will appear:

On this screen you can type in the name you wish to use for your stockroom. It can be the
name of a specific group of items that all have the same delivery time or it can be a name
which cover all the items in your line of products.
Container start date:
Next you can type in how long the delivery time is for the items in the stockroom - it can be in
either days or weeks and you can set both the minimum and maximum delivery time.

After having created one or more stockrooms, you will find the tab Stockroom under your
products. Here you can add the number of items you have in stock.
38

Users and userregistration

Users

Under the User tab you have the option to see an overview of the users that are registered in
the shop (User listing). In this overview it is possible to see the names and usernames for
the users as well as which shopper group the user is signed up to and how much they have
bought for.

It is also possible to sort and filter the list in different ways - for example you can have the
users for specific shopper groups shown and have the users that are not yet accepted in
redSHOP. Of course you can also search for specific names.
You also have the option to manually add a user in redSHOP with the feature Add user. Here
you can manually add a new user, if you need to.
Du har også mulighed for manuelt at tilføje en bruger i redSHOP vha. punktet Tilføj bruger.
Her kan du manuelt oprette en ny bruger, hvis du har behov for det.
39


In the tab Billing information you have the option to put in paying information on the user -
both name and address.
If you have Joomla users you wish to import into redSHOP you can use the option
Synchronize Users and then the Joomla users in your system will be created as redSHOP
users.
Shopper Groups
You have the option to place your registered users in specific shopper groups. These groups
can gain special advantages such as discounts and you can give them special access to certain
product categories.
You create a new shopper group in Add Shopper Group and then the following screen will
appear:
40


In this part of the screen you type in the name of the shopper group and select whether the
group should be placed as a subgroup in the shopper group structure.
You can also select whether the group is for private customers or companies.
In the section Shopper Group Category you can attach categories to specific shopper
groups. This means that these product categories only will be visible for the shopper group.
Shoppergroup cart item ID override is for advanced users only. It is used for shops where
you have the need to show the cart module in different ways. Thereby you have the option to
differentiate the view of the cart module depending on which shoppergroup you are member
of.
Shopper Group URL points to the direct link for the shopper group - this only works, if you
have turned on Shopper group portal.
You can also turn on a default shipping rate. This can be used if you for example have a group
for loyal customers who you wish to reward with a lower shipping rate.
41

Checkout Itemid is for the rest of the checkoutprocess. If you specify an ID here you can
differentiate the checkout view for the different shoppergroups.
It is also possible to set up whether the shoppergroup must be Tax exempt and whether the
shipping rate must be tax exempt (Tax exempt shipping)

In the next part of the creation proces you can add a logo to the shopper group. You can also
make an introduction text and a longer description of the shopper group.
An overview of the created shopper groups can be found in Shopper Group Listing.
REMEMBER to add the group you wish to use as default shopper group in your
redSHOP configuration. You can change it under the tab: Shopper Group.
The shopper group you pick as default shopper group, will be used for visitors that are not
logged in and therefore not a part of a shopper group.
42

Discounts, coupons and vouchers

Discounts
If you wish to set up a rule for when a customer should gain a discount when shopping, you
should use this feature.
You can set up your own discount rules in Discount. Here is an example of a discount rule:

This rule specifies if the customer orders for more than 500$ there will be applied a discount of
10%. It is also possible to give discount for a specified amount instead of a percentage.
Furthermore it is possible make the discount run for a certain period of time - for example with
X-mas shopper discount in the month of December.
Finally it is possible to select which shopper groups the discount should be available for. If you
wish that guests who are not logged into the system also should be available for discount, you
must go back into the Configuration and to the section Shopper Groups. Here it is possible
to select a default shopper group that all visitors on the site are put into, if they are not logged
in and therefore not put into a shopper group.
Coupon
Coupons are discounts that can be sent to your users. You can add a discount for specific users
or make the discount global thereby enabling all users who have the code, to gain the
discount.

43

You add a new coupon by going into Coupon and choose Add Coupon. Then you will be
brought to the following screen:

The Coupon code: is the code the users must type in when they complete their order. Then
you must choose if they will be given a certain percentage in discount or a specific amount. At
the same time the coupon can be se to be valid for a certain timeframe. Under Coupon Type
you can pick whether the coupon is for everyone or only a specific user. If you decide the
coupon should only be valid for a certain user, you must type in the name of the user in the
field User - when you have typed in the first letters of the name, you will get suggestions to
names you can pick. Coupons Left refers to the number of coupons that are available in the
system.
Voucher
The Voucher feature has some of the features that you find in coupon. The difference is that
you can attach the discount to specific products instead of specific users. The selection of
products is done under the tab Voucher product.
44


Giftcard
You also have the option to add giftcards to your shop. This gives the customer the
opportunity to purchase a giftcard, that can be send to a friend. When the purchase is
completed, an email address that the card must be sent to, is typed in and when the purchase
is completed, the card is sent to the recipient.
Products on sale
If you wish to put a product on sale there is two different ways of achieving this.
The first way is a manual editing of all the products you wish to put up for sale. When you
enter the editing of the product, you can check off, that the product must be on sale. Then you
set a discount price beneath the price that you normally use. Furthermore you set a timeframe
on when the discount must be in effect (a start and an end date)

The above method works fine if you only have a few products you wish to add for sale.
However, if you have multiple products or productgroups there is another and quicker way to
add multiple products for sale.
If you unfold the product overview in your left menu, you will see the option to select Mass
Discount
45


In this area you have the option of adding a new saleprice, that is attached to multiple
products at the same time.

Discount type can be set to be either a total price that is subtracted from the normal price or a
percentual amount that also is subtracted from the normal price. The discount amount is either
the total amount or the percentual amount.
46

The period of the discount is set with both a start and end date.
The products are selected either individually or by picking categories or manufacturers.
47

Order and order status
When you receive an order in redSHOP it will be placed under Order and Order listing.
Order listing
In this list you can get an overview of the orders that have been made in the system. For the
sake of clarity you have the option to sort by order ID, name, order status and order date.
Furthermore you can chose to only show orders with a set order status.

In the same place you can type in a search term in Filter and thereby getting all the orders
that contain that word shown.
Update orders
When you have located the order you wish to edit, e.g. if the payment is accepted and you are
ready to ship the item to the customer, you click on the order id in the order listing:

Afterwards you will be brought to a page with information on the selected order:

48

Here you can change the payment status (if you have received a bank transfer) and you can
change the order status as well. In this example we are about to change the status to
Shipped because we have received a payment and are ready to ship the item to the
customer.
You can of course also see the information on the user who has placed the order. You can see
both billing address and shipping address.

If you click on edit, you have the option to change the shipping address. If the billing address
must be changed, the customer must do it himself or you can do it under User listing.
Further down in the order details you have other options to change the customer's order.

You can delete a product from the order (with the red cross) if the customer wants to have a
product deleted from his order or you can update the number of products in the order (with
the green icon).
You can also add a new product to the order:

You select the product in the dropdown box, update the quantity and press add.
Offline orders
If you for some reason need to put in an order for a customer, eg. if you run a showroom and
want to give the customers the option to pay on the spot, you can add an order for them
through the backend administration by clicking on Add order. Here you can type in
information about the customer or select a customer that is already created as a user.
49

After typing in the info, you must click on save beneath the input boxes.
When the userinfo is saved, you can now select the products the customer wish to buy and set
the order and payment status.
Order status list
In this list you can see all the order statuses it is possible to use in the system. You also have
the option to add your own order statuses.
50

Downloadable products
The first step towards making a product available for download, is to add the file there must be
available for download. In the product overview you click on the Media icon next to the
desired product. Then this overview appear.

Here you can click on add which brings this screen forward

Here you can either choose to click on the icon Explore Download Folder to find a file that
has already been uploaded or upload a new file with the media-uploader beneath. The
advantage by using a file that has already been uploaded, is that you can upload larger files to
your system via FTP and then select them here.
In Media type you select Download
Furthermore you must select your product and pick the tab Producttype. Here the
producttype is changed to File and you can se Product for download to being yes.

51

You also have the option to upload a CSV file with serial numbers.
Finally there must be created a mailtemplate, for the mail that is sent to the user, where the
link to the file available for download is placed.
When the user chooses to purchase the product that is available for download he will receive a
mail where the link to the file is available.
52

Add new countries and states
If you have the need to add more countries to your webshop, you can add them under
Country and State.
To create a new country, you must type in the name of the country and two countrycodes: one
with 3 characters (e.g. GBR) as well as a countrycode with two characters (e.g. GB).
To add a new state you must select State where you first select the country the state belongs
to and afterwards you write the name of the state. In the creation of the state you must also
type in two countrycodes with 3 and 2 characters.
53

Mailcenter
All the mails that are sent from redSHOP can be edited in Mailcenter.
If you for example wish to edit the mail that is sent as order confirmation you can select the
template from the section Order Mail (or make a new template and place it in the section
Order Mail).


In the editor you can edit the content of the order mail. By default it is set up in a table in
HTML where you can edit the content. It is also possible to put in pictures and other elements.

In the mailcenter there is a lot of other mailtypes you can edit. For example mails for
registration, send to a friend, order status mail and much more.
54

Newsletter

Please notice that it is required that you install the module for newsletters
(mod_redshop_newsletter) before your users can sign up for the newsletter from the
webpage.
When you have selected the item Newsletter you will see the following overview in the left
part of your screen:

To send a newsletter the first thing you need to do is, to add a newsletter that must be send.
By clicking on Add newsletter you can create a new newsletter.

In the editor you can write the text for the newsletter you wish to send out. Here you can use
the tags: {username} for the username of the recipient of the newsletter and {email} for the
email of the recipient.
As you can see, you can also select a template - you have the option to create this in
Templates Here you create a new template, make the design around the newsletter (for
55

example a logo in the top) in HTML codes. Then you insert the tag {data}in the template
where you wish the text of the newsletter should be inserted.
The Newsletter listing shows an overview of the newsletters you have created and can send
out.

To send out a newsletter you must click in a checkbox next to the name of the newsletter.
When a newsletter is selected you click on the Send Newsletter button which can be found at
the top of the page:

After clicking on the button you are send to a screen where you can set up filters for whom the
newsletter should be send to. There are several different filters you can adjust, thereby
selecting which users you wish to send the newsletter to and which users to exclusde.
Below you can see the screen where you can select the different filters:
56


As you can see there are several options to filter the users. You do not need to fill out all the
filters.
You can also get an overview of the subscribers by clicking on Newsletter subscribers
listing and you can manually add new subscribers with Add newsletter subscriber.
Furthermore there is an option to see statistics on the number of sent out newsletters versus
the number of the sent mails that have been read be the recipients.
There is a module attached to the newsletter, where you can give your users the option to add
their email addresses for the newsletter subscriber list.
Read more about modules in the chapter: Modules and components for redSHOP.
57

Shipping setup

In Shipping you can set up shipping rules. First you select the shipping plugin you use for the
shop. Then you select Shipping rate in the top of the site.
Then you can add new shipping rates. After clicking on New you have the option to add a new
shipping rule:

Above you can see an example that is based on the weight of the shipping. Here the price on
the shipping is set to a certain price as the weight does not pass 5 kilo. You should of course
also make a rule of what happens when the weight surpasses 5 kilo.
The price on the shipping rule is set under Shipping Rate.
58


There is many ways to set up shipping rules in the system. For example you can set a specific
price to deliver products to international customers or give free shipping if the order total
surpasses a certain amount.
The Shipping Priority sets up which priority the shipping rules must be checked in. A rule
with a priority of 1 will be checked by the system before a rule with the priority of 2 which will
be read before a rule with the priority of 3 and so forth. It is important to note if you have
many shipping rules in the system and make sure the correct rules are checked first.
Furthermore you can set up whether the rule must only be present for companies and you can
choose if there should be VAT added to the shipping rate.
59

Payment gateway setup

There are several options to set up payment in redSHOP.
By default you have the option to set up several payment options for the customer. For
example bank transfer and PayPal transfer. Both can be set up very quickly.
Installation
To install a new paymentplugin you must first go into the Payment Gateways section in the
administration and add a new plugin which you have in a compressed file.

After the installation, the new payment option will appear in the list of payment gateways.
Bank Transfer
In bank transfer you insert the information about your bank in the text field in the plugin. You
type in the name of your bank as well as your account information.


Epay setup
A second option is to install a plugin that gives the customer the option to use a creditcard.
You have the option to use a plugin for the payment gateway ePay.
60

In the Configuration for the plugin you have several options to adjust the payment options
through ePay:

If you wish to test out this payment option a Merchant ID can be obtained by contacting
sales@epay.dk.
PayPal setup
The PayPal plugin is installed the same way as the other payment plugins
61


In the configuration you can type in the Business ID for PayPal (the email that is attached to
your PayPal account). Test Mode should be set to yes, as long as your site is under
development. When you are ready to go live with payments you can set Test Mode to no.
Under the details for the plugin and in Payment Extra Info you have the option to adjust the
information that is send to PayPal from redSHOP. This part is only for advanced users.

For example the values for the following information looks like this:
Order id = $order->order_id
Order number = $order->order_number
Order total = $order->order_total
This information must be linked with the values in PayPal. E.g.:
"order_id" => $order->order_id
Here is some more examples of information that can be sent between redSHOP and PayPal:
First Name = $billingaddresses->firstname
Last Name = $billingaddresses->lastname
Address = $billingaddresses->address
You can also create database queries like this:
62

# First create database object
$db = Jfactory::getDBO();
# write joomla supported sql query
$q_oi = "SELECT * FROM #__redshop_order_item ";
$q_oi .= "WHERE #__redshop_order_item.order_id='".$order->order_id."'";
$db->setQuery($q_oi);
$items = $db->loadObjectList();


63

Integration with E-Conomic

E-Conomic is a webbased accounting software that is developed for smaller and middle-sized
companies. E-Conomic has the same features as traditional accounting software but uses the
advantages of being webbased. You do not need to install any software and the program is
available anywhere.
In redSHOP it works like this: When an order is confirmed in the webshop, the customer will be
created as a debotr in E-conomic. Then an invoice is created that is put into redSHOP and sent
out to the customer. When the order is paid the order is updated and recorded automatically in
E-Conomic.
Thus a large part of the work with the webshop is automated.
The first step towards integrating e-conomic with redSHOP is to set up the configuration of e-
conomic. You need to input values in the following settings:
Accounting year: Here you must enter the financial year, e.g. April 2010 - March 2011
Product group: The product groups must be set up to control the VAT system for specific
product groups. If you have a product group that has a certain VAT rate and another product
group with a different VAT rate, this is where you set it up. If all your products have one
specific VAT rate or no VAT rate, you can choose only to set up only one product group.
Customer group: You must also set up customer groups. It is up to you how many or which
groups you wish to make.
Payment terms: Payment terms are shown on the invoice to show which type of payment
method that has been used (cash, split payment etc.)
Design and layout: In this area you must set up how the design of the invoice must look.
Units: Here you set up the product measurements like kilos, pounds, cm, inches.
Cash book Number: This is the id for the cash book you use for accounting in your webshop.
Account Number: Here you must set up the account numbers for account with VAT and
without VAT respectively.
Contra account number
This requires that you log into your e-conomic administration and adjust these settings. You
can choose to pick a Default accountplan for a business and trade company and
thereafter Accounting year and Payment terms are the only settings you must set up.
In the configuration in redSHOP you can select the tab E-conomic and type in your
userinformation for your E-Conomic account.
64


Then you can import all your products into E-Conomic by going into Products and then select
Import products to E-Conomic.
65

Import / export data
If you do not wish to edit the information for your products and categories in the redSHOP
administration, you have the option to do it with Excel instead. If you have typed in a number
of products, you can export them and continue working with the product and category creation
in excel.
First you select the option Import/Export - here you can select Data export and then select
if you wish to export products, categories, attributes or related products. When you have
chosen of the options you click on Export - then you will be asked to save the CSV file
somewhere on your computer.
You can import this CSV file into Excel continue working with it from there.
To import the CSV file to Excel, you must first open up Excel and create an empty document -
it is important that you do not open the CSV file directly but import it. (Please note
that the screenshots below is from a Danish version of Excel)

You must first go into the tab Data and choose From text. Then the following window will
appear:
66


Here you must select Delimited as the original datatype. The File Origin must be UTF-8. Now
you must click on next and you will taken to the next window.

67

Here you must choose that the Delimiters is commas. Click on next again and then finish
and then you are ready to edit the content of the CSV file.

Here you can edit the content of your products and you are able to add new products after the
already existing products. If you look at the products that are already created in the CSV file,
you will be able to see the how the CSV file is build up and you will easily be able to create
new products.
The process is the same when you edit categories, attributes and related products with CSV
files.
Remember to save the file as CSV when you have finished editing it.
When the CSV file is edited you can import it back into the system by selecting Data import.
68

Statistics

In redSHOP there is several options to viewing statistics for the use of the shop.
Below you can see an overview of the statistics you can see in redSHOP:
69

Integrate your Joomla site with redSHOP

From the front page of your Joomla website you have the option to link directly to different
pages that show your redSHOP. Below you can see an example on a menu that links to
redPRODUCTFINDER, and the product categories redCOMPONENT, redMODULES and
redPLUGINS.

To link directly to a product category, you must go to the menu where you wish the link should
appear.

You are brought to a list of the links already appearing in the menu.
To create a new menu item you click on New in the top right corner.

70

Then you will be brought into an overview where you have the option to select items from
redSHOP.

When the redSHOP part is expanded you can pick elements for products, category, catalogue
and others. Pick Standard Category Detail Layout under Category. If you select Category
List Layout you will have the top categories displayed and you will be able to use this
information as a frontpage to the shop.

Then you are brought to a screen where you can type in information about the link. It is
exactly like you would normally create a menu item in Joomla.
In parameters you can select which product category that should be displayed.

Now the menu item is created and you can see it from the front end and click your way into
the specific product category.
As you can tell there several other options to link to different views in redSHOP. For example:
 User account - where the customer can see his order history, wish list among other things
 Catalogue
 Stockroom
 Manufacturer views
 Reviews
 And much more
71

A finished redSHOP

...can look like this:

This design is set up with redSHOP and the modules that belong to redSHOP. On the example
below you can see which modules that are used in the design.
72


1) The three boxes displayed here, are categories set up on the site. The front page is set to
show Categorylist layout.
2) This is the shoppingcart. It is displayed by installing the redSHOP Cart Module.
3) To allow customers to sign up for your newsletter, you must install the redSHOP
Newsletter Module on your site.
4) This module allows customers to search your site and products.
5) These modules (redPRODUCTFILTER & redPRODUCTFINDER) are addons of the module
redPRODUCTFINDER
6) The module redSHOP Product Scroller shows a list of select products.
7) Via the redSHOP Products module, you can show the latest products in your shop. You
can also chose to sort by most sold products instead.
You can read more about redSHOP modules in the next chapter.
73


In the above displayed picture we have moved one step further and are in a product category.
The way products are displayed is made from a template in redSHOP along with CSS styling.
You can read more about how you set up templates in the chapter called: Customize the
viewing of products and categories.
This template has been made by a designer. The layout is set up in a DIV setup where the size
of the frames controls how many products are shown pr line – when there is no more room the
next product is placed on the line beneath.
You can then click one of your products which will take you to the following page:


74


This page shows product details, and is also set up via a template and CSS styling.
This is just one example of how to set up redSHOP. You have the option to add or remove a lot
more information on your products and categories. The layout can be made exactly the way
you require.
75

Modules and Components for redSHOP

Along with redSHOP comes a long range of modules that give you the opportunity to expand
options of your webshop. Furthermore you are also able to use the component
redPRODUCTFINDER.
The installation of components and modules is done by going to Extensions > Install in Joomla
(where you also installed redSHOP)

And picking the file for the module or component you wish to install. .

When you've chosen your file you press ”Upload File & Install” - after this you will get a
message telling you whether or not installation was done successfully.
Now you can set up your modules like you do other Joomla modules. Turn module titles on or
off, and pick their placement as well as other options.
redPRODUCTFINDER
This component gives you the opportuity to make a virtual searchengine for your redSHOP.
After installation you can set tags and keywords as you associate with your products. Thus
giving the customer the option to search for size, color, fabric, price and product names and
other parts that the default searchfunction does not allow.
redPRODUCTFINDER also has to modules associated: redPRODUCTFILTER &
redPRODUCTFINDER.
76


redSHOP Cart module
This module controls the shopping cart. There are no settings available, but you can style is as
you wish with CSS..

redSHOP Newsletter
This module allows you to make a signup form on your site, that allow your customers to
easily sign up for your newsletter. The layout can also be modified through CSS.


redSHOP Search
This is the alternative to redPRODUCTFINDER – it is ideal if you do not have a lot of items in
your shop, or you feel that it is too much work adding tags and keywords to every single
prooduct.
Enter Category ID: Enter the ID of a category. The category you select is associated with a
template for viewing results.
Products Per Page: The number of products listed pr page.
Show Search Field: You can remove the search field if you want a category listing instead.
Show Category Field: Toggle filtering categories.
77

Show Manufacturer Field: Toggle showing manufacturer.


redSHOP Compare
Users can compare items in your webshop via the module redSHOP Compare.

Once the module is installed it will need to be activated in your redSHOP configuration. Under
modules. When this is done your customers will be able to (when they are logged in) add
products for comparison. Once added they will show up in a list in the modulebox (se picture
above.)
redSHOP Productscroller
This module shows a long row of products in a scroller. There are different settings for how
many products you want it to show, which to show and what information is shown about the
product.
There is also an option to configure how the scroller scrolls, both speed and layout.


redSHOP featuredproduct
This module shows select products in a scroller on your site. You pick a line of products you
want to show, by clicking ”special product” under a productlisting – if the module is active it
will be shown.
78


There are several options for showing the products. For example in what order the products
will line up, if the name is shown, if add to cart is shown and if price is shown.

Also the size of the product images can be adjusted.
redSHOP Magic Magnify Plus
This module adds a magnifying glass, that allows you to zoom in on pictures on the site, that
might be scaled down in size. Please note that this is a trial version of the module. To be able
to enjoy full functionality of the module, you requires a license from
www.magictoolbox.com/magicmagnifyplus/

redSHOP Manufacturer
This module acts like a scroller like the redSHOP Featuredproduct module. But instead of
products it shows manufacturers.
redSHOP Products
With this module you can show a specific number of products on the site, based on different
search criteria. You can pick which categories to show, and by new or most sold products.


redSHOP Shoppergroup Category
If you want parts of your webshop to only be accessible to certain groups of clients (ex.
Business2Business clients) you will need this module.

Via the Shoppergroup Category module you can select a Joomla menu which you only want
available for specific clients.
redSHOP Discount
This module shows the current rebate and sales rules active on the shop.
79

Finally

… we would once again like to thank you for picking redSHOP as your webshop solution. We
have spent many hours in development of this component and will spend many more on
further development.
So keep checking redCOMPONENT.com for the latest updates for redSHOP along with all our
newest modules and components that can help improve your webshop and your users
experience.
80

Appendix 1

Tags reference list for templates

Category template:
{product_loop_start} - Start the loop for displaying products in a category
{product_loop_end} - End the loop for displaying products in a category
{category_loop_start} - Start the loop for displaying categories
{category_loop_end} - End the loop for displaying categories
{product_price} - Price on the product
{with_vat} or
{without_vat} - Displays the productprice with or without VAT. Must be placed with the
{product_price} tag.
{category_main_description} - Shows the category description
{category_main_name} - Shows the name of the category
{category_main_thumb_image} or
{category_main_thumb_image_1} or
{category_main_thumb_image_2} or
{category_main_thumb_image_3} - Show the thumb image of the main category which sizes
are set in the configuration.
{product_id_lbl}{product_id} - Displays the product id
{product_number_lbl}{product_number} - Displays the product number
{product_old_price} - Used for products on sale. This shows the price of the product before it
went on sale.
{product_price_saving} - Used for products on sale. This shows the difference between the
saleprice and the old price
{category_thumb_image} or
{category_thumb_image_1} or
{category_thumb_image_2} or
{category_thumb_image_3} Show the thumb image of a category
81

{pagination} - Used for pagination if there is more than one category page
{if subcats} - Start the loop for displaying the subcategories
{subcats end if} - End the loop for displaying the subcategories

Example:
{category_main_description}

{if subcats}
<div id='subcat'>

{category_loop_start}

<li>
{category_name}
</li>

{category_loop_end}
</div>
{subcats end if}

Product template :
{product_price_table} - Shows an overview of the prices on the product (with quantity
discounts etc.)
{with_vat} - Show the product with VAT (Note that you need to use the {product_price} tag
as well)
{without_vat} - Show the product without VAT (Note that you need to use the
{product_price} tag as well)
{products_in_stock} - Number of items in stock
{if product_userfield} - Starts the if condition for product userfields
82

{product_userfield end if} - Ends the if-condition for product userfields
{product_id} - Product id
{product_number} - Product number
{product_old_price} - Price on the product before the sale
{product_price_saving} - Difference between normal price and saleprice
{product_price_novat} - Shows the product price without VAT (Can be used alone, so you can
show the product price both with, and without VAT)
{delivery_time_lbl}{product_delivery_time} - Shows the delivery time (set in the stockroom)
{wishlist_button} - Adds a button so the user can add the product to a wishlist
{my_tags_button} - Adds a button so the user can add tags for the product
{compare_products_button} - Adds a button so the user can add the product to comparison
{product_thumb_image} - Productimage (Scaled after the settings in the configuration)
{product_thumb_image_1} or
{product_thumb_image_2} or
{product_thumb_image_3}
{navigation_link_left} - Navigate to the previous product (Can be edited in the configuration)
{navigation_link_right} - Navigate to next product (Can be edited in the configuration)
{returntocategory} - Link to the products main category
{child_products} - Displays products related as parent/child

Shopping cart :
{product_name} - Name on the product
{product_note} - If the customer has typed in a message, it will be displayed with this tag
{product_sku} - Product id
{product_price} - Price on the product
{product_quantity} - Number of items added to the cart
{product_tot_price} - Total price on the product (If more than one item of the product is
added, the price on the items are added together)
{product_attribute} - Shows selected attributes
83

{product_accessory} - Shows selected accessories
{product_wrapper} - Shows selected wrapper
{product_userfield} - If the user has typed in something in a product userfield, it will be
displayed with this tag
{product_image} - The product image
{remove_product} - Button for removing the product from the cart
{coupon_code_lbl} - Shows text for coupon code
{if discount} {discount_lbl}{discount}{discount end if} - If there is a discount, the content
between these tags will be displayed.
{totalpurchase_lbl} - Shows the text for "total". The text can be changed in the language files
{if vat}{vat_lbl}{tax}{vat end if} - If there is VAT on the order, the content between these
tags will be displayed.
{shipping_lbl}{shipping} - Shows the shipping rate
{total_lbl} - Shows the label for "total". The text can be changed in the language files
{newsletter_signup_lbl} {newsletter_signup_chk} - Sign up for the newsletter checkbox.

Order details:
{product_name} - Product name
{product_note} - Product note (if the customer has added text)
{product_sku} - Product id
{product_price} - Price on the product
{product_quantity} - Number of items of the product
{product_tot_price} - Total price of the productunit
{product_attribute} - Shows the selected attributes
{product_accessory} - Shows the selected accessories
{product_wrapper} - Shows the selected wrapper
{product_image} - Displays the product image
{order_information_lbl}
{order_id_lbl}
84

{order_number_lbl}
{order_date_lbl}
{order_status_lbl}
{billing_address_information_lbl}
{shipping_address_info_lbl}
{order_detail_lbl}
{product_name_lbl}
{note_lbl}
{price_lbl}
{quantity_lbl}
{total_price_lbl}
{order_subtotal_lbl}
{if vat}{vat_lbl}{order_tax}{vat end if} - If there is VAT on the order, the content between
the tags.
{if discount}{discount_lbl}{discount end if} - If there is discount on the order, the content
between the tags will be displayed.
{shipping_lbl}
{total_lbl}

Ordre kvittering:
{product_name} - Product name
{product_note} - Productnote (if the customer has added a customer note)
{product_sku} - Product id
{product_price} - Price on the product
{product_quantity} - Number of items of the product
{product_tot_price} - Total price on the product
{product_attribute} - Selected attributes
{product_accessory} - Selected accessories
{product_wrapper} - Selected wrapper
85

{order_number_lbl}{order_number} - Ordrenumber
{order_id_lbl}{order_id} - Order id
{delivery_time_lbl} {delivery_time} - Delivery time (set in the stockroom)
{if discount}{discount_lbl} {order_discount}{discount end if} - If there is discount on the
order, the content between the tags will be displayed.
{if vat} {vat_lbl} {order_tax}{vat end if} - If there is VAT on the order, the content between
the tags will be displayed.
{shipping_lbl}

Manufacturer
{manufacturer_name} - Name of the manufacturer
{manufacturer_image} - Displays the image of the manufacturer
{manufacturer_image_1} or
{manufacturer_image_2} or
{manufacturer_image_3}

Fabrikant produkt liste
The normal tags for the product display applies here
{manufacturer_image} eller
{manufacturer_image_1} eller
{manufacturer_image_2} eller
{manufacturer_image_3}

Stockroom products
{product_thumb_image} - Displays the product image
{product_thumb_image_1} or
{product_thumb_image_2} or
{product_thumb_image_3}

86

Related products
{relproduct_old_price} - If the discount is turned on, this will display the normal price
{relproduct_price_saving} - Saving on the product if discount is turned on
{relproduct_price_table} - Pricetable for the product
{relproduct_price_novat} - Displays the price without VAT
{form_addtocart:templet1} - Example of add to cart link. Can be edited in the specific
template
{relproduct_image} - Displayes the image of the related product
{relproduct_image_1} or
{relproduct_image_2} or
{relproduct_image_3}

Accessory products
{accessory_product_start} {accessory_product_end} - Start and end tag of accessory
products. The content between the tags, will display the accessory products.
{accessory_title} - Name of the accessory product
{accessory_image} - Image of the accessory product
{accessory_price} - Price of the accessory product
{accessory_short_desc} - Short description for the accessory product
{accessory_readmore} - Read more link for the accessory products
{accessory_attributes}{accessory_attributes_with_image_scroller} - Attributes on accessory
products
{accessory_add_chkbox_lbl}{accessory_add_chkbox} - Add accessory product checkbox

Attributes
{attribute_title} - Title for the attribute
{property_dropdown} - Dropdown that displays the available properties
{subproperty_start}{subproperty_end} - Start and end tag for sub-attributes
{property_title} - Property title
87

{subproperty_dropdown} - Subproperty dropdown

Frontpage category display
{category_frontpage_loop_start} - Start category loop for frontpage categories
{category_frontpage_loop_end} - End category loop for frontpage categories
{category_frontpage_introtext} - Category frontpage description
{category_thumb_image} - Category image
{category_thumb_image_1} or
{category_thumb_image_2} or
{category_thumb_image_3}

Wishlist template
{mail_link} - Button for e-mail link
{product_loop_start}{product_loop_end} - Start and endtag for list of products
{back_link} - Back link
{product_thumb_image} - Product image
{product_thumb_image_1} or
{product_thumb_image_2} or
{product_thumb_image_3}
{product_name} - Name of the product
{product_price} - Price of the product
{form_addtocart:templet1} - Add to cart. Linked to a specific add to cart template
{remove_product_link} - Remove product from wishlist

Reference list for SEO tags


Product
SEO

Page title

88


{productname} - Name of the product
{productsku} - Produkt id
{saleprice} - Price on sale
{saving} - Saving on the product
{manufacturer} - Manufacturer
{categoryname} - Category name
{shopname} - Name of the shop

SEO page header
{productname} - Product name

SEO page description
{productname} - Product name
{productsku} - Product id
{saleprice} - Price on sale
{saving} - Saving on the product
{manufacturer} - Manufacturer
{categoryname} - Category name
{shopname} - Name of the shop

SEO page keywords
{productname} - Product name
{productsku} - Product id
{saleprice} - Price on sale
{saving} - Saving on the product
{manufacturer} - Manufacturer
{categoryname} - Category name
89

{shopname} - Name of the shop

Category
SEO Category Page title
{categoryname} - Category name
{shopname} - Shop name


SEO Category Page Heading
{categoryname} - Category name

SEO Category Page Description
{categoryname} - Category name

SEO Category Page Keywords
{categoryname} - Category name

Manufacturer
SEO Manufacturer Page Title
{manufacturer} - Manufacturer
{shopname} - Shop name

SEO Manufacturer Page Heading
{manufacturer} - Manufacturer

SEO Manufacturer Page Description
{manufacturer} - Manufacturer

SEO Manufacturer Page Keywords
90

{manufacturer} - Manufacturer