.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================ EXT: typo3\_blog ================ :Created: 2010-02-18T17:33:18 :Changed by: Roland Hensch :Changed: 2013-03-17T21:04:44.590000000 :Classification: typo3_blog :Description: The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ---- :Keywords: Blog :Author: Roland Hensch :Email: rsch73@gmail.com :Info 4: :Language: en |img-1| |img-2| EXT: typo3\_blog - typo3\_blog .. _EXT-typo3-blog: EXT: typo3\_blog ================ Extension Key: typo3\_blog Language: en Keywords: Typo3 Blog Copyright 2000-2010, Roland Hensch, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 \- a GNU/GPL CMS/Framework available from www.typo3.org .. _Table-of-Contents: Table of Contents ----------------- `EXT: typo3\_blog 1 <#__RefHeading__9809_1055177846>`_ **`Introduction 3 <#__RefHeading__9811_1055177846>`_** `What does it do? 3 <#__RefHeading__9813_1055177846>`_ `Screenshots 3 <#__RefHeading__9815_1055177846>`_ **`Users manual 4 <#__RefHeading__9817_1055177846>`_** `Generall 4 <#__RefHeading__1663_1321680533>`_ `Blog start page 4 <#__RefHeading__1665_1321680533>`_ `Blog categories 5 <#__RefHeading__9821_1055177846>`_ `Blog entry 5 <#__RefHeading__9823_1055177846>`_ `Blog Settings 5 <#__RefHeading__9825_1055177846>`_ `FAQ 5 <#__RefHeading__9827_1055177846>`_ **`Administration 6 <#__RefHeading__9829_1055177846>`_** `Adding TypoScript Template 6 <#__RefHeading__9831_1055177846>`_ `FAQ 6 <#__RefHeading__9833_1055177846>`_ **`Configuration 7 <#__RefHeading__9835_1055177846>`_** `blogList Widget 7 <#__RefHeading__3085_1179748543>`_ `blogSingle Widget 8 <#__RefHeading__3756_1179748543>`_ `archive Widget 10 <#__RefHeading__4591_1179748543>`_ `blogroll Widget 11 <#__RefHeading__4758_1179748543>`_ `calendar Widget 12 <#__RefHeading__4939_1179748543>`_ `category Widget 13 <#__RefHeading__1658_1179748543>`_ `latestPosts Widget 13 <#__RefHeading__1795_1179748543>`_ `relatedPosts Widget 14 <#__RefHeading__2688_1179748543>`_ `Template Setup 15 <#__RefHeading__2921_1179748543>`_ `Reference 15 <#__RefHeading__9839_1055177846>`_ **`Tutorial 16 <#__RefHeading__8961_1179748543>`_** **`Known problems 17 <#__RefHeading__9843_1055177846>`_** **`To-Do list 18 <#__RefHeading__9845_1055177846>`_** **`ChangeLog 19 <#__RefHeading__9847_1055177846>`_** .. _Introduction: Introduction ------------ .. _What-does-it-do: 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 .. _Widgets: Widgets """"""" - The following widgets are available in this extension - blogSingle: Display a single blog entry - category: Display a menu with blog categories - archive: Display list of blog entries ordered by year and month - calendar: Display a calendar an highlight the date of created posts - blogroll: Display a list with interested links - latestPosts: Display a list from the latest blog entries .. _Screenshots: Screenshots ^^^^^^^^^^^ |img-3| |img-4| .. _img-5-img-6-Users-manual: |img-5| |img-6| Users manual ---------------------------- .. _Generall: 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: 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: 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: 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: Blog Settings ^^^^^^^^^^^^^ |img-3| - 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: FAQ ^^^ Possible subsections: FAQ .. _Administration: Administration -------------- .. _Adding-TypoScript-Template: Adding TypoScript Template ^^^^^^^^^^^^^^^^^^^^^^^^^^ - Create a new extension template on the blog start page to integrate a blog in a existing Site. - |img-7| Add the extension TypoScript “Typo3Blog Setup (typo3\_blog)” and the extension TypoScript “Page browser (pagebrowse)” to this template. Please set the correct order. - |img-8| 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. .. _img-9-FAQ: |img-9| FAQ ^^^^^^^^^^^ .. _jQuery-support: jQuery support """""""""""""" This extension includes the jQuery lib and add's to your template. If jQuery already exist then remove the path in Constant Editor Files Section “jQuery Library” .. _Configuration: Configuration ------------- This section describes the TypoScript configuration of the typo3\_blog widgets and the integration in your page template. .. _blogList-Widget: 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 ... } } .. ### BEGIN~OF~TABLE ### .. _itemsToDisplay: itemsToDisplay """""""""""""" .. container:: table-row Property itemsToDisplay Data type int Description Count to displaying entries in bloglist Default Value of {$plugin.tx\_typo3blog\_pi1.blogList.itemsToDisplay} constant .. _contentItemsToDisplay: contentItemsToDisplay """"""""""""""""""""" .. container:: table-row Property contentItemsToDisplay Data type int Description Displaying elements from tt\_content as preview. Default Value of {$plugin.tx\_typo3blog\_pi1.blogList.contentItemsToDisplay} constant .. _templateFile: templateFile """""""""""" .. container:: table-row Property templateFile Data type string Description Path to blogList template file Default Value of {$plugin.tx\_typo3blog\_pi1.blogList.templateFile} constant .. _baseWrap: baseWrap """""""" .. container:: table-row Property baseWrap Data type array Description Wrap for the widget **Example:** :: baseWrap { outerWrap =
|
} Default .. _marker: marker """""" .. container:: table-row Property marker Data type array Description This is an array with all markers for the template. You can use all columns from the table pages in this marker array. We have already set several columns in this TS. **Example:** :: 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 =
  • |
    • required = 1 } ... } Default .. ###### END~OF~TABLE ###### .. _markerConfigs: markerConfigs """"""""""""" .. ### BEGIN~OF~TABLE ### .. _uid: uid ~~~ .. container:: table-row Property uid Data type TEXT Description Column uid from table pages. Set the marker in templatefile ###UID### Default .. _title: title ~~~~~ .. container:: table-row Property title Data type TEXT Description Column title in table pages. Set the marker in templatefile ###TITLE### Default .. _tx-typo3blog-create-datetime: tx\_typo3blog\_create\_datetime ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property tx\_typo3blog\_create\_datetime Data type TEXT Description Column tx\_typo3blog\_create\_datetime in table pages. Set the marker in templatefile ###TX\_TYPO3BLOG\_CREATE\_DATETIME### Default .. _author: author ~~~~~~ .. container:: table-row Property author Data type TEXT Description Column be\_user\_realName in table be\_users Set the marker in templatefile ###AUTHOR### Default .. _author-email: author\_email ~~~~~~~~~~~~~ .. container:: table-row Property author\_email Data type TEXT Description Column be\_user\_email in table be\_users Set the marker in templatefile ###AUTHOR\_EMAIL### Default .. _author-email: author\_email ~~~~~~~~~~~~~ .. container:: table-row Property author\_email Data type TEXT Description Field that widget with md5() hash from column be\_user\_email in table be\_users Set the marker in templatefile ###GRAVATAR### Default .. _category: category ~~~~~~~~ .. container:: table-row Property category Data type TEXT Description Name of blog category. Field that generated by widget Set the marker in templatefile ###CATEGORY### Default .. _tx-typo3blog-tags: tx\_typo3blog\_tags ~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property tx\_typo3blog\_tags Data type COA Description Column tx\_typo3blog\_tags in table pages. Set the marker in templatefile ###TX\_TYPO3BLOG\_TAGS### Default .. _pagecontent: pagecontent ~~~~~~~~~~~ .. container:: table-row Property pagecontent Data type COA Description CONTENT Select from table tt\_content to set the content element as preview in blogList **Example:** :: 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 } ... } Default .. _showmore: showmore ~~~~~~~~ .. container:: table-row Property showmore Data type TEXT Description This field is parsed in widget and create a link to this blog entry page Set the marker in templatefile ###SHOWMORE### Default .. _additionalheader: additionalheader ~~~~~~~~~~~~~~~~ .. container:: table-row Property additionalheader Data type COA Description This field is parsed in widget and you can add other content on top of the widget. Set the marker in templatefile ###ADDITIONALHEADER### Default .. _additionalfooter: additionalfooter ~~~~~~~~~~~~~~~~ .. container:: table-row Property additionalfooter Data type COA Description This field is parsed in widget and you can add other content on bottom of the widget. Set the marker in templatefile ###ADDITIONALFOOTER### Default .. ###### END~OF~TABLE ###### .. _blogSingle-Widget: 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 ... } } .. ### BEGIN~OF~TABLE ### .. _templateFile: templateFile """""""""""" .. container:: table-row Property templateFile Data type string Description Path to blogList template file Default Value of {$plugin.tx\_typo3blog\_pi1.blogList.templateFile} constant .. _baseWrap: baseWrap """""""" .. container:: table-row Property baseWrap Data type array Description Wrap for the widget **Example:** :: baseWrap { outerWrap =
    |
    } Default .. _singleNav: singleNav """"""""" .. container:: table-row Property singleNav Data type HMENU Description Navigation to get next and preview blog entry **Example:** :: 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 = 1.alternativeSortingField = tx_typo3blog_create_datetime desc 1.NO { linkWrap =
  • |
    • stdWrap.htmlSpecialChars = 1 ATagTitle.field = subtitle // title } } Default .. _marker: marker """""" .. container:: table-row Property marker Data type array Description This is an array with all markers for the template. You can use all columns from table pages in this marker array. We have already set several columns in this TS. **Example:** :: marker { ... title = TEXT title { wrap =

    |

    field = title } tx_typo3blog_create_datetime = TEXT tx_typo3blog_create_datetime { field = tx_typo3blog_create_datetime strftime = {$plugin.tx_typo3blog_pi1.dateFromat} wrap =
  • |
    • required = 1 } gravatar = TEXT gravatar { field = be_user_email_secure dataWrap = {field:be_user_realName} required = 1 } ... } Default .. ###### END~OF~TABLE ###### .. _markerConfigs: markerConfigs """"""""""""" .. ### BEGIN~OF~TABLE ### .. _additionalheader: additionalheader ~~~~~~~~~~~~~~~~ .. container:: table-row Property additionalheader Data type COA Description This field is parsed in widget and you can add other content on top of the widget. Set the marker in templatefile ###ADDITIONALHEADER### Default .. _title: title ~~~~~ .. container:: table-row Property title Data type TEXT Description Column title in table pages. Set the marker in templatefile ###TITLE### Default .. _category: category ~~~~~~~~ .. container:: table-row Property category Data type TEXT Description Name of blog category. Field that generated by widget Set the marker in templatefile ###CATEGORY### Default .. _author: author ~~~~~~ .. container:: table-row Property author Data type TEXT Description Column be\_user\_realName in table be\_users Set the marker in templatefile ###AUTHOR### Default .. _author-email: author\_email ~~~~~~~~~~~~~ .. container:: table-row Property author\_email Data type TEXT Description Field that widget with md5() hash from column be\_user\_email in table be\_users Set the marker in templatefile ###GRAVATAR### Default .. _tx-typo3blog-create-datetime: tx\_typo3blog\_create\_datetime ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property tx\_typo3blog\_create\_datetime Data type TEXT Description Column tx\_typo3blog\_create\_datetime in table pages. Set the marker in templatefile ###TX\_TYPO3BLOG\_CREATE\_DATETIME### Default .. _tx-typo3blog-tags: tx\_typo3blog\_tags ~~~~~~~~~~~~~~~~~~~ .. container:: table-row Property tx\_typo3blog\_tags Data type COA Description Column tx\_typo3blog\_tags in table pages. Set the marker in templatefile ###TX\_TYPO3BLOG\_TAGS### Default .. _gravatar: gravatar ~~~~~~~~ .. container:: table-row Property gravatar Data type TEXT Description Add gravatar from `http://www.gravatar.com/avatar/ `_ Set the marker in templatefile ###GRAVATAR### **Example:** :: marker { ... gravatar = TEXT gravatar { field = be_user_email_secure dataWrap = {field:be_user_realName} required = 1 } ... } Default .. _pagecontent: pagecontent ~~~~~~~~~~~ .. container:: table-row Property pagecontent Data type COA Description CONTENT select from table tt\_content to set all content element from current page (blog entry) **Example:** :: 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 } ... } Default .. _additionalfooter: additionalfooter ~~~~~~~~~~~~~~~~ .. container:: table-row Property additionalfooter Data type COA Description This field is parsed in widget and you can add other content on bottom of the widget. Set the marker in templatefile ###ADDITIONALFOOTER### **Example:** :: marker { ... additionalfooter = COA additionalfooter { 10 = TEXT 10 { if.isTrue.field = tx_typo3blog_allow_comments stdWrap.cObject = CONTENT stdWrap.cObject < comments.commentsForm } } ... } Default .. ###### END~OF~TABLE ###### .. _archive-Widget: 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 ... } } .. ### BEGIN~OF~TABLE ### .. _jQueryNoConflict: jQueryNoConflict """""""""""""""" .. container:: table-row Property jQueryNoConflict Data type boolean Description Enable jQuery no conflict mode Default 0 .. _jsInFooter: jsInFooter """""""""" .. container:: table-row Property jsInFooter Data type boolean Description Add Javascript in footer Default 0 .. _jsMinify: jsMinify """""""" .. container:: table-row Property jsMinify Data type boolean Description Minify Javascript Default 0 .. _jsInline: jsInline """""""" .. container:: table-row Property jsInline Data type boolean Description Add Javascript inline Default 0 .. _cssMinify: cssMinify """"""""" .. container:: table-row Property cssMinify Data type boolean Description Minify CSS stylesheet Default 0 .. _templateFile: templateFile """""""""""" .. container:: table-row Property templateFile Data type string Description Path to template file Default Value of {$plugin.tx\_typo3blog\_pi1.archive.templateFile} constant .. _baseWrap: baseWrap """""""" .. container:: table-row Property baseWrap Data type array Description Contains wraps **Example:** :: baseWrap { outerWrap =
    |
    dataWrap =

    {LLL:EXT:typo3_blog/pi1/locallang.xml:tx_typo3blog_widget_archive.title}

    } Default .. _marker: marker """""" .. container:: table-row Property marker Data type array Description This is an array with all markers for the template. You can use all columns from table pages in this marker array. We have already set several columns in this TS. **Example:** :: marker { ... quantity = TEXT quantity { field = quantity wrap = | } ... } Default .. ###### END~OF~TABLE ###### .. _markerConfigs: markerConfigs """"""""""""" .. ### BEGIN~OF~TABLE ### .. _year: year ~~~~ .. container:: table-row Property year Data type TEXT Description Field year as link Set the marker in templatefile ###YEAR### Default .. _month: month ~~~~~ .. container:: table-row Property month Data type TEXT Description Field month as link Set the marker in templatefile ###MONTH### Default .. _quantity: quantity ~~~~~~~~ .. container:: table-row Property quantity Data type TEXT Description Field quantity is a count of blog entry in month Set the marker in templatefile ###QUANTITY### Default .. _title: title ~~~~~ .. container:: table-row Property title Data type TEXT Description Column title in table pages. Set the marker in templatefile ###TITLE### Default .. ###### END~OF~TABLE ###### .. _blogroll-Widget: 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 } ... } } .. ### BEGIN~OF~TABLE ### .. _tables: tables """""" .. container:: table-row Property tables Data type string Description Name of table with blogroll records Default tx\_typo3blog\_blogroll .. _conf-tx-typo3blog-blogroll: conf.tx\_typo3blog\_blogroll """""""""""""""""""""""""""" .. container:: table-row Property conf.tx\_typo3blog\_blogroll Data type COA Description Contain all fields and wraps to render the blogroll list **Example:** :: conf.tx_typo3blog_blogroll = COA conf.tx_typo3blog_blogroll { 10 = TEXT 10 { field = name typolink { parameter.field = link title.field = title // name } } wrap =
  • |
    • } Default .. _stdWrap: stdWrap """"""" .. container:: table-row Property stdWrap Data type stdWrap Description Wrap for blogroll widget. **Example:** :: stdWrap { outerWrap =
    |
    dataWrap =

    {LLL:EXT:typo3_blog/pi1/locallang.xml:tx_typo3blog_widget_blogroll.title}

    wrap = required = 1 } Default .. ###### END~OF~TABLE ###### .. _calendar-Widget: 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 ... } } .. ### BEGIN~OF~TABLE ### .. _jQueryNoConflict: jQueryNoConflict """""""""""""""" .. container:: table-row Property jQueryNoConflict Data type boolean Description Enable jQuery no conflict mode Default 0 .. _jsInFooter: jsInFooter """""""""" .. container:: table-row Property jsInFooter Data type boolean Description Add Javascript in footer Default 0 .. _jsMinify: jsMinify """""""" .. container:: table-row Property jsMinify Data type boolean Description Minify Javascript Default 0 .. _jsInline: jsInline """""""" .. container:: table-row Property jsInline Data type boolean Description Add Javascript inline Default 0 .. _cssMinify: cssMinify """"""""" .. container:: table-row Property cssMinify Data type boolean Description Minify CSS stylesheet Default 0 .. _templateFile: templateFile """""""""""" .. container:: table-row Property templateFile Data type string Description Path to template file Default Value of {$plugin.tx\_typo3blog\_pi1.calendar.templateFile} constant .. _baseWrap: baseWrap """""""" .. container:: table-row Property baseWrap Data type array Description Wrap for the widget **Example:** :: baseWrap { outerWrap =
    |
    } Default .. _datepicker: datepicker """""""""" .. container:: table-row Property datepicker Data type COA Description Add div element with class attribute to render the datpicker. **Example:** :: datepicker = COA datepicker { 10 = TEXT 10.wrap =
    |
    } Default .. ###### END~OF~TABLE ###### .. _category-Widget: category Widget ^^^^^^^^^^^^^^^ Please look at the TypoScript configuration EXT:typo3\_blog/widgets/category/setup.txt. .. ### BEGIN~OF~TABLE ### .. _categoryList: categoryList """""""""""" .. container:: table-row Property categoryList Data type HMENU Description Default HMENU to render a menu list with categories Default .. ###### END~OF~TABLE ###### .. _latestPosts-Widget: 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 ... } } .. ### BEGIN~OF~TABLE ### .. _itemsToDisplay: itemsToDisplay """""""""""""" .. container:: table-row Property itemsToDisplay Data type int Description Number of items to display in the latestPosts list Default Value of {$plugin.tx\_typo3blog\_pi1.latestPosts.itemsToDisplay} constant .. _templateFile: templateFile """""""""""" .. container:: table-row Property templateFile Data type string Description Path to template file Default Value of {$plugin.tx\_typo3blog\_pi1.latestPosts.templateFile} constant .. _baseWrap: baseWrap """""""" .. container:: table-row Property baseWrap Data type array Description Wrap for the widget **Example:** :: baseWrap { outerWrap =
    |
    dataWrap =

    {LLL:EXT:typo3_blog/pi1/locallang.xml:tx_typo3blog_widget_latestposts.title}

    wrap = } Default .. _marker: marker """""" .. container:: table-row Property marker Data type array Description This is an array with all markers for the template. You can use all columns from table pages in this marker array. We have already set several columns in this TS. **Example:** :: marker { ... title = TEXT title { wrap =
  • |
    • field = title typolink { parameter.dataWrap = {field:uid} title.field = subtitle // title } } ... } Default .. ###### END~OF~TABLE ###### .. _markerConfigs: markerConfigs """"""""""""" .. ### BEGIN~OF~TABLE ### .. _additionalheader: additionalheader ~~~~~~~~~~~~~~~~ .. container:: table-row Property additionalheader Data type COA Description This field is parsed in widget and you can add other content on top of the widget. Set the marker in templatefile ###ADDITIONALHEADER### Default .. _title: title ~~~~~ .. container:: table-row Property title Data type TEXT Description Column title in table pages. Set the marker in templatefile ###TITLE### Default .. _additionalfooter: additionalfooter ~~~~~~~~~~~~~~~~ .. container:: table-row Property additionalfooter Data type COA Description This field is parsed in widget and you can add other content on bottom of the widget. Set the marker in templatefile ###ADDITIONALFOOTER### Default .. ###### END~OF~TABLE ###### .. _relatedPosts-Widget: 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 ... } } .. ### BEGIN~OF~TABLE ### .. _startPID: startPID """""""" .. container:: table-row Property startPID Data type int Description Page ID from blog start page Default Value of {$plugin.tx\_typo3blog\_pi1.startPid} constant .. _templateFile: templateFile """""""""""" .. container:: table-row Property templateFile Data type string Description Path to template Default Value of {$plugin.tx\_typo3blog\_pi1.relatedPosts.templateFile} .. _keywordsColumn: keywordsColumn """""""""""""" .. container:: table-row Property keywordsColumn Data type string Description Name of column with tags to search the related posts Default Value of {$plugin.tx\_typo3blog\_pi1.columnWithTags} constant .. _itemsToDisplay: itemsToDisplay """""""""""""" .. container:: table-row Property itemsToDisplay Data type int Description Number of items to display in the relatedPosts list Default Value of {$plugin.tx\_typo3blog\_pi1.relatedPosts.itemsToDisplay} constant .. _baseWrap: baseWrap """""""" .. container:: table-row Property baseWrap Data type array Description Wrap for the widget **Example:** :: baseWrap { outerWrap =
    |
    dataWrap =

    {LLL:EXT:typo3_blog/pi1/locallang.xml:tx_typo3blog_widget_relatedposts.title}

    wrap = } Default .. _marker: marker """""" .. container:: table-row Property marker Data type array Description This is an array with all markers for the template. You can use all columns from table pages in this marker array. We have already set several columns in this TS. **Example:** :: marker { ... title = TEXT title { wrap =
  • |
    • field = title typolink { parameter.dataWrap = {field:uid} title.field = subtitle // title } } ... } Default .. ###### END~OF~TABLE ###### .. _markerConfig: markerConfig """""""""""" .. ### BEGIN~OF~TABLE ### .. _additionalheader: additionalheader ~~~~~~~~~~~~~~~~ .. container:: table-row Property additionalheader Data type COA Description This field is parsed in widget and you can add other content on top of the widget. Set the marker in templatefile ###ADDITIONALHEADER### Default .. _title: title ~~~~~ .. container:: table-row Property title Data type TEXT Description Column title in table pages. Set the marker in templatefile ###TITLE### Default .. _additionalfooter: additionalfooter ~~~~~~~~~~~~~~~~ .. container:: table-row Property additionalfooter Data type COA Description This field is parsed in widget and you can add other content on the bottom of this widget. Set the marker in templatefile ###ADDITIONALFOOTER### Default .. ###### END~OF~TABLE ###### .. _Template-Setup: 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: Reference ^^^^^^^^^ Possible subsections: Reference (TypoScript) .. _Tutorial: Tutorial -------- See typo3\_blog documentation http://www.unitlabs.ch/typo3-extensions .. _Known-problems: Known problems -------------- `typo3\_blog on TYPO3 Forge `_ .. _To-Do-list: To-Do list ---------- .. _ChangeLog: ChangeLog --------- - Create a file "ChangeLog" (see e.g. the extension "cal" as example) to inform about changes or - Use this section to document all the changes through the versions. - Alternative to the following list: `ChangeLog online (point this link to YOUR extension) `_ .. ### BEGIN~OF~TABLE ### .. _1-0-0: 1.0.0 ^^^^^ .. container:: table-row Version 1.0.0 Changes Add Typo3 multilanguage supportRemove the typo3blog sample Layout and remove widgets for comments, pagehits, tagcloud, form4\_pages\_rss, sexybookmarks and tt\_content search .. _0-0-4: 0.0.4 ^^^^^ .. container:: table-row Version 0.0.4 Changes Add manual .. _0-0-3: 0.0.3 ^^^^^ .. container:: table-row Version 0.0.3 Changes .. _0-0-2: 0.0.2 ^^^^^ .. container:: table-row Version 0.0.2 Changes .. _0-0-1: 0.0.1 ^^^^^ .. container:: table-row Version 0.0.1 Changes .. ###### END~OF~TABLE ###### |img-2| 19 .. ######CUTTER_MARK_IMAGES###### .. |img-1| image:: img-1.png .. :align: left .. |img-2| image:: img-2.png .. :border: 0 .. :height: 21 .. :hspace: 9 .. :id: Grafik2 .. :name: Grafik2 .. :width: 87 .. |img-3| image:: img-3.jpeg .. :align: left .. :border: 0 .. :height: 203 .. :id: Grafik3 .. :name: Grafik3 .. :width: 291 .. |img-4| image:: img-4.jpeg .. :align: left .. :border: 0 .. :height: 273 .. :id: Grafik1 .. :name: Grafik1 .. :width: 329 .. |img-5| image:: img-5.png .. :align: left .. :border: 0 .. :height: 294 .. :id: Grafik5 .. :name: Grafik5 .. :width: 291 .. |img-6| image:: img-6.png .. :align: left .. :border: 0 .. :height: 303 .. :id: Grafik4 .. :name: Grafik4 .. :width: 291 .. |img-7| image:: img-7.jpeg .. :align: left .. :border: 0 .. :height: 245 .. :id: Grafik9 .. :name: Grafik9 .. :width: 556 .. |img-8| image:: img-8.jpeg .. :align: left .. :border: 0 .. :height: 165 .. :id: Grafik7 .. :name: Grafik7 .. :width: 442 .. |img-9| image:: img-9.png .. :align: left .. :border: 0 .. :height: 93 .. :id: Grafik8 .. :name: Grafik8 .. :width: 442