- Updating Hilda and Gwyneth docs

- Fixing information

Author: webmandesign

0app/includes/_vars.pug

@@ -86,7 +86,7 @@ else
 		}
 
 if config.imageNote && 'core' === config.imageNote
-	- config.imageNote = '<svg class="svg-icon" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 256 256"><path fill="currentColor" d="M128 24a104 104 0 1 0 104 104A104.11 104.11 0 0 0 128 24m0 192a88 88 0 1 1 88-88a88.1 88.1 0 0 1-88 88m16-40a8 8 0 0 1-8 8a16 16 0 0 1-16-16v-40a8 8 0 0 1 0-16a16 16 0 0 1 16 16v40a8 8 0 0 1 8 8m-32-92a12 12 0 1 1 12 12a12 12 0 0 1-12-12"/></svg> Illustration image. May not display this actual theme.';
+	- config.imageNote = '<svg class="svg-icon" aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 256 256"><path fill="currentColor" d="M128 24a104 104 0 1 0 104 104A104.11 104.11 0 0 0 128 24m0 192a88 88 0 1 1 88-88a88.1 88.1 0 0 1-88 88m16-40a8 8 0 0 1-8 8a16 16 0 0 1-16-16v-40a8 8 0 0 1 0-16a16 16 0 0 1 16 16v40a8 8 0 0 1 8 8m-32-92a12 12 0 1 1 12 12a12 12 0 0 1-12-12"/></svg> Illustrative image. May not display this actual theme.';
 
 -
 	var image_notes = {

angelica/index.html

@@ -35,9 +35,17 @@ block prepend customizer/fse/theme-options
 block append site-editor/styles/colors/bottom
 	include colors.pug
 
+block append plugins/recommended/woocommerce
+	include plugin-wc.pug
+
 block faq/answer/page-builder
 	include faq-answer-page-builder.pug
-block prepend faq/questions/list
+block append faq/questions/list
 	include faq-question-space.pug
-block prepend faq/answers/list
+	include faq-question-wc-cart-checkout.pug
+block append faq/answers/list
 	include faq-answer-space.pug
+	include faq-answer-wc-cart-checkout.pug
+
+block append sidebars/fse/display
+	include sidebar-block.pug

auberge/index.html

@@ -2,6 +2,6 @@ p <strong>#{config.name}</strong> theme automatically recognizes 2 of the most p
 
 p If you need to tweak a layout for using a page builder plugin, do so in theme options in #[+mark( 'nav', 'Appearance', 'Customize', 'Theme Options', 'Page builders' )].
 
-+tip( 'Page builder with block theme' )
-	p If you really need to use a page builder plugin even if full site editing is enabled, and you experience a layout issues, you can <a href="#site-editor-templates">create a custom "Page builder" template</a> to use whenever you need to build a page/post content with your page builder plugin.
++tip( 'Page builder with block theme', 'h4' )
+	p If you really need to use a page builder plugin even if full site editing is enabled, and you experience some layout issues, you can <a href="#site-editor-templates">create a custom "Page builder" template</a> to use whenever you need to build a page/post content with your page builder plugin.
 

bjork/index.html

@@ -1,14 +1,14 @@
 li
-	+answer( '"Content padding" block spacing value', 'content-padding' )
+	+answer( 'Block spacing "Content padding" value', 'content-padding' )
 
 		p <strong>#{config.name}</strong> theme provides multiple responsive spacing options for blocks (for margin and padding, for example).
 
 		p Among these there is a special option of <em>"<strong>Content padding</strong>"</em> added for setting up intelligent spacing on <a href="https://wordpress.org/documentation/article/post-content-block/">Content block</a> (when <a href="#site-editor-templates">editing templates</a>).
 
-		p Once this spacing value is applied as <em>top padding</em> on the Content block, the <em><strong>first</strong> block in page/post content that is also <strong>fully aligned</strong></em> will mitigate for this content spacing and stick to upper edge of the page/post content, effectively removing the spacing automatically. <br>If the block is not fully aligned, the spacing (content padding) is still present.
+		p Once this spacing value is applied as a <em>top padding</em> on the Content block, the <em><strong>first</strong> block in the page/post content that is also a <strong>fully aligned</strong></em> block will mitigate for this content spacing and sticks to the upper edge of the page/post content, effectively removing the spacing automatically. <br>If the block is not fully aligned, the spacing (content padding) is still present.
 
-		+image( 'faq-spacing.jpg', 'Automatic mitigation for "Content padding" spacing option' )
+		+image( 'faq-spacing.jpg', 'Example of automatic mitigation for "Content padding" spacing option' )
 
-		p The opposite applies for bottom padding and the last block in page/post content (in Content block).
+		p The opposite applies for bottom padding and the last block in the page/post content (in Content block).
 
-		p Feel free to use this <em>"<strong>Content padding</strong>"</em> spacing value everywhere it fits your needs. For example, it can be used for keeping vertical spacing between sections consistent in your page/post content.
+		p Feel free to use this <em>"<strong>Content padding</strong>"</em> spacing value everywhere it fits your needs. For example, it can be used for keeping vertical spacing between sections consistent in your page/post content. The default height of the <a href="https://wordpress.org/documentation/article/spacer-block/">"<strong>Spacer</strong>" block</a> is also set to <em>"<strong>Content padding</strong>"</em> value.

cindy/index.html

@@ -0,0 +1,18 @@
+li
+	+answer( '<strong>WooCommerce</strong>: Cart & Checkout page', 'wc-cart-checkout' )
+
+		+warning( 'Duplicate cart/checkout form', 'h4' )
+			p WooCommerce adds default content to Cart and Checkout page after plugin installation. The actual content depends on whether the theme is a block theme (full site editing theme) or a <a href="#disable-fse">classic theme</a>.
+			p This may cause an issue of rendering 2 different cart/checkout forms on such pages. <strong>Read below for the solution:</strong>
+
+		p As WooCommerce adds default content to Cart and Checkout page after plugin installation, this may produce displaying of 2 different cart/checkout forms on those pages. (Check the pages on your website front-end after WooCommerce plugin installation.)
+
+		p To resolve this issue and provide only one cart/checkout form:
+
+		ol.is-steps
+			li Open "Cart" page for editing and remove its content. (Or you can set custom content using blocks instead. You can also <a href="#posts-excerpt">set page excerpt</a>.)
+			li Do the same for "Checkout" page.
+			li Check those pages on your website front-end now.
+
+		+tip( 'Alternative: Edit templates', 'h4' )
+			p You can directly edit "Cart" and "Checkout" <a href="#site-editor-templates">templates in Site Editor</a> to your needs, which provides more advanced and thorough control over those layouts.

deborah/index.html

@@ -1,2 +1,2 @@
 li
-	a( href="#content-padding" ) "<strong>Content padding</strong>" block spacing value
+	a( href="#content-padding" ) Block spacing "<strong>Content padding</strong>" value

eimear/index.html

@@ -0,0 +1,2 @@
+li
+	a( href="#wc-cart-checkout" ) <strong>WooCommerce</strong>: Cart & Checkout page

forstron/index.html

@@ -0,0 +1,2 @@
++important( 'Setup', 'h5' )
+	p Please check FAQ section for how to <a href="#wc-cart-checkout">set up WooCommerce</a> with the theme.

francesca/index.html

@@ -0,0 +1,2 @@
++tip( 'Sidebar Block' )
+	p If you want to display classic widgets in the sidebar, try <a href="https://wordpress.org/plugins/sidebar-block/"><strong>Sidebar Block</strong> plugin</a>.

gwyneth/includes/_custom-content.pug

@@ -38,9 +38,21 @@ block prepend customizer/fse/theme-options
 block append site-editor/styles/colors/bottom
 	include colors.pug
 
+block append plugins/recommended/woocommerce
+	include plugin-wc.pug
+
 block faq/answer/page-builder
 	include faq-answer-page-builder.pug
-block prepend faq/questions/list
+block append faq/questions/list
+	include faq-question-sticky-header.pug
+	include faq-question-progress-bar.pug
 	include faq-question-space.pug
-block prepend faq/answers/list
+	include faq-question-wc-cart-checkout.pug
+block append faq/answers/list
+	include faq-answer-sticky-header.pug
+	include faq-answer-progress-bar.pug
 	include faq-answer-space.pug
+	include faq-answer-wc-cart-checkout.pug
+
+block append sidebars/fse/display
+	include sidebar-block.pug

gwyneth/includes/faq-answer-page-builder.pug

@@ -2,6 +2,6 @@ p <strong>#{config.name}</strong> theme automatically recognizes 2 of the most p
 
 p If you need to tweak a layout for using a page builder plugin, do so in theme options in #[+mark( 'nav', 'Appearance', 'Customize', 'Theme Options', 'Page builders' )].
 
-+tip( 'Page builder with block theme' )
++tip( 'Page builder with block theme', 'h4' )
 	p If you really need to use a page builder plugin even if full site editing is enabled, and you experience some layout issues, you can <a href="#site-editor-templates">create a custom "Page builder" template</a> to use whenever you need to build a page/post content with your page builder plugin.
 

gwyneth/includes/faq-answer-space.pug

@@ -0,0 +1,19 @@
+li
+	+answer( 'How to set progress bar value (width)', 'progress-bar' )
+
+		p "Progress bar" <a href="#block-patterns">block pattern</a> consists of multiple nested blocks and it may be difficult to find out how to change the value and width of the progress bar. Here are instructions to do so:
+
+		p
+			small
+				em (The images below are only illustrative and may not represent the actual "Progress bar" pattern design supplied with the theme.)
+
+		ol.is-steps
+			li
+				p Insert "Progress bar" block pattern into page/post content.
+				+image( 'progress-bar-1.jpg', 'Insert "Progress bar" block pattern' )
+
+			li Click on the text value of the progress bar (<a href="https://wordpress.org/documentation/article/paragraph-block/">Paragraph block</a> with <code>65%</code> text by default) and change the number to desired value.
+
+			li
+				p Then select the parent <a href="https://wordpress.org/documentation/article/row-block/">Row block</a> and in block options change the width to your desired value.
+				+image( 'progress-bar-2.jpg', 'Setting up progress bar width' )

gwyneth/includes/faq-answer-wc-cart-checkout.pug

@@ -1,11 +1,15 @@
 li
-	+answer( '"Content padding" block spacing value', 'content-padding' )
+	+answer( 'Block spacing "Content padding" value', 'content-padding' )
 
 		p <strong>#{config.name}</strong> theme provides multiple responsive spacing options for blocks (for margin and padding, for example).
 
 		p Among these there is a special option of <em>"<strong>Content padding</strong>"</em> added for setting up intelligent spacing on <a href="https://wordpress.org/documentation/article/post-content-block/">Content block</a> (when <a href="#site-editor-templates">editing templates</a>).
 
-		p Once this spacing value is applied as a <em>top padding</em> on the Content block, the <em><strong>first</strong> block in the page/post content that is also a <strong>fully aligned</strong></em> block will mitigate for this content spacing and stick to the upper edge of the page/post content, effectively removing the spacing automatically. <br>If the block is not fully aligned, the spacing (content padding) is still present.
+		p Once this spacing value is applied as a <em>top padding</em> on the Content block, the <em><strong>first</strong> block in the page/post content that is also a <strong>fully aligned</strong></em> block will mitigate for this content spacing and sticks to the upper edge of the page/post content, effectively removing the spacing automatically. <br>If the block is not fully aligned, the spacing (content padding) is still present.
+
+		p
+			small
+				em (The image below is only illustrative and may not represent the actual theme.)
 
 		+image( 'faq-spacing.jpg', 'Example of automatic mitigation for "Content padding" spacing option' )
 

gwyneth/includes/faq-question-space.pug

@@ -0,0 +1,19 @@
+li
+	+answer( 'How to set sticky header', 'sticky-header' )
+		p If you need to display the site header on top of the browser window (viewport) even when user scrolls the page, try one of these options:
+
+
+		h4 Use a plugin
+
+		p Use a plugin to set sticky position on elements, such as <a href="https://wordpress.org/plugins/sticky-menu-or-anything-on-scroll/"><strong>Sticky Menu & Sticky Header</strong> plugin</a>. This option can be very flexible approach providing conditional control over header sticky positioning (depending on the plugin capabilities).
+
+		+tip( 'Set up the plugin', 'h5' )
+			p For setting up sticky header using a plugin use <code>#masthead</code> in plugin options as (theme default) site header selector.
+			p Alternatively use <a href="https://support.webmandesign.eu/using-browser-code-inspector/">browser code inspector</a> to determine the selector for your desired sticky element. Or check your plugin documentation for tips.
+
+
+		h4 Use custom CSS code
+
+		p You can even set the sticky positioning using a <a href="#css">custom CSS code</a>, such as:
+
+		+code #masthead {<br>	position: sticky;<br>	top: var(--wp-admin--admin-bar--height, 0);<br>}

gwyneth/includes/faq-question-wc-cart-checkout.pug

@@ -0,0 +1,18 @@
+li
+	+answer( '<strong>WooCommerce</strong>: Cart & Checkout page', 'wc-cart-checkout' )
+
+		+warning( 'Duplicate cart/checkout form', 'h4' )
+			p WooCommerce adds default content to Cart and Checkout page after plugin installation. The actual content depends on whether the theme is a block theme (full site editing theme) or a <a href="#disable-fse">classic theme</a>.
+			p This may cause an issue of rendering 2 different cart/checkout forms on such pages. <strong>Read below for the solution:</strong>
+
+		p As WooCommerce adds default content to Cart and Checkout page after plugin installation, this may produce displaying of 2 different cart/checkout forms on those pages. (Check the pages on your website front-end after WooCommerce plugin installation.)
+
+		p To resolve this issue and provide only one cart/checkout form:
+
+		ol.is-steps
+			li Open "Cart" page for editing and remove its content. (Or you can set custom content using blocks instead. You can also <a href="#posts-excerpt">set page excerpt</a>.)
+			li Do the same for "Checkout" page.
+			li Check those pages on your website front-end now.
+
+		+tip( 'Alternative: Edit templates', 'h4' )
+			p You can directly edit "Cart" and "Checkout" <a href="#site-editor-templates">templates in Site Editor</a> to your needs, which provides more advanced and thorough control over those layouts.

gwyneth/includes/plugin-wc.pug

@@ -0,0 +1,2 @@
+li
+	a( href="#progress-bar" ) How to set <strong>progress bar</strong> value (width)

gwyneth/includes/sidebar-block.pug

@@ -1,2 +1,2 @@
 li
-	a( href="#content-padding" ) "<strong>Content padding</strong>" block spacing value
+	a( href="#content-padding" ) Block spacing "<strong>Content padding</strong>" value

gwyneth/index.html

@@ -0,0 +1,2 @@
+li
+	a( href="#sticky-header" ) How to set <strong>sticky header</strong>

hilda/assets/images/faq-spacing.jpg

@@ -0,0 +1,2 @@
+li
+	a( href="#wc-cart-checkout" ) <strong>WooCommerce</strong>: Cart & Checkout page

hilda/assets/images/progress-bar-1.jpg

@@ -0,0 +1,2 @@
++important( 'Setup', 'h5' )
+	p Please check FAQ section for how to <a href="#wc-cart-checkout">set up WooCommerce</a> with the theme.

hilda/assets/images/progress-bar-2.jpg

@@ -0,0 +1,2 @@
++tip( 'Sidebar Block' )
+	p If you want to display classic widgets in the sidebar, try <a href="https://wordpress.org/plugins/sidebar-block/"><strong>Sidebar Block</strong> plugin</a>.

hilda/includes/_custom-content.pug

@@ -15,10 +15,10 @@ li
 
 		h4 Use a plugin
 
-		p Use a plugin to set sticky position on elements, such as <a href="https://wordpress.org/plugins/sticky-menu-or-anything-on-scroll/"><strong>Sticky Menu & Sticky Header</strong> plugin</a>. This option is more flexible approach with less work and provides more control over header sticky positioning.
+		p Use a plugin to set sticky position on elements, such as <a href="https://wordpress.org/plugins/sticky-menu-or-anything-on-scroll/"><strong>Sticky Menu & Sticky Header</strong> plugin</a>. This option can be very flexible approach providing conditional control over header sticky positioning (depending on the plugin capabilities).
 
 		+tip( 'Set up the plugin', 'h5' )
-			p For setting up sticky header using a plugin use <code>#masthead</code> in plugin options as (default) site header selector.
+			p For setting up sticky header using a plugin use <code>#masthead</code> in plugin options as (theme default) site header selector.
 			p Alternatively use <a href="https://support.webmandesign.eu/using-browser-code-inspector/">browser code inspector</a> to determine the selector for your desired sticky element. Or check your plugin documentation for tips.
 
 

hilda/includes/faq-answer-page-builder.pug

@@ -2,12 +2,12 @@ li
 	+answer( '<strong>WooCommerce</strong>: Cart & Checkout page', 'wc-cart-checkout' )
 
 		+warning( 'Duplicate cart/checkout form', 'h4' )
-			p WooCommerce adds default content to Cart and Checkout page after plugin installation. The actual content depends on whether the theme is a block theme (full site editing theme) or a <a href="##disable-fse">classic theme</a>.
-			p This may cause an issue of rendering 2 different cart/checkout forms on such pages. <strong>Read below for solution:</strong>
+			p WooCommerce adds default content to Cart and Checkout page after plugin installation. The actual content depends on whether the theme is a block theme (full site editing theme) or a <a href="#disable-fse">classic theme</a>.
+			p This may cause an issue of rendering 2 different cart/checkout forms on such pages. <strong>Read below for the solution:</strong>
 
 		p For improved flexibility, this theme sets Cart and Checkout page default templates to also display the page excerpt and content. Excerpt is displayed before, and content after the page cart/checkout default form.
 
-		p As WooCommerce adds default content to Cart and Checkout page after plugin installation, this may produce displaying of 2 different cart/checkout forms on those pages. (Check your pages on your website front-end after WooCommerce plugin installation.)
+		p As WooCommerce adds default content to Cart and Checkout page after plugin installation, this may produce displaying of 2 different cart/checkout forms on those pages. (Check the pages on your website front-end after WooCommerce plugin installation.)
 
 		p To resolve this issue and provide only one cart/checkout form:
 

hilda/includes/faq-answer-progress-bar.pug

@@ -1,2 +1,2 @@
 +important( 'Setup', 'h5' )
-	p Please check FAQ section for how to <a href="#wc-cart-checkout">set up WooCommerce</a> with Ileana theme.
+	p Please check FAQ section for how to <a href="#wc-cart-checkout">set up WooCommerce</a> with the theme.