Adding products in Joomla's articles

Description

Why products insertion/translation plugins?

HikaShop product insertion/translation plugins are functionalities which will allow you to display your HikaShop products through your Joomla articles. By this way, you'll be able to create Joomla articles about your "favorite/most popular/.." products and easily display them.

HikaShop product insertion: This plugin will be used through your Article creation page ("Content -> Articles -> 'Your article'") with the "Product" button. This "Product" button enables you to add "Product(s) TAG" to your article.

HikaShop product translation: This plugin will be automatically used through your front-end and will translate your "product(s) TAG".

This tutorial will explain how to add a HikaShop product TAG to Joomla articles and the different ways to display them.

First, we will see how to create and add them through the HikaShop product insertion plugin and how they can be translated by the HikaShop product translation plugin.

Enable / disable HikaShop product insert insertion and translation plugins

By default, these plugins are disabled.

If you want to enable them, you'll have to do it through "System -> Manage -> Plugins" (or "Extensions -> Plugins" on older Joomla versions).

Inserting a product TAG

Through your Joomla article's configuration screen, you'll be able to add products through the Product button:

Product insert button

Then, you'll find this configuration screen showing your products and some options:

Name: Allows you to display the product's name (uses the name tag option)

Description: Allows you to display the product's description (uses the description tag option)

Cart: Allows you to display an add to cart button (uses the cart tag option)

Quantity field: Allows you to display a quantity field next to the add to cart button (uses the quantityfield tag option). Note: The quantity field won't be displayed if your products have variants.

Image: Allows you to display the product's image (uses the picture tag option)

Link to the product page: Allows you to add a link to the product page (uses the link tag option)

Item box border: Allows you to display a border around the products (uses the border tag option)

Badge: Allows you to display product badges on the product image (uses the badge tag option; requires the picture option to be enabled)

Menu ID: If you enter the id of a HikaShop menu item, the system will use the alias of that menu item instead of "component/hikashop" in the URL link (uses the menuid:X tag option where X is the menu item ID).

Display price: Allows you to display the product's price. Use pricetax1 to show prices with tax only, pricetax2 to show prices without tax only, or just price to use the HikaShop default setting.

Show discounted price: If HikaShop needs to apply discounts to the prices displayed, it can also show the price before the discount was applied as an incentive for your customers to buy the products or the discount amount

Insert: Will add the product TAG to your Joomla article editor

Quick Reference: Tag Options

Tip: You can display multiple products in a single tag by separating product IDs with the pipe character:

Here is the product TAG that will be displayed:

Different ways of setting up a product TAG

Here are different examples of product TAG configurations:

• Product tag example 1:
  € 60,00 HikaShop Essential

• Product tag example 2:
  € 60,00 HikaShop Essential

  Add to cart

The quantity field won't be displayed if your products have variants.

• Product tag example 3:
  € 60,00 HikaShop Essential

  Add to cart

• Product tag example 4:
  

  € 60,00 HikaShop Essential

  HikaShop Essential includes all the features from HikaShop Starter.
  * You can compare all our versions here.
  * You can upgrade your version here.

  Features

  • PRODUCTS AND SALES
  • Custom fields for products and user information
  • Customer invoice display
  • Multilingual edition of the content
  • Possibility of payment of an order later on
  • Checkout without registration
  • Contact us form on product pages
  • Options for products
  • Waiting list for products out of stock
  • LAYOUT
  • Powerful dashboard customization
  • More widgets on the dashboard
  • Configurable products purchasing restrictions
    (per period, per weight, per product categories, etc)
  • Additional product listings item layouts
  • Customization of order number format
  • MARKETING TOOLS
  • Google Products integration
  • Restrictions on coupons and discounts

  Usage

  • HikaShop is compatible with every recent versions of Joomla and WordPress. 
    Joomla 3.x Joomla 4.x  Joomla 5.x  Joomla 6.x  WordPress 
  • GPL v3
  • No limit of time
  • 1 year free updates
  • 1 year free HikaShop support for one website
  • 1 year web cron service for one website
  • HikaShop only supports MySQL (no postGreSQL or Oracle or MSSQL support)
  • Installation guaranteed! If you have any problems installing HikaShop, we'll do it for you.
  • 30-day money-back guarantee
  • Support and access to updates can be extended for 40€/year

  

  

  

  

  

  

  Add to cart

Conditional content tags

In addition to the product insertion tags, the plugin also provides conditional content tags that allow you to show or hide content based on the customer's purchase history or current cart contents.

Show/Hide based on purchase history:

• - Shows content only if the user has bought any product
• - Shows content only if the user has bought a specific product (by code, name, or ID)
• Content - Shows content only if the user has never bought anything
• Content - Shows content only if the user has not bought a specific product
• Content - Hides content if the user has bought any product
• - Hides content if the user has not bought a specific product

Show/Hide based on cart total:

• - Shows content only if the cart total (with shipping) is at least 50
• Content - Shows content only if the cart total (with shipping) is at most 100
• - Shows content only if the products total (without shipping) is at least 30
• Content - Shows content only if the products total (without shipping) is at most 200

Displaying the difference:

You can use {min} or {max} placeholders inside the conditional content to display the formatted difference between the threshold and the current cart total:

• You can add up to € 500,00 more before reaching the limit.

Combining conditions:

Multiple conditions can be combined in a single tag (they work as AND conditions):

Plugin settings

The HikaShop Product TAG translation plugin has configuration options available in the Joomla plugin manager (System -> Manage -> Plugins -> System - HikaShop Product TAG translation):

Menu: A global default menu item ID to use for product links. This can be overridden per-tag using the menuid:X option.

Load HikaShop on all frontend pages: When enabled, HikaShop's JavaScript and plugins will be loaded on all frontend pages. This is useful if you want cart notification popups and other HikaShop features to work on pages where products are inserted.

Order statuses for bought tag: A comma-separated list of order statuses that count as "bought" for the conditional {hkshow bought} and {hkhide bought} tags. Default is "confirmed,shipped".

Customizing the display further

If you want to go further in the customization of the inserted products display, you should copy the file plugins/system/hikashopproductinsert/hikashopproductinsert_view.php to the folder templates/YOUR_TEMPLATE/system/ via FTP and then edit the copied file. That way, your modifications won't be removed when you update HikaShop.

Alternative TAG syntax

Both of these syntaxes are supported and produce the same result:

• € 60,00 HikaShop Essential
  - Opening and closing tags
• € 60,00 HikaShop Essential

  Add to cart
  - Self-closing style (shorter)