Product Picker¶
The Product Picker lets you easily embed single items, collections or smart collections in your pages without having to write the Shortcodes. Just click the ASA2 editor button in the editor toolbar and the Product Picker window will open up.
Screencast¶
Amazon API Search¶
Use the first tab “Amazon API” to perform a live search on the Amazon Product Advertisment API. Select the store you want to use for the search in the “Store” dropdown menu on the right. Enter a product name and hit the “Search” button. After the search request has been submitted, you will see a list of ten results.
Shortcode Settings¶
If you have found the right product, click on the title or “Select” button and you’ll be forwarded to the “Shortcode” settings tab:
Here you can select from different display modes:
Template
Single value
Single image
Depending on the display mode, additional options for the display appear below that affect the shortcode.
Finally click the button “Insert shortcode” and the automatically generated [asa2] shortcode will be inserted in the page.
Product Search¶
If you want to select a product which is already stored in the Products, you can start with tab “Your Products”.
Here you can set some search filters to narrow down the results, like the shop of the product if you use the Shops feature.
As with the Amazon API search, click on a product’s title or “Select” button to proceed to the “Shortcode” settings tab:
Customize the shortcode setttings, click the button “Insert shortcode” and the automatically generated [asa2] shortcode will be inserted in the page.
Collection¶
The Product Picker also makes it easy to embed a Collections. Click the tab “Collections” and select the collection you want to embed from the dropdown menu. Then click the button “Proceed”.
You will be forwarded to the “Shortcode” settings tab:
Here you can select which template to use, insert a custom Associate ID and decide wheter to use AJAX mode and caching. Additionally you may adjust the collection’s sorting and limitation. Click the option “Use name” if you want to you the collection name as shortcode value instead of the collection ID.
Note
It is recommended to use the collection ID instead of the name, because the shortcode will not brake if you change the collection name afterwards.
Finally click the button “Insert shortcode” and the automatically generated [asa2_collection] shortcode will be inserted in the page.
Smart Collection¶
The Product Picker also helps you with entering [asa2_smart_collection] shortcodes.
Click the Product Picker tab “Smart Coll.” and enter the options to use with the shortcode and/or a search string. Learn more about the smart collection options here: [asa2_smart_collection].
Then click the button “Proceed”.
You will be forwarded to the “Shortcode” settings tab:
Here you can select which template to use, insert a custom Associate ID and decide wheter to use AJAX mode and caching. Additionally you may adjust the smart collection’s sorting and limitation.
Finally click the button “Insert shortcode” and the automatically generated [asa2_smart_collection] shortcode will be inserted in the page.
Single Image¶
With ASA2 you can integrate single images from all available product pictures into your pages. Simply select the option “Image only” in the tab “Shortcode” in the product picker after selecting a product.
Screencast¶
Watch this video to see the feature in action.
In addition, you can select one of the available image sizes that best fits your content. Width and height can even be adjusted individually with the short code options width and height. Together with the align option, the images can be optimally integrated into the page’s body text.
The presentation of the image is taken over by special image templates, two of which are delivered as new managed templates:
Of course you can also create your own templates for the single image feature.
Optionally, the product title as well as a shop or buy button can be displayed. A mouse-over effect shows price and rating stars (if available) above the image. This effect can be turned on or off, as well as a random, slight rotation of the Polaroid layout.
This new single image feature makes it possible to easily integrate a product image with Amazon link into a text, which often seems more accessible to the reader than overloading it with many product details.
Check the details page about the shortcode related with the single image feature [asa2_img].