EXT: typo3_blog¶

What does it do?¶

• This extension provides blog functionality for Typo3 and we have included several widgets and a new page doktype “Blog Category”. All pages with this doktype will be rendered with the blogList widget. All pages with the doktype “Standard” will also be rendered with the blogSingle widget. You can use all content elements in your blog entries.
• The blog is managed only in Typo3 pagetree. This is very easy.
• You can add more functionality with other Typo3 extension. You can use ext:comments for comments, ext:vge_tagcloud for a tagcloud, ext:form4_pages_rss for RSS Feed

Screenshots¶

Generall¶

• This extension has the Typo3 multilanguage support.
• From the page you can use the “publish date” and the “expiration date”.
• realurl support
• You can change the create datetime of your blog entries

Blog start page¶

• Create first a new page in your pagetree and change the doktype to “Blog Category”. This is the blog start page. The blog start page display a list with all blog entries.
• The blog start page is rendered with the blogList widget.

Blog categories¶

• Create new pages below the blog start page and change the doktype to “Blog Category”. All pages with this doktype will be rendered as bloglist and displayed a list with blog entry only for this category.
• Each page with the page doktype “Blog Category” will be rendered with the blogList widget.

Blog entry¶

• Create a new page with the doktype “Standard” below a blog category page. The blog entry page belongs to this blog category page. You can change the blog settings in the “Blog Settings” Tab. You must edit this page to change the blog settings.
• You can add all content elements on this page.

Blog Settings¶

• Add the author name. Select your name in the “ Author ” select menu. This menu contains the backend users. Please set your name in the “User Settings”
• You can enable or disable comments for this page in “ Allow comments on blog page ”. If you have installed the commtens extension or disqus comment service.
• Set the create datetime . The default is the page create datetime
• Set tags on blog page for a tagcloud. You can render the tagcloud with the vge_tagcloud extension.
• Exclude page to render this page with css_styled_content. You can use this feature to display a search result.
• You can select a blogroll item to display this item on your blog entry page.

FAQ¶

Possible subsections: FAQ

Adding TypoScript Template¶

• Create a new extension template on the blog start page to integrate a blog in a existing Site.
• Add the extension TypoScript “Typo3Blog Setup (typo3_blog)” and the extension TypoScript “Page browser (pagebrowse)” to this template. Please set the correct order.
• Go into the “Constant Editor” on this template and select the category “PLUGIN.TYPO3BLOG: Basic” and set the “Start Pid”. The Start Pid is the page id from the blog start page.

FAQ¶

blogList Widget¶

Please look at the TypoScript configuration EXT:typo3_blog/widgets/bloglist/setup.txt and the template file EXT:typo3_blog/widgets/bloglist/template.html

TypoScript:

plugin.tx_typo3blog_pi1 {
  blogList = USER_INT
  blogList {
    includeLibs = EXT:typo3_blog/widgets/bloglist/class.tx_typo3blog_widget_bloglist.php
    userFunc = tx_typo3blog_widget_bloglist->main
  ...
  }
}

baseWrap {
  outerWrap = <div class="tx-typo3blog-pi1"> | </div>
}

marker {
  ...
  title = TEXT
  title {
    wrap = |
    field = title
    typolink {
      parameter.dataWrap = {field:uid}
      title.field = subtitle // title
      useCacheHash = 1
    }
  }

  tx_typo3blog_create_datetime = TEXT
  tx_typo3blog_create_datetime {
    field = tx_typo3blog_create_datetime
    strftime = {$plugin.tx_typo3blog_pi1.dateFromat}
    wrap = <li> | </li>
    required = 1
  }
  ...
}

marker {
  ...
  pagecontent = COA
  pagecontent {
    10 = CONTENT
    10.table = tt_content
    10.select.pidInList.dataWrap = {field:uid}
    10.select.where = colPos=0
    10.select.max = {$plugin.tx_typo3blog_pi1.blogList.contentItemsToDisplay}
     10.select.languageField = sys_language_uid
  }
  ...
}

blogSingle Widget¶

Please look at the TypoScript configuration EXT:typo3_blog/widgets/blogsingle/setup.txt and the template file EXT:typo3_blog/widgets/blogsingle/template.html

TypoScript:

plugin.tx_typo3blog_pi1 {
  blogSingle = USER
  blogSingle {
    includeLibs = EXT:typo3_blog/widgets/blogsingle/class.tx_typo3blog_widget_blogsingle.php
    userFunc = tx_typo3blog_widget_blogsingle->main
    ...
  }
}

baseWrap {
  outerWrap = <div class="tx-typo3blog-pi1"> | </div>
}

singleNav = HMENU
singleNav {
  special = browse
  special {
    items = prev|up|next
    items.prevnextToSection =
    prev.fields.data = page:title
    up.fields.data = page:title
    next.fields.data = page:title
  }
  1 = TMENU
  1.wrap = <ul>|</ul>
  1.alternativeSortingField = tx_typo3blog_create_datetime desc
  1.NO {
    linkWrap = <li>|</li>
    stdWrap.htmlSpecialChars = 1
    ATagTitle.field = subtitle // title
  }
}

marker {
  ...
  title = TEXT
  title {
    wrap = <h2>|</h2>
    field = title
  }

  tx_typo3blog_create_datetime = TEXT
  tx_typo3blog_create_datetime {
    field = tx_typo3blog_create_datetime
    strftime = {$plugin.tx_typo3blog_pi1.dateFromat}
    wrap = <li> | </li>
    required = 1
  }

  gravatar = TEXT
  gravatar {
    field = be_user_email_secure
    dataWrap = <img src="http://www.gravatar.com/avatar/|.jpg?s=100" alt="{field:be_user_realName}" />
    required = 1
  }
   ...
}

marker {
  ...
  gravatar = TEXT
  gravatar {
    field = be_user_email_secure
    dataWrap = <img src="http://www.gravatar.com/avatar/|.jpg?s=100" alt="{field:be_user_realName}" />
    required = 1
  }
  ...
}

marker {
  ...
  pagecontent = COA
  pagecontent {
    10 = CONTENT
    10.table = tt_content
    10.select.pidInList.dataWrap = {field:uid}
    10.select.where = colPos=0
    10.select.languageField = sys_language_uid
  }
  ...
}

marker {
  ...
  additionalfooter = COA
  additionalfooter {
    10 = TEXT
    10 {
      if.isTrue.field = tx_typo3blog_allow_comments
      stdWrap.cObject = CONTENT
      stdWrap.cObject < comments.commentsForm
    }
  }
  ...
}

archive Widget¶

Please look at the TypoScript configuration EXT:typo3_blog/widgets/archive/setup.txt and the template file EXT:typo3_blog/widgets/archive/template.html

TypoScript:

plugin.tx_typo3blog_pi1 {
  archive = USER
  archive {
    includeLibs = EXT:typo3_blog/widgets/archive/class.tx_typo3blog_widget_archive.php
    userFunc = tx_typo3blog_widget_archive->main
    ...
  }
}

baseWrap {
  outerWrap = <div class="tx-typo3blog-pi1"> | </div>
  dataWrap = <h3>{LLL:EXT:typo3_blog/pi1/locallang.xml:tx_typo3blog_widget_archive.title}</h3>
}

marker {
  ...
  quantity = TEXT
  quantity {
    field = quantity
    wrap = |
  }
  ...
}

blogroll Widget¶

Please look at the TypoScript configuration EXT:typo3_blog/widgets/blogroll/setup.txt

Typoscript:

includeLibs.tx_typo3blog_widget_blogroll = EXT:typo3_blog/widgets/blogroll/class.tx_typo3blog_widget_blogroll.php plugin.tx_typo3blog_pi1 {
  blogroll = RECORDS
  blogroll {
    source.cObject = USER
    source.cObject {
      userFunc = tx_typo3blog_widget_blogroll->getBlogRollIds
    }
    ...
  }
}

conf.tx_typo3blog_blogroll = COA
conf.tx_typo3blog_blogroll {
  10 = TEXT
  10 {
    field = name
    typolink {
      parameter.field = link
      title.field = title // name
    }
  }
  wrap = <li> | </li>
}

stdWrap {
  outerWrap = <div class="tx-typo3blog-pi1"> | </div>
  dataWrap =<h3> {LLL:EXT:typo3_blog/pi1/locallang.xml:tx_typo3blog_widget_blogroll.title}</h3>
  wrap = <ul> | </ul>
  required = 1
}

calendar Widget¶

Please look at the TypoScript configuration EXT:typo3_blog/widgets/calendar/setup.txt and the template file EXT:typo3_blog/widgets/calendar/template.html

Typoscript:

plugin.tx_typo3blog_pi1 {
  calendar = USER
  calendar {
    includeLibs = EXT:typo3_blog/widgets/calendar/class.tx_typo3blog_widget_calendar.php
    userFunc = tx_typo3blog_widget_calendar->main
    ...
  }
}

baseWrap {
  outerWrap = <div class="tx-typo3blog-pi1"> | </div>
}

datepicker = COA
datepicker {
  10 = TEXT
  10.wrap = <div id="tx_typo3blog_widget_calendar">| </div>
}

category Widget¶

Please look at the TypoScript configuration EXT:typo3_blog/widgets/category/setup.txt.

latestPosts Widget¶

Please look at the TypoScript configuration EXT:typo3_blog/widgets/latestposts/setup.txt and the template file EXT:typo3_blog/widgets/latestposts/template.html

Typoscript:

plugin.tx_typo3blog_pi1 {
  latestPosts = USER
  latestPosts {
    includeLibs = EXT:typo3_blog/widgets/latestposts/class.tx_typo3blog_widget_latestposts.php
    userFunc = tx_typo3blog_widget_latestposts->main
    ...
  }
}

baseWrap {
  outerWrap = <div class="tx-typo3blog-pi1"> | </div>
  dataWrap = <h3 class="title">{LLL:EXT:typo3_blog/pi1/locallang.xml:tx_typo3blog_widget_latestposts.title}</h3>
  wrap = <ul>|</ul>
}

marker {
  ...
  title = TEXT
  title {
    wrap = <li>|</li>
     field = title
     typolink {
       parameter.dataWrap = {field:uid}
       title.field = subtitle // title
     }
  }
  ...
}

relatedPosts Widget¶

Please look at the TypoScript configuration EXT:typo3_blog/widgets/relatedPosts/setup.txt and the template file EXT:typo3_blog/widgets/relatedPosts/template.html

Typoscript:

plugin.tx_typo3blog_pi1 {
  relatedPosts = USER
  relatedPosts {
    includeLibs = EXT:typo3_blog/widgets/relatedposts/class.tx_typo3blog_widget_relatedposts.php
    userFunc = tx_typo3blog_widget_relatedposts->main
    ...
  }
}

baseWrap {
  outerWrap = <div class="tx-typo3blog-pi1"> | </div>
  dataWrap =  <h3>{LLL:EXT:typo3_blog/pi1/locallang.xml:tx_typo3blog_widget_relatedposts.title}</h3>
  wrap = <ul>|</ul>
}

marker {
  ...
  title = TEXT
  title {
    wrap = <li>|</li>
     field = title
     typolink {
       parameter.dataWrap = {field:uid}
       title.field = subtitle // title
     }
  }
  ...
}

Template Setup¶

This TypoScript configuration contains the sidebar with widgets.

lib.content_right = COA
lib.content_right {
  10 < plugin.tx_typo3blog_pi1.category
  20 < plugin.tx_typo3blog_pi1.calendar
  30 < plugin.tx_typo3blog_pi1.archive
  40 < plugin.tx_typo3blog_pi1.relatedPosts
  50 < plugin.tx_typo3blog_pi1.latestPosts
  60 < plugin.tx_typo3blog_pi1.latestComments
  70 < plugin.tx_typo3blog_pi1.blogroll
}
# Write the sidebar in page subparts marker CONTENT_RIGHT
page.10.subparts.CONTENT_RIGHT < lib.content_right

This Typoscript configuration is required to render the blogList and blogSingle widget in your template.

[PIDinRootline = {$plugin.tx_typo3blog_pi1.startPid}]
  page.10.subparts.CONTENT_NORMAL < plugin.tx_typo3blog_pi1.blogSingle
[end]

[userFunc = user_typo3blog_pageTypeIsCategory()]
  page.10.subparts.CONTENT_NORMAL < plugin.tx_typo3blog_pi1.blogList
  page.10.subparts.CONTENT_RIGHT.30 >
  page.10.subparts.CONTENT_RIGHT.50 >
[end]

[globalVar = TSFE:page|tx_typo3blog_exclude_page = 1]
  page.10.subparts.CONTENT_NORMAL < styles.content.get
[end]

Reference¶

Possible subsections: Reference (TypoScript)

1.0.0¶

0.0.4¶

0.0.3¶

0.0.2¶

0.0.1¶

19