Published in Documentation

K2Store will display the Add to cart as a button by default. If you want to use the image, you can do so by using CSS.

First, upload the image file to your template's images directory.

Then add the following CSS at the end of your template's css file.

.k2store_cart_button {
    background:url(../images/your_image_file_name.png) no-repeat;
    cursor:pointer;
    width: 200px;
    height: 100px;
    border: none;
}

NOTE: Make sure that the image's extension type is entered correct. If you are using a JPG format of image file, then you the image file should read as your_image_file_name.jpg

Published in Documentation

Many owners of small online stores have asked us how to disable the Shipping address step in the checkout. This guide explains the steps to hide the checkout steps.

Hiding Shipping Address step

Step 1

Go to K2Store -> Options -> Cart settings
Set the Enable Shipping address fields to No.

Step 2

Open your products (K2 Items) and make sure that the Enable shipping for this item is set to NO.

Now shipping fields will not show.

Billing Address

You cannot disable the Billing address entirely.  However, you can reduce the number of fields in the billing address section.

You can disable the fields via the Custom Fields manager , which was introduced in K2Store 3.7.2

IMPORTANT: You should at least have the Email field enabled. The remaining could be disabled.

Friday, 17 January 2014 12:18

HOW TO translate the address field labels

Published in Documentation

Since K2Store 3.7.x, check address fields are rendered via the Custom Fields manager.

If you wanted to translate the Address field labels, you can enter your translation in the respective fields.
Go to Joomla admin -> K2Store -> Set up -> Custom Fields

Open the field, the label of which you want to change, and enter your translation in the label field.

Multi-lingual sites

if you are running multi-lingual site, you can enter a language constant in the label field.
Example: K2STORE_MY_FIELD_NAME

Then you can go to Language manager and create an Override
IMPORTANT: Set the Filter to Administrator before you create an override.

Click New
Language Constant: K2STORE_MY_FIELD_NAME
Text: Your translation
Check the For Both locations
Save.

 

You can repeat this steps for your second, third, and other languages.

You can use language strings in all the fields including Custom Error message, Option Titles (if field type is select, radio, checkbox).

 

Friday, 17 May 2013 22:51

HOWTO add a custom thank you message

Published in Documentation

K2Store allows you to display a customised thank you message for your customers once they completed the purchase.

You can display a K2 Item as a thank you message. That means, you can instruct your customers with some information, or provide a contact information or what they got to do next.

Follow these steps to display a custom thank you message in K2 Store:

1. Create a K2 Item and add your thank message.
2. Save the item and note down its ID.
3. Go to Plugin manager and open the K2Store Payment Plugin that you are using (Example: Paypal Plugin).

You will see a param called Thank You message K2 Item. Enter the ID there.
4. Save and close the plugin

Now the customer will see the thank you message after making successful payment.

Tuesday, 12 March 2013 23:32

HOWTO write a language override

Published in Documentation

Joomla's language ovrride feature enables you to translate/change a text without editing the language files.

Here is a short guide specific to K2Store.

Let us assume that you want to change the Firstname (in billing address fields) to My Name.

  1. Go to Joomla admin->Extensions Manager->Language Manager->Overrides.
  2. Click new to create a override
  3. Under the Search text you want to change, enter the following text (as you see in the site): Firstname and hit search.
  4. You will get the constant: K2STORE_FIRST_NAME
  5. Enter this constant in Language Constant * box
  6. Enter your value (in our example My Name) in the Text box.
  7. Save.

You can create as many overrides as you like in this method.

You can learn more about language override from this page: http://www.inmotionhosting.com/support/edu/joomla-25/language/add-new-language-override

Wednesday, 27 February 2013 23:21

HOWTO write a template override

Published in Documentation

Sometimes, we have to change how things are displayed in our site. Some of us want to show the order summary on the left and the payment options on the right.

Some of us will like to change the layout of the billing / shipping address. And the question is how to do this without editing the core files of K2Store.

Joomla has a built-in solution for this: template overide. In Joomla, the views (or the output we see on the site) are handled separetely. So we can style the output or change the output easily.

This guide will take you step-by-step on writing a template override.

In our case, we take the default cart layout for writing an overide.

The following files control this layout. (Located in /components/com_k2store/views/mycart/tmpl folder)

  1. default.php

Step 1: Create override structure in your template.

We can create template overirides for only those files and folders that reside in the views folder of a component (Example: components/com_k2store/views).

All the template overrides should reside inside the html folder of your template.

Let us say, your template's name is: YOUR_TEMPLATE

And you want to write overide for the files in the mycart view of K2Store component.

Then you should first go to

/templates/YOUR_TEMPLATE/html

And create a folder named: com_k2store

Then go to

/templates/YOUR_TEMPLATE/html/com_k2store

and create folder called: mycart

Step 2: Copying files 

Now

Then you should copy the default.php from

/component/com_k2store/views/mycart/tmpl

to

/templates/YOUR_TEMPLATE/html/com_k2store/mycart

Step 3: Edit the files.

Now you can edit the default.php and carry out any changes. Like altering the scaffolding etc.

 

your_template
Published in Documentation

Many of our customers have asked how to show multiple products in one page. With the release of K2Store 3.0.3, we have introduced a plugin syntax for placing the cart button anywhere in the K2 Item content.

Here is a short tutorial on how to show multiple products in one page using the K2Store Cart syntax.

First things First

If you are not running K2Store 3.0.3, then

1. Download the latest version K2Store 3.0.3.
2. Backup your site
3. Install the latest version.

Create products / K2 Items

Since K2Store takes items created in K2 as products, head over to K2 and create the items, hereafter referred as products.

1. Create all products (K2Items)

Say you got five products. Red shirt, blue shirt, green shirt, pink shirt and orange shirt. Once you created an item in K2, each Item will have on ID. Note down the ID. For instance, Red shirt's  ID is 5 (you can see the ID on the top right of K2 item creation(new item) page.
Similarly,

Blue shirt - 6
Green short - 7
Pink shirt - 8
Orange shirt - 9

2. Set the K2Store Option

To enable the use of plugin syntax, Go to Joomla admin->K2Store->Options.  Under Cart settings, set Add to cart placement to Within Article text.

3. Create another K2 Item

This item is going to hold all the products.  Add the content like you wanted. You can add an image, text, link or whatever you like.

An example content should be like:

Red Shirt

My description about red shirt
{k2storecart 5}


NOTE: 5 is the ID of that K2 Item /Product. You can see the ID on the top right of K2 item after you saved it.

 You can do wonders with the plugin syntax and creatively use it.

Monday, 28 January 2013 19:05

HOWTO move add to cart block of K2Store

Published in Documentation

Many users have been asking how to move the add to cart block near the K2 Item image or just after the intro text.

You can do this in two methods. This howto will walk you through a few simple steps that will move the add to cart.

1. Using Plugin tag

We have introduced a plugin tag/syntax that can be added to your K2 Content. K2Store will recognise the tag and insert the cart there automatically.

Go to Joomla administrator->K2store->Options->Cart settings
Set the Add to cart placement param to Within Article content using tags.

Then go to K2 and open an existing product/item or create a new one.
in the content, use the following tag:

{k2storecart}

You can place this tag anywhere in the content.

2. Template override

CAUTION:  This method requires you to  have atleast a basic knowledge of the html or PHP code, just to interpret and understand atlest the <?php if...endif;?> block, so that you can edit the code correctly.

You first need to override the K2's template. To do that you must copy a few files. So you should have FTP access to your site. Use an FTP client like FileZilla for handling file operations.

Step 1: Copy the following folder

/components/com_k2/templates/default

to

 /templates/YOUR_TEMPLATE/html/com_k2/

 

NOTE: Some templates come with style support to K2. Such templates will already have a com_k2 folder inside your html folder. In this case, you do not have to copy the folder.

Step 2: Open

/templates/YOUR_TEMPLATE/html/com_k2/default/item.php

 

The item.php is used to display a single K2 Item. In this file, locate the following code.

<?php echo $this->item->event->K2AfterDisplay; ?>

Cut this line (shortcut key in Windows/Linuux: Ctrl+X).

This is the line that inserts K2Store addtocart block.

Let us assume that you want to display the Add to cart button, price and the quantity input box right after the image.

Around line 216 to 237, you will find the following block of code:

 

<?php if($this->item->params->get('itemImage') && !empty($this->item->image)): ?>
      <!-- Item Image -->
      <div class="itemImageBlock">
          <span class="itemImage">
              <a class="modal" rel="{handler: 'image'}" href="/<?php echo $this->item->imageXLarge; ?>" title="<?php echo JText::_('K2_CLICK_TO_PREVIEW_IMAGE'); ?>">
                  <img src="/<?php echo $this->item->image; ?>" alt="<?php if(!empty($this->item->image_caption)) echo K2HelperUtilities::cleanHtml($this->item->image_caption); else echo K2HelperUtilities::cleanHtml($this->item->title); ?>" style="width:<?php echo $this->item->imageWidth; ?>px; height:auto;" />
              </a>
          </span>

          <?php if($this->item->params->get('itemImageMainCaption') && !empty($this->item->image_caption)): ?>
          <!-- Image caption -->
          <span class="itemImageCaption"><?php echo $this->item->image_caption; ?></span>
          <?php endif; ?>

          <?php if($this->item->params->get('itemImageMainCredits') && !empty($this->item->image_credits)): ?>
          <!-- Image credits -->
          <span class="itemImageCredits"><?php echo $this->item->image_credits; ?></span>
          <?php endif; ?>

          <div class="clr"></div>
      </div>
      <?php endif; ?>

right after this block, add this line:

<?php echo $this->item->event->K2AfterDisplay; ?>

 

Save your file and visit your product page. Voila... you have successfully moved your add to cart block.

You can move the line whereever you wanted. It depends on your preference.

You can even have this line at multiple places so that the cart block is displayed at multiple times.

Moving Add to cart block in Category Items Display

You have to edit

 /templates/YOUR_TEMPLATE/html/com_k2/default/category_item.php.

 

The rest of the process is similar.

You only have to move the line

<?php echo $this->item->event->K2AfterDisplay; ?>

to a place you like.

 

NOTE: Sometimes, your template may be using a different K2 Sub-template instead of the default. For example, the JA_RAVE template from Joomlart has two different subtemplates - ja_rave, ja_rave_blog.

If you use these sub-templates, then you have to edit the item.php in these sub-templates folder as well.

Thursday, 24 January 2013 05:30

HOWTO translate K2Store in your language?

Published in Documentation

Translating K2Store in your language is very easy.

All the languages files of K2Store are managed in Transifex, an effective localisation platform.

This guide should help you get K2Store to work in your language with a few easy steps.

1. Check exisiting translations

Go to http://k2store.org/translations.html to check if the translation for your language is available. If you see your language listed and the progress bar indicating 100 %, then you can click on the name of your language to download the translation pack.

language download

 

It is an installable pack. You can install it via the Joomla installer.


2. Translations for my language is not complete

If you see the translation for your language is not complete or dont see your language listed at all, you need to translate the K2Store. Dont worry. It is easy to translate K2Store to your language. Transifex makes it easy.

Step 1

Go to http://transifex.com and create an account. Its FREE.

Step 2

Joomla has a group of volunteers for translation. The group works under the name of Open Translators. Its a hub project for the translation of all joomla extensions. So go to the Open Translators hub project at https://opentranslators.transifex.com

opentranslators

 

You will see almost all languages listed there. In case, you dont find your language, you can Request language. But that wont be necessary as all the languages are already listed.

So go ahead and click your language. Say, you need German translation. Click the German language. This will take you to German translations page listing translations for all extensions of Joomla.

Step 3

Join the team of your language. You can find the Join team button on the top right of the page. See the image below

 k2store select

 

It would take some time for the co-ordinators of the language team to approval your joining request.

Step 4

Once you joined, go to https://opentranslators.transifex.com and the choose K2Store from a list of child projects. Start typing a few letters in the box and you can get to see K2Store project. See the image below.

transifex

 Once you choose K2Store you can see a list of the language resources. They are normally the standard Joomla language ini files for admin and site side of the K2Store component. We call these files in Transifex as resources.

language resources

Step 5

Click a resource to start translating. For example click on the K2Store →  admin_com_k2store_menu. This will open a pop up.

start translate

 

 

Click on the translate now. This will take you to the translations mangement window.

 

translation window

In the top right corner, you can see the source language and language of file being translated.

The left columns lists the strings. Clicking on a string will present space to enter your translations.

Once you translated all the strings, click save and exit.

Translate all the language resources in the same fashion.

Once you have translated, inform us. We will make an installable package and make it available for download at http://k2store.org/translations.html immediately.

Still have questions, contact us.

Wednesday, 12 December 2012 22:51

HOWTO sell digital goods with K2Store

Published in Documentation

You can use K2Store to sell digital goods. The K2 attachments are treated as the digital goods here. You can set it in a few steps.

1. Create a K2 Item

2.  Upload your file(s) via K2 Attachments tab.

3. Enter the price in K2 Store block.

Now you have set up the Digital Item for sale.

After the purchase, the customer needs a place to download. So create a menu.

1. Go to Menu and choose K2Store as the Type.

2. Then choose Downloads view.

3. Set the access level to Registered. IMPORTANT NOTE: Guest users cannot download the attachments. The attachments will be emailed to them.

Video tutorials about this feature will be made available soon.