.. include:: _include.rst .. highlight:: bbcode .. _kickstarter_guide: ##################################### Kickstarter Guide for ASA2 Switchers ##################################### For those who have been using ASA 1 for quite some time, this page gives an overview about how the features known from ASA 1 work in |asa2|. **************** Migration Wizard **************** When you switch from ASA 1, it is very recommended to use the :ref:`migration_wizard` to migrate your ASA 1 tempaltes and collections to |asa2|. .. note:: |asa2| is backwards compatible and can handle all ASA 1 contents even the widgets and PHP functions. ********** Shortcodes ********** ============================================================== ============================================================== ASA 1 |asa2| ============================================================== ============================================================== [asa]ASIN[/asa] [asa2]ASIN[/asa2] -------------------------------------------------------------- -------------------------------------------------------------- [asa_collection]collection_name[asa_collection] [asa2_collection]collection_name[asa2_collection] -------------------------------------------------------------- -------------------------------------------------------------- -- [asa2_smart_collection /] -------------------------------------------------------------- -------------------------------------------------------------- -- [asa2_img /] -------------------------------------------------------------- -------------------------------------------------------------- -- [asa2_keywords /] -------------------------------------------------------------- -------------------------------------------------------------- -- [asa2_textlink]ASIN[/asa2_textlink] ============================================================== ============================================================== Check out the manual page of each |asa2| shortcode, to learn more about it: - :ref:`shortcodes_asa2` - :ref:`shortcodes_asa2_collection` - :ref:`shortcodes_asa2_smart_collection` - :ref:`shortcodes_asa2_img` - :ref:`shortcodes_asa2_keywords` - :ref:`shortcodes_asa2_textlink` ********* Templates ********* One of the main features of ASA 1 is its flexible template system. |asa2|'s template system is a lot more flexible and comes with all the missing functions of ASA 1, like conditions. ============================================================== ============================================================== ASA 1 |asa2| ============================================================== ============================================================== Templates stored in filesystem Templates stored in database (update-safe) -------------------------------------------------------------- -------------------------------------------------------------- -- Conditions (``{% if OfferIsPrime %}...{% endif %}``) -------------------------------------------------------------- -------------------------------------------------------------- -- Loops (``{% for imgSet in ImageSetsArray %}...{% endfor %}``) -------------------------------------------------------------- -------------------------------------------------------------- -- Filters (``{{ PublicationDate|date("m/d/Y") }}``) -------------------------------------------------------------- -------------------------------------------------------------- -- Functions (``{{ random('ABC') }}``) -------------------------------------------------------------- -------------------------------------------------------------- -- Include other templates (``{% include "template_name" %}``) -------------------------------------------------------------- -------------------------------------------------------------- -- Translations (``{{ translate("price") }}``) ============================================================== ============================================================== --------------- Template Syntax --------------- Read more about |asa2|'s template system and syntax: - :ref:`templates` (General introduction) - :ref:`managed_templates` - :ref:`template_conditions` - :ref:`template_loops` - :ref:`template_filters` - :ref:`template_functions` - :ref:`templates_include` - :ref:`templates_translation` ************ Placeholders ************ ============================================================== ============================================================== ASA 1 |asa2| ============================================================== ============================================================== Static placeholders Static placeholders -------------------------------------------------------------- -------------------------------------------------------------- Customer average rating including stars image Customer average rating including stars image -------------------------------------------------------------- -------------------------------------------------------------- -- Dynamic placeholders (e.g. :ref:`placeholders_custom_fields`) -------------------------------------------------------------- -------------------------------------------------------------- -- Support for variations (products with selection) -------------------------------------------------------------- -------------------------------------------------------------- -- Support for image sets (all available product images) ============================================================== ============================================================== Read more about |asa2|'s placeholders: - :ref:`placeholders_default` - :ref:`placeholders_reviews` - :ref:`placeholders_custom_fields` - :ref:`placeholders_variations` - :ref:`Image sets ` - :ref:`repo_adv_custom_fields` ************ Collections ************ In |asa2|, collections work like in ASA 1 but can be managed much more efficiently. ============================================================== ============================================================== ASA 1 |asa2| ============================================================== ============================================================== Create unlimited collections Create unlimited collections -------------------------------------------------------------- -------------------------------------------------------------- -- Copy collections -------------------------------------------------------------- -------------------------------------------------------------- -- Import / export collections -------------------------------------------------------------- -------------------------------------------------------------- -- Special templates with surrounding container -------------------------------------------------------------- -------------------------------------------------------------- -- Product picker (Amazon live search) ============================================================== ============================================================== Read more about the collections in |asa2|: - :ref:`collections` (General introduction) - :ref:`collections_copy` - :ref:`collections_import` - :ref:`templates_surrounding_container` - :ref:`product_picker` ************ New features ************ |asa2| has a lot of new features which have never been a part of ASA 1: ============================================================== ============================================================== ASA 1 |asa2| ============================================================== ============================================================== -- Products (:ref:`repo`) -------------------------------------------------------------- -------------------------------------------------------------- -- Shops (:ref:`shops`) -------------------------------------------------------------- -------------------------------------------------------------- -- :ref:`Using external CSV files ` -------------------------------------------------------------- -------------------------------------------------------------- -- Smart Collections (:ref:`shortcodes_asa2_smart_collection`) -------------------------------------------------------------- -------------------------------------------------------------- -- Keyword Search (:ref:`shortcodes_asa2_keywords`) -------------------------------------------------------------- -------------------------------------------------------------- -- :ref:`managed_templates` -------------------------------------------------------------- -------------------------------------------------------------- -- :ref:`i18n` -------------------------------------------------------------- -------------------------------------------------------------- -- :ref:`templates_translation` -------------------------------------------------------------- -------------------------------------------------------------- -- :ref:`product_picker` -------------------------------------------------------------- -------------------------------------------------------------- -- :ref:`notifications` -------------------------------------------------------------- -------------------------------------------------------------- -- :ref:`cronjobs` -------------------------------------------------------------- -------------------------------------------------------------- -- Advanced :ref:`caching` -------------------------------------------------------------- -------------------------------------------------------------- -- Advanced :ref:`php_functions` ============================================================== ==============================================================