Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

--- skoda-ep:skoda_banners [27.10.2021 08:29]
Jakub Štěpánek [Bulk tagging of content]
+++ skoda-ep:skoda_banners [05.06.2024 06:33] (aktuální)
Zbyňěk Hovorka [Škoda Banners - Special Banners for Homepage and Stories]
@@ Řádek 1: / Řádek 1: @@
 ====== ŠKODA Banners ======
-Škoda banners module adds capability to published banners on Škoda Storyboard portal. Banners are displayed in 2 ways - calculated (based on some conditions) and direct (direct placing in to specific article).
+Škoda banners module adds capability to published banners on Škoda Storyboard portal. Banners are displayed in 3 ways - calculated (based on some conditions). direct (direct placing in to specific article), content (Site Origin Widget must be usedused).
 {{ :skoda-ep:banner-positional.png?300 |}}
+===== Škoda Banners Basic Flow =====
+If user consumed an article on the Storyboard and the article is marked by some banner categories, Information is saved in to LocalStorage - browser level.  This information is used to determinate if banner should be display or not.
+When there is a banner available and all conditions are met to display it, Page store information about display too. So it can track how many time banner was shown to user.  If limit is reached, next information is saved - so it can hold showing banner until some time (specified on the banner level setting).
+{{ :skoda-ep:storyboard-banners-flow.jpg |}}
+Banner is displayed until "Show max" times
+  * Each banner display is saved to the user's browser.
+For example, if the banner's Show max is set to 20, the user views the banner 18 times, and then the Show max is set to 10 in the admin, the banner will stop displaying to the user because it has 18 views stored on its page
+  * After displaying the "Show max" times, it is checked if the last display occurred: (Time now - Time of last banner display) > Show max expiration
+Example: (29.8.2023 - 20.8.2023) > 3 = The last display occurred 9 days ago and Show max expiration is set to 3, so the banner resets and starts displaying again until the "Show max" times are displayed again and then repeats
+  * Show max expiration - resetting the banner display starts checking when the number of views (Show max) is full, not periodically!
+===== ŠKODA Banners global settings =====
+Settings control global parameters for banners. It is mostly used for enable debuging or disable positional banners, and some more parameters. All options have its own description.
+{{ :skoda-ep:banner-global-settings.png |}}
 ===== Redaction =====
@@ Řádek 35: / Řádek 59: @@
   * Show max - Maximum banner displays for current user.
   * Show max expiration - Number of days after which to display banner again (after reaching "Show max")
+  * Country blacklist -  Allows for the exclusion of countries using their 2-letter ISO 3166 codes. You can exclude an unlimited number of countries.
 ==== In article banner settings ====
@@ Řádek 57: / Řádek 81: @@
 To mark relevant content with appropriated Banner tag, you can use Bulk Edit in list of articles, Use search, or click some term from for example Models taxonomy, It will select all articles for example market by KAROQ, Select found articles (not more then 10) click Bulk Edit, Add tag to ŠKODA Banners Tag field and save it (be sure the tag exist in selected language before save it), Wait for articles update - If you get timeout, refresh page to check, how many articles has been updates with your tag. You can decrease number of articles in bulk action **Always work only with ONE language!**
+==== Dynamic banners on homepage ====
+  - Create a new Škoda banner tag and tick the “Homepage tag” checkbox (or edit an existing tag).{{ :skoda-ep:image-20220124-112931.png |}}
+  - Add this tag to the banners, that you want to show on the homepage.
+  - On homepage, add Skoda Banner Position widget. Select “dynamic banner” in the widget settings.
+    - You can also use shortcode ŠKODA Banner - Dynamic.
+===== Škoda Banners - Special Banners for Homepage and Stories =====
+For special occasions, it is possible to set a dynamic banner for the main page and for stories. If there is an exceptional event or the banner contains dynamic elements (for example, a countdown to an important event), then you can override standard banners using the settings in Škoda Options.
+This menu item is already available for the "editor" level
+{{ :skoda-ep:editor-options2.png?nolink | }}
+==== Settings ====
+Each language version has its own "Skoda Options", so you have to be in the right language section when creating the banner and you don't have to worry about the banner appearing on another importer's page.
+==== Create a dynamic banner ====
+If you need a dynamic banner you must create a page in your selected language.
+{{ :skoda-ep:create-a-banner.png |}}
+Then fill the banner with your own content. You can use Site origin widgets as you see in an example below and publish page as private.
+{{ :skoda-ep:create-a-banner-2.png |}}
+Fill the ID of the page that you have created in the Škoda Options settings.
+{{ :skoda-ep:homepage_options.png |}}
+==== Set testing template ====
+If you want to test your banner properly set the page template for "Banner homepage/stories" template.
+{{ :skoda-ep:banner-page-settings.png |}}
+==== External URL ====
+To add a URL to a rich-text banner, you need to add **Custom fields** on the banner post.
+First allows you to view custom fields on your screen options as you can see in the image below.
+{{:skoda-ep:custom_fields.png|}}
+Now you can set up an external URL:
+  * **external_url** - URL for the banner redirect
+  * **external_url_target** - target attribute of <a> element, accepted values _self or _blank
+{{:skoda-ep:richtext_custom_fields.png|}}