Collections¶

Screencast¶

Create a new collection¶

To create a new collection, select the section “Collections” from the ASA2 main menu:

Name¶

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.

Comment¶

Optionally you can enter a comment for a collection. This will show up in the list of collections when you hover over the collection name.

Save the new collection and you will be redirected to the main collections page where the new item can be found in the listed.

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, ASA2‘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.

Delete items¶

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”.

Embedding¶

To embed a collection in a page, use the shortcode asa2_collection and place the name of the collection inside the tag, like this:

[asa2_collection]lego_starwars_spaceships[/asa2_collection]

Check the documentation page [asa2_collection] to learn about all the options of this shortcode.

Even easier is to use the ASA2 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.

Copy collection¶

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.

Export collection¶

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.

Import collection¶

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.