DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

FAQ¶

Within this page

Some links are broken, i.e. categories, archive or rss ¶

Check if plugin.tx_t3extblog.settings.blogsystem.pid is set right (see Installation, 4.).

RSS Output instead of page ¶

Remove static template T3Extblog: Rss setup (t3extblog). It should only be included on a seperate rss-page.

Add canonical tag to pae header ¶

Use following TS config:

[globalVar = GP:tx_t3extblog_blogsystem|post > 0]
        page.headerData.123 {
           wrap = <link rel="canonical" href="|">
 htmlSpecialChars = 1

 typolink {
    parameter.data = TSFE:id
    forceAbsoluteUrl = 1
    returnLast = url
    additionalParams.cObject = COA
    additionalParams.cObject {
       10 = TEXT
       10.dataWrap = &tx_t3extblog_blogsystem[controller]=Post&tx_t3extblog_blogsystem[action]=show&tx_t3extblog_blogsystem[post]={GP:tx_t3extblog_blogsystem|post}&tx_t3extblog_blogsystem[year]={GP:tx_t3extblog_blogsystem|year}&tx_t3extblog_blogsystem[month]={GP:tx_t3extblog_blogsystem|month}&tx_t3extblog_blogsystem[day]={GP:tx_t3extblog_blogsystem|day}
       10.if.isTrue.data = GP:tx_t3extblog_blogsystem|post
    }
 }
        }
[global]

Does it work together with “indexed search engine”?¶

Yes! T3extblog works together with “indexed search engine”. Once your posts are indexed, your visitors can search through all your posts. Your sould restrict indexing to the main content (blogposts) and exclude latest posts, the categorie module etc. to get usefull results.

Can I override the basic templates?¶

Copy the template files (t3extblogResourcesPrivateSetLayouts +Partials +Templates) in your fileadmin or custom extension and set the path via TS or constant editor.

See Configuration for code snippets!

Does it work with dd_googlesitemap?¶

Yes! Use this syntax: ?eID=dd_googlesitemap&sitemap=t3extblog&pidList=123 (where 123 is your storage folder page id). Add an optional ‘limit’ parameter for very large blogs. Example: &limit=100.

Tip

Since google supports RSS-Feeds, we recommend to use this solution!

Filtering tags doesn’t work?¶

To avoid filling the cache with not existing pages, the filter only works with tags => 3 letters.

Link handler configuration ¶

Since TYPO3 8.7 a built in link handler is integrated into the core. See here for more info: https://docs.typo3.org/typo3cms/extensions/core/Changelog/8.6/Feature-79626-IntegrateRecordLinkHandler.html

Example page TSconfig configuration:

TCEMAIN.linkHandler {
   tx_t3blog_post {
       handler = TYPO3\CMS\Recordlist\LinkHandler\RecordLinkHandler
       label = Blog-Post
       configuration {
           table = tx_t3blog_post
           storagePid = 123
           hidePageTree = 1
       }
       scanAfter = page
   }
   tx_t3blog_cat {
       handler = TYPO3\CMS\Recordlist\LinkHandler\RecordLinkHandler
       label = Blog-Category
       configuration {
           table = tx_t3blog_cat
           storagePid = 123
           hidePageTree = 1
       }
       scanAfter = page
   }
}

Corresponding TypoScript configuration:

config.recordLinks {
   tx_t3blog_post {
      typolink {
         parameter = 456
         additionalParams.cObject = COA
         additionalParams.cObject {
            10 = TEXT
            10 {
               date = d
               field = date
               wrap = &tx_t3extblog_blogsystem[day]=|
            }
            20 = TEXT
            20 {
               date = m
               field = date
               wrap = &tx_t3extblog_blogsystem[month]=|
            }
            30 = TEXT
            30 {
               date = Y
               field = date
               wrap = &tx_t3extblog_blogsystem[year]=|
            }
            40 = TEXT
            40.dataWrap = &tx_t3extblog_blogsystem[post]={field:uid}
         }
         title.field = title
         useCacheHash = 1
      }
   }
   tx_t3blog_cat {
      typolink {
         parameter = 456
         additionalParams = &tx_t3extblog_blogsystem[category]={field:uid}
         additionalParams.insertData = 1
         useCacheHash = 1
      }
   }
}

Replace 123 with your storage PID and 456 with the PID of your blogsystem plugin page.

Set default post category ¶

Add this to the page or user TSconfig:

TCAdefaults {
        tx_t3blog_post {
                # CSV of category UIDs
                cat = 1,2,3

                # Works for other fields too!
                hidden = 0
        }
}

Disable post fields ¶

Add something similar to the page or user TSconfig:

TCEFORM.tx_t3blog_post {
        # Just some examples...
        hidden.disabled = 1
        starttime.disabled = 1
        endtime.disabled = 1

        preview_mode.disabled = 1
        preview_text.disabled = 1
}

Hint

Do not hide the date field as it’s needed for sorting!

Translation / Localization ¶

Localization works like for any other TYPO3 extension:

plugin.tx_t3extblog._LOCAL_LANG {
        en {
                comment.human = Please confirm!
        }
}

Adding localizations

Feel free to add new localization!

TYPO3 Pootle project: http://translation.typo3.org/projects/TYPO3.TYPO3.ext.t3extblog/

More information about TYPO3 translation server: https://wiki.typo3.org/Translations

Clear frontend cache ¶

Since version 2.2.0 this extension makes use of cache tags. The following cache tags are available:

tx_t3extblog
tx_t3extblog_PID
tx_t3blog_post_uid_UID
tx_t3blog_post_pid_PID
tx_t3blog_com_pid_PID
tx_t3blog_cat_pid_PID

PID = page uid, UID = record uid

Cache tags are cleared by a built-in functionality when a record is modified or created in backend and frontend.

This works by adding cache tags for each page rendered with a t3extblog plugin. Each time a blog record is edited, deleted or created, this cache entry is flushed. No additional cache configuration is needed.

It’s still possible to use TS config for adjusting the cache behaviour. This could be basic configuration (see below) or using a more advanced tag approach:

# Flushes all blog related caches
TCEMAIN.clearCacheCmd = cacheTag:tx_t3extblog

# Flushes cache for all records in page with UID 123
TCEMAIN.clearCacheCmd = cacheTag:tx_t3extblog_123

Before version 2.2.0 ¶

When a frontend user adds a new comment the blogsystem plugin page cache is cleared using default TYPO3 extbase functionality.

When editing records in backend (for example posts or comments) as a non admin user the cache needs to be cleared manually or by using page TS config:

# PIDs of page which need to be cleared
TCEMAIN.clearCacheCmd = 123,456,789

The code needs to be added to the sys folder where the blog records are edited.

Hint

The mentioned TCEMAIN settings are part of the TYPO3 core and can be used therefore not only for the t3extblog extension.

<f:if condition="{nextPost.linkParameter}">
        <f:then>
                <f:link.action controller="Post" action="show" pageUid="{settings.blogsystem.pid}" arguments="{nextPost.linkParameter}"> &lt; {nextPost.title} </f:link.action>
        </f:then>
</f:if>
<f:if condition="{previousPost.linkParameter}">
        <f:then>
                <f:link.action controller="Post" action="show" pageUid="{settings.blogsystem.pid}" arguments="{previousPost.linkParameter}"> {previousPost.title} &gt; </f:link.action>
        </f:then>
</f:if>

FAQ¶

Some links are broken, i.e. categories, archive or rss ¶

RSS Output instead of page ¶

Link RSS in page header ¶

Add canonical tag to pae header ¶

Does it work together with “indexed search engine”?¶

Can I override the basic templates?¶

Does it work with dd_googlesitemap?¶

Filtering tags doesn’t work?¶

Link handler configuration ¶

Set default post category ¶

Disable post fields ¶

Translation / Localization ¶

Clear frontend cache ¶

Before version 2.2.0 ¶

Some output tweaks ¶

Category-Module ¶

Add number of articles per category ¶

Detail-View (Show post)¶

Add prev/next-function ¶

TYPO3 CMS legacy support ¶

Version 7.x ¶

Version 6.0 - 6.2 ¶

Version 4.5 - 4.7 ¶