=== Flat Blocks Classic ===
Contributors:  XtremelySocial

== Description ==

Flat Blocks Classic is a Child Theme of Flat Blocks that has a more "classic" WordPress layout with right sidebars. There are Templates included to remove the sidebar on posts and pages, so you can mix and match layouts. It includes abbreviated page excerpts in the Page Titles too as a nice touch.

For more information go to [http://xtremelysocial.com/wordpress/flat-blocks/].

== Installation ==

1. Download and install the parent theme Flat Blocks
2. Download and install this Flat Blocks Classic child theme
3. Activate this child theme through the 'Appearance' menu in WordPress
4. Read the notes below about how to use this child theme

== How to Use This Child Theme ==

This theme is a standard WordPress "child theme" of Flat Blocks. While you could make edits to it, it is strongly recommended that you create a copy of it in a new directory and update the theme name in style.css. 

The easiest way to do that is to use the [Create Block Theme](https://wordpress.org/plugins/create-block-theme/) plugin.

Install the Create Child Theme plugin 
Use the Full Site Editor to adjust any global styles, templates, template parts, etc. to your liking.
Use the Create Child Theme plugin to export a new child theme based on this one.

You can read more information about how to use child themes on WordPress.org [https://codex.wordpress.org/Child_Themes]

= More Information About This Theme = 

For more information, see these pages on the XtremelySocial.com website:
* How to use our Block Themes: https://xtremelysocial.com/userguide/block-themes/
* Our Theme Block Styles: https://xtremelysocial.com/userguide/block-styles/
* Our Theme Block Patterns: https://xtremelysocial.com/userguide/block-patterns/

You can check out our other themes here: https://xtremelysocial.com/wordpress/

== Changelog ==

= 2.1 =
January 18, 2026

* Update the Flat Blocks Classic child theme based on version 2.1 of the parent theme, Flat Blocks. 
* Remove zero top-margin in templates as it isn't needed and was already removed from templates in the parent theme.

Flat Blocks v2.1 Release Notes:
* Updates for WordPress v6.9:
	* Added the new Post Time to Read and Post Comments Link Blocks to the Blog index only for WordPress v6.9+ (or Gutenberg plugin active). You can remove them by editing the Article Content Template Part. Note: We use Post Comments Link instead of Post Comments Count and apply a new custom style is-style-link-inactive to make it appear like normal text. This is done because the Post Comments Count Block only displays the count itself whereas the Post Comments Link Block displays No Comments, 1 Comment, 2 Comments, etc.
	* Added the new Post Time to Read Block to the Post Title (after Post Date and Author). You can remove it by editing the Post Title Template Part.
	* Added clock icon automatically to the new Post Time to Read block. Added custom style option of "No Icon" for users to remove the icon if desired.
	* Styled the new Accordion Block to use the theme's Primary color for the heading and open and close icons.
	* Set the new Math Block to use Medium font size by default. Of course you can change it whatever font size you want in the Global Block Style or the individual Math Block on pages and posts.
* Other Updates
	* Updated the CSS for automatic icons to align more to the center of the text. This is for the Post Date, Post Author, Post Time to Read, Category, and Tag Blocks.
	* Added neutral color background to the Query Pagination block to match the Comments block, Page templates with Sidebar, etc. This required updating theme.json and the various Query Patterns.
	* Set Mobile Nav Menu icon to use the theme style's border radius and box shadow. By default the radius is 5px with no box shadow.
	* Adjusted horizontal position of the Fixed Mobile Nav Only menu to line up just outside the horizontal margins on the page.
	* Updated CSS for the Group Block with colored backgrounds to use the theme's overall left and right margins when they are full width.
	* Removed box-shadow: none from the rounded border styles for Groups, Columns, Code, etc. User can add box-shadow on individual blocks, if desired.
	* Arrow Down Icon paragraph style now inherits the font color from it's parent, such as the Group or Cover blocks.

= 2.0.3 =
April 15, 2025

Update the Flat Blocks Classic child theme based on version 2.0.3 of the parent theme, Flat Blocks. 

Flat Blocks v2.0.3 Release Notes:
* Enhanced CSS for font color on input fields when used within a section (Group, Column) with a dark background. Removed the custom variables --wp--custom--color--field--background and --wp--custom--color--field--text from the main theme.json since they aren't needed anymore. They can still be used in custom Global Styles or Child Themes though.
* Added CSS to reduce the height of the Search input and button when used in a Navigation menu so it looks better alongside the other menu items.
* Enhanced CSS for automatic vertical margins on blocks to allow the user to set top margin to zero on the first block and/or bottom margin on the last block. For example, if you want the last block on a page to not have margin after it before the footer.
* Enhanced CSS to remove top margin on Comments block if it is completely empty (no comments or comment form).
* Enhanced CSS to get a little more aggressive in applying default text color on colored backgrounds.
* Enhanced CSS for vertical margins on Social Icons blocks.
* Set Comment Form labels to normal font weight (by removing medium weight in the CSS).
* Updated readme.txt section on creating child themes based on simplifications made in Flat Blocks v2.0.
* Updated CSS source (.scss) files to get media query breakpoints (e.g. '@media only AND (max-width: 600px)') from the core WordPress scripts (@wordpress/base-styles/breakpoints).

= 2.0.2 = 
February 5, 2025

Update the Flat Blocks Classic child theme based on version 2.0.2 of the parent theme, Flat Blocks. 

Flat Blocks v2.0.2 Release Notes:
* Template Parts:
	* Added new ones for Search Title, 404 (Error Page) Title, and Archive (Blog) Title. These can be found under the "Title" category in the Block Patterns in the Editor along with the Page Title and Post Title Template Parts. 
	* On the Page Title, set the Excerpt length to 20 words (was 30).
	* Updated the various Templates to use the new title Template Parts.
* Enhanced CSS:
	* Add bottom margin on the last element in the Post Content (unless the user overrides it on the block).
	* Inherit text alignment on Dashicons.
	* Fix link hover color in the Editor (issue is with WordPress v6.7).

= 2.0 = 
January 2, 2025

Update the Flat Blocks Classic child theme based on version 2.0 of the parent theme, Flat Blocks.

Flat Blocks Version 2.0 Summary: Updated minimum WordPress version required to 6.7 which coupled with simplifying CSS throughout significantly reduced the amount of CSS needed by over 25%. The theme now only loads the CSS styles needed for each page and instructs WordPress to also do this, which further reduces the amount of CSS for most pages. Added 5 new gradients based on the recent duotones that were added. Changed Larger and Extra Large font slugs to match the TwentyTwentyFive theme.

Changes to look out for and update your content if necessary:
* Change "Extra Large" font size to use "2X Large" and "Larger" font size to use "Extra Large".
* Check top margins on pages and posts with sidebars, both with and without featured images. If there is extra top margin, you can remove it from the sidebar and/or featured image. 
* Check footers with copyright date and/or theme info that might be using Block Bindings. Use the more recent Template Parts (Site Copyright, Theme Tagline).
* If you are still using the really old "Background" and "Foreground" colors, change them to "Base" and "Contrast" colors instead.
* If coming over to Flat Blocks from another theme, change out the background and text colors. Unknown background colors are mapped to the Primary color (light green by default) and the text color to Foreground Alt (offwhite by default).

More Details:
* Updated minimum WordPress version required to 6.7 and dropped all the code needed to support back to Wordpress v6.5.
* CSS Enhancements and Optimization:
	* Simplified the CSS for default text and link colors on colored backgrounds as well as for Navigation highlights which reduced CSS by over 25%.
	* Now Dashicons CSS only loads if in use on a particular page, further reducing CSS on most pages. Also enhanced it to work better with optimization plugins that concatenate CSS, such as Jetpack Boost.
	* The theme now instructs WordPress to only load the CSS styles needed for each page (which is the default in WordPress v6.7). The theme itself now also does this which lets core WordPress optimize whether styles are loaded inline or in separate CSS file(s).
	* Rewrote the CSS for top margin on blocks to be consistent with WordPress vertical spacing as well as no longer require certain Template Parts and Templates to add top-margin.
	* Enhanced the CSS for horizontal padding on tablet and mobile so that groups and columns with colored backgrounds line up better with the site's global padding. 
	* Enhanced the CSS for default text color on Cover Images.
	* Added clear floats automatically to Groups which have align left and align right in them. This is only done on normal (non-flex) Groups, not on Rows (flex).
	* For users migrating from other themes, we now map unknown background colors to mapped to the Primary color (Light Green by default) and the text color to Foreground Alt (Off White by default).
	* Added legacy support for Flat Blocks versions 1.9x, specifically for deprecated font sizes, top margins, and the scroll down arrow. Removed legacy support for older theme versions, such as the use of "foreground" and "background" color names (use contrast and base now).
* Changed icons that the theme uses directly to SVG instead of Dashicons, such as post date, author name, scroll down arrow, etc. So Dashicons CSS styles will only load when used in your content itself.
* Changed the "Larger" font size (larger) to "Extra Large" (x-large) and "Extra Large" (x-large) to "2X Large" (xx-large) for compatibility with the TwentyTwentyFive theme. Added CSS for backwards compatibility, but you should update the font sizes in your content at some point.
* Added more gradient options to match the duotones added in Flat Blocks v1.9: Purple to Yellow, Purple to Green, Blue to Red, Blue to Orange, and Midnight (Midnight Blue to Blue).
* Added Block Pattern for Cover Camera. 
* Added WEBP versions of all cover images. The JPEG versions are still used in the various Block Patterns, but if your web server supports WEBP then you can upload them to your Media Library and use them instead. WEBP is a more optimized image format specifically for use on the web. 
* Removed Block Bindings for site copyright year and theme info. Template Parts with Block Patterns are now used instead. 
* Rewrote the main functions.php to radically simplify it as well. It now uses an array to load other PHP include files as well as an array for which CSS stylesheets to load. Code needed for older WordPress versions was removed. 
* For developers: Updated webpack.config.js to add postcss-loader to use autoprefixer to add browser prefixes automatically (e.g. -webkit-mask-image). Removed our vendor-prefixes mixin as it is no longer needed. 

= 1.3.3 = 
December 7, 2024

* Update Sidebar to add top margin now that the parent Flat Blocks theme requires it. If you have edited the sidebar, you should add top margin to it. For now, we've added CSS to handle it. 
* Since the "No Sidebar" page and post Templates from this theme were added to the parent Flat Blocks theme, they aren't needed here anymore.
* Added the Footer w/Motto and Social Icons from the parent theme to this child theme. 
* Added in the PHP-based Block Patterns from the parent theme since the WordPress.org theme preview isn't loading them for some reason. 

= 1.3.2 = 
December 2, 2024

* More updates to Site Copyright and Theme Tagline Block Patterns used in various Footers. These are now driven by Block Bindings added to the parent Flat Blocks theme v1.9.4.
* Set light default link and button color on Midnight Blue and Dark Midnight Blue backgrounds to match recent change to the Flat Blocks parent theme. This is more consistent with the handling of other dark accent colors.

= 1.3.1 = 
December 1, 2024

* Update Site Copyright and Theme Tagline used in various headers to display properly when previewing the theme on WordPress.org. For some reason, parent theme Block Patterns written in PHP aren't being loaded in child themes in the previews.
* Let Paragraph top and bottom margin default based on the font size (i.e. "1 em").

= 1.3 = 
November 26, 2024

* Incorporated changes from the Flat Blocks parent theme in the Styles Editor (theme.json) and various Template Parts, Templates, and Block Patterns.
* Changed default Site Contents section in the Sidebar to use a Pages List so it lists all the pages on your site.

= 1.2 = 
September 3, 2024

* Incorporated changes from the Flat Blocks parent theme, such as new Highlight and Highlight Alt colors (for links and buttons), adjusted drop-shadow presets, default font and link colors in colored sections, whether or not links are underlined by default in various colored sections, and various other theme.json settings.
* Added names to all Header, Footer, Sidebar, Post Meta, and Main content groups to differentiate them from other groups in the Templates while viewing in the Editor.

= 1.1.1 =
July 27, 2024

* Quick fix for theme preview on WordPress.org because it isn't using the parent theme's settings in theme.json, so we have to include the full set of settings from the parent too.

= 1.1 =
July 27, 2024

* Breaking change: Changed Background and Foreground colors to Base and Contrast respectively to match the default WordPress TwentyTwentyFour theme. CSS was added for backward-compatibility to this theme's parent, Flat Blocks.
* Updated theme.json to version 3 which allows the new WordPress v6.6 features, such as Block Style Variations. See https://make.wordpress.org/core/2024/06/19/theme-json-version-3/
* Simplified theme.json to include ONLY the settings that override the parent theme (Flat Blocks). That includes Typography (font) settings and Custom Templates since this theme's default templates have sidebars, so there are "no sidebar" versions in this theme.

= 1.0.5 = 
February 13, 2024

* Changed Content Page Home Template Part cover image to be an antique typewriter to better reflect the "classic" nature of this theme. Note this requires Flat Blocks parent theme version 1.4.6 or higher.
* In conjunction with above, changed the heading font to Source Serif Pro and the body font to Source Sans Pro. The serif font for the headings is more in line with the antique typewriter and "classic" nature of this theme.
* Set footers to not underline theme link now that the Flat Blocks parent theme defaults to underlining most links.

= 1.0.4 = 
September 21, 2023

* Include full theme.json from parent Flat Blocks theme because WordPress.org theme directory isn't properly combining these theme's json with the parent theme. Note that this shouldn't be needed and if you are making your own child theme you should only need the CustomTemplates section from theme.json.

= 1.0.3 = 
September 16, 2023

* Update screenshot to pass WordPress.org Theme review guidelines.

= 1.0.2 = 
September 10, 2023

* Added "Page Featured Image with Left Sidebar" and "Page Featured Image with Right Sidebar" templates from the Flat Blocks parent theme.

= 1.0.1 = 
September 6, 2023

Initial theme version

== Copyright ==

Flat Blocks Classic WordPress Theme, (C) 2023 Tim Nicholson / XtremelySocial
Flat Blocks Classic is distributed under the terms of the GNU GPL.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

See the Flat Blocks parent theme for a list of third-party resources used by that theme.
