Full.rst

.. ================================================== .. FOR YOUR INFORMATION .. -------------------------------------------------- .. --- coding: utf-8 --- with BOM.

Installation

Target group: --Administrators--

Within this page

• Installation process - step by step
• Next Steps

Installation process - step by step

Important

This guide will use the "old" way of configuring an extension: including a static TypoScript template

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

1. Import and install the extension

   • via the extension manager
   • or using composer

2. Create the following pages

   • See :ref:`Quick Installation <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
   

3. Include static TypoScript template

   This can be done on your root-page or in an extension template for a specific page.

   Minimum requirement: T3Extblog: Default Setup (needed). Do NOT include T3Extblog: RSS setup! We will need this elsewhere.

   

4. Add plugins to the pages

   • See :ref:`Quick Installation <quick_installation>`
   • Optional: add the RSS plugin to your RSS page
   • Optional: add the blog subscription form plugin to the previously created page

5. Configure settings in the constant editor module:

   

   Or use TypoScript:

6. Start to configure your Blog. This is an TypoScript example:

      plugin.tx_t3extblog {
         settings {
            blogsystem {
               posts {
                  paginate {
                     insertAbove = 1
                     maximumNumberOfLinks = 1
                  }
               }
               comments {
                  allowedUntil = +5 years
                  approvedByDefault = 1
                  subscribeForComments = 0
               }
            }
         }
      }
      module.tx_t3extblog < plugin.tx_t3extblog
   

   See :ref:`Configuration <configuration>` for all possible settings.

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 :ref:`minimal configuration <configuration-minimal>`!

Tip

It is recommended to use the constants in conjunction with custom TypoScript. Copy both configuration files (constants.typoscript and setup.typoscript located in EXT:t3extblog/Configuration/TypoScript) and include (using <INCLUDE_TYPOSCRIPT: source="FILE:EXT:my_extension/.../setup.typoscript"> them in your root template. This is overall more flexible than using the site sets settings approach.

Next Steps

1. Setup the RSS page TypoScript: :ref:`RSS setup <administration-rss>`
2. Configure speaking URLs (optional): :ref:`Speaking URL configuration <configuration-speaking-url>`
3. Copy all templates, configure the paths in TS and start adjusting the HTML markup to your needs
4. Start blogging: :ref:`Users manual <users-manual>`.