Description
The plugin offers different shortcodes to use the CSS3 Multiple Columns.
For better user experience it includes an integration into the visual editor. You can enter all attributes with the help of dialogs, so you don’t need to write the shortcodes by hand.
The plugin simply wraps the enclosed content into a container and defines according CSS rules.
The attributes for the shortcodes and examples you can find under “Other Notes”.
All default values can be changed in the settings page. With saving the settings a static CSS file is written and included for better performance.
Shortcodes
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]
Screenshots
Installation
- Extract and upload
cm-css-columns.zip
to the/wp-content/plugins/
directory. - Activate the plugin through the ‘Plugins’ menu in WordPress.
- Use the shortcodes in the editor.
FAQ
- Do I have to use shortcodes?
-
No. You can also use the dialogs to insert the shortcode with visual editor.
Contributors & Developers
“CM CSS Columns” is open source software. The following people have contributed to this plugin.
Contributors“CM CSS Columns” has been translated into 1 locale. Thank you to the translators for their contributions.
Translate “CM CSS Columns” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.2.1
- tested in last WordPress versions
1.2.0
- Added: attributes dialog for [css_col_span]-shortcode
- Added: attributes dialog for [css_no_break]-shortcode
1.1.1
- Added: attributes dialog for [css_columns]-shortcode
- Fixed: generating and including the CSS file with default values
1.1.0
- Added: menu button in visual editor to wrap selected text with shortcodes
1.0.2
- Fixed: backend javascript error
1.0.1
- Fixed: activation/deactivation
1.0
- initial release version