1. Documentation
  2. Plugins
  3. WooSlider
  4. Codex

WooSlider Shortcode Parameters Reference

Sometimes, it’s necessary to add an extra parameter to an existing shortcode, or maybe you prefer adding the parameters manually, instead of using the built-in shortcode creator.

Below is a list of all available parameters that can be used with the shortcode. The default settings for each of the “settings” parameters can be adjusted on the WooSlider “Settings” screen.

Defaults for the slideshow type-specific parameters are listed below each parameter, if a default setting is applicable.

Note: This is a Developer level doc. If you are unfamiliar with parameters and resolving potential conflicts, select a WooExpert or Developer for assistance. We are unable to provide support for customizations under our  Support Policy.

General settings ↑ Back to top

  • slider_type – The slideshow type desired (bundled options include “attachments”, “posts” and “slides”)
  • animation – The type of animation transition to apply (“slide” or “fade”)
  • direction – The direction in which to slide the slides (works only with the “slide” animation) (“horizontal” or “vertical”)
  • slideshow_speed – The delay between each slide animation (0.5 – 10.0 – in seconds ( 1.5, 2.0, 2.5, etc))
  • animation_duration – The duration of each slide transition animation (0.1 – 0.9 and 1.0 – 10.0, with 0.5 increments)

Control settings ↑ Back to top

  • autoslide – Whether or not to automatically animate the slideshow (Boolean- “true” or “false”)
  • smoothheight – Whether or not to adjust the slideshow height to the height of the current slide (Boolean- “true” or “false”)
  • direction_nav – Whether or not to display the “previous/next” navigation (Boolean- “true” or “false”)
  • control_nav – Whether or not to display the pagination (Boolean- “true” or “false”)
  • keyboard_nav – Whether or not to enable navigation using a keyboard (Boolean- “true” or “false”)
  • mousewheel_nav – Whether or not to enable navigation using the mousewheel (Boolean- “true” or “false”)
  • randomize – Whether or not to randomize the display of the slides in the slideshow (Boolean- “true” or “false”)
  • animation_loop – Whether or not to loop the animation when reaching the end (Boolean- “true” or “false”)
  • pause_on_action – Whether or not to pause when the visitor uses the navigation controls on the slideshow (Boolean- “true” or “false”)
  • pause_on_hover – Whether or not to pause when the visitor hovers over the slideshow (Boolean- “true” or “false”)

Button settings ↑ Back to top

  • prev_text – Custom text to display as the “Previous Slide” button text
  • next_text – Custom text to display as the “Next Slide” button text
  • play_text – Custom text to display as the “Play Slideshow” button text
  • pause_text – Custom text to display as the “Pause Slideshow” button text

Note: By default, WooSlider’s CSS styles hide the text on these buttons. Additional CSS styles would be required to display this text (alternatively, it displays when hovering over the buttons).

Attached Images parameters ↑ Back to top

  • id – An optional post ID for which to retrieve attached images (must be an integer).
    Default: $post->ID (the ID of the current post being viewed)
  • size – The size of the image to be displayed (takes a WordPress size handle – “thumbnail”, “medium”, “large”, “full” or a custom-registered image size)
    Default: “large”
  • limit – The number of posts to display (an integer value such as 1, 5, or 10, for example)
    Default: “5”
  • thumbnails – Whether or not to use thumbnails for pagination, instead of the default pagination navigation (Boolean- “true” or “false”)
    Default: “false”

Posts parameters ↑ Back to top

  • category – The slug (or a comma-separated list of slugs) of one or more of your post categories
  • tag – The slug (or a comma-separated list of slugs) of one or more of your post tags
  • size – The size of the image to be displayed (takes a WordPress size handle – “thumbnail”, “medium”, “large”, “full” or a custom-registered image size)
    Default: “large”
  • layout – Where to display the post title and excerpt, in relation to the image (“text-left”, “text-right”, “text-top”, “text-bottom”)
    Default: “text-left”
  • overlay – Whether or not to overlay the text over the image (“none”, “natural” or “full”)
    Default: “none”
  • limit – The number of posts to display (an integer value such as 1, 5, or 10, for example)
    Default: “5”
  • thumbnails – Whether or not to use thumbnails for pagination, instead of the default pagination navigation (Boolean- “true” or “false”)
    Default: “false”
  • link_title – Whether or not to transform the title of each post into a link to the post itself (Boolean- “true” or “false”)
    Default: “false”

Slides parameters ↑ Back to top

  • slide_page – The slug (or a comma-separated list of slugs) of one or more of your slide groups
  • limit – The number of posts to display (an integer value such as 1, 5, or 10, for example)
    Default: “5”
  • thumbnails – Whether or not to use thumbnails for pagination, instead of the default pagination navigation (Boolean- “true” or “false”)
    Default: “false”

How to use these parameters ↑ Back to top

Adding parameters to the shortcode looks like this:

Adding a second parameter (smoothheight, for example) would look as follows:

It’s only necessary to add a parameter to the shortcode if you wish to override that specific parameter for that slideshow.

WooCommerce - the most customizable eCommerce platform for building your online business.

  • 30 day money back guarantee
  • Support teams across the world
  • Safe & Secure online payment