Child pages
  • Minimum Advertised Price
Skip to end of metadata
Go to start of metadata

Extension page: http://ecommerce.aheadworks.com/magento-extensions/minimum-advertised-price.html


The Minimum Advertised Price Magento extension adds a special Check Price button instead of the usual product price. If the price in your store is less than the minimum stipulated price for this product, either no price is displayed or the List Price is displayed with a strikethrough just to stress that your price is lower.

Installation

1. Backup your web directory and store database.

 Click to view details

You can make backup copies with any tool you find appropriate

If you are going to use the native Magento backup function, navigate to System -> Tools -> Backups and perform System and Database backups

 2. Log in to the Magento backend

 3. Disable compilation

 Click to view details

Navigate to System -> Tools -> Compilation.

If Compiler status is Disabled, you can skip to the next step

If Compiler is enabled, disable it.

IMPORTANT: after the extension is installed, you can enable the compilation again; IT IS CRUCIAL that you use "Run Compilation Process" function, not just "Enable button"

Icon

Installing an extension with the Compilation enabled will result in store downtime.

 4. Flush store cache

 Click to view details

You can flush the store cache in 2 ways:

  • via the backend:

Navigate to System -> Cache Management menu, and click Flush Magento Cache button

  • via filesystem:

On your server, navigate to Magento root folder, then proceed to /var/cache/; delete all the content there.

 5. Download the extension package from your account and extract the downloaded archive

 6. Copy the content of /Step_1/ folder to your store's root directory

If you are using a custom theme,

Icon
 read the instructions here.

In case you are using a custom theme, it is recommended to copy the design files to your current theme's folders. In case there are several themes in use at the same store, the design files must be copied to each of them.

  • Find this folder in the package: /step_1/app/design/frontend/base/default/ ; copy its content to /app/design/frontend/[your_package]/[your_theme]/
  • Find this folder in the package: /step_1/skin/frontend/base/default/ ; copy its content to /skin/frontend/[your_package]/[your_theme]/

 7. Copy the content of /Step_2/ folder to your store's root directory

 8. Flush store cache again; log out from the backend and log in again.

New product attributes

The extension adds Minimum Advertised Price and List Price attributes to products. They can be set on Prices tab of Catalog -> Manage Products -> Product page of the Admin section.

The additional You Save attribute is calculated as List Price – Price or, if List Price is not set, as Minimum Advertised Price – Price. If both List Price and Minimum Advertised Price are not set, You Save = 0.

The view of List PricePrice, and You Save attributes can be customized. You can set templates for displaying these attributes and their visibility on category/search/product page views on Minimum Advertised Price tab of System -> Configuration page of Admin section.

Action Buttons

There are 3 action buttons:

  • Just Checking Price - hides the window;
  • Keep in Cart - adds the product to the cart and brings the customer to the Cart page;
  • Buy Now - adds the product to the cart and brings the customer to the Checkout page.

You can hide the default button bar located at the bottom of the Check Price window as far as assign action of any button to any element(s) of the window HTML content.

'Check Price' window content

The Check Price window can display macro fields based on the product attributes.

It is also capable to include any content that Magento CMS can involve:

  • HTML;
  • Images/Flash;
  • JavaScript;
  • Code for fetching of other blocks.

Configuration

To hide the price and display the Check Price button instead, please follow the steps below:

1. Set Minimum Advertised Price

Go to the Prices tab on the product page, and set Minimum Advertised Price there. The Check Price button will be shown instead of the price when the product minimum advertised price is higher than its price.

WARNING: Please note that Minimum Advertised Price is available for simple, virtual, and configurable products only!

1.1. Minimum advertised price for Configurable products

Since MAP version 1.1 you can set up Minimum Advertised Price for configurable products. Displaying the MAP or regular price for such product type depends on the MAP for configurable products is taken from setting: if Configurable product is set, the price/MAP button will be displayed according to the product attributes, but if Associated product is defined, the price/MAP button will be displayed for the simple product currently selected.

Note that in case when Associated product is defined, the simple product price/MAP button won't be displayed until all attributes of the current configurable product are specified.

2. Set the 'Check Price' button view

Go to the System -> Configuration page of the Admin section, select the Minimum Advertised Price tab and do the following:

2.1. Enable the Check Price button

You can set the visibility of the default Check Price button by changing the Display Standard "Check Price" Button option.

In case if you disabled the standard Check Price button, you have to define any HTML element on step 2.2 and assign the {checkPrice} action macro to one of the element events (see step 3.1 for example of such assigning).

2.2. Set the Check Price button additional text

Set Additional HTML to define the HTML template content that will be displayed below (or, in case you have disabled the standard Check Price button, instead of) the Check Price button.

The HTML content has the same properties as the content of the Check Price window, so refer to step 3 to learn how to use it.

3. Set the content of the 'Check Price' window

Go to the System -> Configuration page of the Admin section, select the Minimum Advertised Price tab and define the HTML template content of the Check Price window.

3.1 Action buttons customization

You can hide the default button bar located at the bottom of the Check Price window by changing the Show Button Bar option on the extension configuration page in the Admin section.

You can also assign an action to any HTML element, for example:

or

The actions are:

  • {close} - corresponds to Just Checking Price;
  • {addToCart} - adds the product to the cart and hides the Check Price window;
  • {goToCart} - corresponds to Keep in Cart;
  • {goToCheckout} - corresponds to Buy Now.

3.2 Product attributes displaying

You can use macro fields to display the value of any product attribute such as Price, SKU, Description, Image link, etc., by placing product attribute name in braces like {attribute}. If the attribute name consists of two or more parts, join the parts with underscores like {long_attribute_name}.

For example:

The price for <strong style="color:#306375">{name}</strong> is <strong style="color:#EB5E00">{price}</strong>

Note that the list of the product attributes depends on many factors, and there are attributes available for any product by default, as far as customizable attributes added by the shop owner, Magento extensions, and so on. Please keep in mind also the fact that if the product attribute is optional, its value can be undefined and in this case the extension can not replace the attribute name by its value.

Also note that all the product and action macro names are case-sensitive, so be careful when typing them.

The list below contains the most useful attributes a product has:

Name and Description

  • name
  • meta_title
  • meta_description
  • short_description
  • description
  • in_depth
  • activation_information

Pricing

  • price
  • cost
  • minimal_price (for configurable products only)
  • minimum_advertised_price (added by this extension)

And there is special macro field named you_save_price representing the difference between the List Price (or, if the List Price is not set, between Minimum Advertised Price) and the Price of the product, i.e. you_save_price is calculated as list_price – price orminimum_advertised_price – price.

Each attribute containing pricecost, or tax in its name is duplicated with "_formatted" suffix appended to the name and value formatted with the current store settings (for example, final_price_formatted = $850.00).

Images

  • image
  • small_image
  • thumbnail
  • image_label (not available since Magento 1.4.x)
  • small_image_label
  • thumbnail_label

Since Magento uses dynamic complex URL for cached thumbnail images, and thumbnails themselves can be of different size depending on the place they are inserted, there is a special macro field named {thumbnail_url} that has an optional thumbnail sizeparameter defining the dimensions of the thumbnail inserted. For example, {thumbnail_url 75} means that an URL will be inserted pointing to the thumbnail that has a dimension of 75x75 pixels. If the thumbnail size parameter is omitted, a default value of 56 is assumed.

Date & Time (looks like '2007-08-23 18:06:42', string length=19)

  • created_at
  • updated_at

URL constructing

  • store_id
  • entity_id'
  • url_key

General

  • type_id (may be either simplevirtual, or configurable since bundled and other product types are not supported now)
  • sku
  • meta_keyword
  • is_in_stock
  • is_salable
  • enable_googlecheckout

Please note that attributes like weight, model, color, dimension, gift_message_available are optional and may not be presented among the product attributes.

3.3 Product images displaying

As far as macro fields allow gaining access to any product attribute, it is possile to use them in a HTML template to display product images or thumbnails. For example, we can use the product {image} attribute:

Please note that in the example above we had to use Magento CMS content { {media url="..."} } macro to get correct URL to the product image.

The example below demonstrates how to insert product thumbnail image that has the dimension of 50x50 pixels:

3.4 Magento CMS Content displaying

In the Check Price window you can use any content that Magento CMS can involve. It's especially useful for inserting links, images, Flash, etc. related to the product.

See example above to learn how to use CMS macro for inserting product image to the Check Price window.

The following example demonstrates how to place a 'Closing cross' on the top-right of the window:

Troubleshooting

After the extension installation the store gives an error, or blank page, or suggests to start Magento installation procedure.

Change the owner of the extracted extension files to the web server user and set 775 permissions on them. Clear the store cache and try again.

There is no aheadWorks extensions under my configuration section, or having the extension tab clicked I get a blank page, or Access Denied error.

Clear the store cache, browser cookies, logout and login again.

I've set up everything correctly, inserted the HTML code but there is nothing on that page.

Clear the store cache, clear your browser cache and domain cookies and refresh the page.

My configuration changes do not appear on the store.

 Clear the store cache, clear your browser cache and domain cookies and refresh the page.



You can always find the latest version of the software, full documentation, demos, screenshots and reviews at http://ecommerce.aheadworks.com
License agreement: http://ecommerce.aheadworks.com/LICENSE-M1.txt
Contact us: http://ecommerce.aheadworks.com/contacts/
Copyright © 2015 aheadWorks Co. http://www.aheadworks.com


  • No labels