=== Categories All In One ===
Contributors: coolcatideas, teastudio.pl
Tags: categories, taxonomy, list, widget, shortcode
Requires at least: 6.2
Tested up to: 6.8
equires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Display customizable category list from selected taxonomies with various sorting and styling options.

== Description ==

**Categories All In One** is a powerful and flexible WordPress plugin that lets you display a customizable list of categories anywhere on your site. 
Choose your taxonomy, control the layout and style, set depth levels, and sort your content exactly how you need it - including manual drag-and-drop ordering of categories for full control over the display sequence. 

For more information, check out [PLUGIN HOMEPAGE](https://teastudio.pl/product/categories-all-in-one/).

**Key Features:**  

* Supports any category cointains 'category' string in name 
* Legacy widget
* Gutenberg block
* Shortcode `[categories_all_in_one ...]` for embedding the categories anywhere  
* Configure list style, counter brackets, sorting with drag & drop, depth and classes  

**Watch the demo video** 
[youtube https://youtu.be/N_OcJBvvecU ]

**Shortcode explanation:**  

`[categories_all_in_one list="bullet" separator="" hide_empty="false" show_count="true" counter_brackets="round" orderby="name" order="asc" custom_class="" post="false" parent_category="" max_depth="0" block_custom_class="" taxonomy="category" exclude=""]`

**Params:**
lang:	optional language code, 'en'
post:	optional proper post ID, ""
taxonomy:	proper taxonomies, separated by commas
parent_category:	proper category ID, ""
orderby: name, count
order: asc, desc, rand
max_depth: 0, 1...n
hide_empty:	true, false
exclude:	category ID separated by commas, ""
include:	category ID separated by commas, ""
list: bullet, numbered, ""
show_count: true, false
counter_brackets: round, curly, square, angle, ""
show_description: true, false
description_length: 0, 1...n
description_link: true, false
separator: ""
custom_class: ""
block_custom_class: ""


**Example of use:**
`[categories_all_in_one exclude="" lang="en" post="false" parent_category="" orderby="name" order="asc" max_depth="0" hide_empty="false" list="bullet" show_count="true" counter_brackets="round" show_description="true" description_length="100" description_link="true" separator="" custom_class="" block_custom_class="" taxonomy="category"]`
    

= DEMO =
You can see the plugin in action on [DEMO PAGE](https://coolcatideas.com/blog/)

== Translations ==

* English (en_EN) - by Marcin Gierada
* Polish (pl_PL) - by Marcin Gierada

== Installation ==

1. Upload plugin either via the yours Wordpress installation, or by uploading to the /wp-content/plugins/ by FTP client
2. Install the plugin through the 'Plugins' menu in WordPress.
3. Activate "Categories All In One" in the "Plugins" using the "Activate" link.

== Frequently Asked Questions ==
If you've got any questions, don't hesitate to ask.

== Screenshots ==
1. Category list example
2. Gutenberg block
3. Legacy widget
4. Button
5. Shortcode generator


== Building the Plugin in Development Mode ==
The source code for the plugin is available at: [GitLab Repository](https://gitlab.com/cool-cat-ideas/categories-all-in-one#). We encourage developers to contribute, fork, and improve the plugin.
To build the plugin in development mode, follow these steps:

### 1. Install Dependencies
Run the following command to install npm dependencies:
`npm install`

### 2. Build Gutenberg Block
To build only the Gutenberg block, use:
`npm run build-gutenberg`

This will compile the block's JavaScript and place it in the `js/block/` folder.

### 3. Build Full Plugin
To build the entire plugin, including the Gutenberg block and other files, use:
`npm run build`
This will generate the plugin package in the `dist/` folder.


== Changelog ==

= 1.1.0 =
* added independent language support
* added drag & drop category sorting
* added param to display category description
* added param to set custom block classes 
* improved plugin styles

= 1.0.0 =
* Initial release

== Upgrade Notice ==