=== CM CSS Columns ===
Contributors: codemacher
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=C53QMVCECEQPA
Tags: css3, multiple columns
Requires at least: 4.0.0
Tested up to: 4.5
Stable tag: trunk
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
The plugin offers shortcodes to use the CSS3 Multiple Columns layout feature.
== Description ==
The plugin offers different shortcodes to use the [CSS3 Multiple Columns](http://www.w3schools.com/css/css3_multiple_columns.asp).
Here is the list of shortcodes with the corresponding attributes:
= [css_columns] =
This is an enclosing shortcode to distribute content into a CSS3 multiple columns layout. As content you can use any complex markup. A div-Tag with CSS classes and default definitions is used to wrap the content. The default values for the attributes can be changed in the settings page of the plugin.
*Possible attributes:*
* **gap** - Specifies the gap between the columns, e.g. in pixel 40px. Possible values can be found on column-gap on w3schools.com
* **width** - Specifies a suggested, optimal width for the columns. Possible values can be found on column-width on w3schools.com
* **count** - Specifies the number of columns an element should be divided into. Possible values can be found on column-count on w3schools.com
* **rule_color** - Specifies the color of the rule between columns. Possible values can be found on column-rule-color on w3schools.com
* **rule_style** - Specifies the style of the rule between columns. Description for the values can be found on column-rule-style on w3schools.com
* **rule_width** - Specifies the width of the rule between columns. Possible values can be found on column-rule-width on w3schools.com
*Example:*
[css_columns gap=30px width=120px count=3 rule_color="#000000" rule_style=solid rule_width=medium]
.... here goes the complex content ....
[/css_columns]
= [css_col_span] =
This is an enclosing shortcode, which only can be used within the [css_columns] shortcode. You can define content, which spans over multiple columns.
*Possible attributes:*
* **cols** - Specifies how many columns an element should span across. Same values like column-span on w3schools.com
* **tag** - Specifies the tag used for wrapping the spanning content, e.g. span, h2, div, ...
*Example:*
[css_col_span cols=2 tag=div]
... here goes the spanning content ....
[/css_col_span]
= [css_no_break] =
This is an enclosing shortcode, which only can be used within the [css_columns] shortcode. You can define content, which never breaks into different columns. **WARNING** Feature is not supported by Firefox yet!
*Possible attributes:*
* **type** - Specifies whether a page break is allowed inside a specified element. Same values like page-break-inside on w3schools.com
* **tag** - Specifies the tag used for wrapping the non breaking content, e.g. span, h2, div, ...
*Example:*
[css_no_break type=avoid tag=div]
... here goes the non-breakable complex content ....
[/css_no_break]
== Installation ==
1. Extract and upload `cm-css-columns.zip` to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Use the shortcodes in the editor.
== Screenshots ==
1. settings page to define the default attribute values
== Frequently Asked Questions ==
= Do I have to use shortcodes? =
Yes. At the moment this is the only possibility to use the plugin.
== Changelog ==
= 1.0.2 =
* bugifx backend javascript error
= 1.0.1 =
* bugfix deactivation
= 1.0 =
* initial release version
== Upgrade Notice ==
= 1.0.2 =
Bugfix for the backend javascript errors.