.. include:: _include.rst .. highlight:: html+jinja .. _options_repo: ##################### Products ##################### .. include:: _include_local_toc.rst For more information about the |repo|, check documentation section :ref:`repo`. .. _options_repo_deactivate: ********************************** Deactivate Products ********************************** If you do not want to use the |repo|, you can set this option to deactivate it completely. .. image:: _static/repo_option_deactivate.png :width: 784px :height: 80px :scale: 100% :alt: Deactivate Products ********************************** PA API ********************************** Deactivate auto-refresh ----------------------- This option deactivates the Products's auto-refresh function. When a product gets loaded on a page, it will be refreshed automatically if its last refresh time is older than the product lifetime (see below). By deactivating this functionality, the product data will be loaded from the database as long as it gets refreshed manually. If you deactivate the auto-refresh, the products will not be refreshed automatically. This makes sense if you use the cronjob :ref:`repo_cronjob` to automatically refresh all products (e.g. over night). .. image:: _static/repo_option_deactivate_autorefresh.png :height: 51px :width: 593px :scale: 100% :alt: Product deactivate autorefresh Product lifetime ---------------- You can adjust the product lifetime with this option. The lifetime value is used to determine if a product has to be updated or not. If the seconds since the last refresh are more than the lifetime, than the product will be refreshed (if autorefresh is activated). The lifetime value has to be defined in seconds. Leave it blank to use the default lifetime of 3600 seconds (one hour). .. image:: _static/repo_option_lifetime.png :height: 91px :width: 717px :scale: 100% :alt: Repo option lifetime Update title on refresh -------------------------------- Update the title of the product when refreshing the product data. This will replace the customizable product post title with the original product title delivered by the API. ************************ Custom Products ************************ Reset rating when reconnecting to PA API ---------------------------------------- If a Amazon product that has been created without PA API gets reconnected to the PA API, custom rating values will be reset. Assign to default shop ---------------------- Assigns all products that are not assigned to a store to the default store. ASA2 has already done this initially. Use it when there is something wrong or for support cases. Default Country --------------- This option allows you to set the default country for custom products. ************************ Misc ************************ Deactivate auto-transfer ------------------------ If set, the products auto-transfer feature will be deactivated. .. note:: By default, whenever |asa2| requests a product via the |apilong|, it will be stored in the |repo| to retrieve its data from there on the next request within the lifetime. By default, on every request to the Amazon |api|, |asa2| will check if the product already exists in the |repo|. If not, it will be saved there. This is recommended, because on the next request, |asa2| can load the product from the database instead of requesting it from the |api| again. .. image:: _static/repo_option_deactivate_autotransfer.png :height: 75px :width: 724px :scale: 100% :alt: Repo option deactivate autotransfer Deactivate auto-transfer on post save ------------------------------------------------ When a post or page gets saved or updated, |asa2| checks if there are products embedded in the contents. If they are Amazon products, they get transfered to the |repo|, if they do not already exists there. This is recommended, because after you have published a post, the product will be loaded from the database instead of from the |api| when the frontend page gets accessed by a user. For whatever reason, you may deactivate the auto-transfer on post save functionality with this option. .. note:: By default, when you save or update a post, |asa2| will transfer all Amazon products embedded in the post/page content to the |repo|, if they do not exist already. .. image:: _static/repo_option_deactivate_autotransfer_on_save.png :height: 91px :width: 725px :scale: 100% :alt: Products option deactivate autotransfer on save ************************ Public product pages ************************ Set this if you want the product pages to be public. They are not public by default. ************************ Item pages slug ************************ Customize the permalink structure slug for public products pages. Default is "asa2_repo". ************************ Sales rank column ************************ .. image:: _static/repo_sales_rank_column.png :height: 190px :width: 190px :scale: 100% :alt: Products sales rank column If set, a dedicated column containing the sales rank will be displayed in the Products list table. ************************ Include in feeds ************************ .. image:: _static/repo_option_include_in_feeds.png :height: 68px :width: 939px :scale: 100% :alt: Products option include in feeds Set this if you want the products to be included in feeds. They are not included by default. This should only be used with public product pages! *********************** Featured image fallback *********************** .. image:: _static/option_repo_featured_image_fallback.png :height: 53px :width: 899px :scale: 100% :alt: Products featured image fallback If a product has no image information delivered by the API, the featured image on the product will be used instead. *********************** Prefer featured image *********************** .. image:: _static/option_repo_prefer_featured_image.png :height: 62px :width: 1051px :scale: 100% :alt: Products prefer featured image If this option is active, the featured image of a product will be used instead of the main product image delivered by the API.