.. include:: _include.rst .. _subsection_keywords: ############################ Keywords ############################ .. include:: _include_local_toc.rst ******************* Keywords Preloading ******************* This section currently contains an overview for the preloading function for :ref:`shortcodes_asa2_keywords` shortcodes. The list contains entries of all known preloadable shortcodes. .. image:: _static/section_keywords_list.png :height: 535px :width: 1023px :scale: 100% :alt: Keywords Preload List The "ID" column refers to the unique identifier option of the :ref:`shortcodes_asa2_keywords` shortcode (see :ref:`shortcodes_asa2_keywords_option_id`). The Timeout column contains the time information (hours:minutes:seconds) for how long this keywords shortcode remains in the cache. ---------------------- Background Information ---------------------- To render a :ref:`shortcodes_asa2_keywords` shortcode, |asa2| sends one request to the |api|. The results remain in the cache as long as it is defined in the "Options / Cache / Keywords cache" section. If the cache expired, another request would be needed to refresh the results. Typically, this occurs when the first visitor comes to the page with the shortcode, which may cause some delay in page loading. To avoid this, you can set a :ref:`shortcodes_asa2_keywords` shortcode a unique ID (see :ref:`shortcodes_asa2_keywords_option_id`) so that |asa2| can remember it. If you have defined this ID, |asa2| will save it automatically when the shortcode is loaded in the frontend and the corresponding entry will appear in this admin section list. ---------------------- Preloading via Cronjob ---------------------- Using a periodic cron job, |asa2| can now refresh these known shortcodes before the cache becomes invalid. Thus, the request is sent without involving the user, at least if it is a real server-side cronjob. Learn more about the :ref:`cronjob_keywords`.