EXT: TIMTAB Weblog¶

What does it do?¶

- timtab is mainly a framework extension which connects other extensions, namely tt_news, ve_guestbook (modern guestbook) and realurl to use TYPO3 for blogging. You will use tt_news to post, your visitors can comment these posts with ve_guestbook and realurl delivers nice URLs. There will be 'optimal' default configurationsf or these extensions so you can start blogging (nearly) right away. Further this extension ships with the beautiful wordpress default template 'Kubrick'. With this template it is possible to set up a blog within a few clicks.

Requirements¶

TYPO3 3.8.0css_styled_contenttt_news 2.2.0ve_guestbook 1.7.5not required but recommended: realurl

Screenshots¶

Included template “Kubrick”

additional fields for a blog post in a tt_news record

Credits¶

Thanks to Kasper Skårhøj for TYPO3!

Thanks to Rupert Germann for the awesome work on tt_news.

Valery Romanchev who provided the first patch for modern guestbook to use it as commenting system for tt_news.

Udo von Eynern as author of modern guestbook who integrated some hooks and patches in modern guestbook we are using.

Thanks to Micheal Stucki for all his help and support so far.

Last but not least a thanks goes to Ingo Schommer for the initial implementation of the metaweblog API.

Sponsors¶

Thanks to Gerald Fränkl, Michael Janssen and Jens Schaller for the books and cds!

Donate¶

If you enjoy using this extension and/or would like to see it enhanced, please donate a buck or two ... or fifty. I will use the money to keep my development hardware and software updated. If I had a girlfriend I would buy her dinner so she lets keep me working on this stuff for free and doesn't comlain.

`Make a Donation <https://www.paypal.com/cgi- bin/webscr?cmd=_xclick&business=contact@ingo- renner.com&item_name=TIMTAB&no_shipping=1&return=http://www.ingo- renner.com/index.php?id=22&cancel_return=http://www.ingo- renner.com/index.php?id=23&no_note=1&tax=0&currency_code=EUR&bn=PP- DonationsBF&charset=UTF-8>`_

You can also check my amazon wishlist if you don't like making donations via paypal.

An example page tree¶

All of the following examples and explainations will be based on this example tree:

Setting up a blog using the included template “Kubrick”¶

Go to our homepage [1] and create a main template record on the same page. Here you select from the right box “Include static (from extension)” the templates like shown in the screenshot below and in that order.

Next step is to insert two instances of Modern Guestbook on page [2]. One for the comments listing and one for the form. As Modern Guestbook can not be inserted via TS you have to do it manualy:

The last thing left is to set some options in the constants editor. To do this go to Template [1] --> page where you want to store the settings [2] --> Constants Editor [3] --> PLUGIN.TX_TIMTAB [4].

In our example we would set the following options:

required settings (timtab)

pid to store posts in: 6 pid to store comments in: 7 Blog pid: 2 Home pid: 1 Blog homepage: http://www.example.com

required settings (tt_news)

backPid: 1 pid_list: 6 catSelectorTargetPid: 1

required settings (ve_guestbook)

templateFile = {$page.file.template_ve_guestbook}

recommended settings (timtab)

Title, Tagline

recommended settings (ve_guestbook)

limit = 1000

Blogroll settings (timtab)

To make the Blogroll work you need to set plugin.tx_timtab_pi1.pid_list. (Set it to 8 for our example.

That's it – we're done! Wasn't that fast?

Setting up a blog in general without using the themes¶

Just create a website however you like. After installing tt_news, ve_guestbook and timtab you can use some additional markers in your tt_news and ve_guestbook templates. You can find a list of available markers further done in this manual.

»Simply create templates for tt_news and ve_guestbook like always. Just add the additional markers to the templates! «

Creating a blog post¶

Simply create a regular tt_news record and switch the type to “Blog Post”

Trackbacks¶

Trackbacks will be discovered automaticly when saving a new post. Timtab is searching for trackback enabled sites every time you change the bodytext field . Simply link to a post using its regular URL or Permalink. If the other site supports trackback autodiscovery timtab will find the trackback URL itself and ping the other site. If the other site doesn't support trackback autodiscovery you can still put the trackback URL s in the trackback field, one per line.

After timtab has sent the pings you will see the results in the trackback field devided by a pipe character after the ping URL:

• 1 stands for a successfull ping
• 0 means that there was an error and will be followed by the according error message.

More on trackback and what it is: http://en.wikipedia.org/wiki/TrackBack

A Note on Trackbacks:

When using xhtml_cleaning in order to make it possible for other blogs to discover your trackback URLs automaticly it is necessary to patch a core file. The needed patch is provided in typo3conf/ext/timtab/res/patches. Use that patch against t3lib/class.t3lib_parsehtml.php. Fo those who on't know how to do this there's also a ready patched file available from my homepage . Both the patch and the patched file are for TYPO3 3.8.0!An alternative is to turn off xhtml_cleaning.

Blogging with external tools¶

Before you can start bloggging with external tools it is necessary to set the Webservice (XML-RPC) settings. See the reference further down on this. Set the PIDs where you want the posts stored and enable the API you want to use.

Your blog accepts XML-RPC requests on http://www.example.com/index.php?type=200

Use an existing BE username/password to login.

[Example on how to set up w.bloggar goes here]

FAQ¶

- Possible FAQs

Installation¶

Timtab requires TYPO3 version 3.8.0 as it uses some features which have been introduced in this version.

Before you can install timtab it is required to have the following extensions in the given versions:

Activation of Webservice – XML-RPC Interface¶

Todo: add description on how to set up the webservice

Trackback SPAM protection¶

Since version 0.5.10 TIMTAB has a basic feature to prevent Trackback Spam. When receiving a Trackback TIMTAB fetches the sending URL and checks its content for a link to your own site. If no such link is found the Trackback Ping is considered Spam.

This feature is turned on by default. You can turn it of by setting

plugin.tx_timtab_pi2.trackback.validate = 0

After TIMTAB decided that a ping is Spam several things can be done with it. Default is to mark it hidden. Alternatively you can mark it as deleted, prevent TIMTAB from saving the ping at all or simply do nothing. The action is defined by the value for

plugin.tx_timtab_pi2.trackback.spam.mark (see table below for values and corresponding actions)

FAQ¶

- Possible subsections: FAQ

Reference¶

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.