Shortcode Parameters

You can output QuotesDLX in a shortcode. This makes QuotesDLX compatible with the Classic Editor and also with most page builders.

QuotesDLX has a shortcode you can use if you don't want to use the block output.

Here's a sample shortcode.

[quotesdlx]This is the quote I'd like to share[/quotesdlx]

The shortcode will get your defaults from the admin options, but you can easily override the defaults.

Here are the available shortcode parameters.

template

Can be:

  • midnight-blue

  • bubble-gum

  • cotton-candy

  • dark-x

  • dark-matter

  • light-branded

  • purple-bliss

Available Themes

Example usage:

[quotesdlx template="bubble-gum"]This is the quote I'd like to share[/quotesdlx]

share_text_override_enabled

If your quote is too long, you can enable a shorter version. You'll use this in conjunction with share_text_override.

Can be:

  • true

  • false (default)

share_text_override

Enter the text you'd like to use for Twitter sharing to avoid exceeding the character count.

Example usage:

[quotesdlx share_text_override_enabled="true" share_text_override="this text is shorter"]This is the quote I'd like to share[/quotesdlx]

hashtags

These are comma-separated and will be displayed when sharing on Twitter/X.

Example usage:

[quotesdlx hashtags="WordPresRules,BuildInPublic"]This is the quote I'd like to share[/quotesdlx]

share_button_text

This is for the text shown on the Twitter (now X) button if a label is shown.

Example usage:

[quotesdlx share_button_text="Post on X"]This is the quote I'd like to share[/quotesdlx]

facebook_share_button_text

This is for the text shown on the Facebook button if a label is shown.

[quotesdlx share_button_text="Post on X" facebook_share_button_text="Share to Facebook" facebook_button_enabled="true"]This is the quote I'd like to share[/quotesdlx]

For a Facebook button to show, you need to set facebook_button_enabled to true.

twitter_username

What Twitter/X username you'd like to use when someone shares out the quote.

Example usage:

[quotesdlx twitter_username="mediaronllc"]This is the quote I'd like to share[/quotesdlx]

tweet_button_alignment

This argument controls the overall alignment of the share buttons.

Can be:

  • left

  • center

  • right (default)

Example usage:

[quotesdlx tweet_button_alignment="left"]This is the quote I'd like to share[/quotesdlx]

tweet_icon_alignment

This argument controls the location of the icon on the share buttons.

Can be:

  • left

  • center

  • right (default)

Example usage:

[quotesdlx tweet_icon_alignment="left"]This is the quote I'd like to share[/quotesdlx]

tweet_button_enabled

Hide the Twitter button by setting this to false.

Can be:

  • true (default)

  • false

Example usage (only show Facebook):

[quotesdlx tweet_button_enabled="false" facebook_button_enabled="true"]This is the quote I'd like to share[/quotesdlx]

facebook_button_enabled

Enable the Facebook button in the quote.

Can be:

  • true

  • false (default)

Example usage:

[quotesdlx share_button_text="Post on X" facebook_share_button_text="Share to Facebook" facebook_button_enabled="true"]This is the quote I'd like to share[/quotesdlx]

tweet_button_display

Determine how the sharing buttons look.

Can be:

  • full (default)

  • icon (icons only)

  • text (text only)

Example usage:

[quotesdlx tweet_button_display="icon" facebook_button_enabled="true"]This is the quote I'd like to share[/quotesdlx]

icon_appearance

This determines if the buttons should be shown as-is, or are transparent.

Can be:

  • button (default)

  • transparent

The argument tweet_button_display must be set to icon for a button to be transparent.

Example usage:

[quotesdlx template="purple-bliss" tweet_button_alignment="center" tweet_button_display="icon" facebook_button_enabled="true" icon_appearance="transparent"]This is the quote I'd like to share[/quotesdlx]

maximum_width

The maximum width of the container (numbers only). Use this in conjunction with maximum_width_unit.

Example usage:

[quotesdlx maximum_width="600" maximum_width_unit="px"]This is the quote I'd like to share[/quotesdlx]

maximum_width_unit

Set the unit for the max-width:

Can be:

  • vh

  • vw

  • px (default)

  • em

  • rem

Example usage:

[quotesdlx maximum_width="600" maximum_width_unit="px"]This is the quote I'd like to share[/quotesdlx]

align

The overall alignment of the Quote container.

Can be:

  • left

  • center (default)

  • right

  • wide

  • full

Example usage:

[quotesdlx maximum_width="600" maximum_width_unit="px" align="left"]This is the quote I'd like to share[/quotesdlx]

has_anchor

Whether the permalink has an anchor or not.

Can be:

  • true (default)

  • false

anchor

Default empty. Define an anchor here that'll be appended to the permalink.

The shortcode argument has_anchor must be set to true and enable_links_in_tweet must be true.

Example usage:

[quotesdlx anchor="my-unique-anchor" has_anchor="true"]This is the quote I'd like to share[/quotesdlx]

This would result in a URL like:

https://dlxplugins.local/quotesdlx-test/#my-unique-anchor 

This enables or disables a permalink displaying when sharing to Twitter/X.

Can be:

  • true (default)

  • false

Example usage:

[quotesdlx enable_links_in_tweet="false"]This is the quote I'd like to share[/quotesdlx]

url_shortener

Whether to use a URL shortening service or not.

Can be:

  • true

  • false (default)

url_shortening_service

Determine which service you'd like to shorten your links with.

Can be:

  • manual

  • bitly

  • jetpack

Bitly and Jetpack are separate plugins, so you'll need to install and configure those for shortlinks.

This allows you to put in a custom link for sharing on Twitter/X.

The url_shortening_service must be manual for manual permalinks to work.

Example usage:

[quotesdlx url_shortener="true" url_shortening_service="manual" manual_permalink="https://dlxplugins.com"]This is the quote I'd like to share[/quotesdlx]

enable_contextual_menu

Enable or disable the meatball contextual menu.

Can be:

  • true (default)

  • false

Global contextual menu settings will override this value.

[quotesdlx enable_contextual_menu="false"]This is the quote I'd like to share[/quotesdlx]

Enable or disable the ability to copy the quote's permalink in the contextual menu.

Can be:

  • true (default)

  • false

A valid permalink for the quote must be specified so that the option appears in the contextual menu.

enable_copy_text

Enable or disable the ability to copy the quote from the contextual menu.

Can be:

  • true (default)

  • false

enable_copy_tweet

Enable or disable the ability to copy the Twitter/X text that will be generated, including permalink and hashtags.

Can be:

  • true (default)

  • false

enable_tweet_this

Enable or disable the ability to Post to Twitter/X from the contextual menu.

Can be:

  • true (default)

  • false

enable_email_text

Enable or disable the ability to email the quote from the contextual menu.

Can be:

  • true

  • false (default)

enable_share_this

Enable or disable the ability to post the quote's URL with Facebook.

Can be:

  • true

  • false (default)

email_text_label

The label for the email button in the contextual menu.

Default: Email Quote

copy_text_label

The label to copy the quote in the contextual menu.

Default: Copy Quote

copy_tweet_label

The label to copy the generated Tweet/Post in the contextual menu.

Default: Copy X Post

The label to copy the quote's permalink in the contextual menu.

Default: Copy Link

tweet_this_label

The label to post to Twitter/X from the contextual menu.

Default: Post This

share_this_label

The label to post to Facebook from the contextual menu.

Default: Share This

enable_citation

Whether to display a citation section for the quote.

Can be:

  • true

  • false (default)

Example usage:

[quotesdlx enable_citation="true" citation_image_url="https://dlxplugins.local/wp-content/uploads/2024/06/headshot.jpg" citation_image_appearance="round" citation_author="Ronald Huereca" citation_title="Web Developer"]This is the quote I'd like to share[/quotesdlx]

enable_citation_image

Whether to display a citation image on the quote for the citation.

Can be:

  • true (default)

  • false

enable_citation_author

Whether to display an author field on the quote for the citation.

Can be:

  • true (default)

  • false

citation_author

The string value that goes into the author field for the quote.

enable_citation_title

Whether to display a title field on the quote for the citation.

Can be:

  • true (default)

  • false

citation_title

The string value that goes into the title field for the citation.

enable_citation_source

Whether to display a third source field where you can leave attribution.

Can be:

  • true

  • false (default)

citation_source

The string value to go into the citation source field.

citation_image_url

The URL to the image used for the citation author.

citation_image_appearance

The appearance of the citation image.

Can be:

  • round (default)

  • square

citation_image_has_border

Whether to add a border around the citation image.

Can be:

  • true (default)

  • false

citation_alignment

The alignment of the citation.

Can be:

  • left (default)

  • center

  • right

Last updated