DEPRECATION WARNING

This documentation is not using the current rendering mechanism and will be deleted by December 31st, 2020. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Administrator Manual

Target group: Administrators

Insert Plugin

The output is managed via content modules. This means easy and flexible usage.

  1. Insert a content element, choose “Plugins” -> “General Plugin”
Insert plugin

Choose one or more of the plugins listed to build your blog. These can be distributed to different columns.

Modules

Plugins

Blogsystem

Main plugin of the extension. Provides post list and detail view. Enables users to create comments.

Blogsystem

Archive

This plugin displays a list of your blog posts, nested by month and sorted by date.

Archive

Categories

List all blog categories including sub categories.

Latest Comments

List of the latest comments. Configurable via paginate settings.

Lastest Posts

List of the latest blog posts. Configurable via paginate settings.

RSS Feed

RSS output, see chapter RSS.

Subscription Manager

This plugin manages all blog related subscriptions. All email links will point to this page. Depending on your configuration users can confirm, add and remove subscriptions for new comments and new posts.

Subscription Manager

We’ve already did some basic settings for this plugin in the installation process, but you should do so some more configuration.

Configure the Subscription manager via with (see t3extblogConfigurationTypoScriptsetup.txt, look for “subscriptionManager”!

Important

Use a separate page for this plugin!

Tip

More information about email sending in the Users Manual

Blog Subscription Form

This plugin provides a simple form which enables users to subscribe for new blog posts. Uses opt-in emails for confirmation.

Configure the Subscription manager form with TS (see t3extblogConfigurationTypoScriptsetup.txt, look for “blogSubscription”!

RSS Feed

This plugin renders a RSS feed.

The RSS-Module need some special treatment, but no need to worry. Just create a single page for the RSS-output, then:

  1. Choose the RSS plugin and insert it to that page (see above how to do this)
  2. Create an extension template and include T3Extblog: Rss setup (t3extblog)
RSS include static

When you open the page, the output should look like this:

RSS output

Have a look at /Configuration/TypoScript/RSS/setup.txt You can override the values by using an extension template on the page where your have insert the Rss-modul.

When you want to use RealURL add the static template T3Extblog: additional RealUrl config (t3extblog) too. When overriding the TS-values, add a config.tx_realurl_enable = 1 to your TS to get RealUrl running in the RSS-Feed.

Important

Please note: Default RSS template depends on using RealUrl. You will need to escape links when using plain TYPO3 links.

Preview blog posts

The extension has a preview functionality. Add following TypoScript to your page TSconfig (where 123 is the PID of the page where the blogsystem plugin is included).

TCEMAIN.preview {
        tx_t3blog_post {
                previewPageId = 123
                useDefaultLanguageRecord = 1
                fieldToParameterMap {
                        uid = tx_t3extblog_blogsystem[previewPost]
                }
                additionalGetParameters {
                        tx_t3extblog_blogsystem.controller = Post
                        tx_t3extblog_blogsystem.action = preview
                }
        }
}

By default, hidden posts are only visible to authenticated backend users. This is done by TypoScript (settings.previewHiddenRecords), please see /Configuration/TypoScript/setup.txt.

Multilanguage / Localization

Requirements:

Working multi language TYPO3 CMS installation.

Needed steps:

  • Translate blogsystem plugin page
  • Translate plugin elements
  • Translate record sysfolder
  • Start translating your posts and categories!

Email localization

All emails (subscription opt-in, new comment notify for admin and user) are single language only at the moment.

Important

Please note: Added localization strings will work in frontend but not in backend context (e.g. when switch a comment visible from the BE). It’s recommended to only use and change the default localization to keep all emails consistent. You may use FLUID if conditions within the email templates in order to localize your custom email templates.

Please see here for more information: https://github.com/fnagel/t3extblog/issues/68