Twitt Theme Documentation.

Twitt's theme engine is made to be extremely powerful, yet allow for quick creation and easy customization of themes.

Don't forget to submit you themes to the repository. Just send an email to hello@twittapp.com with the theme attached.
Advanced Tip: If you need to create a static link to be opened in the users default browser, prefix the link with twitt:link&URL=. This will tell Twitt to open it in a browser.

Files

Please note: none of these files are required, but your theme will suffer the consequences.

header.html

Use this file to set anything up that should span the entire page of content. Use footer.html to close what what remains open.

Accepted insertables: none.

notice.html

Used when Twitter returns an error that Twitt needs to notify the user about.

Accepted insertables: (noticeContent).

tweet.html

A normal tweet.

Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetIndicator), (undoReiterated), (replyToDirectMessage).

reply.html

A tweet beginning with an @, but not containing the user's username.

Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetIndicator), (undoReiterated), (replyToDirectMessage), (conversationIndicator).

mention.html

A tweet containing the user's username.

Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetIndicator), (undoReiterated), (replyToDirectMessage), (conversationIndicator).

directmessage.html

A direct message.

Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetIndicator), (undoReiterated), (replyToDirectMessage).

retweet.html

An official retweet.

Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetedBy), (retweetedByAvatar), (retweetIndicator), (undoReiterated), (replyToDirectMessage), (conversationIndicator).

self.html

A tweet from the user.

Accepted insertables: (realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetIndicator), (undoReiterated), (replyToDirectMessage), (conversationIndicator).

favorite.html

Inserted when (favorited) is found and the tweet should be favorited.

Accepted insertables: (favorited), (updateFavoritedStatus).

unfavorite.html

Inserted when (favorited) is found and the tweet should be unfavorited.

Accepted insertables: (favorited), (updateFavoritedStatus).

reiteratetoggle.html

Inserted when (reiterateToggle) is found. Show when the user can retweet an update.

Hidden if update has been retweeted by the user.

Accepted insertables: (reiterate).

retweetindicator.html

Inserted when (retweetIndicator) is found. Use to indicate when an update has already been retweeted by the user.

Hidden unless the update has been retweeted by the user.

Tip: Use (undoReiterated) as a 'href' to allow the user to undo a retweet.

Accepted insertables: (undoReiterated).

conversationIndicator.html

Inserted when (conversationIndicator) is found.

Hidden if there is no in-reply-to date.

Accepted insertables: (conversationWithUser), (viewConversation).

footer.html

Use this file to close anything setup in header.html as well as anything that should appear at the bottom of the content.

Accepted insertables: none.

archive.html

Used when the user has "Differentiate archived content" checked.

Accepted insertables: (archive).

(realName), (updateContent), (favorited), (updateFavoritedStatus), (postedTime), (screenName), (avatarURL), (updatePermalink), (twitterUserPage), (replyToUser), (replyToTweet), (reiterate), (retweetedBy), (retweetIndicator), (undoReiterated), (replyToDirectMessage).

Insertables


(realName)

Real name of user.

(updateContent)

Contents of an update.

(postedTime)

Localized time for when the update was posted.

(screenName)

Screen name of user.

(avatarURL)

Inserts: URL.
Direct URL to the user picture.

(updatePermalink)

Inserts: URL.
Permanent link to the update.

(twitterUserPage)

Inserts: URL.
Link to twitter.com/User.

(replyToUser)

Inserts: Action URL.
Autofills a new reply to the user.

(replyToTweet)

Inserts: Action URL.
Autofills a reply to a specific tweet from a specific user (so it will show up as "in reply to".

(replyToDirectMessage)

Inserts: Action URL.
Autofills "d username".

(favorited)

Inserts: Insert point for code.
Inserts the code located in favorite.html or unfavorite.html, depending on wether the update is already favorited.

(updateFavoritedStatus)

Inserts: Action URL.
Inverts the favorite status of selected update (i.e. if the updated is already favorited, it unfavorites it).

(reiterate)

Inserts: Action URL.
Reiterate this tweet. Based off the user's preference, will use official method first or will fill update box with the message (formatted based on the preference).

(retweetedBy)

Inserts the username (with @) of the user who retweeted given update.

(retweetedByAvatar)

Inserts: URL.
Direct URL to the avatar of the user who retweeted this update.

(reiterateToggle)

Inserts: Action URL.
Inserts code found in reiteratetoggle.html. See reiteratetoggle.html.

(retweetIndicator)

Inserts: Insert point for code.
Inserts code found in retweetindicator.html. See retweetIndicator.html.

(undoReiterated)

Inserts: Action URL.
Inserts an 'href' that destroys the given retweet.

(conversationIndicator)

Inserts: Insert point for code.
Used to indicate when a tweet is in reply to another tweet. Inserts the code located in conversationIndicator.html.

(conversationUser)

Inserts: Insert point for code.
The username of the author of the tweet that reply is to.

(viewConversation)

Inserts: Action URL.
Inserts a link to the tweet that is replied to.

(archive)

Inserts: Archived Update.
Indicates where archived content should be inserted.
© 2010 Dan Deming-Henes. All rights reserved worldwide.