=== Caledros Basic Blocks ===

Contributors: @darnado
Tags: gutenberg, block editor, custom blocks
Requires at least: 6.7
Tested up to: 6.9
Stable tag: 3.1.1
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html

Introduces 18 lightweight blocks for the Gutenberg editor. Also includes an optional preloader for CSS stylesheets to enhance performance.

== Description ==

Supercharge your WordPress site with Caledros Basic Blocks – a collection of 18 lightweight, performance-optimized Gutenberg blocks designed to extend the capabilities of the WordPress block editor without slowing down your site. 

Unlike many block libraries that add unnecessary bloat, Caledros Basic Blocks focuses on efficiency and speed. Each block is crafted to deliver essential functionality while keeping your site lean. 

The plugin includes a built-in CSS stylesheet preloader, ensuring faster page load times by optimizing the delivery of block styles. This feature can be easily disabled if preferred, giving you full control over performance tuning.

## Features

* Adds 18 new custom Gutenberg blocks, and 2 new variation blocks. 4 blocks and 1 variation block are only available for header template parts. 1 block (Content Renderer) is limited to templates. 
* Flex and grid containers blocks included
* Dark/Light mode block included
* Blocks built with performance and minimalism in mind
* Includes a toggleable preloader for CSS stylesheets to improve loading speed
* Includes toggleable controls for adding/removing pre-defined CSS styles to the "wp-site-blocks" container.
* Enable featured images for post categories
* Clean, modern design for seamless visual integration
* Fully responsive and compatible with Full Site Editing Themes

Perfect for developers, designers, and content creators who want more control and better performance without the overhead of large block libraries.

## More Projects & Information

For more information about my projects, you can visit my website: [caledrosforge.com](https://caledrosforge.com/)

## Third Party Resources

Caledros Basic Blocks bundles the following third-party resources:

### 1. Icons

**1.1. Bootstrap Icons**, *Copyright (c) 2019-2024 The Bootstrap Authors*

The icons (SVG files) used in the Icon block, Social Icon block, and the Button Block were downloaded from Bootstrap Icons. 

Additionally, the four icons used in the Posts Loop block (user, date, category, and tag) as well as the publications icon in the Category Loop block, were all sourced from Bootstrap Icons.

Bootstrap Icons are licensed under the **MIT License**.

**Source:** [Bootstrap Icons Github repository](https://github.com/twbs/icons) and [Bootstrap Icons website](https://icons.getbootstrap.com/)

**License information last verified on:** May 21st, 2025

## 2. Libraries

**2.1. Swiper JS**, *Copyright (c) 2019 Vladimir Kharlampidi*

Both the Slider block and the Image Gallery block use the Swiper JS library, which is licensed under the **MIT License**.

**Source:** [Swiper JS Github repository](https://github.com/nolimits4web/swiper) and [Swiper JS website](https://swiperjs.com/)

**License information last verified on:** May 14th, 2025

## 3. Images

**3.1. Placeholder Mountains** *(placeholder-mountains.webp, placeholder-mountains.7da2eb2d.webp)*

Used in the Category Loop and Posts Loop blocks. 

[CC0](https://creativecommons.org/publicdomain/zero/1.0/) licensed [photo](https://wordpress.org/photos/photo/85161bd2cb/) by [Marcus Kazmierczak](https://wordpress.org/photos/author/mkaz/) from the [WordPress Photo Directory](https://wordpress.org/photos/)

**Source:** [Wordpress Photo Directory](https://wordpress.org/photos/photo/85161bd2cb/)

**License information last verified on:** September 7th, 2025

**3.2. Bird** *(bird.webp, bird.8dbbb5a8.webp)*

Used in the Image Gallery block. 

[CC0](https://creativecommons.org/publicdomain/zero/1.0/) licensed [photo](https://wordpress.org/photos/photo/715678e819/) by [Nilesh Shiragave](https://wordpress.org/photos/author/snilesh/) from the [WordPress Photo Directory](https://wordpress.org/photos/)

**Source:** [Wordpress Photo Directory](https://wordpress.org/photos/photo/715678e819/)

**License information last verified on:** September 7th, 2025

**3.3. Flower** *(flower.webp, flower.1092b3c8.webp)*

Used in the Image Gallery block. 

[CC0](https://creativecommons.org/publicdomain/zero/1.0/) licensed [photo](https://wordpress.org/photos/photo/763688069f/) by [Chura Bhandari](https://wordpress.org/photos/author/churaclicks/) from the [WordPress Photo Directory](https://wordpress.org/photos/)

**Source:** [Wordpress Photo Directory](https://wordpress.org/photos/photo/763688069f/)

**License information last verified on:** September 7th, 2025

**3.4. Mountains** *(mountains.webp, mountains.2b50cd4a.webp)*

Used in the Image Gallery block. 

[CC0](https://creativecommons.org/publicdomain/zero/1.0/) licensed [photo](https://wordpress.org/photos/photo/62068b050a/) by [ABISHKAAR CHETTRI](https://wordpress.org/photos/author/abishkaarchettri/) from the [WordPress Photo Directory](https://wordpress.org/photos/)

**Source:** [Wordpress Photo Directory](https://wordpress.org/photos/photo/62068b050a/)

**License information last verified on:** September 7th, 2025

== Frequently Asked Questions ==

= What is Caledros Basic Blocks =
Caledros Basic Blocks is a lightweight WordPress plugin that adds 18 custom Gutenberg blocks to enhance your content creation experience 
while keeping your website fast and optimized.

= What makes this plugin performance-friendly? =
Caledros Basic Blocks is developed using the official @wordpress/scripts toolkit, which ensures clean, modern, and optimized code for Gutenberg blocks. 

Some blocks also leverage the WordPress Interactivity API to deliver smooth, responsive user interactions without adding unnecessary overhead.

Additionally, the plugin features a built-in CSS preloader that efficiently loads stylesheets to reduce render-blocking and improve page load times. 

This careful focus on best practices and minimal dependencies helps keep your site lightweight and fast.

= Can I disable the CSS preloader? =
Yes, the CSS preloader feature is optional and can be easily deactivated in the plugin settings if you prefer to manage styles differently.

= Are the blocks compatible with all themes? = 
The blocks are designed to work seamlessly with any modern, well-coded WordPress theme as long as the Gutenberg editor is enabled on your site. 

Since Caledros Basic Blocks extends the Gutenberg block editor, it requires the block editor to be active to function properly.

= Do I need to know how to code to use these blocks? =
Not at all! All blocks are fully integrated into the Gutenberg editor and can be used visually with no coding required.

= Will this plugin slow down my site? =
No. Caledros Basic Blocks is specifically built to enhance performance, not hinder it. The plugin is lightweight and optimized for speed.

However, other third party plugins can slow down your website if they are used together with Caledros Basic Blocks.

== Screenshots ==

1. CSS Preloader toggle. Optimize loading performance with a single click.
2. Customize your categories with featured images and alt texts. Enhance accessibility and design.
3. Add a toggle for Dark and Light mode. Give visitors control over their viewing experience.
4. Editor-only preview sidebar. Toggle between Dark and Light mode to see how your content adapts.
5. Flexible Grid Container block. Arrange content in responsive columns and rows with ease.

== Changelog ==

This changelog format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Also, this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

= 3.1.1 - 2025-12-05 =

**Changed**

* "Tested up to" information. The plugin has been successfully tested with WordPress 6.9.

**Fixed**

* Several errors highlighted by the latest version of the Plugin Check testing tool. 
* Browser console warnings about missing prop for a Select Control in the Button block.
* Image Gallery block's loop setting. Loop functionality is now limited to coverflow image galleries with more than 2 images. This change complies with Swiper JS behavior.

= 3.1.0 - 2025-10-16 =

**Added**

* New "Filter by Author" control to the Posts Loop block.
* New option to the "Page Type" control in the Posts Loop block. This option is "Author template", and it allows to use this block on the default WordPress Author Template. Thus, this option enables the Posts Loop block to automatically retrieve posts from an especific author using the WordPress Query class.
* New option to the "Author options" control in the Posts Loop block. This option is named "Enable author's page link". It allows to turn the author's name into a link to the author's page.

**Changed**

* @wordpress/scripts version. This package has been updated to version 30.25.0. The previous version was 30.14.0.
* Category filter behavior in the Posts Loop block. When the filter is disabled, the block displays all the categories of each post.
* Tag filter behavior in the Posts Loop block. When the filter is disabled, the block displays all the tags of each post.

**Fixed**

* Bug in the Posts Loop block. This block displayed content when the category, tag, or author filters were enabled, but no specific filter was selected.
* Bug when the WordPress debug mode was enabled. A notice was displayed in the pagination section of the Posts Loop block. This notice was visible when the number of items per page exceeded the number of items returned by the WordPress loop. 

= 3.0.0 - 2025-09-07 =

**Added**

* New icon (Telephone) to the Icon block and the Button with Icon block variation. This icon, like the initial set, is sourced from Bootstrap Icons and is used under the MIT license.
* New control to the Button with Icon block variation. This new control (Content gap) allows changing the space between the button's icon and text.
* New blur control to the Desktop Menu Container and Mobile Menu Container blocks. This new control is located under the "Style" tab.
* Previews for the following blocks: Button, Button with Icon (block variation), Category Loop, Dark/Light Mode Switcher, Desktop Menu Container, Flex Container, Grid Container, Icon, Image Gallery, Menu Link, Mobile Menu Container, Posts Loop, Search Form, Sidebar Menu, and Social Icons Group.

**Changed**

* Description for the Flex Container block.
* Changelog format. Now its format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
* Demo images for the demo data of the following blocks: Posts Loop, Category Loop, and Image Gallery.

**Removed**

* The Mega Menu variation block has been removed from the block inserter in posts, pages, templates, and non-header template parts. It is now only available for header template parts. 
* Four blocks have been removed from the block inserter in posts, pages, templates, and non-header template parts. They are now limited to header template parts. These blocks are the following: Dark/Light Mode Switcher, Desktop Menu Container, Mobile Menu Container, and Sidebar Menu.

**Fixed**

* Icons in the Icon block and Social Icon block not displaying correctly. New CSS rules have been applied.
* The Content Renderer block incorrectly appearing in the block inserter for posts, pages, and template parts in the Site Editor. It is now only available for templates.

= 2.2.1 - 2025-08-10 =

**Fixed**

* A bug affecting Flex Container blocks located inside the Slider block. The issue caused the Flex Container blocks to display the same background image as the Slider block within the Gutenberg editor. The CSS rule responsible for this bug was removed.

= 2.2.0 - 2025-07-31 =

**Added**

* New blur control to the Flex and Grid Containers blocks. This new control is available under the Style tab.

**Changed**

* Inset CSS property of the Button block. The previous value was cropping a part of the button icon.
* Default values for the "buttonIconColor" and "buttonIconDarkColor" attributes of the Button with Icon variation block.
* Controls order for the hover border color in the Button block. Also, the labels of such controls have been modified.

**Removed**

* Unused CSS styles for the "swiper-slider" class in the Slider and Image Gallery blocks.

= 2.1.1 - 2025-07-29 =

**Changed**

* Controls order in the Additional tab of the Button Block.
* Default value to zero for the "caledros_basic_blocks_add_column_layout_to_wp_site_blocks" and "caledros_basic_blocks_set_custom_height_to_wp_site_blocks" settings. These settings are used in the plugin Admin menu.

= 2.1.0 - 2025-07-28 =

**Added**

* New option to set the height of the wp-site-blocks container to 100vh. This new option is available as a checkbox in the plugin Admin menu.
* New 30 icons to the Icon Block. These icons, like the initial set, are sourced from Bootstrap Icons and are used under the MIT license.
* Missing license notice to the CSS stylesheet of the Icon Block.
* New responsive controls to the Flex Container Block. These controls allow to change the "justify content" and "align items" properties for tablets and mobile devices. In total, there are 4 new controls: Justify Content (Tablet and Mobile), Justify Content (Mobile), Align Items (Tablet and Mobile), and Align Items (Mobile). These controls are available in the "Additional" tab.
* New control to change the color of the lazy-loading overlay. This control is available for the Responsive Image Block in the Additional Tab.
* New control named "Box Shadow", which is available for the Desktop Menu Container and the Mobile Menu Container blocks. It allows to set a custom box shadow for the sticky navigation bar. This control is located in the Sticky tab of the aforementioned blocks.
* New block variation for the Button Block. This block variation is named "Button with Icon" and allows the user to select an icon for the button. These icons are the same as those available for the Icon Block. Also, they are sourced from Bootstrap Icons and are used under the MIT license.
* New controls to the Button Block. These controls allow to change the hover color for the text and border, both for the light and dark mode. 

**Changed**

* Title of the hover background color control for the Button Block.

**Fixed**

* Bug in the Responsive Image Block. This bug was causing the lazy loading overlay to be visible in the Gutenberg editor, while it remained hidden on the frontend. This bug was affecting images with the object-fit property set to "contain", and images with borders.

= 2.0.1 - 2025-07-23 =

**Fixed**

* Bug in the Linkedin icon of the Social Icon block. Now the Linkedin icon is visible.

= 2.0.0 - 2025-07-15 =

**Added**

* Support for translating the texts in the plugin's admin menu.

**Removed**

* 5 blocks and 1 block variation for the Gutenberg editor on pages and posts. The removed blocks are: Content Renderer, Dark Light Mode Switcher, Desktop Menu Container, Mobile Menu Container, and Sidebar Menu. The removed block variation is the Mega Menu block. Now, the Gutenberg editor for pages and posts has only 12 blocks available for use. The Gutenberg editor for templates, template parts, and patterns has access to the 18 custom blocks. 

= 1.2.2 - 2025-07-11 =

**Added**

* CSS styles to the excerpt text of the Posts Loop block.
* Fallback colors for the Posts Loop and Category Loop blocks.

**Fixed**

* Bug with the navigation links of the Posts Loop block. The navigation links were not displaying correctly on the frontend.

= 1.2.1 - 2025-07-08 =

**Fixed**

* CSS style bug in grid and flex containers located inside the Slider block. Now their background colors, gradients, box shadows, and border colors show correctly in the Gutenberg editor.

= 1.2.0 - 2025-07-03 =

**Added**

* A new option in the plugin admin bar to apply a flex-column layout to the wp-site-blocks container.

**Fixed**

* Typos in some of the settings descriptions for the plugin blocks.

= 1.1.1 - 2025-06-18 =

**Added**

* Fallback colors for the default Gutenberg list block. It now uses the same colors as paragraph text in both dark and light modes.

**Removed**

* Empty folder located inside core &#8594; resources &#8594; src

= 1.1.0 - 2025-06-17 =

**Added**

* "Style" tab to the editor of the Posts Loop block. 
* 3 new settings to the Posts Loop block. These settings control the number of columns in desktop, tablet, and mobile screens.
* "Style" tab to the editor if the Category Loop Block. 
* 3 new settings to the Category Loop block. These settings control the number of columns in desktop, tablet, and mobile screens.
* Default colors for links ("a" HTML tags) located inside paragraphs ("p" HTML tags).  The default colors apply to the dark and light modes.
* Missing props (__nextHasNoMarginBottom and __next40pxDefaultSize) to the UI components used as controls for the plugin blocks. Based on the following articles: [Updates to user-interface components in WordPress 6.8](https://make.wordpress.org/core/2025/03/25/updates-to-user-interface-components-in-wordpress-6-8/) and [Updates to user-interface components in WordPress 6.7](https://make.wordpress.org/core/2024/10/18/editor-components-updates-in-wordpress-6-7/).

**Changed**

* README.txt. "Requires at least" information added.

= 1.0.1 - 2025-06-16 =

**Added**

* Fallback error handling to the Slider Block. This handling executes when a template part fails to load.
* "Installation" and "Screenshots" sections to the readme.txt file.

**Changed**

* Replaced fetch() with apiFetch() for improved compatibility in the Slider Block. This change was made in the edit-block file.
* Block titles. The first letter of each word of the block titles has been capitalized.
* Block descriptions for improved clarity.
* Icon property in the block.json file for all 18 blocks. The new icon property has been set to "block-default". This change provides a fallback icon for non-JavaScript environments.

**Fixed**

* Bug which was preventing the template parts of the Slider Block from displaying.* 
* Markdown formatting issues in the readme.txt file.

= 1.0.0 - 2025-06-15 =

**Added**

* 18 custom Gutenberg blocks
* CSS stylesheet preloader for improved performance. This preloader can be disabled.

== Upgrade Notice ==

= 3.1.1 =
This update fixes several errors highlighted by the latest version of Plugin Check.

= 3.1.0 =
This update adds a new control and two new control options to the Posts Loop block.

= 3.0.0 =
This update removes blocks from the block inserter for non-header template parts.

= 2.2.1 =
This update fixes a CSS bug in Flex Container blocks located inside the Slider block.

= 2.2.0 =
This update adds a new blur control to the Flex and Grid Containers blocks.

= 2.1.1 =
This update changes the controls order of the Button block and modifies the default values of 2 plugin settings.

= 2.1.0 =
This update adds several new features to the blocks included in the plugin. 

= 2.0.1 =
This update fixes a bug in the Linkedin icon of the Social Icon block.

= 2.0.0 =
This update disables 5 blocks and 1 variation block for the Gutenberg editor in pages and posts.

= 1.2.2 =
This update fixes a bug with the navigation links of the Posts Loop block. It also adds CSS styles to the Posts Loop and Category Loop blocks.

= 1.2.1 =
This update fixes a CSS style bug in grid and flex containers located inside the Slider block.

= 1.2.0 =
This update adds an option in the plugin admin bar to apply a flex-column layout to the wp-site-blocks container.

= 1.1.1 =
Added fallback colors for the default Gutenberg list block. It now uses the same colors as paragraph text in both dark and light modes.

= 1.1.0 =
This version includes new settings for the Posts Loop and Category Loop blocks, default CSS styles for links, and updates to user-interface components.

= 1.0.1 =
This update includes important bug fixes for the Slider block, improved compatibility using apiFetch(), and enhanced fallback handling.

= 1.0.0 =
Welcome to the first release of Caledros Basic Blocks! This version introduces 18 new performance-optimized Gutenberg blocks. The plugin includes an optional CSS preloader.

== Installation ==

You have two easy ways to install the Caledros Basic Blocks plugin:

**Option 1: From Your WordPress Dashboard**

**1\.** Go to your WordPress admin area.

**2\.** Navigate to Plugins &#8594; Add Plugin.

**3\.** In the Search Plugins box, type "Caledros Basic Blocks".

**4\.** Click Install Now, then Activate.

**Option 2: Manual Installation**

**1\.** Download the plugin ZIP file from WordPress.org.

**2\.** In your WordPress admin area, go to Plugins &#8594; Add Plugin &#8594; Upload Plugin.

**3\.** Choose the ZIP file you downloaded and click Install Now.

**4\.** Activate the plugin after installation.

**Need help or want to see what each block can do?**

Visit my [YouTube](https://www.youtube.com/@CaledrosForge) channel for step-by-step tutorials and tips on using Caledros Basic Blocks.