Collections¶
Table of contents
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 ASA2’s collections feature.
Mit Collections kannst du eine unbegrenzte Anzahl Produkte in einer Collection mit einem frei wählbaren Namen zusammenfassen. Um dieses Bündel an Produkten in eine Seite einzubetten, muss nur ein Shortcode [asa2_collection] mit dem Namen der Collection eingefügt werden.
[asa2_collection]lego_starwars_spaceships[/asa2_collection]
Screencast¶
Neue Collection erstellen¶
Um eine neue Collection zu erstellen, wähle “Collections” aus dem ASA2 Hauptmenü:

Name¶
Klicke dann den Button “Neue Collection erstellen” und gib einen Namen für die Collection ein, z.B. “lego_starwars_spaceships”. Collection Namen dürfen nur alphanumerische Zeichen, Zahlen und Unterstriche enthalten.

Kommentar¶
Optional kannst du einen Kommentar für eine Collection eingeben. Dieses wird in der Liste aller Collections angezeigt, wenn du mit dem Mauscursor über den Namen einer Collection fährst.

Speichere die Collection und du wirst auf die Collections Hauptseite weitergeleitet wo der neue Eintrag gelistet ist.
Neue Artikel hinzufügen¶
Fahre mit dem Mauscursor über einen Listeneintrag und wähle die Option “Manage items”.

Auf der Seite “Manage collection” gib die ASIN des Artikels den du hinzufügen möchtest in das Feld ASIN ein oder wähle die Suchfunktion aus, um das Produkt direkt bei Amazon zu suchen.

Ein Klick auf den Titel eines Produktes fügt dessen ASIN in das ASIN-Feld ein. Klicke danach den Button “Hinzufügen” und das Produkt wird der Collection hinzugefügt.

Nach dieser Vorgehensweise kannst du noch beliebig viele weitere Produkte zu der Collection hinzufügen.
Artikel löschen¶
Um einen Artikel aus einer Collection zu entfernen, fahre mit dem Mauszeiger über den Eintrag und klicke auf “Löschen”.

Um mehrere Artikel zu löschen, markiere diese Artikel und wähle die Mehrfachbearbeitungsfunktion “Löschen” aus.

Einfügen¶
Um eine Collection in einer Seite einzufügen, verwende den Shortcode asa2_collection
und setze den Name oder die ID der Collection innerhalb des Tags ein, wie hier:
[asa2_collection]lego_starwars_spaceships[/asa2_collection]
Sieh dir die Dokumentationsseite [asa2_collection] an, um alle Optionen dieses Shortcodes zu erfahren.
Noch einfacher geht es mit dem ASA2 editor button:

Wenn du ihn anklickst, öffnet sich das Product Picker Fenster und du kannst die gewünschte Collection im Bereich “Collections” auswählen:

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.
