Let’s say you want to include four products into your new post and also in an older post. As explained on the [asa2] shortcode page you would have to include the shortcode
[asa2] four times in every post. With copy and paste it still would be acceptable but not very convenient. That would be the right moment to think about ASA 2‘s collections feature.
With collections you can bundle an unlimited amount of products into one collection container identified by a name of your choice. To embed this bunch of products in your pages, you only have to insert one shortcode [asa2_collection] with the name of your collection.
Create a new collection¶
To create a new collection, select the section “Collections” from the ASA 2 main menu:
Then click the button “Create new collection” and enter a name for the new collection, e.g. “lego_starwars_spaceships”. Collections names may only contain alphanumeric characters, numbers and underscores.
Add new items¶
Hover over the list item and select the option “Manage items”.
On the “Manage collection” page, use the ASIN field to enter the ASIN of the product you want to add to the collection. When you click in the ASIN field, ASA 2‘s Product Picker will open up automatically. Use it to search the Amazon store of your choice for the products you want to add.
Clicking on the title of a product in the list will add its ASIN to the ASIN field. Then click the button “Add” and the product will be added to the collection.
Go ahead and add as much items to the collection as you want.
To delete an item from a collection, hover over the entry and click the “Delete” link.
To delete multiple items, select the items and use the bulk action “Delete”.
To embed a collection in a page, use the shortcode
asa2_collection and place the name of the collection inside the tag, like this:
Check the documentation page [asa2_collection] to learn about all the options of this shortcode.
Even easier is to use the ASA 2 editor button:
When you click on it, the Product Picker will open and you can select the collection you want to embed in the section “Collections”:
Click the button “Proceed” to get to the “Shortcode” settings. Here you can adjust the options which will be used for the shortcode, e.g. select a custom template or tracking ID or set a limit about how many collections items should be loaded.
Finally click the button “Insert shortcode”. The shortcode will be generated and inserted into the post editor.
If you want to create a new collection similar to one you already have, you could use the “Copy” function. Hover over the list item of the collection you want to copy and click the link “Copy”.
A duplicate collection will be created containing all the items of the original one.
If you want to move a collection from one site to another or just want to create a backup file, you can use the “Export” function. Hover over the list item of the collection you want to copy and click the link “Export”. You will be prompted to store the XML export file to your local computer.
To import a collection, select the button “Import collection” on top of the collections main page. In the import form select a XML file generated by the collection export function. To mark the name of an imported collection, you may insert a prefix which will be prepended to the imported collection’s name.
Click “Submit” and wait a short moment while the import will be processed.
Import ASA 1 collections¶
You can import your collections of ASA 1 to ASA 2. Just be sure to update to the newest release of ASA 1. Then you will see an “Export” button in ASA 1’s collections manage console:
You will receive an XML export file which you can use to import in ASA 2 as a new collection.
After you imported a ASA 1 collection in ASA 2, switch to the “Manage items” page.
Because ASA 1 does not store the item title and preview image in collections, those fields are empty. To update the items, select all and choose “Refresh” from the bulk actions.