Creating a WP Quote Tweets template

Version 2.0 and up of the WP Quote Tweets plugin supports Tweet templates. You can easily create your own custom template to match your site’s layout and style.

Rules for creating a WP Quote Tweets template

  • A tweet template has its own folder under the /templates/ subfolder or the /wp-content/{CurrentTheme}/wpqt/ folder
  • All templates folders have a .template.html file, a .CSS file (even if it’s empty) and a .PNG file (screenshot of the template in action)
  • The name of the folder is the name of all else.
    Example:
    Path to your template:
    /wp-quote-tweets/templates/MyTemplateName/
    Your template file must be called:
    MyTemplateName.template.html
    Your CSS must be called:
    MyTemplateName.css
  • Your PNG must be called:
    MyTemplateName.png

You can include the dynamic tweet data in your templates by using the variables shown below. Some variables are pre-formatted, but most are returned as twitter provides them.

%TWEET_URL%Renders the full URL to the tweet
%REPLY_TO_LINK%Renders a link to twitter where you can reply to the tweet.(Text of the link is “Reply”)
%RETWEET_LINK%Renders a link to twitter where the contents of the tweet are ready to be re-tweeted.
%USER_PICTURE_LINK%Renders a link to the profile of the person that made the tweet with the tweeters picture
%PROFILE_LINK%Renders a link to the profile of the person that made the tweet.
%TIMESTAMP_LINK%Creates a link to the original tweet on Twitter.com with the date of the tweet as text.
%IN_REPLY_TO_LINK%If the tweet is a reply to another tweet, this will render a link to the original tweet that was replied to (Text is ” in reply to [name]“). If the tweet is not a reply, it will render nothing.
%CREATED_AT%Renders tweet date as returned from Twitter.
%TWEET_ID%Renders the ID of the tweet
%TWEET_TEXT%Renders the text of the tweet (URL’s and hash tags are formatted to be links)
%FROM_LINK%Renders the source of the tweet (“web”, “TweetDeck”, etc..). Note that this is usually a link.
%IN_REPLY_TO_STATUS_ID%
%IN_REPLY_TO_USER_ID%
%IN_REPLY_TO_SCREEN_NAME%
%USER_ID%
%USER_NAME%
%USER_SCREENNAME%
%USER_LOCATION%
%USER_DESCRIPTION%
%USER_PROFILE_IMAGE_URL%
%USER_URL%
%USER_FOLLOWERS_COUNT%
%USER_PROFILE_BACKGROUND_COLOR%
%USER_PROFILE_TEXT_COLOR%
%USER_PROFILE_LINK_COLOR%
%USER_PROFILE_SIDEBAR_FILL_COLOR%
%USER_PROFILE_SIDEBAR_BORDER_COLOR%
%USER_FRIEND_COUNT%
%USER_CREATED_AT%
%USER_FAVOURITES_COUNT%
%USER_UTC_OFFSET%
%USER_TIME_ZONE%
%USER_PROFILE_BACKGROUND_IMAGE_URL%
%USER_STATUSES_COUNT%
%CSS_USER_BACKGROUND%Renders the user’s background properties in CSS format(Example: "background:#aaf url(http://tanin.nl/tanin2.png) top left no-repeat")

If you’re not sure what a variable in this list does you may also want to check out Twitter’s API documentation.

If you would like to include your templates in the next version of this plugin, let me know and I’ll add it to the next build.

Have fun!

Related Posts