.. include:: _include.rst .. _first_steps: ############ First steps ############ .. include:: _include_local_toc.rst .. _first_step_setup: *************************** Setup *************************** If you want to use the |api| to automatically update Amazon products, you need to enter your credentials in the :ref:`setup` section. .. raw:: html For more information, read: :ref:`setup`. .. _first_step_license_activation: ****************** License activation ****************** To be able to receive **auto-updates** through your WordPress plugins backend, you have to activate your |asa2| license. On single site installations, go to page "ASA 2 Pro / License". On multisite installations, go to page "ASA 2 Pro" in your Network Admin backend. Enter the license key you have received upon your purchase. You can find your license key in your purchase email and on your |asa2| account page: https://getasa2.com/your-account/ .. image:: _static/license_page.png :height: 321px :width: 1102px :scale: 100% :alt: ASA 2 license page Without activated license, you can not receive auto-updates: .. image:: _static/update_license_issue.png :height: 87px :width: 742px :scale: 100% :alt: ASA 2 update license issue For more details about licensing, please see chapter :ref:`licensing`. .. _first_step_embed_single_product: *************************** Embedding a single product *************************** The easiest way to embed an Amazon product in your WordPress pages is to use |asa2|'s |productpicker|. Just click the button in the WordPress editor toolbar and use the search field to find the product. Then click the product title and on the settings tab the button "Insert shortcode" and you're done. .. raw:: html Read more about :ref:`product_picker`. .. raw:: html ********************** Template customization ********************** On ASA 2's admin page "Templates" you can open a customization context window for each managed template. Just hover the mouse cursor over a template row and click the link "Customize" to open it. These settings will effect the appearance of this template. .. raw:: html Read more about :ref:`managed_templates_customization`. *********************** Create custom templates *********************** |asa2| comes with some managed templates to render the products on your WordPress pages. If they do not fit so well to your WordPress theme, you can easily **create own templates**. Just navigate to |asa2|'s templates admin page and either create a new template or duplicate an existing. Afterwards you can select your custom template in the product picker or manually use the shortcode options ``tpl`` (:ref:`shortcodes_asa2_opt_tpl`) or ``tplid`` (:ref:`shortcodes_asa2_tplid`). .. image:: _static/template_code_example1.gif :height: 473px :width: 820px :scale: 100% :alt: ASA 2 template example Read more about customizing the layout in :ref:`templates`. ******************************* Collections ******************************* With collections you can bundle an unlimited amount of products into one container and embed all those products in a page with just one shortcode. .. raw:: html Read more about how to use collections in :ref:`collections`. ******************************* Using Products ******************************* Check out the :ref:`repo` section for more details. ************** Using Shops ************** Check out the :ref:`shops` section for more details. .. raw:: html

************** Keyword Search ************** With the shortcode [asa2_keywords] you can dynamically display the results of an Amazon product search on your site. More details: :ref:`shortcodes_asa2_keywords` ************ Single Image ************ With |asa2| you can display a single product image selected from all available ones. More details: :ref:`shortcodes_asa2_img` ********** Text Links ********** With shortcode [asa2_textlink] you can easily embed Amazon text links in your WordPress pages. More details: :ref:`shortcodes_asa2_textlink`