# 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="/pages/Qe8QNIgKlzqXwoQKvAlj" %}
[Available Themes](/quotes-dlx/getting-started/available-themes.md)
{% 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="/files/l1mfo3jbpsLYnbdnIcnY" 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="/files/QgzfEvdrPezYKISbo2yl" 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="/files/fd7bfnTuDhon2qNITsL5" 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="/files/X78ERC2rwj2myrBHbKHV" 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="/files/E8nk2IeoI7HIKwchzU27" 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="/files/FWSlYhfiyGKH1bFcgaN0" 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="/files/yPWXzupU3nbDcYv5eiFC" 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="/files/AW8KzXc4PTzuq77ejoB8" 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="/files/28bqpGvGMDezXS7oHPtt" 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="/files/uwrUcVTsLn7t0huUwhua" 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dlxplugins.com/quotes-dlx/getting-started/shortcode-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
