AmazonSimpleAdmin Documentation
New website online!
Please refer to the new Plugin homepage http://www.wp-amazon-plugin.com/ to get the latest news and documentation about Amazon Simple Admin
Step-by-Step Guide
Download the Step-by-Step Guide (PDF, 688 KB)
Tags
Available BBCode tags for use in your wordpress posts are:
- [asa]ASIN[/asa]
- [asa_collection]collection_label[/asa_collection]
Templates
The [asa] and [asa_collection] tags provide the feature of declaring individual templates. Declare your template in the first opening tag after a separating space.
- [asa template_01]ASIN[/asa]
- [asa_collection template_01]collection_label[/asa_collection]
Templates are simple HTML-files located in the “tpl” folder of the amazonsimpleadmin plugin directory. They must have the extension “.htm”. For declaring a template inside a tag, use the filename without the extension.
There are several placeholders available for use inside the templates. Every placeholder contains certain information about the Amazon product. For testing simply make a copy of a template file delivered in the package.
List of Placeholders
- SmallImageUrl
- SmallImageWidth
- SmallImageHeight
- MediumImageUrl
- MediumImageWidth
- MediumImageHeight
- LargeImageUrl
- LargeImageWidth
- LargeImageHeight
- Label
- Manufacturer
- Publisher
- Title
- AmazonUrl
- TotalOffers
- LowestOfferPrice
- LowestOfferCurrency
- LowestOfferFormattedPrice
- AmazonPrice
- AmazonCurrency
- AmazonAvailability
- AmazonLogoSmallUrl
- AmazonLogoLargeUrl
- DetailPageURL
- Platform
- ISBN
- EAN
- NumberOfPages
- ReleaseDate
- Binding
- Author
- Creator
- Edition
- AverageRating
- TotalReviews
- RatingStars
- RatingStarsSrc
- Director
- Actors
- RunningTime
- Format
- Studio
- ProductDescription
- AmazonDescription
- CustomRating (can be defined by [asa custom_rating=3.5]0316015849[/asa])
- PercentageSaved
- Model
- Languages (for DVDs)
- Subtitles (for DVDs)
- ListPrice->FormattedPrice
- ListPrice->CurrencyCode
- AmountSaved->FormattedPrice
- AmountSaved->CurrencyCode
- Artist
Collections
You can use the collections feature to assemble certain Amazon products. For example, your favorite new books of the last month or your favorite videogames, and so on. To use collections you first have to activate this feature in the AmazonSimpleAdmin admin panel, so that the database tables will only be installed if you really need them.
The usage is very simple. Create a new collection by choosing a label, like “my_fav_books” or “my_fav_games”. Then you can assign the Amazon products to the collections by inserting the ASIN numbers. Later you can browse your collections and delete products or update their timestamps.
Then you can show your collections to your readers by using the BBCode [asa_collection]collection_label[/asa_collection] where collection_label stands for the name you have choosen. The default template will be used for presentation if you did not declare your own like I explained above.
Furthermore there are two parameters you can use to customize the output of a collection. With “items=2″ you can limit the number of items to display and with “type=random” the items to display are chosen randomly. Default type is “latest”. You have to separate the parameters if you use both of them.
The following would randomly display two items of my collection “my_fav_games”:
[asa_collection items=2, type=random]my_fav_games[/asa_collection]
Mario Kart Wii (inkl. Wii Wheel – Lenkrad)
Price: EUR 39,99
(346 customer reviews)
61 used & new available from EUR 26,19
Price: EUR 21,99
(69 customer reviews)
18 used & new available from EUR 7,98
Additionally you can use the funtion “asa_collection” in your PHP scripts like in sidebar.php.
- string asa_collection($label [, string [$type], string [$tpl]])Displays one or more collection itemslabel is mandatory and stands for the collection label
type is optional. “all” lists all collection items sorted by time of adding whereas “latest” only displays the latest added item. Default is “all”
tpl is optional. Here you can define your own template file. Default is “collection_sidebar_default”Example:
- string asa_item($asin [, string [$tpl]])Displays one item defined by $asinasin is mandatory and stands for the amazon ASIN
tpl is optional. Here you can define your own template file. Default is “sidebar_item”Example:
With this feature it is possible to show only the latest added product of a collection. I use this feature on the sidebar of this site under the headline “Aktuell spiele ich am liebsten” (Currently I like to play most).
Questions?
Is anything missing in this documentation or something still not clear? Please send an e-mail to info@NOSPAM_ichdigital.de (remove the NOSPAM_) or use the comments.
Pingback: AmazonSimpleAdmin_Wordpress plugin
Pingback: AmazonSimpleAdmin
Hallo,
ich würde gern einzelne Artikel (Bücher) direkt in die Seiten einbinden – also nicht im Post.
Dafür benötige ich den PHP-Code, habe aber leider keine Ahnung wie ich das realisieren soll.
In der Doku steht zwar etwas zu den Funktionen – aber wie der Code dann aussehen soll weiß ich dennoch nicht. Ich habe lediglich eine Collection angelegt (“Books”) und möchte auch nur das Standard-Template verwenden. Wie genau muß der Code dafür aussehen? Kann mir bitte jemand helfen?
Gruß, Frank
I love this amazon plugin!!
But…
Is there any way to display a maximum items in a collection and set pagenumbers below for more??
When achieving large lists of collections i get and endless scrolling problem.
Can anyone help me with this??
If you have that many items in a collection you may want to look at breaking you collection down into several smaller collections, kind of like sub-niches.
And with the new version you can limit the items by using: [asa_collection items=10]…
Pingback: AmazonSimpleAdmin Plugin | Wordpress Plugins
Hi there – I am new here and just downloaded the plugin. Unfortunately I do not understand what I have to do next? I have added all the amazon details, but now I am ‘stuck’ on collections and do not know what to do next. Can you help please!
Hi viola,
thanks for using my plugin. You can use the collections to show several items on a page by just setting one collection bb code in your post. To accomplish this go the collections menu, set up a collection with a name of your choice and start adding some amazon products to it. You can click on the browse collection button to check all items you already added. Then go to your post and add this: [asa_collection]name of your choice[/asa_collection]
All before added items will show up in the post where you add the code. Please activate the plugin’s cache before you use the collections because for every product one single amazon request has to be made and that will affect your page load time.
I hope I could help you.
Hi Timo – thanks for your reply. I ‘think’ I did what you said, and I can see the amazon pictures, but it still doesn’t work.
Do you have to tick any of theses:
Options
Allow parsing [asa] tags in user comments: ??
Enable product preview links: ??
You said: ‘You can use the collections to show several items on a page by just setting one collection bb code in your post’…what is the bb code?
I added a couple of amazon items and I can see them in the CP, but not on the actual home page??
And you say: ‘Then go to your post and add this: [asa_collection]name of your choice[/asa_collection]‘. I have added the code on the post and it does not work???
I must be doing something wrong??
Also, does every article asin have to be added (each at the time)?
Thanks for your help
Viola
Hi Viola,
no, you do not have to enalbe “Allow parsing [asa] tags in user comments” or “Enable product preview links” to make the collections work. With bb code I mean that code you have to enter in your post, like [asa_collection]collection_name[/asa_collection].
In your post you must insert the individuell collection name you chose in the settings. For example if you added a collection called “my_fav_books” the code for your post must look like [asa_collection]my_fav_books[/asa_collection]
If you use a collection you just have to add an article asin once to the collection and could then re-use the collection in your posts again and again. You can see a collection just like a way to store articles in a container. If you just want to show a few articles in one post and never want to use them again you should use the code [asa]ASIN[/asa] for every article.
Hi Timo – I think I understand all of that, but I have added this [asa_collection]track_suits_girls[/asa_collection]
and the page is blank. If I add the asin instead of the track_suits_girls, I can see the picture.
Adding [asa]ASIN[/asa] leaves a blank page also???
Was mache ich immer noch falsch?
Viola
Pingback: WordPress アフィリエイト活用術
This plugin is great unlike the other free ones I tried. However, it seems that the shortcode does not work on the sidebar as a text widget. Would be great to show a random item from a collection. Thanks, though.
Hi Tom,
I am working on a sidebar widget. Hopefully it will be available with the next update.
I am getting a blank page with BBCode [asa_collection]collection_label[/asa_collection]. Please note that i have replaced the collection label name with my collection label name. please check my site for the blank i am referring to. Please can you help. Thank you
Hello… Thks for plugin which I find great. But the prices that was shown on my site does not correpond with Amazon site… for e.g. 399 is shown as 3.99 on my site. Any ideas? thks…
Hi David,
which ASIN and country is it for this example with 399? I will check that. Also I am working on an update to fix this issue.
Hi Timo,
is there a placeholder for “Sparabo Preis” (“Subscribe & Save” for amazon.com)?
Or is that something you could include at some point in a future update?
Thanks,
Chris
Hi Chris,
sorry for the late answer. I have been busy with the new update.
I will add your request to the list of things to check
Pingback: コンバージョンが上がるアフィリエイト用プラグイン『AmazonSimpleAdmin』