Our extensions

play HikaShop is an e-commerce solution for Joomla !
Built for simplicity and flexibility. 


Have your users purchase your products efficiently, facilitate the management of your store, increase your sales thanks to built-in marketing tools and so much more !
Quik and easy to configure, let starts your shop online today !

All features     Download

What's new ?

Main features

INTERNATIONAL
SALES


HikaShop provides an interface for handling languages, currencies, zones and advanced taxes to sell anywhere in the world.

POWERFUL
STATISTICS


Easily manage your store using the built-in dashboard and its powerful statistics capabilities.

RESPONSIVE
LAYOUT


HikaShop works on every device (laptop, tablet, smartphone..). Your shop will fit to each user's screen.

MARKETING
TOOLS


Increase your sales thanks to affiliate program support, coupons, discounts and email marketing integration.

EASY TO
CONFIGURE


User-friendly and flexible, our component is easy to use and configure. Create your own shop online in a minute !

FULLY
INTEGRATED


HikaShop is integrated with many other components and includes a lots of plugins...

ADVANCED
CUSTOMIZATION


Personalize your store: views, checkout, information fields, emails, and more to fit your website design

MULTI
VENDOR


Adding HikaMarket to HikaShop, create a multi-vendor website. Manage in one shop several sales from different people.

Our Company

BUSINESS
PARTNER

HikaShop is a complete e-commerce solution that allows you to easily create and manage your online store but also take it to the highest level.

GREAT
SUPPORT

The whole team is working to provide you with quality support. Documentation and forum are there to guide you step by step. Each issue finds an answer !

ALWAYS
ON TOP

HikaShop is constantly improving. We ensure compatibility with each new version of Joomla! And new features are added frequently.

RECEIVE
OUR NEWS

Good deals and novelties, it's here!

 

Description

This module, once published will display shortcut icons to HikaShop functions on the backend dashboard of your website.

 

Install the module for Joomla! 2.5

 

Download HikaShop's icons module

 

Log in to your backend and click on the menu "Extensions => Extension Manager".

 

 

For upload the file, choose it in the pop up window.

 

 

And click on "Upload & Install"

 

 

If everything gone well, you'll see this :

 

 

Time to activate it now, so go on the menu "Extensions => Module Manager".

 

 

Before looking for, change the filter "site" for "administrator"

 

 

Then, type the word key "icons".

 

 

and click on "Search" button, Hikashop QuickIcons will appear, click on it.

 

 

First, set the position by clicking on "Select position" button

 

 

A pop up window will apppear, select icon position by clicking there :

 

 

Don't forget to change the status for "Published".

 

 

And save!

 

 

Result for Joomla! 2.5 control panel

 

Let's go see, if everything work well, so go "site" menu and select "Control Panel"

 

 

On the below, Hikashop QuickIcons (admin) is now present, click on it.

 

 

And so you have now display Hikashop icons on the Joomla! Control Panel.

 

 

You are now able to manage quickly your Hikashop store thanks to this quick icons! For learn more about these Quick Icons go to Hikashop Quick Icons legend.

 

Install the module for Joomla! 3.X

 

First of all, you can download Download HikaShop's icons module for Joomla! 3.X

 

Go to Extensions => Extension Manager

 

 

Pick your file on your computer, by clicking on "choose file" button, and show it in the pop up window

 

 

And install it with the "Upload & Install" button.

 

 

If everything worked well, you'll see this.

 

 

Now, go to Extensions => Plugin Manager.

 

 

You have to look for your plugin, so type "icon" in the input search, and click on search button.

 

 

Hikashop Quick Icon will appear, for publish it click on the red cross icon.

 

 

Result for 3.X control panel

 

To see the result go to System => Control Panel.

 

 

There, you will notice an new Hikashop icon, click on it.

 

 

You are now able to manage quickly your Hikashop store thanks to this quick icons! For learn more about these Quick Icons go to Hikashop Quick Icons legend.

 

 

Hikashop Quick Icons legend

 

Here, you will find a description for each icon, and what it links to with your Hikashop store managing.

 

 

 

 

edition

HikaShop edition

Which HikaShop edition do I need ?
It depends of what you want to do. You can find a comparison of the features here.
How to hide the HikaShop footer text ?
Go in the Display tab of the configuration of HikaShop and turn off the "show footer" option.

install

Installation / update

Will I loose my settings/data if I update (or upgrade to a commercial edition) of HikaShop?
No, you won't loose anything. The update can be installed like a fresh install, via the joomla extensions installer page.
I have some errors when I install HikaShop.

HikaShop installs files in the following folders. Please first make sure those folders are writable before trying to install HikaShop :

  • Joomla / Administrator / Components
  • Joomla / Components
  • Joomla / Modules
  • Joomla / Plugins
  • Joomla / Plugins / Hikashop
  • Joomla / Plugins / Hikashoppayment
  • Joomla / Plugins / Hikashopshipping
  • Joomla / Plugins / Acymailing
  • Joomla / Plugins / Search
  • Joomla / Plugins / User
  • Joomla / Plugins / System
  • Joomla / Language / en-GB
  • Joomla / tmp
  • Joomla / media

If you have errors regarding the copy of files, it's likely to be because of access right issues. You should look at these documentation pages of Joomla: http://docs.joomla.org/Why_can't_you_install_any_extensions%3F http://docs.joomla.org/Installing_an_extension http://docs.joomla.org/How_to_solve_Installation_errors_Extension_Manager

Blank page

A blank page does not help us to determine what could be the problem so if you get a blank page (an entire white screen without anything written on it), please make sure that your PHP configuration enables you to see errors and if not, edit your php.ini file and search for the string parameter display_errors.
This parameter should be turned On : display_errors = On. If it's not the case, please edit your php.ini file, modify this line, save your file and then restart your server and try again to install HikaShop. You should not see a blank screen anymore and the error message will help us a lot to fix the problem.
If you can not see any error, please try to install HikaShop via FTP, it solves more than half of the installation issues.

Install via FTP

If you have difficulties to install HikaShop, you may want to try to install it via FTP. This way, Joomla won't have to upload the HikaShop package on your website so the installation will be much faster.


  • Extract your HikaShop package in a folder called "HikaShop " on your own computer.
  • Open your FTP software (FileZilla for example), connect to your website and upload the folder "HikaShop " in the temporary folder of your website : /tmp/
  • Go to your Joomla Installer manager on your website backend and specify the path of your folder in the input "Install from Directory" : "\home\...\tmp\hikashop".
  • Click on the button "Install"... the install process should be much faster and will enable you to successfully install HikaShop.

http://www.hikashop.com/fr/support/59-hikashop-how-to-install.html#errors
I want the latest version of HikaShop, do I have to uninstall it before ?
No, you don't have to uninstall HikaShop, you can follow this link to see how to update.
Are my custom views deleted after HikaShop update ?
No, all your custom views will be present after the update.
I have problems after updating HikaShop.

After updating HikaShop, or when creating custom fields, it's possible that you have things not functioning properly (eg. products not saving, not adding to the cart, order not creating, etc).
It always comes from the fact that the process could not update the HikaShop's tables structure during the update (or when you add a custom field). That can be caused by two things:
1. Your MySQL user do not have the ALTER privilege which is essential to the update of tables structure.
2. Your MySQL server could not run all the queries because it was limited by some resource restrictions put in place by your hosting.

How to know if it comes from that (for update issues)?

First, you should turn on the debug mode option of the configuration of joomla in your backend and deactivate the option "Use AJAX when possible for add to cart buttons" of the Checkout tab of the configuration of HikaShop. Then, reproduce the action where you have the problem. If you see a big warning with a MySQL query error, then that's your problem. The message should start with something like that:
500 - JDatabaseMySQL::query: 1054 - Unknown column 'XXXXXX' in 'where clause' SQL=SELECT * FROM.....

How to fix (for update issues)?

You should open the file administrator/components/com_hikashop/install.hikashop.php and search for that column name. You should see something like that:
$this->db->setQuery("ALTER TABLE `#__hikashop_YYYY` ADD `XXXXXXXX` ....................................................."); $this->db->query();
You need to open your phpmyadmin and run the query which is in the double quotes in your database. Don't forget to replace #__ by the prefix of your tables (it's usually jos_ for Joomla 1.5 but it is random for Joomla > 1.6 ).
For custom fields, you can just delete them and the error should disappear.

How to avoid problems later on ?
You should make sure that your MySQL user has the ALTER privilege. If you don't know how to do that, you should ask your hosting company.
Problems with modal popups and javascript errors.

These problems can manifest when there is a conflict between one of the plugins of the group system, the template or a module of your website, which uses invalid javascript or another javascript not compatible with mootools, and the standard mootools javascript library of joomla. In order to know if you're affected, you can display the javascript error console of your browser (a documentation on that for Google Chrome: http://code.google.com/intl/en/chrome/devtools/docs/overview.html ). If you see errors about javascript files, it's likely that you have that problem.
There is unfortunately nothing we can do in HikaShop regarding that as it's not a problem in HikaShop. The fact fact that it doesn't work is a byproduct of that conflict. The solution is to try to disable the different plugins of the group system and modules to see which one is causing the problem or to switch your template to see if it comes from that. Then, you can contact the developer of that plugin/module/template to try to solve the problem or use another one.
Known extensions which can cause such problems:

  • jQuery++ integrator
  • SC jQuery
  • System - Core Design Scriptegrator plugin
  • Scroll To Top -> there are plenty of modules to do the same out there so you should try to use another one.
  • SuperFish Dropdown menu module -> There is an option in that module to activate the no conflict mode which solves the problem
  • Google's mod_pagespeed can cause the action icons not to work on some of the back end screens when it is set to trim whitespaces and comments from javascript.

    A solution you can try is to use a jquery plugin (we recommend that you try with the plugin "jquery easy") which would load properly jquery instead of the extension's jquery: http://extensions.joomla.org/extensions/core-enhancements/scripts After a new installation or an update I have the error below each time I save the configuration and it doesn't work: Your checkout workflow is empty. Checkout workflow invalid. The modification is ignored. See the documentation for more information on how to configure that option No valid weight unit entered. The system put back the default units. No valid dimension unit entered. The system put back the default units. Either clear the cache and cookies of your browser or use another browser and you won't have the problem anymore.

style

Styling of the display (CSS)

How to edit the CSS ?
You can follow this tutorial. It will help you to customize the css on your webshop.
Where can I edit the CSS?
In HikaShop, go to System->Configuration->Display, in the CSS part, click on the "edit" picture.
Here you can edit the Frontend or Backend CSS file.
Can you give me some CSS examples ?
Some CSS Styling examples are here.
How can I change the color of the item box ?
The background color can be configured in the HikaShop options of your menu/module. If you don't see any changes, it's because you're not editing the correct menu/module.
If however you want to use CSS for that, you need to do like that: .hikashop_subcontainer{ background-color: red !important; }
The !important will override the CSS of that background option of your menus/modules.
I want to change the styling of the comments.

Edit the Front-end CSS File via the Display tab of the configuration. There, near the end of this document, you can edit all the css properties for the vote and comment module.

How to change the size of thumbnails ?
In System -> configuration -> files, you can set the width and the height of the thumbnails.
I want to change the default image for the products and categories.
In System -> configuration -> files, you can set the default image.
How can I change the Styling with CSS ?
On Firefox, you can use the Addon "Firebug", it allows you to see the CSS properties of the overred element.
You can find a tutorial here: firebug tutorial
What is CSS ?
You can learn CSS on the w3school website.
I want to change the previous/next product buttons in the product page.
In the backend, go to the menu Display -> Views of HikaShop, then search "Show" in the good template, and open the "Show" file of the product view. For this line, links->path."prev.png' alt='Previous'/> you can edit "prev.png" by the name of the picture wanted, "$this->links-path" links to the "media\com_hikashop\images\icons" folder. You can edit the links too.
Do the same things for the "next.png" picture.

layout

Layout

How to change a view in HikaShop ?
You can follow this tutorial.

In the HikaShop component, under the "Display" menu, click on Views. Then, filter by template to edit the good one.
In the "File" column, click on the layout to edit, then you can change the code of the display. In most cases, you will find a lot of HTML tags with some PHP code in between in order to display the data.
For example, in order to add a "Product name" label to the title of your products, edit the file "show_default" of the view "product". Then, replace echo $this->element->main->product_name; by echo "Product name: ". $this->element->main->product_name;
If you have trouble saving your changes, try to disable the "code mirror" plugin via the joomla plugins manager and check that the folder templates/YOUR_TEMPLATE/html/com_hikashop exists and is writable.

The links of my HikaShop content module don't work (error 404) when SEF is activated.
Go in the menu Menus->HikaShop hidden menus and click on the "rebuild" button. That should hopefully fix the problem. Otherwise, make sure that the "menu" option of your module is set to a hikashop category listing menu and that this menu is available to the public.
What is the "Inherit" option ?
If you select the inherit option, the configuration of the current parameter will be the same as the main configuration of hikashop.
I don't see any pagination on the listing of products.
That's probably because you have the "Random" option of your menu (for products listing menus) or of the associated module of your menu (for categories listing menus) which is activated. In that case, no pagination is displayed and the products on the page change each time you're displaying the page. If you turn off that option, the pagination will be displayed if there are more items to display than the "Number of items" option of your menu/associated module.
How to Display the quantity box for the add to cart buttons on products listings ?
You can edit the file "listing" of the view "product" for your front end template via the menu Display->Views and add the code:
$this->params->set('show_quantity_field', 1);
at the beginning of the file, after the first < ?php tag.
I'm trying to change the display settings in the tab Display of the configuration but I don't see the changes on my product/category listing on the front end.
That's because the settings on that screen are only for NEW menus and modules. Existing modules and menus have their own set of options that you can access via the menus Display->Content menus and Display->Content modules.
I'm changing the display settings of my category listing menu in the HikaShop options of the menu but I don't see the changes on the products listing on the front end.
That's because the settings on that screen are only for the categories listing. For the products listing, you need to click on the link of the "Associated modules" option of the HikaShop options of your menu which will direct you to the HikaShop options of the products listing associated module which was created automatically by HikaShop and which handles the display of the products listing for that category listing menu.
How to change the size of thumbnails ?
In the HikaShop options of your menus and modules, you will find a image height and image width option where you will be able to set the size of your thumbnails for that listing. If you don't set anything in them, it will use the values of the thumbnail height and width options of the Files tab of the configuration where you will find more options to handle the size of images in HikaShop.
The "$" is not present anymore in the prices.
That's probably because you installed a new extension recently which hide this symbol. Three solutions are available to you:
Unpublish the extension which is hiding the symbol. In System->Currencies, click on your currency, and in the edition page, you can do one of the following :
Disable "Symbol preceeds positive value" so that the symbol goes after the price. Put a space after the "$" in the "Symbol" field.
Custom item fields don't appear on the front end.
  • When you create a custom field, don't forget to enable the "Front-end" option.
  • Be careful, when you create the custom field, be sure that you set the good table , which is the "item" table, not the "product" table.
  • For products listings, enable the default option in System->configuration->display, enable "Display custom item fields" in the Default parameters for products.
  • For products listings, enable the same option, in Display->content menus/modules.
I add products to cart, but I don't see them on each pages.

Four possibilities:

  • Disable the cache in Joomla configuration. Site -> global configuration -> system -> "Cache settings".
  • If enabled, please disable the joomla cache plugin.
  • Check your template' options for a potential cache option and deactivate it.
  • Some hosting companies use caching proxies like Varnish or CDNs which can potentially be configured to cache your pages. So please contact your hosting company to see with them if they do for your website/server and if it can be deactivated.
I can't display the votes and comments.

Maybe one option is not activated. To be sure you activate this module, check this different options: System->configuration->Display
Products settings, enable "Display vote of product".
Category settings, enable "Display vote in category".
System->configuration->vote
In the dropdown, select something, for example "Vote & Comment".

The stars don't appear for votes.

Many possibilities:

  • You have to clear the cache of your browser.
  • JavaScript is not enabled on your browser.
  • The mootools upgrade plugin is missing on your Joomla 1.5, please install and activate it.
  • You have made a custom CSS file, and after updating to the latest version of HikaShop, the new CSS to handle the stars is missing. Take it from the "frontend_default.css" file and add it to your custom CSS file via the Display tab of the configuration.
How to remove double product title ?
In fact, there is only one title, the second is the product_code. By default, the product code should not be displayed on that page unless you changed the CSS to display it.
To remove it, you can create a new property in your template: .hikashop_product_code_main{display: none;}
If you see it and you don't want it, it's possible that your template process and break the attributes of the HTML tags around the code. You can turn off the "span processing" option of your template in that case and that should then hide the product code. Otherwise, you can also remove the product code display block in the file "show_default" of the view "product" via the menu Display->Views.
How to add a tab in the tabular view ?
You have to edit the view "product / show_tabular" via the menu Display > Views and add an entry like:
<li id="hikashop_show_tabular_custom_li" class="hikashop_tabs_li ui-corner-top">
<a onclick="displayTab('hikashop_show_tabular_custom');" href="javascript:void(0);">
<?php echo JText::_('YOUR_TAB_NAME');?>
</a>
</li>
In the < ul class="hikashop_tabs_ul"> element. Then add a div with content after the "ul" thanks to:
<div class="hikashop_tabs_content" id="hikashop_show_tabular_custom">
<!-- Your div content -->
</div>
The popups are not displayed or displayed at the bottom of the page.
HikaShop is compatible with the different popup system proposed by Joomla (SqueezeBox / Bootstrap) ; if your template is not compatible with one of them you will have some difficulties to see the popups.
In that case you have to change the "popup mode" in your HikaShop configuration (Display > General display options).

text

Translation / text modification

How to translate HikaShop ?

If HikaShop is not translated in your own language, you can easily add a language file in HikaShop.
Log on the administrator section of your website.
Click on the menu Components -> HikaShop and then on the HikaShop menu System Click on the tab Languages
If HikaShop is not translated in your language, you should see a small Add Icon next to your language (only installed languages are displayed on this area so you have first to make sure the Joomla language file is installed on your website).
Click on the add/edit icon and a popup will open, enabling you to modify the language file. If the language file already exists, you will be able to modify any string used by HikaShop with this interface.
If the language file does not exist, the English version will be loaded so that you can translate the strings from this English version.
The lines starting with # should not be translated (example : #price ) Each translation string is composed by a namekey (in upper-case) and the translated string separated by an equal sign (=).
The translations are enclosed in double quotes. You should keep them while translating and not add double quotes in the string when modifying a translation as that would break the file. You should not modify the string before the equal sign, otherwise, you will break the language file.
Example: The 8th line of this file : PRICE_AFTER_TAX="With VAT) " should be changed to PRICE_AFTER_TAX="TVA incluse) " for the French language. Do not add any return character in your translation, otherwise, you will break the language file.
Sometimes, you will see the sign %s. This symbol indicates a variable which will be replaced by a string or a number in HikaShop.
Please do not modify this symbol!
If there are two %s in the translation, please do not change their order in the sentence.
Once you translated your language file, you can click on the button Save. Then, if you want to share your language file with the rest of the community, please click on the button Share.
Sharing a language file is very important so that we can include your language file in our next versions.
Even if you translated only few strings, we would appreciate if you could share those modifications, so that you will be able to update HikaShop without loosing your work.

How to modify translations for my precise case ?

You will probably want to change a translation so that it fits your case. For example, we use the word VAT in our english translation file but you might prefer "Sales tax" instead. You could edit directly the translation file like explained above but when you update HikaShop and its language files in the future, you will loose your modifications. Instead, you can copy/paste the lines you want to change to the override textarea below the translation file textarea and do your modifications there. This "override" file won't be changed by HikaShop when you update and that way, you will be able to keep your modifications while still getting the new translations we publish.
For example, if you want to change the word VAT to use "Sales tax" instead you would:
1) Go in the configuration of HikaShop via the menu Components->HikaShop->Configuration in your back end and then open the tab languages.
2) Click on the "change" icon of your language file which opens a popup where you can see your translation file and an override textarea below it.
3) Search for the lines with the word VAT in the translation file and copy/paste them to the override textarea below.
4) Change the text in the override file to suits your needs.
5) Save the modifications.

How can I use FaLang or JoomFish for HikaShop ?
You have to install HikaShop after FaLang/JoomFish.
If you already installed HikaShop, no problem. Just install FaLang/JoomFish and then install HikaShop again.
If it still doesn't work, copy the xml files from yourWebsite\administrator\components\com_hikashop\falang to yourWebsite\administrator\components\com_falang\contentelements or yourWebsite\administrator\components\com_hikashop\translations to yourWebsite\administrator\components\com_joomfish\contentelements
Then, make sure that you can translate joomla articles with FaLang/JoomFish before you try to translate HikaShop content.
I want to change the "Add to cart" text (or any other text in HikaShop).
In HikaShop administration, in System -> language, click on the edit button for the language you're using.
Search the text "Add to cart", copy the line in the override area, then change the text there and finally save. Well done, your text "Add to cart" has been changed.
I want to change "Product category" name.
Easy, in Product -> Categories, in the explorer, click on "Root", and click on the edit icon next to "Product category". In the edit page, you just have to change the name and save.
How to change email text ?
You just have to go in System -> Emails (Business edition only), then click on the email that you want to edit.
You just have to change the text in this view. You can also unpublish emails there.
I want to change the decimal separator in the price.
Go in System->currencies, and select your currency in the listing.
In this page, you can change the decimal separator among other display options.
How can I change the "Next" button text for the last step in the checkout ?

In the menu Display -> Views, edit the "step" file (in the good template). Instead of : if($this->nextButton){ echo $this->cart->displayButton(JText::_('HIKA_NEXT'),'next',... Write : if($this->nextButton){ if(count($this->steps)-1 == $this->step+1){$button_value = JText::_('HIKA_FINALIZE');}else{ $button_value = JText::_('HIKA_NEXT');} echo $this->cart->displayButton($button_value,'next',... And in System -> Configuration -> Languages, edit your traduction file, add a line like that: HIKA_FINALIZE="Finalize" "Finalize" is for the example, but you can set whatever you want.

I sell packed products, how can I change "each" text in the product page ?

Create a new product custom field (commercial editions only), via Display -> Custom fields -> New, like in this screenshot:

sale method custom field

In the menu Display -> Views, edit the product / listing_price.php file. In this file, replace:
echo '<span class="hikashop_product_price_per_unit">'.JText::_('PER_UNIT').'</span>'; 

By:
if(isset($this->element->main)) echo JText::_($this->element->main->salemethod);
elseif(isset($this->row)) echo JText::_($this->row->salemethod);
else echo JText::_($this->element->salemethod);

And to finish, you just have to create a new translation, in Display -> Languages, edit your language file and add in the override area :
PER_PACK="each pack"

This translation is an example, but you can write what you want.


payment

Payment methods

I don't see any payment methods during the checkout, or I don't see some of them, what is the problem ?

There are several things which you could have missed.
1) Check that the payments plugins are installed and published
2) Check that you have configured your payment plugins (edit it and save its configuration)
3) Check that your template is able to display error messages: http://www.hikashop.com/en/support/documentation/61.html
4) Check that you have the payment view in the checkout workflow option of the configuration 5) If you restricted your payment methods to zones, check that the address you're using is inside those zones ! Otherwise the payment methods will be filtered out.
6) If you restricted your payment methods to shipping methods, check that the shipping method you're using is in the list of authorized shipping methods for your payment methods ! Otherwise the payment methods will be filtered out.
7) Check that the currency you're using is supported by the payment plugins you're using. Some payment plugins only supports a limited number of currencies. You should check that with the support of the payment gateways you're using.
8) Please make sure that you didn't change the currency code of your currency. Otherwise, the payment plugins won't recognize your currency. If you want to change the display of your currency, we invite you to use the "format" option on the right of the currency options screen as well as the symbol field.
9) When you select a currency or a shipping method in the options of the payment method, the payment method won't display unless that currency or shipping method is selected during the checkout. In most cases, these parameters shouldn't be selected so make sure they are unselected. To unselect them, you need to press the ctrl key and click on the selected currencies or shipping methods.
10) It can happen that the plugin's access is not set properly in the database. Please go in the Joomla plugins manager and edit the plugin and save it. That will sett the access if not present and might help solve your problem.


shipping

Shipping methods

I don't see any shipping methods during the checkout, what is the problem ?

There are several things which you could have missed.
1) Check that the manual shipping plugin is installed and published
2) Check that you have some shipping methods defined in the Manual shipping methods listing in System->Shipping methods
3) If those shipping methods have restrictions make sure that your methods cover all the possible cases (if you have one for weight 20 kg, if the order weights 15kg, the system won't find any suitable shipping methods)
4) Check that your template is able to display error messages: http://www.hikashop.com/en/support/documentation/61.html
5) Check that your products have a weight, otherwise, the system won't display any shipping methods as it will consider the products as virtual goods.
6) Check that you have the shipping view in the checkout workflow option of the configuration
7) If you restricted your shipping methods to zones, check that the address you're using is inside those zones ! Otherwise the shipping methods will be filtered out.
8) Be sure to have valid units in the configuration as only a set of units are valid as stated in the documentation of the configuration page : http://www.hikashop.com/support/documentation/54.html#main
9) Please try to use the same weight and dimension units as the first unit configured in the unit option of the configuration. For example, if you have the units m,dm,cm,mm configured and you use mm for your products dimensions, HikaShop will convert all your dimensions into the first unit (m in that case) to run the comparisons. However, the comparisons are limited to a certain number of decimals and your dimensions might end up as being considered as 0. So, in that case, you would have to change the unit option of the configuration to mm,m,dm,cm
10) If you use a shipping plugin which automatically retrieve the rates for your shipping company servers like the UPS,USPS or FedEx plugins do, you need to make sure that you entered the width, height, length and weight of each product as they base themselves on these in order to know how much to charge. You also need to make sure that you test the shipping selection with a customer test account which already has a shipping address selected as that is also necessary for the calculations of the shipping company server.
11) If you have set a "Warehouse" restriction on your shipping method or on your product configuration page, note that you'll need the same warehouse set on your products and the corresponding shipping method configuration page. At least you'll need to set no warehouse restriction on your shipping method configuration page if you want it to be used by your products.


taxe

Taxation rules

How to set the tax rules ?

First of all, go in System -> Taxes, in the menu on the right click on "Manage Tax categories", then "New" and set your tax category name, Optional if you need just one category of tax. (A default category already exists). When you have your tax categories, go back in System -> Taxes, and click on "Manage rates", and "New".
Here you can set the Tax namekey, for example: "Normal rate", "Reduced rate", and the rate, like "19.6", or "5.5"...
You can see all the USA tax rates here, or canada tax rates here, and all you have to know about VAT here.
Example of Europe taxes:

My taxes do not appear on my website. Why ?

That can come from one or several of these possibilities:
1) You unpublished the states for which you set your tax rules.
2) You unpublished the countries for which you set your tax rules.
3) You created new zones for your tax zones without adding any countries/states as sub zones of your new zones and thus, the system cannot link your rules using these new zones and the addresses on the front end which use the countries/states.
4) You set the "main tax zone" option of the configuration of HikaShop to country/state that you don't use in your tax rules and thus, the taxes are only displayed when the address of the user is in one of these zones and not before he enters his address.
5) You unpublished both the country and the state fields.
6) You changed the type of the country/state custom fields via the menu Display->Custom fields (it should always be "zone" unless you know what you're doing).
7) The address you're using during the checkout on the front end is outside the zones in your tax rules
8) You didn't set the "tax category" option in your products when creating/editing them.

I want to hide taxes in my website before the checkout.

In System -> Configuration -> Main, set the "Main tax zone", out of your taxed zone. That way, taxes will not be displayed until the customer enter his address during the checkout.

I want to display taxes in my website all the time.

In System -> Configuration -> main, set the "Main tax zone", in your taxed zone. That way, taxes will be displayed.


sales

Cart / Checkout

The "Add to cart" button is not present, why ?

That can come from one or several of these possibilities:
You are in "Catalog mode", you can change it in System->Configuration->Display, in "General display options" disable the "Catalogue mode" option.
The stock for this product is not set.
The price is not set for this product and the option "Display Add to cart button for free products" is disabled.
"Display Add to cart button" is disabled on the products listings:
you can change the default option in "Default parameters for products" in System->Configuration->Display.
Likewise, you will find a similar option in the HikaShop options of your menus/modules via the menu Display->Content menus/modules

How to display the cart module on my shop but not during the checkout ?

For that, you need to set the option "Force a menu on checkout" of the Checkout tab of the configuration to a menu where you don't want the cart (or create one specifically for that). Then, in the Joomla options of your cart module, that you can access via the Joomla module manager, unselect that menu in the "menu assignment" option and you won't have the cart module on your checkout.

The cart is not working properly. Sometimes I see products of another user, or I don't see the product I just added or I have different things displayed in it on different pages. What's going on ?

That can happen when you have some cache activated in your website. You should: Deactivate the cache option of the joomla configuration Disable the system cache plugin of joomla via the plugins manager Turn off the cache option of your template via the templates manager if such option is available in your template

How can I set unlimited stock for a product ?

In the Product page, you just have to let the "Quantity" field blank. The stock will be unlimited by default.

I want to change my checkout workflow.

In System->Configuration->Checkout. With the enabled option "advanced checkout workflow edition", if you want many pages for the checkout, for example, one page with the login & address, another with the shipping & payment method, and another one with the rest, click on "Add step", now you just have to drag and drop your elements in the new step. If the "advanced checkout workflow edition" option is disabled, you will have instead to change the string in the text area according to the documentation related to the Checkout workflow option.

I can't finalize an order.

That can come from :
You don't have any shipping methods displayed (check the FAQ for shipping methods not displayed)
You don't have any payment methods displayed (check the FAQ for payment methods not displayed) You can see how to configure a payment / shipping method here.

How to set up a guest checkout ?


If you need a guest checkout with the address of the customer, you have to set the checkout steps with "login - address - ..." in the options of the checkout set it to "no registration", and if wanted "no login".
Then you have to do some translation overrides for the "Register" button, to change it to, for example, "Use this address". By this way the customer will not be registered and you have his address for shipping and ordering.

How to sell products by Width and Length ?

1. You'll have to install and publish the plugin named "HikaShopCustom Quantity plugin

2. Create 2 custom fields from the "Item" table named "width" and "lengththrough "Hikashop->Display->Custom Fields->'New'" , and publish them for the front-end.

 

cron

Cron task

Is my cron task working ?
  • We implemented an easy way for you to check that your cron task is working.
  • Go on your HikaShop configuration page and click on the tab Cron.
  • On the Report area, you can see an option to have HikaShop sending you a report each time it is triggered.
  • So you can turn ON this option and once your done with your tests, you can then turn it Off.
  • Also, on the Last Cron area, you can see the last time your cron has been triggered, who triggered it and the latest report.
My cron task doesn't work, what should I do ?
  • Make sure your website can be triggered via your browser:
    Click on your cron url. That will trigger it manually via your browser so you will see if this url can be reached or not.
  • If you use a third-party SEF component, your website may redirect the current page to the SEF one which will break our own cron service.
  • So you can either configure your SEF component to not transform non-SEF into SEF urls or directly write your sef cron url on our cron interface. That can happen with sh404sef.
  • Make sure your website can be triggered by the outside:
    If you have an .htaccess with password protection, your website will obviously not accept to be triggered by an anonymous user.
  • If you use a security component on your Joomla website, this component might block our cron task. RSFirewall: You should disable the DoS protection from the Components > RSFirewall > Configuration > Active scanner configuration options.
  • If you use Cloudfare please configure it to allow the cron task to go through.
  • If you configured your cron task on your own server, check the report of your own cron task and you may also want to apply this workaround:
  • Create a php file at the root of your joomla website with the code below in it where you will replace yourwebsite.com by your website. ask=cron"); exit(); ?>
  • Then, instead of calling the hikashop cron page, you will call your php file you just created. Like that, for example: wget -O /dev/null "http://www.yourwebsite.com/myfile.php" > /dev/null
  • If you use our own server to trigger your website, please make sure you enabled our server IP to trigger your website every X minutes! (you might block it if you have some security checks on the number of connections per IP)
  • If you configured your cron task on your own server, check the report of your own cron task and you may also want to apply this workaround: http://www.acyba.com/support/forum/2-bug-report/1377-solved-cron-job-runs-ok-but-acymailing-queue-is-not-processed.html#1466

 

All these CSS modifications can be done via the CSS edition interface in the Display tab of the configuration ("Hikashop->System->Configuration->Display"):

How to move the registration box below the login box on the checkout

You need to edit the CSS of HikaShop via the interface in the configuration under the tab display in the CSS area and change the code:
.hikashop_checkout_login_right_part {
  1. width440px;
  2. floatleft;
}
to:
.hikashop_checkout_login_right_part {
  1. width440px;
}

 

How to move the shipping address selection box below the billing address selection box on the checkout

You need to edit the CSS of HikaShop via the interface in the configuration under the tab display in the CSS area and change the code:
.hikashop_checkout_address_right_part {
  1. width350px;
  2. floatleft;
}
to:
.hikashop_checkout_address_right_part {
  1. width350px;
}

 

How to change the color/size of the prices in HikaShop

You need to edit the CSS of HikaShop via the interface in the configuration under the tab display in the CSS area and modify the code:
span.hikashop_product_price {
  1. color: #900;
  2. white-spacenowrap;
}

 

The text of some buttons in HikaShop doesn't fit in the styling of the button

The styling of HikaShop buttons is handled by default by your template. If the text doesn't fit in the styling, that's because the template you're using uses a static styling for the buttons with a fix width. So, you have three solutions:
  1. You change the styling of buttons in your template so that it works regardless of the text in it. You might want to contact your template provider for that.
  2. Change (shorten) the text of the buttons so that it fits the styling. You can do that via the interface in the configuration under the tab languages.
  3. Change the option "button style" from "normal" to "css" in the tab "Display" of the configuration of HikaShop so that it uses HikaShop's default CSS for the buttons instead of your template CSS. You will then be able to edit the CSS used by the buttons by editing the CSS of HikaShop via the interface in the configuration under the tab display in the CSS area
 

How to hide some parts of the pagination ?

You need to edit the CSS of HikaShop via the interface in the configuration under the tab display in the CSS area.
There, in order to remove the number of items per page selection (with the dropdown), you can add the CSS:
.hikashop_products_pagination div.limit, .hikashop_subcategories_pagination div.limit{ display:none; }
In order to remove the results counter text below it, you can add the CSS:
span.hikashop_results_counter{ display:none; }

How to display the product code on the product page ?

You need to edit the CSS of HikaShop via the interface in the configuration under the tab display in the CSS area.
There, in order to display the product code on the product page, you can remove the CSS:
.hikashop_product_code_main{ display:none; }

How to change the border around products and categories on listings ?

You need to edit the CSS of HikaShop via the interface in the configuration under the tab display in the CSS area.
There,  you can change the CSS:
div.hikashop_products div.hikashop_subcontainer{
border: 1px solid;
}

How to change the size of the small thumbnails on the product page (you see them only when you have several images attached to a product) ?

You need to edit the CSS of HikaShop via the interface in the configuration under the tab display in the CSS area.
There,  you can change the CSS:
img.hikashop_child_image{
margin : 2px;
height:25px;
}

How to hide the characteristic values in the product name on the product page ?

You need to edit the CSS of HikaShop via the interface in the configuration under the tab display in the CSS area.
There,  you can change the CSS:
.hikashop_product_page .hikashop_product_variant_subname{
display: none;
}

How display the characteristics radio selection vertically ?

You need to edit the CSS of HikaShop via the interface in the configuration under the tab display in the CSS area.
There,  you can change the CSS:
.hikashop_product_characteristics_table{
width: 100%;
}
.hikashop_product_characteristics_table input{
float: left;
clear: both;
}
.hikashop_product_characteristics_table label{
display: block;
}

 

Available languages

HikaShop is actually fully translated in 30 languages and partially in 11 languages.
By default, only the english language is on the installation package in order to reduce its size. If you use other languages that weren't installed during the wizard setup phase of the installation of HikaShop, you simply have to go on the HikaShop Configuration page ("Hikashop->System->Configuration"), click on the tab "Languages" and then create your own language. HikaShop will propose you to load the latest version of this language directly from our website. Finally, you simply have to save the language to have it on your website. If you don't see your language there, that's because you first need to install your language in Joomla before you can install it in HikaShop.

 

For any reason, if your language file could not be automatically installed, you can manually download it below and upload it in the folder language/TAG (you need to replace TAG by the tag of your language) of your website via FTP:
Afrikaans (South Africa) af-ZA Download
Arabic (all) ar-AR Download
Albanian (Albania) sq-AL Download
Basque eu-ES Download
Bulgarian (Bulgaria) bg-BG Download
Catalan (Spain) ca-ES Download
Chinese (China) zh-CN Download
Chinese (Taiwan) zh-TW Download
Croatian (Bosnia and Herzegovina) bs-BA Download
Czech (Czech Republic) cs-CZ Download
Danish (Denmark) da-DK Download
Dutch (Belgium) nl-BE Download
Dutch (Netherlands) nl-NL Download
English (United Kingdom) en-GB Download
English (USA) en-US Download
Finnish (Finland) fi-FI Download
French (France) fr-FR Download
Galician gl-ES gl-ES Download
German (Germany) de-DE Download
Greek (Greece) el-GR Download
Hebrew (Israel) he-IL Download
Hungarian (Hungary) hu-HU Download
Italian (Italy) it-IT Download
Japanese (Japan) ja-JP Download
Korean (South Korea) ko-KR Download
Latvian (Latvia) lv-LV Download
Lithuanian (Lithuania) lt-LT Download
Macedonian mk-MK Download
Montenegrin (latin) srp-ME Download
Norwegian Bokmål (Norway) nb-NO Download
Persian (Iran) fa-IR Download
Polish (Poland) pl-PL Download
Portuguese (Brazil) pt-BR Download
Portuguese (Portugal) pt-PT Download
Romanian (Romania) ro-RO Download
Russian (Russia) ru-RU Download
Serbian Cyrillic (Serbia) sr-RS Download
Serbian Latin (Serbia) sr-YU Download
Spanish (Spain) es-ES Download
Slovak (Slovakia) sk-SK Download
Slovenian (Slovenia) sl-SI Download
Swedish (Sweden) sv-SE Download
Thai (Thailand) th-TH Download
Turkish (Turkey) tr-TR Download
Ukrainian (Ukraine) uk-UA Download
Vietnamese (Viet Nam) vi-VN Download

 

HikaMarket Languages

Danish (Denmark) da-DK Download
German (Germany) de-DE Download
English (United Kingdom) en-GB Download
Spanish (Spain) es-ES Download
Persian (Iran) fa-IR Download
French (France) fr-FR Download
Italian (Italy) it-IT Download
Japanese (Japan) ja-JP Download
Dutch (Belgium) nl-BE Download
Dutch (Netherlands) nl-NL Download
Russian (Russia) ru-RU Download
Slovak (Slovakia) sk-SK Download
Swedish (Sweden) sv-SE Download
Ukrainian (Ukraine) uk-UA Download

HikaSerial Languages

Bulgarian (Bulgaria) bg-BG Download
German (Germany) de-DE Download
English (United Kingdom) en-GB Download
French (France) fr-FR Download
Italian (Italy) it-IT Download
Japanese (Japan) ja-JP Download
Dutch (Belgium) nl-BE Download
Dutch (Netherlands) nl-NL Download
Russian (Russia) ru-RU Download
Swedish (Sweden) sv-SE Download
Turkish (Turkey) tr-TR Download

 

How to translate HikaShop ?

If HikaShop is not translated in your own language, you can easily add a language file in HikaShop.

  • Log on the administrator section of your website.
  • Click on the menu Components -> HikaShop and then on the HikaShop menu System
  • Click on the tab Languages

If HikaShop is not translated in your language, you should see a small Add Icon next to your language (only installed languages are displayed on this area so you have first to make sure the Joomla language file is installed on your website).

  • Click on the add/edit icon and a popup will open, enabling you to modify the language file.
    If the language file already exists, you will be able to modify any string used by HikaShop with this interface.
    If the language file does not exist, the English version will be loaded so that you can translate the strings from this English version.

 

  • The lines starting with # should not be translated (example : #price )
  • Each translation string is composed by a namekey (in upper-case) and the translated string separated by an equal sign (=).
  • The translations are enclosed in double quotes. You should keep them while translating and not add double quotes in the string when modifying a translation as that would break the file.
  • You should not modify the string before the equal sign, otherwise, you will break the language file.
    Example: The 8th line of this file : PRICE_AFTER_TAX="With VAT) " should be changed to PRICE_AFTER_TAX="TVA incluse) " for the French language.
  • Do not add any return character in your translation, otherwise, you will break the language file.
  • Sometimes, you will see the sign %s. This symbol indicates a variable which will be replaced by a string or a number in HikaShop.
    • Please do not modify this symbol!
    • If there are two %s in the translation, please do not change their order in the sentence.

 

Once you translated your language file, you can click on the button Save.
Then, if you want to share your language file with the rest of the community, please click on the button Share.
Sharing a language file is very important so that we can include your language file in our next versions.
Even if you translated only few strings, we would appreciate if you could share those modifications, so that you will be able to update HikaShop without loosing your work.

 

How to translate your content (products/categories/etc) ?

In order to translate your content, you have two solutions:

1. You can create several category trees (one per language), duplicate your products for each category tree and create different Joomla menu items attached to the different category trees' main category.
The cons are that it requires a lot of management work if you have a lot of products and you can't handle the stock management across the different languages for your products. If you don't need to maange the stock of your products and have only a few products, it's however a solution.

2. You can install a third party translation extension like Falang. HikaShop is integrated with it and it will allow you to translate your content directly when you edit them and won't duplicate them. That way, the management of the translations is made easier and the stock management is possible.
The cons are that it requires another extension on your website. That's however the method we recommend as it is easier to setup, manage and more effective.
Here is a tutorial explaining how to set that up: translations with Falang

How to modify translations for my precise case ?

You will probably want to change a translation so that it fits your case. For example, we use the word VAT in our english translation file but you might prefer "Sales tax" instead. You could edit directly the translation file like explained above but when you update HikaShop and its language files in the future, you will loose your modifications. Instead, you can copy/paste the lines you want to change to the override textarea below the translation file textarea and do your modifications there. This "override" file won't be changed by HikaShop when you update and that way, you will be able to keep your modifications while still getting the new translations we publish.

For example, if you want to change the word VAT to use "Sales tax" instead you would:

  • Go in the configuration of HikaShop via the menu Components->HikaShop->Configuration in your back end and then open the tab languages.
  • Click on the "change" icon of your language file which opens a popup where you can see your translation file and an override textarea below it.
  • Search for the lines with the word VAT in the translation file and copy/paste them to the override textarea below.
  • Change the text in the override file to suits your needs.
  • Save the modifications.

Note that since Joomla 2.5, Joomla has an interface to do that in the Languages manager. HikaShop's translation override system is compatible with Joomla's so you can use one or the other. Here is a tutorial explaining how to use it:

http://www.inmotionhosting.com/support/edu/joomla-25/language/add-new-language-override

Also, you'll find more information on the format of translation strings here.

 

 

Download HikaShop

If you want to use the free version of HikaShop, you can go to Download HikaShop Starter and click on the button "Download".

A popup will open asking you your Name and your E-mail and then, you will be able to download HikaShop.

hikashop.com only asks you your e-mail in order to keep you informed about important updates and security issues and we won't sell your personal data, nor spam you.

If you purchased HikaShop, you should have received a confirmation e-mail with a direct download link.
This download link will always be linked to the latest version of HikaShop so you can download new versions that way as well.

 

Install HikaShop

HikaShop is a Joomla Component and like any other Joomla Component, it can be installed within two clicks!
You don't have to extract the package first, HikaShop will automatically install some plugins and modules.

 

Log on to the Joomla Administrator Section and click on the menu "Extensions" -> "Install/Uninstall" Install Menu

 

Browse for your HikaShop package and then click "Upload File & Install".

upload package


Joomla will upload the package on your server and install the HikaShop component.
This part can take more than 1 minute.

 


Then, HikaShop will display a screen with the message "Please wait..." as HikaShop will now redirect you to an other screen in order to finalize the installation of the extension.
HikaShop will now automatically install its modules and plugins.
HikaShop will also install some default categories so that you can directly add your products to your store.
HikaShop finished the install process and you should now see a result of all installed extensions (Modules and Plugins).

Install Extensions


If you purchased the commercial version of HikaShop, HikaShop will connect to hikashop.com in order to validate your license.

You are now ready to use HikaShop !

 

Update/Upgrade HikaShop

If you want to install the latest version of HikaShop or upgrade to any commercial version, the upgrade process is as easy as the install one!

You don't have to uninstall HikaShop. Simply proceed as explained above and install the new package via the Joomla "Install/Uninstall" screen and HikaShop will be upgraded without loosing any of your data.

 

You can check the latest version and download it directly on your HikaShop Component...

Log on to the Joomla Administrator Section and click on the menu "Components" -> "HikaShop" to access the HikaShop Dashboard.

Click on the HikaShop menu help -> Update / About.

Dashboard Menu Update/About

 

If your component is not up to date, a message will be displayed enabling you to download the latest version.

 

Then download the package on your computer and install it via the Joomla installer, you don't have to uninstall the previous version!
HikaShop will be updated and you won't loose any of your data.

 

Installation Errors

HikaShop installs files in the following folders. Please first make sure those folders are writable before trying to install HikaShop :

  • Joomla / Administrator / Components
  • Joomla / Components
  • Joomla / Modules
  • Joomla / Plugins
  • Joomla / Plugins / Hikashop
  • Joomla / Plugins / Hikashoppayment
  • Joomla / Plugins / Hikashopshipping
  • Joomla / Plugins / Acymailing
  • Joomla / Plugins / Search
  • Joomla / Plugins / User
  • Joomla / Plugins / System
  • Joomla / Language / en-GB
  • Joomla / tmp
  • Joomla / media

In Joomla 3, you can check the folder permissions in the Joomla backend, under: System > System Information > Folder permissions

 

If you have errors regarding the copy of files, it's likely to be because of access right issues. You should look at these documentation pages of Joomla:

 

Blank page

A blank page does not help us to determine what could be the problem so if you get a blank page (an entire white screen without anything written on it).

 

Please make sure that your PHP configuration enables you to see errors and if not, edit your php.ini file and search for the string parameter display_errors.
This parameter should be turned On: display_errors = On.
If it's not the case, please edit your php.ini file, modify this line, save your file and then restart your server and try again to install HikaShop. You should not see a blank screen anymore and the error message will help us a lot to fix the problem.

 

In the Joomla global configuration (System > Global configuration), you can also change temporally the setting Error reporting (under tab "Server") to development

If you can not see any error, please try to install HikaShop via FTP, it solves more than half of the installlation issues.

 

Install via FTP

If you have difficulties to install HikaShop, you may want to try to install it via FTP.
This way, Joomla won't have to upload the HikaShop package on your website so the installation will be much faster.

  • Extract your HikaShop package in a folder called "hikashop" on your own computer.
  • Open your FTP software (FileZilla for example), connect to your website and upload the folder "hikashop" in the temporary folder of your website : /tmp/
  • Go to your Joomla Installer manager on your website backend and specify the path of your folder in the input "Install from Directory" : "\home\...\tmp\hikashop".
  • Click on the button "Install"... the install process should be much faster and will enable you to successfully install HikaShop.

-1 - an error has occurred ( It was not possible to copy the selected file. )

An error occured

This error message is displayed when Joomla can not copy a folder from the temp folder to the destination folder.

It's usually because of access rights and you should make sure the HikaShop folders are writeable (see above).

If it does not solve the issue, please edit the file libraries/joomla/filesystem/folder.php

Around line 93 AND 122, please replace:

return JError::raiseError(-1, JText::_('Copy failed'));

by

return JError::raiseError(-1, JText::_('Copy failed').' '.$sfid.' => '.$dfid);

 

It won't solve the problem but at least if you try to install again HikaShop, you will see a much better error message telling you what folder is not writeable.
That way you can move forward by fixing the permission issue on that folder and install again HikaShop.

 

This kind of error can be automatically solved by enabling the FTP layer on the Joomla configuration page (or turning it OFF if it was enabled).

 

  • Component Install: DB function reports no errors
  • JFTP: :delete: Bad response
  • JFTP: :delete: Bad response
  • Error installing component

Error delete bad response

 

This error is apparently due to the fact HikaShop could not be installed properly and there are probably still some instances of HikaShop on your Extensions Manager.

Please go on your Extensions Manager (click on the menu "Manage"), select HikaShop (the component) and uninstall it.

If it can't be uninstalled from there, please access your phpMyAdmin and execute this query:

  • DELETE FROM `jos_menu` WHERE link LIKE '%com_hikashop%';
  • DELETE FROM jos_extensions WHERE element = 'com_hikashop';
  • DELETE FROM jos_assets WHERE name='com_hikashop';

Then install HikaShop again... it should work.

 

  • JFolder: :files: Path is not a folder. Path: xxxxxxxxxxxxxx/tmp/install_xxxxxxxx
  • JFolder: :folder: Path is not a folder. Path: xxxxxxxxxxxxxx/tmp/install_xxxxxxxx
  • JFolder: :files: Path is not a folder. Path: xxxxxxxxxxxxxx/tmp/install_xxxxxxxx
  • JInstaller: :Install: Cannot find Joomla XML setup file

These errors can happen even though your access rights are correctly configured. It comes apparently from a problem between the ZIP extraction library and your server settings. You should try to convert the installation package of HikaShop to a tar.gz file with 7zip (tool for windows to generate packages) or an equivalent tool and then use that tar.gz package instead in order to install HikaShop.