Login / Status
developer.Resource
Home . Documentation . Document Library . Extension Manuals
Sponsors
hosted by punkt.deTYPO3 and Open Source Magazine

1.5. Configuration

Many of the following settings can be configured using the constants editor:

Reference

General settings

Property:

Data type:

Description:

Default:

title

string

Your blogs name

timtab

tagline

string

A short description for your blog

Blogging with TYPO3

homepage

string

The URL to your blog

homePid

int+

The pid of your homepage

blogPid

int+

The pid where your tt_news SINGLE view of your tt_news plugin resides

clearPageCacheOnUpdate

int

A comma separated list of page ids to clear the FE cache after a post or a comment has been created or modified

Settings for the category menu: (plugin.tx_timtab.displayCatMenu)

   

wrap

wrap

This wrap is required

<ul>|</ul>

targetPid

Int+

Pid for the category links to point to. Set this to make the category menu work!

sortBy

string

A tt_news table field to sort by

title

sortOrder

string

The sorting order: ASC for ascending, DESC for descending

ASC

hideEmpty

boolean

Hides categories with no posts when set

1

list

boolean

Wraps the output in an <ul> unordered list if set

1

showLatestDate

boolean

Shows  the date of the latest post in the current category after the title

0

catLatestDate.strftime

string

Formatting for the date, see http://www.php.net/strftime for options

%d.%m.%G

showCount

boolean

Shows the number of posts in the current category

1

useDescForTitle

boolean

Use the category description for  thelink's title attribute

1

hierarchical

boolean

Whether to render a hierarchical tree list or not

0

[tsref:plugin.tx_timtab]

Gravatar settings

Property:

Data type:

Description:

Default:

rating

string

Rating defines what kind of gravatars you might want to block for your site.

Possible values are: G, PG, R and X. 0 means no rating.

G is suitable for display on all sites.

PG may contain disputably offensive imagery

R things as harsh profanity, intense violence, explicit sexual content, and drug use

X may contain hardcore sexual imagery or extremely disturbing violence

see http://www.gravatar.com/rating.php

0

defaultImg

string

Set this to an URL to an image you want as default image if the person who comments doesn't have a gravatar. You can set it to http://www.yourdomain.com/clear.gif for example.

border

string

Draws a 1px border around the gravatar. Defines the color as HEX color: FF0000

class

string

The css class assigned to the gravatar

size

int+

Defines the size of the displayed gravatar in pixels. Maximum vlaue is 80.

60

[tsref:plugin.tx_timtab.gravatar]

Blogroll settings

Property:

Data type:

Description:

Default:

header_stdWrap

->stdWrap

StdWrap for the header

dontWrapInDiv

boolean

If set to 1 the plugin won't be wrapped in a <div>. Comes in handy when integrating the plugin in an <ul> unordered list.

0

pid_list

int+

Pid to take the blogroll links from when inserting the plugin into your site via TypoScript.

listClass

string

Adds a css class to the <ul> tag of the blogroll

[tsref:plugin.tx_timtab_pi1]

Webservice (XML-RPC) settings

All of these settings ar configurable with the Constants editor.

Property:

Data type:

Description:

Default:

pidStorePosts

int+

The page or sysfolder where your posts from external tools will be saved to.

pidStoreComments

int+

The page or sysfolder where your comments and trackback pings will be saved to.

connectionTimeout

int+

Timeout for XML-RPC Server connections in seconds.

30

enableBlogger

boolean

Enable blogging with external tools which are capable of using the Blogger API.

enableMetaweblog

boolean

Enable blogging with external tools which are capable of using the MetaWeblog API.

strictAPI

boolean

Force the XML-RPC Server to be API compliant instead of behaving the more common way. You might want to set this to 1 if you encounter problems with your blog tool especially with categories.

0

[tsref:plugin.tx_timtab_pi2]

Calendar settings

Property:

Data type:

Description:

Default:

header_stdWrap

->stdWrap

StdWrap for the header

dontWrapInDiv

boolean

If set to 1 the plugin won't be wrapped in a <div>. Comes in handy when integrating the plugin in an <ul> unordered list.

0

pid_list

int+

Pid to take the posts from when inserting the plugin into your site via TypoScript.

targetPid

int+

Pid where you want the links to point to. Set this to make the calendar work!

week_begins

int

Determines the day with that the week starts. = = Sunday, 1 = Monday

1

gmt_offset

int

GMT Offset in hours

0

weedayNameLength

int+

Length of the name of the weekday in the table header

1

[tsref:plugin.tx_timtab_pi3]

New template markers

Tmtab offers you to use some new markers in your tt_news and ve_guestbook templates. Amoung them are markers for inserting the gravatar images or showing the number of comments a post got so far.

Markers for use in tt_news templates

Marker:

Description:

###BLOG_COMMENTS_COUNT###

Displays the number of comments a post got so far. If there are no comments yet instead of displaying a 0 it stays empty.

###BLOG_TEXT_COMMENTS###

If there are no comments it says “No comments”, if there is one comment it says “comment” in singular. For any other case with more than one comment it's he plural “comments”

Usaually you will use this marker in conjunction with BLOG_COMMENTS_COUNT in front of it.

###BLOG_TRACKBACK_RDF###

This produces a piece of RDF code encapsulated in an HTML comment. It is not visually visible but can be found by other blog systems who will determine the URL to send trackback pings to through this.

This marker should be used in tt_news SINGLE view  only.

###BLOG_TRACKBACK_URL###

The Trackback URL. This can be used in <a> anchor tags.

###BLOG_TRACKBACK_LINK###

Links the word “trackback” to the Trackback URL for the current post.

This marker should be used in tt_news SINGLE view  only.

###BLOG_POST_TITLE###

Produces the Permalink to the post with <A> tag attribute rel=”bookmark” and links to SINGLE view.

This marker should be used in tt_news SINGLE view  only.

Markers for use in ve_guestbook templates

Marker:

Description:

###BLOG_FORM_REQUIRED###

By default gets replaced by “(required)” and is supposed to be placed after the required form fields.

###BLOG_NOT_PUBLISHED###

Default is “(will not be published)” and is supposed to be put after the email field if it is required.

###BLOG_LEAVE_REPLY###

By default it is replaced by “Leave a reply”.

###BLOG_NAME###

Replaced by “Name”.

###BLOG_MAIL###

Replaced by “Mail”.

###BLOG_HOMEPAGE###

Replaced by “Website”.

###BLOG_COMMENTS_COUNT###

Gets replaced by the number of comments for the current post.

###BLOG_TEXT_COMMENTS###

If there are no comments it says “No comments”, if there is one comment it says “comment” in singular. For any other case with more than one comment it's he plural “comments”

Usaually you will use this marker in conjunction with BLOG_COMMENTS_COUNT in front of it.

###BLOG_RESPONSES###

Is either singular or plural of “response” reagrding the number of response a post got.

###BLOG_POST_TITLE###

Is the title of the current post.

###BLOG_COMMENT_GRAVATAR###

Adds the gravatar image to the comment if any is returned otherwise the configured default image is displayed.

###BLOG_COMMENTER_NAME###

The name of the person who left the comment.

###BLOG_COMMENT_NUM###

Gives the comment a number starting with 1 for the first increasing by 1 for each comment. That makes it possible to give each comment an anchor or just displaying it to the visitors.

###BLOG_REMEMBER_YES###

Will be replaced by “yes” and should be placed besides the radio button for remembering the visitors informaton.

###BLOG_REMEMBER_NO###

Is equivalent to the previous marker but displaying “no”.

###BLOG_REMEMBER_VISITOR###

The label for the radio buttons to remember the visitors information. If he checks yes the name, email and homepage will be saved in a cookie. The cookie has a lifetime of 90 days. So if the visitor comes back within these 90 days he doesn't have to type in his information again and can just start commenting right away.

###BLOG_TRACKBACK_URL###

The Trackback URL. This can be used in <a> anchor tags.