# Shortcode Parameters

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

Here's a sample shortcode.

{% code overflow="wrap" %}

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

{% endcode %}

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

{% content-ref url="available-themes" %}
[available-themes](https://docs.dlxplugins.com/quotes-dlx/getting-started/available-themes)
{% endcontent-ref %}

Example usage:

{% code overflow="wrap" %}

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

{% endcode %}

<figure><img src="https://1948389296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fWeIf0dD55hk2b9Gqjx%2Fuploads%2FeoIyBc1hjdXoCInQgTGz%2Fdlx-000506%402x.jpg?alt=media&#x26;token=98422234-1e84-4241-a29e-e84293bc3be1" alt=""><figcaption><p>Bubble Gum Theme</p></figcaption></figure>

### 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:

{% code overflow="wrap" %}

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

{% endcode %}

### hashtags

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

Example usage:

{% code overflow="wrap" %}

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

{% endcode %}

### share\_button\_text

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

Example usage:

{% code overflow="wrap" %}

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

{% endcode %}

<figure><img src="https://1948389296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fWeIf0dD55hk2b9Gqjx%2Fuploads%2FZYL17Nv8QR8M7bYaIYVq%2Fdlx-000502%402x.jpg?alt=media&#x26;token=cf0abdda-615d-450b-87e0-9f7110dc7d59" alt=""><figcaption><p>Quote with Custom X Button Label</p></figcaption></figure>

### facebook\_share\_button\_text

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

<figure><img src="https://1948389296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fWeIf0dD55hk2b9Gqjx%2Fuploads%2Fj0EKqwLFUn4hyk92TIIY%2Fdlx-000503%402x.jpg?alt=media&#x26;token=cd83a22c-a58e-4866-b20f-c415d408024e" alt=""><figcaption><p>Facebook Share Label Example</p></figcaption></figure>

{% code overflow="wrap" %}

```
[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]
```

{% endcode %}

{% hint style="danger" %}
For a Facebook button to show, you need to set `facebook_button_enabled` to `true`.
{% endhint %}

### twitter\_username

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

Example usage:

{% code overflow="wrap" %}

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

{% endcode %}

### tweet\_button\_alignment

This argument controls the overall alignment of the share buttons.

Can be:

* left
* center
* right (default)

Example usage:&#x20;

{% code overflow="wrap" %}

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

{% endcode %}

<figure><img src="https://1948389296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fWeIf0dD55hk2b9Gqjx%2Fuploads%2FUtTa5x4VmmSvQfSmpRW8%2Fdlx-000504%402x.jpg?alt=media&#x26;token=0d19498e-1781-40f7-a582-6e242196d10d" alt=""><figcaption><p>Left Aligned Twitter Button</p></figcaption></figure>

### tweet\_icon\_alignment

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

Can be:

* left
* center
* right (default)

Example usage:&#x20;

{% code overflow="wrap" %}

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

{% endcode %}

<figure><img src="https://1948389296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fWeIf0dD55hk2b9Gqjx%2Fuploads%2Fh3cssahzVWEmayQyvGaT%2Fdlx-000505%402x.jpg?alt=media&#x26;token=7eb949d0-ebb0-4322-9fcd-14b20830894f" alt=""><figcaption><p>Left Aligned Icon</p></figcaption></figure>

### tweet\_button\_enabled

Hide the Twitter button by setting this to false.

Can be:

* true (default)
* false

Example usage (only show Facebook):

{% code overflow="wrap" %}

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

{% endcode %}

<figure><img src="https://1948389296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fWeIf0dD55hk2b9Gqjx%2Fuploads%2FEiBLNlBDHAtCv5lGyDpU%2Fdlx-000507%402x.jpg?alt=media&#x26;token=1a9c5709-c363-47a5-92c0-86ac234ad40e" alt=""><figcaption><p>Example With Facebook Enabled, and Twitter disabled</p></figcaption></figure>

### facebook\_button\_enabled

Enable the Facebook button in the quote.

Can be:

* true
* false (default)

Example usage:

{% code overflow="wrap" %}

```
[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]
```

{% endcode %}

### tweet\_button\_display

Determine how the sharing buttons look.

Can be:

* full (default)
* icon (icons only)
* text (text only)

Example usage:

{% code overflow="wrap" %}

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

{% endcode %}

<figure><img src="https://1948389296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fWeIf0dD55hk2b9Gqjx%2Fuploads%2FQrzQvghJAOBFI2WUgxF6%2Fdlx-000508%402x.jpg?alt=media&#x26;token=fe2a244d-9128-485a-9414-80d1a86bb7bf" alt=""><figcaption><p>Icons Only View of the Quote</p></figcaption></figure>

### icon\_appearance

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

Can be:

* button (default)
* transparent

{% hint style="warning" %}
The argument `tweet_button_display` must be set to `icon for a button to be transparent.`
{% endhint %}

Example usage:

{% code overflow="wrap" %}

```
[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]
```

{% endcode %}

<figure><img src="https://1948389296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fWeIf0dD55hk2b9Gqjx%2Fuploads%2FzBLVI3n1goY36M0EaxoJ%2Fdlx-000509%402x.jpg?alt=media&#x26;token=0858a861-fda6-45ba-9a04-e84e22cdffa0" alt=""><figcaption><p>Icons Only View With Transparent Buttons</p></figcaption></figure>

### maximum\_width

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

Example usage:

{% code overflow="wrap" %}

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

{% endcode %}

### maximum\_width\_unit

Set the unit for the max-width:

Can be:

* vh
* vw
* px (default)
* em
* rem

Example usage:

{% code overflow="wrap" %}

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

{% endcode %}

### align

The overall alignment of the Quote container.

Can be:

* left
* center (default)
* right
* wide
* full

Example usage:

{% code overflow="wrap" %}

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

{% endcode %}

### 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.

{% hint style="danger" %}
The shortcode argument `has_anchor` must be set to true and `enable_links_in_tweet` must be true.
{% endhint %}

Example usage:

{% code overflow="wrap" %}

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

{% endcode %}

This would result in a URL like:

{% code overflow="wrap" %}

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

{% endcode %}

### enable\_links\_in\_tweet

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

Can be:

* true (default)
* false

Example usage:

{% code overflow="wrap" %}

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

{% endcode %}

### 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

{% hint style="danger" %}
Bitly and Jetpack are separate plugins, so you'll need to install and configure those for shortlinks.
{% endhint %}

### manual\_permalink

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

{% hint style="danger" %}
The `url_shortening_service` must be `manual` for manual permalinks to work.
{% endhint %}

Example usage:

{% code overflow="wrap" %}

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

{% endcode %}

### enable\_contextual\_menu

Enable or disable the meatball contextual menu.

<figure><img src="https://1948389296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fWeIf0dD55hk2b9Gqjx%2Fuploads%2FIMSLIOiX57IFwYyx5xsH%2Fdlx-000510%402x.jpg?alt=media&#x26;token=9bd3721f-2dcc-4011-b9df-9056d3121720" alt=""><figcaption><p>Contextual Menu Displaying on the Quote</p></figcaption></figure>

Can be:

* true (default)
* false

{% hint style="danger" %}
Global contextual menu settings will override this value.
{% endhint %}

{% code overflow="wrap" %}

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

{% endcode %}

### enable\_copy\_link

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

Can be:

* true (default)
* false

{% hint style="danger" %}
A valid permalink for the quote must be specified so that the option appears in the contextual menu.
{% endhint %}

### 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

### copy\_link\_label

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

<figure><img src="https://1948389296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0fWeIf0dD55hk2b9Gqjx%2Fuploads%2FNdJZpWOvPr2BpzBVfilh%2Fdlx-000511%402x.jpg?alt=media&#x26;token=9922d321-1071-48cd-a1fb-a0aee85ce3aa" alt=""><figcaption><p>Sample Citation On a Quote</p></figcaption></figure>

Whether to display a citation section for the quote.

Can be:

* true
* false (default)

Example usage:

{% code overflow="wrap" %}

```
[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]
```

{% endcode %}

### 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