With the Ballyhoo Commerce system you can add files to the content of your e-commerce website.

The following instructions outline how to add a file to any area of the site where you can edit and format text with the text-editing toolbar (such as a product description, category description or content page).

Preparing The File

Before you add the file to the site you must make sure it is properly named. This is good practice in general as many programs do not accept incorrectly named files.

Ensure the file has been renamed to exclude all uppercase characters and spaces between words, for example product-document.pdf instead of Product Document.pdf.

It is also helpful to save the file to an easily accessible area of your computer such as the Desktop.

Adding The File

Edit Product/Category/Content Item

In the text area type the name of the link you want the file to appear under, for example Download Brochure.

Highlight the text you have just typed and click on the Link button (located in the middle row of the text-editing toolbar). This will open a new window called Insert/Edit Link.

Insert/Edit Link

In the General tab of this window, click on the small Browse button located next to the Link URL field.

This will open a new window called Moxiecode File Manager.

Moxiecode File Manager

Click on the Upload button, located in the top-right of the window. This will open a further Upload window.

Upload

Click on Browse to select the file from your computer.

Click Upload.

Moxiecode File Manager

The file you have just uploaded will appear in the list of files.

Click on the Filename, this will bring up a preview of the document on the left side of the window.

Under the preview, click Insert.

Insert/Edit Link

You can now set the Target of the file (whether you want it to open in a same window or a new one) and add the Title of the file.

You don’t need to add anything under the Popup, Events or Advanced tabs.

Click Insert to add the file to your content.

Edit Product/Category/Content Item

You can now click Save to submit your changes to the website.

If you require any assistance you can call 0121 286 9390 or email support@ballyhoo.ltd.uk and we’ll be happy to help.

Related Articles

• E-Commerce Support: How To Add A Content Page
• E-Commerce Support: How To Paste & Format Text
• E-Commerce Support: How To Manage Product Variations
• E-Commerce Support: How To Add An Image To A Content Page
• E-Commerce Support: How To Embed A YouTube Video
• E-Commerce Support: How To Manage Categories
• E-Commerce Support: How To Add A New Product

The Ballyhoo Commerce e-commerce system also functions excellently as a content management system. The following instructions advise you how to add a basic content page to your e-commerce website.

Add A Content Page

Go to the website Admin Area and click on Content Manager in the top navigation bar.

Click on the content list to which you want to add another content page, to be found under Current Lists.

Content List Editor

Under Tools, select Add New Main Content Item.

Add New Content Item

Content Page will be selected as default under Content Type, use this to add a standard content page for information such as About, Contact, etc.

For each enabled language you will need to add:

Link Title

The link text as it will appear in the navigation.

Page Title

This is usually the same as the Link Title and appears at the top of the content page.

Content

The content of your page can be added to this field and formatted using the text-editing toolbar. Images, external links and other items such as PDFs can also be added in this field.

Click Insert to save the changes and add the new content page to your site.

Content List Editor

Change the order content pages appear in by dragging and dropping the page titles into any order you wish.

Amend any content page by clicking Edit to the right of the page title and delete a page by clicking Delete.

You can also add sub-pages to any existing content page. Simply click Add Content Item next to the appropriate page title and follow the same steps outlined above.

As a general rule the internet doesn’t appreciate spaces or a mix of upper and lower case characters in filenames. While these may work perfectly well on your computer, it is wise to rename your files before you upload them to your website.

• Change all the characters in the file name to lowercase, for example computer file.pdf instead of Computer File.pdf
• If there are any spaces in the file name you can replace these with underscores or hyphens, for example computer_file.pdf or computer-file.pdf

Making these changes should ensure that you have no problems uploading files to your website. However, if you still experience difficulty there could be an underlying issue so please get in touch for assistance.

To see a full comment in the order manager, hover your cursor over the text.

PayPal

The following is list of order comments you might see if the transactions on your e-commerce website are processed by PayPal.

Receiver of the funds does not match the vendor email address.

You may see this comment if you change your primary email address with PayPal. Orders will no longer be automatically authorised in your Ballyhoo admin area because when a payment notification is sent from PayPal we verify it against the vendor email address you have provided. It is therefore important to notify us of any changes you make to your PayPal account.

Payment status returned from gateway is not completed.

PayPal has informed us that they were unable to complete the transaction with your customer. You will have to check your PayPal account or contact PayPal for more information.

Fraudulent information provided from payment gateway.

When an instant payment notification is received by our system we verify the information directly with PayPal. This comment status indicates that PayPal did not verify the payment notification we received. We have therefore assumed there has been a fraudulent attempt to authorise an order. Please check your PayPal account for any records of this transaction and contact us immediately.

Transaction ID returned from payment gateway has already been used.

Each transaction with PayPal is given a unique transaction ID. This comment status also indicates a fraudulent attempt to authorise an order because we have been provided with a transaction ID we have already seen. Again, check your PayPal account for any records of this transaction and contact us.

Total amount or currency returned from payment gateway does not match actual values.

This status essentially means the funds taken at PayPal do not match the total for this order, possibly due to the PayPal transaction being in a different currency. Again this indicates a fraudulent attempt to authorise an order. Check your PayPal account for any records of this transaction and contact us.

SagePay Form

Order comments from SagePay are usually very concise and require no further explanation. The following is a list of comments you can expect to see.

NOTAUTHED

The Sage Pay system could not authorise the transaction because the details provided by the Customer were incorrect, or insufficient funds were available.

MALFORMED

Input message was missing fields or badly formatted – normally will only occur during development and vendor integration.

INVALID

Transaction was not registered because although the POST format was valid, some information supplied was invalid. e.g. incorrect vendor name or currency.

ABORT

The Transaction could not be completed because the user clicked the CANCEL button on the payment pages, or went inactive for 15 minutes or longer.

REJECTED

The Sage Pay System rejected the transaction because of the fraud screening rules you have set on your account.

AUTHENTICATED

The 3D-Secure checks were performed successfully and the card details secured at Sage Pay.

REGISTERED

3D-Secure checks failed or were not performed, but the card details are still secured at Sage Pay.

ERROR

A problem occurred at Sage Pay which prevented transaction completion.

SagePay Server

If your e-commerce website runs the SagePay Server Integration to take payments, you can expect to see the following comments in your order manager. Again, these are usually self-explanatory.

Tamper detected.

When a payment goes through SagePay a summary of the transaction is returned. If this doesn’t match the information you have stored in your system the ‘Tamper Detected’ comment will appear. Check your SagePay account for more information and contact us.

DECLINED

The transaction was not authorised by the bank.”

ABORTED

The customer clicked Cancel on the payment pages, or the transaction was timed out due to customer inactivity.

REJECTED

The transaction was failed by your 3D-Secure or AVS/CV2 rule-bases.

ERROR

There was an error during the payment process.

UNKNOWN

An unknown status was returned from Sage Pay.

2013

The transaction was cancelled by the customer

2000

The authorisation was declined by the bank

If your Order Manager has displayed a comment that is not listed here or you want further clarification on any of the comments, get in touch and we’ll be happy to help.

Customers Within the UK

If a customer places an order on your site to be dispatched within the UK, VAT will automatically be added to the order at the current rate.

Customers Within the EC (European Community)

Customers wishing to have thier goods dispatched to another EC Member State fall under the intra-Community supply rules. In such a case, the customer will be asked to provide an EC VAT registration number. If they are VAT registered in their respective country they may provide their registration number in order for VAT to be removed from their order.

However, it is your responsibility as the vendor to make reasonable attempts to ensure the registration number is correct. We recommend using the VAT Information Exchange System (VIES) provided by the Taxation and Customs Union to check that the number is valid before dispatching any goods within the EC.

Customers Outside of the EC (European Community)

Any order to be dispatched outside of the EC will not have VAT applied.

Pasting And Formatting Text

Edit Product

In the text-editing toolbar there will be a button named Paste As Plain Text. Click on this.

Paste As Plain Text

Now paste in your copied text by pressing Ctrl+V or clicking with the right mouse button and selecting paste. All font formatting will be removed, as well as any unwanted code.

Click Insert.

Edit Product

You can then format the text using the text-editing toolbar to output your pages exactly as you wish them to look.

Using the text-editing toolbar you can make words bold, italic and underlined exactly as you would when writing a text document. You can make bullet and number lists, align the text and make use of headings that have been defined to match your website.

Users familiar with HTML can do advanced formatting by clicking the HTML button to edit the code directly.

You can clear any formatting by highlighting the text and clicking the remove formatting button.

Using this process each and every time you paste text will ensure consistency throughout your website and, most of all, prevent errors in the pages.

If you need further assistance please contact us and we will be happy to help.

As an online retailer you may often sell certain products in different sizes, colours or specifications. Make it easy for your customer to select the product they want by clearly showing the variations of every product. Ballyhoo Commerce allows you enormous flexibility to manage the variations of your products. Please view our short instructional video or read the guide to learn how to successfully do this.

Managing Product Variations

Starting at your Ballyhoo Dashboard, click on Product Manager.

Product Manager

Then select from the Product Title list the product you want to create variants for.

Edit Product

Click on Manage Variations.

Variation Editor

Select Create Primary Variation.

Add New Variation

Enter a Title for the variation, for example Colour.

Enter the Label Text if you wish, this is what is shown beside the selection box on the product page. If you enter nothing the title will be used as default.

Click Insert.

Variation Editor

Now click Add Variant beside the variation you have just created to enter the first variant of the product.

Add Variant

Enter a Title for the variant.

If this variant costs more than the original price enter the Price Difference.

Then click Insert.

Variation Editor

You can add an unlimited number of variants following the same process.

The variants you have added can also have unlimited variations and so on.

Click Add Variation beside one of the variants and follow the same process for each as you did when adding the original variant. For example this time add Size.

You can drag and drop variant titles to change the order they will appear in.

To change any of the variant information just click Edit beside it.

If you now go to the product page, you will see the options you have just added.

If you need further assistance please contact us and we will be happy to help.

Adding An Image To A Content Page

From your Ballyhoo Dashboard, go to Content Manager.

Content Manager

Select the Content List within which your page is contained.

Click Edit beside the title of the page.

Edit Content Item

Ensure the cursor is placed within the text where you want the image to appear (at the start, between lines or at the end of the text).

Click the Image button in the text-editing toolbar.

Insert/Edit Image

Now click on the Browse button beside the Image URL field.

Moxiecode File Manager

In this window click Upload in the top toolbar.

Upload

You can now browse your computer to find and open the required image file.

Click Upload then exit the Upload window.

Moxiecode File Manager

The image you have just uploaded is now permanently available to insert anywhere on your site, as many times as you wish.

Select this image and, beneath the preview on the left of the window, click Insert.

Insert/Edit Image

Enter an Image Description (the title of the image will do), then click Insert.

Edit Content Item

Click Save and Close and you will now be able to view the page complete with your new image.

If you need further assistance please contact us and we will be happy to help.

How To Embed A YouTube Video

The following instructions describe how to add a YouTube video to a product description although the same process can be used to embed a video within content pages, category descriptions or wherever you see the text-editing toolbar.

From your Ballyhoo Dashboard go to the Product Manager.

Select the product you would like to add a video to from the Product Title list.

Edit Product

In the Main Description text, the cursor should be located where you want the video to go (i.e. beneath the text, at the start or between lines).

Now click on the Media button in the text-editing toolbar.

Insert/Edit Embedded Media

Ensure Flash is selected as the Type.

Copy and paste the URL of the Youtube video in the File/URL field (you can find the URL in the address bar or on the right-hand side of the YouTube video page). A preview of the video will be shown below.

You can adjust the dimensions of the video to fit within your site. Constrain Proportions must be ticked to ensure the video is scaled proportionately.

Now click Insert.

Edit Product

The video is now part of your description and you can align it however you wish, for example centrally.

Click Save And Close at the bottom of this page to save the video.

The video is now available to view on the product page.

If you need further assistance please contact us and we will be happy to help.

]]> http://www.ballyhoo.ltd.uk/e-commerce-support-how-to-embed-a-youtube-video/feed/ 0 http://www.ballyhoo.ltd.uk/e-commerce-support-managing-categories/ http://www.ballyhoo.ltd.uk/e-commerce-support-managing-categories/#comments Fri, 08 May 2009 15:19:29 +0000 Alison http://www.ballyhoocommerce.co.uk/?p=601 For help managing your product categories using the Ballyhoo Commerce software please view our short instructional video or read the written guide.

Managing Categories

Managing product categories is an important part of running an online store. Doing this well ensures customers can browse your site easily and find exactly what they are looking for. Ballyhoo Commerce gives you enormous flexibility to make this possible.

Go to the website Dashboard.

Click on Product Manager, then click on Category Editor.

Add New Category

To add a new category to the list click on Add New Main Category.

On this page you will need to enter the Category Title and an optional Description, which could simply be text about what’s included in that category, links to other pages or even images.

Click Insert and the category will be created.

Sub-Categories

At the bottom of the list will be the category you have just created. Unlike some other e-commerce platforms, with Ballyhoo you can have an unlimited number and depth of categories. You can have as many categories as you like and each of those can have as many sub-categories as you wish.

To add a sub-category click on Add Sub-Category beside the category. This takes you to a page in the same format that was used to create the main category. Add the Category Title and Description and click Insert.

You can add sub-categories to sub-categories and so forth, there is no limit.

Category Order

If you don’t like the order in which the categories appear, you can move them into any order you wish. Click and hold on the category title you wish to move, drag it to the new position and drop. You can change the order of all of the sub-categories too.

These are updated on the shop-front as soon as you move them.

If you need further assistance please call 0121 286 9390 or email support@ballyhoo.ltd.uk and we will be happy to help.

Related Articles

• How To Add A Content Page
• How To Paste & Format Text
• How To Manage Product Variations
• How To Add An Image To A Content Page
• How To Embed A YouTube Video
• How To Add A New Product