Table of Contents


Pricing

please install flash


How to setup Worldpay

When you want to enable Worldpay in your shop you need to set a few simple configuration options.

  1. Enable the Worldpay module [Secure Credit Card Payment] in your shops administration, found in "Configuration » Finance » Payment"
  2. Now set the module to your liking and press the update button.
  3. Log into the Worldpay administration: http://support.worldpay.com/admin
  4. Click on Configuration Options for the relevant installation.
  5. Tick the "Use callback" checkbox to enable the callback facility.
  6. Enter the URL "http://<wpdisplay item="MC_callback">", into the "Callback URL" field.
  7. Make sure the "Use callback response" checkbox is ticked (enabled).
  8. Make sure that "Callback suspended" checked is not ticked (disabled).
  9. Clear the "Callback password" by ticking the "Use Default" box.

Manufacturers

please install flash


Manage Variants

please install flash

<script> var so = new SWFObject("fileadmin/knowledgebase/english/openbizbox/ver4x/video/managevariants/managevariants_controller.swf", "csSWF", "570", "375", "9.0.115","#1a1a1a");so.addParam( "quality", "best" );so.addParam( "allowFullScreen", "true" );so.addParam( "scale", "showall" );so.addParam( "allowScriptAccess", "always" );so.addVariable( "autostart", "false" );so.addVariable( "thumb", "fileadmin/knowledgebase/english/openbizbox/ver4x/video/managevariants/FirstFrame.png" );so.write("mediaflash"); </script>

 


Main Page Customization

please install flash


Price Settings

Go to "Configuration" > "Finance" > "Price Settings" where you have the following options:

Switch To Default Language Currency

If you switch to another language, the system automatically switches to the corresponding currency.

Only show prices for customers who are logged in

Hide the price for guests.

Show minimum price for variant products

If this is set to "Yes" there will be displayed the lowest price for products with variants. If this is set to "No" there will be displayed the base price of the main product.

Allow all customer with a VAT or EAN number to pay by invoice

If this is set to "No", this has to be approved per customer* and for new customers it will not be possbible to pay their first order by invoice.

*This is done via the customers list for each customer

Display Prices with Tax

All prices are either displayed incl. VAT (Yes) or the VAT amount is displayed in Sub-Total at the end of the checkout process (No).

Display Both Prices

Display the price both inclusive and exclusive VAT. Under"Display Prices with Tax" it can be selected which of the two should be emphasized.

Show VAT labels

Show "incl./excl. VAT" near all prices.

Show additional note for prices

If this is set to "Yes" an additional footnote will be displayed with the price. You can add the text for this footnote under "Additional note for prices".

Additional note for prices

The text you write here will be displayed together with the prices. This could for example be information on additional shipping costs. Whether this text should be displayed or not, can be determined under "Show additional note for prices".

 


Categories

please install flash


Order Total: Payment Type Charge

Via ”Configuration” > ”Finance” > Order Total" you have the possibility to set up a charge for the different payment methods that you use in your shop. This excludes the payment method "Credit card" (quickpay) as the payment charge for this can be set up directly in the payment module.

If you would like to add a charge to Cash on Delivery you click on the module "Payment Type Charge" and afterwards on "Edit". If the payment method 'cod' should for example cost 5,00 Euro excl. VAT you can enter "cod: 5" into the field "Payment methods and rates". You can add more charges for the other payment methods by entering their module name (you can see the name while editing the payment method), afterwards a colon ":" and at last the charge excl. VAT.

For example:

'cod:5' to charge 5,00 Euro for Cash on Delivery (excl. VAT).

In the field "Sort Order" you define in which sort order the payment charge shall be listed in the order totals. It is important to remember that the sort order not only effects the way the order totals are displayed but also the way the totals are calculated. This is very important for modules that calculate totals like charges, discounts, etc.



Add category

please install flash


Variants

please install flash


SEO

please install flash


Order Total: Low Order Fee

You can set up a low order fee if you want to add a fee to orders that are under a specific amount. If for example a customer buys something for only 2 Euro, you can decide to take an extra fee for the order handling.

This can be set up via "Configuration" > "Finance" > "Order Total" > "Low Order Fee".

 

In the field "Sort Order" you define in which sort order the low order fee shall be listed in the order totals. It is important to remember that the sort order not only effects the way the order totals are displayed but also the way the totals are calculated. This is very important for modules that calculate totals like charges, discounts, etc.

Under "Order Fee For Orders Under" you enter the minimum amount of orders to which a low order fee will be added. 

Enter the amount of the order fee into the field "Order Fee".

Under "Attach Low Order Fee On Orders Made" you choose if a low order fee should be charged for national or international customers or both.


Bundles

please install flash


Order Total: Customer Loyalty Discount

If you have customers that have bought something in your shop repeatedly, you can give them a loyalty discount. This can be set up via "Configuration" > "Finance" > "Order Total" > "Customer Loyalty Discount". 

 

 

In the field "Sort Order" you define in which sort order the loyalty discount shall be listed in the order totals. It is important to remember that the sort order not only effects the way the order totals are displayed but also the way the totals are calculated. This is very important for modules that calculate totals like charges, discounts, etc.

In connection with the loyalty discount you have to remember that if you include shipping in the loyalty discount (that means you give a discount for shipping), the sort order of the discount module has to be higher than the sort order of the shipping module, and thus it also has to be lower if you do not want to give a discount on shipping. 

Under "Cumulative order total period" you choose the period the loyalty discount shall be calculated for. This can be always, a year, a quarter or a month.

In the field "Discount Percentage" you enter a tabel which defines the percentage rate based on the total order amount from the period chosen above.

Example: 100:5,200:7.5,300:10,400:12.5,500:15

That means that a customer that has bought for more than 100 Euro and less than 200 Euro, during the period that has been defined above, will be given a discount of 5 %. Customers that have bought for more than 200 Euro and less than 300 Euro will be given a discount of 7.5 %, and so on.

Under "Include Tax" and "Calculate Tax" you choose if VAT should be included in the calculation of the discount and if there should be added VAT to the discount amount.

Under "Include current order in total" you choose whether the discount shall first be given after the current order (No) or whether the last and the current order (Yes) shall be included in the calculation.

Under "Order Status Priority" you choose the minumum order status an order should have to get included in the calculation of the loyalty discount. This is defined in numbers which you find under "Sale" > "Order status options" in the column "Priority".

 


Images

please install flash


Files

please install flash


Order Total: Shipping

Via "Configuration" > "Finance" > "Order Total" you can set up free shipping.

 

In the field "Sort Order" you define in which sort order shipping shall be listed in the order totals. It is important to remember that the sort order not only effects the way the order totals are displayed but also the way the totals are calculated. This is very important for modules that calculate totals like charges, discounts, etc.

Under "Allow Free Shipping" you can choose if you want to offer free shipping if an order weighs less than the weight and costs more than the amount that you enter into the two next fields.

In our example in the picture above, all orders, irrespective of the price, which weigh less than half a kilo get free shipping. If you only want to offer free shipping for orders over 100 Euro you enter "100" instead of "0" into the field "Free Shipping For Orders Over".

At last you choose whether the settings you have made for free shipping shall apply for national or international customers or both.


OpenBizBox - closed versus open source code

From time to time customers are expressing confusion regarding the need to go from closed to open source code with their OpenBizBox. Below is a list with some of the questions and their answer.

Question:

I want to change the way my OpenBizBox looks - then I need to have the source code opened, right?

Answer:

No, not necessarily. You are free to change all CSS-files (controlling fonts, colors, etc) and change or replace the graphical elements that controls how backgrounds, logo, bars, buttons and other things without opening the source code.

You only need open source code if you want to make some more radical changes that requires modifications in the PHP-code itself.

Spørgsmål:

Are there any inconveniences when moving from closed to open cource code?

Svar:

Very much so!

  1. Your OpenBizBox will no longer receive automatic updates. We apply small "service packs" with bugfixes and new functionality from time to time but once you decide to open the source code that has to stop: There is no way for us to test whether our changes may collide with your own changes.
  2. Support and bugfixing may become a very expensive process indeed. We normally help users free of charge if they think they may have found a bug in OpenBizBox but should we identify the root cause for an error to be within your own changes you will be invoiced the time spent at our standard hourly rates.
  3. Keeping OpenBizBox up-to-date with the latest changes manually is a job for experienced web developers. We offer a tool to assist you in tracking changes between versions (http://developer.openbizbox.com) but it requires some knowledge of the UNIX commands "patch" and "diff" to use it. Also, it is strongly recommended that all patches are tested against your own changes on a local server running a compatible UNIX-variant before comitting them to the production environment.

Alternatively you are of course welcome to keep your OpenBizBox running the way it was just before changing it to open source.

Question:

Can I change my OpenBizBox back to closed source?

Answer:

Yes, but at a very steep price: ALL your changes are deleted! in addition to that, there is a monetary price to pay for the procedure, as well as a fee should you decide to go open source again at a later point.

Question:

Using the diff-tool mentioned above I can see that I haven't changed any of the files that you have changed in later versions. Why can't you just apply the automatic updates to my OpenBizBox then?

Answer:

PHP-files are not independent, isolated entities but includes results from the execution of other files in their work. Hence, it is not sufficient to check for changes in specific files; we need to check if the files we have changed rely on data calculated by files that you have changed.

It is literally impossible to perform these checks automatically with a sufficient degree of reliablity so the only absolutely certain outcome is that we at some point will shred your OpenBizBox to a million pieces if we try that kind of updates.

And it will happen the day before your ridiculously expensive advertising campaign is aired.

Just before Christmas.

With 400 Christmas presents in your order list.

Three of which is from your Mother-In-Law.

And the rest are from Grandparents to innocent, starry-eyed children.

That was the long version. The short version: Not on our lives!

Question:

Isn't it illegal to close the source code when the project originates from GPL-licensed code?

Answer:

In this case the term "closed source" only refers to your ability to change the source code that comprises your OpenBizBox on our server.

You are free to download a copy of the source code and tweak it silly in any way you like but in order to prevent problems with the automatic updates of your OpenBizBox it is impossible to upload the changed files to our server. The term "write protected source code" would perhaps be more accurate.


How to integrate my shop with Google Analytics

The Google Analytics (GA) is the well-known system which tracks your sites usage and displays it user-friendly with numerous charts and reports. It also allows to track ROI of advertizing campaigns and/or affiliates gain. For the e-commerce sites it may output total revenue, segmented by traffic source or campaign.

OpenBizBox fully supports integration with Google Analytics. Below are the steps to integrate your shop.

Follow the next steps in order to ingegrate OBB with GA.

1. If you don't have a Google Analytics account

First you need to have an account in GA (skip this step if you already have one).

Go to google account signup, fill in all required fields. After submiting you will be sent a letter with a confirmation link. Click on it and you are inside your Google Account. Go to the «Google analytics» link and sign up there:

Click continue, enter your personal information and confirm the license agreement.

After that go directly to the step 3 of this article.

2. If you already have a Google Analytics account

If you already have a Google Analytics just need to add a new website profile:

Enter only the domain, even if your shop is installed in a subfolder.


3. Get the special code for your shop

On the next screen you will see the HTML code to insert into your site. Don't pay your attention to the code, just find your identification number which looks like: UA-1234567-8 (you will have different numbers). Store this code somewhere for the next step.

4. Set up the additional statistics for your shop

Edit your profile, set the type to E-commerce website and choose the default currency of your shop:


6. Insert the Google Analytics code in your shop

Login into your shop backend and go to Integration -> Google Analytics and:

- Set the «Google Analytics Status» to «Yes»

- Set the Google Analytics Account Number to the code you've been given.

(leave «Google Analytics verification meta tag» unchanged, you don't need it).

Confgratulations, now you have successfully integrated with Google Analytics.

All reports usually appear with a lag of two hours.


Shipping per zone/country

OpenBizBox is a webshop solution for international e-commerce. Shipping costs differ from country to country. That is why it is important to have the possibility to set different shipping costs for each country or zone.

You decide whether you would like to offer a flat fee for each country, regardless of size and weight (shipping module: "Flat Rate"), or if the shipping costs should be in proportion to weight AND shipping zone (shipping module: "State/Country/ and Weight").

Flat Rate

Go to "Shipping" > "Shipping Methods". You can edit the module "Flat Rate", by clicking on it first and afterwards on "Edit" (or first on "Enable Module" if it is disabled).

You have the possibility to change the title that your customers see, from "Flat Rate" to e.g. "Shipping costs, inland". This can be done in the first fields, for the different languages you have enabled in your shop.

In the field "Shipping Zone" you choose the zone for which the price that you enter into the field "Shipping Cost" should apply. If you don't choose a shipping zone, the price will apply for all customers, regardless of their shipping address.

In our example in the picture an inland customer would have to pay 2,00 Euro per order, regardless of the orders's size and weight.

If you would like to set up a flat fee for further countries and zones, you can copy the module. To do this you click on the module first and afterwards on "Copy". Afterwards you can change the title.

Furthermore, you have the possibility to define countries and zones yourself. In the next paragraph you will learn how to do this.

 

Definitions of zones and shipping methods 

Go to "Configuration" > "Localization" > "Zones". These modules are connected to the shipping modules, which you can set up via "Shipping" > "Shipping Methods".

Now there are the following options:

1. Editing an existing zonemodule

You can edit an existing module by clicking on it first and afterwards on "Edit", "Delete" or "Details".

  1. ”Edit”: Here you can edit the name and the description of the module.

  2. ”Delete”: This deletes the complete module

  3. ”Details”: Here you can see, which zones there are connected to this module. You can delete and add zones and and edit existing ones. If you want to edit one of the modules' zones you can click on it first and afterwars  on "Edit". If you for example edit the zone "United Kingdom"" you can decide whether all regions should be included or if you would like to  divide the zone into different regions.

2. Adding a new zone module

  1. Click on "Insert".

  2. Choose a name and description for the module.

  3. Click on "Insert".

  4. Click on the new module and follow the procedure described above.

 

Creating and editing countries

Go to "Configuration" > "Localization" > "Countries".
Here you have the following options:

1. Editing existing countries

You can edit existing countries by clicking on them first and afterwards on "Edit" (or „Delete“ if you want to delete a country). Then you have the possibility to change the name, ISO code and address format for this country.

2. Creating a new country

  1. Click on "New Country".

  2. Enter name and ISO code of the country. Afterwards, choose an address format, that is the format of the customer's address on e.g. invoices, if the customer is from this country.

  3. Click on "Insert".


How to connect states and areas to a country, you can learn in the following paragraph.

Creating states and areas and connecting them to countries

There are allocated different states and areas to the countries and these can be edited via "Configuration" > "Localization" > "States and Areas".

1. Editing existing states and areas

If you for example would like to edit the zones of the United Kingdom, you find United Kingdom in the list (by using the dropdown menu you can switch to the pages more quickly) and click on the zone you would like to edit. After you have edited it you click on "Update".

2. Creating states and areas

  1. Click on "New zone".

  2. Choose a name and the zone code of the zone.

  3. Choose a country from the dropdown menu which you would like to connect to this zone.

  4. Click on "Insert".

 

State/Country and Weight

Go to "Shipping" > "Shipping Methods". Here you can edit the module "State/Country and Weight", by clicking on it first and afterwards on "Edit".

 

 

For setting this module up for different zones you don't have to copy the module like you do in connection with "Flat rate". Instead, you can directly in the module choose how many zones you would like to set up for this shipping method.
At "Number of zones" you enter a number which represents the amount of countries for which you would like to set up the shipping costs in this shipping module.


Adding Google Sitemap

OpenBizBox has an integration with Google Sitemap. Here is a description of how you add a Google Sitemap verfication tag to your shop. 

At first you need to have a Google account. Then you have to insert a code to verify that you are the owner of the domain. In your Google account you click on "webmastertools" and afterwards on "Add a site".

 

 

You insert your domain name and click on "Continue".

 

 

Remember to copy the complete code and insert it in your webshop via "Integration" > "Google Sitemap".

 

       

 

 

 

After you have inserted the code into your shop and saved it, you click on "Verify" and Google will be ready to read your googlesitemap.php


General

please install flash


Master password

With a master password you have the possibility of logging in as your customers to for example edit their account settings or for placing an order for them.

You can set  up a master password via "Tools" > "Master Password".

 

You can enable this feature by clicking on "Allow Master Password" first and afterwards on "Edit". Then you tick the box "Yes" and click on "Update".

Afterwards you click on "Master Password" and "Edit" and choose a password. Choose a "safe" password that contains both upper and lower case letters as well as numbers. At last, click on "Update".

Now you have the possibility to log in as one of your customers on the first page of your webshop.

 

 

 

 

 


Data

please install flash


How to add affiliates functionality to my shop

You have to be integrated with Google Analytics (GA) to be able to track Affiliates revenue. The steps to integrate with GA you may find in this article.

If you already integrated with GA you are able to use affiliates.

Create affiliate URL

Go to the google URL builder and create the URL based on the:

As the result you will get an URL similar to:

http://myshop.com/catalog/?utm_source=AFFILIATE_ID&utm_medium=banner&utm_campaign=3

Send this link to your affiliates (don't forget to vary their AFFILIATE_IDs), you will not be able to distinct sales by affiliates if they all will have same URL.

Give access to reports

It could happen that your affiliate will trust you when you'll pay them, but not necessary. If someone would like to control his achievments you can give him a read-only access to the GA profile.

To give an access your affiliate must have a Google Account (see here) and sent you his Google Account email. If user don't want to create any accounts he can just register new email on gmail.com.

Go to your shop's profile in GA and click «Add user» link:

You will be asked for Google Account email of your affiliate, ask him to provide it to you (he may aleady have one, or register new). Fill his google account email and don't forget to set «Account Access» field to the «View reports only»:

 

Your affiliate will be able to track statistics for your site when logging into Google Analytics with his google account (or gmail login/passwords).

Getting total revenue gained by an affiliate

Open your shop's reports in Google Analytics. Select Traffic Sources / All traffic sources on the left. Limit the period to a needed term, group by «Sources» and click on «E-commerce» tab (see screenshot below).

You will see revenue earned for that period groupped by all affiliates:

 


Payment methods

Go to "Configuration" > "Finance" > "Payment".

Click on the line of the module you would like to edit. Then you have the possibility to enable disabled modules by clicking on "Enable module". You can disable a module by clicking on it once and then on "Disable module".

When a payment module is enabled, you can edit it by clicking on it in the list and afterwards on "Edit" on the right. By this you can also see information on the current settings. The field "Sort order" is used for determining in which order the different payment modules should be displayed for your customers during the checkout. (The lowest is displayed first.)

Pay by invoice

This module makes it possible for you to give a credit to all or only selected customers if they pay by invoice.

Cash on delivery

This payment method requires a secondary setting for adding a payment fee for cash on delivery. This fee can be defined via "Configuration" > "Payment" > "Order Total". Here you click on the module "Payment Type Charge" and afterwards on "Edit" (or first on "Enable module" if the module is disabled). Now you can define that cash on delivery for example costs 5,00 EUR excl. VAT by writing 'cod:5' in the field "Payment methods and rates". You can add more fees for your other payment methods by writing their module name (which you can see when you edit the module), followed by a ":" and at last the fee excl. VAT.

Example:

'cod:5' for charging a fee for cash on delivery (EUR 5,-) excl. VAT.


Google AdWords conversion tracking

To track your Google AdWords campaigns you can use OpenBizBox's build-in support for Google Analytics and link it to your AdWords accouont. Then Google will automatically detect your AdWord campaigns in the Analytics order tracking and record correct conversion rates.

You can read how to link AdWords to Analytics by following this link:

http://adwords.google.com/support/aw/bin/answer.py?hl=en-uk&answer=61130


General help

There are many different ways of getting help - the most important ones are:

1) If you need help with the administration of OpenBizBox you should always look at the top of the administration of your shop, the same place where you have found the link to the text you are reading right now. On many pages you find help videos which guide you through the different topics, features and settings.

 

2) It is always a good idea to use the search function of OpenBizBox if you are looking for a specific feature or setting. You find this in the upper right corner of your administration.

 

3) There is also the possibility to use our knowledge database which includes many different topics. You find it at:  http://www.goldenplanet.com/support/kb.htmlViden Database

 

 

4) You are always welcome to contact us by dropping us an email to: support@dont-want-spamgoldenplanet.dont-want-spamcom or by calling us at: (International) +44 0870 068 58 98 or (Denmark) +45 7020 9594


Products

please install flash


Editing text

The text that is shown in the OpenBizBox shops will all be generated based on information that is stored in a special language file on the server. This means that ALL text can be changed; it is simply a matter of finding the correct files.

 

Here, we will explain which files contain what and how one finds the texts that will typically be changed in a new set-up. Below, you will find a list of the files that are in a language folder, all language files and folders are in the folder:

 

includes/languages/

Danish           Danish language folder

English           English language folder

Spanish          Spanish language folder

German          German language folder

danish.php      Typical texts and headings used in the entire shop, this is for Danish texts

english.php     English texts...

espanol.php    Spanish texts...

german.php    and German texts.

 

The files for a language are located in the folder for the name of the language, for example, the Danish language files are located in the ‘Danish’ folder. If you are in doubt as to which file a certain text is in, as a rule, it is a question of searching for a file with the name that is in the address row of your browser.


Installing OpenBizBox web application

It is possible to set-up a complete OpenBizBox web application and database for it in just a few mouse clicks. The only requirement is that your web solution supports the necessary functions and has sufficient resources available.

With one click on the OpenBizBox icon you will have the opportunity to set-up an OpenBizBox web application or, if it has already been set-up, the opportunity to delete it. If an OpenBizBox web application has not been set-up yet, the system will check whether the necessary conditions for being able to set this up are in place and, in that case, whether there are any necessary upgrades:

Providing that everything is in order, click on “Yes” and the following page will appear:

Here, there is the possibility to change a number of things in connection with the installation:

The folder it shall be installed to:
The standard folder is "shop" but if, for some reason, this should be impractical you can choose another folder that shall be created in connection with the installation. Note that the folder may not contain any special characters or Danish letters.

Administrator login:
The username for administrator access to the web application, this user has the right to create users, assign rights, etc. 

Administrator password:
Password for the administrator account.

Finally, click on "Install" and after a short wait time (typically 20-30 seconds) the OpenBizBox is ready for use.


How do I create gift vouchers that my customers can buy?

Gift vouchers are treated as normal products, and created the exact same way. This feature is however not present from version 3.2 and on.
The only difference there is the demands for the "Model" field at the bottom of the create new product page.

The Model field
The system sees a product as a gift voucher when the "Model" field begins with "GIFT".
What comes after the word GIFT does not make any difference to the system, therefor there is nothing wrong in creating multiple gift vouchers of different values and using different "Model" definitions. As an example one could imagine using "GIFT10" for a 10 USD gift voucher, and "GIFT20" for 20 USD voucher.

What happens in the shop when a customer buys a gift voucher?
When a customer buys a gift voucher it will appear in the voucher queue in the administration. Here it will stay untill the admin approves the voucher (typically done after payment has been registered).
When the voucher is approved an email is send to the customer with a code. This should then be used when the customer places an order.


Manual for EasyPopulate (import/export of products)

Here you will find the manual for Easy Populate.

Please note that installation is already completed - you can go directly to the section about how to use this module.