plugin: JoomShopping

Description

This plugin enables you to insert products (one by one or by a selection on one or several categories) from JoomShopping in your Newsletters.

You can also use this plugin to automatically include your newly created (or modified) products in an Auto-newsletter.

You can search in all your JoomShopping products and then click on one of the products to include it in your Newsletter.

If you purchased at least one paid version of AcyMailing, you can download the JoomShopping plugin on our plugins section then install and publish it like a standard Joomla plugin.

Here is an example of inserted product:

Plugin

Single Product

You can use this interface to insert any JoomShopping product in your Newsletter.

Each product can be selected one by one.

• Display: select the information to display with the product

• Clickable Title: make your title clickable (so linked to your online version) or not.

• Read More: add a "read more" link at the end of the product (so linked to your online version)

• Languages: select the language or keep the default value if you want to display the product in the current Back-end language

• Truncate the text after...: it will truncate the product description, keep "0" or empty if you do not want to truncate it

• Display pictures: you can decide to display or not the main picture of the product.

• Additional parameters:

  • itemid: it will add the specified itemid in the link

Categories

You can select one or several JoomShopping categories and AcyMailing will automatically include the JoomShopping products belonging to the selected categories.

• Label: Filter your products by their "Label" field.

• Max. Number of items: The inserted tag will be replaced by a maximum of X products.

• Min. Number of items: This option will only be displayed if you access this plugin for a Smart-Newsletter. AcyMailing will only generates your Smart-Newsletter if the minimum number of JoomShopping products found is reached.

• Filter: This option will only be displayed if you access this plugin for a Smart-Newsletter. You can set a rule so that only newly created or modified JoomShopping products are added to your Newsletter.

• Order by: order the products by ID, title, etc...

• Columns: display the products in one, two or more columns

Coupons

With the "Coupon" tab, you can insert existing JoomShopping coupon by clicking on the one you want to insert in your newsletter:

You can also create a new coupon for each receiver by clicking on the "New" option:

• Coupon Code: With this option, you can set the coupon code depending on the receiver's data. For example if the newsletter is sent to john, the coupon code could be "johnab56d42". You can use in this field the following receiver's datas: [name], [subid], [email], [key] which is a random key of 5 characters and [value] which is the coupon value.

• Permanent/Gift: Select if you want the coupon to be available only one time of if you want it to be permanent until the expiry date.

• Value: Set here the numeric value of the coupon. Set also if the value is a percentage or not (here, the value is $42)

• Date: Set here the date the generated coupon will be enabled. You can either choose a specific date or specify a delay after the newsletter is sent (here, the coupons will be enabled 3 days after the newsletter is sent)

• Expiry Date: You can specify with this option if you want to apply an expiry date on the generated coupons. Set a specific date or a delay after the newsletter is sent (here, there will not be an expiry date)

Parameters

• Display products: This parameter enables you to filter the list of JoomShopping products in the tag system

  • All products: AcyMailing will display all your JoomShopping products

  • Only published products: AcyMailing will only display your published products

• Front-end Access: You can hide this plugin's tab on the Front-end tag's popup

Customize your product using some CSS

You can change the styles used for the title and the content area by editing your AcyMailing template.

Edit the AcyMailing template used for your Newsletter and then set some styles:

• Style for the content area will be used to encompass your product

• Style for the content title will be applied to your product title

• Style for the read more link will be applied to your read more link (if you have one)

• You can also set the style of all your links using the Link a field

Set styles template

Create your own template

You can also modify the way your JoomShopping product is displayed by creating your own template which will be used to render the product. Please follow those instructions, we don't recommend you to modify the JoomShopping plugin directly otherwise your changes will be overwritten when you update the plugin.

Create a file in the the folder media / com_acymailing / plugins (if the folder does not exist, please create it first). The name of the file should be joomshopping.php If this file is available on your server, AcyMailing will use it and won't use the default one.

On this file you can access the element $varFields (which contains all the product information), the element $tag (which contains the information of the current tag used in your Newsletter) and $link (the product link)

You can insert the product information using this simple syntax : {name_en-GB}, {link} or {description_en-GB}

Using all those variables, you can create your own product template.

Here is an example:

<div class="acymailing_content">
    <a href="{link}" name="joomshopping-{product_id}" target="_blank" >
        <h2 class="acymailing_title">{name_en-GB}</h2>
    </a>
    <a href="{link}" target="_blank" style="text-decoration:none" >{imagehtml}</a>
    {description_en-GB}
    Price: {product_price} {currency_code} 
    Rating: {average_rating}/5
</div>