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.

Installation

Target group: Administrators

Installation process - step by step

In this installation guide, we will override some values and make our blog more individual. Some steps are already described in the Quick Installation.

  1. Import and install the extension
    • via the extension manager
  2. Create the following pages
    • See Quick Installation
    • Optional: add an RSS page (standard page) which will contain the RSS plugin
    • Optional: add a page (standard page) for subscribing to new blog posts
    Recommended page structure
  3. Include static template
  4. Add plugins to the pages
    • See Quick Installation
    • Optional: add the RSS plugin to your RSS page
    • Optional: add the Blog Subscription Form plugin to the previously created page
  5. Start to configure your Blog. This is an TypoScript example:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
        plugin.tx_t3extblog {
                settings {
                        blogsystem {
                                posts {
                                        paginate {
                                                itemsPerPage = 99
                                                insertAbove = 1
                                                insertBelow = 1
                                                maximumNumberOfLinks = 50
                                        }
                                        metadata {
                                                enable = 1

                                                twitterCards {
                                                        enable = 0
                                                }
                                        }
                                }
                                comments {
                                        allowed = 1
                                        allowedUntil = +6 months
                                        approvedByDefault = 0

                                        subscribeForComments = 0
                                }
                        }
                }
        }
        module.tx_t3extblog < plugin.tx_t3extblog

For more configuration-options and the associated explanations see /Configuration/TypoScript/setup.txt.

Important

Assigning the TypoScript settings to backend context by using module.tx_t3extblog < plugin.tx_t3extblog is essential when overriding values. Don’t forget it!

Important

Make sure to configure all mandatory settings, see the minimal configuration!

Tip

It is recommended to use the constants in conjunction with custom TypoScript. Copy both configuration files (constants.txt and setup.txt located in typo3conf/ext/t3extblog/Configuration/TypoScript) and include (using <INCLUDE_TYPOSCRIPT: source=”FILE:EXT:my_extension/…/setup.txt”> them in your root template.

Next Steps

  1. Setup the RSS page TypoScript: RSS setup
  2. Configure RealURL: RealUrl configuration
  3. Copy all templates, configure the paths in TS and start adjusting the HTML markup to your needs
  4. Start blogging: Users manual.