Tweet This Settings

Most of this plugin’s settings are self-explanatory…  I hope.  If something isn’t obvious about them, let me know so I can improve the settings page.

If something isn’t clear, I have explained in greater detail what the settings are, what they do, and how to use them below.

General Settings

Default Twitter Handles

Do you use a Twitter account with your website?  Maybe your personal account?  One for your business?  Or an account dedicated entirely to your website?  Or all three?

If so, you’ll probably want to draw attention to your Twitter account(s), in addition to your website, whenever Tweet This is used.

Which is why Tweet This supports appending Twitter usernames (A.K.A Twitter handles) to your Tweet This content.

You can manually specify Twitter handles every time you create a Tweet This shortcode.  But that sounds like a pain-in-the-butt to me.

Therefore, I added a method for specifying default Twitter handles.  Unless overridden when creating a shortcode, these Twitter handles will be added to every Twitter post originating from your Tweet This boxes.


Simply type in a comma-separated list of Twitter handles in the Default Twitter Handles settings field.  Be sure to include the @ symbol!


Default Hidden Hashtags

If you want to add hashtags to messages your visitors will tweet, but don’t want them to show in the pretty box on your site, this is the field for you.  It is to hashtags, what Default Twitter Handles is to Twitter handles.

Much like the Twitter handles, these can be manually specified, overridden, or removed when creating each shortcode.  This specifies the default behavior.


Default Hidden URLs

Behaves identically to hidden hashtags, except is used for URLs instead.  If, for any reason, you want to include additional URLs instead of the one to your post, but you don’t want it displayed in the pretty box on your site, this is the field for you.

These can, again, be manually specified, overridden, or removed when creating each shortcode.  This field specifies the default behavior.

One potential use for hidden URLs is to include pictures with tweets.


Twitter Icon


You see that cute little birdy?  Yeah you do.  I can hear you now… “Oh look at that adorable little thing!”

Well, you can replace it.  Maybe you’d prefer a standard Twitter logo.  Or a different color scheme.

Whatever the reason, you can choose the icon by selecting the radio button next to your favorite icon in the Twitter Icon setting.

Once you choose a new icon, all the Tweet This boxes will use that one instead.  Poor little birdy.


Use Shortlink?

Do you use shortlinks with your site?  If not, you probably should.  Long URLs are character hogs on Twitter, and don’t look very appealing to click on.

If you need some help getting started, I’ve written a handy introduction to shortlinks and using them with WordPress.


If you currently, or will in the future, use shortlinks, you can then tell Tweet This to use them.  Just select “Yes” on the Use Shortlink setting.

Every automatically generated link to your content will use shortlinks instead of the normal, full URL.


Disable URLs

If you don’t want automatic URLs in your tweets at all, you can disable automatic URL generation and inclusion here.  Simply choose “Yes.”

Hide Promotional Byline?

Tweet This loves attention.  To this end, it includes a little promotional link with each Tweet This box.


This way, when people inevitably fall in love with your site, and enjoy the Tweet This box, they’ll know where they can get it themselves.

But, I know not every site should have this promotional byline taking up space and drawing attention.  And if that’s your site, you can turn it off.  Simply choose “Yes” on the Hide Promotional Byline setting.  You’ll receive a short plea to reconsider, but the byline will be gone.


If the byline isn’t hurting anything, please leave it there.  Like I said, Tweet This loves attention.  But, if you need it hidden, hide it.


Display Mode

By default, this plugin creates big boxes with your message and links encouraging users to tweet it.  I call this “box” mode.

Box Display Mode

If you’d prefer inline links, you can change to “Button Link” mode which removes the box and puts a simple link in its place.





Box Display Mode Settings

If you use the box display mode, you can customize it’s appearance using settings in this section.


Choose Theme

That default theme is just so pale isn’t it?  It doesn’t really leap out enough.

FUSCIA!  That’s what it needs!  Fuscia!


Well, there’s no fuscia theme right now.  But there are different looks for the Tweet This boxes.  If you find a more suitable one, choose the radio button next to that theme in the Choose Theme setting.

Now all the Tweet This boxes will look like that instead.


If you have an idea for another theme, let me know.  I’ve been trying to find a way to make a fuscia theme not hurt my eyes, and could use a break.


Button Link Display Mode Settings

If you use the button link display mode, you can customize it’s appearance using settings in this section.


Include Twitter Icon in Link

Do you see the little bird next to the link in the picture below?


If you don’t want that to show up, change this setting to “No.”


Shortcode Creator Dialog Settings

This is the default Tweet This Shortcode Creator:

If you want to tweak it, use these settings.

Disable Preview?

If you don’t want or need the grey preview box, choose “Yes” in this setting.  The box will be hidden from then on.


Disable Character Counter?

If you don’t want the character counter above the preview in the image above, choose “Yes” for this setting.  The character counter will no longer show.


Disable Post URL Options?

If you don’t use all the geeky stuff under Post URL Options, you can hide all of it entirely.  Simply choose “Yes” in this setting.  The whole section entitled Post URL Options in the picture above will go away.


Disable Twitter Handle Options?

If you don’t use all the geeky stuff under Twitter Handle Options, you can hide all of it entirely.  Simply choose “Yes” in this setting.  The whole section entitled Twitter Handle Options in the picture above will go away.


Disable Hidden Content Options?

If you don’t use all the geeky stuff under Hidden Content Options, you can hide all of it entirely.  Simply choose “Yes” in this setting.  The whole section entitled Hidden Content Options in the picture above will go away.


Advanced Settings

This section is for more complex options that most of you probably won’t use.  But, the options are there!

Override Button Text

By default, Tweet This’ boxes and inline links say “Tweet This.”  If you’d rather change that, simply input the value you’d rather it say in the text box.  This is useful if your website uses a language other than English, or if you have an irrational hatred of the default phrase.  If you leave this box empty, the default text will be used.


Icon Alt Tag Value

The cute little birdie icon mentioned and pictured earlier is rendered using an HTML <img> tag.  This tag does not have an alt attribute by default.  If you want a value in that alt attribute, specify it here.  This can be useful for accessibility tools like screen readers and text web browsers.


Tweet Element Template

This setting allows you to customize the order all of Tweet This’ elements are placed in, and what separates the various elements.  Details on template structuring and behavior are available in this post: Introducing the Tweet Element Template.  To use the default template, leave this field blank.

Default template:

Read more…


Override CSS

You’re tired of waiting for a fuscia theme right?  You know exactly what shades of pink will make the Tweet This box pop, and you just want to do it.

Well, if you know CSS, you’re welcome to do so.  Simply choose the theme that most closely resembles what you want, and then add your customizing CSS code to the Override CSS box.

I’ll only cry a little when you change my beautiful theme.  Small price to pay for your Fun Fuscia Fanfare theme.


To get you started, a copy of one of the theme’s CSS code is below. (This is only the theme.  Things like color, fonts, sizes, et cetera.  Not the Tweet This Box layout.)  Combine this with liberal use of your web browser’s element inspection tool to make your Fantabulous Fuscia theme.

Once you’ve created your theme, share your creation.  Post a link to a screenshot in the comments.



Leave a Reply

Your email address will not be published. Required fields are marked *