Shortcodes

Button shortcode:

[button][/button]

 

Available attributes

• url – Where the button links. Any valid link. Default ‘#‘.
• target – Where the link should open. Any one of: ‘_blank‘, ‘_self‘, ‘_parent‘, ‘_top‘. Default empty.
• size – The size of the button. Any one of: ‘small‘, ‘medium‘, ‘large‘. Default ‘medium‘.
• scheme – Color scheme. Any predefined color scheme name.
• bg_color – The background color of the button. Any valid CSS color.
• fg_color – The foreground (text) color of the button. Any valid CSS color.
• border_color – The border color of the button. Any valid CSS color.
• border_width – The width of the border. Any valid CSS border-width: value.
• corners – The radius of the border’s corner. Any valid CSS border-radius: value.
• icon – A Font-Awesome icon name. E.g. ‘fa-download‘
• spin_icon – Turn icon spinning on. See spin_icon.

 

Examples

A button to CSSIgniter A button to CSSIgniter A button to CSSIgniter

---

New window to Google New window to Google New window to Google

---

Download now Download now Download now

---

Refresh Refresh Refresh

---

Rounded Rounded Rounded

---

Compatibility with pre-v2.0 versions

The button shortcode used to accept a type and color attributes that are now deprecated. Valid values for those attributes were:

• type – Any one of: download, check, envelope, cancel, cart. Use of the type attributes is discouraged and unsupported. Existing shortcodes will get mapped to a similar icon.
• color – Any one of: grey, white, blue, yellow, green, red, black, purple. Use of the color attributes is discouraged and unsupported. Existing shortcodes will get mapped to a similar scheme.

---

Box shortcode:

[box][/box]

 

Available attributes

• scheme – Color scheme. Any predefined color scheme name.
• bg_color – The background color of the box. Any valid CSS color.
• fg_color – The foreground (text) color of the box. Any valid CSS color.
• border_color – The border color of the box. Any valid CSS color.
• border_width – The width of the border. Any valid CSS border-width: value.
• corners – The radius of the border’s corner. Any valid CSS border-radius: value.
• icon – A Font-Awesome icon name. E.g. ‘fa-download‘
• spin_icon – Turn icon spinning on. See spin_icon.

 

Examples

---

---

---

---

 

Compatibility with pre-v2.0 versions

The box shortcode used to accept a type attribute that is now deprecated. Valid values for this attribute were:

• type – Any one of: normal, info, warning, download, error, success. Use of the type attribute is discouraged and unsupported. Existing shortcodes will get mapped to a similar icon.

---

Grid shortcodes:

[row][/row], [column][/column], [col][/col]

With these shortcodes you can create a grid system within your posts or pages which will allow you to display your content in columns. The shortcode uses a twelve grid layout so the maximum sum of columns in a single row can’t be more than twelve. Start by creating the [row][/row] shortcode which is the container for your columns, much like a row in a spreadsheet contains the cells from each column. Then proceed by adding the [col][/col] or [column][/column], each [col][/col] shortcode will have a number which will represent how much of the available width the particular column will take up, for example if you have [col desktop="6"][/col] this column will take up 6 columns from the total 12, so half the available width. You are now left with 6 more columns which you can either use up in one or more [col][/col] shortcodes.

 

row – Available attributes

• none

column, col – Available attributes

• desktop – Number of columns for the medium breakpoint ‘md‘.
• tablet – Number of columns for the small breakpoint ‘sm‘.
• mobile – Number of columns for the extra small breakpoint ‘xs‘. Default ‘12‘
• class – Additional classes for the generated wrapper. Useful for applying styles and/or targeting in custom styles.
• id – An optional HTML id value for the generated wrapper. Useful for targeting in custom styles.

 

Examples

Two equal columns

---

Three equal columns

---

Two unequal columns on desktop, equal on tablets.

---

 

Nested columns

WordPress can’t handle nested shortcodes of the same name. So, you can’t really do:

We have made available, however, the same row and column shortcodes prefixed with one and two undescores, so for each nesting level (up to two) you just ads an underscore. E.g.:

The additionally available shortcodes are: _row, __row, _column, __column, _col, __col

 

Compatibility with pre-v2.0 versions

The older shortcodes one_half, one_half_last, one_third, one_third_last, two_thirds, two_thirds_last are now deprecated. Although they are mapped to the new column shortcode for compatibility, it’s not possible to automatically wrap them in a row. So, results will vary from installation to installation, and even from post to post. If you are having troubles with the layout of these old shortcodes, try wrapping them in a [row][/row] shortcode.

---

Headings shortcodes:

[h][/h], [h1][/h1], [h2][/h2], [h3][/h3], [h4][/h4], [h5][/h5], [h6][/h6]

 

With the h shortcode, you can create styled headings for you content. The shortcodes h1-h6 are just shorthand aliases to h with the level attribute already set.

 

Available attributes

• level – The heading level. A number between 1-6. Default ‘2‘ but can be changed through the plugin’s options.
• scheme – Color scheme. Any predefined color scheme name.
• bg_color – The background color of the heading. Any valid CSS color.
• fg_color – The foreground (text) color of the heading. Any valid CSS color.
• border_color – The border color of the heading. Any valid CSS color.
• border_width – The width of the border. Any valid CSS border-width: value.
• corners – The radius of the border’s corner. Any valid CSS border-radius: value.
• icon – A Font-Awesome icon name. E.g. ‘fa-download‘
• spin_icon – Turn icon spinning on. See spin_icon.
• padding – Add some padding in order to make the heading box larger. Any valid CSS padding: value.

 

Examples

This is set from the options to be H2

---

A maroon H3 with globe

---

An H4 with a lemon

---

With a bottom border

---

---

List shortcode:

[list][/list]

&nbsp
You can replace those boring default HTML bullets by any icon you like. Just create a normal unordered (ul) list from within the WordPress editor, and wrap it in a [list][/list] shortcode.

 

Available attributes

• scheme – Color scheme. Only affects the icon. Any predefined color scheme name.
• color – The color of the icon. Any valid CSS color.
• icon – A Font-Awesome icon name. E.g. ‘fa-download‘

 

Examples

---

 

Compatibility with pre-v2.0 versions

The list shortcode used to accept a type attribute that is now deprecated. Valid values for this attribute were:

• type – Any one of: check, cross. Use of the type attribute is discouraged and unsupported. Existing shortcodes will get mapped to a similar icon.

---

Blockquote shortcode:

[quote][/quote]

 

Available attributes

• title – The citation text, i.e. who said what you’re quoting.
• scheme – Color scheme. Any predefined color scheme name.
• bg_color – The background color of the blockquote. Any valid CSS color.
• fg_color – The foreground (text) color of the blockquote. Any valid CSS color.
• border_color – The border color of the blockquote. Any valid CSS color.
• border_width – The width of the border. Any valid CSS border-width: value.
• corners – The radius of the border’s corner. Any valid CSS border-radius: value.
• icon – A Font-Awesome icon name. Default ‘fa-quote-left‘.

 

Examples

---

---

 

Compatibility with pre-v2.0 versions

The quote shortcode used to accept a float attribute that is now removed. Valid values for this attribute were:

• float – Any one of: left, right. Use of the float attribute is not supported. Existing shortcodes will behave as if the attribute was omitted.

---

Separator shortcodes:

[separator /], [hr /]

Both shortcodes separator and hr, are just aliases of each other and behave exactly the same.

Available attributes

• type – The type / styling of the separator. Any one value of: solid, dotted, dashed, double, groove, ridge, inset, outset. Default ‘solid‘.
• scheme – Color scheme. Any predefined color scheme name.
• color – The color of the separator. Any valid CSS color.
• height – The height of the separator (bottom border). Any valid CSS border-width: value.
• width – The width of the separator. Any valid CSS unit of length.
• center – Centered separator. Any one value of: true, on. Furthermore, a ‘center‘ value can be placed by itself as a shorthand, without the need for the attribute name.

 

Examples

---

---

---

---

---

---

---

---

---

---

 

Compatibility with pre-v2.0 versions

The separator shortcode used to accept a type attribute that is now removed. Valid values for this attribute were:

• type – Any one of: normal, lightning. Use of the type attribute is not supported. Existing shortcodes will behave as if the attribute was omitted.

---

Tooltip shortcode:

[tooltip][/tooltip]

 

Available attributes

• tip – The content that appears as the tootip. Required.
• position – The position of the tooltip relative to the hover-able text. Any one value of: top, bottom, left, right. If empty, the tooltip appears over the hover-able text.
• always – Always show the tooltip. Any one value of: on. Furthermore, a ‘alwayson‘ value can be placed by itself as a shorthand, without the need for the attribute name.
• color – The color scheme of the tooltip. Any one value of: dark, light. Default ‘dark‘. Furthermore, a ‘light‘ value can be placed by itself as a shorthand, without the need for the attribute name.

 

Examples

Do you know what a CPU is?

---

Just a tooltip on the top.

---

How about an always on, right, tooltip?

---

 

Compatibility with pre-v2.0 versions

The tooltip shortcode used to accept a contents and color attributes that are now deprecated. Valid values for these attributes were:

• contents – The content that appears as the tooltip. Use of the contents attribute is not supported. Existing shortcodes will map this attribute to the tip attribute.
• color – The color attribute is still in use, however the older ‘grey‘ value is no longer support. Existing shortcodes using ‘grey‘ will get mapped to ‘light‘ instead.

---

Map shortcodes:

[map /] , [googlemap /]

 

Available attributes

• lat – The latitude of a place in the map. Any decimal value between -90 to 90. Required.
• lon – The longitude of a place in the map. Any decimal value between -180 to 180. Required.
• zoom – Zoom level of the map. Any integer value between 0-21. Default ‘8‘.
• title – The text appearing when hovering over the map marker.
• text – The text appearing when the map marker gets clicked.

 

Examples

---

---

Compatibility with pre-v2.0 versions

The googlemap shortcode used to accept a src attribute that is now deprecated. Valid values for this attribute were:

• src – A google maps URL. Use of the src attribute is no longer supported. Existing shortcodes will extract and map this attribute to the appropriate lat, lon and zoom attributes.

Important information regarding map shortcode usage

The maps API is off by default on new installations, to enable it go to Settings > CSSIgniter Shortcodes and check the Load Google Maps API box. Additionally you will need maps API key as it is mandatory for the map embed to work. More info about this here.

---

Slider shortcodes:

[slider][/slider] , [slide][/slide]

To create a slider wrap one or more [slide][/slide] shortcodes into a [slider][/slider] shortcode. The slide’s content will be placed in the slide shortcode, like this [slide] Slider content here [/slide].

 

slider – Available attributes

• scheme – Color scheme. Any predefined color scheme name.
• bg_color – The background color of the slider’s content. Any valid CSS color.
• fg_color – The foreground (text) color of the slider’s content. Any valid CSS color.
• border_color – The border color of the slider. Any valid CSS color.
• border_width – The width of the slider’s border. Any valid CSS border-width: value.
• corners – The radius of the slider’s border corners. Any valid CSS border-radius: value. Note: If you provide a single CSS unit value, it will only be applied to the to top-left and top-right corners of each tab. This is on purpose, to get the best result with minimal typing. If you need to affect all corners of the tabs, you’ll need to provide four values, e.g. corners=”10px 10px 10px 10px”

 

Examples

---

Tabs shortcodes:

[tabs][/tabs] , [tab][/tab]

In order to create a set of tabs, you need to wrap one or more [tab][/tab] shortcodes into a [tabs][/tabs] shortcode.

 

tabs – Available attributes

• scheme – Color scheme. Any predefined color scheme name.
• bg_color – The background color of the tabs’ content. Any valid CSS color.
• fg_color – The foreground (text) color of the tabs’ content. Any valid CSS color.
• tab_bg_color – The background color of the inactive tabs. Any valid CSS color.
• tab_fg_color – The foreground (text) color of the inactive tabs. Any valid CSS color.
• active_bg_color – The background color of the active tab. Any valid CSS color.
• active_fg_color – The foreground (text) color of the active tab. Any valid CSS color.
• border_color – The border color of the tab group. Any valid CSS color.
• border_width – The width of the tab group’s border. Any valid CSS border-width: value.
• corners – The radius of the tabs’ border corners. Any valid CSS border-radius: value. Note: If you provide a single CSS unit value, it will only be applied to the to top-left and top-right corners of each tab. This is on purpose, to get the best result with minimal typing. If you need to affect all corners of the tabs, you’ll need to provide four values, e.g. corners=”10px 10px 10px 10px”

 

tab – Available attributes

• title – The text that appears on the tab. Required.

 

Examples

---

---

Accordions shortcodes:

[accordion][/accordion], [accordion_tab][/accordion_tab]

Accordions’ syntax and attributes are exactly the same like the tabs shortcode. Only the actual names of the shortcode change. That way, you can easily swap from tabs to accordions and back, without touching any of the attributes.

 

accordion – Available attributes

• scheme – Color scheme. Any predefined color scheme name.
• bg_color – The background color of the accordion tabs’ content. Any valid CSS color.
• fg_color – The foreground (text) color of the accordion tabs’ content. Any valid CSS color.
• tab_bg_color – The background color of the inactive accordion tabs. Any valid CSS color.
• tab_fg_color – The foreground (text) color of the inactive accordion tabs. Any valid CSS color.
• active_bg_color – The background color of the active accordion tab. Any valid CSS color.
• active_fg_color – The foreground (text) color of the accordion active tab. Any valid CSS color.
• border_color – The border color of the accordion. Any valid CSS color.
• border_width – The width of the accordion’s border. Any valid CSS border-width: value.
• corners – The radius of the accordion tabs’ border corners. Any valid CSS border-radius: value. Note: If you provide a single CSS unit value, it will only be applied to the to top-left and top-right corners of each accordion tab. This is on purpose, to get the best result with minimal typing. If you need to affect all corners of the accordion tabs, you’ll need to provide four values, e.g. corners=”10px 10px 10px 10px”

 

accordion_tab – Available attributes

• title – The text that appears on the accordion tab. Required.

 

Examples

---

---

Common attributes.

 

Predefined color schemes.

Any shortcode that accepts an attribute named ‘scheme‘ can accept any one of the following values: blue, red, yellow, orange, purple, pink, brown, green, grey, white, black.

 

color

All attributes in every shortcode that accept a CSS color value, usually named ‘something_color’ can accept any of these color formats:

• Hexadecimal: #000000 to #ffffff upper-case or lower-case. Shorthand notation is not allowed, i.e. #000 to #fff
• rgb(): rgb($r, $g, $b) – Where $r $g and $b is a number 0-255 or a percentage 0%-100%
• rgba(): rgba($r, $g, $b, $a) – As above, and $a between 0-1.
• hsl(): hsl($h, $s, $l) – Where $h 0-360, $s and $l 0%-100%.
• hsla(): hsla($h, $s, $l, $a) – As above, and $a between 0-1 (decimal values allowed).
• Any one of the following keywords: transparent, initial, inherit, black, silver, gray, white, maroon, red, purple, fuchsia, green, lime, olive, yellow, navy, blue, teal, aqua

Please note that common names between the predefined colors above and the color schemes, doesn’t necessarily translate to the same color values.

 

spin_icon

Where a spin_icon attribute is available, valid values are: ‘true‘, ‘spin‘.
Furthermore, a ‘spin‘ value can be placed by itself as a shorthand, without the need for the attribute name.

 

Examples

The following shortcodes are all identical:

They all produce:

Some text

 

border_width

Shortcodes that have a border_width property, can accept any valid CSS shorthand border-width value:

• One to four CSS units of length.
• Any one of the following keywords: thin, medium, thick, initial, inherit

 

Examples

---

---

corners

Shortcodes that have a corners property, can accept any valid CSS shorthand border-radius value:

• One to four CSS units of length, optionally followed by a forward slash ‘/‘ and one to four CSS units of length.
• Any one of the following keywords: initial, inherit

 

Examples

---

---

padding

Shortcodes that have a padding property, can accept any valid CSS shorthand padding value:

• One to four CSS units of length.

Length Units

Any property that requires a CSS unit of length accepts a number immediately followed by one of the following units: px, %, em, rem, ex, ch, vh, vw, vmin, vmax, mm, cm, in, pt, pc

Decimal numbers expressed in pixels (px) may or may not work depending on each browser’s handling, they are however accepted by the plugin.

 

Examples

• 1px
• 0.5em
• 1.2rem

---

Compatibility Mode

It’s quite common for users to have installed more than one shortcodes plugins, or for themes to provide their own shortcodes. When this happens, chances are that some shortcodes overlap, and more often than not, you end up having shortcodes that you can’t be sure where are they getting their styles and markup from.

Just go into the plugin’s settings panel, check the Compatibility Mode checkbox and Save Changes. You’ve just future-proofed your posts! All shortcodes now require a prefix of ‘ci-‘ minimizing the risk of collision with other shortcode providers. For example, instead of [button]Hello[/button] you should now write [ci-button]Hello[/ci-button]